@furongjun1999/dsh-memory 0.4.8 → 0.4.9

package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md

@@ -0,0 +1,286 @@
+# 灵枢自我改进工作计划
+
+—— 基于六篇外部研究与一份实践视频的系统化吸收 · v1.0
+
+> 证据基线：GBrain（garrytan/gbrain，30k★）、REMem（arXiv 2602.13530，ICLR 2026）、
+> MRAgent（arXiv 2606.06036，ICML 2026）、MAGE（arXiv 2608.29678）、
+> Wayfinder（agent 规划技能）、上下文工程实践视频、
+> Dream-RSI（arXiv 2609.14858，Google/DeepMind）。
+> 每条改动标注证据来源：[GB] [RE] [MA] [MAGE] [WF] [DRSI] [V5]。
+
+日期：2026-09-19 · 状态：计划 v1.0（待荣裁定）· 关联：白箱化纲领、条件论、
+蜂巢跨端验证与同步协议 v0.1、多 Harness 适配设计
+
+---
+
+## 0. 元原则：计划自身的形态
+
+本计划采用 Dream-RSI 的三段闭环作为**元结构**——每个阶段不是清单的
+罗列，而是一个可独立验收的迷你循环：
+
+> **改造 → 回放验证 → 量化 → 选拔 → 回归**
+
+- **改造**：对灵枢记忆/协议/检索做一次结构性变更；
+- **回放验证**：变更必须在**历史数据**上证明不劣化——用灵枢已有的
+  完整留痕（会话记录、审核记录、回执、认知图真源）作为回放沙盘，
+  新旧版本在全部历史查询上对比；
+- **量化**：验收指标数值化（见 §7 指标体系），拒绝"感觉更好"；
+- **选拔**：回放分不劣化（含旧版本作为候选 → 单调门 [DRSI]）才进入真源；
+- **回归**：阶段完成后立即投入真实任务流（蜂巢运行），用真实使用
+  暴露沙盘盲区，驱动下一阶段（[DRSI] 边界：回放不知未探索区域）。
+
+零条改动绕过此循环。这是 Dream-RSI 对本计划的最大贡献：
+**自改进的安全形态 = 回放沙盘 + 单调门 + 周期性回归真实**，
+而非"文字教训注入"形态（[DRSI] 反直觉发现：文字指导一致拖累表现）。
+
+---
+
+## 1. 现状盘点：主战场与缺口
+
+**已建成（主战场，不动摇）**：
+五层认知图、CCG 六要素条件卡、四态判定（含 BLINDSPOT）、
+D_norm 信息差、审核队列（DEFER → can_admin 裁决）、supersede/forget/
+protect 撤回体系、蜂巢多实例互验（跨端验证协议 v0.1：水位/心跳/回执
+逐字纪律）、hive 任务队列、三端 kernel surface（cg/stg）、渲染管线
+（真源 → render → verify 防漂移）、白箱化纲领。
+
+**外部对照后的两个缺口 + 一个盲区**：
+1. **使用侧缺口**：检索为单步路由/读取，缺图遍历原语与时间算子
+   （[RE][MA] 两篇独立证实这是数量级差距来源）；
+2. **模型侧缺口**：事实无显式有效期，时间只是元数据而非推理维度
+   （[GB][RE][MAGE] 三篇独立指向）；
+3. **治理盲区**：治理强度从未被量化——supersede 传播率、矛盾处理率、
+   过期取回率无数字（[MAGE] 给出三个现成指标定义）；
+4. **自改进盲区**：evolve/consolidate 无回放沙盘与单调门（[DRSI]）。
+
+---
+
+## 2. 负面清单：明确不做的
+
+防止吸收变成照搬。以下为**有意不采纳**的外部设计：
+
+| 不做 | 理由 |
+|---|---|
+| per-language 原生索引器（[GB] tree-sitter 全语言 WASM，≈70MB）| 灵枢走统一语义归一路线；语言无关的结构化表示是本体，格式只是来源 |
+| 把 insight/教训作为提示词常驻注入（[DRSI] 反例）| 文字指导 = 有损压缩 + 语义偏置；教训以可回放记录存在，按需派生 |
+| 入库前放弃裁决改为事后撤回（[GB] 模式）| 事前裁决是灵枢信任模型的核心；GBrain 的事后账本可借鉴为**补充**而非替代 |
+| surface 全量开放给所有 agent | 保持 kernel surface 收缩 + 阶梯 fail-closed（[GB] 阶梯设计本身采纳，默认档保持最小）|
+| 记忆图静态单调增长（[MA] 自认局限）| 灵枢的更新/遗忘是主场，反向输出而非吸收 |
+
+---
+
+## 3. 阶段一：基础字段与冻结协议（数据模型升级）
+
+**目标**：事实的生命周期与治理状态在数据模型上显式化。
+
+### 3.1 双时间轴字段 [GB][RE][MAGE]
+条件卡新增：
+- `believed_at`（信念时间：体系何时确认此条——supersede/审核的锚）；
+- `effective_from / effective_until`（效力时间：事实在任务世界何时有效）；
+- `expired_at` + 过期查询语义（过期≠删除，是查询默认过滤）。
+验收：全部历史条件卡回填后，按效力区间过滤的历史查询回放结果
+与人工标定一致。
+
+### 3.2 巩固字段一等公民化 [GB]
+新增 `consolidated_at / consolidated_into`（自引用）——归并/insight
+操作从流程记录升级为可追溯字段。
+验收：任一合并后的条目可定位其全部前身。
+
+### 3.3 裁决枚举扩为四类 [MAGE]
+审核队列裁决从 ACCEPT/REJECT(+edit/merge) 扩为显式
+**ADD / UPDATE / DELETE / NOOP**——NOOP（"已评估，判定不改变任何
+现有记忆"）成为被记录的判定而非静默忽略。
+验收：NOOP 有留痕、有统计（§6 指标输入）。
+
+### 3.4 冻结动词协议 v1 [GB]
+为灵枢 MCP 记忆工具面（kernel surface 的记忆相关操作）定义
+《灵枢记忆动词协议 v1》：字段名与语义冻结、只增不破坏、
+`protocol_version` 随行、**conformance 测试**钉死形状。
+范围先行收窄：`route / read / write / supersede / forget` 五动词。
+验收：三端（DSH/ZCode/CodeBuddy）按协议文档独立实现客户端，
+conformance 全绿。
+
+### 3.5 fence 真源绑定 [GB]
+条件卡与 Markdown 真源之间加"往返列"（真源 slug + 行位），
+实现 DB 行 ↔ 真源文件双向定位。
+验收：任一条件卡可定位真源精确行；真源重排后按 reconciler 重建。
+
+**回放验证**：全部历史条件卡与审核记录在新模型上重放
+（route/read/write/supersede 逐条），结果与旧模型逐字节一致
+（纯字段增列，不改既有语义）。
+**风险**：低（增列不动既有语义）。**依赖**：无。
+
+---
+
+## 4. 阶段二：检索原语（使用侧补强）
+
+**目标**：把 `cg` 的检索从单步路由升级为可组合的图遍历原语，
+agent 端获得多步推演的能力面。
+
+### 4.1 时间算子 [RE]
+所有检索原语接受 `start_time, end_time, start_operator, end_operator`
+参数——时间是一等检索参数且带比较算子（§3.1 的字段在此兑现）。
+
+### 4.2 find_entity_contexts 式原语 [RE]
+`subject / object / predicate + 时间条件 + limit / ordering / offset /
+aggregation`——按三元组任意端与谓词反查。
+
+### 4.3 tag 枢纽层 [MA]
+cues（细粒度线索）与内容之间加"短标签"检索枢纽
+（≤2 词，`query_tag_events` 式），先查 tag 再展开内容。
+
+### 4.4 反向遍历 [MA]
+`Content → (Cue, Tag)`——从已取内容反查来源线索、由线索激活
+相邻记忆，暴露为独立检索动作。
+
+### 4.5 f_route 式剪枝 [MA]
+多步遍历中每步由 LLM 剪枝无关分支——[MA] 数据：剪枝使 token
+118k vs 245k/632k（−52%~−81%），多步反而省。
+
+### 4.6 能力探测降级 [GB]
+检索入口探测能力：无 embedding 依赖时自动降级 BM25 式关键词——
+零配置可用的底线体验。
+
+**回放验证**：新原语在全部历史查询上对比单步基线——
+召回集是旧法的超集（单调门），且引入的噪声由剪枝控制
+（f_route 的准确率回放对比）。
+**风险**：中（新原语的误用噪声）。**依赖**：§3.1（时间字段）。
+
+---
+
+## 5. 阶段三：治理量化（把主场变成可测的主场）
+
+**目标**：灵枢最强的治理维度获得数字。[MAGE] 给出三个现成定义。
+
+### 5.1 治理指标三件套 [MAGE]
+- **修正传播率**：一次 supersede 之后，下游引用它的节点同步失效/
+  更新的比例（MAGE 91.2%）；
+- **矛盾处理率**：新证据与旧记忆矛盾时被正确裁决（取代/失效）
+  的比例（MAGE 88.5%）;
+- **过期取回率**：查询返回已过期信息的比例（MAGE 3.1%，越低越好）。
+
+### 5.2 拒答/无知量化 [RE]
+四态判定的 BLINDSPOT 获得 REMem 式量化：不可答问题的
+拒答精确率/召回率/F1（REMem F1 64.0 为对照线）。
+"显式表达无知"从设计变成可打分的能力。
+
+### 5.3 公开基准体检 [RE]
+以 LoCoMo（长对话回忆，与蜂巢会话场景最近）为首个外部基准，
+灵枢记忆对标准流程跑分，与 Mem0/HippoRAG 2/REMem 公开数字对照。
+仅测差距，不为其改架构。
+
+### 5.4 BLINDSPOT 票据化 [WF]
+BLINDSPOT 生成时追问"缺的是哪类信息"，自动生成对应类型消解票据
+（research / prototype / grilling / task）挂入依赖图——
+无知从状态标记升级为可分派工单。grilling 类型由既有 grill 工具承接。
+
+**回放验证**：指标基线先在"不改动"的当前版本上测出
+（这是基线定义，无单调门问题）；随后每次治理相关改动
+对照基线报告三指标变化。
+**风险**：低（测量不改行为）。**依赖**：§3.3（NOOP 枚举）。
+
+---
+
+## 6. 阶段四：角色化读取与超边形式化（蜂巢侧）
+
+**目标**：蜂巢多实例的记忆读取按角色差异化；协作事件形式化。
+
+### 6.1 角色化读取 [MAGE]
+主代理读"结论与修正历史"，验证端读"判据面与环境陷阱"，
+回执任务读"命令与预期输出"——同一记忆库，按角色过滤视图。
+验收：角色化读取后各角色任务的 token 消耗与判据命中率
+对照无差别全量读取。
+
+### 6.2 超边形式化 [MAGE]
+把"一次跨端验证"显式定义为超边类型：参与者集合、证据集合、
+修正集合、时间范围——互验协议 v0.1 的文件组约定升级为
+可被外部工具理解的正式结构（对齐 MAGE 的第一类超边）。
+验收：任一历史验证回执可从超边完整重建。
+
+**依赖**：§3 全部（超边字段引用双时间轴与裁决枚举）。
+**回放验证**：历史互验记录全部迁移为超边后，水位/心跳/回执
+语义逐字不变。
+
+---
+
+## 7. 阶段五：回放沙盘（自改进闭环，终局）
+
+**目标**：灵枢的 evolve/consolidate/白箱自举获得 Dream-RSI 形态的
+安全自改进。
+
+### 7.1 历史留痕升级为可回放世界 [DRSI]
+会话记录、审核记录、回执、认知图真源——这些本来就完整留痕的
+历史，封装为**可回放世界**：任意记忆/策略变更，可以在历史上
+全部真实查询与任务回执上离线重放。
+
+### 7.2 单调门 [DRSI]
+自改进候选（新词条、新路由策略、新归并规则）在回放世界上
+与现役版本同台比试；候选集含现役版本 → **历史回放分单调不退化**
+才被选拔。
+
+### 7.3 周期性回归与盲区标记 [DRSI]
+回放只覆盖已探索区域——沙盘选拔后周期性回归真实任务流，
+新暴露的未探索区域以 BLINDSPOT 显式标记（§5.4 票据化承接），
+驱动下一轮在线探索。
+
+**回放验证**：本阶段自身的验收即 Dream-RSI 数字——自改进操作
+历史回放分单调不退化 + 真实任务流上无回归 + Lasso 式成本节省
+（对照：人工演进）。
+**风险**：高（新机制）。**依赖**：§3–§5 全部 + 蜂巢历史留痕完整
+（已满足：会话/审核/回执本就全留痕）。
+
+---
+
+## 8. 指标体系（贯穿验收）
+
+| 指标 | 定义 | 来源 | 基线 |
+|---|---|---|---|
+| 修正传播率 | supersede 后下游同步失效比例 | [MAGE] | 待测（当前无数字）|
+| 矛盾处理率 | 矛盾证据被正确裁决比例 | [MAGE] | 待测 |
+| 过期取回率 | 查询返回已过期信息比例 | [MAGE] | 待测 |
+| 拒答 F1 | 不可答问题的显式拒答 | [RE] | 对照线 64.0 |
+| 检索召回超集率 | 新原语召回 ⊇ 旧法召回比例 | 本计划 | 100%（单调门）|
+| token 效率 | 同等任务 token 消耗 | [MA] | 对照 −50% 目标 |
+| 回放分单调性 | 候选 vs 现役回放分 | [DRSI] | 不退化 |
+| 接入成本 | 新 harness 接入所需理解面 | [GB] | 15 分钟对齐 |
+
+---
+
+## 9. 风险与边界
+
+1. **回放盲区** [DRSI]：沙盘单调 ≠ 真实不退化——每阶段以真实任务流
+   回归收口，新盲区以 BLINDSPOT 标记；
+2. **上游提取质量** [MAGE 同款限制]：语义归一依赖 LLM 抽取——
+   抽取失真会进库。缓解：来源留痕 + fence 往返（可审计回原文）、
+   受控翻译（标识符白名单）；
+3. **协议冻结的不可逆**：v1 冻结是单向门——字段命名与语义需在
+   三端实测收敛后再冻结，冻结前允许破坏性调整；
+4. **工程容量**：阶段四、五重（蜂巢改造 + 新机制），阶段一至三
+   轻（字段 + 原语 + 测量）。顺序即风险排序。
+
+---
+
+## 10. 摘要对照总表
+
+| 条目 | 证据 | 落点 | 阶段 |
+|---|---|---|---|
+| 双时间轴 | [GB][RE][MAGE] | 条件卡字段 | 一 |
+| 巩固字段 | [GB] | facts/条件卡 | 一 |
+| NOOP 裁决 | [MAGE] | 审核队列枚举 | 一 |
+| 冻结动词协议 + conformance | [GB] | md_cg MCP 面 | 一 |
+| fence 真源绑定 | [GB] | 条件卡↔md | 一 |
+| 时间算子 | [RE] | 检索原语 | 二 |
+| 实体上下文原语 | [RE] | 检索原语 | 二 |
+| tag 枢纽 | [MA] | 检索原语 | 二 |
+| 反向遍历 | [MA] | 检索原语 | 二 |
+| f_route 剪枝 | [MA] | 检索原语 | 二 |
+| 能力探测降级 | [GB] | 检索入口 | 二 |
+| 治理指标三件套 | [MAGE] | 指标体系 | 三 |
+| 拒答量化 | [RE] | BLINDSPOT | 三 |
+| LoCoMo 基准体检 | [RE] | 外部锚点 | 三 |
+| BLINDSPOT 票据化 | [WF] | 判定→工单 | 三 |
+| 角色化读取 | [MAGE] | 蜂巢读取 | 四 |
+| 超边形式化 | [MAGE] | 互验协议 | 四 |
+| 回放世界池 | [DRSI] | 自改进 | 五 |
+| 单调门 | [DRSI] | 自改进 | 五 |
+| 周期性回归 + 盲区 | [DRSI][WF] | 自改进 | 五 |

