@furongjun1999/dsh-memory 0.4.6 → 0.4.8

package/docs/{ → mdcg/}/347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md

@@ -1,181 +1,181 @@
-# 灵枢三层拆分规划 v0.1
-
-> 状态：规划稿（未执行任何文件搬迁）
-> 日期：2026-09-10
-> 范围：理论（灵）/ 大脑（brain）/ 身体（body）三仓职责分离与主仓库瘦身
-> 性质：**本文只定义职责与顺序，不构成搬迁授权**；所有搬迁动作须先通过 Phase 0 裁决。
-
----
-
-## 0. 背景与结论
-
-### 0.1 现状问题
-
-| 问题 | 表现 |
-|---|---|
-| 主仓库职责混杂 | `dsh-memory` 同时承载「记忆大脑」与「工程/身体运行时」（`docker/`、`scripts/` 看门狗、宿主启动脚本），二者依赖量级完全不同 |
-| 同名不同物 | 历史命名中「AEIS」既指理论方（CTP）自带的工程副本，又指 `dsh-memory` 的 Python 大脑包，导致「aeis = 大脑」的旧语义债 |
-| 跨库同步困难 | 同一份工程内容在多库各存一份，改动需人工同步，真源不清 |
-| 断链 | `AEIS/tools/*` 指向 `dsh-memory\llm-adapter-poc`，该路径当前不存在（待 Phase 0 核实） |
-| 交付面过宽 | 完整灵枢 = 理论 + 大脑 + 身体，体量巨大；理论难懂、身体重依赖，二者都阻碍了「大多数人只需大脑」这一主路径 |
-
-### 0.2 结论（本次收敛）
-
-**主仓库不再放工程内容的完整实现，只放「大脑」。**
-
-- 完整灵枢 = **灵** + **脑** + **身**；但对外**默认只交付大脑**。
-- 理论（灵）与身体（身）作为大脑的**可选下层 / 上层**，通过 README 分层入口引导，而非塞进主仓库。
-- 分离的直接收益：消除跨库重复实现，真源唯一，降低同步成本。
-- 面向人群：理论 → 研究者；身体 → 少数需具身者；**大脑 → 大多数人（默认入口）**。
-
----
-
-## 1. 三层定位
-
-| 仓 | 角色 | 内容边界 | 默认读者 | 依赖量级 |
-|---|---|---|---|---|
-| CTP / CommonTrustProtocol | **理论（灵）** | 协议、认识论、信任账本；**不含工程实现**（待剥离自带 `aeis/` 工程副本） | 研究者 | 无（纯文档/协议） |
-| **dsh-memory（主仓库）** | **大脑** | `md_cg` 认知图内核 + MCP/npm 接口 + 记忆数据；**纯逻辑、零重依赖** | **大多数人（默认入口）** | 轻（标准库 + 轻量 npm） |
-| AEIS / body | **身体** | 传感器、语音、执行器、docker 运行环境、模型权重、宿主看门狗 | 少数需具身者 | 重（设备/模型/容器） |
-
-**一句话各自定位**
-
-- 灵：定义「什么样的智能值得被信任」——协议与公理，不落代码。
-- 脑：定义「记住什么、如何召回、如何自演化」——可在任意宿主上单独运行。
-- 身：定义「如何感知与作用于世界」——可选，且可替换。
-
----
-
-## 2. 主仓库（大脑）取舍清单
-
-### 2.1 保留（= 大脑本体）
-
-| 路径 | 内容 | 理由 |
-|---|---|---|
-| `md_cg/` | 认知图内核（98 py：consolidate / refine / pooling / provenance / whitebox / MCP server…） | 大脑核心，纯 Python |
-| `src/` | MCP / npm 插件接口（8 ts） | 大脑对外唯一入口 |
-| `test/` | 集成测试 | 大脑正确性保障 |
-| `data/` | 记忆数据（**归位须待 Phase 3**） | 大脑资产，非工程副产物 |
-| `package.json` / `tsconfig.json` | 构建定义 | 轻依赖 |
-| `README.md` / `docs/` | 分层入口文档 | 需重写为三层入口（Phase 4） |
-
-### 2.2 移出或降级（= 身体 / 工程）
-
-| 路径 | 处置 | 去向 |
-|---|---|---|
-| `docker/` | 移出 | 身体仓（运行环境） |
-| `dsh-web-start.bat` | 移出 | 身体仓（宿主启动） |
-| `scripts/`（看门狗 ps1 / vbs） | 移出 | 身体仓（宿主守护） |
-| 语音 / 模型权重 / 设备相关资源 | 移出 | 身体仓 |
-
-### 2.3 断链修复（Phase 2 处理）
-
-- `AEIS/tools/*` → `dsh-memory\llm-adapter-poc`（当前缺失）。
-- 二选一：**补齐**该路径，或**声明废弃**并从文档/代码中移除引用。
-- 原则：不允许存在「文档指向不存在路径」的悬空引用。
-
----
-
-## 3. 分期任务规划
-
-> 顺序不可交换：**先裁决 → 再冻接口 → 再搬代码 → 最后动数据**。
-> 每一期均有独立验收，未通过不得进入下一期。
-
-### Phase 0 — 裁决（不搬任何文件）
-
-| # | 任务 | 产出 |
-|---|---|---|
-| 0.1 | `diff -rq` 定 `aeis` 唯一真源（CTP 侧 vs 独立仓侧） | 真源结论 + diff 快照存档 |
-| 0.2 | 一句话写死「身体」操作定义：设备端口 / 世界载体 / 宿主客户端（三择一） | 定义条目（可导出为边界表） |
-| 0.3 | 将 `data/mdcg` 声明为大脑资产，并**冻结写入** | 冻结记录 + 恢复步骤 |
-
-**验收**：真源唯一；身体定义可一句话导出；`data/mdcg` 冻结生效且可恢复。
-
-### Phase 1 — 接口先行（仍不搬文件）
-
-| # | 任务 | 产出 |
-|---|---|---|
-| 1.1 | 冻结 brain↔body 契约：只暴露**能力名**，不暴露执行细节 | 契约表（能力名 + 入参/出参语义） |
-| 1.2 | 跑通两条链路各一次：身体取知识（`cg(op=whitebox)`）、大脑写记忆（`mdcg_remember`） | 双向链路验证记录 |
-
-**验收**：契约冻结且带版本号；两条链路各绿一次。
-
-### Phase 2 — 代码剥离
-
-| # | 任务 | 产出 |
-|---|---|---|
-| 2.1 | 主仓库移除重依赖目录（见 §2.2） | 瘦身后的主仓库 |
-| 2.2 | CTP 侧剥离自带 `aeis/` 工程副本（或反向声明 CTP 为发布源） | 剥离/声明记录 |
-| 2.3 | 修复 `AEIS/tools/*` 断链 | 补齐或废弃说明 |
-
-**验收**：主仓库在干净环境 `pip install` / `npm install` 后**无重依赖**即可运行大脑。
-
-> **详规**：理论仓具体拆分清单、主仓切 `md_cg` 的逐行改动点、白箱知识库内迁的依赖阻断与搬迁映射，见 [docs/理论仓拆分与白箱知识库内迁_v0.1.md](理论仓拆分与白箱知识库内迁_v0.1.md)。
-
-### Phase 3 — 数据迁移（最后做 · 不可逆）
-
-| # | 任务 | 产出 |
-|---|---|---|
-| 3.1 | **先演练回退**：`mdcg.enabled: false` + 数据不迁移，确认旧通道可用 | 回退演练记录 |
-| 3.2 | 再迁 `data/mdcg` | 迁移报告（幂等 + 备份） |
-
-**验收**：迁移后节点数与原库一致（当前基准 **6340** 节点）；数量不符即说明密级 / root / actor 未对齐，须回退重来。
-
-### Phase 4 — 命名与文档统一
-
-| # | 任务 | 产出 |
-|---|---|---|
-| 4.1 | 全库统一「灵 / 大脑 / 身体」表述 | 术语表 |
-| 4.2 | 同步 README 与 `docs/`，清掉「aeis = 大脑」旧语义债 | 修订后的分层入口文档 |
-
-**验收**：README 三层入口清晰，无「aeis = 大脑」歧义表述；命名与职责一致。
-
----
-
-## 4. 贯穿全程的三条铁律
-
-1. **先定职责、再定归属**——库名是历史沉积，不是功能声明。不得因为「名字里有 aeis」就归给理论方。
-2. **接口冻结早于代码搬迁**——否则拆的是目录，不是耦合；耦合仍在，只是换了个地方报错。
-3. **数据最后动且可回退**——`data/mdcg` 挪错是**静默失效**（写入只打 warn），6340 节点无法从代码重建。
-
----
-
-## 5. 风险与回退
-
-| 风险 | 触发条件 | 回退动作 |
-|---|---|---|
-| 记忆真源错位 | `mdcg.root` 落到错误目录，写入静默告警 | 恢复 `data/mdcg` 原位 + `mdcg.enabled: false` |
-| 写入冻结期间数据丢失 | Phase 0 冻结但未建备份 | 冻结前先做全量备份（必须前置） |
-| 契约冻结不彻底 | 身体侧仍直接读大脑文件 | 强制走契约能力名，禁止跨层直连 |
-| 真源判断错误 | Phase 0 diff 结论有误 | 保留 diff 快照，可重判并回滚剥离 |
-
-**迁移不可逆点**：Phase 3.2。进入前必须完成 Phase 3.1 回退演练。
-
----
-
-## 6. 明确不做（边界声明）
-
-- 本文**不授权**任何文件实际搬迁 / 删除。
-- 本文**不改变**任何运行时配置、不修改 `cordis.patch.yml`、不动 `data/mdcg` 内容。
-- 本文**不替代** Phase 0 的裁决结论——若裁决结果与本规划假设冲突，以裁决为准并回改本文。
-
----
-
-## 7. 下一步（三个裁决性动作）
-
-1. `diff -rq` 定 `aeis` 真源；
-2. 一句话写死「身体」定义；
-3. 冻结 `data/mdcg` 写入（含前置备份）。
-
-> 这三件做完，搬迁清单会自动收敛；在此之前动手，等于在大脑里留一个没有海马体的身体。
-
----
-
-## 附：术语对照
-
-| 本文用语 | 对应现状命名 | 说明 |
-|---|---|---|
-| 灵 / 理论 | 智能论 v3.4、CTP、CommonTrustProtocol | 协议与认识论 |
-| 大脑 / brain | `md_cg`、`dsh-memory`、`@furongjun1999/dsh-memory` | 认知图 + MCP 接口 + 记忆数据 |
-| 身体 / body | AEIS（独立仓）、`docker/`、`scripts/`、`src` 之外的宿主层 | 传感器 / 执行器 / 宿主运行时 |
-| 真源 | single source of truth | 同一内容只允许一处为准 |
+# 灵枢三层拆分规划 v0.1
+
+> 状态：规划稿（未执行任何文件搬迁）
+> 日期：2026-09-10
+> 范围：理论（灵）/ 大脑（brain）/ 身体（body）三仓职责分离与主仓库瘦身
+> 性质：**本文只定义职责与顺序，不构成搬迁授权**；所有搬迁动作须先通过 Phase 0 裁决。
+
+---
+
+## 0. 背景与结论
+
+### 0.1 现状问题
+
+| 问题 | 表现 |
+|---|---|
+| 主仓库职责混杂 | `dsh-memory` 同时承载「记忆大脑」与「工程/身体运行时」（`docker/`、`scripts/` 看门狗、宿主启动脚本），二者依赖量级完全不同 |
+| 同名不同物 | 历史命名中「AEIS」既指理论方（CTP）自带的工程副本，又指 `dsh-memory` 的 Python 大脑包，导致「aeis = 大脑」的旧语义债 |
+| 跨库同步困难 | 同一份工程内容在多库各存一份，改动需人工同步，真源不清 |
+| 断链 | `AEIS/tools/*` 指向 `dsh-memory\llm-adapter-poc`，该路径当前不存在（待 Phase 0 核实） |
+| 交付面过宽 | 完整灵枢 = 理论 + 大脑 + 身体，体量巨大；理论难懂、身体重依赖，二者都阻碍了「大多数人只需大脑」这一主路径 |
+
+### 0.2 结论（本次收敛）
+
+**主仓库不再放工程内容的完整实现，只放「大脑」。**
+
+- 完整灵枢 = **灵** + **脑** + **身**；但对外**默认只交付大脑**。
+- 理论（灵）与身体（身）作为大脑的**可选下层 / 上层**，通过 README 分层入口引导，而非塞进主仓库。
+- 分离的直接收益：消除跨库重复实现，真源唯一，降低同步成本。
+- 面向人群：理论 → 研究者；身体 → 少数需具身者；**大脑 → 大多数人（默认入口）**。
+
+---
+
+## 1. 三层定位
+
+| 仓 | 角色 | 内容边界 | 默认读者 | 依赖量级 |
+|---|---|---|---|---|
+| CTP / CommonTrustProtocol | **理论（灵）** | 协议、认识论、信任账本；**不含工程实现**（待剥离自带 `aeis/` 工程副本） | 研究者 | 无（纯文档/协议） |
+| **dsh-memory（主仓库）** | **大脑** | `md_cg` 认知图内核 + MCP/npm 接口 + 记忆数据；**纯逻辑、零重依赖** | **大多数人（默认入口）** | 轻（标准库 + 轻量 npm） |
+| AEIS / body | **身体** | 传感器、语音、执行器、docker 运行环境、模型权重、宿主看门狗 | 少数需具身者 | 重（设备/模型/容器） |
+
+**一句话各自定位**
+
+- 灵：定义「什么样的智能值得被信任」——协议与公理，不落代码。
+- 脑：定义「记住什么、如何召回、如何自演化」——可在任意宿主上单独运行。
+- 身：定义「如何感知与作用于世界」——可选，且可替换。
+
+---
+
+## 2. 主仓库（大脑）取舍清单
+
+### 2.1 保留（= 大脑本体）
+
+| 路径 | 内容 | 理由 |
+|---|---|---|
+| `md_cg/` | 认知图内核（98 py：consolidate / refine / pooling / provenance / whitebox / MCP server…） | 大脑核心，纯 Python |
+| `src/` | MCP / npm 插件接口（8 ts） | 大脑对外唯一入口 |
+| `test/` | 集成测试 | 大脑正确性保障 |
+| `data/` | 记忆数据（**归位须待 Phase 3**） | 大脑资产，非工程副产物 |
+| `package.json` / `tsconfig.json` | 构建定义 | 轻依赖 |
+| `README.md` / `docs/` | 分层入口文档 | 需重写为三层入口（Phase 4） |
+
+### 2.2 移出或降级（= 身体 / 工程）
+
+| 路径 | 处置 | 去向 |
+|---|---|---|
+| `docker/` | 移出 | 身体仓（运行环境） |
+| `dsh-web-start.bat` | 移出 | 身体仓（宿主启动） |
+| `scripts/`（看门狗 ps1 / vbs） | 移出 | 身体仓（宿主守护） |
+| 语音 / 模型权重 / 设备相关资源 | 移出 | 身体仓 |
+
+### 2.3 断链修复（Phase 2 处理）
+
+- `AEIS/tools/*` → `dsh-memory\llm-adapter-poc`（当前缺失）。
+- 二选一：**补齐**该路径，或**声明废弃**并从文档/代码中移除引用。
+- 原则：不允许存在「文档指向不存在路径」的悬空引用。
+
+---
+
+## 3. 分期任务规划
+
+> 顺序不可交换：**先裁决 → 再冻接口 → 再搬代码 → 最后动数据**。
+> 每一期均有独立验收，未通过不得进入下一期。
+
+### Phase 0 — 裁决（不搬任何文件）
+
+| # | 任务 | 产出 |
+|---|---|---|
+| 0.1 | `diff -rq` 定 `aeis` 唯一真源（CTP 侧 vs 独立仓侧） | 真源结论 + diff 快照存档 |
+| 0.2 | 一句话写死「身体」操作定义：设备端口 / 世界载体 / 宿主客户端（三择一） | 定义条目（可导出为边界表） |
+| 0.3 | 将 `data/mdcg` 声明为大脑资产，并**冻结写入** | 冻结记录 + 恢复步骤 |
+
+**验收**：真源唯一；身体定义可一句话导出；`data/mdcg` 冻结生效且可恢复。
+
+### Phase 1 — 接口先行（仍不搬文件）
+
+| # | 任务 | 产出 |
+|---|---|---|
+| 1.1 | 冻结 brain↔body 契约：只暴露**能力名**，不暴露执行细节 | 契约表（能力名 + 入参/出参语义） |
+| 1.2 | 跑通两条链路各一次：身体取知识（`cg(op=whitebox)`）、大脑写记忆（`mdcg_remember`） | 双向链路验证记录 |
+
+**验收**：契约冻结且带版本号；两条链路各绿一次。
+
+### Phase 2 — 代码剥离
+
+| # | 任务 | 产出 |
+|---|---|---|
+| 2.1 | 主仓库移除重依赖目录（见 §2.2） | 瘦身后的主仓库 |
+| 2.2 | CTP 侧剥离自带 `aeis/` 工程副本（或反向声明 CTP 为发布源） | 剥离/声明记录 |
+| 2.3 | 修复 `AEIS/tools/*` 断链 | 补齐或废弃说明 |
+
+**验收**：主仓库在干净环境 `pip install` / `npm install` 后**无重依赖**即可运行大脑。
+
+> **详规**：理论仓具体拆分清单、主仓切 `md_cg` 的逐行改动点、白箱知识库内迁的依赖阻断与搬迁映射，见 [docs/theory/理论仓拆分与白箱知识库内迁_v0.1.md](../theory/理论仓拆分与白箱知识库内迁_v0.1.md)。
+
+### Phase 3 — 数据迁移（最后做 · 不可逆）
+
+| # | 任务 | 产出 |
+|---|---|---|
+| 3.1 | **先演练回退**：`mdcg.enabled: false` + 数据不迁移，确认旧通道可用 | 回退演练记录 |
+| 3.2 | 再迁 `data/mdcg` | 迁移报告（幂等 + 备份） |
+
+**验收**：迁移后节点数与原库一致（当前基准 **6340** 节点）；数量不符即说明密级 / root / actor 未对齐，须回退重来。
+
+### Phase 4 — 命名与文档统一
+
+| # | 任务 | 产出 |
+|---|---|---|
+| 4.1 | 全库统一「灵 / 大脑 / 身体」表述 | 术语表 |
+| 4.2 | 同步 README 与 `docs/`，清掉「aeis = 大脑」旧语义债 | 修订后的分层入口文档 |
+
+**验收**：README 三层入口清晰，无「aeis = 大脑」歧义表述；命名与职责一致。
+
+---
+
+## 4. 贯穿全程的三条铁律
+
+1. **先定职责、再定归属**——库名是历史沉积，不是功能声明。不得因为「名字里有 aeis」就归给理论方。
+2. **接口冻结早于代码搬迁**——否则拆的是目录，不是耦合；耦合仍在，只是换了个地方报错。
+3. **数据最后动且可回退**——`data/mdcg` 挪错是**静默失效**（写入只打 warn），6340 节点无法从代码重建。
+
+---
+
+## 5. 风险与回退
+
+| 风险 | 触发条件 | 回退动作 |
+|---|---|---|
+| 记忆真源错位 | `mdcg.root` 落到错误目录，写入静默告警 | 恢复 `data/mdcg` 原位 + `mdcg.enabled: false` |
+| 写入冻结期间数据丢失 | Phase 0 冻结但未建备份 | 冻结前先做全量备份（必须前置） |
+| 契约冻结不彻底 | 身体侧仍直接读大脑文件 | 强制走契约能力名，禁止跨层直连 |
+| 真源判断错误 | Phase 0 diff 结论有误 | 保留 diff 快照，可重判并回滚剥离 |
+
+**迁移不可逆点**：Phase 3.2。进入前必须完成 Phase 3.1 回退演练。
+
+---
+
+## 6. 明确不做（边界声明）
+
+- 本文**不授权**任何文件实际搬迁 / 删除。
+- 本文**不改变**任何运行时配置、不修改 `cordis.patch.yml`、不动 `data/mdcg` 内容。
+- 本文**不替代** Phase 0 的裁决结论——若裁决结果与本规划假设冲突，以裁决为准并回改本文。
+
+---
+
+## 7. 下一步（三个裁决性动作）
+
+1. `diff -rq` 定 `aeis` 真源；
+2. 一句话写死「身体」定义；
+3. 冻结 `data/mdcg` 写入（含前置备份）。
+
+> 这三件做完，搬迁清单会自动收敛；在此之前动手，等于在大脑里留一个没有海马体的身体。
+
+---
+
+## 附：术语对照
+
+| 本文用语 | 对应现状命名 | 说明 |
+|---|---|---|
+| 灵 / 理论 | 智能论 v3.4、CTP、CommonTrustProtocol | 协议与认识论 |
+| 大脑 / brain | `md_cg`、`dsh-memory`、`@furongjun1999/dsh-memory` | 认知图 + MCP 接口 + 记忆数据 |
+| 身体 / body | AEIS（独立仓）、`docker/`、`scripts/`、`src` 之外的宿主层 | 传感器 / 执行器 / 宿主运行时 |
+| 真源 | single source of truth | 同一内容只允许一处为准 |

