@v587d/capital-generation 2.7.8 → 2.7.9

package/CHANGELOG.md

@@ -7,6 +7,71 @@
 - **第三位（patch）**：不破坏既有工具 / 配置 / 会话的新增与修复（如 2.1.1、2.1.2）。
 - **第二位（minor）**：有需要用户知晓的行为变更，且段内附迁移说明（如 2.1.0 的图表呈现通道重做、2.2.0 的数据源与检索来源扩容、2.4.0 的**必须换宿主版本**——本插件自己的工具与数据契约没变，所以只抬第二位）。
 
+## [2.7.9] - 2026-10-13
+
+第八份 Skill 快照入驻：社区项目 **Quant Agent Skills**（`Howard-Jerry/quant-agent-skills`，MIT，钉在
+commit `03677d2`，2026-08-05）。这一份的收录口径与前七份不同，先说清楚：上游那三颗 skill 都是**自述的
+编排器**，正文指挥公开版根本不附带的私有数据层（实测三颗点名的本地路径一个都不在仓里），所以
+**一颗都不进可选清单**；本仓改为**自持一颗入口** `cross-market-listing-choice`（跨市场选线 A/H · ADR/HK），
+只挂载上游那两份零执行面、零私有引用的口径文件（逐字复制，非改写）。上游三颗与 `docs/`、`scripts/`
+等完整文件树随 git 快照保留供复核，由该快照自己的 `.npmignore` 挡在发布包之外。可选清单 **67 → 68**，
+收录项目 **7 → 8**。
+
+同版修掉精选 Skills 的一条注册路径（先建会话、再切到 Capital 模式），并收了 2026-10-10 真机复盘的
+三处往返收敛（图表 token 幂等、超预算回执带体积归因、事实核查分级）与 `data_analyst` 条文补齐。
+其余契约照旧：工具入参与返回（除下面点名的两个只读字段）、能力清单、四把密钥与凭据引用名、配置字段、
+会话日志格式、你已有的自选股数据与**已经开启的那几项 Skill** 全部没动。宿主要求与 2.7.8 相同
+（DSH`@0.2.0-rc.2`），不必换版本，升级无需迁移；两个返回面的变化都在下面写明。
+
+### Added
+
+- **跨市场选线一颗**：`cross-market-listing-choice`——同一家公司在多个市场各有上市线时（A/H、ADR/HK）
+  选一条来持有、加仓或观察：A/H 溢价与币种股息税、流动性与通道、ADR 换算比例与披露文件路径。
+  公司层面只研究一次（A 与 H 是同一家公司的两条线），价差是当天的事实、不是"折价那条会涨回来"的结论。
+  本插件没有现成的 A/H 溢价或 ADR 平价条目：溢价必须由两条线同一 as-of 交易日的收盘价加上当日汇率
+  现算，三项任缺一项就只报缺哪一项，也不用记忆里的近似汇率补数。
+- **上游三颗编排器刻意不收**（`concept-research` / `industry-research` / `stock-research`）：正文点名
+  的本地取数路径公开版没有，属"指挥 Agent 去跑公开版没有的执行面"，逐条判据与 132 处闸门命中分布见
+  `selected-skills/quant-agent-skills/UPSTREAM.md`。文件仍随快照住在 git 与发布包的材料区，运行时读不到。
+
+### Fixed
+
+- **先建会话、再切到 Capital 模式，精选 Skills 也注入了**。用户可见症状：设置卡里 10 个开关全开，
+  会话里却始终只有 preset 自带的 8 条 `capital-*`；直接从 Capital 建会话（或恢复旧会话）却正常。
+  根因是 provider 只挂在 `agent/created` 一条监听上，而建会话的真实顺序是"先按默认预设把根 Agent
+  建好、随后才 `select` 到 `capital-generation`"——`agent/created` 在那次 select 之前就发完了，
+  只挂一条时本插件的 `apply()` 是在**这次挂载里**才跑的，监听器出生就错过了自己这个 Agent。
+  现在同时挂 `agent-preset/selected`（preset registry 在挂载完成后才发这条事件，一定赶得上），
+  同一个 Agent 由 `WeakSet` 去重、注册失败撤登记以留下重试余地；子 Agent 与其他 preset 照旧不注册。
+  真机复核：重启前同一份会话的目录是「8 条 / 0 精选」，重启后同一份会话补齐「18 条 / 10 精选」；
+  新建会话（走的正是先建后切）首轮目录直接是「18 条 / 10 精选」。回归见
+  `test/selected-skills-provider.test.mjs`（先建后切注册路径 + 切换期注入失败可重试）。
+
+### Changed
+
+- **`prepare_chart_source` 幂等**：同一 `task_id` + `dataset_id` 在 TTL 内重复调用返回**同一个**
+  `chart_source_ref`（token 是读能力而非一次性凭证，`resolve` 不消费，复用没有语义损失）。
+  2026-10-10 真机：data_junior 改了视图方案后为同一 Dataset 重签，紧跟一个 7.9K 字符的思考回合；
+  人设与 skill 里"不要重签"的提醒拦不住，就把幂等沉到工具层。`capital-visualization-protocol` 同步
+  改成"再签一次也无妨，工具层保证不会签出第二个"。
+- **`describe_dataset` 超预算回执自带体积归因**：`too_large` 现在返回 `facts_bytes` / `queries_bytes`
+  （本版唯一新增的返回字段，只增不改），`hint` 直指大头（queries 大 → 去掉 queries、聚合改单独走
+  `query_dataset`；facts 大 → `columns_of_interest` 收窄列）。同日真机：两份宽表各带 5-6 条聚合打穿
+  7000 码点闸门，而旧 hint 只说"收窄列"——列本来已经很窄，超预算的其实是 queries，模型只好
+  `describe` + `query_dataset` 各来一轮，4 次调用里 2 次本可省。⛔ 体积闸门仍只有一道，没有引入
+  digest / 裁剪阶梯（`docs/dev/data-roles.md` §1.1）。
+- **外部事实核查改成分级写需求**：核心事实（直接改变结论或风险判断的——审计意见、商誉、质押/担保/
+  资金占用、现金流与利润背离、有息负债、再融资/重组、被监管调查等）≤10 条逐条核验、每条一行来源；
+  外围事实（分红方案、互动平台问答、媒体花絮）合并成一句话清单，来源整段合标。不再预设"逐条
+  URL+日期+双分类"的审计级格式，异常线索（质押、商誉减值、现金流恶化、审计非标）出现才对该项深挖。
+  同日真机：全量审计级核验产出 18 条情报、39K 输出 tokens，拖慢主结论。落点：`capital-web-protocol` §5、
+  `capital-orchestration`、`capital-equity-research`。
+- **`data_analyst` 条文补齐**（该角色仍保持 `disabled`）：启用后由主 Agent **按需激活**（不进每轮强制
+  预检），补数走与 `data_gap` 同构的 `analysis_data_request`（主 Agent 是范围闸门，只转交 brief 内的
+  请求；`blocking: true` 未决时不得写最终答复），输入只敲标量（≤20 个）、逐数核对再算、不整行复制
+  （同日真机：整段聚合行逐数敲进脚本，转写出笔误又花 7.2K 字符发更正）。落点：`docs/dev/data-roles.md`、
+  人设与 5 份协议 skill。
+
 ## [2.7.8] - 2026-10-12
 
 第七份 Skill 快照入驻：社区项目 **FinanceSkills**（`GAJETOso/financeskills`，MIT，钉在 commit `b0c6239`），

