@v587d/capital-generation 2.8.2 → 2.9.0

package/CHANGELOG.md

@@ -5,7 +5,93 @@
 
 **版本号口径（本仓实践）**：
 - **第三位（patch）**：不破坏既有工具 / 配置 / 会话的新增与修复（如 2.1.1、2.1.2）。
-- **第二位（minor）**：有需要用户知晓的行为变更，且段内附迁移说明（如 2.1.0 的图表呈现通道重做、2.2.0 的数据源与检索来源扩容、2.4.0 的**必须换宿主版本**——本插件自己的工具与数据契约没变，所以只抬第二位）。
+- **第二位（minor）**：有需要用户知晓的行为变更，且段内附迁移说明（如 2.1.0 的图表呈现通道重做、2.2.0 的数据源与检索来源扩容、2.4.0 的**必须换宿主版本**、2.9.0 的选择器收敛与质检前置——本插件自己的工具与数据契约没变，所以只抬第二位）。
+
+## [2.9.0] - 2026-10-20
+
+新会话选择器收敛到三个用户模式：**自动模式 / 行情专家 / 资讯专员**。分析师与绘图专员继续注册，
+但从选择器和预设管理里隐藏，只由自动模式按需委派。结构化数据的质检与可视化 gate 同时改成
+**每份数据必经**：用户提不提图，都不再决定是否派分析师。宿主要求从 DSH`@0.2.0-rc.2` 抬到
+`@0.2.1-rc.2`，**本次必须换宿主版本**。
+
+### Added
+
+- **三个用户模式**：新会话选择器最前面依次是「自动模式」「行情专家」「资讯专员」，排在官方
+  `standard` / `ptc` / `minimal` / `cordis` 之前。官方模式仍保留在下方。三张卡片各有模式说明与
+  适用场景，不再把内部角色当成可独立完成的玩法。
+- **自动模式成为完整研究入口**：主 Agent 统一调度行情、资讯、质检与绘图角色，最后汇总证据、
+  来源与局限后直接答复用户；它自己仍然不取数、不画图。
+- **每份结构化数据必经分析师**：收到一份行情 / 财务数据就交给分析师做结构、时间轴、缺失与基础
+  统计检查，并完成可视化 gate。用户是否提图只影响 gate 的结论，不是派分析师的触发条件。
+- **两个可单独使用的专用模式**：行情专家可以单独取数并拿到数据引用，资讯专员可以单独查公告、
+  新闻与互动平台材料。两者都只做自己那一段，不替用户做投资判断。
+- **README 与角色说明重写**：快速上手、模式选择、数据质检与图表边界按当前行为重写，并换了
+  新会话选择器与「Agent 预设」设置页两张截图。
+
+### Changed
+
+- **角色名称统一**：原「Capital 模式」改为「自动模式」，原「市场行情」改为「行情专家」，
+  原「资讯搜索」改为「资讯专员」，原「初级分析」改为「分析师」，原「可视化图形」改为「绘图专员」。
+  显示名变化不影响历史会话，会话仍按原身份恢复。
+- **分析师与绘图专员从选择器隐藏**：两颗内部角色仍在预设注册表里，委派行才能按身份创建它们；
+  新会话的远端列表与预设管理不再展示，避免用户误开一个没有取数入口的空会话。
+- **「不要图」只收窄出图，不跳过质检**：明确说不要图时，分析师仍完成 profile 与 gate 结论，
+  只是不创建绘图专员；回传里会写明未出图是委派收窄，不是数据不支持。
+- **角色人设与协议去重**：修正五颗人设之间互相矛盾或过时的说法，包括一次性 / 异步子 Agent、
+  宿主工具可见性、结算通知与完成判定、重试次数、标签复用，以及 `data_analyst` 已停用却仍被
+  当作可用角色的旧描述。长协议继续按册放在 skills 里，人设只留每轮硬规则。
+- **装配适配 DSH 0.2.1**：委派行只保留 `agentPreset` 指针，角色人设与工具面回到各自的 preset；
+  每颗角色只挂自己需要的工具族，运行期不再维护名字级 allow 清单。用户可见结果是：单独打开
+  行情专家或资讯专员时，工具边界与自动模式委派时一致。
+- **数据角色说明同步实现**：`data_collector` 的能力数从 69 更新为 128，补齐 Wind 三条与
+  FTShare 34 条的口径；网页检索能力表里腾讯的条数改为 9。
+
+### 迁移说明
+
+- **必须先升级 DSH 到 `@0.2.1-rc.2`**。0.2.0 及更早版本不接受本版的角色 preset 形状（委派行
+  不再携带 persona / toolFilter），升级前会看到 preset 装载失败，或整个插件被宿主跳过。升级宿主
+  后更新本插件，并新建会话。
+- **已有的五把密钥、卡片设置、精选 Skills 勾选、自选股清单与持仓标记全部照旧**，不需要重设。
+- **之前直接选「初级分析」「可视化图形」的用户**：这两个入口不再出现在选择器里，旧会话仍能
+  按原身份恢复；新任务请在自动模式里提出，由主 Agent 委派。
+- **行情专家的数据仍只属于当前会话**：单开行情专家拿到的数据，别的会话或自动模式读不到。
+  要做完整研究，直接在自动模式里提问。
+- **提图不再是派分析师的开关**：无论要不要图，结构化数据都会先质检；明确不要图时只是停在
+  出图之前。图表的交付方式没变，仍作为本轮交付物出现在会话里，可在侧栏查看或离线打开。
+- `data_analyst` 继续停用，不参与选择器与委派。
+
+## [2.8.3] - 2026-10-16
+
+接入**期货与贵金属**：数据收集能力 **118 → 128** 项（新增 10 项），仍来自 FTShare（非凸科技）免费档。
+宿主要求与 2.8.1 相同（DSH`@0.2.0-rc.2`），**不必换宿主版本**；密钥沿用「插件」页卡片上 2.8.2 补的那一格。
+
+### Added
+
+- **合约与要素两颗**：某交易日全部在册期货合约清单（六家期货交易所 + 银行间债券远期），以及单只合约的
+  交易单位、合约乘数、最小变动价位、保证金说明、上市与摘牌日、交割方式。⛔ 这两张表**每只合约给两份副本**
+  （实测一个交易日 1812 行、其实只有 906 只合约），取数时会点名这件事——按行数报"多少只合约"会正好翻倍。
+- **行情与结算五颗**：单只合约的日/周/月/季 K 线（每手成交额与持仓量都在，成交额经乘数与收盘价交叉核对
+  确定是元）、每日涨跌停价、每日结算参数（结算价与投机/套保四档保证金率）、交易所仓单日报、
+  主要品种交易周报（周成交量、成交额、持仓量与同比环比；成交额经同样方式核对确定是**亿元**）。
+- **指数与持仓排名两颗**：南华商品期货指数日 K（本仓第一次有商品指数序列）、东方财富期货会员成交持仓排名
+  （一只合约 × 一家会员一行，含成交量、多头、空头、净多、净空五组排名与持仓，以及增减仓排名）。
+- **贵金属价格一颗**：AU9999 与 XAUUSD 两条日度序列。这一家实测只有这两个代码有数，且两条都停在
+  2026 年 8 月中旬——问"最近一周的金价"会拿到空，那不是取数失败，说明里写清了。
+- 三处上游口径差异由插件自己填平，使用者不用管：合约代码的交易所后缀**同一所写法不止一种**
+  （清单给 `.CFE` / `.CZC`，涨跌停与结算给 `.CFX` / `.ZCE`，而行情只认全称），会员持仓那一族对大小写
+  敏感且广期所的真名是 `gfe`（照常规写 `GFEX` 会静默拿到零行），周报的同比列上游把键名拼错了。
+- 每一项都按上游真实返回逐列核验后才登记：单位、哪些列可以为空、当日数据要 20:20 之后才开放这类采集时点
+  都写进该项说明；上游文档与实测不符的地方以实测为准并点名。免费档限流（10 QPS / 突发 20）由出口节流守住。
+
+### 迁移说明
+
+- **不需要任何动作**。已有的五把密钥、卡片设置、精选 Skills 勾选、自选股清单与持仓标记全部照旧。
+  没配 FTShare 密钥时，这 10 项仍在能力目录里，但每次取数都会点名 `FTSHARE_API_KEY` 失败，其余来源照常。
+- **仍未覆盖**：期权（这一家的免费档与全量接口表里都没有这个域，不是待办）、中金所的每日结算参数
+  （实测返回零行，同一天同品种的涨跌停价有数）、银行间品种的行情端（清单里有那 64 只，行情取不到）、
+  期货的会员龙虎榜（同一家另一个接口，一次回十二个指标、三种数据形状，需要先给数据层加"一行拆多行"
+  的能力，排在下一批）。
+- 覆盖范围见 [数据收集能力表](docs/data-collector-capabilities.md)。
 
 ## [2.8.2] - 2026-10-16
 