package/dsh/README.md

@@ -11,6 +11,9 @@
 | `cordis.yml.example` | 插件配置示例（30+ 项：mdcg / memory / mutual / capability …） |
 | `cordis-patch-profile-web.example.yml` | profile `web` 的 config override **备份模板**（换 profile / 重装 / 升级后须核对仍在） |
 | `dsh-web-start.bat` | DSH web 宿主启动脚本（带 8GB heap 保护，防启动 OOM） |
+| `update-lingshu.ps1` / `update-lingshu.bat` | 灵枢插件一键更新：放行 pnpm 发布龄闸门 → 同步 lockfile → 停 DSH（释放目录锁）→ 安装并校验 → 重启。详见脚本头部注释 |
+| `hive-mcp.example.yml` | **蜂巢 MCP 接入样例**（追加进 `<profile>/cordis.patch.yml`）：把 `hive_spawn`/`hive_poll`/`hive_kill`/`hive_doctor` 以 `mcp__hive__*` 暴露给 DSH 模型。含 env 清洗、insert 形态、密钥传递等实测要点 |
+| `hive-mcp-probe.mjs` | 蜂巢 MCP server 探针：用 DSH 自带的 `@modelcontextprotocol/sdk` 直接握手 + `tools/list` + `hive_doctor`（`--spawn` 可跑一次真任务），**不动 DSH 进程**即可验证 server 侧 |
 
 ## 安装
 
