迭代18: QMT Bridge MCP 能力内建（R-020）—— 动态挂载 dsh-mcp-client + 状态出口（设置页/会话头部灯）

docs/05-需求池/R-020.md

@@ -0,0 +1,57 @@
+# 需求：R-020 QMT Bridge MCP 能力内建（神之一手自注册 MCP，去三方插件依赖）· 已定稿
+
+> 登记：2026-09-08 ｜ 来源：老师指令（2026-09-08 新需求）｜ 状态：**已定稿（2026-09-08，Q1-Q6 老师逐项确认）**
+> 归属：待立项（拟迭代 18）｜ 计划：待出 ｜ 实现状态：未开始
+
+## 需求描述（老师原始诉求）
+
+> **老师原话（2026-09-08）**：当前我们给 DSH 配置了一个 MCP，用于连接 QMT bridge，这个配置是在另一个插件中配置的（三方插件 dsh-skill-mcp-panel 在 profile cordis.patch.yml 受管块里插入 QMT_Bridge_MCP 实例——管理 UI + 写宿主 patch；真正连接的是 DSH 官方 dsh-mcp-client）。我希望可以在神之一手插件的配置 tab 中，添加了 QMTBridge 的配置后，可以**自动检查 MCP 连接信息**，这样我们**不需要依赖三方插件来加入 MCP 的能力**。
+>
+> **2026-09-08 老师澄清（指令修正）**：不要的是**第三方 dsh-skill-mcp-panel**（设置菜单「技能 / MCP」+ 它写的宿主 patch 受管块）；**依赖 DSH 官方 @deepseek-ai/dsh-mcp-client 是允许的**。实现 = 神之一手 apply 内动态挂载官方 dsh-mcp-client（参照 mcp_router 实证），**移除三方 dsh-skill-mcp-panel 及其受管块**。
+
+## 定稿语义
+
+- **MCP 能力内建**：神之一手在自己的 apply 内按 QMT 连接配置动态挂载 DSH 官方 @deepseek-ai/dsh-mcp-client（插件内管理：挂载/切换/卸载/状态都由神之一手控制），QMT Bridge 的 MCP 工具由神之一手自己接入；不再依赖三方 dsh-skill-mcp-panel 的面板与宿主 patch 受管块；
+- **REST 直连不变**（技术约束-003）：插件 UI/tab 数据仍走 REST，MCP 是插件自带的 Agent 侧能力；
+- **MCP url 自动派生**：激活连接 baseUrl + /mcp，零新增配置字段。
+
+## 讨论记录（2026-09-08，第一轮，Q1-Q6 老师逐项拍板 → 定稿）
+
+| # | 问题 | 结论（老师拍板） |
+|---|---|---|
+| Q1 | MCP 客户端挂载粒度 | **只使用当前激活的那个连接**：仅激活连接挂 1 个 dsh-mcp-client 实例（serverName 固定 QMT_Bridge_MCP，切换激活即热切换 MCP url，工具名 mcp__QMT_Bridge_MCP__* 保持稳定）；不逐连接各挂实例 |
+| Q2 | 现有三方条目处置 | **现在的移除（2026-09-08 老师澄清：移除对象 = 第三方 dsh-skill-mcp-panel）**：① 卸载/停用三方 dsh-skill-mcp-panel（其「技能 / MCP」设置菜单与宿主 patch 管理职责一并移除）；② 删除 cordis.patch.yml 中其受管块（QMT_Bridge_MCP 不再由三方写入）；**QMT 的 MCP 连接通过神之一手插件自己管理**——插件 apply 内动态挂载**官方 @deepseek-ai/dsh-mcp-client**（依赖官方库、管理在我们插件内），含连接 CRUD/激活切换的全生命周期联动 |
+| Q3 | MCP url 与字段 | **自动来**：默认派生 baseUrl + /mcp，不需要每连接 mcpUrl 覆盖字段 |
+| Q4 | 「自动检查 MCP 连接信息」口径 | **两处状态出口**：① 设置页「QMT 连接配置」连接卡片可检查（手动触发）；② **对话窗口顶端状态指示灯区新增一个 MCP 状态**（与现有持仓/盘口同步指示灯并列） |
+| Q5 | 失败与重连语义 | **采纳建议**：对齐 failOnStartupError:false + reconnect（初始连不上不拒绝插件激活；连接丢失自动指数退避重连；期间保留断开状态不崩插件） |
+| Q6 | 范围确认 | **不做通用 MCP 管理**，只做 QMT 的 MCP 内建；通用任意 MCP 服务器管理面板不做（该域属 mcp-router / dsh-skill-mcp-panel，另议） |
+
+## 定稿边界
+
+**做**：
+1. 神之一手 apply 内动态挂载/卸载 dsh-mcp-client（唯一实例，serverName=QMT_Bridge_MCP，url=激活连接 baseUrl+/mcp）；
+2. 生命周期联动：启动（激活默认/上次连接）→ 挂载；添加/编辑/删除/激活连接 → MCP 挂/切/卸（对齐现有 qmt-connections API 热切换编排）；激活连接被删自动切默认并重挂；
+3. MCP 状态出口 ×2：设置页连接卡片 MCP 检查/状态；对话窗口顶端状态指示灯区新增 MCP 状态（三态风格对齐产品约束-012 指示灯体系）；
+4. 移除三方 dsh-skill-mcp-panel：卸载其插件 + 移除宿主 cordis.patch.yml 受管块（Q2；属宿主配置变更，按 editing-cordis-compositions 技能流程操作 + 老师确认）；
+5. 失败/重连语义按 Q5（failOnStartupError:false + reconnect）。
+
+**不做（本期）**：通用 MCP 服务器管理面板（Q6，含自建「任意 MCP 管理 UI」——Q6 明确不做）；插件 UI/tab 数据源改走 MCP（技术约束-003 REST 直连不变）；多 serverName 并存；自研 MCP 协议客户端（老师定：依赖官方 dsh-mcp-client 即可，不重造轮子）。
+
+## 计划阶段待办（定稿后第一件事：技术可行性调研）
+
+1. **依赖解析实证**：one-divine-lot 运行时能否 import(@deepseek-ai/dsh-mcp-client)（宿主 CLI 依赖树 / profile node_modules 解析路径核实，对照 mcp_router 的 peerDependencies 声明与日志实证；确认后在 package.json 补 peer 依赖）；
+2. **动态挂载生命周期设计**：add/update/remove/activate 连接 → MCP 实例 挂/切/卸 编排（对齐 qmt-connections API 现有热切换逻辑，MCP url 随激活 baseUrl）；
+3. **MCP 状态查询与展示**：服务端 MCP 状态端点（已连接/断开 + 工具数 + 错误/重连信息）+ 设置页卡片检查 + 会话头部指示灯新增 MCP 状态（对齐产品约束-012/UI约束的指示灯体系）；
+4. **宿主受管块迁移**：cordis.patch.yml 移除 QMT_Bridge_MCP 块的精确操作步骤（保留块外内容逐字节不动）；
+5. 前端连接卡片表单是否需提示「MCP 将自动随激活连接启用」（Q4 落点 UI 文案）。
+
+## 关联
+
+- 终极目标：目标-001（DSH 插件形态·复用宿主 MCP 能力）、目标-008（真实交易系统接入）
+- 既有需求：R-004（QMT 连接配置，本需求数据基础：settings.qmtConnections + 激活/默认语义 + 热切换编排）；R-015（会话头部指示灯体系，MCP 状态灯并入同一区）
+- 设计约束：技术约束-003（REST 直连不变）、技术约束-008（连接配置存储/热切换）；定稿后需补新约束条目（技术约束：「插件内建 MCP 客户端注册规范」；产品约束：「MCP 状态出口（设置卡片 + 会话头部指示灯）」）
+- 参考实现：mcp_router（ds-plugins/mcp_router）——动态 ctx.plugin(dsh-mcp-client) 实证
+
+## 验收
+
+**（立项后写入迭代验收标准.md）**

