@v587d/capital-generation 2.6.5 → 2.7.1

package/CHANGELOG.md

@@ -7,6 +7,98 @@
 - **第三位（patch）**：不破坏既有工具 / 配置 / 会话的新增与修复（如 2.1.1、2.1.2）。
 - **第二位（minor）**：有需要用户知晓的行为变更，且段内附迁移说明（如 2.1.0 的图表呈现通道重做、2.2.0 的数据源与检索来源扩容、2.4.0 的**必须换宿主版本**——本插件自己的工具与数据契约没变，所以只抬第二位）。
 
+## [2.7.1] - 2026-10-10
+
+社区 Skill 目录多了第三份快照（**35 条**可选），并把「插件」页那张配置卡片重排了一遍。既有契约
+完全没动：工具入参与返回、能力清单、四把密钥与凭据引用名、配置字段、会话日志格式、你已有的自选股
+数据与**已经开启的那几项 Skill**，全部照旧；宿主要求与 2.7.0 相同（DSH`@0.2.0-rc.2`），不必换版本。
+
+### Added
+
+- **社区 Skill 目录新增第三份快照**：`yennanliu/InvestSkill`（MIT，commit `c3f2a17`）的 28 个美股
+  模块——逐条主张核验、空头反方、披露文件与内部人追踪、压力测试、现金流与组合视角等，整份目录从 7 条
+  变成 **35 条**，默认仍然全部关闭。上游自带的流程编排照旧排除（与本插件的角色路由冲突），上游脚本
+  一条都不会被执行。整包解包体积因此从 2.2 MB→2.6 MB 那一档再抬到 **3.7 MB**（下载 1.2 MB）；每颗
+  skill 的正文、references 与脚本、`LICENSE` 与 `UPSTREAM.md` 都在包里。
+- **「精选 Skills」每一项多一颗「详情」**：点一下就摊开那份 `SKILL.md` **原文**（不渲染，就是源码，
+  可以选中复制），开之前先看看它到底让助手做什么；窗口按 `Esc`、点外面或右上角的关闭都能收起来，
+  英文代号也写在这扇窗口的标题下面。原文是**要看了才去取**的（鼠标停在「详情」上就先预热）：整份
+  目录加起来约 750 KB，
+  不该为"可能一次都不点"的动作在打开页面时就付掉；取不到会明说取不到（并说清是"这份快照读不到"还是
+  "宿主进程还没有这条读原文的通道——这时要重启 DSH，刷新页面没有用"），绝不会把"没读到"写成一份空的原文。
+
+### Changed
+
+- **插件详情页的配置从"一长条"改成三格**：「数据源」「精选 Skills」「包含的组件」各占一格，进页面
+  默认停在「数据源」。原来「数据源」标题底下压着一层「精选 Skills」小标题，读起来像是数据源的一个
+  子项——这两块其实是平级的，现在平级了；往下滚四屏才能看完的日子也到此为止。
+- **两格带数字**：「精选 Skills」标**已开启 / 收录总数**（例如 `2/35`，只标总数会让人以为整份目录
+  都开着），「包含的组件」标组件行数。取不到那个行数时**只写名字、不写数字**——把"还不知道"写成 `0`
+  就是骗你。
+- **「包含的组件」这一格的内容仍是 DSH 自己画的那份组件清单**（行开关、运行状态、"共 N 个 · 运行 N"
+  都住在它那里），我们只是把它接到这一格上：切到这一格它才显形，切走就收起。清单没有被我们重画一份，
+  所以宿主哪天改它，不会出现两处说法不一样。
+- **在「数据源」填了密钥还没按保存就切去别格，那一格会写明「数据源 未保存」**：填的东西不会因为你
+  切格子就消失，但也不会替你保存。
+- **三格的首行文字与顶部切换条之间留同样的距离**：以前每切一格版面就跳一下，看着像内容被换掉了。
+  「包含的组件」那一格也不再额外写一行"清单在下方"的说明——点这一格看到的就是那份清单。
+- **「精选 Skills」从上下排改成左右排**：能力筛选器挪到左边、按项数从多到少排（「全部」仍在最前），
+  每一项后面跟着它下面有几项（例如「美股 26」），往下翻清单时这一列一直钉在左边——以前它在最上方，
+  滚到第二十行就想筛选得先滚回去。「按能力筛选」那四个字不再占一行，屏幕读屏时仍然报得出这一组是什么。
+  **已开启的那几项排在清单最前面**（同一档里仍按目录顺序）——不过这是**下次进入这一格时**的事：刚拨完
+  开关那一行不会当场被抽走，切到别处再切回来它才升到上面（格子标题上的「已开启 / 收录总数」仍然实时）。
+- **行面上的动作变干净了**：不再印 `buffett-investment-framework` 这种英文代号，**开启后的**技能那一行
+  多出一颗「复制技能名」按钮（有边框、按得动，复制成功亮一下「已复制」再自己退回去——以前那行灰色小字
+  既不明显也没有复位，像一个一直亮着的状态）。
+
+## [2.7.0] - 2026-10-10
+
+自选股从**"你每次贴给助手看"**变成**"助手自己读得到"**，并加上三套自带的研究流程与一份默认关闭的
+社区 Skill 实验目录。按第二位（minor）口径发，因为**宿主要求变了**：本插件现在显式声明需要
+DSH`@0.2.0-rc.2` 带的 `dsh-skill` 与 `dsh-skill-filesystem`（两颗精确版本；2.6.5 只声明了宿主内核）。
+其余契约与 2.6.5 相同：既有工具的入参与返回、**94** 颗数据收集能力与 **14** 颗网页检索能力、四把密钥
+与凭据引用名、配置字段、会话日志格式，以及**你已有的那份自选股数据**，全部没动。
+
+**装完要做的两件事**：
+
+1. **新建一个 Capital 模式会话**。选用开关在主插件装配时读一次，旧会话看不到新装配的东西。
+2. 想让组合复盘直接用你面板里的仓位，先在自选股把那几只标成持仓并填占比。**不标就只是关注清单**，
+   助手不会替你把"加过自选"读成"持有"。
+
+已有清单**不需要任何处理**：持仓是新增的**可选**字段，没标过的旧条目一律按"纯关注"读，存储格式版本
+没有抬，不必清空重来。
+
+### Added
+
+- **自选股面板可以把某几只标成实际持仓并填占比**。可交易的证券（A 股、场内基金、港股、美股）那一行
+  的「更多」里多一行「持仓」，开关拨到开就标上，紧接着一行出现「持仓比例」，用 `+` / `−` 按 10 个
+  百分点调（手动输入的数不会被吸附成整十），标过的行名称标红，拨回关就取消——点这一行的文字不会误删。
+  单只最远走到 100%，那一格就置灰；因为只做多、不算空头，所有持仓加起来最多 120%，额度用完 `+`
+  同样置灰，而"标了持仓但比例还空着"的那几格永远允许继续改。**指数没有这一行**——指数不是一个可持有、
+  可配比率的标的；但历史上标过的指数持仓仍然照常标红、仍然给取消出口，只按类型画会把人锁死在里面改不掉。
+  面板与宿主共用**同一份**类型与上限表：这两件事此前分两头各判一次，一旦放宽一头就是"点了没反应"或者
+  "面板让填、宿主悄悄不收"。
+- **主 Agent 多一颗只读的 `get_watchlist`**：读你本机那份清单——代码、名称、类型、添加日期、顺序
+  （置顶在前），以及你标的持仓、自报的占比、标记日期与"距今多少天"。它**没有任何写入口**，增删与标记
+  只能由你在面板里做；通用的子 Agent 明确拿不到这颗工具。占比是**你自报的**，助手原样引用、不自行折算
+  也不补满 100%；标记距今较久、或者你说过"最近调过仓"，它会先跟你复述确认这份仓位仍然成立，再拿它做
+  组合判断。"清单读不到"与"你确实没有自选股"是两件事，话术分开，不会把读取失败说成空清单。这份清单不含
+  成本、股数与买卖流水，也不给行情——行情、财务与历史数值一律走原来的取数角色。
+- **三套自带的研究流程**（默认装载，无需开关；结论都写在最终答复里，不新增工具、角色或报告通道）：
+  单一标的完整投研报告、具体公告或事件的影响核验、持仓与组合复盘（先读上面那颗只读工具）。主 Agent 的
+  人设里补了对应的三条分流，README 新增「试试这三类研究」三段可以直接照抄的指令。
+- **社区 Skill 自选实验目录，默认全部关闭**。里面是两份 MIT 协议的固定快照：
+  `finterm-ai/investment-skills`（commit `7235d34`）与 `spikeHongg/china-stock-research-skills`
+  （commit `d49f1f3`），共 7 条可选。开关在「插件」→ **Capital Generation** → 「配置」页新增的
+  「选用 Skill」段：可按能力标签筛选，每一格旁边写着来源与仓库、状态、最近提交、下次复查日期和风险提示。
+  状态只有两种说法：`experimental`（能用，但按美股语境写，不能直接当 A 股规则）与 `watchlist`（上游
+  九十天内没有提交，启用前请自己复核内容和出处）。能力标签只说明"这条能帮上什么"，不代表推荐或背书。
+  开启后**只对之后新建的 Capital 根会话生效，子 Agent 不继承**；上游自带的编排 skill 被排除，因为它和
+  本插件既有的角色路由冲突；上游脚本只作为材料保留，一条都不会被执行。
+  体积说清楚：装出去的是**运行时正文与溯源**——每颗 skill 的正文、references 与脚本，加上两份 `LICENSE`
+  和 `UPSTREAM.md`；上游 README 用的成图和它自己的 viz 站点不进包（同一批图在仓库里还存了两份）。整包
+  解包体积因此只从 2.2 MB 抬到 2.6 MB，下载 869 kB。全量快照仍然完整住在仓库里，从 `github:` 安装、
+  或回看"它当时是哪个 commit、原文怎么写"都不受影响。
 ## [2.6.5] - 2026-10-08
 
 上游数据源的一轮**外部巡检**：仓库里新加了一条每天早上的契约巡检，不合格自动开 GitHub Issue。

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 v587d
+Copyright (c) 2026 v587d
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

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.6.5-9cf" alt="Version"></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>
 </p>
 
 # Capital Generation
