@furongjun1999/dsh-memory 0.4.4 → 0.4.6

package/docs//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

@@ -0,0 +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 | 同一内容只允许一处为准 |

package/docs//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md

@@ -0,0 +1,198 @@
+# 理论仓拆分与白箱知识库内迁 v0.1
+
+> 状态：执行规格（**未执行任何文件搬迁/删除**）
+> 日期：2026-09-10
+> 上游：[docs/灵枢三层拆分规划_v0.1.md](灵枢三层拆分规划_v0.1.md)
+> 性质：本文给出三条动作的**实测盘点 + 精确改动点 + 执行顺序**；所有数字为 2026-09-10 本机实测。
+
+---
+
+## 0. 三条动作
+
+| # | 动作 | 一句话 |
+|---|---|---|
+| **A** | 理论仓（CTP）功能拆分 | 去掉 `aeis/` 工程库，CTP 只留「灵」（协议 / 文档 / 账本 / 测试集） |
+| **B** | 灵枢插件主仓改为使用 `md_cg` | 主桥默认从 `python -m aeis.mcp.server` 收敛为 `python -m md_cg.mcp_server`，不再依赖 pip 装 `aeis` wheel |
+| **C** | 白箱知识库改为主仓自带 | CTP 的 `wisdom/` + `knowledge/` + `seed_knowledge/`（+ `skills/`）迁入 `dsh-memory` |
+
+**关键现状（决定顺序）**：插件当前启**两个 Python 子进程**——
+
+```
+LingshuBridge  → python -m aeis.mcp.server    ← pip 安装的 aeis wheel（来自 CTP）
+MdcgClient     → python -m md_cg.mcp_server   ← 本仓 md_cg/（需 PYTHONPATH 指向仓库根）
+```
+
+即 **「大脑」目前物理上住在理论仓**：npm 包 `files` 白名单只含 `lib/src/README/cordis*/docs`，**不含 `md_cg/`**。所以 B 与 C 必须**同时成立**才不产生功能回归。
+
+---
+
+## 1. CTP/aeis 实测盘点
+
+| 目录 | 体积 | 文件数 | 归属 | 处置 |
+|---|---|---|---|---|
+| `models/` | **10932.7 MB** | 297 | 身（模型权重） | 迁身体仓；**绝不进 git** |
+| `wisdom/` | 26.5 MB | 128 | **脑（白箱引擎+知识资产）** | 迁入主仓 |
+| `build/` | 22.8 MB | 278 | 产物 | **删除** |
+| `dist/` | 9.7 MB | 1（wheel） | 产物 | **删除**（改由主仓发布） |
+| `knowledge/` | 8.6 MB | 249（247 md） | **脑（白箱知识库）** | 迁入主仓 |
+| `tests/` | 2.9 MB | 78 | 测试 | 按被测对象分流 |
+| `aeis/` | 2.0 MB | 143 | **工程库** | **删除**（功能三分流） |
+| `seed_knowledge/` | 1.4 MB | 119 | **脑（种子知识）** | 迁入主仓 |
+| `skills/` | 1.1 MB | 698（693 md） | **脑（688 Agent Skills）** | 迁入主仓 |
+| `data/` | 1.1 MB | 30 | 运行数据 | 逐项核实后迁/删 |
+| `harness/` | 0.3 MB | 69 | 接口 | 迁（并入主仓或身体仓） |
+| `docs/` `examples/` `logs/` `.pytest_cache/` `aeis.egg-info/` | 0.2 MB | 8+ | 文档/产物 | 文档保留，产物删除 |
+
+**非模型合计 ≈ 72 MB**；其中**白箱知识资产 ≈ 37.6 MB**（wisdom + knowledge + seed_knowledge + skills）。
+
+### 1.1 白箱知识资产明细（wisdom/ 大文件）
+
+| 文件 | 体积 |
+|---|---|
+| `wisdom-book-cloud.db` | 10.98 MB |
+| `neural_index.npz` | 6.53 MB |
+| `csre_lexicon_index.npz` | 0.46 MB |
+| `code_solidified.json` | 0.37 MB |
+| `neural_index.json` | 0.16 MB |
+| `conflict_map.json` | 0.12 MB |
+| `trigger_words_index.json` | 0.09 MB |
+| 其余（distilled_condition_units / prereq_map / role_solidified / snr_report / status_terms / task_discipline / human_observer_knowledge） | < 0.07 MB 各 |
+
+---
+
+## 2. 动作 A：CTP 只留「灵」
+
+### 2.1 保留（灵）
+
+`智能论3.4.md` · `README.md` · `AGENTS.md` · `LICENSE` · `docs/`（252 md）· `protocol-framework/` · `ledger/` · `memory-seed/` · `testsets/`（157 json）· `reports/`
+
+### 2.2 删除（工程）
+
+`aeis/` 整目录 —— 但**前置条件**：其内容必须先完成三分流（§4），否则删除即断链。
+
+### 2.3 待分流（本节最易漏，须逐项裁决）
+
+| 路径 | 问题 | 建议归属 |
+|---|---|---|
+| `tools/`（1881 文件） | 内含 `seed_common_*_cards.py` 等**知识播种脚本**（属白箱知识管线），也含 `rp_quality_gate.py` / `run_whale_100.py`（属角色/身体） | 播种 → 主仓；角色/身体 → 身体仓；一次性实验脚本 → `historical/` |
+| `historical/`（907 文件：780 py） | 历史归档 | 保留为 CTP 归档目录 或 移出 |
+| `plugins/` `release/` `data/` | 空/未定 | 逐项核实 |
+| `demo_lingshu.py` / `gen_dialogue_1000.py` / `run_*.py` / `extend_test_100.py` / `_queue_dp.py` | 根目录散落脚本 | 分流或归档 |
+
+### 2.4 验收
+
+- CTP 内 `find -name "*.py"` 只剩 `protocol-framework/`（5 py）与 `historical/`（归档）。
+- CTP 无 `pyproject.toml` 打包配置残留（aeis 的发布职能移交主仓）。
+
+---
+
+## 3. 动作 B：主仓收敛为单 `md_cg` 进程
+
+### 3.1 改动点（精确到行）
+
+| # | 文件:行 | 现状 | 改为 |
+|---|---|---|---|
+| B1 | `src/index.ts:126` | `moduleArgs` 默认 `['-m','aeis.mcp.server']` | `['-m','md_cg.mcp_server']` |
+| B2 | `src/index.ts:186` | `env: { AEIS_DB, AEIS_IDENTITY, ... }` | 去掉 `AEIS_DB`（或降为兼容可选） |
+| B3 | `src/bridge.ts:50` | 注释/默认指向 `aeis.mcp.server` | 同步为 `md_cg.mcp_server` |
+| B4 | `cordis.yml.example:26` | `moduleArgs: ['-m','aeis.mcp.server']` | 同步 |
+| B5 | **`package.json:14-21`** | `files` 白名单**不含** `md_cg` | **加 `md_cg`**（否则 npm 包不含大脑，B 无意义） |
+| B6 | `md_cg/whitebox.py:63` | `args = ["-m","aeis.mcp.server"]`（子进程） | 改为进程内调用（见 §4.2） |
+| B7 | `md_cg/vision_evidence.py:81,173` | `AEIS/data/vision/...` | 本仓 `data/vision/...` |
+| B8 | `md_cg/migrate_aeis.py` | 一次性迁移脚本 | 标 `legacy/`，保留但声明不随主线 |
+| B9 | `src/lib/mdcg_client.ts:44,63` | 已默认 `['-m','md_cg.mcp_server']` | **无需改**（B 的正向基线） |
+
+### 3.2 功能缺口（必须逐项裁决）
+
+实测工具定义数：`md_cg/mcp_server.py` = **33**，`aeis/aeis/mcp/server.py` = **84**。
+
+`md_cg.mcp_server` 默认只暴露 kernel 2 基元（`cg`/`stg`），`MDCG_MCP_SURFACE=full` 才补 29 个细粒度工具。**差额约 50 个工具**（角色扮演 / 世界模型 / 身体视觉 / 洞察 / 生命周期 / 智慧之书族）。
+
+每一项须落入三选一：
+
+| 处置 | 含义 |
+|---|---|
+| **迁入** | 该能力本质属于大脑（如白箱族）→ 在 `md_cg` 内实现或包一层 |
+| **移身体** | 依赖设备/模型/宿主（如 `see`/`device_call`/`run_command`）→ 身体仓，插件侧作为可选扩展挂载 |
+| **废弃** | 已无下游调用（如 `lingshu-whitebox` provider 已下线）→ 删除并留痕 |
+
+> 未裁决先切默认 args = 静默丢功能（工具不再注册，Agent 侧表现为「工具不存在」）。
+
+---
+
+## 4. 动作 C：白箱知识库内迁
+
+### 4.1 搬迁映射
+
+| 源（CTP/aeis） | 目标（dsh-memory） | 体积 |
+|---|---|---|
+| `wisdom/` | `md_cg/whitebox/`（引擎+资产同目录） | 26.5 MB |
+| `knowledge/` | `data/whitebox/knowledge/` | 8.6 MB |
+| `seed_knowledge/` | `data/whitebox/seed/` | 1.4 MB |
+| `skills/` | 顶层 `skills/`（随包分发） | 1.1 MB |
+| `harness/` | `harness/` 或并入 `src/` 桥 | 0.3 MB |
+
+### 4.2 实测阻断点：wisdom 依赖 `aeis.core`
+
+`wisdom/` **不是自包含的**，硬依赖如下（实测）：
+
+- `from aeis.core import ...` —— **11 个文件、约 25 处**：`SpacetimeMemoryEngine` / `ConditionSpace` / `MemoryLayer` / `EdgeType` / `STNode` / `LayeredStore`
+  - 涉及：`wisdom_cloud.py` `wisdom_book.py` `semantic_translate.py` `pattern_separation.py` `causal_discover.py` `scene_reconstruction.py` `spatial_qa.py` `card_validator.py` `neural_retrieve.py` `answer_spec_anchor.py` `danmaku_bridge.py`
+- `from aeis.api import Agent` —— 3 处（`spatial_qa` `causal_discover` `danmaku_bridge`）
+- 平铺导入：多数文件 `sys.path.insert(0, __file__ 目录)` + `from wisdom_book import ConditionDex`（非包相对），**同目录搬迁即可存活**，但改名会破坏
+- **`md_cg` 侧无对应类**：实测 `md_cg/` 内 0 处定义 `ConditionSpace`/`MemoryLayer`/`STNode`/`SpacetimeMemoryEngine`（md_cg 用 plain dict 表达 `condition_space`）
+
+**两条路径**
+
+| 路径 | 做法 | 代价 | 风险 |
+|---|---|---|---|
+| **A 兼容层**（建议先行） | 在 `md_cg/` 内建 `aeis_compat.py`，提供上述 6 个类名 → 映射到 md_cg 原生模型；wisdom 只改 import 前缀 | 小（一个 shim + import 替换） | 语义漂移：`ConditionSpace` 字段口径须逐字段对齐，须回归测试 |
+| **B 收敛重构** | 把 wisdom 的 `aeis.core` 用法改写为 md_cg 原生 API | 大 | 高回归面，需全量白箱测试 |
+
+### 4.3 新增裁决点：37.6 MB 知识资产怎么分发
+
+| 方案 | 优点 | 缺点 |
+|---|---|---|
+| 随 npm 包 | 一条命令装齐 | npm 包从 <1 MB 涨到 ~38 MB，安装/更新变慢 |
+| 随 Python 包（wheel） | 与 pip 生态一致 | 需要主仓产出 wheel（当前无 pyproject） |
+| 首启下载 / 按需拉取 | 包最小 | 离线首次不可用，与「开箱可用」冲突 |
+
+> 建议：**引擎随包、大资产（`.db` / `.npz`，合计 ~18 MB）单独发资产包**，首启校验并落 `data/whitebox/`；这需要你裁决。
+
+---
+
+## 5. 执行顺序（不可交换）
+
+| 步 | 动作 | 验收 |
+|---|---|---|
+| **S1** | CTP 冻结 + 打 tag（只读快照，不动内容） | tag 存在，可回滚 |
+| **S2** | 主仓建 `aeis_compat` + 内迁 `wisdom/`（CTP 不动，仅复制） | 主仓内 `import` 通过（0 处 `aeis.core` 残留） |
+| **S3** | 跑通主仓白箱链路 `cg(op=whitebox, action=ask)` | 返回非空 + 与 CTP 侧答案对照一致 |
+| **S4** | 主仓切默认 args → `md_cg.mcp_server`；`package.json` 加 `md_cg` | 单进程启动，`tools/list` 达到裁定后的目标工具集 |
+| **S5** | 功能缺口逐项裁决（迁/移/废） | 差额表逐行有结论 |
+| **S6** | CTP 删 `aeis/`（此时已无下游依赖） | CTP 内无工程 `.py`（除归档） |
+| **S7** | 文档/命名统一（清「aeis = 大脑」语义债） | README 无歧义 |
+
+> **铁律不变**：`data/mdcg`（6340 节点）在 S6 之后才动；动前先演练回退。
+
+---
+
+## 6. 总验收
+
+1. 主仓 `python -m md_cg.mcp_server` **独立可跑**，不依赖 pip 装的 `aeis`。
+2. 主仓 `grep -r "aeis" md_cg/ src/` 仅剩「兼容层 + legacy 迁移脚本」两类豁免命中。
+3. 白箱知识库自洽：迁入后 `knowledge/` 247 md + `seed_knowledge/` 118 md，数量与 CTP 侧一致。
+4. CTP 内无工程实现（仅协议/文档/账本/测试集）。
+5. 工具面差额表逐行闭环，无静默丢失。
+
+---
+
+## 7. 风险
+
+| 风险 | 触发 | 缓解 |
+|---|---|---|
+| 静默丢功能 | 先切 args，后裁决工具 | S4 前必须完成 S5 的差额表 |
+| 语义漂移 | 兼容层对 `ConditionSpace` 字段口径不一致 | 逐字段对照 + 白箱回归用例 |
+| npm 包膨胀 | 37.6 MB 资产随包 | 引擎随包、大资产生成资产包（待裁决） |
+| 断链 | 先删 `aeis/` 后迁 | 严格 S1→S6 顺序 |
+| 记忆真源错位 | 搬迁时 `mdcg.root` 漂移 | 写入冻结 + 备份 + 6340 节点核对 |