docs/05-需求池/需求池索引.md

@@ -31,6 +31,9 @@
 | R-017 | 委托归属候选纳入近期清仓持仓 | 交易记录 tab 归属候选只回当前持仓——清仓后当日委托失去下拉锚点无法补关联（R-016 关联观察立项，2026-09-07 大连热电实际发生：盘中归属后被清为未关联，下拉已无做T候选）。**2026-09-07 定稿（老师指令确认方向）**：候选 = 当前持仓 + 近 7 天清仓持仓（closed 标记，选项文本「已清仓」后缀），下拉 value 改 holdingId 键控（同策略多轮不撞值），排序当前在前/清仓按 closed_at DESC；当日数据修复经 set-attribution 通道完成（非固化功能）。**2026-09-08 R-018 取代标注：7 天清仓候选退役（R-018 T2 拍板）**——归属候选改策略级 attribution-targets（迭代 16 实施），本需求「清仓后补关联」痛点根因（幽灵清仓抢先归档）已由数据域分界消除；holdingId 键控/占位安全逻辑保留。详见 R-017.md | 老师指令（2026-09-07） | P1 | 已定稿 | 2026-09-07 | 15-归属候选纳入清仓持仓 | 已实现（被 R-018 语义取代） |
 | R-018 | 交易关联驱动持仓份额动态调整（归属 = 账本写操作） | 从交易记录出发给委托关联策略/持仓时自动同步调整该策略下持仓份额（关联即账本写操作）：策略级候选 + 统一「份额分配器」（一笔委托拆 0..N 段 × 策略×量，余额默认全量可改小，允许部分关联）+ 买入加仓/建新仓（不复活旧行）、卖出减仓/归零清仓、仓不足自动截断续分、无仓关联失败；撤段逆操作（撤建仓买入=持仓作废第三态不产生假清仓历史、撤加仓=减回归零作废、撤卖出=恢复活动仓+份额加回，粒度=段、改归属原子）；**数据域分界（老师拍板）：幽灵清仓等同步机制只作用于「全部持仓」对账单域，不再写 strategy_holdings 账本**——账本生命周期只由交易关联 + 手动份额操作驱动，账本转历史唯一途径=卖出单关联 closeHolding；R-017 7 天清仓候选退役（holdingId 键控/占位保留）；漏关联软提示（账本有活动行+QMT 无此 code）。影响既有定稿：技术约束-017/产品约束-011/R-014/迭代12 幽灵清仓条款修订。详见 R-018.md | 老师指令（2026-09-08 新优化需求讨论） | P1 | 已定稿 | 2026-09-08 | 16-交易关联驱动持仓份额动态调整 | **已实现（已归档至 已完成/R-018.md，2026-09-08 验收通过）** |
 