@@ -23,6 +26,36 @@ dsh plugin --profile web add .        # 必须走 dsh plugin，勿用裸 npm ins
 
 再参照 `cordis.yml.example` 在 `<profile>/cordis.yml` 启用配置。
 
+## 蜂巢（hive）MCP 接入（任务调度 + 多智能体并发）
+
+把 `hive/hive_mcp/mcp_server.py` 作为 MCP 服务器接进 DSH，模型即可直接调用 4 个工具：
+`mcp__hive__hive_spawn` / `mcp__hive__hive_poll` / `mcp__hive__hive_kill` / `mcp__hive__hive_doctor`。
+
+完整配置见 [`hive-mcp.example.yml`](hive-mcp.example.yml)（**必须用 `- insert:` 形态**追加到
+`<profile>/cordis.patch.yml`；模板内 4 个 `<REPLACE_WITH_...>` 占位符换成你自己的绝对路径）。
+三条最容易踩的点：
+
+1. **env 会被清洗**：`dsh-mcp-client` 只继承 12 个系统变量，`PYTHONPATH` / `PYTHONUTF8` /
+   `DEEPSEEK_API_KEY` 都得在配置里显式写出，否则 `python -m hive.hive_mcp.mcp_server` 起不来。
+2. **密钥要传下去**：serve 未存活时 `hive_spawn` 会自动拉起它，而 `hive/config.local.json` 里
+   `HIVE_API_KEY` 取自宿主环境变量 `DEEPSEEK_API_KEY`；漏传 ⇒ 拉起一个「没钥匙的 serve」。
+3. **重启才生效**：profile 的 `patchReload` 默认 `startup`。
+
+验证（两步，都不需要动正在跑的 DSH；探针脚本内是占位符，用环境变量传入）：
+
+```bash
+set DSH_ROOT=<DSH 安装目录>
+set HIVE_REPO=<dsh-memory 仓的绝对路径>
+set HIVE_LIB=<认知图库仓的绝对路径>
+set MDCG_ROOT=<认知图根的绝对路径>
+node dsh/hive-mcp-probe.mjs              # 直接连 server：握手 + tools/list + hive_doctor
+node dsh/hive-mcp-probe.mjs --spawn      # 再真跑一个任务，验证写路径
+dsh --profile web --dump-config | findstr mcp-hive   # 确认配置确实进了组合后的插件树
+```
+
+重启后在 DSH 里调用 `mcp__hive__hive_doctor` 应报 serve 存活；`hive_spawn` 一个最小任务
+（如「回复 HIVE_DSH_MCP_OK」）再 `hive_poll` 到 `done` 即端到端通。
+
 ## 纪律注入（personaPrefix 受管块）
 
 DSH 端的 16 条工作纪律**不走独立文件**，而是以 `compact` 变体写入

