@furongjun1999/dsh-memory 0.7.3 → 0.7.5

package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md

@@ -0,0 +1,76 @@
+# 灵枢「身体 × 脑」世界模型对接设计 v0.1
+
+> 任务来源：使用者 2026-10-06「0.8.0 版本工作就是和之前的身体核心组合。让世界模型真正端到端可用。」
+> 三步流程：**测试验证成功 → 脱敏 → 全部公开**（本稿完成第一步并出读数）。
+> 状态：v0.1 未签收；本稿**不改一行码**（smoke 件为已验收验证工具，见 §一）。
+
+---
+
+## 一、测试验证读数（第一步已达成）
+
+| 验证 | 内容 | 读数 |
+|---|---|---|
+| V1 身体包冒烟 | `lingshu` 包导入（python 3.12.10） | core 零依赖 ✓ · world（numpy 2.5.3）✓ · gen ✓ |
+| V1b 既有连接 | `tools/coggraph/view_memory.py` 七步在当前库重跑 | rc=0、203s、**20135 节点**／5918 显式边／78685 推导边／4 会话链；只读真源、产物仓外 |
+| V3 世界模型端到端 | 身体侧进程 → MCP stdio → 脑（v0.7.4） | 握手 ✓ → **写口 25/25 入账** → **查询 11 槽位**（含 2 退役、区间/变迁史全对）；隔离库 |
+| **固化件** | `scripts/body_e2e_smoke.py`（本仓） | 内置样本 3/3→2 槽位 ✓ · 真实事件 25/25→11 槽位 ✓（两遍 VERDICT=PASS，可复跑） |
+
+## 二、对接面盘点（读码级）
+
+### 2.1 身体侧（`lingshu/world` 24 件）关键面
+
+- **`scene_model.py`＝「语义时空图 ↔ 3D 场景绑定层」**——天然对接件：
+  - store 协议：`get_nodes_by_tag(tag, limit)`（读）；节点带 `tags`（`spatial`＋`cat:<类>`＋`ent:<名>`）、`spatial_coordinates {x,y,z}`（米）、`state_attributes {"state": …}`；`ingest_scene` 写路径。
+  - `load_world_from_memory(store)`＝世界重建（"记忆即缓存：场景＝记忆节点的实时投影"）——**理念与脑侧「事件是源、槽位是投影」同构**。
+- `semantic_anchor_graph.py`：3D 语义锚点图（节点＝类别＋坐标；边＝关系；"事物是其关系的总和"）。
+- `seven_layer_loop.py`：感知→记忆→理解→预测→验证→物理→决策（"记忆"层即对接位）。
+- `spacetime_consistency / anchored_verification / anchor_verify`：时空一致性、锚定分级验证（多感知通道）。
+
+### 2.2 脑侧（本仓）对应面
+
+- `stg` 五 op（`timeline / anchors[2D bbox] / consistency / relation / state_chain`）；
+- `state_events` 台账 ＋ `state_slots` 投影 ＋ `cg(op=state_event)` 写口 ＋ 两个《秤》探针；
+- MCP 面（V3 smoke 已证跨进程全链）。
+
+### 2.3 映射表与缺口
+
+| 身体侧约定 | 脑侧对应 | 状态 |
+|---|---|---|
+| tags：`spatial` / `cat:` / `ent:` | 节点 tags（写侧可带） | 写 ✓；**读侧缺 tag 过滤维（缺口①）** |
+| `spatial_coordinates {x,y,z}`（米） | `frontmatter.spatial.bbox`＝2D 图像坐标四元组 | **缺口②：3D↔2D 方案待裁**（见 §四.2） |
+| `state_attributes.state`（每实体状态） | **槽位寄存器**（subject＝实体／slot＝state／value）＋状态事件台账 | **✓ 同构，直接对接**（世界模型的"状态追踪"＝本版新地基：记账→台账→投影） |
+| `ingest_scene` 写 | `cg(op=state_event)` / `mdcg_remember`（经 MCP，已证） | ✓ |
+| `load_world_from_memory` 读 | 需"按 tag 读＋坐标取回"的组合 | **缺口①③：标签过滤读；场景整体重建的组合接口** |
+
+## 三、最小闭环（两条路线）
+
+- **M1（读向·身体重建世界）**：给 `scene_model` 提供"**脑版 store**"（实现 `get_nodes_by_tag` /
+  `state_attributes` 等 → 经 MCP `cg` 读＋台账投影取值）→ `load_world_from_memory` 零改动直接以脑为底。
+- **M2（写向·身体观测入脑）**：`ingest_scene` 的写落到 `cg(op=state_event)`（状态变迁）＋场景节点
+  （坐标入库）→ 由脑的投影/查询供任意端消费（**smoke 已证全链**）。
+
+两条路线共用同一验证工具：`python -X utf8 scripts/body_e2e_smoke.py`（隔离库、零在役写入、退出码判据）。
+
+## 四、待裁清单（请逐条裁决）
+
+1. **适配器归属侧**：身体侧件（`lingshu/world/brain_store.py`，聚合仓工具面）vs 脑侧件（本仓）。
+   推荐：**身体侧适配器**——章程口径"脑为包依赖、身侧件进身仓"，且 `scene_model` 零改动即插。
+2. **3D 坐标方案**：推荐 **`spatial.coords3d` 自定义键直存米制＋可选 bbox 投影**（不改既有
+   `spatial.bbox` 的 2D 语义、stg 四 op 零位移）；不建议扩 bbox 为 3D（破坏既有语义）。
+3. **tag 过滤读（缺口①）**：脑侧给 `read/search` 加 tag 维（小活，进脑）vs 适配器侧读后过滤
+   （零脑改、性能略差）。推荐：**先适配器侧**（探针验证后再决定是否进脑）。
+4. **smoke 进门禁**：是否把 `scripts/body_e2e_smoke.py` 纳入发布链附加腿（与《秤》探针同列）。
+
+## 五、边界
+
+- 不改 `scene_model` 既有语义（适配层在 store 接口外侧）；不动在役库（smoke 全隔离）；
+  身体件入聚合仓走章程双清单与 `docs/intake/` 登记；脑侧改动一律走本仓批次纪律（守卫＋变异＋门禁）。
+
+## 六、三步位置
+
+**测试验证 ✓（§一）** → 脱敏（readiness 扫描已 CLEAN；正式步骤＝组合件入库时过双清单并登记）→
+全部公开（转公开时机属使用者操作；公开前终检清单可随时编制）。
+
+---
+
+*v0.1 · 2026-10-06 · 编排侧编制（读码：身体侧 scene_model/semantic_anchor_graph/seven_layer_loop 等；脑侧 stg/state_slots）*