@furongjun1999/dsh-memory 0.5.0 → 0.5.1

package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md

@@ -0,0 +1,202 @@
+# 安全审计实锚记录 v0.1
+
+外部审查报告（33 项）的逐项处置实锚。报告原文未随仓库分发，本文档是
+**处置状态真源**：每项记「实锚证据 → 裁定 → 载体」。
+
+## 已修复（批次 24，提交 2a57c2a）
+
+| 项 | 处置 | 载体 |
+|---|---|---|
+| P0-1 node_id 任意文件写入 | 三层纵深：白名单 + realpath 纵深闸 + schema pattern | `md_cg/mdcg.py` `_NODE_ID_RE`、`md_cg/mcp_server.py` |
+| P1-1 mdcg_* 绕过 ops_allow | `_MDCG_OP_REQUIRE` 映射 + `_dispatch` 单点闸 + 完备性守卫 | 同上；守卫 `test_security_audit.py` 13 项 |
+| P2-1 负记忆死调用双倍 IO | 删除死调用 + 注释改写 | `md_cg/mdcg.py` |
+| P1-8 tarfile 解包越界 | `extractall(..., filter="data")` | `scripts/criteria_fingerprint.py` |
+
+字符集裁定（偏离报告建议的理由）：白名单**不含冒号**——NTFS 文件名 `:` 是
+备用数据流（ADS）分隔符，`a:b.md` 实际写 `a` 主文件错位，Windows 硬约束；
+**含 `@`**——无路径语义且存量在用（`mem_a@exp1` 形态）。
+
+## 本批实锚（批次 25）
+
+### P1-6 read_file 收敛 —— 部分分歧 + 增量已修（批次 26）
+
+实锚：`hive/exec.py` `tool_read_file` 已有 **`HIVE_READ_ROOTS`** 白名单机制
+（`read_roots()` + `_under()` 前缀判定，越界即拒），默认放开是
+**2026-09-19 使用者裁定**（docstring 留痕）。
+
+**批次 25 裁定勘误**：本文件曾据此判「已闭环」——报告原文到手后确认报告
+**明确建议默认收敛到 workdir**，与 2026-09-19 裁定构成真实分歧，不是闭环。
+处置（批次 26）：默认放开维持使用者裁定不动；采纳报告建议 3 的增量——
+**敏感凭据路径拒读**（`_sensitive_read`：SSH 私钥/云凭据/浏览器 Cookie/
+dot-env/密钥扩展，内容回喂外部 LLM 网关前拦截），不受根白名单配置影响。
+分歧余项（默认是否收敛）留使用者决策。
+
+### P1-7 自举循环 exec —— 批次 25 实锚错误，批次 26 已修
+
+**批次 25 裁定勘误**：曾把本项错锚到 hive 执行器并判「不适用」——报告原文
+确认真实载体是 `scripts/bootstrap_loop.py:228`：`exec(compile(code, ...), ns)`
+的 `code` 来自 LLM 返回 / `channel_b_queue.json`（模型可控输入），未沙箱。
+
+处置（批次 26）：`_safe_exec_gen` AST denylist 沙箱——禁 import 面、危险
+内建名（eval/exec/compile/open/__import__/反射面）、dunder 属性逃逸链；
+命名空间 `__builtins__` 收窄到纯计算内建（双层防御）。自举循环的合法产出
+（排序/查找类纯函数）不受影响，冒烟 10 恶意样本全拒。
+
+### P1-2 / P1-3 / P1-4 / P1-5 —— 报告原文到手后批次 26 已修
+
+批次 25 曾判「待报告原文」（记忆载体落空）——使用者提供原文
+（`D:\program\dsh-memory-代码审查报告.md`）后对齐施工：
+
+- **P1-2** `src/lib/roleplay_web.ts` `requireEditKey` **fail-closed**：未配置
+  `ROLEPLAY_EDIT_KEY` → 写操作一律 403（`editKeyHint()` 引导配置）。此前
+  「未配置=开放」的 README 如实化被报告正确指出不够——网页面板是唯一
+  浏览器开放面，默认必须关。
+- **P1-3** 原型污染：角色 id 白名单 `validRoleId`（`^[A-Za-z0-9_.-]{1,64}$`
+  + 显式拒 `__proto__`/`constructor`/`prototype`）+ meta 字典统一 **null
+  原型**（`toNullProto`——存量文件已含危险键也只是普通 own 属性）+
+  `/meta` 与 `setTranslations` 入口校验。
+- **P1-4** 路径根白名单 `check_path_root`（`md_cg/security.py`）：ingest /
+  export / link(export/import) / mdcg_ingest 五处接线；
+  `MDCG_INGEST_ROOT` / `MDCG_EXPORT_ROOT` **设置即 fail-closed**、未设置
+  保持现状（与 HIVE_READ_ROOTS 同构的部署开关语义）；`mdcg_ingest` 的
+  权限闸已由批次 24 `_MDCG_OP_REQUIRE`（write）补上。
+- **P1-5** `MDCG_LEGACY_ENV_AUTH` 身份不再能自授 admin：需
+  `MDCG_LEGACY_ENV_ADMIN=1` **显式二次开关**，只设 `MDCG_CAN_ADMIN` 时
+  降级 recorder + stderr 提示（不静默）。
+
+### P0-1 同类残留扫 —— 清零确认
+
+对 `mdcg.py` / `mcp_server.py` / `mdcos.py` 全部 `os.path.join` 面（49 处）
+逐点核查：外部可控输入**仅 node_id 一处**（已三层闸）；其余均为内部常量
+构造（`_index.json` / `_audit.jsonl` / 分片名 `%06d` 格式化串）或只读探测
+（sessions 目录 `os.listdir` 枚举名 + `isdir` 探测，不落盘）。
+
+## 读权限分级（批次 27，使用者需求落地；表述经使用者 2026-09-24 澄清）
+
+**private 的体系语义正名**：private ≠ 个人隐私保密，而是**错误处置标记**——
+工作区内容因错误相关、验证未过、待排查而被标记私有，目的是限制向平级/
+下级扩散。可见性是**故意的冲突设计**：平级/下级限读，但错误处置链路
+（**设计者、上级节点、验证单元**）必须可读。缺口已于批次 28 按使用者裁定
+**分型治本**：新增 `restricted` 档（阶梯
+public<internal<**restricted**<private<secret），错误处置标记用 restricted
+——可见性按**错误处置链路角色集**（designer/orchestr/verify，或
+can_admin）判定而非纯 rank；**不加密**（不在 ENCRYPTED_LEVELS——链路要
+明文读）。private 回归纯隐私/会话绑定语义（加密、仅归属会话+设计者
+豁免）；verify 的初版 cap=private 豁免被分型取代、回滚 internal——
+验证单元不读真隐私。
+
+**新发现——信封加密的第二层墙（批次 28 实验实锤）**：private/secret 节点
+落盘即加密（encrypted_levels），provision_dek 为每个 actor 发独立 DEK、
+节点用**写入者 DEK** 加密——跨 actor 读取解密失败静默空（实验：另一
+designer 读 seed 的 private 节点亦空）。即 cap 豁免只过密级闸，跨 actor
+的 private 实际可读还需 **DEK 共享机制**，三选项待裁定：①DEK 信封共享
+（写者 DEK 用读者身份再包信封——改 seal/envelope 结构）；②设计者代查
+通道（designer 解密后受控转述）；③private 分型（错误标记 vs 隐私加密
+拆开）。不在本批擅自改加密结构。
+
+| 身份 | 文件读面（read_file） | 认知图读面（lingshu_cg read） |
+|---|---|---|
+| 设计者/主代理 | 全路径（2026-09-19 裁定）+ 部署可选 `HIVE_READ_ROOTS`；文本内容过 **PII 脱敏**（跳过个人敏感信息不入明文） | 其密级上限内全量（designer=secret：public/internal/private） |
+| 子代理（worker） | **fail-closed 白名单**：工作区（job_dir）+ 定制工作目录（`spec.workdir`）+ 额外定制目录（`spec.read_roots`，新增）——其他会话/越界拒读；无根即无文件读权限 | 默认密级 **internal**（原 secret 降级）：可读 public/internal，**错误处置标记（private）与 secret 拒读**——平级不消费未证实/已知有误内容 |
+
+实现：`hive/exec.py` `_worker_scope`/`tool_read_file(scope_roots=)`/`_redact_pii`
+（邮箱/手机号/身份证/私钥块/API key 样式；正则脱敏是概率防线，新增类别在
+`_PII_PATTERNS` 扩展）。编排器派生令牌（`_PRINCIPAL_FACTORY`）身份由调用方
+给定，不受默认密级影响。
+
+## 剩余项总览
+
+- **P1 面已全清**（P1-1/2/3/4/5/6增量/7/8）；
+- P1-6 余项分歧：读默认是否从「放开」收敛到 workdir——留使用者决策
+  （2026-09-19 裁定 vs 报告建议，增量黑名单已先行）；
+- P2 剩余 13 项（性能 9 + 安全/健壮性 4，P2-1 已修）：按报告优先序渐进；
+- 部署建议：生产设 `HIVE_READ_ROOTS` / `MDCG_INGEST_ROOT` /
+  `MDCG_EXPORT_ROOT`（三组根开关的消费侧）。
+
+
+## P2-14 根源分析（批次 32，使用者要求查明根源）
+
+**堆积链路**：新版 Windows 移除 wmic.exe → ind_bootstrap_procs 的
+subprocess 抛 FileNotFoundError → except: pass 吞掉返回 [] → main
+停转分支把 [] 解读为「确认无进程」→ **不 kill 旧 loop 直接 restart** →
+每轮叠加一个新进程（堆积）。
+
+**三层根源**：
+1. 组件层：wmic 已从新版 Windows 移除（本机实测 wmic.exe 存在且可运行
+   ——堆积在本机未发生；风险面向新部署）；
+2. **语义层（真根因）**：探测失败（未知）被压平为「确认无进程」——
+   fail-open 的错误处理。修复 = 三态探测：成功返回 list / 失败返回
+   **None（未知）**，调用方对 None 跳过 kill/restart（fail-safe：不确定
+   就不动）；
+3. 历史层（实证）：watchdog 日志 1316 条 100% 是 no_log——
+   ind_bootstrap_procs 在本机历史中从未执行过（bootstrap_log.jsonl
+   不存在，no_log 分支短路），堆积从未发生。
+
+**报告断言修正**：①「taskkill 模糊匹配误杀」不成立——kill_procs 是
+/PID 精确击杀，find 的行过滤也必须含 bootstrap_loop.py；②「判活恒失败」
+在 wmic 存在的机器不成立（no_log 短路根本不进判活）。
+
+**修复落地（批次 32）**：find_bootstrap_procs 升级 CIM 枚举
+（Get-CimInstance+CSV，wmic 依赖消除）+ 三态返回（None=探测未知）；
+main 两个分支（degraded/停转）对 None 一律跳过 kill/restart、状态记
+probe_unknown。行为验证：CIM 实测 []（当前无 loop 进程）、枚举故障
+mock → None。顺带发现：loop 未部署的机器上 watchdog 每 10 分钟刷一条
+no_log 噪声日志（1316 条）——调度侧应停用未部署机器的 watchdog 任务。
+
+
+## P2 面清账终态（批次 30/31/32 + 本批裁定，33 项报告收官）
+
+P2 共 24 项，终态：**23 项修复/闭环 + 1 项裁定保留**。
+
+| 项 | 终态 | 批次 |
+|---|---|---|
+| P2-1 死调用 | 修 | 24 |
+| P2-2 检索双遍历 / P2-3 残留拷贝 / P2-4 重复打分 | 修（单遍双收集/回写自愈/pre_scored） | 31 |
+| P2-5 候选无缓存 | 闭环（批次 21 readcache 先于报告） | 21 |
+| P2-6~8 budget/列目录/context | 修（增量/先截断/读前查大小） | 31 |
+| P2-9~11 transcript/原子写/meta 锁 | 修（尾 500 条/tmp+rename/同步段注记） | 31 |
+| P2-12 UTF-8 截断 / P2-13 日志轮转 / P2-14 watchdog | 修（Buffer/轮转/根源修复三态+CIM） | 31/32 |
+| P2-15~20 安壮面 | 修（fd/timeout/resp 上限/test_cmd env 化/验证器白名单/读路径单点收拢） | 30 |
+| P2-22 schema 薄 | 示范点渐进（node_id pattern 等） | 24/30 |
+| P2-23 role_id 白名单 / P2-24 笔误 | 修 | 30 |
+| **P2-21 自研 ChaCha20-Poly1305** | **裁定保留（本批）** | — |
+
+**P2-21 裁定记录**：报告建议长期换 cryptography 库，使用者裁定
+**不引入第三方依赖**——保留自研实现。依据：报告自标「未见弱密钥或时序
+侧信道」；实现与 RFC 8439 逐段核查一致；仓库测试面（test_p13_encryption）
+覆盖正确性。残余风险如实登记：自研密码学无第三方审计背书，后续若引入
+依赖管理体系可重议。
+
+**P2-13 PS 侧校正**：报告称 dsh-watchdog.ps1「日志追加无轮转」——实锚
+现状为**时间戳分片**（每次运行生成 dsh-\.out.log 新文件），天然无追加
+无轮转需求，主张与现状不符（登记不改）。观察项（报告未提）：时间戳分片
+无限累积，可考虑启动时清理 30 天前旧分片（低优先级，未施工）。
+
+
+## V21 缺陷挖掘报告处置（批次 34/35，提交 1fd4b36+）
+
+第 21 轮对抗式缺陷挖掘（对象 00a2c70b）8 项全修：4 P0 + 4 P1。
+
+| 项 | 级别 | 归属 | 处置 |
+|---|---|---|---|
+| V21-1 editKeyHint 无限自递归 | P0 | 批次 26 引入 | 两分支终止文案；附带修 verify_web mock 缺 ctx.get（空跑） |
+| V21-2 _readable 密级回填 fail-open | P0 | 历史遗留 | 密级未知按最高档 secret（fail-closed） |
+| V21-3 _NODE_ID_RE 只允许 ASCII | P0 | 批次 24 引入 | 放行中文+逗号；5 官方红同源转绿；P0-1 防线不变 |
+| V21-4 run_channel_b 主体被掏空 | P0 | 批次 26 插入错位 | 沙箱段归位模块级，主体恢复 |
+| V21-5 P2-3 回写永久 no-op | P1 | 批次 31 引入 | 就地剥离自愈（s1 断言随语义翻转） |
+| V21-6 P2-4 不可哈希死代码 | P1 | 批次 31 引入 | doc_key[0] 取 node_id 作键 |
+| V21-7 lingshu_cg 不过 PII 脱敏 | P1 | 批次 27 缺口 | _redact_deep 递归脱敏统一接线 |
+| V21-8 _sensitive_read 改名即免检 | P1 | 批次 26 增量的界 | 族匹配（id_* 前缀/credential 子串/.env 后缀） |
+
+流程项落地：
+- **check_unreachable.py** 进 gate 首位——AST 判终止语句后同块后继，
+  一次拦住 s5（批次 33）与 V21-4 同族缺陷；反向样例验证两形态命中；
+- **run_channel_b 全链路冒烟**并入 V21-4 守卫（队列→沙箱→verifier→
+  verified_units/队列回写/rejected_log 五断言）——首跑即暴露两个潜伏
+  缺陷：verified 初始化空串（文件不存在时 TypeError）与前置拒绝路径
+  不标 status（卡队列，与 2026-08-28 同型）——无测试覆盖模块的静默
+  潜伏实证，已修。
+
+基线对照（报告第五节）：旧 5 红（branches/en_pipeline/identity_attribution/
+p32_backfill/semantic_canonical）与新 5 红（V21-3 同源）**全部清零**
+（批次 34/35 实测：37 套 + en_pipeline 48 + semantic_canonical 33 全绿）。

