@furongjun1999/dsh-memory 0.5.1 → 0.6.1

package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md

@@ -0,0 +1,171 @@
+# 0.6.0 发布准备报告 v1.0 —— 一键配置 init · DSH 0.17.2 声明 · 版本发布准备
+
+> 批次：0.6.0 发布准备 ｜ 报告：v1.0 ｜ 环境：win32，仓库 `dsh-memory-main`（工作区 HEAD `d7c6e347`）
+> 本报告所引全部检查为本会话（报告撰写会话）**实跑复验**的结果；引用行号均经读取核对。未跑项在第四节与自查双清单中如实声明。
+
+---
+
+## 一、总览
+
+本次 0.6.0 发布准备含三个任务，全部落在工作区未提交改动中（编排会话负责 git commit）：
+
+| # | 任务 | 交付物 | 本会话复验 |
+|---|---|---|---|
+| 1 | **init 一键配置** | 新增 `src/init.ts`（lingshu-init CLI）、`src/cli.ts`（lingshu 主命令分发）、`test/init.test.ts`（6 用例）；`package.json` 补 bin 字段；README 快速开始头部加「一键配置（推荐）」节；WORKSPACE_INDEX.md 重生成 | build/单测/E2E/gate 全过（见第四节） |
+| 2 | **README DSH 0.17.2 声明** | README.md:14 徽章换为「DSH 适配-0.17.2 已验证」；README.md:106 前置行追加「已验证至 DSH 0.17.2」 | 徽章解码 + grep 双计数核过（见第三节） |
+| 3 | **版本 0.6.0 发布准备** | 发布清单就绪（第五节）；`package.json` version 当前仍为 0.5.1（`package.json:3`），0.6.0 bump 属编排待执行动作 | 未执行 version bump / pack / publish（如实声明） |
+
+git 工作区快照（`git status --short` 实测）：` M README.md`、` M WORKSPACE_INDEX.md`、` M package.json`、` A src/cli.ts`、` A src/init.ts`、` A test/init.test.ts`（intent-to-add 登记，与「git add -N」口径一致）、`?? lingshu-mcp-snippet.json`（见第六节第 6 条）。
+
+---
+
+## 二、init 命令设计与实现
+
+### 2.1 目标
+
+一键配置命令：`npx @furongjun1999/dsh-memory init`。新增 `src/init.ts`（lingshu-init CLI 主实现）、`src/cli.ts`（lingshu 主命令分发）、`test/init.test.ts`；`package.json` 补 bin 字段；README.md 快速开始节头部加「一键配置（推荐）」小节；WORKSPACE_INDEX.md 重生成。**未动** `src/index.ts`（DSH 插件入口）与 `src/lib/`（仅 import 复用）。未 git commit（编排会话负责；三个新文件已登记进 git 索引面）。
+
+### 2.2 实现要点（行号均经本会话读取核对）
+
+**src/init.ts（新增，348 行）**：导出 `runInit(argv, opts)`（src/init.ts:239）、`buildSnippet`（src/init.ts:106）、`defaultMemoryRoot`（src/init.ts:101）。文件尾 `import.meta === pathToFileURL(resolve(process.argv[1]))` 判定直跑，win32 下做大小写兜底比对（src/init.ts:328-338）。
+
+- **交互模式**（无参数/参数不全且 stdin TTY，src/init.ts:256-288）：`node:readline/promises` 三问——①接入端 1=DSH 插件 2=Claude Code 3=Codex CLI 4=通用 MCP ②记忆根目录（缺省 `<home>/.lingshu/memory`，src/init.ts:101-103）③Python 解释器（缺省 `defaultPython()` 按平台 python/python3，src/lib/python_path.ts:42-49）。
+- **非交互**：`--end/--root/--python` 齐即跳过问答；解析容忍 `--flag value` 与 `--flag=value`、跳过一个前导 `--` 分隔符（src/init.ts:216,221）；非 TTY 缺参报错退出 1、点名缺失 flag（src/init.ts:259-266），不挂死。
+- **产出**：①打印所选端 mcp.json 片段——`command`=解释器、`args=['-m','md_cg.mcp_server']`、env 含 `MDCG_ROOT`、`MDCG_PYTHON`、`PYTHONPATH`=包根（`repoRoot()`，src/init.ts:118）、`PYTHONIOENCODING`/`PYTHONUTF8` 编码硬约束、`MDCG_MCP_SURFACE=kernel`、`MDCG_ACTOR` 按端（src/init.ts:109-129）②写 `<cwd>/lingshu-mcp-snippet.json`（src/init.ts:297-298）③后续步骤指引（片段各端放哪、令牌签发 `python -m md_cg.tokens issue ...` 与 README「写入凭据」对应，src/init.ts:136-144、大脑自检、PYTHONPATH 换常驻仓库的提示 src/init.ts:312）。
+- **边界**：不创建目录/不启动服务/不写库（src/init.ts:11-16 头注；输出尾行如实声明 src/init.ts:313）；无时间戳类易变内容（幂等）。零运行时依赖：仅 `node:fs`/`node:os`/`node:readline/promises`/`node:path`/`node:url` + 包内 lib 模块（src/init.ts:29-36 import 清单）。
+- **各端口径**：dsh 端诚实标注「DSH 无全局 mcp.json——推荐走插件形态；下方 JSON 为 MCP 直挂等价形态」（src/init.ts:58），并给出 cordis.yml 对应关系 `config.python` / `config.mdcg.root`（src/init.ts:152-154）。
+
+**src/cli.ts（新增，66 行）**：`lingshu <cmd>` 分发——`'init'` → `runInit`（src/cli.ts:35-38）；无/未知命令打印用法退出 1（src/cli.ts:39-43）；导出 `main` 供测试（src/cli.ts:33）。头注说明三 bin 设计动机（src/cli.ts:5-10）。
+
+**package.json**：`bin = { lingshu→./lib/cli.js, lingshu-init→./lib/init.js, dsh-memory→./lib/cli.js }`（package.json:8-12）。第三个 bin 是 npx 硬要求——包有多 bin 时 npx 只自动运行与包名末段（dsh-memory）同名的 bin，缺它则 `npx @furongjun1999/dsh-memory init` 直接报错（npm npx 多 bin 同名匹配规则）。`files` 数组已含 `lib/` 与 `md_cg/`（package.json:19-29），未改。git diff 实测 package.json 仅 +5 行（bin 块）。
+
+**test/init.test.ts（新增，6 用例，src 行号 :41/:82/:102/:128/:151/:173）**：非交互四端端到端（各端 MDCG_ROOT/MDCG_PYTHON/command/args/actor/编码键逐条断言 + snippet 落盘可 JSON.parse 且与返回一致 + 输出含令牌指引 + 记忆根目录未被创建）；幂等（同参重跑 stdout 逐字节一致 + 文件一致）；交互 mock stdin（PassThrough）走通 DSH 分支与缺省分支；非 TTY 缺参报错点名缺失 flag。测试注释记录 readline 预缓冲坑的实测结论（test/init.test.ts:97-100）。
+
+**README.md:48-66**：「### 一键配置（推荐）」置于「按宿主选择入口」引用块（README.md:68，即原手工三步）之前：npx 命令（:51）、三问与三项产出说明（:54-58）、非交互直跑形态（:63）、init 边界与幂等（:66）、「或继续阅读下方手工步骤」（:66）。
+
+**WORKSPACE_INDEX.md**：`scripts/workspace_index.py --write` 重生成（`--check` 过，见第四节⑤⑥）。快照行实测：HEAD `d7c6e347` · 追踪 1998 件（WORKSPACE_INDEX.md:8），`src/` 14 件（WORKSPACE_INDEX.md:20）。
+
+### 2.3 前 / 后对比
+
+- **前**：部署灵枢需手工多步——读 README 选流程、自己定记忆根目录、手写各端 mcp.json 的 env（README 各端样例里 PYTHONPATH 是 REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory 占位符）、自行理解令牌签发；无任何 bin，包不可执行。
+- **后**：一条命令三问即产出所选端可直接复制的 mcp.json 片段 + 落盘文件 + 后续步骤（含按端 actor 的令牌签发命令）；参数齐可非交互直跑；重跑输出一致。DSH 端诚实标注「无全局 mcp.json，JSON 为直挂等价形态，推荐插件形态三步」并给出 cordis.yml 对应关系（config.python / config.mdcg.root）。
+
+### 2.4 语义注记（口径对齐，均已读取核对）
+
+1. 片段 env 口径与 `mdcgChildEnv()`（src/lib/mdcg_client.ts:115-129）对齐——`PYTHONIOENCODING`/`PYTHONUTF8` 是硬约束非可选（中文记忆场景，该函数头注 2026-09-20 读线程崩溃现场）；`MDCG_MCP_SURFACE=kernel` 与既有直挂样例同口径——kernel 面无 `mdcg_*` 细粒度工具，直挂端写入走 `cg(op=write)`+凭据，与插件端「必须 full」的场景（src/lib/mdcg_client.ts:68-74：唯一写入通道是 `mdcg_remember`，kernel 面下写入静默失败）不同，**刻意不跟插件对齐**。
+2. 缺省记忆根 `~/.lingshu/memory` 是本命令的显式缺省并写进 MDCG_ROOT，与插件运行时缺省（`~/.dsh/.dsh-memory`，src/lib/datapath.ts stateRoot()）不同源——片段显式指定即无歧义，两套默认各安其位。
+3. `PYTHONPATH=repoRoot()`（import.meta 向上找 package.json，src/lib/datapath.ts:41-56）：npx 场景指向 npx 缓存中的包根（files 含 md_cg/ 故随包可用），输出含「建议换 git clone 常驻仓库路径（免疫 npx 缓存清理）」的诚实提示（src/init.ts:312）。
+4. `MDCG_PYTHON` 键对直挂端是文档性（解释器由 command 决定），对 DSH 插件端真实生效（`defaultPython()` 读 env 覆盖，src/lib/python_path.ts:46-47）——输出文案如实区分（src/init.ts:122）。
+5. readline 对「attach 前预缓冲且不 end」的 PassThrough 只消费第一行（隔离实验结论：首问 OK 次问 ERR_USE_AFTER_CLOSE/question 永久 pending），可靠形态是先启动 runInit 再逐问 write——该结论已写进测试注释（test/init.test.ts:97-100），后来者不必重踩。
+
+---
+
+## 三、README 更新（DSH 0.17.2 声明）
+
+### 3.1 改动（两处）
+
+1. **README.md:14 徽章行**：DSH 适配徽章 URL 由 `badge/DSH%20%E9%80%82%E9%85%8D-%3E%3D0.1.2--rc.1-4E9BF1` 换为 `badge/DSH%20%E9%80%82%E9%85%8D-0.17.2%20%E5%B7%B2%E9%AA%8C%E8%AF%81-4E9BF1`。
+2. **README.md:106 前置行**：「DSH 内核 ≥ 0.1.2-rc.1」后插入「· **已验证至 DSH 0.17.2**」。
+
+- 前：`![DSH 适配](https://img.shields.io/badge/DSH%20%E9%80%82%E9%85%8D-%3E%3D0.1.2--rc.1-4E9BF1)` ／ 后：`![DSH 适配](https://img.shields.io/badge/DSH%20%E9%80%82%E9%85%8D-0.17.2%20%E5%B7%B2%E9%AA%8C%E8%AF%81-4E9BF1)`
+- 前置行 前：`- **前置**：Node ≥ 22.19 · DSH 内核 ≥ 0.1.2-rc.1 · **大脑零安装**…` ／ 后：`- **前置**：Node ≥ 22.19 · DSH 内核 ≥ 0.1.2-rc.1 · **已验证至 DSH 0.17.2** · **大脑零安装**…`
+
+### 3.2 行号勘误与兼容性小节说明
+
+- **行号勘误**：任务书写「:86 前置行」，实际前置行在 README.md:106（:86 现为 cordis.yml 示例的 `mdcg:` 配置行，本会话读取核实）——系工作区已有未提交的「一键配置」init 段（+20 行）导致行号漂移，已按文案「DSH 内核 ≥ 0.1.2-rc.1」精确定位修改。
+- **兼容性/版本对照小节**：README 全文检索无独立小节（仅文档导航表指向外部历史文档），按任务书第 3 条未新建。
+- 语义上「≥ 0.1.2-rc.1」的最低要求声明**保留不动**，仅追加「已验证至 0.17.2」的上界事实；徽章与前置行两处表述一致（徽章版本表述与正文一致性纪律）。
+- **未触碰**：Release 历史段与 COGMAP 标记段——git diff 实测 README.md 全部 3 个 hunk 为：①`@@ -11,7` 徽章行 ②`@@ -45,6` 一键配置段（+20 行，会话开始前工作区已有的 init 功能未提交改动，非本任务所改）③`@@ -83,7` 前置行。两目标行各在其 hunk 内，无越界改动。
+
+### 3.3 本会话复验输出
+
+- `node -e "console.log(decodeURIComponent('DSH%20%E9%80%82%E9%85%8D-0.17.2%20%E5%B7%B2%E9%AA%8C%E8%AF%81-4E9BF1'))"` → **`DSH 适配-0.17.2 已验证-4E9BF1`**——徽章文字与颜色逐一核对无误。
+- `grep -n "0\.1\.2" README.md` → 仅 README.md:106 一行（最低要求项；旧徽章形态 `>=0.1.2--rc.1` 已消失）；`grep -n "0\.17\.2" README.md` → 恰为 README.md:14 与 README.md:106 两处。
+- `grep -c "COGMAP:BEGIN" README.md` → **1**，标记段完好。
+- `python scripts/cogmap_sync.py check`（gate 内实跑）→「cogmap check: 通过（cg 36 op / stg 4 op / whitebox 6 action / mdcg_* 31 个…全部一致）」——gate 未因本次修改报错。
+- **未做**：真机 DSH 0.17.2 配合验证（任务书声明用户已实测，本任务只做文档声明）。
+
+---
+
+## 四、验证（本会话全部实跑复验）
+
+| # | 检查 | 命令 | 实测结果 | 判定 |
+|---|---|---|---|---|
+| ① | build | `npm run build` | exit=0；`ls` 确认 lib/init.js、lib/cli.js 生成；`head -1` 两文件均为 `#!/usr/bin/env node`（shebang 保留） | **通过** |
+| ② | init 单测 | `node --import tsx --test --test-timeout=15000 test/init.test.ts` | tests 6 / pass 6 / fail 0（四端 E2E、幂等、交互 DSH 分支、交互缺省分支、非 TTY 缺参、缺省根口径） | **通过** |
+| ③ | 全量测试 | `npm test` | exit 0；tests 59 = pass 58 + skipped 1 + fail 0（skip 为既有 python-utf8-mode 环境性用例「内层 locale 已是 utf-8，无从构造 gbk 现场」，与本次改动无关） | **通过** |
+| ④ | init E2E 真跑 | 临时目录实跑（见下） | 编译产物直跑全链 | **通过** |
+| ⑤ | gate | `npm run gate` | exit 0：check_unreachable VERDICT=PASS（FAIL 规则=0）/ cogmap check 通过 / link_check 228 OK·0 BROKEN / workspace_index --check [OK] 顶层 20·追踪 1998 / verify_discipline 结论 9/9 目标一致 | **通过** |
+| ⑥ | 索引守卫单跑 | `python scripts/workspace_index.py --check` | `[OK ] 工作区索引与仓库一致（顶层目录 20 · 追踪 1998 件）`，exit 0 | **通过** |
+
+**④ E2E 细节**（临时目录，测毕已清理，不触真实 `~/.lingshu` 与在役库）：
+
+- `node lib/init.js --end claude --root <tmp>/mem --python python3` → exit=0；stdout 含 MDCG_ROOT×2、`md_cg.tokens issue`、`README「写入凭据」`、「建议换成 git clone」提示；`lingshu-mcp-snippet.json` 落临时目录且 `JSON.parse` 通过（MDCG_ROOT 指向 `<tmp>/mem`、ACTOR=claude-code）；`<tmp>/mem` **未创建**（test 判定）。
+- 同参数重跑 → `diff run1.txt run2.txt` 为空（**stdout 幂等**）。
+- `node lib/cli.js init -- --end dsh --root <tmp>/mem2 --python python` → exit=0（分发 + `--` 分隔符 + dsh 端 `MDCG_ACTOR: "dsh-memory"` 与令牌 actor dsh-memory 实测）。
+- `node lib/cli.js`（无命令）→ 打印用法 exit=1；`node lib/cli.js badcmd` → exit=1。
+- `node lib/init.js`（非 TTY 缺参）→ exit=1，stderr：`lingshu-init：非交互环境（stdin 非 TTY）必须给齐参数：--end --root --python。示例：…`。
+
+**未验证（如实声明）**：
+
+- a) `npx @furongjun1999/dsh-memory init` **联网安装全链路未跑**——需发布含 bin 的新版本后 npx 才可能从 registry 拉到；本会话验证的是其依赖的机制（bin 声明 + lib/cli.js、lib/init.js 直跑行为）与 npm npx 多 bin 同名匹配规则。
+- b) **真实 TTY 下人工交互问答未跑**（本会话无交互终端），由单测 mock stdin 覆盖同一代码路径（DSH 分支 + 缺省分支，test/init.test.ts:102/:128）。
+- c) `npm version 0.6.0` / `npm pack --dry-run` / `npm publish` **未执行**——属第五节编排待执行清单。
+
+**另注（WORKSPACE_INDEX 陈化）**：索引重生成把此前的陈化欠账一并刷新（快照 HEAD `2e9bfe8`→`d7c6e347`、追踪 1828→1998 件，src/ 12→14 中本次贡献 2 件）——该陈化在本次改动前已存在（此前提交未重生成索引），不回滚（回滚会使 gate 的索引守卫在当前树上亮红）。
+
+---
+
+## 五、发布清单（编排待执行）
+
+以下动作**本会话未执行**，按序待编排/使用者完成：
+
+1. `npm version 0.6.0`——当前 version 仍为 0.5.1（package.json:3 实读）。
+2. `npm pack --dry-run`——核对 files 集合（lib/、md_cg/、skills/ 等，package.json:19-29）与 bin 三键（package.json:8-12）入包形态。
+3. `npm publish`——需使用者终端凭据；`prepublishOnly` 钩子（package.json:88）将自动串联 `npm run build && npm test && npm run gate`（三者本会话均已预验通过）。
+4. 发布后补验：`npx @furongjun1999/dsh-memory init`（清 npx 缓存后）——registry 拉到含 bin 版本后的一键配置全链路终验。
+5. git commit 由编排会话统一负责（本会话未 commit，遵守纪律）。
+
+---
+
+## 六、纪律合规声明
+
+1. **零运行时依赖**：init/cli 仅 import `node:fs`/`node:os`/`node:readline/promises`/`node:path`/`node:url` + 包内 lib 模块（src/init.ts:29-36、src/cli.ts:14-16 实读），未加 prompts/inquirer 等第三方依赖。
+2. **实验只在临时目录**：E2E 全部落 `mktemp -d` 临时目录并以 `--root` 指向临时路径，未触真实 `~/.lingshu`、未触在役库；测毕 `rm -rf` 并复核不存在。单测同口径（test/init.test.ts:14-15 头注「不 spawn python、不触碰 ~/.lingshu、不触真实记忆库」）。
+3. **不写本机绝对路径**：本报告路径一律仓库相对形态（临时目录以 `<tmp>` 代指）。
+4. **未 git commit**：工作区保持编排会话负责提交的形态。
+5. **诚实报告**：第四节列出全部未验证项（npx 联网链路/真 TTY 交互/version+pack+publish/真机 DSH 0.17.2 配合验证），无一项填充为「已通过」。
+6. **现场遗留说明**：仓库根有一份前会话遗留的未跟踪 `lingshu-mcp-snippet.json`（MDCG_ROOT 指向 `.lingshu-init-e2e-root`，该目录确认不存在）。本会话复验时曾因在仓库根直跑 init 被 `process.cwd()` 语义覆盖此文件（init 按设计把片段写到当前目录），已当即用同参数重跑恢复（恢复后 MDCG_ROOT 实读核对为 `.lingshu-init-e2e-root`）。该文件属前会话 E2E 遗留产物、未跟踪，是否清理由编排会话决定——**注意**：其 MDCG_ROOT 指向的仓库内路径不可作为真实记忆根使用（勿把记忆写进插件包目录，README cordis.yml 示例同此警示）。
+
+---
+
+## 附：自查双清单
+
+### 清单一：已验证清单（本会话实跑，全部有命令+输出）
+
+| 检查 | 命令/方式 | 结果 |
+|---|---|---|
+| 构建 | `npm run build` | exit 0；lib/init.js + lib/cli.js 生成，shebang 保留 |
+| init 单测 | `node --import tsx --test --test-timeout=15000 test/init.test.ts` | 6/6 pass，0 fail |
+| 全量测试 | `npm test` | exit 0；59 = 58 pass + 1 skip（既有环境性）+ 0 fail |
+| E2E 非交互 | `node lib/init.js --end claude --root <tmp>/mem --python python3`（临时目录） | exit 0；片段+落盘+JSON 可解析+记忆根未创建 |
+| E2E 幂等 | 同参重跑 `diff run1.txt run2.txt` | 空（逐字节一致） |
+| E2E 分发 | `node lib/cli.js init -- --end dsh --root <tmp>/mem2 --python python` | exit 0；端=DSH 插件；actor=dsh-memory |
+| E2E 用法/错误 | `node lib/cli.js`、`badcmd`、`node lib/init.js`（非 TTY 缺参） | 各 exit 1；报错点名 --end --root --python |
+| gate | `npm run gate` | exit 0；五守卫全绿 |
+| 索引守卫 | `python scripts/workspace_index.py --check` | [OK] exit 0 |
+| 徽章文字 | `node -e decodeURIComponent(...)` | 「DSH 适配-0.17.2 已验证-4E9BF1」 |
+| README 计数 | `grep -n "0\.1\.2"` / `"0\.17\.2"` / `grep -c "COGMAP:BEGIN"` | 仅 :106 最低要求项 ／ 恰 :14+:106 两处 ／ 标记段=1 |
+| diff 范围 | `git diff README.md` hunk 清点 | 3 hunks：徽章 / 一键配置段（会话前已有）/ 前置行 |
+| 引用行号 | 读取 src/init.ts、src/cli.ts、test/init.test.ts、package.json、README、src/lib 三件 | 全部核对一致 |
+
+### 清单二：未验证与欠账清单（如实声明，编排可循）
+
+| 项 | 状态 | 原因 / 后续 |
+|---|---|---|
+| `npx @furongjun1999/dsh-memory init` 联网全链路 | 未跑 | registry 需发布含 bin 版本；发布后按第五节 4 补验 |
+| 真实 TTY 人工交互问答 | 未跑 | 本会话无交互终端；单测 mock stdin 覆盖同一代码路径 |
+| `npm version 0.6.0` / `npm pack --dry-run` / `npm publish` | 未执行 | 编排待执行；publish 需使用者终端凭据；当前 version=0.5.1 |
+| 真机 DSH 0.17.2 配合验证 | 未跑 | 任务书声明用户已实测，本次仅文档声明 |
+| python-utf8-mode 1 例 skip | 维持 skip | 既有环境性用例（内层 locale 已是 utf-8），与本次改动无关 |
+| 仓库根遗留 `lingshu-mcp-snippet.json` | 待编排决定 | 前会话 E2E 遗留、未跟踪；本会话已恢复原内容；MDCG_ROOT 指向路径不可作真实记忆根 |

