@furongjun1999/dsh-memory 0.4.11 → 0.5.1

package/dsh/README.md

@@ -1,82 +1,82 @@
-# DSH 端 · 灵枢插件配置
-
-本目录 = **DeepSeek Harness（DSH）harness 专属配置**。与 `codebuddy/`、`zcode/` 平级，
-共享层（`md_cg/` 大脑、`data/`、`docs/`、`scripts/`）在仓库根。
-
-## 目录内容
-
-| 文件 | 作用 |
-|---|---|
-| `cordis.patch.yml` | 插件 **bundle 入口**（`package.json` 的 `dsh.bundle.patch` 指向本文件；裸 insert 声明） |
-| `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 侧 |
-
-## 安装
-
-```bash
-git clone https://github.com/FuRongJun-1999/dsh-memory.git
-cd dsh-memory
-npm install && npm run build          # tsc → lib/
-dsh plugin --profile web add .        # 必须走 dsh plugin，勿用裸 npm install 装进 profile
-```
-
-再参照 `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` 变体写入
-`~/.dsh/profiles/web/cordis.patch.yml` 的 `personaPrefix` 键，用受管标记块 `lingshu:discipline`
-原地修订（保留注释）：
-
-```
-python scripts/render_discipline.py --target dsh --write
-python scripts/verify_discipline.py --target dsh
-```
-
-> DSH 的 `personaPrefix` 是**每轮注入**的系统提示槽位，因此用 `compact` 变体；
-> CodeBuddy / ZCode 是**会话起始注入**，用 `full` 变体。三角色同源于
-> `docs/工作纪律_认知图条目_v1.1.json`，矩阵见 `docs/discipline/harnesses.yaml`。
-
-## 与「三层拆分规划」的关系
-
-本目录是**按 harness 维度**（DSH / CodeBuddy / ZCode）归置配置；
-[`../docs/mdcg/灵枢三层拆分规划_v0.1.md`](../docs/mdcg/灵枢三层拆分规划_v0.1.md) 讨论的是**另一种正交维度**
-（灵 / 脑 / 身 三仓职责分离，目标是主仓瘦身）。
-
-二者在 `dsh-web-start.bat` 上存在**归属分歧**：三层规划拟将其移出主仓至「身体仓（宿主启动）」，
-而本目录按 harness 维度将其收拢。该分歧**留待三层规划 Phase 裁决收敛**——本目录为其当前的
-可追踪落点，不改变三层规划的结论。
+# DSH 端 · 灵枢插件配置
+
+本目录 = **DeepSeek Harness（DSH）harness 专属配置**。与 `codebuddy/`、`zcode/` 平级，
+共享层（`md_cg/` 大脑、`data/`、`docs/`、`scripts/`）在仓库根。
+
+## 目录内容
+
+| 文件 | 作用 |
+|---|---|
+| `cordis.patch.yml` | 插件 **bundle 入口**（`package.json` 的 `dsh.bundle.patch` 指向本文件；裸 insert 声明） |
+| `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 侧 |
+
+## 安装
+
+```bash
+git clone https://github.com/FuRongJun-1999/dsh-memory.git
+cd dsh-memory
+npm install && npm run build          # tsc → lib/
+dsh plugin --profile web add .        # 必须走 dsh plugin，勿用裸 npm install 装进 profile
+```
+
+再参照 `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` 变体写入
+`~/.dsh/profiles/web/cordis.patch.yml` 的 `personaPrefix` 键，用受管标记块 `lingshu:discipline`
+原地修订（保留注释）：
+
+```
+python scripts/render_discipline.py --target dsh --write
+python scripts/verify_discipline.py --target dsh
+```
+
+> DSH 的 `personaPrefix` 是**每轮注入**的系统提示槽位，因此用 `compact` 变体；
+> CodeBuddy / ZCode 是**会话起始注入**，用 `full` 变体。三角色同源于
+> `docs/工作纪律_认知图条目_v1.1.json`，矩阵见 `docs/discipline/harnesses.yaml`。
+
+## 与「三层拆分规划」的关系
+
+本目录是**按 harness 维度**（DSH / CodeBuddy / ZCode）归置配置；
+[`../docs/mdcg/灵枢三层拆分规划_v0.1.md`](../docs/mdcg/灵枢三层拆分规划_v0.1.md) 讨论的是**另一种正交维度**
+（灵 / 脑 / 身 三仓职责分离，目标是主仓瘦身）。
+
+二者在 `dsh-web-start.bat` 上存在**归属分歧**：三层规划拟将其移出主仓至「身体仓（宿主启动）」，
+而本目录按 harness 维度将其收拢。该分歧**留待三层规划 Phase 裁决收敛**——本目录为其当前的
+可追踪落点，不改变三层规划的结论。