package/README.md

@@ -11,12 +11,12 @@
   <a href="https://github.com/deepseek-ai"><img src="https://img.shields.io/badge/DeepSeek_Harness-web-orange" alt="DSH Web"></a>
   <a href="https://github.com/deepseek-ai"><img src="https://img.shields.io/badge/DeepSeek_Harness-desktop-brightgreen" alt="DSH Desktop · 已实机验证"></a>
   <a href="https://github.com/deepseek-ai"><img src="https://img.shields.io/badge/DSH%20Baseline-0.2.0--rc.2-blue" alt="DSH@0.2.0-rc.2"></a>
-  <a href="https://www.npmjs.com/package/@v587d/capital-generation"><img src="https://img.shields.io/npm/v/%40v587d%2Fcapital-generation" alt="npm version"></a>
 </p>
 <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.8-9cf" alt="Version"></a>
+  <a href="https://github.com/v587d/capital-generation/releases"><img src="https://img.shields.io/badge/version-2.7.9-9cf" alt="Version"></a>
+  <a href="https://www.npmjs.com/package/@v587d/capital-generation"><img src="https://img.shields.io/npm/v/%40v587d%2Fcapital-generation" alt="npm version"></a>
 </p>
 
 # Capital Generation
@@ -144,7 +144,7 @@ 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：** 当前收录 7 个开源项目、共 67 个 Skill（默认全部关闭，在配置页按需打开；随时切换，无需新建会话，正在使用的 Capital 会话下一条指令即生效）
+- **精选 Skills：** 当前收录 8 个开源项目、共 68 个 Skill（默认全部关闭，在配置页按需打开；随时切换，无需新建会话，正在使用的 Capital 会话下一条指令即生效）
 
 | 项目名称 | 收录边界 |
 | :---: | :---: |
