@furongjun1999/dsh-memory 0.4.11 → 0.5.0

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

@@ -1,198 +1,198 @@
-# 理论仓拆分与白箱知识库内迁 v0.1
-
-> 状态：执行规格（**未执行任何文件搬迁/删除**）
-> 日期：2026-09-10
-> 上游：[docs/mdcg/灵枢三层拆分规划_v0.1.md](../mdcg/灵枢三层拆分规划_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 | `dsh/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 节点核对 |
+# 理论仓拆分与白箱知识库内迁 v0.1
+
+> 状态：执行规格（**未执行任何文件搬迁/删除**）
+> 日期：2026-09-10
+> 上游：[docs/mdcg/灵枢三层拆分规划_v0.1.md](../mdcg/灵枢三层拆分规划_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 | `dsh/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 节点核对 |