package/dsh/cordis.yml.example

@@ -1,139 +1,139 @@
-# @furongjun1999/dsh-memory 插件配置示例
-# 复制到 DSH profile 的 cordis.patch.yml（或 cordis.yml）启用
-#
-# 说明：
-# - !!js process.env.X 语法在加载期求值，密钥不入库
-# - 记忆写入路径（下面 mdcg.root）默认落在**用户级状态根**（~/.dsh/.dsh-memory/data），
-#   与进程 cwd、**插件包目录**都解耦——历史事故①：cwd 落在别的仓时相对路径会把
-#   记忆真源写偏；事故②：默认曾锚定插件包内 data/，而 pnpm 更新包会整目录替换，
-#   包内数据每次更新成功即被删掉（详见 src/lib/datapath.ts 头注）。目录不存在会
-#   自动创建。想换位置有三种方式（优先级由高到低）：
-#     ① 环境变量 MDCG_DATA_ROOT（数据根）/ MDCG_ROOT（认知图根）
-#     ② 编辑 <用户级状态根>/paths.json 的 "data_root" / "root"
-#        （旧版包内 data/paths.json 仍兼容读，但会被下次 pnpm 更新删除）
-#     ③ 本文件的 mdcg.root（填绝对路径或相对插件仓的路径）
-#   查当前解析结果（解释器按平台：Windows python / Linux·macOS python3，下同）：
-#     python md_cg/datapath.py
-#   旧版数据迁移：包内 data/ 仍有内容时，插件首启会**复制**（不删除）到用户级根；
-#   也可手动执行 python md_cg/datapath.py --migrate-legacy
-
-- id: lingshu-memory
-  name: '@furongjun1999/dsh-memory'
-  config:
-    # 工具命名空间：Agent 看到的工具名是 lingshu_cg / lingshu_stg（记忆面已基元化）
-    serverName: 'lingshu'
-
-    # ⚠️ 遗留项：SQLite 库文件路径（经环境变量 AEIS_DB 传给子进程）。
-    # 大脑真源已统一到 md_cg 认知图（见下面的 mdcg 块）；此项现仅供角色
-    # 数据目录 roleDataDir（由它的父目录推导）使用，**不再存记忆**，
-    # md_cg server 也不读取它。
-    dbPath: 'data/lingshu.db'
-
-    # 灵枢身份标识
-    identity: '灵枢'
-
-    # Python 与启动参数（默认即可；md_cg 随插件自带，无需 pip 安装第三方包）
-    # 解释器**无需配置**：默认按平台自动选——Windows → python，Linux/macOS → python3。
-    # 为什么不能照抄 'python'（issue #19）：Linux/macOS 发行版按 PEP 394 只提供
-    # python3（这是默认状态，不是环境损坏），写死 python 会让桥 spawn ENOENT，
-    # 重试 8 次后进终态——插件看起来装好了，但工具不注册、记忆永不落盘且不自愈。
-    # 解释器名特殊（如 python3.12）时：在此显式配置，或设环境变量 MDCG_PYTHON
-    # （优先级：config.python > env MDCG_PYTHON > 平台默认）。
-    # python: 'python'
-    # 大脑进程：md_cg（主仓自带，不再依赖 pip aeis）
-    moduleArgs: ['-m', 'md_cg.mcp_server']
-
-    # 暴露的工具集合：'core'（默认，仅 cg/stg 两基元）| 'brain' | 'all' | 自定义数组
-    # 进程侧 MDCG_MCP_SURFACE=full 暴露 cg/stg 基元 + mdcg_* 细粒度工具（共 33）；
-    # 此处选择表再筛一遍：'core' = 2 基元；'brain' = 完整认知面（30，排除管理类
-    # forget/restore/review_decide）；'all' 同样排除管理类（RISK_TOOLS）。
-    tools: 'core'
-
-    # 「身体」能力后端（可选）：角色扮演生成等「身」的生成能力。
-    # 默认关闭 → 主仓保持**纯大脑单进程**（只起 md_cg）。开启后额外起一个
-    # 能力库子进程（如 AEIS），仅角色扮演生成使用；记忆真源仍是 md_cg。
-    # 未开启时 /roleplay 的生成接口 fail-closed（返回明确原因，不编造回复），
-    # 但转录 / 历史 / 翻译 / 落图始终可用（走大脑）。
-    # capability:
-    #   enabled: false
-    #   python: ''              # 留空 = 跟随上面的 python（平台默认）
-    #   args: ['-m', 'aeis.mcp.server']
-
-    # 自动记忆（对话沉淀进灵枢）
-    memory:
-      userMessage: true        # 用户消息 → remember
-      assistantMessage: false  # agent 回复（默认关，防噪音）
-      toolResult: false        # 工具结果（默认关）
-      importance: 0.6
-
-    # 密钥经环境变量注入（不进配置库）
-    env:
-      BOCHA_API_KEY: !!js process.env.BOCHA_API_KEY
-      # AEIS_DESIGNER_KEY: !!js process.env.AEIS_DESIGNER_KEY   # 设计者裁决工具所需
-
-      # ── 认知图写入凭据：默认【关闭】，由你决定是否打开 ──────────────
-      # md_cg 是 fail-closed：不配凭据时插件以**只读 guest** 运行 ——
-      # 读取 / 召回 / 时间线照常，但自动记忆、对话转录、角色落图**全部不落盘**
-      # （插件启动时会打印一条告警提醒，不会静默）。
-      #
-      # 想打开：取消注释下面任一方案，然后重启 DSH。
-      #
-      # ① 功能完整（推荐，已收窄）：覆盖插件全部 9 个调用点，但无管理权、
-      #    不写 anchor 保护层。签发：
-      #    python -m md_cg.tokens issue --role designer --actor dsh-memory \
-      #      --clearance internal \
-      #      --ops-allow info,route,read,write,recent,goal,identity,whitebox,verify \
-      #      --layers-allow knowledge,contextual,structural,self,goals,unresolved,rejected
-      # MDCG_TOKEN: !!js process.env.MDCG_TOKEN
-      #
-      # ② 最小权限：--role recorder --actor dsh-memory
-      #    只能自动记忆 / 转录 / 角色定义；whitebox、identity、verify 与
-      #    写 self 层（角色 anchors 导入）会被 AccessDenied。
-      # MDCG_TOKEN: !!js process.env.MDCG_TOKEN
-      #
-      # ③ 兼容旧部署（不推荐：明文身份、无令牌可吊销）：
-      #    recorder 可写 contextual/knowledge/structural；
-      #    要写 self 层再加 MDCG_CAN_ADMIN: '1'（→ designer）
-      # MDCG_LEGACY_ENV_AUTH: '1'
-      #
-      # 令牌明文怎么给进去（二选一）：
-      #   · 推荐：设环境变量后引用（明文不进配置文件）
-      #       setx MDCG_TOKEN "mdcg1.xxxxx"   然后重启 DSH
-      #   · 或直接写明文：MDCG_TOKEN: 'mdcg1.xxxxx'
-
-    # 容错
-    toolCallTimeoutMs: 60000
-    maxRetryDelayMs: 30000
-    failOnStartupError: false
-
-    # 互维维护（Mutual Sustain Loop v1.1）：心跳10min写戳 + 守护A + 任务验证双通道
-    # 需在双沙箱环境中启用（与 A 侧 guardian 对称）；单实例可关
-    mutual:
-      enabled: true
-      heartbeatMs: 600000        # 10min，任务不阻塞心跳
-
-    # 认知图（md_cg）= 记忆唯一真源；AEIS 降为能力库。
-    # 插件侧唯一显式入口：src/lib/mdcg_client.ts（每个方法 = 一条 MCP 调用：
-    # 记忆写入走 mdcg_remember，读取/召回/时间线走 cg/stg 基元）。
-    # ⚠️ 写入需上面的 MDCG_LEGACY_ENV_AUTH / MDCG_TOKEN 凭据，否则只读 guest。
-    # 功能 → 代码 对照见 docs/功能调用映射表_v0.1.md
-    mdcg:
-      enabled: true
-      # root = 记忆写入路径（用户可改）。留空 '' = 走解析优先级，默认落在
-      # **用户级状态根** 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 一致
-      clearance: 'private'       # MDCG_CLEARANCE：可读写密级上限
-
-# 多实例示例：第二个灵枢（不同记忆库/身份/命名空间）
-# - id: lingshu-memory-2
-#   name: '@furongjun1999/dsh-memory'
-#   config:
-#     serverName: 'lingshu2'
-#     dbPath: 'data/lingshu2.db'
-#     identity: '灵枢二号'
-#     tools: ['cg', 'stg']
+# @furongjun1999/dsh-memory 插件配置示例
+# 复制到 DSH profile 的 cordis.patch.yml（或 cordis.yml）启用
+#
+# 说明：
+# - !!js process.env.X 语法在加载期求值，密钥不入库
+# - 记忆写入路径（下面 mdcg.root）默认落在**用户级状态根**（~/.dsh/.dsh-memory/data），
+#   与进程 cwd、**插件包目录**都解耦——历史事故①：cwd 落在别的仓时相对路径会把
+#   记忆真源写偏；事故②：默认曾锚定插件包内 data/，而 pnpm 更新包会整目录替换，
+#   包内数据每次更新成功即被删掉（详见 src/lib/datapath.ts 头注）。目录不存在会
+#   自动创建。想换位置有三种方式（优先级由高到低）：
+#     ① 环境变量 MDCG_DATA_ROOT（数据根）/ MDCG_ROOT（认知图根）
+#     ② 编辑 <用户级状态根>/paths.json 的 "data_root" / "root"
+#        （旧版包内 data/paths.json 仍兼容读，但会被下次 pnpm 更新删除）
+#     ③ 本文件的 mdcg.root（填绝对路径或相对插件仓的路径）
+#   查当前解析结果（解释器按平台：Windows python / Linux·macOS python3，下同）：
+#     python md_cg/datapath.py
+#   旧版数据迁移：包内 data/ 仍有内容时，插件首启会**复制**（不删除）到用户级根；
+#   也可手动执行 python md_cg/datapath.py --migrate-legacy
+
+- id: lingshu-memory
+  name: '@furongjun1999/dsh-memory'
+  config:
+    # 工具命名空间：Agent 看到的工具名是 lingshu_cg / lingshu_stg（记忆面已基元化）
+    serverName: 'lingshu'
+
+    # ⚠️ 遗留项：SQLite 库文件路径（经环境变量 AEIS_DB 传给子进程）。
+    # 大脑真源已统一到 md_cg 认知图（见下面的 mdcg 块）；此项现仅供角色
+    # 数据目录 roleDataDir（由它的父目录推导）使用，**不再存记忆**，
+    # md_cg server 也不读取它。
+    dbPath: 'data/lingshu.db'
+
+    # 灵枢身份标识
+    identity: '灵枢'
+
+    # Python 与启动参数（默认即可；md_cg 随插件自带，无需 pip 安装第三方包）
+    # 解释器**无需配置**：默认按平台自动选——Windows → python，Linux/macOS → python3。
+    # 为什么不能照抄 'python'（issue #19）：Linux/macOS 发行版按 PEP 394 只提供
+    # python3（这是默认状态，不是环境损坏），写死 python 会让桥 spawn ENOENT，
+    # 重试 8 次后进终态——插件看起来装好了，但工具不注册、记忆永不落盘且不自愈。
+    # 解释器名特殊（如 python3.12）时：在此显式配置，或设环境变量 MDCG_PYTHON
+    # （优先级：config.python > env MDCG_PYTHON > 平台默认）。
+    # python: 'python'
+    # 大脑进程：md_cg（主仓自带，不再依赖 pip aeis）
+    moduleArgs: ['-m', 'md_cg.mcp_server']
+
+    # 暴露的工具集合：'core'（默认，仅 cg/stg 两基元）| 'brain' | 'all' | 自定义数组
+    # 进程侧 MDCG_MCP_SURFACE=full 暴露 cg/stg 基元 + mdcg_* 细粒度工具（共 33）；
+    # 此处选择表再筛一遍：'core' = 2 基元；'brain' = 完整认知面（30，排除管理类
+    # forget/restore/review_decide）；'all' 同样排除管理类（RISK_TOOLS）。
+    tools: 'core'
+
+    # 「身体」能力后端（可选）：角色扮演生成等「身」的生成能力。
+    # 默认关闭 → 主仓保持**纯大脑单进程**（只起 md_cg）。开启后额外起一个
+    # 能力库子进程（如 AEIS），仅角色扮演生成使用；记忆真源仍是 md_cg。
+    # 未开启时 /roleplay 的生成接口 fail-closed（返回明确原因，不编造回复），
+    # 但转录 / 历史 / 翻译 / 落图始终可用（走大脑）。
+    # capability:
+    #   enabled: false
+    #   python: ''              # 留空 = 跟随上面的 python（平台默认）
+    #   args: ['-m', 'aeis.mcp.server']
+
+    # 自动记忆（对话沉淀进灵枢）
+    memory:
+      userMessage: true        # 用户消息 → remember
+      assistantMessage: false  # agent 回复（默认关，防噪音）
+      toolResult: false        # 工具结果（默认关）
+      importance: 0.6
+
+    # 密钥经环境变量注入（不进配置库）
+    env:
+      BOCHA_API_KEY: !!js process.env.BOCHA_API_KEY
+      # AEIS_DESIGNER_KEY: !!js process.env.AEIS_DESIGNER_KEY   # 设计者裁决工具所需
+
+      # ── 认知图写入凭据：默认【关闭】，由你决定是否打开 ──────────────
+      # md_cg 是 fail-closed：不配凭据时插件以**只读 guest** 运行 ——
+      # 读取 / 召回 / 时间线照常，但自动记忆、对话转录、角色落图**全部不落盘**
+      # （插件启动时会打印一条告警提醒，不会静默）。
+      #
+      # 想打开：取消注释下面任一方案，然后重启 DSH。
+      #
+      # ① 功能完整（推荐，已收窄）：覆盖插件全部 9 个调用点，但无管理权、
+      #    不写 anchor 保护层。签发：
+      #    python -m md_cg.tokens issue --role designer --actor dsh-memory \
+      #      --clearance internal \
+      #      --ops-allow info,route,read,write,recent,goal,identity,whitebox,verify \
+      #      --layers-allow knowledge,contextual,structural,self,goals,unresolved,rejected
+      # MDCG_TOKEN: !!js process.env.MDCG_TOKEN
+      #
+      # ② 最小权限：--role recorder --actor dsh-memory
+      #    只能自动记忆 / 转录 / 角色定义；whitebox、identity、verify 与
+      #    写 self 层（角色 anchors 导入）会被 AccessDenied。
+      # MDCG_TOKEN: !!js process.env.MDCG_TOKEN
+      #
+      # ③ 兼容旧部署（不推荐：明文身份、无令牌可吊销）：
+      #    recorder 可写 contextual/knowledge/structural；
+      #    要写 self 层再加 MDCG_CAN_ADMIN: '1'（→ designer）
+      # MDCG_LEGACY_ENV_AUTH: '1'
+      #
+      # 令牌明文怎么给进去（二选一）：
+      #   · 推荐：设环境变量后引用（明文不进配置文件）
+      #       setx MDCG_TOKEN "mdcg1.xxxxx"   然后重启 DSH
+      #   · 或直接写明文：MDCG_TOKEN: 'mdcg1.xxxxx'
+
+    # 容错
+    toolCallTimeoutMs: 60000
+    maxRetryDelayMs: 30000
+    failOnStartupError: false
+
+    # 互维维护（Mutual Sustain Loop v1.1）：心跳10min写戳 + 守护A + 任务验证双通道
+    # 需在双沙箱环境中启用（与 A 侧 guardian 对称）；单实例可关
+    mutual:
+      enabled: true
+      heartbeatMs: 600000        # 10min，任务不阻塞心跳
+
+    # 认知图（md_cg）= 记忆唯一真源；AEIS 降为能力库。
+    # 插件侧唯一显式入口：src/lib/mdcg_client.ts（每个方法 = 一条 MCP 调用：
+    # 记忆写入走 mdcg_remember，读取/召回/时间线走 cg/stg 基元）。
+    # ⚠️ 写入需上面的 MDCG_LEGACY_ENV_AUTH / MDCG_TOKEN 凭据，否则只读 guest。
+    # 功能 → 代码 对照见 docs/功能调用映射表_v0.1.md
+    mdcg:
+      enabled: true
+      # root = 记忆写入路径（用户可改）。留空 '' = 走解析优先级，默认落在
+      # **用户级状态根** 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 一致
+      clearance: 'private'       # MDCG_CLEARANCE：可读写密级上限
+
+# 多实例示例：第二个灵枢（不同记忆库/身份/命名空间）
+# - id: lingshu-memory-2
+#   name: '@furongjun1999/dsh-memory'
+#   config:
+#     serverName: 'lingshu2'
+#     dbPath: 'data/lingshu2.db'
+#     identity: '灵枢二号'
+#     tools: ['cg', 'stg']