+| R-019 | 策略会话：会话以策略当前数据为依据做复盘/分析讨论 | 让 AI 会话以策略为 Workspace（老师原话）→ **已定稿（2026-09-08，F1/F2 拍板）**：改造现有 DSH 对话窗口，对话视图首条消息前提供「讨论策略」选择（仿 DSH workspace chip Choose 体验：依据：做T ▾），选策略即把该策略**当前数据摘要**预注入会话上下文开始聊，会话中可换策略/刷新再注入；**不用 DSH 宿主工作区**（R3）；注入 = 当前持仓明细 + 全历史关联交易聚合摘要（含已清仓，F2）；只读不开放账本写（Q4=A）；产物不落盘（R2-Q4，复盘管理/落库归未来 T-002）。宿主注入通道等技术调研列计划阶段待办。详见 R-019.md | 老师指令（2026-09-08） | P1 | 已定稿 | 2026-09-08 | 17-策略会话 | 已立项（迭代 17 设计阶段） |
+| R-020 | QMT Bridge MCP 能力内建（神之一手自注册 MCP，去三方插件依赖） | 当前 DSH 的 QMT Bridge MCP 由三方插件 dsh-skill-mcp-panel 写入 profile cordis.patch.yml 受管块。**2026-09-08 定稿（Q1-Q6 老师逐项拍板）**：神之一手 apply 内动态挂载 **DSH 官方 dsh-mcp-client**（**只挂当前激活连接**，serverName 固定 QMT_Bridge_MCP，url 自动派生 baseUrl+/mcp；挂载/切换/卸载/状态由神之一手插件内管理），MCP 能力内建；**移除对象 = 三方 dsh-skill-mcp-panel**（2026-09-08 老师澄清：卸载其插件 + 移除其宿主 cordis.patch.yml 受管块，官方 dsh-mcp-client 可依赖）；MCP 生命周期随连接 CRUD/激活切换联动；状态出口 = 设置页连接卡片检查 + **会话头部指示灯区新增 MCP 状态灯**；失败重连对齐 failOnStartupError:false+reconnect；**不做通用 MCP 管理**。REST 直连不变（技术约束-003）。详见 R-020.md | 老师指令（2026-09-08） | P1 | 已定稿 | 2026-09-08 | -（拟迭代 18） | 未开始 |
+
 ## 渐进明细规划素材
 
 > 2026-08-27 老师确立「渐进明细」：前期目标笼统，先实现周边工具，做中学逐步明确计划。以下周边工具候选为规划素材，**状态为「起草」级**（未定稿，不进入计划/迭代范围），待讨论与实践中逐步明确并转入正式需求。