package/docs//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md

@@ -8,7 +8,8 @@
 > 目标读者：会一点 Python、想亲手做一个"有记忆的 AI"的人。
 > 诚实开场白：标题里的"真正记得"指的是可复现的工程方法，不是魔法。本教程
 > 不依赖任何未经验证的榜单数字，只讲原理。全部代码经过 zcode 端独立实测
-> （8/8 通过，验证报告见文末附录）。
+> （8/8 通过，验证报告见文末附录）；文末另附一组任务级 A/B 实证，
+公开测试集可一键复跑。
 
 ---
 
@@ -340,6 +341,49 @@ if turn_count % 30 == 0:
 
 ---
 
+### 九·一 实测：先验陷阱 A/B（可复现）
+
+上面的方法不是空谈。我们按它设计了一组「先验陷阱」实验，在两个量级完全不同
+的模型上跑出了同一个结论。
+
+**为什么要用先验陷阱**：如果题目答案本来就在模型的先验里，无记忆臂也能答对，
+记忆的价值会被天花板效应遮住。所以每题都构造成——通用最佳实践（模型会自信
+选它）在本项目规范下恰好是错的，只有记忆里的隐性条件能纠正：
+
+| 用例 | 陷阱（模型先验） | 本项目正解（只在记忆里） |
+|---|---|---|
+| p01 | 返回 HTTP 400 | 返回 200 + 业务错误码（老 SDK 会重试非 200） |
+| p02 | ISO 8601 字符串 | Unix 毫秒整数（时区事故） |
+| p03 | `isinstance(x, int)` | `type(x) is int`（bool 是 int 子类） |
+| p04 | `cfg.get('key', d)` | `'key' in cfg`（区分未配 vs 显式 None） |
+| p05 | `logger.warning` | `logger.info` + `[WARN]`（warning 触发 PagerDuty） |
+
+**结果**（5 用例 × 3 循环排列 × 2 臂 = 30 次调用/模型，temperature=0）：
+
+| 指标 | deepseek-v4.1-flash | 本地 9B |
+|---|---|---|
+| content_acc（无记忆 → 有记忆） | 0.0% → **100%** | 20.0% → **100%** |
+| trap_rate（无记忆 → 有记忆） | 100% → **0%** | 80% → **0%** |
+| 召回命中（有记忆） | 100% | 100% |
+| 选项位置分布（无记忆 → 有记忆） | 5/5/5 → 5/5/5 | 4/7/4 → 5/5/5 |
+| 平均 token（无记忆 → 有记忆） | 309 → 763 | 185 → 781 |
+
+三个结论：
+
+1. **记忆增益与模型强弱无关**：两个模型加记忆后都 15/15 全对、trap_rate 归零。
+   收益来自记忆内容本身，不靠模型推理能力兜底。
+2. **小模型无记忆的 20% 基本是位置偏差**：15 次里 7 次选了第 2 个选项，3 次选对
+   中有 2 次正落在第 2 位；有记忆后位置分布回到均匀 5/5/5。这说明「看着会」和
+   「真的懂」必须分开测。
+3. **记忆的代价是每次多几百 token**（本实验 +450~600），延迟基本不变。
+
+> **公开测试集**：`CommonTrustProtocol/testsets/prior_trap_v1/`——
+> `prior_trap_testset_v1.json`（题目）、`prior_trap_testset_v1_results.json`
+> （逐次原始结果）、`run_prior_trap_v1.py`（零依赖 runner）、`README.md`
+> （方法 + 复现步骤）。填入任一 OpenAI 兼容端点即可复跑。
+
+---
+
 ## 十、收尾：三个真正值得记住的结论
 
 1. **记忆 ≠ 历史。**记忆是从经历中提炼出的、未来会被调用的状态。存录音的
@@ -371,3 +415,7 @@ if turn_count % 30 == 0:
 - **理论对照**：本教程七件套与白箱智能的五层记忆（锚点/结构/知识/情境/自
   我）、条件空间必带、负记忆机制、压缩巩固**逐条同构**——教程的"条件绑定"
   就是系列第一篇"条件空间"的入门形态，"四态判定"贯穿白箱全部能力判定。
+- **v1.2 任务级 A/B 实证（2026-09-09）**：先验陷阱 5 题 × 3 排列 × 2 臂，在
+  deepseek-v4.1-flash 与本地 9B 上均得到「无记忆 0~20% → 有记忆 100%」，
+  trap_rate 100%/80% → 0%，召回命中 100%。公开测试集见
+  `CommonTrustProtocol/testsets/prior_trap_v1/`，可一键复跑。