package/dsh/cordis.yml.example

@@ -3,13 +3,18 @@
 #
 # 说明：
 # - !!js process.env.X 语法在加载期求值，密钥不入库
-# - 记忆写入路径（下面 mdcg.root）默认锚定**插件仓自身** data/，与进程 cwd
-#   解耦——历史事故：cwd 落在别的仓时，相对路径会把记忆真源写偏。目录不存在
-#   会自动创建。想换位置有三种方式（优先级由高到低）：
+# - 记忆写入路径（下面 mdcg.root）默认落在**用户级状态根**（~/.dsh/.dsh-memory/data），
+#   与进程 cwd、**插件包目录**都解耦——历史事故①：cwd 落在别的仓时相对路径会把
+#   记忆真源写偏；事故②：默认曾锚定插件包内 data/，而 pnpm 更新包会整目录替换，
+#   包内数据每次更新成功即被删掉（详见 src/lib/datapath.ts 头注）。目录不存在会
+#   自动创建。想换位置有三种方式（优先级由高到低）：
 #     ① 环境变量 MDCG_DATA_ROOT（数据根）/ MDCG_ROOT（认知图根）
-#     ② 编辑 <插件仓>/data/paths.json 的 "data_root" / "root"
+#     ② 编辑 <用户级状态根>/paths.json 的 "data_root" / "root"
+#        （旧版包内 data/paths.json 仍兼容读，但会被下次 pnpm 更新删除）
 #     ③ 本文件的 mdcg.root（填绝对路径或相对插件仓的路径）
 #   查当前解析结果：python md_cg/datapath.py
