@v587d/capital-generation 2.7.1 → 2.7.3

package/CHANGELOG.md

@@ -7,6 +7,86 @@
 - **第三位（patch）**：不破坏既有工具 / 配置 / 会话的新增与修复（如 2.1.1、2.1.2）。
 - **第二位（minor）**：有需要用户知晓的行为变更，且段内附迁移说明（如 2.1.0 的图表呈现通道重做、2.2.0 的数据源与检索来源扩容、2.4.0 的**必须换宿主版本**——本插件自己的工具与数据契约没变，所以只抬第二位）。
 
+## [2.7.3] - 2026-10-11
+
+社区 Skill 目录多了第五份快照（**45 条**可选），并把首页与第三方清单对外说的内容核了一遍——顺带把包里
+不该带的上游仓库材料挡掉，整包反而比上一版**小**。既有契约完全没动：工具入参与返回、能力清单、四把密钥
+与凭据引用名、配置字段、会话日志格式、你已有的自选股数据与**已经开启的那几项 Skill**，全部照旧；
+宿主要求与 2.7.2 相同（DSH`@0.2.0-rc.2`），不必换版本。
+
+### Added
+
+- **社区 Skill 目录新增第五份快照**：`marian2js/trading-skills`（MIT，commit `f1ae7d4`）。前四份都是
+  "把这家生意研究清楚"，这一份管**下单前的检查与下单后的复盘**：催化剂怎么排注意力、自选清单里哪些理由
+  已经不成立、这笔想法还缺哪些证据、一个说法能不能被检验、盈亏比结构是否自洽、计划在实际盘面上落不落得
+  了地、组合有没有压在同一批暴露上、交易日志里的重复失误、一笔已经平掉的交易怎么复盘。上游 19 个模块里
+  开放 **9 个**，整份目录从 36 条变成 **45 条**，默认仍然全部关闭。
+- **十颗不进可选清单，逐颗有名字和理由**（写在该快照的 `UPSTREAM.md`）：券商 API 执行面那颗（`etoro`：
+  让你在对话里交密钥、教助手真实下单）**连发布包都不进**；给仓位数字的（`position-sizing`）与给持仓
+  加减动作的（`position-management`）按本仓一贯口径属于明确冲突——本项目不提供投资建议，也不替你动仓；
+  四颗"把模块串成一条流程"的编排不开放（会话怎么分流由本插件自己决定，两处都在路由就会打架）；三颗把
+  取数写死成"先问你用哪家付费服务商、再自己调接口"的不开放，本插件没有那些服务商的凭据，其中
+  `earnings-preview` 还与已经收录的同名模块撞车。
+- **「精选 Skills」的筛选条多一个标签：交易纪律**（中英文各一套显示名，切到中文界面不会露出英文原词）。
+- **首页那行现在写着总数**：5 个开源项目、共 **45 个可选模块**。这个数字不再靠人手抄——配置页每一行都是
+  按目录现算的，两处一旦不一致，回归测试会点名该改哪一边。
+
+### Changed
+
+- **这份快照的正文按本插件的取数与计算边界改了一遍**（10 份文件、17 处，只动"谁去取数、谁去算"这一件
+  事）：这一份里没有"你自己去搜"那一句，但伸手取数换了形态——要使用者点选付费服务商、自己调它们的接口、
+  认领对话里给过的 API 凭据，以及"宿主能跑代码就去用那个共享 python 模块"。在本插件里取数和统计量都是
+  交出去的。判定档位、阈值、输入清单与分析结论**一字未改**；哪一颗完全没动（`post-trade-review` 原文
+  就过关），也记在 `UPSTREAM.md` 里。
+- **第三方清单补全**（`THIRD_PARTY_NOTICES.md`）：每份快照多一列「可选模块 / 快照内共」，一次说清
+  卡片比快照少的那些是什么；宿主提供的那一节补上 React 与两个宿主客户端库（本插件既不打进也不声明
+  它们）；新增"构建期使用、不随包分发"一节。首页致谢也补齐了五份快照。
+- **包变小了**：上游仓库自己的 README 变体、CI 与 workflow、静态文档站、路线图和贡献指南这类只有人类
+  读者会用的材料不再随包发出。排除口径写在每份快照自己的 `.npmignore` 里，回归测试逐条反查它是否真的
+  生效——**现在连文件级规则也查**（此前只查目录，文件规则写了不生效也不会报错）。整包解包
+  3.8 MB → **3.5 MB**、下载 1.3 MB → **1.15 MB**。上游自带的脚本与安装脚本作为可审查材料照旧留在
+  盘上，本插件从不执行它们；老快照里残留的四份上游 `.gitignore` 一并清掉（ignore 规则会在本仓继续
+  生效，那是过去真挡掉过文件的一族）。
+- **社区 Skill 正文的合规检查多认六种形态**：`curl` 外部接口、"宿主能跑代码就去用脚本"、向使用者点选
+  付费服务商、在对话里认领凭据，以及把取数写成"除非使用者明确要求否则别取实时数据"那类条件分支。
+  这一族最早只有"你自己去 web search"一种写法；检查跟着上游的形态加宽，而不是跟着措辞放宽。
+
+**开启新快照后请重启 DSH**：社区 Skill 的名单在宿主装配时算好，刷新页面不会重算（表现是卡片能勾、
+点「详情」读不到原文、会话里也不出现）——上一版的"重启才装配"是同一件事。
+
+## [2.7.2] - 2026-10-11
+
+社区 Skill 目录多了第四份快照（**36 条**可选）。既有契约完全没动：工具入参与返回、能力清单、四把密钥
+与凭据引用名、配置字段、会话日志格式、你已有的自选股数据与**已经开启的那几项 Skill**，全部照旧；
+宿主要求与 2.7.1 相同（DSH`@0.2.0-rc.2`），不必换版本。
+
+### Added
+
+- **社区 Skill 目录新增第四份快照**：`DjNero11/peter-lynch-skill`（MIT，commit `e0eaf58`）——一条完整的
+  个股研究流程。先做一次约 450 字的快筛，回答"这只股票值不值得花 2–5 小时深挖"，给出
+  SKIP / WATCHLIST / DEEP RESEARCH；也可以直接走最长 3000 字的尽调报告。两条路径都强制**固定证据预算**
+  （快筛默认 1–3 份来源、2–3 次取数）与**每条主张配一个可点开的来源链接**：取不到的字段就明说缺哪一项、
+  该分析停在那一项上，不拿印象里的数字补。整份目录从 35 条变成 **36 条**，默认仍然关闭，只对你之后
+  新建的 Capital 会话可见；解包体积 3.7 MB→**3.8 MB**（下载 1.3 MB）。
+- **「精选 Skills」的筛选条多一个标签：彼得·林奇**。前三份快照按"分析视角"这个大类标注，这一份直接以
+  人物命名——使用者真的会按"这是哪一种流派"来筛。中英文各一套显示名，切到中文界面不会露出英文原词。
+
+### Changed
+
+- **这份快照的正文按本插件的取数边界改写了一遍**（124 行，只动"谁去取数"这一件事）：上游写给"什么工具
+  都在手边"的宿主，原文要求助手自己去搜、自己翻页；在本插件里取数是交出去的——结构化数据交给负责取数
+  的角色，网页与披露材料交给负责检索的角色，把代码、要的字段、截止日期写清楚就行。方法论、评分表、
+  预算数字、来源账本字段与输出模板**一字未改**；改了哪几类句子、为什么改，逐条写在该快照的
+  `UPSTREAM.md` 里。报告口径另补一句：那份 X/10 打的是**论点自洽度与结构特征**，不预测涨跌，也不是
+  买卖指令——本项目不提供投资建议。
+- **社区 Skill 正文的合规检查把附属文件也扫进来了**：上一版只扫每颗 skill 的入口文件，而这一份改完入口
+  才发现"你自己去搜"那句写在它的附属说明书里——运行时同样会被读到。现在一颗 skill 目录下的全部
+  markdown 都在扫描范围内，其余三份快照照着复查一遍零命中。这一条对你没有可感变化，只决定下一份社区
+  快照能不能进来。
+- **这份快照标为 `watchlist`（观察中）而不是 `experimental`**：上游只有两次提交、自 2026-06-28 起没有
+  更新（内容读起来是"按意图做完"而非"烂尾"，但维护信号薄）。开启前请自行复核它的来源与口径——它按美股
+  与境外上市语境写，**不声称适用于 A 股**，筛选条上的「美股」标签就是这件事的提示。
+
 ## [2.7.1] - 2026-10-10
 
 社区 Skill 目录多了第三份快照（**35 条**可选），并把「插件」页那张配置卡片重排了一遍。既有契约