package/README.md

@@ -5,17 +5,20 @@
 <p align="center">
   <a href="https://github.com/v587d/capital-generation"><img src="https://img.shields.io/badge/Market-CN%20%7C%20HK%20%7C%20US-orange" alt="Market·CN+HK+US"></a>
   <a href="https://github.com/v587d/capital-generation"><img src="https://img.shields.io/badge/Financial-Agent-red" alt="Financial Agent"></a>
+  <a href="https://github.com/v587d/capital-generation">
+    <img src="https://img.shields.io/badge/%E5%93%81%E7%A7%8D-%E8%82%A1%E7%A5%A8%20%7C%E5%80%BA%E5%88%B8%20%7C%E6%9C%9F%E8%B4%A7%20%7C%E5%95%86%E5%93%81%20%7C%E8%A1%8D%E7%94%9F%E5%93%81-fedcba" alt="股票·债券·期货·商品·衍生品">
+  </a>
 </p>
 <p align="center">
   <a href="https://github.com/deepseek-ai"><img src="https://img.shields.io/badge/DeepSeek_Harness-plugin-blue" alt="DSH Plugin"></a>
   <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://github.com/deepseek-ai"><img src="https://img.shields.io/badge/DSH%20Baseline-0.2.1--rc.2-blue" alt="DSH@0.2.1-rc.2"></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.8.2-9cf" alt="Version"></a>