@@ -26,39 +26,44 @@ Capital Generation 是运行在 [DeepSeek Harness（DSH）](https://github.com/d
 
 **🎞️视频演示：**[安装、配置与使用](https://www.bilibili.com/video/BV1fzaZ6CE9J/)。
 
-例如，你可以问：「复盘 XXXX 最近 20 个交易日的走势，结合公告和财务数据说明主要变化，并画一张量价图。」
-[样例：假期后研判报告（20261007）](docs/sample/假期后研判报告.md)。
-
 > [!IMPORTANT]
 > 本项目仍在探索中，不提供金融服务或投资建议，不保证数据完整、及时或准确，也不承诺投资回报。请自行核对来源并承担投资风险。
 
-## 开始使用
+## 快速上手
 
 > [!NOTE]
 > 适配 DSH`@0.2.0-rc.2`。已在 Linux 的 Web profile 和 Windows 桌面端验证；其他环境尚未充分测试。建议使用 `Deepseek/deepseek-flash` ，思考推理能力为 High ；GPT / Claude 尚未充分测试。
 
 1. **安装插件。** 
+
 Linux / macOS 的 Web 或 CLI profile 在终端执行，下面两条 **任选一条** ：
 
-   ```bash
-   dsh plugin --profile web add @v587d/capital-generation
-   ```
+```bash
+dsh plugin --profile web add @v587d/capital-generation
+```
+或
+```bash
+dsh plugin --profile web add github:v587d/capital-generation
+```
 
-   ```bash
-   dsh plugin --profile web add github:v587d/capital-generation
-   ```
+两条装完的功能一样：前者取 npm 上已发布的版本，后者取本仓库当前的代码。装后重启该 profile。
 
-   两条装完的功能一样：前者取 npm 上已发布的版本，后者取本仓库当前的代码。
-   安装后重启该 profile。
+DSH 桌面端在 「添加插件」 中输入，下面两条 **任选一条**：
 
-DSH 桌面端在 「添加插件」 中输入：
-`https://github.com/v587d/capital-generation` 或 `@v587d/capital-generation` 
+```input
+https://github.com/v587d/capital-generation
+```
+或
+```input
+@v587d/capital-generation
+``` 
 桌面端自带 DSH 宿主，不需要单独用 npm 安装宿主。本仓库已包含构建产物，普通用户不需要克隆仓库或运行构建命令。
 
+
 > [!NOTE]
-> 本插件所有自带密钥均免费申请、免费日常使用且不影响插件核心功能，即缺哪个密钥，仅表示对应能力就不可用，其他功能照常。
+> 本插件所有自带密钥均可免费申请、免费日常使用。 哪怕所有密钥留空也不影响插件核心功能，即缺哪个密钥，仅表示对应能力就不可用，其他功能照常。
 
-2. **选填密钥。** 打开 DSH 「插件」 → **Capital Generation** -> 「配置」。
+2. **选填密钥。** 打开 DSH 「插件」 → **Capital Generation** →「数据源」（进页面就停在这一格）。
 
    | 密钥 | 用途 |
    | --- | --- |
@@ -67,14 +72,14 @@ DSH 桌面端在 「添加插件」 中输入：
    | [Wind Alice](https://market.windalice.com/#/home) | 公告与新闻检索，以及宏观/行业/汇率指标与按日期区间取的历史 K 线 |
    | [PaddleOCR AIStudio](https://aistudio.baidu.com/paddleocr) | 解析 PDF 和图片中的文字 |
 
-   这些都是第三方服务的密钥，需分别向服务方申请；额度和条款以各服务方为准。
-   保存后**新建 Capital 模式会话**即可生效，无需重启。
-   也可以将密钥写入 `~/.dsh/.credentials.yaml`，名称依次为 `FUYAO_API_KEY`、`ANYSEARCH_API_KEY`、`WIND_API_KEY`、`PADDLE_OCR_TOKEN`。
-   密钥由 DSH 凭据服务保存，不会显示在会话配置中。
+    这些都是第三方服务的密钥，需分别向服务方申请；额度和条款以各服务方为准。
+    保存后**新建 Capital 模式会话**即可生效，无需重启。
+    也可以将密钥写入 `~/.dsh/.credentials.yaml`，名称依次为 `FUYAO_API_KEY`、`ANYSEARCH_API_KEY`、`WIND_API_KEY`、`PADDLE_OCR_TOKEN`。
+    密钥由 DSH 凭据服务保存，不会显示在会话配置中。
 
    <p align="center">
-     <a href="assets/DSH@0.2.0rc2插件主页配置.png">
-       <img src="assets/DSH@0.2.0rc2插件主页配置.png" alt="插件主页的「配置」段" width="800">
+     <a href="assets/数据源配置.png">
+       <img src="assets/数据源配置.png" alt="数据源配置" width="800">
      </a>
    </p>
 
@@ -86,29 +91,69 @@ DSH 桌面端在 「添加插件」 中输入：
      </a>
    </p>
 
-## 能做什么
+## 试试这么用
+
+在新的 Capital 模式会话中使用以下指令。将方括号内容换成自己的标的、公告或持仓；证券代码写完整市场后缀，例如 `600519.SH`。每条指令单独发送，便于观察结果。
+
+[样例：假期后研判报告（20261007）](docs/sample/假期后研判报告.md)
+
+**完整投资研究报告**
+
+```text
+请对[公司名称、俗称]([证券代码])做一份完整投资研究报告。
+以你实际取得的最新可用数据为截止，覆盖业务、财务、估值、价格走势、近期重要事件以及风险与反方观点。
+先给核心判断和最大风险；关键数字注明报告期或交易日、来源和采集时间。
+证据不足的部分注明未评估及原因，不编造目标价或收益概率。
+```
+
+**事件与公告影响分析**
+
+```text
+请核查[公司名称]([完整证券代码])的[公告标题及披露日期，或“最近一次业绩公告”]，
+分析它对经营、现金流和投资风险可能产生的影响。
+先核对公告原文、披露时间和事项进展，区分已实施事实与尚待批准的方案；
+如讨论股价反应，只比较公告后可交易时段和同窗市场走势，不把同期涨跌直接归因于公告。
+给出最大不确定性和后续验证指标，找不到原文时不要假设事件已发生。
+```
+
+**持仓与组合复盘**
+
+```text
+请复盘我的持仓[其他资产如有，请补充]。
+请先核对这些比例是否覆盖全部资产，再分析单只标的、行业与市场的集中风险，
+以及哪些风险会同时影响多个持仓。
+我没有提供交易流水或成本，不要计算期间收益、最大回撤或收益归因；
+我只在自选股里标过持仓的那几只才算仓位，没标的只是关注。
+给出最需要核实的信息和可观察的防守选项。
+```
+
+## 还能做什么
 
 - **查数据和资料：** 覆盖A股、港股、美股，由 Agents 按需获取行情、财务、指数、基金与宏观行业数据，检索公告、新闻和研报。共计 **94** 个数据收集能力和 **14** 个网页检索能力，部分公开数据源无需额外密钥；具体覆盖范围见 [数据收集能力表](docs/data-collector-capabilities.md) 和 [网页检索能力表](docs/web-retriever-capabilities.md)。
 - **数据分析：** 所有 Agents 均不直接接触原始结构数据，Agents 按需读取数据、校验数据，并写脚本挖掘数据背后含义。 
 - **可视化：** 将数据交给不同角色处理，再生成可交互图表。图表会作为本轮交付物出现在会话中，可在侧栏查看或离线打开。了解处理流程可看 [Agent 角色说明](docs/agent-roles.md)。
-- **管理自选股：** 在 Capital 会话中输入 `/` 或点击输入框旁的 `+`，从「指令」中打开「自选股」。A股、港股、美股共用这一个入口：直接敲代码或名称，候选列表会写清它属于哪个市场；清单里每一行都带市场标注，指数另标一行。某一个市场取数失败时，其余市场照常刷新，页面会说明失败的是哪一路；整体刷新失败时已有报价仍显示为旧快照，并标明时间，请勿当作实时价格。
-
-会话中的图表效果：
 
 | 走势折线 | K 线与量价 |
 | :---: | :---: |
 | <a href="assets/chart-line-sidebar.png"><img src="assets/chart-line-sidebar.png" alt="侧栏折线图" width="400"></a> | <a href="assets/chart-candlestick-sidebar.png"><img src="assets/chart-candlestick-sidebar.png" alt="侧栏 K 线图" width="400"></a> |
 
+- **管理自选股：** 在 Capital 会话中输入 `/` 或点击输入框旁的 `+`，从「指令」中打开「自选股」。
+
+| 管理自选股 | 标记持仓 |
+| :---: | :---: |
+| <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 会话生效，默认关闭。
 <p align="center">
-  <a href="assets/watchlist-popup.png">
-    <img src="assets/watchlist-popup.png" alt="自选股面板" width="420">
+  <a href="assets/selected-skills配置.png">
+    <img src="assets/selected-skills配置.png" alt="selected-skills配置" width="800">
   </a>
 </p>
 
 ## 常见问题
 
 - **安装后找不到 Capital 模式？** 确认插件出现在「插件」→ 已安装列表；Web / CLI profile 安装后要重启该 profile，并在新会话选择模式。
-- **配置在哪？** 打开「插件」→ 已安装的 **Capital Generation**，页面里的「配置」段就是；不在 DSH 的普通「设置」页面，也不用点进「包含的组件」。保存密钥后新建会话再试。
+- **配置在哪？** 打开「插件」→ 已安装的 **Capital Generation**，页面顶部就是「数据源 / 精选 Skills / 包含的组件」三格，四把密钥都在第一格；不在 DSH 的普通「设置」页面，也不用点进任何一行组件。保存密钥后新建会话再试。
 - **桌面端升级后仍是旧版？** 桌面端安装时会固定所解析的版本，不会自动升级。卸载后重新安装，再到插件详情查看版本号；如需指定版本，可在地址末尾加 `#v2.6.1` 或 `@2.6.1`。
 - **刚发布的新版本装不到？** 桌面端取包时会跳过**刚发布不久**的版本（宿主侧包管理器的发布冷却策略，实测会静默装成上一个版本），国内镜像的同步也可能滞后一段时间。急着用最新代码，改用仓库地址安装最直接。
 - **网页抓取失败？** 配置卡片中的「允许启动本地提取网页内容」默认开启：AnySearch 提取失败时可尝试本机直连。关闭后，本机直连的具名来源查询也不可用；请检查该开关和网络连接。
@@ -129,3 +174,11 @@ npm run smoke:boot  # 检查插件装配
 ```
 
 完整版本历史见 [CHANGELOG.md](CHANGELOG.md)。问题与建议可到 [Issues](https://github.com/v587d/capital-generation/issues) 或 [DSH官方 Discussions](https://github.com/deepseek-ai/deepseek-harness/discussions/6947) 交流。本项目采用 [MIT 许可](LICENSE)。
+
+## 致谢
+
+- 「精选 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`。分析方法、评分表与结论一字未改，其中的观点仍属原作者，不构成对本插件结论的背书。
+- 会话里的可交互图表由 [TradingView Lightweight Charts](https://github.com/tradingview/lightweight-charts)（Apache-2.0）渲染。
+- 行情、财务、公告与网页材料来自同花顺 Fuyao、Wind Alice、AnySearch、PaddleOCR 以及东方财富、腾讯等公开或申请制接口；数据版权归各服务方，额度与条款以服务方为准，本项目不重新分发原始数据。
+
+随包分发的第三方组件、版本与许可逐条列在 [第三方组件与许可](THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,51 @@
+# 第三方组件与许可（Third-Party Notices）
+
+本文件集中列出 Capital Generation 随包分发或调用的第三方组件：项目名、作者、许可证与原始仓库。
+本文件随 npm 包一起发布。各组件的许可全文以仓库内文件为准（下表"许可文本"列给出位置）。
+
+## 随包分发的代码与内容
+
+| 组件 | 作者 | 许可证 | 原始仓库 | 许可文本 | 用在哪里 |
+|---|---|---|---|---|---|
+| 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` 取实时行情、取不到就凭印象估一个。本插件的取数只有一个入口（交给负责取数的
+角色），而"用记忆里的数字继续分析"没有任何工具会拦，所以只能改在正文里。
+改了什么、影响几篇，逐条记在对应快照的 `UPSTREAM.md`；改写结果由仓库自带的回归测试逐条复查。
+方法论、评分表、输出模板与分析结论一字未改。
+
+## 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/cordis`（`^4.0.2`）、`@deepseek-ai/dsh-skill` 与 `@deepseek-ai/dsh-skill-filesystem`
+（均 `0.2.0-rc.2`）由 DSH 宿主提供，本插件只声明依赖。宿主的许可见 <https://github.com/deepseek-ai>。
+
+## 外部数据与检索服务
+
+以下服务由使用者自备密钥调用，**不是代码依赖，也不受上表许可约束**；接口条款、额度与数据版权归各服务方所有：
+同花顺 Fuyao 结构化数据接口、Wind Alice 金融信披文档检索、AnySearch 网页搜索与提取、
+PaddleOCR 文档解析，以及东方财富、腾讯的公开行情接口与若干具名公开来源。
+本插件不重新分发这些服务的原始数据，图表与结论所依据的数据集只保存在使用者本机，默认保留 7 天。
+
+## 本插件自身
+
+Capital Generation 的原创代码与文档以 MIT 许可发布，见仓库根的 `LICENSE`。
+本文件不构成对任何第三方项目、数据源或其观点的背书；三份 Skill 快照里的方法论与结论属于原作者，
+使用前请自行复核来源，尤其不要把按美股语境写的框架直接当作 A 股规则。