package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md

@@ -326,18 +326,34 @@
 {
   "iter_id": "…",
   "verifier_instance": "verifier",
-  "verifier_fingerprint": "<验证者二进制指纹>",
+  "verifier_fingerprint": "<验证者二进制指纹（12-64 位十六进制）>",
   "subject_instance": "main",
-  "subject_fingerprint": "<候选二进制指纹>",
+  "subject_fingerprint": "<候选二进制指纹（自报值，形状受检，见下）>",
   "suite_origin": "<测试套件来源——必须是验证者自己的 worktree>",
   "frozen_at": "<本轮冻结时刻>",
   "verdict": "pass | fail",
   "passed": 0,
   "failed": 0,
-  "details": []
+  "details": [],
+  "valid": false,
+  "assertions_ok": false,
+  "failure_reason": "suite_failed | assertions_failed | both | null"
 }
 ```
 
+**字段语义（issue #37 定稿，2026-09-24）**：
+
+| 字段 | 语义 |
+|---|---|
+| `valid` | **单一放行位** = 断言 AND 套件皆过（与 `verdict=="pass"` 同义）。旧语义「仅三断言」已废——实测中「套件全挂（编译失败）而 valid=true」的形态极易被误读为放行 |
+| `assertions_ok` | 断言面（A1/A2/A3 是否成立）——承接旧 `valid` 的语义，供归因 |
+| `failure_reason` | 失败成因枚举（`suite_failed` / `assertions_failed` / `both` / null）——「为什么失败」是结构化事实，不需消费方解析 `details` |
+| `subject_fingerprint` | **self-reported**：由派发方经 `spec.env` 自报、A2 不核验其真伪（A2 为辅助断言——§7.5：A1/A2 起两进程即自动成立；防线在 A3 冻结值）。形状须为 12-64 位十六进制 |
+
+**双门禁（落盘前）**：`sanity_check_verdict`（脱敏黑名单：盘符/UNC/unix 家目录/~/$HOME/密钥形态 ghp_·AIza·AKIA·xox/Bearer/prompt·content 文本形态）+ `shape_check_verdict`（形状白名单：顶层字段集 ⊆ 契约集、指纹形状、枚举、非负整数计数）。
+
+**机械消费方（issue #37 J4 落地）**：`scripts/interop_gate.py`——合并/收尾流程在动 `task/<iter_id>` 分支前调用：exit 0=放行（pass+valid）、1=拒绝（fail）、2=未互验（fail-closed）、3=产物形状非法（拒绝猜测）。§7.4 第 7 步「verdict=pass → 合并」由此获得机械强制。
+
 **留痕位置（已裁定）**：**入库并同步 GitHub 仓库**——互验产物是本机制的**标准功能产物**，
 随仓版本控制、随 `push` 上 GitHub，公开可复核。
 

package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md

@@ -41,42 +41,42 @@ MCP stdio：md_cg/mcp_server.py
 
 | 功能 | 显式调用 | 代码位置（点击直达源码行） |
 |---|---|---|
-| 按需披露（投影后完整工具 / 参数文档即时取回） | `cg(op=help)` | [`help`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1934) → [`_help_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1853) |
-| 验证态 / 双时间轴 / 履历（含冷路径队列；只读） | `cg(op=status)` | [`status`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1940) → [`_status_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1768) |
-| 三元组反查（派生边任意端 / 谓词 / 时间反查；只读） | `cg(op=edges)` | [`edges`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1943) → [`_edges_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1824) |
-| 理论检索（领域理论 / 方法论文） | `cg(op=theory)` | [`theory`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1946) → [`theory`](../../md_cg/theory.py) |
-| 记忆互链（节点间链接管理） | `cg(op=link)` | [`link`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1963) → [`evidence`](../../md_cg/evidence.py) → [`links`](../../md_cg/links.py) → [`provenance`](../../md_cg/provenance.py) → [`signer`](../../md_cg/signer.py) |
-| 服务信息 / 健康 | `cg(op=info)` | [`info`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2072) → [`audit`](../../md_cg/audit.py) → [`links`](../../md_cg/links.py) → [`nodefile`](../../md_cg/nodefile.py) → [`theory`](../../md_cg/theory.py) |
-| 路由：意图→知识+建议能力 | `cg(op=route)` | [`route`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2089) |
-| 读取（按 id / 召回 / 预算） | `cg(op=read)` | [`read`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2110) → [`refindex`](../../md_cg/refindex.py) |
-| 写入（含冲突检测 / 闸门 / 审核） | `cg(op=write)` | [`write`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2144) → [`writepipe`](../../md_cg/writepipe.py) |
-| 目标（写入 / 状态 / 清单） | `cg(op=goal)` | [`goal`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2152) |
-| 任务实体（登记 / 计划 / 状态 / 结果；done 无结果拒收） | `cg(op=task)` | [`task`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2171) → [`_task_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1866) |
-| 最近记忆（事件窗口） | `cg(op=recent)` | [`recent`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2174) |
-| 外部裁决回填（节点证据验证） | `cg(op=verify)` | [`verify`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2186) |
-| 审核队列（DEFER / 提案裁决） | `cg(op=review)` | [`review`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2190) |
-| 主动遗忘 / 恢复 | `cg(op=forget)` | [`forget`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2210) |
-| 保护（不可遗忘） | `cg(op=protect)` | [`protect`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2216) → [`_protect_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1109) |
-| 身份维度 | `cg(op=identity)` | [`identity`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2219) → [`_identity_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1137) |
-| 一致性检测 | `cg(op=consistency)` | [`consistency`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2222) → [`_consistency_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1188) |
-| 元认知（盲区聚合） | `cg(op=metacognition)` | [`metacognition`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2225) → [`_metacognition_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1217) |
-| 自我状态 | `cg(op=self_state)` | [`self_state`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2228) → [`_self_state_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1252) |
-| 演化（记忆结构演化） | `cg(op=evolution)` | [`evolution`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2231) → [`_evolution_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1387) |
-| 飞轮 / 自愈 | `cg(op=sustain)` | [`sustain`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2234) → [`_sustain_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1479) |
-| 洗脑 / 去污染 | `cg(op=scrub)` | [`scrub`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2237) → [`_scrub_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1588) |
-| 预测 / 因果门 | `cg(op=predict)` | [`predict`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2240) → [`_predict_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1314) |
-| 因果链 | `cg(op=causal)` | [`causal`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2243) → [`_causal_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1348) |
-| 白箱能力库（AEIS 能力显式调用） | `cg(op=whitebox)` | [`whitebox`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2246) → [`_whitebox_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2860) |
-| 代码索引 | `cg(op=index_code)` | [`index_code`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2249) → [`refindex`](../../md_cg/refindex.py) |
-| 文档索引 | `cg(op=index_doc)` | [`index_doc`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2281) → [`refindex`](../../md_cg/refindex.py) |
-| 引用 / 反向引用 | `cg(op=ref)` | [`ref`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2317) → [`_ref_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2791) |
-| 会话管理（多会话归属与过滤） | `cg(op=session)` | [`session`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2320) → [`_session_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2521) |
-| 导入落图 | `cg(op=ingest)` | [`ingest`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2323) → [`_ingest_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2598) |
-| 导出 | `cg(op=export)` | [`export`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2326) → [`_export_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2619) |
-| 维护 | `cg(op=maintain)` | [`maintain`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2329) → [`_maintain_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2638) |
-| 记忆固化 / 整理 | `cg(op=consolidate)` | [`consolidate`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2332) → [`_consolidate_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2716) |
-| 洞察 / 自主探索（信息差驱动） | `cg(op=insight)` | [`insight`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2335) → [`_insight_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2741) |
-| CCG 六要素编译（对话→候选→编外复核→落库） | `cg(op=ccg)` | [`ccg`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2338) → [`_ccg_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2345) |
+| 按需披露（投影后完整工具 / 参数文档即时取回） | `cg(op=help)` | [`help`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1955) → [`_help_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1874) |
+| 验证态 / 双时间轴 / 履历（含冷路径队列；只读） | `cg(op=status)` | [`status`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1961) → [`_status_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1789) |
+| 三元组反查（派生边任意端 / 谓词 / 时间反查；只读） | `cg(op=edges)` | [`edges`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1964) → [`_edges_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1845) |
+| 理论检索（领域理论 / 方法论文） | `cg(op=theory)` | [`theory`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1967) → [`theory`](../../md_cg/theory.py) |
+| 记忆互链（节点间链接管理） | `cg(op=link)` | [`link`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1984) → [`evidence`](../../md_cg/evidence.py) → [`links`](../../md_cg/links.py) → [`provenance`](../../md_cg/provenance.py) → [`security`](../../md_cg/security.py) → [`signer`](../../md_cg/signer.py) |
+| 服务信息 / 健康 | `cg(op=info)` | [`info`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2100) → [`audit`](../../md_cg/audit.py) → [`links`](../../md_cg/links.py) → [`nodefile`](../../md_cg/nodefile.py) → [`theory`](../../md_cg/theory.py) |
+| 路由：意图→知识+建议能力 | `cg(op=route)` | [`route`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2117) |
+| 读取（按 id / 召回 / 预算） | `cg(op=read)` | [`read`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2138) → [`refindex`](../../md_cg/refindex.py) |
+| 写入（含冲突检测 / 闸门 / 审核） | `cg(op=write)` | [`write`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2174) → [`writepipe`](../../md_cg/writepipe.py) |
+| 目标（写入 / 状态 / 清单） | `cg(op=goal)` | [`goal`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2182) |
+| 任务实体（登记 / 计划 / 状态 / 结果；done 无结果拒收） | `cg(op=task)` | [`task`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2201) → [`_task_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1887) |
+| 最近记忆（事件窗口） | `cg(op=recent)` | [`recent`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2204) |
+| 外部裁决回填（节点证据验证） | `cg(op=verify)` | [`verify`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2216) |
+| 审核队列（DEFER / 提案裁决） | `cg(op=review)` | [`review`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2221) |
+| 主动遗忘 / 恢复 | `cg(op=forget)` | [`forget`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2242) |
+| 保护（不可遗忘） | `cg(op=protect)` | [`protect`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2248) → [`_protect_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1130) |
+| 身份维度 | `cg(op=identity)` | [`identity`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2251) → [`_identity_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1158) |
+| 一致性检测 | `cg(op=consistency)` | [`consistency`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2254) → [`_consistency_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1209) |
+| 元认知（盲区聚合） | `cg(op=metacognition)` | [`metacognition`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2257) → [`_metacognition_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1238) |
+| 自我状态 | `cg(op=self_state)` | [`self_state`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2260) → [`_self_state_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1273) |
+| 演化（记忆结构演化） | `cg(op=evolution)` | [`evolution`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2263) → [`_evolution_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1408) |
+| 飞轮 / 自愈 | `cg(op=sustain)` | [`sustain`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2266) → [`_sustain_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1500) |
+| 洗脑 / 去污染 | `cg(op=scrub)` | [`scrub`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2269) → [`_scrub_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1609) |
+| 预测 / 因果门 | `cg(op=predict)` | [`predict`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2272) → [`_predict_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1335) |
+| 因果链 | `cg(op=causal)` | [`causal`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2275) → [`_causal_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L1369) |
+| 白箱能力库（AEIS 能力显式调用） | `cg(op=whitebox)` | [`whitebox`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2278) → [`_whitebox_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2921) |
+| 代码索引 | `cg(op=index_code)` | [`index_code`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2281) → [`refindex`](../../md_cg/refindex.py) → [`security`](../../md_cg/security.py) |
+| 文档索引 | `cg(op=index_doc)` | [`index_doc`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2318) → [`refindex`](../../md_cg/refindex.py) → [`security`](../../md_cg/security.py) |
+| 引用 / 反向引用 | `cg(op=ref)` | [`ref`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2358) → [`_ref_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2841) |
+| 会话管理（多会话归属与过滤） | `cg(op=session)` | [`session`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2361) → [`_session_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2562) |
+| 导入落图 | `cg(op=ingest)` | [`ingest`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2364) → [`_ingest_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2641) |
+| 导出 | `cg(op=export)` | [`export`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2367) → [`_export_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2666) |
+| 维护 | `cg(op=maintain)` | [`maintain`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2370) → [`_maintain_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2688) |
+| 记忆固化 / 整理 | `cg(op=consolidate)` | [`consolidate`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2373) → [`_consolidate_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2766) |
+| 洞察 / 自主探索（信息差驱动） | `cg(op=insight)` | [`insight`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2376) → [`_insight_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2791) |
+| CCG 六要素编译（对话→候选→编外复核→落库） | `cg(op=ccg)` | [`ccg`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2379) → [`_ccg_call`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2386) |
 
 <!-- FUNCMAP:END -->
 
@@ -95,10 +95,10 @@ MCP stdio：md_cg/mcp_server.py
 
 | 功能 | 显式调用 | 代码位置（点击直达源码行） |
 |---|---|---|
-| 两节点关系 | `stg(op=relation)` | [`relation`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2883) |
-| 时间线 | `stg(op=timeline)` | [`timeline`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2885) |
-| 锚点检索（时空窗口） | `stg(op=anchors)` | [`anchors`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2892) |
-| 时空一致性 | `stg(op=consistency)` | [`consistency`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2896) |
+| 两节点关系 | `stg(op=relation)` | [`relation`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2944) |
+| 时间线 | `stg(op=timeline)` | [`timeline`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2946) |
+| 锚点检索（时空窗口） | `stg(op=anchors)` | [`anchors`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2953) |
+| 时空一致性 | `stg(op=consistency)` | [`consistency`](https://github.com/FuRongJun-1999/dsh-memory/blob/main/md_cg/mcp_server.py#L2957) |
 
 <!-- FUNCMAP:END -->