package/docs/{ → mdcg/}/347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md

@@ -1,6 +1,6 @@
 # 认知图 · P0 收口 证据单（G2 索引接线 + G3 能力标签）v0.1
 
-> 来源：`docs/认知图_索引与工程规范化_计划_v0.1.md` 的 R4/R5 前置项 —— **G2（文档/代码索引接线）** 与
+> 来源：`docs/mdcg/认知图_索引与工程规范化_计划_v0.1.md` 的 R4/R5 前置项 —— **G2（文档/代码索引接线）** 与
 > **G3（能力标签注入）**；G1（生效条件口径接线到各前缀）已于上一批次闭合（`evo-20260910-152148-2b35`）。
 > 目标工程：**dsh-memory / md_cg（认知图 + 记忆 OS）**
 > 证据口径：源码级核对 + **真实库（`AEIS/data/mdcg`）复算** + 前后冻结基线对照（不采信估计值）
@@ -38,7 +38,7 @@
 |---|---|---|
 | **G2** 索引接线（md_cg / src / docs 三大域） | ✅ 执行 | 计划 §六 R4/R5 的前置「先有索引」 |
 | **G3** 能力标签注入（`cap:<op>`） | ✅ 执行 | 计划 §四「索引节点缺能力归属」 |
-| G1 生效条件口径接线到各前缀 | ⏸ 已闭合 | 上一批次，见 `docs/认知图_条件空间合成与生效条件口径_v0.1.md` |
+| G1 生效条件口径接线到各前缀 | ⏸ 已闭合 | 上一批次，见 `docs/mdcg/认知图_条件空间合成与生效条件口径_v0.1.md` |
 | G7 / G8 / G4 / G5 / G6 | ⬜ 不执行 | 登记待定（§八）；G8 已裁定方案留作后续依据 |
 
 **执行通道（必须记录的环境事实）**：常驻 MCP 服务进程启动于当日改造**之前**，其内存模块缺 `CONDITION_SLOTS` / `condition_space_text`