+  <a href="https://github.com/v587d/capital-generation/releases"><img src="https://img.shields.io/badge/version-2.9.0-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>
 
@@ -23,7 +26,7 @@
 
 > Next-Gen AI-Driven Capital Generation.
 
-Capital Generation 是运行在 [DeepSeek Harness（DSH）](https://github.com/deepseek-ai/deepseek-harness) 里的证券研究插件，面向关注 A股/港股/美股 的个人投资者。安装后，在新会话中选择 **Capital 模式**，就可以用自然语言查行情、财务数据、公告和新闻，整理分析并生成图表。它不是独立应用，需要先安装 DSH。
+Capital Generation 是运行在 [DeepSeek Harness（DSH）](https://github.com/deepseek-ai/deepseek-harness) 里的证券研究插件，面向关注 A 股、港股、美股的个体投资者。安装后，新会话的选择器里会多出 **自动模式**、**行情专家**、**资讯专员** 三个模式；日常研究选 **自动模式**，用自然语言查行情、财务数据、公告和新闻，由它安排取数、数据质检、资料检索与图表，最后给出带来源的结论。它不是独立应用，需要先安装 DSH。
 
 **🎞️视频演示：**[安装、配置与使用](https://www.bilibili.com/video/BV1fzaZ6CE9J/)。
 
@@ -33,7 +36,7 @@ Capital Generation 是运行在 [DeepSeek Harness（DSH）](https://github.com/d
 ## 快速上手
 
 > [!NOTE]
-> 适配 DSH`@0.2.0-rc.2`。已在 Linux 的 Web profile 和 Windows 桌面端验证；其他环境尚未充分测试。建议使用 `Deepseek/deepseek-flash` ，思考推理能力为 High ；GPT / Claude 尚未充分测试。
+> 适配 DSH`@0.2.1-rc.2`。已在 Linux 的 Web profile 和 Windows 桌面端验证；其他环境尚未充分测试。建议使用 `Deepseek/deepseek-flash` ，思考推理能力为 High ；GPT / Claude 尚未充分测试。
 
 1. **安装插件。** 
 
@@ -72,10 +75,10 @@ https://github.com/v587d/capital-generation
    | [AnySearch](https://www.anysearch.com/docs) | 网页搜索和正文提取 |
    | [Wind Alice](https://market.windalice.com/#/home) | 公告与新闻检索，以及宏观/行业/汇率指标与按日期区间取的历史 K 线 |
    | [PaddleOCR AIStudio](https://aistudio.baidu.com/paddleocr) | 解析 PDF 和图片中的文字 |
-   | [FTShare（非凸科技）](https://market.ft.tech/gateway/doc/p/pb8eizu3) | A 股行情与日 K 截面、主力资金流、涨跌停、龙虎榜席位、股东人数、指数权重、可转债行情与宏观利率等第二家上游口径 |
+   | [FTShare（非凸科技）](https://market.ft.tech/gateway/doc/p/pb8eizu3) | A 股行情与日 K 截面、主力资金流、涨跌停、龙虎榜席位、股东人数、指数权重、可转债行情、宏观利率，以及期货合约与贵金属行情等第二家上游口径 |
 
     这些都是第三方服务的密钥，需分别向服务方申请；额度和条款以各服务方为准。
-    保存后**新建 Capital 模式会话**即可生效，无需重启。
+    保存后**新建会话**即可生效，无需重启。
     也可以不走卡片，直接把密钥写入 `~/.dsh/.credentials.yaml`，名称依次为 `FUYAO_API_KEY`、`ANYSEARCH_API_KEY`、`WIND_API_KEY`、`PADDLE_OCR_TOKEN`、`FTSHARE_API_KEY`。
     密钥由 DSH 凭据服务保存，不会显示在会话配置中。
 
@@ -85,17 +88,35 @@ https://github.com/v587d/capital-generation
      </a>
    </p>
 
-3. **新建会话。** 在 Agent Preset 选择器中选 **Capital 模式**，然后直接描述研究问题。也可以到「设置」→「Agent 预设」把它设为默认模式。
+3. **新建会话。** 新会话的模式选择器里会看到三个自定义模式。日常研究选 **自动模式**，然后直接描述研究问题；也可以到「设置」→「Agent 预设」把它设为默认模式。
 
    <p align="center">
-     <a href="assets/mode_selector.png">
-       <img src="assets/mode_selector.png" alt="新会话选择 Capital 模式" width="800">
+     <a href="assets/session-preset-selector.png">
+       <img src="assets/session-preset-selector.png" alt="新会话选择自动模式" width="800">
      </a>
    </p>
 
+## 三个模式怎么选
+
+<p align="center">
+  <a href="assets/settings-perset-selector.png">
+    <img src="assets/settings-perset-selector.png" alt="「Agent 预设」里的三个自定义模式" width="760">
+  </a>
+</p>
+
+| 模式 | 适合什么 | 会做什么 | 边界 |
+| --- | --- | --- | --- |
+| **自动模式**（推荐） | 投研报告、事件影响、持仓复盘，以及需要同时查数、查资料和出图的综合问题 | 统一调度取数、数据质检、资料检索与绘图，汇总证据后直接答复 | 自动模式不直接取数，也不直接画图；每个数字都要有来源与截止时间 |
+| **行情专家** | 只想拿一份结构化行情、财务或宏观数据 | 查询并保存到当前会话，返回数据引用、来源与截止时间 | 只负责取数，不读取数据内容、不做判断；数据只在当前会话可用 |
+| **资讯专员** | 只要公告、新闻或互动平台材料 | 检索公告与新闻，逐条标注来源与核验状态 | 不做投资分析，也不给买卖建议 |
+
+**分析师**与**绘图专员**是自动模式的内部角色，不出现在选择器里。自动模式会在需要时创建并调度它们；它们没有独立的取数入口，单独打开也读不到本次研究的数据。
+
+**每份结构化数据都会先做质检。** 无论你有没有提图表，自动模式收到行情或财务数据后都会先交给分析师检查结构、时间轴、缺失与基础统计；要不要图是检查之后的一个判断。明确说“不要图”时，质检照做，只是停在出图之前。
+
 ## 试试这么用
 
-在新的 Capital 模式会话中使用以下指令。将方括号内容换成自己的标的、公告或持仓；证券代码写完整市场后缀，例如 `600519.SH`。每条指令单独发送，便于观察结果。
+在新的自动模式会话中使用以下指令。将方括号内容换成自己的标的、公告或持仓；证券代码写完整市场后缀，例如 `600519.SH`。每条指令单独发送，便于观察结果。
 
 [样例：假期后研判报告（20261007）](docs/sample/假期后研判报告.md)
 
@@ -131,21 +152,21 @@ https://github.com/v587d/capital-generation
 
 ## 还能做什么
 
-- **查数据和资料：** 覆盖A股、港股、美股，由 Agents 按需获取行情、财务、指数、基金与宏观行业数据，检索公告、新闻和研报。共计 **118** 个数据收集能力和 **14** 个网页检索能力，部分公开数据源无需额外密钥；具体覆盖范围见 [数据收集能力表](docs/data-collector-capabilities.md) 和 [网页检索能力表](docs/web-retriever-capabilities.md)。
-- **数据分析：** 所有 Agents 均不直接接触原始结构数据，Agents 按需读取数据、校验数据，并写脚本挖掘数据背后含义。 
-- **可视化：** Agent 视情况将校验后数据交给可视化专家生成可交互图表。图表会作为本轮交付物出现在会话中，可在侧栏查看或离线打开。了解处理流程可看 [Agent 角色说明](docs/agent-roles.md)。
+- **查数据和资料：** 覆盖 A 股、港股、美股与期货等品种，由专用角色按需获取行情、财务、指数、基金、宏观行业与期货数据，检索公告、新闻和研报。共计 **128** 个数据收集能力和 **14** 个网页检索能力，部分公开数据源无需额外密钥；具体覆盖范围见 [数据收集能力表](docs/data-collector-capabilities.md) 和 [网页检索能力表](docs/web-retriever-capabilities.md)。
+- **数据质检：** 结构化数据不会直接进入模型上下文。每份数据先由分析师检查结构、时间轴、缺失与基础统计，再按受控方式汇总；原始数据行始终留在工具层。
+- **可视化：** 分析师判断数据适合图表，或你明确要图时，绘图专员会生成可交互图表；明确不要图时只完成质检。图表作为本轮交付物出现在会话里，可在侧栏查看或离线打开。了解处理流程可看 [Agent 角色说明](docs/agent-roles.md)。
 
 | 走势折线 | 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 会话中输入 `/` 或点击输入框旁的 `+`，从「指令」中打开「自选股」。
+- **管理自选股：** 在任意 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：** 当前收录 8 个开源项目、共 68 个 Skill（默认全部关闭，在配置页按需打开；随时切换，无需新建会话，正在使用的 Capital 会话下一条指令即生效）
+- **精选 Skills：** 当前收录 8 个开源项目、共 68 个 Skill（默认全部关闭，在配置页按需打开；随时切换，无需新建会话，正在使用的会话下一条指令即生效）
 
 | 项目名称 | 收录边界 |
 | :---: | :---: |
@@ -166,17 +187,17 @@ https://github.com/v587d/capital-generation
 
 ## 常见问题
 
-- **安装后找不到 Capital 模式？** 确认插件出现在「插件」→ 已安装列表；Web / CLI profile 安装后要重启该 profile，并在新会话选择模式。
+- **安装后找不到模式？** 确认插件出现在「插件」→ 已安装列表；Web / CLI profile 安装后要重启该 profile，并在新会话选择模式。选择器里应看到自动模式、行情专家、资讯专员；分析师和绘图专员是自动模式的内部角色，不会出现在这里。
 - **配置在哪？** 打开「插件」→ 已安装的 **Capital Generation**，页面顶部就是「数据源 / 精选 Skills / 包含的组件」三格，五把密钥都在第一格；不在 DSH 的普通「设置」页面，也不用点进任何一行组件。保存密钥后新建会话再试。
-- **升级到 2.7.11 后，卡片里的开关回到默认值了？** 这一版把插件内部两个组件换了目录名，宿主按旧路径记住的那份保存值因此接不上。四把 API Key、你的自选股清单与持仓标记都不受影响；「精选 Skills」的勾选、附加人设与「本机直连」开关需要重新设一次并保存，之后就稳定了。已经设过的话，旧的那份仍写在 DSH 的 profile 文件里，手改那一行的路径也能取回来。
-- **桌面端升级后仍是旧版？** 桌面端安装时会固定所解析的版本，不会自动升级。卸载后重新安装，再到插件详情查看版本号；如需指定版本，可在地址末尾加 `#v2.8.2` 或 `@2.8.2`。
+- **升级到 2.9.0 后，分析师和绘图专员去哪了？** 这一版把它们收进自动模式内部，不再出现在选择器与预设管理里，避免误开一个没有取数入口的空会话。旧会话仍能按原身份恢复；新任务直接用自动模式提出即可。
+- **桌面端升级后仍是旧版？** 桌面端安装时会固定所解析的版本，不会自动升级。卸载后重新安装，再到插件详情查看版本号；如需指定版本，可在地址末尾加 `#v2.9.0` 或 `@2.9.0`。
 - **刚发布的新版本装不到？** 桌面端取包时会跳过**刚发布不久**的版本（宿主侧包管理器的发布冷却策略，实测会静默装成上一个版本），国内镜像的同步也可能滞后一段时间。急着用最新代码，改用仓库地址安装最直接。
 - **网页抓取失败？** 配置卡片中的「允许启动本地提取网页内容」默认开启：AnySearch 提取失败时可尝试本机直连。关闭后，本机直连的具名来源查询也不可用；请检查该开关和网络连接。
 - **Wind 那部分会消耗积分？** 会。公告与新闻检索、宏观 / 行业 / 汇率指标、按日期区间取的历史 K 线都按次消耗你在 Wind 侧的额度；额度与条款以 Wind 为准，插件不做用量封顶。没配 `WIND_API_KEY` 时这几类不可用，其余功能照常。
-- **运行时主 Agent 没有加载已打开的精选 Skill？** 由 LLM 判断是否值得加载精选 Skill，如果你需要强制使用某一种技能，可通过 `/技能名称` 斜杠命令的形式手动加载已在设置中打开的 Skill。
+- **自动模式没有加载已打开的精选 Skill？** 由 LLM 判断是否值得加载精选 Skill，如果你需要强制使用某一种技能，可通过 `/技能名称` 斜杠命令的形式手动加载已在设置中打开的 Skill。
 - **精选 Skill 的方法论很长，Agent 读得完吗？** 读得完。超过一次可读长度的正文已经重排成「入口 + 分册」：Agent 先看入口目录，需要具体规则、模板或阈值时把对应那一册整本读进来，并会告诉你它读了哪几册、哪些没读。设置卡片里的「看原文」仍然只给入口那一份，想看某一册直接问 Agent。
 
-目前 Windows 桌面端有一项[已知宿主差异](CHANGELOG.md)：主 Agent 的部分工具限制可能不生效。请特别留意它实际调用了哪些工具；结构化数据的取数限制仍由工具自身执行。
+目前 Windows 桌面端有一项[已知宿主差异](CHANGELOG.md)：自动模式的出图与检索限制可能不生效。请留意它实际调用了哪些工具；结构化数据的取数边界仍由工具层执行。
 
 ## 开发与贡献 
 普通用户不需要执行下面的命令。修改源码时请参考 [贡献指南](CONTRIBUTING.md) 和 [开发约定](AGENTS.md)：

package/chart-ui/README.md

@@ -1,6 +1,6 @@
 # @v587d/capital-charts
 
-Capital 模式的图表前端组件。**它不是独立安装的包**——它是 `@v587d/capital-generation`
+自动模式的图表前端组件。**它不是独立安装的包**——它是 `@v587d/capital-generation`
 随包携带的嵌套包，由后者 `cordis.patch.yml` 里的 `insert` 行以 host 平面挂载。
 
 ## 为什么是一个嵌套包，而不是主包的一部分

package/chart-ui/client.src.cjs

@@ -1,17 +1,8 @@
 /**
- * `@v587d/capital-charts` browser half.
- *
- * 单一 surface：`tool.call.toolview['render_chart']` —— 图表生成过程的明细卡片
- * （子会话与展开视图里都能看）。数据经 `/capital-charts/<chart_id>.json` 旁路取，
- * 不进任何 Agent 上下文。
- *
- * ⚠️ 这里**没有** turn-tail 卡片，且不要再加回来（2026-09-18 事故，实测根因）：
- * 内嵌卡片依赖宿主往会话里追加自定义事件 `capital/chart-rendered`，而会话日志的事件
- * 词汇表是闭集——`Session.append` 无法设置 `ignorable`，非 first-party 事件写进去之后，
- * **整份会话在冷加载时会被 fail-closed 拒绝**（6 份会话 `failed to observe session`）。
- * 现在图表以官方 `deliverables/presented` 登记为「本轮交付」，用户在收尾的交付行点开
- * `chart.html`，由官方 document preview 的 script-enabled iframe 渲染自包含图表
- * （见 src/chart/events.ts）。**呈现走官方通道，客户端不再需要任何图表专属投影。**
+ * `@v587d/capital-charts` browser half: one `render_chart` toolview fed by the
+ * `/capital-charts/<id>.json` route. No turn-tail card or custom session event:
+ * the vocabulary is closed and non-first-party events make cold load fail closed.
+ * Delivery goes through `deliverables/presented`.
  */
 const { useEffect, useRef, useState, createElement: h } = require('react')
 const LightweightCharts = require('lightweight-charts')
@@ -28,7 +19,7 @@ function readReceipt(block) {
         const parsed = JSON.parse(item.text)
         if (parsed && typeof parsed === 'object') return parsed
       } catch {
-        // Not the structured receipt; continue scanning.
+        // Not the structured receipt; keep scanning.
       }
     }
   }
@@ -50,7 +41,7 @@ function ChartCanvas(props) {
       try {
         if (chart && typeof chart.remove === 'function') chart.remove()
       } catch {
-        // The host removed the card.
+        // The host already removed the card.
       }
     }
   }, [props.payload])
@@ -85,7 +76,7 @@ function useJson(url) {
   return { value, error }
 }
 
-/** 工具过程明细：保留在子会话与展开视图里。 */
+/** Tool detail card, also visible in child sessions and the expanded view. */
 function ChartView(props) {
   const block = props.block
   const settled = Boolean(block) && block.kind === 'tool-result'

package/chart-ui/index.js

@@ -1,10 +1,7 @@
 /**
- * `@v587d/capital-charts` 的 host half。
- *
- * It owns only opaque chart registrations and their browser route. It never
- * reads Dataset files itself; render_chart supplies the resolved chart series
- * path, and the turn event published by the plugin carries the small metadata
- * the client renders.
+ * Host half of `@v587d/capital-charts`: opaque chart registrations plus their
+ * series route. render_chart supplies the resolved file path; this half never
+ * reads Dataset files itself.
  */
 
 export const name = 'capital-charts'
@@ -77,18 +74,9 @@ function pathnameOf(req, res) {
 }
 
 /**
- * Build the series route handler.
- *
- * @param store - the opaque chart registry.
- * @param options.authorize - optional `(req) => 401 | 403 | undefined`. When it
- *   returns a status the handler answers with that status and never touches the
- *   registry, so an unauthenticated caller learns nothing about `chart_id`.
- *   `apply()` passes `connection.requestRejection` here: that is the same
- *   trusted-Host fence + signed browser cookie every other session-scoped Web
- *   route runs behind (`/api`, the static index), and a route that skips it is
- *   readable by any local process or page that learns a `chart_id`
- *   (2026-09-17 review). A composition with no `connection` service (no browser
- *   auth plane at all) passes nothing and keeps the old behaviour.
+ * `options.authorize` receives `connection.requestRejection` (trusted-Host 403 +
+ * signed cookie 401); a returned status answers before the registry is touched,
+ * so an unauthenticated caller learns nothing about `chart_id`.
  */
 export function createRouteHandler(store, options = {}) {
   const authorize = options.authorize
@@ -98,8 +86,7 @@ export function createRouteHandler(store, options = {}) {
       try {
         rejection = authorize(req)
       } catch {
-        // An authorizer that cannot answer must not fall through to the data:
-        // fail closed on the same status the platform uses for a missing cookie.
+        // Fail closed: an authorizer that cannot answer must not mean "no auth".
         rejection = 401
       }
       if (rejection !== undefined && rejection !== null) {
@@ -162,13 +149,8 @@ export function apply(ctx) {
   })
 
   /**
-   * 认证围栏：优先解析 host 平面的 `connection`（web profile 由
-   * `@deepseek-ai/dsh-client-connection` 提供），把它的 `requestRejection`
-   * 原样接到本路由上——trusted-Host（403）+ 签名 cookie（401）。
-   *
-   * 惰性解析而不是 apply 时解析一次：`connection` 与本行的挂载先后不由我们决定。
-   * 服务整体缺席（Electron/file:// 这类没有浏览器认证面的载体）时返回 undefined，
-   * 退化成"没有认证面"的旧行为；但**解析抛错**（上下文已销毁）一律 401，宁可拒绝。
+   * Resolve `connection` lazily: its mount order is not ours. Absent service
+   * (Electron / file://) = no auth plane; a throwing resolve fails closed 401.
    */
   const authorize = (req) => {
     let connection
@@ -195,11 +177,8 @@ export function apply(ctx) {
       'capital-charts: series route',
     )
   }
-  // 只走 inject，不许"先 get 探测、再直接拿属性"。`ctx.get('webServer')` 能解析出值
-  // **不代表** `ctx.webServer` 这个属性访问合法：cordis 的属性代理只认"本层声明过 inject"
-  // （ReflectService 找不到就抛 cannot get property "webServer" without inject）。探测式写法
-  // 把正确性押在装配顺序上——桌面端 webServer 在本行之前已就绪，于是走了"直接调用"那条并
-  // 当场炸（2026-09-30 实机：capital-charts 与 capital-watchlist 两行 异常）；web profile 里
-  // 它还没就绪，反而躲过。inject 两种顺序都对：已就绪立刻起，没出现就一直等（本行仍激活）。
+  // Only through inject: `ctx.get('webServer')` resolving does not make
+  // `ctx.webServer` legal (cordis requires a declared inject); probing bets
+  // correctness on mount order and crashed on desktop.
   ctx.inject(['webServer'], registerRoute)
 }

package/chart-ui/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@v587d/capital-charts",
-  "version": "2.8.2",
-  "description": "Capital 模式的图表前端组件（浏览器半边 + 序列旁路路由）：由 @v587d/capital-generation 随包携带并作为 host 平面行挂载。",
+  "version": "2.9.0",
+  "description": "自动模式的图表前端组件（浏览器半边 + 序列旁路路由）：由 @v587d/capital-generation 随包携带并作为 host 平面行挂载。",
   "license": "MIT",
   "type": "module",
   "exports": {