package/README.md

@@ -15,7 +15,7 @@
 <p align="center">
   <a href="https://awesome-dsh-plugin.com"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="awesome · DSH plugin"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="License"></a>
-  <a href="https://github.com/v587d/capital-generation/releases"><img src="https://img.shields.io/badge/version-2.7.1-9cf" alt="Version"></a>
+  <a href="https://github.com/v587d/capital-generation/releases"><img src="https://img.shields.io/badge/version-2.7.3-9cf" alt="Version"></a>
 </p>
 
 # Capital Generation
@@ -131,7 +131,7 @@ https://github.com/v587d/capital-generation
 
 - **查数据和资料：** 覆盖A股、港股、美股，由 Agents 按需获取行情、财务、指数、基金与宏观行业数据，检索公告、新闻和研报。共计 **94** 个数据收集能力和 **14** 个网页检索能力，部分公开数据源无需额外密钥；具体覆盖范围见 [数据收集能力表](docs/data-collector-capabilities.md) 和 [网页检索能力表](docs/web-retriever-capabilities.md)。
 - **数据分析：** 所有 Agents 均不直接接触原始结构数据，Agents 按需读取数据、校验数据，并写脚本挖掘数据背后含义。 
-- **可视化：** 将数据交给不同角色处理，再生成可交互图表。图表会作为本轮交付物出现在会话中，可在侧栏查看或离线打开。了解处理流程可看 [Agent 角色说明](docs/agent-roles.md)。
+- **可视化：** Agent 视情况将校验后数据交给可视化专家生成可交互图表。图表会作为本轮交付物出现在会话中，可在侧栏查看或离线打开。了解处理流程可看 [Agent 角色说明](docs/agent-roles.md)。
 
 | 走势折线 | K 线与量价 |
 | :---: | :---: |