@@ -257,7 +257,7 @@ Top：`cap:whitebox` 59、`cap:predict` 41、`cap:route` 37、`cap:session` 25
 **派生产物**（均在仓库之外）：
 
 ```
-D:/Program Files/2_ai/AEIS/data/mdcg/
+AEIS/data/mdcg/
 ├── _refindex.json     # G2 水位（schema=2、116 源文件、1847 条登记）
 ├── _backfill.jsonl    # G3 批次留痕（+369 条 action=cap / batch=cap_v01）
 ├── _index.json        # 6339 节点（+1813）

package/docs/{ → mdcg/}/350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md

@@ -1,6 +1,6 @@
 # 认知图 · G4–G8 缺口裁定单（条件空间声明 + 四态裁决）v0.1
 
-> 来源：`docs/缺口单_P0收口_v0.1.md` §八「DEFER 登记项」——**G4 层归属错位 / G5 视觉证据未落 / G6 node_ 结构提炼 /
+> 来源：`docs/mdcg/缺口单_P0收口_v0.1.md` §八「DEFER 登记项」——**G4 层归属错位 / G5 视觉证据未落 / G6 node_ 结构提炼 /
 > G7 自主演化无驱动 / G8 溯源链缺失**，外加缺口单 §6.1 的「索引节点应域级分池降权，而非吃 GLOBAL_CAP」。
 > 目标工程：**dsh-memory / md_cg（认知图 + 记忆 OS）**
 > 证据口径：源码级核对（行号可回溯）+ **真实库（`AEIS/data/mdcg`）只读复算** + 前后冻结基线对照（不采信估计值、不转述文档结论）
@@ -38,7 +38,7 @@
 
 ## 一、冻结基线（本轮实测，2026-09-10）
 
-**库根裁定**：真实库为 `D:/Program Files/2_ai/AEIS/data/mdcg`（6340 个 `.md`，6339 有 frontmatter）；
+**库根裁定**：真实库为 `AEIS/data/mdcg`（6340 个 `.md`，6339 有 frontmatter）；
 工作区 `dsh-memory/data/mdcg` 实测仅 **1** 个节点（`python -m md_cg.census` 输出 `总节点: 1`），**非本批对象**，不参与。
 → 这一条必须先声明，否则「库根写错」会让所有后续计数与判定失效。
 
@@ -113,7 +113,7 @@
 
 ## 三、G5 裁定：视觉证据未落 → 守卫式证据回填（ACCEPT，条件=脱敏 + 只读 AEIS）
 
-**证据源（AEIS 侧，全部只读；`D:/Program Files/2_ai/AEIS` 为异仓，不得写入）**
+**证据源（AEIS 侧，全部只读；`AEIS` 为异仓，不得写入）**
 
 | 资产 | 位置 | 用途 |
 |---|---|---|

package/docs/{ → mdcg/}/350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md

@@ -314,12 +314,12 @@ CONDITION_SLOTS = (
 ```bash
 # 只读预演：清洗计划 + 待补台账（不写盘）
 python -X utf8 -c "from md_cg.mdcos import MdCGOS; from md_cg import backfill; \
- cg=MdCGOS(r'D:/Program Files/2_ai/AEIS/data/mdcg'); \
+ cg=MdCGOS(r'AEIS/data/mdcg'); \
  print(backfill.fix_conditions_plan(cg)); print(backfill.conditions_pending(cg)['by_missing'])"
 
 # 复算：弱等价残留 / 合成来源 / 缺失清单
 python -X utf8 -c "from md_cg.mdcos import MdCGOS; from md_cg import backfill; \
- cg=MdCGOS(r'D:/Program Files/2_ai/AEIS/data/mdcg'); print(backfill.verify_conditions(cg))"
+ cg=MdCGOS(r'AEIS/data/mdcg'); print(backfill.verify_conditions(cg))"
 
 # 回滚（按批次，当前值一致才撤销）
 #   fix_conditions_rollback(batch="cond_fix_v01") / rollback(batch="cond_full_v01")