@@ -155,6 +155,7 @@ https://github.com/v587d/capital-generation
 | [Trading Skills](https://github.com/marian2js/trading-skills) | 11 个交易过程 Skill：催化剂排布、自选股分诊、论点压力测试、执行计划检查、入场仓位测算、持仓论点复核、交易日志复盘等，美股与境外交易口径 |
 | [Claude for Financial Services CN](https://github.com/jwangkun/claude-for-financial-services-cn) | 12 个 A 股卖方研究 Skill：业绩点评与差异表述、财报前瞻、可比倍数、A 股 DCF 口径、行业全景、催化剂日历、财务核查、晨会纪要、持仓逻辑跟踪与选股清单等 |
 | [FinanceSkills](https://github.com/GAJETOso/financeskills) | 8 个估值与财务方法 Skill：折现率（WACC）估算、三表勾稽建模、企业估值与股权价值桥、偿债能力与债务容量、预期信用损失三阶段、银行资本与流动性、保险准备金与综合成本率、账务异常排查；按 IFRS / 美股与国际准则口径写，境内监管阈值与科目名需自行对照 |
+| [Quant Agent Skills](https://github.com/Howard-Jerry/quant-agent-skills) | 1 个跨市场选线 Skill：同一家公司在 A 股与港股、或美股 ADR 与港股各有一条线时该走哪一条——价差、币种与股息税、流动性与通道、披露文件路径各不相同。公司本身只研究一次，便宜的那条线不构成"这家公司更值得买"；A/H 溢价与 ADR 平价没有现成条目，须按两条线同一天的收盘价与当日汇率现算，缺任一项就只报缺的那一项 |
 
 <p align="center">
   <a href="assets/selected-skills配置.png">
@@ -166,7 +167,7 @@ https://github.com/v587d/capital-generation
 
 - **安装后找不到 Capital 模式？** 确认插件出现在「插件」→ 已安装列表；Web / CLI profile 安装后要重启该 profile，并在新会话选择模式。
 - **配置在哪？** 打开「插件」→ 已安装的 **Capital Generation**，页面顶部就是「数据源 / 精选 Skills / 包含的组件」三格，四把密钥都在第一格；不在 DSH 的普通「设置」页面，也不用点进任何一行组件。保存密钥后新建会话再试。
-- **桌面端升级后仍是旧版？** 桌面端安装时会固定所解析的版本，不会自动升级。卸载后重新安装，再到插件详情查看版本号；如需指定版本，可在地址末尾加 `#v2.7.8` 或 `@2.7.8`。
+- **桌面端升级后仍是旧版？** 桌面端安装时会固定所解析的版本，不会自动升级。卸载后重新安装，再到插件详情查看版本号；如需指定版本，可在地址末尾加 `#v2.7.9` 或 `@2.7.9`。
 - **刚发布的新版本装不到？** 桌面端取包时会跳过**刚发布不久**的版本（宿主侧包管理器的发布冷却策略，实测会静默装成上一个版本），国内镜像的同步也可能滞后一段时间。急着用最新代码，改用仓库地址安装最直接。
 - **网页抓取失败？** 配置卡片中的「允许启动本地提取网页内容」默认开启：AnySearch 提取失败时可尝试本机直连。关闭后，本机直连的具名来源查询也不可用；请检查该开关和网络连接。
 - **Wind 那部分会消耗积分？** 会。公告与新闻检索、宏观 / 行业 / 汇率指标、按日期区间取的历史 K 线都按次消耗你在 Wind 侧的额度；额度与条款以 Wind 为准，插件不做用量封顶。没配 `WIND_API_KEY` 时这几类不可用，其余功能照常。
@@ -190,7 +191,7 @@ npm run smoke:boot  # 检查插件装配
 
 ## 致谢
 
-- 「精选 Skills」的研究、交易过程与财务方法 Skill 按固定 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)、[GAJETOso/financeskills](https://github.com/GAJETOso/financeskills)（以上均 MIT License）与 [jwangkun/claude-for-financial-services-cn](https://github.com/jwangkun/claude-for-financial-services-cn)（Apache-2.0）。快照目录、收录口径与逐颗排除理由见 [selected-skills/](selected-skills/README.md)，第三方组件与许可见下面的清单文件。
+- 「精选 Skills」的研究、交易过程与财务方法 Skill 按固定 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)、[GAJETOso/financeskills](https://github.com/GAJETOso/financeskills)、[Howard-Jerry/quant-agent-skills](https://github.com/Howard-Jerry/quant-agent-skills)（以上均 MIT License）与 [jwangkun/claude-for-financial-services-cn](https://github.com/jwangkun/claude-for-financial-services-cn)（Apache-2.0）。最后那一份只按原文收了它两份跨市场选线的口径文件，收录流程本身由本项目写；该快照另外三颗会自行派子任务取数并产出一包文件的编排流程不收录。快照目录、收录口径与逐颗排除理由见 [selected-skills/](selected-skills/README.md)，第三方组件与许可见下面的清单文件。
 - 会话里的可交互图表由 [TradingView Lightweight Charts](https://github.com/tradingview/lightweight-charts)（Apache-2.0）渲染，图上保留它自带的归属标识。
 - 行情、财务、公告与网页材料来自四类需自备密钥的服务（同花顺 Fuyao、Wind Alice、AnySearch、PaddleOCR）与一批公开口径的来源（东方财富、腾讯、新浪、财联社、华尔街见闻、巨潮互动易、上证 e互动、同花顺公开站点）；数据版权归各服务方，额度与条款以服务方为准，本项目不重新分发原始数据。
 

package/THIRD_PARTY_NOTICES.md

@@ -18,7 +18,9 @@
 | Claude for Financial Services CN（`d7585ca`，固定快照；改写 12 颗正文的取数层与出图口径，判定档位、报告骨架与分析结论未改） | jwangkun（`LICENSE` 的署名行还带着没去掉的方括号，六份 plugin manifest 另署 `Anthropic FSI China`；上游自称基于 Anthropic 官方仓库适配 A 股） | **Apache-2.0** | <https://github.com/jwangkun/claude-for-financial-services-cn> | `selected-skills/claude-for-financial-services-cn/LICENSE` | 12 / 63 | 「精选 Skills」中的 12 颗 A 股卖方研究 Skill（`china-earnings-analysis`、`china-earnings-preview`、`china-comps-analysis`、`china-dcf`、`china-sector-overview`、`china-catalyst-calendar`、`china-break-trace`、`china-variance-commentary`、`china-initiating-coverage`、`china-morning-note`、`china-thesis-tracker`、`china-idea-generation`）；正文本身就是取数目录的那颗、元技能与 alias 残片、按美股税制写的税损收割那颗、以及要求产出或读取工作簿与 deck 的十一颗都不开放；四份可运行的取数服务端不进发布包 |
 | FinanceSkills（`b0c6239`，固定快照；改写 8 颗正文里"自己跑脚本 / 用代码算"那 16 段与一句点名宿主检索工具的护栏，公式、阈值与分析结论未改） | Ayotunde Oso（仓库账号 `GAJETOso`；`LICENSE` 版权行、`marketplace.json` 的 publisher 与上游 `AGENTS.md` 另署 **KOMVIA**） | MIT | <https://github.com/GAJETOso/financeskills> | `selected-skills/financeskills/LICENSE` | 8 / 48 | 「精选 Skills」中的 8 颗估值建模与偿债 / 行业专用财务 Skill（`wacc-computation`、`company-valuation`、`three-statement-modeling`、`credit-analysis`、`ecl-computation`、`banking-compliance`、`insurance-reserving`、`forensic-accounting`）；其余 40 颗按**领域外**排除（编制视角的会计作业、内部审计与内控、个人理财与美国 / 英国税制、加密资产、私有公司语境），留在快照里作为可审查材料；上游自带的 43 份 python 计算脚本与它自己的评测夹具目录不进发布包，上游的 MCP 服务端与 Stripe / Plaid 等账户连接器连本仓都不进 |
 
-七份快照合计 **67 个可选 Skill**（快照里共有 173 颗 skill，差额逐颗记在各自的 `UPSTREAM.md` 里）。
+| Quant Agent Skills（`03677d2`，固定快照；上游三颗自述的编排器不进可选清单，只有两份跨市场选线口径按原文随包） | Jerry Wang（仓库账号 `Howard-Jerry`；上游 README 声明正文来自其个人量化系统，数据层尚未开源） | MIT | <https://github.com/Howard-Jerry/quant-agent-skills> | `selected-skills/quant-agent-skills/LICENSE` | 1 / 4 | 「精选 Skills」中的 `cross-market-listing-choice`（跨市场选线：A/H 与 ADR/HK）。**这颗的入口正文由本仓撰写**——上游那三颗都会接管会话路由并指挥公开版根本不附带的私有脚本，一颗都不能开放；随包的上游原文只有两份 overlay 口径文件（与所钉 commit 逐字节相同，核对方式与该快照的 `UPSTREAM.md` 里）；上游三颗与它的工程材料留在 git 里供复核，由快照自己的 `.npmignore` 挡在发布包之外 |
+
+八份快照合计 **68 个可选 Skill**（快照里共有 177 颗 skill，差额逐颗记在各自的 `UPSTREAM.md` 里）。
 首页「精选 Skills」那句里的两个数字与此同源，由回归测试按 catalog 现算钉住。
 它们的收录方式、上游 commit、维护状态与逐颗排除理由记在各自的 `UPSTREAM.md` 里，并且**默认全部关闭**，
 只在使用者于配置页显式开启后才对新建的 Capital 会话可见。
@@ -38,6 +40,14 @@ Trading Skills 另外排除的几类走的是同一批约定：券商 API 执行
 （含密钥申请去处与一个用环境变量决定"用哪家"的开关）、一段看起来能跑的伪调用，以及把服务商名写死的引用格式。
 其中 `china-market-data` 整颗就是那份服务商工具目录，收录它等于在本插件既有的取数协议之外再造一条取数路由；
 四份配套的服务端脚本（万得 / 同花顺 / AkShare / 新闻）与本插件不发布券商执行面是同一条线，连发布包都不进。
+第八颗（Quant Agent Skills）排除的理由与前面每一颗都不一样：**不是措辞问题，是它指挥的东西根本不在仓里。**
+上游三颗自述为编排器（接管会话路由、并行派生 5–6 个子代理再裁决），实测三颗入口点名的本地路径
+10 / 32 / 16 个，公开版**一个都不存在**——作者自己写明数据层要到 v1.1 才开源。这类正文发给使用者，
+得到的只是"教 Agent 去撞一条跑不通的指令"。所以我们从这颗只取两份口径文件（跨市场选线那两条 overlay，
+正文只含纯文本代码块、零私有路径、零跨文件引用），收录那颗的入口流程由本仓自己写。
+这也是本仓**第一次在外部快照里放一份自持正文**，许可口径因此要说清：MIT 只要求随包保留版权与许可声明，
+不要求"被改过的文件带显著声明"（上面 Apache 那一份多出来的那条义务在这颗不适用），
+而上游那两份原文我们一个字都没改，逐字节一致的核对方式记在该快照的 `UPSTREAM.md` 里。
 
 **五处对上游正文的改写都是合规改写，不是编辑**：上游 skill 写给"什么工具都在手边"的宿主——前三份成规模地要求
 分析角色自己去 `web search` 取实时行情，其中两份还留着"取不到就凭印象估一个"的逃生口；第五份一次 `web search`
@@ -51,7 +61,7 @@ python 模块"；第六颗（本颗）把形态摊成全量：每份正文自带
 改了什么、影响几篇，逐条记在对应快照的 `UPSTREAM.md`；改写结果由仓库自带的回归测试逐条复查。
 方法论、评分表、输出模板与分析结论一字未改。
 
-**本颗是七份里唯一的 Apache-2.0 快照**（其余六份为 MIT），许可义务也因此多一条：Apache-2.0 第 4 条 (b) 款要求
+**本颗是八份里唯一的 Apache-2.0 快照**（其余七份为 MIT），许可义务也因此多一条：Apache-2.0 第 4 条 (b) 款要求
 "修改过的文件本身带上显著声明"，而不只是在他处说明。所以被改写的那 12 份正文在标题下各留了一句可见的改动声明，
 点名所钉 commit 并指回该快照的 `UPSTREAM.md`；与上游逐字节相同的 51 份不带这一行。上游没有 `NOTICE` 文件，
 因此随包保留 `LICENSE` 原件与这份清单即可。