package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md

@@ -0,0 +1,205 @@
+# 0.6.1 发布报告 v1.0 —— 外部测试报告核验 · 四批修复 · Linux 双栈验证
+
+> 批次：0.6.1 发布 ｜ 报告：v1.0 ｜ 环境：win32（Windows 10.0.19045）+ Docker Desktop（ServerVersion 28.4.0）
+> 仓库 `dsh-memory-main`，发版前 HEAD `956807a1`，本版基线 `06db0f74`
+> 编号说明：上一件为 [`发布06_一键配置与DSH0172_v1.0.md`](发布06_一键配置与DSH0172_v1.0.md)（0.6.0），本件续其序号为 07。
+> 本报告所引全部检查为本会话**实跑复验**的结果；未跑项在第六节如实声明。**代理自报不作为判据**——每批均由编排侧独立复跑守卫、套件与门禁。
+
+---
+
+## 一、总览
+
+本版修的是**外部 DSH 插件测试报告**中经核验「在 HEAD 上仍生效」的缺陷。一个前提必须先说清楚：
+
+> 那份报告测的是**已发布的 npm 0.6.0 制品**，其代码早于本仓 HEAD；而 HEAD 的版本串当时**也是 0.6.0**
+> ⇒ 一切「已修/未修」的判断只能**按代码**，不能按版本号。因此本轮先用九项探针把报告断言逐条落到 HEAD 的代码行为上，再动手。
+
+| 阶段 | 内容 | 结果 |
+|---|---|---|
+| 第 0 步 | 九项探针（P-1…P-9b），只读、沙箱 root、绝不碰在役库 | 推翻我三处预判；额外挖出报告未含的缺陷 |
+| 第 1 包 | 写面静默失败族（B1 自动 id 撞毫秒 / B2 密级静默降级 / B4 索引分片目录不自愈） | `778f8ede`，12 文件 +2344/−22 |
+| 第 2 包 | 合并吞正文与冲突误判（B3 / H8 / H3）+ 补强 | `69e8719b`，8 文件 +1094/−41 |
+| 第 3 包 | 召回面诚实性（H7/H10/H11/M1/M2/M3/M4/H9）+ 补强 | `2e7d7230`（18 文件 +3636/−140）、`f706b799`（9 文件 +243/−66） |
+| 第 4 包 | 插件面（M5 / H5 / H6 / H1 / H2） | `956807a1`，14 文件 +1777/−36 |
+| 收口 | 版本号 8 处 → 0.6.1 · README 版本表 · 门禁链文档订正 · **自查抓到并修掉一条自有回归** | 见第四、七节 |
+
+四批合计（`06db0f74..956807a1`）：**43 文件，+9036 / −247**。执行模型沿用第 17 条——每个工作包派发一轮 zcode 动态工作流（契约：先探针读数 → 再改码 → 守卫 → 定点变异自证 → 报告逐条读数），编排侧独立复核并分批提交。
+
+---
+
+## 二、九项探针：三处预判被推翻
+
+探针全部独立 `tempfile` 沙箱 root（独立 `MDCG_ROOT`/`MDCG_AUX_ROOT`/`MDCG_MASTER_KEY`）、argv 列表 + `shell=False` + 显式 UTF-8，**不写入在役库**。三条结论与我事前的判断相反：
+
+1. **P-4（分片目录删除后能否自愈）**——我原以为「新进程也看不到节点」，**被证伪**：全新短命进程本就会重建目录，故不自愈的必要条件是「本进程已持有 `ShardLog` 实例」（长驻 MCP serve 形态）。B4 的修法与反证据此写成。
+2. **P-9a（H4 统一归一层默认开影响英文检索）**——**直接证伪报告结论**：默认态下英文查询命中 gold top1，且仓内本就有两条测试断言这一点。报告该条**不成立**。按使用者裁定「不动默认，补探针与文档」，本版**不翻全局默认**。
+3. **P-3（MERGE 还是熵 DROP 吞正文）**——我原以为只有一条分支有问题，**实测是两条都吞**：`0.85` 的 MERGE 与 `0.60` 的熵 DROP 都丢新正文。第 2 包据此两分支一起修。
+
+九探针另额外挖出**报告里没有**的三条缺陷：
+
+- **①** CCG 哨兵 `不适用条件：无` 会无条件触发 `condition_clash`（假冲突）⇒ 第 2 包 H8-⑤ 收口（`_is_null_condition` + 输入剥空值）。
+- **②** 基类 `MdCG.search` 的负记忆提示段会把同一节点**重复出条** ⇒ 随 H10 负尾单点化一并收口。**诚实边界**：收口后「重复出条」这一具体形态**我未单独立断言复验**，只由 `test_neg_tail_honesty.py`（44 断言）与 `test_read_face_semantics.py`（123 断言）间接覆盖 ⇒ **记为待复验项**。
+- **③** `scripts/linkref_backfill.py` 仍在铸造裸毫秒 id（存量现场遗漏）⇒ 第 1 包 B1 把它改为委托 `mint_auto_id`，守卫断言「`def mint_auto_id(` 全仓仅 1 处」。
+
+---
+
+## 三、四批修复逐条
+
+### 3.1 第 1 包 `778f8ede` —— 写面静默失败族
+
+| 项 | 缺陷 | 修法（单点） | 守卫 |
+|---|---|---|---|
+| **B1** | 同毫秒自动 id 相撞**静默顶替**（并发写入丢条目） | 唯一铸造点 `mdcg.mint_auto_id`：形态 `mem_<毫秒>_<6位hex>`，撞既有 id 换随机段**有界重生成**（5 次），撞满 fail-closed 抛错；`writepipe` / `mcp_server` / `linkref_backfill` 三处现场全部委托 | `test_b1_auto_id_multiproc.py`（11）、`test_b1b2_write_face.py`（33） |
+| **B2** | 声明 `private` 却落 `internal`，**密级静默降级** | 四处落盘实参表补 `sensitivity` 透传 + 单点 fail-closed 闸 `_check_sensitivity_landing` 接在全库唯一写盘口 `MdCG._write_node`（12 处调用点一次覆盖）；**声明值与落盘值经 `declared_sensitivity` 分离**，否则 `or DEFAULT` 会把两者归一、闸永远看不见差异 | `test_b2_sensitivity_landing.py`（14） |
+| **B4** | 长驻进程删掉 `_index_log/` 后**永不自愈** | 单点 `fsutil.ensure_shard_dir`（缺失即建 / 失败抛结构化 `ShardDirError` 带 code+hint / 成功记账 + stderr 告警——**容忍不等于静默**） | `test_b4_shard_dir_selfheal.py`（29）、`_guard.py`（21） |
+
+**语义未动**：显式传 `node_id` 的「同 id 即改写」既有 upsert 契约原样保留（有断言钉住不被误伤）；`read_all` 缺目录返回 `[]` 的既有语义未动。
+
+### 3.2 第 2 包 `69e8719b` —— 合并吞正文与冲突误判
+
+- **B3（真凶已定位）**：`forgetting.reinforce` 写回的是 `node.get("content")`（**既有**正文），且签名根本没有 content 参数。修法＝加 `content=None` 槽（缺省不变 ⇒ 既有调用零破坏）+ 抽出共享聚合行 `forgetting.aggregate_line`（`reinforce` 与 `writelimit.converge_into` 同源），**MERGE 与熵 DROP 两条分支都写「新正文去向」**，且聚合行不再被截断在 80 字符。
+- **H8**：仅空白差异（`\r\n`↔`\n`、尾换行、缩进）的近重复被误判成 `same_condition_divergence`。修法＝两侧改用**同一归一化** `_norm_ws/_nows` + 「逐字相同 ⇒ 必判重复」短路；阈值 `CONCLUSION_SAME=0.95` **未动**。顺带补上此前**零覆盖**的 `CONCLUSION_SAME` 判据。
+- **H3**：合并时**双方归属并列**落 `fm`（`forgetting.note_source`，有界 20 条），不再只留一侧。
+- **H8-⑤**：CCG 哨兵空值化（见第二节①）。
+- 守卫：`test_b3_merge_keeps_content.py`（31）、`test_p11_consistency.py` G 段（42）、`test_p30_maintain.py`（57）。
+
+### 3.3 第 3 包 `2e7d7230` + 补强 `f706b799` —— 召回面诚实性
+
+| 项 | 缺陷 | 修法 |
+|---|---|---|
+| **H10** | 被负记忆覆盖的条目以 `score=1.0` 冒充答案、被顶到首位且**溢出 k** | 哨兵值 `NEG_COVERAGE_SCORE`（不再用 1.0）、尾部位置、条数 `min(NEG_COVERAGE_MAX, k)` **计入 k 预算**、`_compute_d` 分母排除提示条目；负尾单点 `_neg_tail` 构造，带 `negative_coverage`/`neg_layer`/`node_id` 三个独立字段 |
+| **H7** | 负记忆路由层未短路（读面串层） | `NEG_ROUTE_LAYERS` 单点 + `_ticket_slug`/`_refresh_unresolved` 工单刷新 |
+| **H11** | 一致性飞轮对**任意**判定建工单（噪音） | `FLYWHEEL_TRIGGERS=("REJECT",)`——只对**真冲突**建单 |
+| **M1** | `k=0` 被当成「没传」（静默换成缺省 20） | 统一 `is not None` 口径，单点 `_int_arg`；k 族同族 **8 处**一并收口（补强批） |
+| **M2** | `node_id` 类型错返回**裸 null** | 类型闸 + 结构化错误（对齐既有 `{"ok": False, "error": "not_found"}` 口径） |
+| **M3** | 仅 1 个桶的库被判「分区健康」 | `routing.bucket_health(counts, total_nodes)`——巨桶检查加 `nb > 1`，单桶给显式 reason「条件路由不可用（无分区，非退化）」，`counts=={}` 但对非空库判红 |
+| **M4** | 隐式默认动作不可辨 | `action_source` 登记进 `protocol.py` 真源 + 对外暴露 |
+| **H9** | `protect.mark` 对不存在节点返回裸 null | 改结构化 `{"ok": False, "error": "node_not_found", ...}` |
+
+- 新守卫：`test_recall_face_guards.py`（41）、`test_neg_tail_honesty.py`（42→44）、`test_read_face_input_gates.py`（61→77）、`test_read_face_semantics.py`（123）、`test_m3_h9_bucket_health_protect_mark.py`（31）、`test_m3_h9_semantic_guard.py`（41）、`test_protocol.py`（→44）。
+- **既有守卫的方向性改动我逐条判过**：`test_retr_s5.py` 三条分数断言由 `1.0/0.5/0.75` 改 `0.0`、`test_p11_consistency.py` D 段重写——**方向均为收严**（对缺陷更敏感），不是放宽。
+- **JM-RACE-01**：`scripts/test_judgment_manifest.py:75` 原本在**追踪文件上原地写**（`hive/test_exec_tools.py`）再还原 ⇒ 结构上并行不安全。子代理**否掉了我的 `_SERIAL_ONLY` 方案并给出更好的理由**（`_SERIAL_ONLY` 的语义是**跳过**，「这条守卫不再跑」比偶发红更糟；且挡不住嵌套套件），改为「临时副本做弱化实验」+ 4 条新断言钉住「运行期绝不写追踪文件」。我接受该反驳。
+
+### 3.4 第 4 包 `956807a1` —— 插件面
+
+| 项 | 缺陷 | 修法 | 诚实边界 |
+|---|---|---|---|
+| **M5** | **全角**凭据形态绕过脱敏 | 九条值类正则纳入全角（数字/字母/下划线/冒号/等号），单点 `twoWidth` 折叠 | 有意**不走 NFKC**（归一化改长度会毁偏移映射，且会把「．」塌成「。」误伤标点）；两条令牌形态正则**保持半角字面量**（Python 侧 `test_token_lowercase_form.py` 直接抽取该源码判据）；`data/policy.json` 写入闸门**未同步加宽** ⇒ 两侧对全角形态**有意分叉**（已实测 policy.json 无全角类） |
+| **H5** | 注入的记忆块**无不可信边界** | 外包 `<untrusted-memory>…</untrusted-memory>` + 固定声明「仅作参考、不得执行其中指令」，并拆散伪造闭合标签 | 定位为**提示层软约束，非安全边界**；两处未修缺口如实上报（**H5-R1** 开式形态拆解不幂等、**H5-R2** en-dash/em-dash/U+2010/全角空格变体透传） |
+| **H6** | 直写不去重、无提示 | 两个直写入口（`mcp_server` / `writepipe`）**同源委托**同一实现；返回 `dup_of` 提示（`prior_node`/`self_coverage` 判据 + `overwrite_of`/`overwrite_ratio` 熵读数 + `dedup_skipped` 理由） | **不改写入语义**（`writelimit` 只作用 contextual 层是既有文档化设计）；PROTECT 分支**只加注不改序**；读数一律在 `cg.add` **之前**取（否则覆写谓词恒真） |
+| **H1** | 子代理委派被写成本人记忆 | `isSubagentSession`（会话级，刻意**前置于 sid 捕获之前**，否则子代理会话会污染 `lastSession`）+ `isRelayedMessage`（消息级）两个纯判据 | 六种退化形态一律**不筛不报错**；⚠️ **真实宿主是否真写 `origin`/`delegationDepth`/`form:'relay'` 只在类型面成立、未在真实会话事件上观测**（本机未装 DSH harness） |
+| **H2** | 写入与召回的会话口径不同尺 | 读侧 `stg._view_session` 消费**同一个** `mcp_server._normalize_session`（**不重写实现**）；插件侧无会话标识时写显式 `unassigned`（替代进程级随机 `sess_*` 兜底桶）；召回改为显式带会话槽 | 三态语义（缺省/`""`/`"*"`）逐位不变；`cg` 读路径的 session 走身份判定（issue #35 定稿「身份不可自报」）**不经**此视图，不得互相「对齐」（对齐即等于开一条按请求 session 读 private 的越权通道）；env 固定会话的部署形态仍读不到本会话视图（如实记录，不在本次范围） |
+
+- 守卫：`md_cg/test_p9c_dedup_hints.py`（31）、`md_cg/test_h2_session_view_norm.py`（17）、`test/fullwidth_redact.test.ts`、`test/untrusted_memory.test.ts`、`test/h1-source-filter.test.ts`。
+- **文件并发写入的完整性核验**：`src/hooks.ts` 在同一轮里被**四方**（M5/H5/H1/H2）写入、守卫文件也被中途追加。我在提交前逐标记核验四处改动**全部在场且互不覆盖**（`twoWidth`/`renderUntrustedMemoryBlock`/`isSubagentSession`/`UNASSIGNED_SESSION`），变异残留扫描全程为 0。
+- **我自己的派发契约缺陷**：H1/H2 的 `hooks.ts` 侧在我写的归属划分里**没有主**（我把 hooks.ts 排给了插件面修改员，却把 H1/H2 排给了另一员）。是该子代理**拒答并上报**（`dwfq-a9007424-1`）才暴露的——**缺陷在我，不在它的边界**。我据此补授权并加了三项防丢更新要求。
+
+---
+
+## 四、自有回归：自查抓到的一条，比新增守卫更重要
+
+容器栈一（Linux）第一次跑出 `[FAIL] md_cg.test_policy_required_ccg --head-baseline`。取证链条：
+
+1. **红项集合比对**：实际 `{G2b,G2c,G2d,G3b,G3c,G4a,G4b,G4c,G5a,**G8a**,G8c,**G8d**}` vs 预期 `{…,**G8b**,G8c}` ⇒ 多出 G8a/G8d（`ModuleNotFoundError: No module named 'mdcg_head.mdcg'`），且**预期该红的 G8b 变绿了**。
+2. **基线对拍（决定性）**：把改前的 `06db0f74` 检出到**独立 worktree** 跑同一守卫 ⇒ 红项**恰好**是预期 11 项、自带红基线 PASS ⇒ **这是我这四批引入的回归，不是既有状态**（worktree 已 `remove`，工作区未被触碰）。
+3. **根因**：该守卫用「假包 `mdcg_head` + 转发层 `_SHIMS`」把工作区源码做定点变异后单测。我这四批给 `md_cg/writepipe.py` 新增了两处**函数内**委托（`from .mdcg import …`、`from . import forgetting`），而 `_SHIMS` 没跟上 ⇒ 假包缺模块 ⇒ 调用期抛异常 ⇒ 被 `_try` 收成 `err`、`got` 退化为 `{}` ⇒ `hint=""` ⇒ **G8b 的 `"重试同样结果" not in ""` 恒真**，于是「守卫坏了」伪装成「多两个红项 + 一个假绿」。
+
+**修法（治三处，不只是补一个名字）**：
+
+1. 补齐转发层：`_SHIMS` 增加 `mdcg`/`forgetting`/`units`/`coldverify`/`hotcache`/`hyperedge`/`nodefile`——注意后五个是我这条新判据**自己查出来的**（历史靠「那条路径没跑到」侥幸绿着）。
+2. **新增 fail-closed 判据 `_check_shim_coverage`**：用 AST 抽取基线源里**全部**相对 import（含函数内延迟导入），凡未登记即报 `SHIM-MISS` 并点名模块 ⇒ 同类缺口从此在**装配期**就叫停，不再退化成假绿。**定点变异自证**：抽掉 `_SHIMS` 里的 `forgetting` ⇒ 立刻 `SHIM-MISS` 且**逐字点名 `writepipe -> .forgetting`**。
+3. **堵死假绿**：G8b 断言补 `err is None and bool(hint)`。**定点变异自证**：用一个「一碰就抛」的 `wp_mod` 桩跑 `run_checks` ⇒ G8b **转红**（detail = `RuntimeError: boom-stub(WritePipeline)`），而旧写法在同一输入下判定为 `True`（假绿形态**在进程内复现**）。
+
+修后：绿态 **28 pass / 0 fail**、红基线**红项恰好 11 项**（`rc=0`），容器栈一该腿 `[PASS]`。
+
+---
+
+## 五、验证读数（本会话实跑，逐条为原始读数）
+
+### 5.1 分批复跑（每批提交前后各一次）
+
+| 批次 | python 全量 | npm test | gate |
+|---|---|---|---|
+| 第 1 包 `778f8ede` | 277/277 | — | rc=0 |
+| 第 2 包 `69e8719b` | 278/278 | — | rc=0 |
+| 第 3 包 `2e7d7230` | 284/284 | — | rc=0 |
+| 第 3 包补强 `f706b799` | 286/286 | — | rc=0 |
+| 第 4 包 `956807a1` | 286/286（5 跳过） | rc=0（99 用例 / 98 通过 / 1 跳过） | rc=0 |
+
+### 5.2 发版验证三连（改版后最终态）
+
+| 项 | 命令 | 读数 |
+|---|---|---|
+| ① | `python scripts/run_tests.py --jobs 4` | **286/286 通过，5 跳过**，rc=0 |
+| ② | `npm.cmd test`（= build + `node --import tsx --test "test/*.test.ts"`） | **99 用例 / 98 通过 / 0 失败 / 1 跳过**，rc=0 |
+| ③ | `npm.cmd run gate`（8 条腿） | **VERDICT=PASS**，rc=0 |
+
+gate 八腿逐条：`check_unreachable` PASS · `check_publish_artifact` PASS（R1 凭据面=0/0、R2、R3、**R4 非追踪=28 允许=28**、R5、R6）· `cogmap_sync check` PASS · `link_check` PASS · `workspace_index --check` [OK]（顶层 20 · 追踪 2104 件）· `verify_discipline --allow-missing` PASS（9 条链一致 / 1 SKIP codebuddy-local 未生成）· `cargo test` rc=0 **27 passed / 0 failed** · `rank_parity` rc=0 **两侧同口径逐位一致**。
+
+### 5.3 Linux 容器双栈（Docker Desktop 28.4.0）
+
+前置：三个容器脚本（`scripts/*.sh`）**CRLF=0**（纯 LF）——`core.autocrlf=true` 下 CRLF 会让整腿在第一步退出。
+
+| 栈 | 镜像 / 命令 | 读数 |
+|---|---|---|
+| 栈一 | `rust:bookworm` + `bash scripts/linux_verify.sh full`（`CARGO_TARGET_DIR=/tmp/target`，与 Windows 侧 `target/` 隔离） | **38 pass / 0 fail**，rc=0（Python 3.11.2 / cargo 1.98.1；含 `cargo test`、`cargo build --release`、23 条 `md_cg` 套件、4 条 hive python、7 条 head/branch 基线自证腿、1 条 hive 锚链自证腿、smoke） |
+| 栈二 | `node:22-bookworm` + `npm ci --include=dev && npm run build && node --import tsx --test test/*.test.ts` | **99 用例 / 96 通过 / 0 失败 / 3 跳过**，rc=0 |
+
+两处**口径修正**（相对我事前的说法，如实记账）：
+
+- 栈二原用 `npm install`，会**在挂载的仓内**重装 `node_modules`（把宿主 win32 的 esbuild 二进制换成 Linux 版，且 `npm install` 会改写 `package-lock.json`）。已改为 **`npm ci` + `node_modules` 挂匿名卷**隔离。
+- 栈一的 `cargo test` 腿覆盖的是 **`hive` crate**，**不是 `rust/`**；且脚本用 `tail -4` 截断输出，容器日志里可见的是最后一个测试二进制的 `0 passed`（真实通过数被截断，**腿的判据是退出码**）。`rust/` 的 27 passed 由 Windows 侧 gate 的 `gate_rust_crate_test` 腿给出。
+
+### 5.4 版本面
+
+| 项 | 处置 |
+|---|---|
+| 版本号 **8 处** → 0.6.1 | `package.json:3` · `package-lock.json:3/:9` · `.claude-plugin/marketplace.json:12` · `claude/lingshu-memory/.claude-plugin/plugin.json:4` · `codex/lingshu-memory/.codex-plugin/plugin.json:3` · `skills/plugin.json:4` · `README.md:16`。逐处**断言命中数**后字节级替换（`package-lock.json:810` 的 `^10.6.0` 是引擎区间，**未误伤**） |
+| `SERVER_VERSION` | **未动**——它动态读 `package.json`，正是 issue #42 的修法 |
+| README 版本表 | 原表从 v0.5.1 直跳 0.6.0（历史遗漏），本版补 `Release v0.6.0` 与 `Release v0.6.1` **两行** |
+| `docs/mdcg/发布门禁链_v0.1.md` | 陈旧表述订正：门禁由「五道」改为**八道**，并**逐条与 `package.json` 的 `scripts.gate` 实读对齐**。新增诚实边界：第 1/7/8 道（`check_unreachable` 与两条 Rust 腿）**没有对应 CI workflow**——`hive-check.yml` 只跑 `hive/Cargo.toml`，`rust/` 至今零 CI |
+
+---
+
+## 六、未跑 / 未修清单（如实声明）
+
+**未跑**：
+
+- `npm pack` / `npm publish` —— publish 属使用者终端凭据动作（实测 `npm whoami` = E401 凭据无效）。`prepublishOnly` 会在发布时自动再跑 build+test+gate。
+- 发布后回验（`check_publish_artifact.py --registry 0.6.1`、`npx @furongjun1999/dsh-memory init` 清缓存终验、`check_registry_tarball.py`）——须等 registry 出现 0.6.1 之后。
+- **H1 的真实宿主行为**：本机未装 DSH harness ⇒ 「宿主要不要真写 `origin`/`delegationDepth`/`form:'relay'`」**只在类型面成立、未在真实会话事件上观测过**。守卫证明的是「判据在场即拦、缺失即不拦」这一可机械判定的性质，**不是**真实委派已被拦住。
+- `test_conformance.py:312` 硬编码一条**本机活库绝对路径**（`<盘符>/Program Files/2_ai/…` 形态；门禁 R3 的 `LOCAL_PATH_PROGRAM` 规则对本仓自有文档同样生效，故本报告不复述字面量）——按本轮「不碰在役库」约束，复核侧改用 `conformance --root <沙箱>` 替代，**未在活库上跑**。
+- 第二节的**探针额外发现②（负尾重复出条）**：收口方式为负尾单点化，**该具体形态未单独立断言复验** ⇒ 待复验。
+
+**未修（记入留池，供使用者裁定）**：
+
+| # | 项 | 位置 / 形态 |
+|---|---|---|
+| 1 | `limit=0` / `k=0` 在**库层**语义与读面不一致 | `scrub.py:859 records[-int(limit):]`（`limit=0` ⇒ 「全量」）、`tasks.py:447 max(int(k or 5), 1)`（`k=0` ≡ `k=5`）——补强批「下限 1」的措辞据此**订正为不准确** |
+| 2 | 同族更宽的两处 | `mcp_server.py:1981`（help, k=40）/ `:2141`（link.evidence, k=100） |
+| 3 | `backfill.py:61 SKIP_LAYERS` 第三份字面量副本 | 未收单点 |
+| 4 | MCP 结果面未暴露 `negative_coverage` / `neg_layer` / `node_id` | 提示只在库层结果里可判 |
+| 5 | `mdcg_get` 对 list/dict 型 `node_id` 仍抛异常 | 与 M2 同族，未一并收口 |
+| 6 | legacy `unr_<sha10hex>` 工单未迁移 | 与 H7 的 `_ticket_slug` 同族 |
+| 7 | `merge_count` / `last_merge_at` 未镜像进内存索引 | H3 只落了 fm |
+| 8 | **H5-R1** 开式形态拆解不幂等（docstring 声称幂等，实测仅闭合形态成立） | 第 4 包守卫复核发现并独立复现 |
+| 9 | **H5-R2** en-dash / em-dash / U+2010 / 全角空格变体透传 | 同上 |
+
+---
+
+## 七、纪律合规声明（第 16 条格式）
+
+- **功能名**：0.6.1 发布准备（外部报告核验 · 四批修复 · Linux 双栈验证）
+- **生效条件**：`git tag v0.6.1` 存在且 `npm publish` 由使用者执行完成；在此之前本报告描述的修复只在**仓库 HEAD** 生效，**不在** registry 的 0.6.0 制品里。
+- **子功能**：① 九探针先行取证 ② 四批写面/合并面/召回面/插件面修复（各带守卫与定点变异自证）③ 自有回归的取证与修复（第 4 节）④ 版本面与文档面收口 ⑤ Linux 容器双栈验证
+- **执行**：见第三节各批提交（`778f8ede` / `69e8719b` / `2e7d7230` / `f706b799` / `956807a1`）与第五节读数的对应命令；每批提交前**均由编排侧独立复跑**守卫、套件与门禁，**代理自报未作为判据**。
+- **验证方式**：`python scripts/run_tests.py --jobs 4`（286/286）+ `npm.cmd test`（99/98/1）+ `npm.cmd run gate`（8 腿 PASS、`VERDICT=PASS` rc=0）+ Docker 双栈（38/0 与 99/96/3，均 rc=0）+ 基线 worktree 对拍（自有回归的定因）。
+- **不适用条件**：不覆盖**已发布 npm 制品**的行为（那是 0.6.0 代码）；不覆盖**真实 DSH 宿主**的委派字段写入行为（未装 harness）；不覆盖 `test_conformance.py:312` 的活库路径腿（本轮约束不碰在役库）；不覆盖留池 9 项；`SERVER_VERSION` 不在版本面内（动态读 `package.json`，故意的）。
+
+---
+
+## 附：文件清单
+
+**新增守卫（12 个）**：`md_cg/test_b1_auto_id_multiproc.py`、`test_b2_sensitivity_landing.py`、`test_b1b2_write_face.py`、`test_b4_shard_dir_selfheal.py`、`test_b4_shard_dir_selfheal_guard.py`、`test_b3_merge_keeps_content.py`、`test_recall_face_guards.py`、`test_neg_tail_honesty.py`、`test_read_face_input_gates.py`、`test_read_face_semantics.py`、`test_m3_h9_bucket_health_protect_mark.py`、`test_m3_h9_semantic_guard.py`、`test_p9c_dedup_hints.py`、`test_h2_session_view_norm.py` + TS 三份 `test/fullwidth_redact.test.ts`、`test/untrusted_memory.test.ts`、`test/h1-source-filter.test.ts`。
+
+**文档面**：`README.md`（版本串 + 版本表两行）、`docs/mdcg/发布门禁链_v0.1.md`（八道腿订正 + CI 覆盖诚实边界）、`docs/mdcg/README详细版_v0.4.10.md`（H1/H2 的声明与未验证项）、本文件。