package/docs/{ → mdcg/}/350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md

@@ -101,7 +101,7 @@ judge_qualification(mdcg.py:709-714)
              "lineno":383,"end":462,"lang":"py","hash":"9f2c1ab3de44"}
 
 // 文档节点
-"doc_ref":  {"path":"docs/认知图_MD目录方案_v0.1.md","heading":"9. 分阶段实施（稳健）",
+"doc_ref":  {"path":"docs/mdcg/认知图_MD目录方案_v0.1.md","heading":"9. 分阶段实施（稳健）",
              "heading_path":["9. 分阶段实施（稳健）"],"level":2,
              "lineno":491,"end":513,"anchor":"9-分阶段实施稳健","hash":"41ab77c0e1d9"}
 ```
@@ -144,10 +144,10 @@ judge_qualification(mdcg.py:709-714)
 
 | 文件 | 动作 | 职责 |
 |---|---|---|
-| `md_cg/refindex.py` | **新增** | ref 协议常量 + 提取器注册表 + 统一 `index_dir` 调度 + `_refindex.json` 增量 + `check_refs()` 漂移巡检 + `read_ref()` 回读 |
-| `md_cg/docindex.py` | **新增** | `.md` 章节切块：ATX 标题栈、heading_path、行号区间、首段摘要、anchor |
-| `md_cg/codeindex.py` | **改造** | ①`render()` 改产 CCG 5 要素（修 B）②后缀注册化（`.py` 走 AST、`.ts/.js` 走弱提取器）③`index_dir` 返回 `truncated` 与 `files_scanned`（修 F）④`node_id` 保持稳定（重复索引幂等） |
-| `md_cg/mcp_server.py` | **扩** | 新增 `op=ref`（`action=read\|check\|stat`，兼回读与巡检）；`op=index_code` 保留为别名并透传 `truncated`；`op=index_doc`；op 枚举与 `:542-546` 同步 |
+| `md_cg/refindex.py` | **新增** | ref 协议常量 + 提取器注册表 + 统一 `index_dir` 调度 + `_refindex.json` 增量 + `check_refs()` 漂移巡检 + `read_ref()` 回读 + **节点级对账** `prune_orphans()`（过期代）/ `prune_dangling()`（悬空）（R3.1）+ `skip_dirs` 透传（R3.2） |
+| `md_cg/docindex.py` | **新增** | `.md` 章节切块：ATX 标题栈、heading_path、行号区间、首段摘要、anchor；`skip_dirs` 追加排除（R3.2，复用 `codeindex.skip_matcher`） |
+| `md_cg/codeindex.py` | **改造** | ①`render()` 改产 CCG 5 要素（修 B）②后缀注册化（`.py` 走 AST、`.ts/.js` 走弱提取器）③`index_dir` 返回 `truncated` 与 `files_scanned`（修 F）④`node_id` 保持稳定（重复索引幂等）⑤`skip_matcher()` + `skip_dirs`（R3.2，两条链路的唯一实现） |
+| `md_cg/mcp_server.py` | **扩** | 新增 `op=ref`（`action=read\|check\|stat\|prune`，兼回读 / 巡检 / 清退）；`op=index_code` 保留为别名并透传 `truncated`；`op=index_doc`；op 枚举与 `:542-546` 同步；`index_code`/`index_doc` 索引后自动节点级对账（`prune` 默认开、`prune_dry_run` 可预演，R3.1）；`skip_dirs` 透传 + `skipped_dirs` 回报（R3.2） |
 | `md_cg/tokens.py` | **改** | `ALL_OPS`(`:56-59`) 加 `ref` / `index_doc`（漏改会被权限层直接拒），`test_p21_tokens.py` 同步 |
 | `md_cg/sustain.py` | **扩** | `diagnose` 增巡检项 `ref_stale` / `ref_dangling`，`heal` 动作为「重建索引」（派生物，符合现有自愈边界 `:12-14`） |
 | `md_cg/mdcos.py` | **扩** | 检索结果带 `ref` 与 `ref_kind`（读侧不改召回逻辑，只加字段） |
@@ -161,8 +161,10 @@ judge_qualification(mdcg.py:709-714)
 |---|---|---|---|
 | **R0** | ✅ **已完成**（§十一 取证纪录）：全量 28 用例基线取证 + 修 4 条缺陷（`corpus.reset_root` 全量 rmtree / 3 处编码） | 28/28 全绿；P0 25/25、P1 38/38、P11 27/27、P12 32/32 | ✅ |
 | **R1** | ✅ **已完成**（§十二 取证纪录）：`codeindex.render` 改产 CCG 6 行、`EXTRACTORS` 后缀注册化（AST 精确 / TS-JS 弱提取）、`op=ref` 回读 + 漂移检测、`truncated`/`skipped_suffixes` 显式上报；实测 §1.3-1（role 档位） | ✅ 代码节点判定 **ACCEPT**（不再 BLINDSPOT）；`op=ref` 回读文本与源区间**逐字一致**、`hash_match` 检出漂移 | ✅ |
-| **R2** | ✅ **已完成**（§十三 取证纪录）：`docindex.py`（章节切块 + CCG 渲染 + `doc_ref`）+ `op=index_doc`；裁 §1.3-3（层/密级） | ✅ `docs/` 全部 md（实测 **19/19**，非静默跳过）切块可定位；`docs/认知图_MD目录方案_v0.1.md` 的 §9 表被判 **ACCEPT** 且给出行号 `L491-L516` | ✅ |
+| **R2** | ✅ **已完成**（§十三 取证纪录）：`docindex.py`（章节切块 + CCG 渲染 + `doc_ref`）+ `op=index_doc`；裁 §1.3-3（层/密级） | ✅ `docs/` 全部 md（实测 **19/19**，非静默跳过）切块可定位；`docs/mdcg/认知图_MD目录方案_v0.1.md` 的 §9 表被判 **ACCEPT** 且给出行号 `L491-L516` | ✅ |
 | **R3** | ✅ **已完成**（§十四 取证纪录）：`_refindex.json` 增量（抄 `sources.Ingestor` 范式）+ `check_refs` 漂移巡检 + `truncated` 显式上报 + 接入 `sustain.diagnose` | ✅ 改源文件一行 → `ref check` 报 stale（重建后消除）；删源 → dangling；`max_files` 触发时 `truncated=true` 且写进水位；`diagnose` 报 `ref_stale`、`heal` 的 `rebuild_refs` 修复 | ✅ |
+| **R3.1** | ✅ **已完成**（§十五 取证纪录，2026-09-12）：节点级对账——`prune_orphans`（改标题产生的过期代）+ `prune_dangling`（源已删的悬空节点），接入 `index_code`/`index_doc` 与 `op=ref action=prune` | ✅ P27 §10/§10b 全绿；真实现场悬空 **20 → 0**（`LIVE_HITS=0`/`TRASH_HITS=20`）；受影响面 7 模块 6 绿 1 环境红 | ✅ |
+| **R3.2** | ✅ **已完成**（§十五 取证纪录，2026-09-12）：索引器**追加排除** `skip_dirs`（`index_code`/`index_doc`）——把 `.gitignore` 已忽略却物理留存的实验产物挡在门外，替代「调大 `max_files`」这一掩盖手段 | ✅ P27 **75/0** 全绿（§9 由 `500/2388` 红转 `30/30`）；新增 §9b 验证匹配口径 / 只增不减 / 可审计；受影响面 10 模块全绿 | ✅ |
 | **R4** | 修 H：code↔doc 互链（文档中出现的符号名/路径 → 建边指向 code 节点；反向亦然） | 「某功能」检索能同时给出代码位置与文档位置 | ⬜ |
 | **R5** | 修 I（工程规范化产出，见 §九） | 三份索引文件可由 `index_ref` **自动生成**，非手写 | ⬜ |
 | DEFER | `.ps1/.vbs/.yml` 提取器；跨副本身份下的 ref 可见性 | 先决：R4 完成且互链被实际使用 | ⬜ |
@@ -221,7 +223,7 @@ md_cg 侧再补 `timeout_ms` 与 `needs_clearance` 两个扩展字段。裁剪
 3. **`hash` 不是内容寻址**：只做变更探测，不保证「内容相同即同节点」。
 4. ~~R0 有一个待闭环疑点~~ → **已在 §十一 闭环**。「`test_p1` EXIT 1 且输出仅 165 字节」的根因与 `test_p0` 同一类：受管环境下 `os.remove` 被环境 shim 接管，
    删除量越阈即中断进程；且失败形态是**静默截断 + 非零退出**，不是一条 FAIL。现已改为不清空目录（原子覆盖 + 等号守门），并全量复跑验证。
-5. **当前工作区未提交**：`docs/认知图_MD目录方案_v0.1.md`、`bench_p0.py`、`census.py`、`test_p0.py`、`test_p1.py` 已改，`md_cg/corpus.py` 未跟踪——R0 应先收口提交，再动索引层。
+5. **当前工作区未提交**：`docs/mdcg/认知图_MD目录方案_v0.1.md`、`bench_p0.py`、`census.py`、`test_p0.py`、`test_p1.py` 已改，`md_cg/corpus.py` 未跟踪——R0 应先收口提交，再动索引层。
 
 ---
 
@@ -251,7 +253,7 @@ md_cg 侧再补 `timeout_ms` 与 `needs_clearance` 两个扩展字段。裁剪
 `_md_cg_p0` 实测 **0 文件**——说明第一个 `reset_root(ROOT)` 已清空+重建成功，死在第二个；
 `_md_cg_p1` 实测 **350 文件**（< 500）故通过——**只差 150 就到阈值**，这正是历史上「P1 EXIT 1 / 165 字节」的同源形态。
 
-**关键点：文档早已裁决过**。`docs/认知图_MD目录方案_v0.1.md:365-367` 原文：
+**关键点：文档早已裁决过**。`docs/mdcg/认知图_MD目录方案_v0.1.md:365-367` 原文：
 > 幂等性：迁移按 node id 原子覆盖写，可反复执行，**不需要先清空目录**。（这不只是便利：清空目录依赖 `rmtree`，
 > 在有安全策略的环境下会被拦截，而"必须先删除才能重跑"的迁移脚本本身就是个脆弱设计。）
 
@@ -493,4 +495,94 @@ md 不是代码，切块风险集中在「把不该当标题的当标题」。
 
 ---
 
-*计划生成：2026-09-10 · 证据：§一 全部为源码行级核对结果 · 未核对项已单列 §1.3 / §十 · §十一 为 R0 实测取证 · §十二 为 R1 实测取证 · §十三 为 R2 实测取证 · §十四 为 R3 实测取证*
+## 十五、R3.1 / R3.2 取证纪录（已完成 · 2026-09-12）：节点级对账 + 索引追加排除
+
+> **为什么单开一节而不并进 R3**：R3 只做了**水位层**对账（`Ledger.reconcile`/`prune` 剪的是 `_refindex.json` 的水位条目），
+> **节点层**两类残留无人处置——`node_id = sha1(相对路径 + "#" + heading_path)`，文档标题一变整篇 id 全量重算，
+> 于是同 path 的旧代节点与新代节点并存（一份文档召回两份）；源文件一删，节点永久 `dangling`。
+> §十四 验收项 5 的原话是「删源报 `dangling`」——**悬空当时只承诺「可检出」，本节补上「可处置」**。
+
+### 15.1 交付物与改动清单
+
+| 文件 | 动作 | 职责 |
+|---|---|---|
+| `md_cg/refindex.py` | **扩** | 节点级对账节：`_norm_root`/`_same_root`/`_norm_rel`（大域与路径归一）+ `_forget_many`（逐条软删、受保护拦下、缺 `forget` 能力显式报错）+ `prune_orphans`（清退同 root+path 的过期代）+ `prune_dangling`（清退悬空） |
+| `md_cg/mcp_server.py` | **扩** | `op=ref` 增 `action=prune`/`prune_dangling`；`index_code`/`index_doc` 返回前接 `_prune_after_index`（读 `prune` 默认 True、`prune_dry_run` 预演）；schema 增 `prune`/`prune_dry_run`/`roots` |
+| `md_cg/test_p27_docindex.py` | **扩** | 新增【10】节点级对账、【10b】悬空清退；`cg` 由 `MdCG` 改 `MdCGOS`（对齐生产路径） |
+
+### 15.2 两个真实缺陷（首轮实测暴露，逐条留证）
+
+1. **对账静默假成功（严重）**：`cg.index['nodes']` 是 `mdcg._scan_nodes()` 产出的**元数据快照**（path/layer/tags/importance/edges…），**不含 `ref`**——`ref` 只写在节点 frontmatter 里。首版直接对索引条目调 `ref_of()`，**恒返回 `('', None)`**，于是「清退了 0 条」却报 `ok=True`。实测 `prune_orphans count=0`、`prune_dangling candidates=0`。
+   → 改为 `node = cg.get(nid)` 取回节点再 `ref_of(node)`，并加 `doc`/`code` 标签预筛（与 `check_refs` 同口径，免得为全库每条记忆都读一次盘）。
+2. **`forget` 能力分层被忽略**：`forget` 属 **`MdCGOS` 层**（保护裁决 + 回收站 + 删除清单），基础层 `MdCG` 没有任何删除原语。首版测试用 `MdCG(ROOT)`，实测 `'MdCG' object has no attribute 'forget'`。
+   → ①`_forget_many` 缺能力时**显式返回错误、不静默跳过**（文案点名「生产路径是 MdCGOS，测试请用 MdCGOS」）；②测试改 `MdCGOS` 构造。
+   → 与 P43 的教训同构：**双实现类（`MdCG`/`MdCGOS`）必须双路覆盖**，只测一条路径等于留静默盲区。
+
+### 15.3 三条保守约束（宁可不删，不可误删）
+
+- **只清「本次真正重切过」的文件**：`prune_orphans` 的判定范围限于 `items` 里的 path；增量索引跳过的未变文件不进判定——否则会把完好节点整片误删。
+- **截断轮次不清退**：没扫完 ≠ 剩下的都过期。`_prune_after_index` 见 `truncated=True` 直接返回，不算、不删。
+- **探测失败不算悬空**：`probe_ref` 抛异常即跳过，不把「读不到」当成「源已删」。
+
+### 15.4 真实现场处置（`AEIS/data/mdcg`）
+
+常驻 MCP 进程加载的仍是旧代码（`op=ref` 只认 `read|check|stat`），故按**工作纪律第7条**走等价兜底：python 直调同一模块（身份从 CodeBuddy `mcp.json` 读取，不落盘、不回显令牌）。
+
+| 步骤 | 命令 | 实测 |
+|---|---|---|
+| 巡检 | `op=ref action=check max_nodes=20000` | `checked=5456`、`dangling=20`、`stale=42`、`truncated=false` |
+| 预演 | `action=prune_dangling dry_run=true` | `scanned=10136`、`candidates=20`、`count=20` |
+| 清退 | `action=prune_dangling`（designer 身份，`can_admin=true`） | `count=20`，全部软删进 `trash/` |
+| 复核 | 同 `dry_run` 再跑 + 落盘核对 | `candidates=0`；20 个 `node_id` **`LIVE_HITS=0` / `TRASH_HITS=20`**；`trash/` 与 `_deletions.jsonl` 均 36 条 |
+
+悬空来源单一：4 个已删的临时脚本（`_tmp_v3check.py`×2、`cmp_rows.py`×4、`dump_rows.py`×2、`vision.py`×12），非业务记忆，清退无信息损失且可 `op=restore` 回滚。
+
+### 15.5 诚实边界（R3.1 新增）
+
+1. **对账是 O(带标签节点数) 次读盘**：`ref` 不在索引快照里，只能逐节点 `cg.get()`。每次 `index_code`/`index_doc` 都会带上这一遍开销（本仓 ~500 节点级、现场 10k 节点级；后者秒级但非零成本）。若成热点，正解是把 `ref` 摘要进 `_scan_nodes` 快照，而非放松判定。
+2. **只处置「孤儿」与「悬空」，不处置 `stale`**：漂移（源已改）用重建解决（重跑索引或 `sustain.heal`），不靠清退——删掉再索引等于绕远路。
+3. **`stale` 与「孤儿」判据不同**：孤儿靠 `node_id` 重算比对（结构性），不看内容哈希；内容已变但 id 未变的节点不属孤儿。
+4. **本仓 `test_p27` §9 的计数断言曾在本机为红**（`files=500/2388`，唯一失败项，非 R3.1 改动引起）：`.gitignore` 已整目录忽略的 `docs/experiments/`（实测 2358 个 md 于 `docs/experiments/md-cg-gate-probe/`）物理仍在盘上，把 `docs/` 从 30 个 md 撑到 2388，越过 `max_files=500`。**处置口径已裁定并落地 → 见 §15.7（R3.2）**：给索引器加**追加排除**，而非调大上限。裁后 §9 由 `500/2388` 转为 `30/30` 全绿。
+
+### 15.6 回归（R3.1）
+
+受影响面 7 模块：`test_p9_forget_protect` 37/0、`test_p14_sustain` 44/0、`test_p21_tokens` 31/0、`test_p26_refindex` 55/0、`test_p28_refcheck` 45/0、`test_p2_mcp` 63/0 **全绿**；`test_p27_docindex` **68/1**（当时唯一红项为 §15.5-4 的环境事实，非代码缺陷）。
+
+### 15.7 R3.2：`skip_dirs` 追加排除（原 §15.5-4 的裁定落地）
+
+**问题**：索引的「扫描范围」只有**下限**（`SKIP_DIRS` 硬编码）没有**上限**——`.gitignore` 已整目录忽略的实验产物物理仍留在盘上，就照样被扫。本仓 `docs/` 真实内容 30 个 md，被 `docs/experiments/` 的 2358 个撑到 2388，直接压爆 `max_files=500`。此前唯一的应对是「调大 `max_files`」，那是**掩盖**：上限调到 2500，下次再多一批产物同样爆。
+
+**交付物**：
+
+| 文件 | 动作 | 职责 |
+|---|---|---|
+| `md_cg/codeindex.py` | **扩** | `skip_matcher(skip_dirs)` → `(hit, rules)`；`index_dir(..., skip_dirs=None)` 在 `os.walk` 处**追加**剪枝；`stats` 增 `skip_dirs`（规则回显）/ `skipped_dirs`（实际排掉的目录） |
+| `md_cg/docindex.py` | **扩** | 同签名同语义，复用 `codeindex.skip_matcher`（**唯一实现**，避免两条链路口径漂移） |
+| `md_cg/refindex.py` | **扩** | `index_dir(..., skip_dirs=None)` 透传给底层 |
+| `md_cg/mcp_server.py` | **扩** | `index_code`/`index_doc` 透传 `skip_dirs`；`_skip_dirs_report()` 把「排掉了什么」压成 `skipped_dirs` / `skipped_dirs_count` / `skip_dirs` 回报；schema 增 `skip_dirs` |
+| `md_cg/test_p27_docindex.py` | **扩** | §9 改用 `skip_dirs=["experiments"]`；新增 §9b 专测匹配口径 / 只增不减 / 可审计 |
+
+**三条设计裁定**：
+
+1. **只增不减**：`skip_dirs` 在 `SKIP_DIRS` **同一处**生效，调用方只能追加，**不能关掉** `.git`/`.venv`/`node_modules` 这类内置保护——否则一次参数写错就能把版本库元数据索引进认知图。
+2. **排除不许静默**（与「截断不许静默」同一纪律）：命中目录写进 `stats["skipped_dirs"]`（就地追加、不依赖末尾汇总，所以**截断提前 return 时也带得走**），MCP 层再压成可读回报。调用方据此能把「源文件真的少了」与「被规则排掉了」区分开。
+3. **两类匹配口径可混用**：含 `/` 按**相对 root 的路径**（`docs/experiments` 只排这一处）；不含 `/` 按**目录名**（`experiments` 排任意层级同名目录）。反斜杠 / 首尾斜杠先归一——否则「规则传了却不生效」又是一次静默失配。默认 `None` 时 `hit is None`、走原路径，**行为与改造前逐字一致**（同 `fresh`/`on_file` 纪律）。
+
+**实测**（`test_p27` §9 / §9b）：
+- 本仓 `docs/`：`files=30/30`、`truncated=false`，`skipped_dirs=['experiments']`（此前 `files=500/2388` 已截断）。
+- 合成树（`keep.md` + 两层 `experiments/*` + `sub/experiments/y.md` + `node_modules/pkg/n.md`）：不给规则 → `files=4`「内置排除照旧」；`skip_dirs=["experiments"]` → `files=1` 且 `skipped=['docs/experiments','sub/experiments']`（**同时证明 `node_modules` 仍被排，即只增不减**）；`skip_dirs=["docs/experiments"]` → `files=2` 只排这一处；`skip_dirs=["docs\\experiments\\"]` → `files=2`（归一后仍生效）。
+
+### 15.8 诚实边界（R3.2 新增）
+
+1. **按路径的规则不跨 root**：`docs/experiments` 是「相对本次 root」的路径，换个 root 就不再匹配；跨仓复用规则要用不含 `/` 的目录名形式。
+2. **同名目录一网打尽**：`skip_dirs=["experiments"]` 会排掉**任意层级**的同名目录。这正是它对 `2_ai` 那种多子项目树好用的原因，但也意味着「只想排一处」必须写全路径。
+3. **排除只影响扫描，不清理既有节点**：已在库、但本次被排掉的目录里的节点**不会**因此消失（`prune_orphans` 的判定范围限于本次真正重切过的 path，见 §15.3-1）。若要清掉，需先不带 `skip_dirs` 跑一次让它们成为孤儿，或直接 `prune_dangling`。
+4. **`max_files` 仍是安全上限而非目标值**：`skip_dirs` 解决「噪声挤占额度」，不解决「真实内容超过 500」——真超了应当**调大 `max_files`**（那是真实内容），而不是继续加排除。
+
+### 15.9 回归（R3.2）
+
+受影响面 10 模块**全绿**：`test_p2_mcp` 63/0、`test_p9_forget_protect` 37/0、`test_p14_sustain` 44/0、`test_p21_tokens` 31/0、`test_p26_refindex` 55/0、`test_p27_docindex` **75/0**、`test_p28_refcheck` 45/0、`test_p29_session_ingest_export` 48/0、`test_p30_maintain` 55/0、`test_p32_backfill` 58/0。改动文件 lint 0 错误。
+
+---
+
+*计划生成：2026-09-10 · 证据：§一 全部为源码行级核对结果 · 未核对项已单列 §1.3 / §十 · §十一 为 R0 实测取证 · §十二 为 R1 实测取证 · §十三 为 R2 实测取证 · §十四 为 R3 实测取证 · §十五 为 R3.1 / R3.2 实测取证*

package/docs/{ → mdcg/}/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md

@@ -35,10 +35,10 @@ P8 34 · P9 37 · P10 24 · P11 27 · P12 32 · P13 42 · P14 44 · P15 53 · P1
 | 3 | **RRF 并行多路召回** | `search_rrf(...)` | 词法 / 条件桶 / 实体 / 图扩展 四路并行 → Reciprocal Rank Fusion；结果带 **provenance**（可审计）|
 | 4 | **审核队列 edit/merge** | `propose` · `review_list` · `review_decide` | 海马体式 `hippocampus/inbox.jsonl` → `decisions.jsonl`；裁决 **accept / reject / edit / merge** |
 | 5 | **tombstone + 恢复检查** | `forget` · `restore` · `is_tombstoned` | 软删除入 `trash/` + `_deletions.jsonl` 删除清单；恢复时校验，须 `force` 才可强恢复 |
-| 6 | **payload-free 审计** | `_audit` · `audit_records` | 每次变更只记 `{t,op,id,actor,payload_hash}`，**绝不记内容** |
+| 6 | **payload-free 审计 + 分片轮转** | `_audit` · `audit_records` · `rotate_audit` · `audit_scale` | 每次变更只记 `{t,op,id,actor,payload_hash}`，**绝不记内容**；活动日志超 `AUDIT_ROTATE_BYTES` 即 `os.replace` 原子切分（分片数 ≤ `AUDIT_KEEP_SHARDS`）⇒ **单文件与总量都有上界**；读数走 O(1) 元数据口径（超大历史分片只给量级并标 `exact=False`）|
 | 7 | **budget-driven pack** | `recall(query, budget_tokens)` | 装到预算花完；**超大条目跳过而非停下**（继续尝试更小的）|
 
-另：`health_os()` 在原有健康度上并入 OS 指标（role 分布 / 待审数 / 墓碑数 / 审计事件数 / 反思数）。
+另：`health_os()` 在原有健康度上并入 OS 指标（role 分布 / 待审数 / 墓碑数 / 审计事件数 / 反思数）；审计面另透出**轮转证据**：`audit_shards` / `audit_total_bytes` / `audit_total_events` / `audit_total_exact` / `audit_oversized`。
 
 ---