@@ -143,7 +143,8 @@ https://github.com/v587d/capital-generation
 | :---: | :---: |
 | <a href="assets/watchlist-popup.png"><img src="assets/watchlist-popup.png" alt="管理自选股" width="400"></a> | <a href="assets/watchlist-more.png"><img src="assets/watchlist-more.png" alt="标记持仓" width="400"></a> |
 
-- **精选 Skills：** 当前收录三个开源项目：[The Investment Skills Lexicon](https://github.com/finterm-ai/investment-skills)（Buffett Investment Framework）、[China Stock Research Skills](https://github.com/spikeHongg/china-stock-research-skills)（六个 A 股研究模块）与 [InvestSkill](https://github.com/yennanliu/InvestSkill)（28 个美股模块：逐条主张核验、空头反方、披露文件与内部人追踪、压力测试等）。上游自带的整套流程编排不会覆盖 Capital 的会话路由。可在「插件」→ **Capital Generation** →「精选 Skills」这一格按需开启（格名后面标着「已开启 / 收录总数」）：左边按能力筛选，按项数从多到少排，往下翻时这一列一直跟着；**已经开启的那几项排在清单最前面**（下次进入这一格时生效，刚拨完不会当场抽走行）。每一项可以先点**详情**，摊开那份 `SKILL.md` 原文读一遍再决定要不要开（按 `Esc` 或点外面收起），开起来之后那一行会多出一个**复制技能名**。开启后新建 Capital 会话生效，默认关闭。
+- **精选 Skills：** 当前收录 5 个开源项目、共 45 个可选模块（默认全部关闭，在配置页逐格打开）：[The Investment Skills Lexicon](https://github.com/finterm-ai/investment-skills)（Buffett Investment Framework）、[China Stock Research Skills](https://github.com/spikeHongg/china-stock-research-skills)（六个 A 股研究模块）、[InvestSkill](https://github.com/yennanliu/InvestSkill)（28 个美股模块：逐条主张核验、空头反方、披露文件与内部人追踪、压力测试等）、[Peter Lynch Research](https://github.com/DjNero11/peter-lynch-skill)（一条完整的个股研究流程）与 [Trading Skills](https://github.com/marian2js/trading-skills)（9 个交易过程模块：催化剂排布、自选股分诊、论点压力测试、执行计划检查、交易日志复盘等，美股与境外交易口径）。
+
 <p align="center">
   <a href="assets/selected-skills配置.png">
     <img src="assets/selected-skills配置.png" alt="selected-skills配置" width="800">
@@ -161,10 +162,11 @@ https://github.com/v587d/capital-generation
 
 目前 Windows 桌面端有一项[已知宿主差异](CHANGELOG.md)：主 Agent 的部分工具限制可能不生效。请特别留意它实际调用了哪些工具；结构化数据的取数限制仍由工具自身执行。
 
-## 开发与贡献
-
+## 开发与贡献 
 普通用户不需要执行下面的命令。修改源码时请参考 [贡献指南](CONTRIBUTING.md) 和 [开发约定](AGENTS.md)：
 
+[![OctoCounts](https://api.octocounts.com/badge/v587d/capital-generation/branch/master)](https://octocounts.com/github/v587d/capital-generation/tree/master)
+
 ```bash
 npm install
 npm run build       # 构建 lib/ 和浏览器端资源
@@ -177,8 +179,8 @@ npm run smoke:boot  # 检查插件装配
 
 ## 致谢
 
-- 「精选 Skills」的研究流程按固定 commit **快照收录**自 [finterm-ai/investment-skills](https://github.com/finterm-ai/investment-skills)、[spikeHongg/china-stock-research-skills](https://github.com/spikeHongg/china-stock-research-skills) 与 [yennanliu/InvestSkill](https://github.com/yennanliu/InvestSkill)（均 MIT License），全部默认关闭。上游那些流程是写给"什么工具都在手边"的助手的，成规模地要求它自己去搜实时行情、搜不到就凭印象估一个；本助手的取数只有一条路（交给负责取数的角色），所以这几处**按合规清单改写过**，改了什么、影响几篇都记在快照内的 `UPSTREAM.md`。分析方法、评分表与结论一字未改，其中的观点仍属原作者，不构成对本插件结论的背书。
+- 「精选 Skills」的研究与交易过程模块按固定 commit **快照收录**自 [finterm-ai/investment-skills](https://github.com/finterm-ai/investment-skills)、[spikeHongg/china-stock-research-skills](https://github.com/spikeHongg/china-stock-research-skills)、[yennanliu/InvestSkill](https://github.com/yennanliu/InvestSkill)、[DjNero11/peter-lynch-skill](https://github.com/DjNero11/peter-lynch-skill) 与 [marian2js/trading-skills](https://github.com/marian2js/trading-skills)（均 MIT License）。
 - 会话里的可交互图表由 [TradingView Lightweight Charts](https://github.com/tradingview/lightweight-charts)（Apache-2.0）渲染。
 - 行情、财务、公告与网页材料来自同花顺 Fuyao、Wind Alice、AnySearch、PaddleOCR 以及东方财富、腾讯等公开或申请制接口；数据版权归各服务方，额度与条款以服务方为准，本项目不重新分发原始数据。
 
-随包分发的第三方组件、版本与许可逐条列在 [第三方组件与许可](THIRD_PARTY_NOTICES.md)。
+随包分发的第三方组件、版本与许可逐条列在 [第三方组件与许可](THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -1,41 +1,80 @@
 # 第三方组件与许可（Third-Party Notices）
 
-本文件集中列出 Capital Generation 随包分发或调用的第三方组件：项目名、作者、许可证与原始仓库。
-本文件随 npm 包一起发布。各组件的许可全文以仓库内文件为准（下表"许可文本"列给出位置）。
+本文件集中列出 Capital Generation 随包分发、随包调用、或只在构建期使用的第三方组件：项目名、作者、
+许可证、原始仓库，以及它在本插件里的位置。本文件随 npm 包一起发布；各组件的许可全文以仓库内文件为准
+（下表"许可文本"列给出位置）。**这份清单不是手抄的**：仓库回归测试会把这里点名的仓内路径拿去问一次
+真实打包器（写了却没发出去就红），也会按 catalog 现算核对首页的模块总数，所以它与装出去的包同步。
 
 ## 随包分发的代码与内容
 
-| 组件 | 作者 | 许可证 | 原始仓库 | 许可文本 | 用在哪里 |
-|---|---|---|---|---|---|
-| Lightweight Charts™ 5.2.1（standalone 构建） | TradingView | Apache-2.0 | <https://github.com/tradingview/lightweight-charts> | `lib/chart/vendor/LICENSE` | 插件内所有可交互图表的渲染层；`VERSION.json` 记有该构建的 sha256，归属标识（attribution logo）保持开启 |
-| Investment Skills Lexicon（`7235d34`，固定快照；仅改写路由段的一句前置条件与退路） | finterm.ai | MIT | <https://github.com/finterm-ai/investment-skills> | `selected-skills/investment-skills/LICENSE` | 「精选 Skills」中的 `buffett-investment-framework` |
-| China Stock Research Skills（`d49f1f3`，未修改的固定快照） | spikeHongg | MIT | <https://github.com/spikeHongg/china-stock-research-skills> | `selected-skills/china-stock-research-skills/LICENSE` | 「精选 Skills」中的 `financial-health`、`risk-warning-catalysts`、`valuation-investment-strategy`、`strategy-business-transition`、`industry-competition-moat`、`business-decomposition-order-quality` |
-| InvestSkill（`c3f2a17`，固定快照；补 `name` 字段 + 28 颗的取数口径改写，分析正文未改） | yennanliu | MIT | <https://github.com/yennanliu/InvestSkill> | `selected-skills/InvestSkill/LICENSE` | 「精选 Skills」中的 28 个美股模块（`fact-check`、`bear-case`、`10k-digest`、`stock-valuation`、`risk-stress-test`、`tax-lens` 等） |
-
-三份 Skill 快照的收录方式、上游 commit、维护状态与排除项逐条记在各自的 `UPSTREAM.md` 里；它们**默认全部关闭**，
-只在使用者于配置页显式开启后才对新建的 Capital 会话可见，上游自带的脚本一律不作为可执行面引入。
-上游自带的编排、报告与出图 skill 不进入可选清单（六颗仍留在快照里作为可审查材料）：前者与本插件既有的角色
-路由冲突，后两者与已删除的报告交付链路、以及"出图只走 `render_chart`"的约定冲突。
-
-**两处对上游正文的改写都是合规改写，不是编辑**：上游 skill 写给"什么工具都在手边"的宿主，成规模地要求
-分析角色自己去 `web search` 取实时行情、取不到就凭印象估一个。本插件的取数只有一个入口（交给负责取数的
-角色），而"用记忆里的数字继续分析"没有任何工具会拦，所以只能改在正文里。
+| 组件 | 作者 | 许可证 | 原始仓库 | 许可文本 | 可选模块 / 快照内共 | 用在哪里 |
+|---|---|---|---|---|---|---|
+| Lightweight Charts™ 5.2.1（standalone 构建） | TradingView | Apache-2.0 | <https://github.com/tradingview/lightweight-charts> | `lib/chart/vendor/LICENSE` | — | 插件内所有可交互图表的渲染层；`VERSION.json` 记有该构建的 sha256，归属标识（attribution logo）保持开启 |
+| Investment Skills Lexicon（`7235d34`，固定快照；仅改写路由段的一句前置条件与退路） | finterm.ai | MIT | <https://github.com/finterm-ai/investment-skills> | `selected-skills/investment-skills/LICENSE` | 1 / 1 | 「精选 Skills」中的 `buffett-investment-framework` |
+| China Stock Research Skills（`d49f1f3`，未修改的固定快照） | spikeHongg | MIT | <https://github.com/spikeHongg/china-stock-research-skills> | `selected-skills/china-stock-research-skills/LICENSE` | 6 / 7 | 「精选 Skills」中的六颗 A 股模块：`financial-health`、`risk-warning-catalysts`、`valuation-investment-strategy`、`strategy-business-transition`、`industry-competition-moat`、`business-decomposition-order-quality`；快照内的 orchestrator 不开放（与本插件的角色路由冲突） |
+| InvestSkill（`c3f2a17`，固定快照；补 `name` 字段 + 28 颗的取数口径改写，分析正文未改） | yennanliu | MIT | <https://github.com/yennanliu/InvestSkill> | `selected-skills/InvestSkill/LICENSE` | 28 / 34 | 「精选 Skills」中的 28 个美股模块（`fact-check`、`bear-case`、`10k-digest`、`stock-valuation`、`risk-stress-test`、`tax-lens` 等）；另六颗（编排、报告输出口、自带出图、三颗 alias 残片）留在快照里作为可审查材料 |
+| Peter Lynch Research（`e0eaf58`，固定快照；套一层 skills 目录 + 取数口径改写，方法论、预算与输出模板未改） | Szymon Nycz（仓库账号 `DjNero11`） | MIT | <https://github.com/DjNero11/peter-lynch-skill> | `selected-skills/peter-lynch-skill/LICENSE` | 1 / 1 | 「精选 Skills」中的 `peter-lynch-skill`（个股快筛与尽调工作流，美股与境外上市口径） |
+| Trading Skills（`f1ae7d4`，固定快照；平铺掉上游的主题分组 + 取数与计算口径改写，判定档位、阈值与分析结论未改） | marian2js | MIT | <https://github.com/marian2js/trading-skills> | `selected-skills/trading-skills/LICENSE` | 9 / 19 | 「精选 Skills」中的 9 颗交易过程模块（`catalyst-map`、`watchlist-review`、`evidence-gap-check`、`thesis-validation`、`risk-reward-sanity-check`、`execution-plan-check`、`portfolio-concentration`、`journal-pattern-analyzer`、`post-trade-review`）；券商执行面那颗不进发布包，其余排除项留在快照里作为材料 |
+
+五份快照合计 **45 个可选模块**（首页「精选 Skills」那句里的两个数字与此同源，由回归测试按 catalog 现算钉住）。
+它们的收录方式、上游 commit、维护状态与逐颗排除理由记在各自的 `UPSTREAM.md` 里，并且**默认全部关闭**，
+只在使用者于配置页显式开启后才对新建的 Capital 会话可见。
+上游自带的编排、报告与出图 skill 不进入可选清单（InvestSkill 的六颗与 Trading Skills 的九颗仍留在快照里作为可审查材料）：
+前者与本插件既有的角色路由冲突，后两者与已删除的报告交付链路、以及"出图只走 `render_chart`"的约定冲突。
+Trading Skills 另外排除的几类走的是同一批约定：券商 API 执行面（在对话里采集凭据、真实下单）不进可选清单、
+也不进发布包；给仓位数字与持仓加减动作的模块按「买卖动作与仓位决策属于明确冲突」的既有口径排除；
+把取数写死成"向用户点选付费服务商再自己调接口"的三颗不收录，本插件没有那些服务商的凭据，密钥只进凭据域。
+
+**四处对上游正文的改写都是合规改写，不是编辑**：上游 skill 写给"什么工具都在手边"的宿主——前三份成规模地要求
+分析角色自己去 `web search` 取实时行情，其中两份还留着"取不到就凭印象估一个"的逃生口；最新这份一次 `web search`
+都没写，但伸手取数换了形态：`curl` 付费服务商的接口、认领对话里给过的 API 凭据，以及"能跑代码的宿主就去用共享
+python 模块"。本插件的取数只有一个入口（交给负责取数的角色），统计量交给数据侧，凭据不进对话，
+而"用记忆里的数字继续分析"没有任何工具会拦，所以只能改在正文里。
 改了什么、影响几篇，逐条记在对应快照的 `UPSTREAM.md`；改写结果由仓库自带的回归测试逐条复查。
 方法论、评分表、输出模板与分析结论一字未改。
 
+## 随包发布的是什么
+
+每份快照在 npm 包里只带**运行时正文与溯源**：那颗 skill 的 `SKILL.md` 与其附属文件、`LICENSE` 原件、
+以及本仓写的 `UPSTREAM.md`。上游仓库的其他材料（README 及其变体、它自己的 CI 与 workflow、静态站与成图、
+roadmap 与贡献指南、站点体检记录、给别的宿主用的接线配置）由该快照目录里的 `.npmignore` 挡在包外——
+那份文件是排除口径的唯一声明处，回归测试逐颗读它并拿发布清单反查（目录规则与文件规则两类都问）。
+全量快照完整住在 git，`github:` 安装与"当时是哪个 commit"的复核都不受影响。
+
+上游自带的可执行面文件（`framework.py`、`install.sh`、`Makefile`、`openai.yaml`）**照旧随包保留作为可审查材料**：
+本插件的根角色没有 shell，provider 与工具面只读取文档、从不执行它们，正文里也不许出现"跑这个脚本"的指令
+（有方法论入口的那颗同时写明了没有 shell 时直接读哪份附属文件）。不进可选清单的 skill 同样随包保留，
+但运行时读不到：技能注册的名单与原文旁路的文件名都是按可选清单现算的闭集。
+
 ## npm 运行时依赖
 
-| 包 | 版本 | 许可证 | 用途 |
+| 包 | 声明版本 | 许可证 | 用途 |
 |---|---|---|---|
-| `@deepseek-ai/schemastery` | 3.18.4 | MIT | 工具参数的 JSON Schema 构造 |
-| `zod` | 4.5.4 | MIT | 配置与持久化结构的校验 |
-| `turndown` | 7.2.4 | MIT | 网页材料 HTML → Markdown |
-| `@joplin/turndown-plugin-gfm` | 1.0.68 | MIT | 同上，表格等 GFM 扩展 |
+| `@deepseek-ai/schemastery` | ^3.18.4 | MIT | 工具参数的 JSON Schema 构造 |
+| `zod` | ^4.5.4 | MIT | 配置与持久化结构的校验 |
+| `turndown` | ^7.2.4 | MIT | 网页材料 HTML → Markdown |
+| `@joplin/turndown-plugin-gfm` | ^1.0.68 | MIT | 同上，表格等 GFM 扩展 |
+
+图表 UI、设置卡片与自选股这三个随包携带的嵌套包复用同一批运行时依赖（前者不带依赖，
+后两者分别只用 schemastery 与 zod），不各带一份副本。
 
 ## 由宿主提供、不随本包分发
 
 `@deepseek-ai/cordis`（`^4.0.2`）、`@deepseek-ai/dsh-skill` 与 `@deepseek-ai/dsh-skill-filesystem`
-（均 `0.2.0-rc.2`）由 DSH 宿主提供，本插件只声明依赖。宿主的许可见 <https://github.com/deepseek-ai>。
+（均 `0.2.0-rc.2`）由 DSH 宿主提供，本插件只声明依赖。
+三个客户端 bundle（图表卡片、设置卡片、自选股）在构建时把 `react`、`react-dom`、
+`@deepseek-ai/dsh-client-store` 与 `@deepseek-ai/dsh-client-ui-primitives` 留成 external：
+本插件既不打进去也不声明它们，运行时由宿主页面提供。宿主的许可见 <https://github.com/deepseek-ai>。
+
+## 构建期使用、不随包分发
+
+| 包 | 声明版本 | 许可证 | 构建期用途 |
+|---|---|---|---|
+| `typescript` | ^5.0.0（实测 5.9.3） | Apache-2.0 | 把仓内 TypeScript 源码编译为随包发布的 lib 产物 |
+| `esbuild` | ^0.28.2 | MIT | 打三个客户端 bundle；上面那四个 external 就是它留出来的 |
+| `js-yaml` | ^5.4.1 | MIT | 解析与校验 preset 的 patch 声明 |
+| `lightweight-charts` | 5.2.1 | Apache-2.0 | 构建期把 standalone 副本 vendored 进 lib/chart/vendor 目录，随包发布的是那份副本（见上表） |
+| `@deepseek-ai/dsh-system-prompt` | ^0.2.0-rc.2 | MIT | 只用它的类型面（一处 `import type`），编译产物里不留引用 |
 
 ## 外部数据与检索服务
 
@@ -43,9 +82,11 @@
 同花顺 Fuyao 结构化数据接口、Wind Alice 金融信披文档检索、AnySearch 网页搜索与提取、
 PaddleOCR 文档解析，以及东方财富、腾讯的公开行情接口与若干具名公开来源。
 本插件不重新分发这些服务的原始数据，图表与结论所依据的数据集只保存在使用者本机，默认保留 7 天。
+本插件也不接入券商接口：可选清单里没有任何下单、改单或读取账户的能力，密钥一律只进宿主的凭据域。
 
 ## 本插件自身
 
 Capital Generation 的原创代码与文档以 MIT 许可发布，见仓库根的 `LICENSE`。
-本文件不构成对任何第三方项目、数据源或其观点的背书；三份 Skill 快照里的方法论与结论属于原作者，
+本文件不构成对任何第三方项目、数据源或其观点的背书；五份 Skill 快照里的方法论与结论属于原作者，
 使用前请自行复核来源，尤其不要把按美股语境写的框架直接当作 A 股规则。
+交易过程类的模块（第五份）提供的是下单前的检查与下单后的复盘方法，本插件不据它们下单、不改单，也不给仓位数字。