package/dsh/update-lingshu.bat

@@ -1,11 +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
+@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

package/lib/bridge.d.ts

@@ -73,6 +73,15 @@ export declare class LingshuBridge {
     get gaveUp(): boolean;
     /** 等待握手完成（用于 apply 阶段同步就绪）。 */
     waitReady(): Promise<boolean>;
+    /**
+     * V23 修复（缺陷 :284）：清理上一个仍存活的子进程。
+     * 握手超时/启动失败重试时直接 spawn 新进程并覆盖 this.proc（:182），
+     * 旧进程若仍存活（卡死但不退出的服务端）既不 kill 也不关 stdin——
+     * 引用被覆盖后永远无人清理 = 僵尸进程泄漏（最多 MAX_RETRIES 个并存，
+     * dispose 也只收尾最后一个）。换代前统一回收：stdin EOF 优雅退出 + kill 兜底。
+     * 幂等：已退出（exitCode/signalCode 非 null）的进程跳过。
+     */
+    private killStaleProc;
     private spawnAndHandshake;
     private handshake;
     private scheduleRetry;

package/lib/bridge.js

@@ -116,9 +116,37 @@ export class LingshuBridge {
             return Promise.resolve(false);
         return new Promise((resolve) => this.bootQueue.push(resolve));
     }
+    /**
+     * V23 修复（缺陷 :284）：清理上一个仍存活的子进程。
+     * 握手超时/启动失败重试时直接 spawn 新进程并覆盖 this.proc（:182），
+     * 旧进程若仍存活（卡死但不退出的服务端）既不 kill 也不关 stdin——
+     * 引用被覆盖后永远无人清理 = 僵尸进程泄漏（最多 MAX_RETRIES 个并存，
+     * dispose 也只收尾最后一个）。换代前统一回收：stdin EOF 优雅退出 + kill 兜底。
+     * 幂等：已退出（exitCode/signalCode 非 null）的进程跳过。
+     */
+    killStaleProc() {
+        const old = this.proc;
+        this.proc = null; // 先摘引用：旧进程随后的 exit 事件走 stale 早退分支
+        if (!old || old.exitCode !== null || old.signalCode !== null)
+            return;
+        try {
+            old.stdin?.end();
+        }
+        catch {
+            /* 已关闭则忽略 */
+        }
+        try {
+            old.kill();
+        }
+        catch {
+            /* 已退出则忽略 */
+        }
+    }
     spawnAndHandshake() {
         if (this.disposed)
             return;
+        // V23：重试路径先回收上一个仍存活的子进程（防换代泄漏僵尸进程）
+        this.killStaleProc();
         this.procStartedAt = Date.now();
         const { python, args, env, cwd } = this.options;
         const childEnv = { ...process.env, ...env };
@@ -178,6 +206,13 @@ export class LingshuBridge {
             }
         });
         proc.on('exit', (code, signal) => {
+            // V23：被换代清理的旧进程退出（this.proc 已指向新一代或为 null）——
+            // 不动当前进程的 rl/pending/重试状态机，只留探针；否则旧 exit 会
+            // close 新进程的 readline、误拒新进程的挂起请求并多触发一轮重试。
+            if (proc !== this.proc) {
+                probe(`stale proc exit code=${code} signal=${signal}（换代已回收，不影响当前进程）`);
+                return;
+            }
             // 探针：写独立文件记录退出（绕过 DSH 日志系统，便于定位）
             const uptimeS = this.procStartedAt
                 ? Math.round((Date.now() - this.procStartedAt) / 1000)

package/lib/hooks.js

@@ -132,6 +132,19 @@ function formatTimelineDecayed(payload) {
     }
     return out.join('\n').slice(0, RECALL_MAX_CHARS);
 }
+/** 取宿主会话标识（只用于**归因/隔离**，不参与任何权限判断）。
+ *
+ *  动机：记忆写入必须带会话身份才能区分不同会话；读取默认只看本会话（防串台），
+ *  而「所有会话做了什么」用显式 session="*" 取。两侧都依赖这个标识。
+ *
+ *  字段名按 DSH 既有形态（`id` / `sessionId`）防御式读取，取不到就返回空串——
+ *  空串在上游一律等同「不分会话」（退回旧行为），故宿主改字段名最坏只是失去
+ *  隔离能力，不会注入错块、不会抛错。 */
+function sessionIdOf(raw) {
+    const s = raw;
+    const v = s?.id ?? s?.sessionId;
+    return typeof v === 'string' ? v.trim() : '';
+}
 /** 安装自动记忆钩子（effect 作用域内，随插件卸载自动移除）。
  *
  *  mdcg 为 null（config.mdcg.enabled=false）时自动记忆整体停用：记忆真源是
@@ -142,6 +155,8 @@ export function installMemoryHooks(ctx, mdcg, opts) {
         return;
     }
     const graph = mdcg;
+    /** 最近一次观测到的宿主会话标识（见 sessionIdOf；空串 = 未知/无会话）。 */
+    let lastSession = '';
     /** 记忆沉淀（fire-and-forget）。认知图未就绪则跳过并告警（不退回 AEIS）。 */
     const memorize = (label, run) => {
         if (!graph.isReady()) {
@@ -178,7 +193,17 @@ export function installMemoryHooks(ctx, mdcg, opts) {
             try {
                 // 异步取最近记忆节点（失败静默——不阻塞模型请求）
                 if (graph.isReady()) {
-                    const text = formatTimelineDecayed(await graph.timeline(recallLimit));
+                    // 会话隔离（P45）：自动召回只注入**本会话**的记忆，防多会话串台；
+                    // 取不到会话标识则退回旧行为（不加过滤），不做半吊子猜测。
+                    // ⚠️ 取值必须**每步稳定**：本块按 v0.4.8 契约每步都 push，内容一旦与上
+                    // 一步不同宿主就 append 一份新快照——会话标识若中途才出现，会让「无过滤
+                    // → 有过滤」翻转一次，白付两份快照。故优先取 ctx 上的会话（首步即在），
+                    // 退回「最近一次 session/event 的会话」。
+                    // 想读**所有**会话做了什么：别走自动召回（它会串台），显式调
+                    // `stg(op=timeline, session="*")`，返回项带 session 归属。
+                    const hostCtx = _ctx;
+                    const sid = sessionIdOf(hostCtx?.agent?.session) || lastSession;
+                    const text = formatTimelineDecayed(await graph.timeline(recallLimit, sid ? { session: sid } : {}));
                     if (text) {
                         // 注入边界转义（issue #16）：宿主 system-prompt 对 context 文本做严格
                         // `{{variable}}` 插值，裸 `{{` 会 throw → 该轮请求整体失败。记忆原文
@@ -194,7 +219,13 @@ export function installMemoryHooks(ctx, mdcg, opts) {
             return next();
         });
     }
-    ctx.on('session/event', (_session, event) => {
+    ctx.on('session/event', (session, event) => {
+        // 会话归属（P45）：记忆写入必须带会话身份，用来区分不同会话的记忆。
+        // 空串 = 宿主未给出会话标识 → 不声明，交给内核回落到进程身份（不编造）。
+        const sid = sessionIdOf(session);
+        if (sid)
+            lastSession = sid;
+        const sessionTag = sid ? { session: sid } : {};
         if (event.type === 'user/message' && opts.userMessage) {
             // 只记真实用户输入（kind='user'），跳过插件注入/系统上下文
             if (event.data.source?.kind !== 'user') {
@@ -211,6 +242,7 @@ export function installMemoryHooks(ctx, mdcg, opts) {
                 return;
             memorize('user', (g) => g.remember(safe, {
                 role: 'user', tags: ['dsh', 'user'], importance: opts.importance,
+                ...sessionTag,
             }));
             // T4：用用户消息做一次语义召回——md_cg 的读取会记 access log（复用观测，
             // 供 importance / scrub 陈旧度使用），同时预热检索路径。
@@ -226,6 +258,7 @@ export function installMemoryHooks(ctx, mdcg, opts) {
                 return;
             memorize('assistant', (g) => g.remember(safe, {
                 role: 'assistant', tags: ['dsh', 'assistant'], importance: opts.importance * 0.8,
+                ...sessionTag,
             }));
         }
         else if (event.type === 'tool/result' && opts.toolResult) {
@@ -239,6 +272,7 @@ export function installMemoryHooks(ctx, mdcg, opts) {
                 return;
             memorize('tool', (g) => g.remember(safe, {
                 role: 'tool-output', tags: ['dsh', 'tool'], importance: opts.importance * 0.6,
+                ...sessionTag,
             }));
         }
     });