+#   旧版数据迁移：包内 data/ 仍有内容时，插件首启会**复制**（不删除）到用户级根；
+#   也可手动执行 python md_cg/datapath.py --migrate-legacy
 
 - id: lingshu-memory
   name: '@furongjun1999/dsh-memory'
@@ -108,9 +113,10 @@
     mdcg:
       enabled: true
       # root = 记忆写入路径（用户可改）。留空 '' = 走解析优先级，默认落在
-      # **插件仓自身** data/mdcg（与 cwd 解耦）：
-      #   env MDCG_ROOT > data/paths.json 的 "root" > 本项 > 默认 <插件仓>/data/mdcg
-      # 想换位置：填绝对路径（如 'D:/lingshu/mdcg'），或改 data/paths.json。
+      # **用户级状态根** data/mdcg（与 cwd、插件包目录都解耦）：
+      #   env MDCG_ROOT > <用户级状态根>/paths.json 的 "root" > 本项
+      #   > 默认 ~/.dsh/.dsh-memory/data/mdcg
+      # 想换位置：填绝对路径（如 'D:/lingshu/mdcg'），或改 paths.json。
       root: ''
       actor: 'dsh-memory'        # MDCG_ACTOR：私有内容按 (tenant, actor) 派生 DEK
       tenant: 'default'          # MDCG_TENANT：须与迁移脚本 --tenant 一致

package/dsh/hive-mcp-probe.mjs

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+/**
+ * hive-mcp-probe.mjs —— 用 DSH 自带的 @modelcontextprotocol/sdk 直接连一次蜂巢 MCP server。
+ *
+ * 目的：在不动 DSH 进程的前提下，验证「DSH 的 mcp-client 会看到什么」。
+ *   - 用与 dsh-mcp-client 同一个 SDK（版本一致）走 stdio 握手
+ *   - tools/list → 工具名与入参 schema
+ *   - tools/call hive_doctor → serve 存活与任务统计
+ *   - （可选）tools/call hive_spawn → 真提交一个任务，证明写路径通
+ *
+ * 用法：node dsh/hive-mcp-probe.mjs [--spawn]
+ * 依赖环境变量（可覆盖）：DSH_ROOT、HIVE_REPO、HIVE_LIB、MDCG_ROOT
+ *   DSH_ROOT  = DSH 安装目录（其下含 node_modules/@modelcontextprotocol/sdk）
+ *   HIVE_REPO = dsh-memory 仓绝对路径
+ *   HIVE_LIB  = 认知图库仓绝对路径（追加进 PYTHONPATH）
+ *   MDCG_ROOT = 认知图根
+ * 四个值未设置且脚本内仍为占位符时直接报错退出——本仓是公开仓，不硬编码本机路径。
+ */
+const DSH_ROOT = (process.env.DSH_ROOT || '<REPLACE_WITH_DSH_INSTALL_DIR>').replace(/\\/g, '/')
+const REPO = process.env.HIVE_REPO || '<REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory>'
+const LIB = process.env.HIVE_LIB || '<REPLACE_WITH_ABSOLUTE_PATH_TO_mdcg_lib>'
+const MDCG_ROOT = process.env.MDCG_ROOT || '<REPLACE_WITH_ABSOLUTE_PATH_TO_MDCG_ROOT>'
+
+const PH = { DSH_ROOT, HIVE_REPO: REPO, HIVE_LIB: LIB, MDCG_ROOT }
+const missing = Object.entries(PH).filter(([, v]) => v.includes('REPLACE_WITH'))
+if (missing.length) {
+  console.error('[ABORT] 以下参数仍是占位符，请用同名环境变量覆盖后重跑：' + missing.map(([k]) => k).join(', '))
+  process.exit(1)
+}
+
+const SDK = 'file:///' + DSH_ROOT + '/node_modules/@modelcontextprotocol/sdk/dist/esm'
+const { Client } = await import(SDK + '/client/index.js')
+const { StdioClientTransport } = await import(SDK + '/client/stdio.js')
+
+const doSpawn = process.argv.includes('--spawn')
+
+const transport = new StdioClientTransport({
+  command: 'python',
+  args: ['-m', 'hive.hive_mcp.mcp_server'],
+  cwd: REPO,
+  env: {
+    ...process.env,
+    PYTHONPATH: REPO + ';' + LIB,
+    PYTHONUTF8: '1',
+    PYTHONIOENCODING: 'utf-8',
+    MDCG_ROOT,
+  },
+})
+
+const client = new Client({ name: 'dsh-hive-probe', version: '1.0.0' })
+await client.connect(transport)
+console.log('[OK] MCP 握手成功（stdio）')
+console.log('serverInfo =', JSON.stringify(client.getServerVersion?.() ?? {}))
+
+const listed = await client.listTools()
+console.log('[OK] tools/list 返回 ' + listed.tools.length + ' 个工具：')
+for (const t of listed.tools) {
+  console.log('  - ' + t.name + '  参数：' + Object.keys(t.inputSchema?.properties ?? {}).join(', '))
+}
+
+const doc = await client.callTool({ name: 'hive_doctor', arguments: {} })
+const docText = (doc.content ?? []).map((c) => c.text ?? '').join('')
+console.log('[OK] hive_doctor →')
+console.log('  ' + docText.slice(0, 900).replace(/\n/g, '\n  '))
+
+if (doSpawn) {
+  const tag = 'HIVE_MCP_OK_' + Date.now()
+  const sp = await client.callTool({ name: 'hive_spawn', arguments: {
+    model: 'deepseek-flash',
+    user_prompt: 'Reply with exactly this token and nothing else: ' + tag,
+    max_tokens: 2000,
+  } })
+  const spText = (sp.content ?? []).map((c) => c.text ?? '').join('')
+  console.log('[OK] hive_spawn → ' + spText.slice(0, 400))
+  const jobId = (spText.match(/h\d+_[0-9a-f]+/) || [])[0]
+  if (jobId) {
+    let last = ''
+    for (let i = 0; i < 60; i++) {
+      await new Promise((r) => setTimeout(r, 3000))
+      const pl = await client.callTool({ name: 'hive_poll', arguments: { job_id: jobId } })
+      const txt = (pl.content ?? []).map((c) => c.text ?? '').join('')
+      const st = (txt.match(/"state"\s*:\s*"([a-z]+)"/) || [])[1]
+      if (st !== last) { console.log('  poll ' + jobId + ' state=' + st); last = st }
+      if (['done', 'error', 'timeout', 'killed'].includes(st)) {
+        console.log('[RESULT] ' + txt.slice(0, 1200))
+        console.log('[CHECK] 令牌往返 ' + (txt.includes(tag) ? '通过（content 含 ' + tag + '）' : '未在片段中看到令牌，读全文确认'))
+        break
+      }
+    }
+  }
+}
+
+await client.close()
+console.log('[DONE] 探针结束')

package/dsh/hive-mcp.example.yml

@@ -0,0 +1,62 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# 蜂巢（hive）MCP 接入 · DSH 端配置样例（本机实测通过 2026-09-17）
+#
+#   作用：把 hive 的 4 个工具变成 DSH 原生工具，交给模型直接调用：
+#     mcp__hive__hive_spawn   提交 LLM 任务（毫秒返回 job_id，蜂巢后台并发执行）
+#     mcp__hive__hive_poll    查状态 / 读结果（含 handoff_ready 交回信号）
+#     mcp__hive__hive_kill    写 kill 标志强杀（worker ≤1s 生效）
+#     mcp__hive__hive_doctor  体检：serve 存活 / 任务统计 / env 资格列
+#
+#   放置位置：$DSH_HOME/profiles/<profile>/cordis.patch.yml（用户 patch 层，追加即可）
+#
+#   ⚠️ 必须包在 `- insert:` 里。用户 patch 层的裸条目 `- id: xxx` 语义是「覆盖已
+#      有行的 config」；对不存在的 id **不生效，而且不报错**。实测：裸写 mcp-hive
+#      后 `dsh --profile web --dump-config` 里查无此行、stderr 也为空；改成
+#      `- insert: [...]` 后立刻出现在 dump 里。
+#
+#   前置依赖（一次性）：
+#     1) profile 需能解析 @deepseek-ai/dsh-mcp-client（DSH 自带此包，用 link: 指过去）：
+#        {"@deepseek-ai/dsh-mcp-client": "link:<你的 DSH 安装目录>/node_modules/@deepseek-ai/dsh-mcp-client"}
+#        再用 pnpm install --lockfile-only 同步 lockfile（只写 lockfile，不动 node_modules）。
+#        node_modules 下的目录实体与其它 link: 依赖同形（Windows Junction），可手工补齐：
+#          New-Item -ItemType Junction -Path <profile>\\node_modules\\@deepseek-ai\\dsh-mcp-client -Target <上面的路径>
+#        （DSH 运行中跑 pnpm install 会被 <profile>\\node_modules\\@furongjun1999\\dsh-memory
+#          的目录锁挡住报 EPERM；用 Junction 可绕开，因为不重命名任何目录。）
+#     2) 生效时机：profile 的 patchReload 默认 "startup" → 改完要**重启 DSH**才加载。
+#
+#   实测要点（2026-09-17 本机，全部有回显证据）：
+#     · mcp-client 会清洗宿主环境变量：只继承 APPDATA / HOMEDRIVE / HOMEPATH /
+#       LOCALAPPDATA / PATH / PROCESSOR_ARCHITECTURE / SYSTEMDRIVE / SYSTEMROOT /
+#       TEMP / USERNAME / USERPROFILE / PROGRAMFILES 这 12 个
+#       （@modelcontextprotocol/sdk 的 stdio.js::DEFAULT_INHERITED_ENV_VARS）。
+#       → PYTHONPATH / PYTHONUTF8 必须在这里显式声明，否则
+#         `python -m hive.hive_mcp.mcp_server` 直接 ModuleNotFoundError。
+#     · hive/ 是 python 包；`-m hive.hive_mcp.mcp_server` 要求 PYTHONPATH 指向仓根。
+#     · serve 未存活时 hive_spawn 会自动拉起（复用 serve_start.start()）。该路径的
+#       env = MCP 进程 env + hive/config.local.json；而 config.local.json 里
+#       HIVE_API_KEY 的来源写作 {"env": "DEEPSEEK_API_KEY"} → 必须把
+#       DEEPSEEK_API_KEY 传下来，否则自动拉起的是「没钥匙的 serve」，任务必失败。
+#     · 验收（端到端）：mcp__hive__hive_spawn 提交 → mcp__hive__hive_poll 轮询到
+#       done。实测 job h1789598763792_32c0aa：claimed→running→done 5.77s，
+#       content 与提示词约定的令牌逐字相同，且 serve 由本次 spawn 自动拉起。
+#     · 可用 `node dsh/hive-mcp-probe.mjs` 在不动 DSH 的前提下单独验证 server 侧。
+#     · 本文件是公开仓模板：下面 4 个 <REPLACE_WITH_...> 占位符须换成你自己的
+#       绝对路径（正斜杠写法），否则客户端会以错误 cwd/PYTHONPATH 启动 server。
+# ─────────────────────────────────────────────────────────────────────────────
+- insert:
+    - id: mcp-hive
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: hive
+        transport: stdio
+        command: python
+        args: ['-m', 'hive.hive_mcp.mcp_server']
+        cwd: '<REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory>'
+        env:
+          PYTHONPATH: '<REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory>;<REPLACE_WITH_ABSOLUTE_PATH_TO_mdcg_lib>'
+          PYTHONUTF8: '1'
+          PYTHONIOENCODING: 'utf-8'
+          MDCG_ROOT: '<REPLACE_WITH_ABSOLUTE_PATH_TO_MDCG_ROOT>'
+          DEEPSEEK_API_KEY: !!js process.env.DEEPSEEK_API_KEY
+        toolCallTimeoutMs: 60000
+        failOnStartupError: false

package/dsh/update-lingshu.bat

@@ -0,0 +1,11 @@
+@echo off
+rem ============================================================
+rem update-lingshu.bat - 灵枢插件一键更新（占位：逻辑在 update-lingshu.ps1）
+rem ============================================================
+setlocal
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0update-lingshu.ps1" %*
+set RC=%ERRORLEVEL%
+echo.
+if "%RC%"=="0" (echo [OK] update finished.) else (echo [FAILED] exit %RC% - see %TEMP%\update-lingshu.log)
+pause
+endlocal