@furongjun1999/dsh-memory 0.4.10 → 0.5.0

package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md

@@ -1,169 +1,169 @@
-# GBrain 可借鉴点 · 灵枢大脑改进交接文档
-
-> 交接方：CodeBuddy 端 · 接收方：**CodeBuddy 端后续施工轮次 / 其他端**
-> 交接时间：2026-09-19 · 依据：荣指令「GBrain 记忆机制学习报告也可以列新任务来补充功能了」
-> 素材：`docs/GBrain记忆机制学习报告_供CodeBuddy端_20260914.md`（自包含报告）· 源项目 gbrain（MIT，TypeScript/bun，30.1k★，本地参考克隆）
-> **本轮范围声明（重要）**：本文件**只出任务清单、不改代码**。四条任务的代码实施另立施工轮次，沿用 Pi 交接「先文档后施工」的既有节奏。
-
----
-
-## 0. 一句话交接
-
-gbrain 把**「记忆如何变化」做成了数据模型的一等公民**——冻结的动词线缆协议、事实有效期双时间戳、巩固指针、能力探测降级；本文件将其 §10 四条可借鉴点逐项映射到灵枢大脑（`md_cg`）的落点，每项带 gbrain 源码证据、**本轮实测的灵枢现状基线**、建议落点与可裁决验收口径；并附「不学什么」反面清单（§4）与既有工作线边界（§5）。
-
-**本文件与 Pi 交接的分工**：Pi 交接（`docs/Pi可学习优点_灵枢大脑改进交接_20260915.md`）解决的是**运行时与上下文工程**（fork/钩子/瘦身/状态机/两段式/不变量巡检/组装细节）；本文件解决的是**记忆数据模型与接口契约**（协议冻结/有效期语义/巩固字段/能力降级）。两者无重叠面，可并行施工。
-
-## 1. 版本与落点纪律（⚠️ 防版本不一致，先读）
-
-| 仓 | 角色 | 本次改动落点 |
-|---|---|---|
-| `dsh-memory/` | **大脑 · 唯一主线** | ✅ **本文件全部改进落这里**（`md_cg/` 为主） |
-| `AEIS/` | 身体仓：记忆真源数据 + 可视化管线 | ❌ 不改代码 |
-| gbrain 源码克隆 | **只读参考件**（MIT，思想可吸收） | ❌ 不引入其运行时、不引依赖 |
-
-- 记忆真源 = md 文件（纯 md，主链路零 SQLite、零外部依赖）；`md_cg` 经 `--root`/`MDCG_ROOT`/datapath 访问，**不得**在 `md_cg` 内硬编码本机路径。
-- **gbrain 的存储形态不学**：其真源是 Markdown、派生索引在 PGLite（嵌入式 Postgres/WASM）。灵枢主链路**零 SQLite**是既有架构决定，只吸收其**数据模型与契约设计**，不引入任何 DB 依赖。
-- 改动后必须跑全量回归（`python -m md_cg.test_pXX` 形式）；测试只能模块方式跑，直接 `pytest md_cg/` 会崩（相对导入，已知缺陷）。
-- **引用纪律（内容政策）**：本文件所有 gbrain 侧证据一律以「**仓名 + 报告锚点行号**」引用（如「报告 §2 冻结政策」），**不写本机克隆绝对路径**；报告头部现有的本机路径不复制。
-
-> **完成度判据（沿用 Pi 交接 §3 纪律，同为本文件的硬约束）**：各项「落地状态」是**手工标注、无机械守卫**，历史上必滞后于代码（Pi 交接已实证：① ② ④ ⑥ 已入库而文档长期漏标，曾据「未标」误判未落地）。
-> **判断某项是否完成，请以认知图落地记录 + `git log` 提交取证为准**，本文件标注只作索引——与「手写行号必腐化」同构：无守卫的手工标注必漂移。
-> **本文件四条初始状态一律为「未开工」，依上纪律，动工前请先重新取证而非信任此标注。**
-
-## 2. gbrain 素材位置（查证入口）
-
-| 内容 | 位置（仓内可见） |
-|---|---|
-| 学习报告（主素材，自包含、逐条带源码锚点） | `docs/GBrain记忆机制学习报告_供CodeBuddy端_20260914.md` |
-| 四条可借鉴点原文 | 同上 **§10**（行号见 §3 各条「证据行」） |
-| 七动词协议与冻结政策 | 同上 §1–§2（对应 gbrain 仓 `gbrain/docs/protocol/MEMORY_VERBS_v1.md`、`gbrain/src/mcp/surface.ts`） |
-| 数据模型逐字段解剖 | 同上 §3（对应 gbrain 仓 `gbrain/src/core/migrate.ts:2395` 起建表语句） |
-| 能力探测两级降级 | 同上 §6（对应 gbrain 仓 `gbrain/src/core/capability.ts`） |
-| 巩固 / dream cycle | 同上 §7 |
-| 反面素材（治理/多 agent/哲学） | 同上 §4、§5、§8、§9 |
-| 动手验证清单（6 条复核路径） | 同上 §11 |
-
-## 3. 可借鉴点清单（按建议优先级排序）
-
-> 每条五段式：**gbrain 机制** → **灵枢现状**（2026-09-19 实测取证）→ **建议落点** → **验收** → **落地状态**。
-
-### ②★P0 事实有效期进入查询语义（highest：字段与判定已在，只差消费）
-
-- **gbrain 机制**：`facts` 表把「记忆的后半生」做成一等公民——`valid_from / valid_until / expired_at` 三戳表达有效期，「过期」由查询侧判定，不是人工清理任务（报告 §3 生命周期行、§10 第 2 条）。配套 `superseded_by BIGINT REFERENCES facts(id)` 自引用链：**纠错不是删除**。
-- **灵枢现状**（实测取证，逐条可复核）：
-  - 字段**已在**：`valid_from` / `valid_until` —— `md_cg/nodefile.py:122-123`（`VALID_FROM_FIELD` / `VALID_UNTIL_FIELD`，注释自陈「`valid_until` 既有（已被 scrub 的过期消费面使用）；`valid_from` 本轮补齐」）+ `md_cg/trust.py:61-62`（`FROM_FIELD` / `UNTIL_FIELD`）。
-  - **`expired_at` 在灵枢零命中**（全仓唯一命中即本报告自身）——灵枢以 `valid_until` + 验证态 `expired` 表达过期，**不设第三戳**。故本条的灵枢形态是「**双时间戳 + 状态**」，与 gbrain 的「双时间戳 + 过期戳」是**同构不同形**（差异如实列出，不视为缺陷）。
-  - 判定函数**已在**：`md_cg/trust.py:225-242` `validity(fm, now)` → `unknown / not_yet / active / expired` 四态。
-  - 消费面**只在治理/展示侧**：`trust.patrol`（`trust.py:500-524` 巡检粗判 expired/not_yet 清单出报表）、`md_cg/statushdr.py:77`（状态头展示）、`md_cg/coldverify.py:148`（冷启动复核转 expired 态）。
-  - **检索面零处理（关键缺口）**：`mdcg.search` / `mdcos.search_rrf` / `mdcos.recall` / `mdcg._candidates` / `mdcos._candidates` **均无 `validity` 调用**——`_candidates` 的过滤维度现有 layer / session / branch / roles，**没有有效期**。即：**过期节点仍会作为正常候选参与召回**。
-- **建议落点**：`md_cg/mdcos.py` 的 `_candidates`（一处过滤全链路生效，与既有 `session=` / `branch=` 过滤同构——该位置已被 Pi④ 验证为「改一处、search/search_rrf/recall 三签名透传」的正确落点）；`mdcg._candidates` 同步（子类覆盖，历史教训：首轮漏改被测试抓住）。**处置语义建议先出裁决再动手**：`expired` 与 `not_yet` 是否同等对待（gbrain 的三戳里 `expired_at` 与 `valid_until` 可分离，灵枢无第三戳 → 需明确「未生效」与「已过期」是否同为不可召回）。参数建议 **opt-in 开关注入**（对齐 `session=`/`branch=` 的「一处过滤全链路生效」与仓内「默认零回归」惯例）。
-- **验收**：① 断言 `validity=expired` 节点**不入候选池**（口径同 Pi④ 分支过滤：以「nid 不在命中集」为准，而非「结果为空」）；② `not_yet` 处置按裁决断言；③ `active` / `unknown` 节点召回**逐位不变**（零回归）；④ 全量回归零新增失败。
-- **落地状态（2026-09-19）：未开工** · 资格裁决=**ACCEPT**（依据：字段在+判定在+查询面缺位，「已有的判定函数无人消费」是确定性缺口，非相似度推断）。
-
-### ③★P0 巩固结果显式化与可追溯（second：已有归并，缺「可被查询看见」）
-
-- **gbrain 机制**：夜间 dream cycle 做「事实抽取 → 引用修复 → **合并** → 嵌入去重」，合并动作在 `facts` 上留下 `consolidated_at / consolidated_into BIGINT`——**合并可追溯**，且是**结果节点上的显式指针**（报告 §3 巩固行、§7）。
-- **灵枢现状**（实测取证）：
-  - `consolidated_at` / `consolidated_into` **全仓零命中**（唯一命中即本报告自身）。
-  - 归并机制**已在**：`md_cg/consolidate.py:1217` `induce_memories`（聚类归纳）+ `:1153` `_link_concept`（建**概念节点** + `edges` 成员边）+ `:1200` `_concept_payload`；`:799` `promote_memories`（三门槛层级提升）+ `:871` `rollback_promotion`（可回滚）；`contextualize_*` 语境化归位。入口 `md_cg/mcp_server.py:2201` 分派 `_consolidate_call`，action 枚举 `promote / promote_rollback / promote_history / induce / contextualize / contextualize_rollback / contextualize_history`。
-  - 另有**分支级**合并：`md_cg/branches.py` 的 `merge`（逐节点按 `branched_from` 溯源回写，`relation=merged_from`）——**是分支级而非节点级**，与本条目标不同层。
-  - **关键取证（决定落点）**：`md_cg/mdcg.py:2079-2080` 注释自陈「S3 图扩散激活……**为何：edges 一直只被写入、检索从不使用（审计偏差 1）**」→ **归并产生的成员边在检索面长期不可达**，即「合并可追溯」在**查询侧实际不成立**。
-- **建议落点**：**优先补读侧可达**（概念节点 ↔ 成员边的检索消费，S3 图扩散已部分在做——先确认其覆盖面是否已包含 `_link_concept` 产出的边类型）；**其次**再评估是否需要在结果节点落 `consolidated_into` 式显式指针字段——**须先答「字段 vs 边」的单一真源问题**（两者并存即双真源，违反仓内「真源唯一」纪律，可能反被判 REJECT）。gbrain 的字段指针形态与其 DB 行模型绑定，灵枢用结构化边表达同一语义**已是对等设计**，不可照搬字段。
-- **验收**：① 对既有 `induce` 产出的概念节点，断言「成员节点可经该边被检索/追溯到达」（口径可裁决、可复跑）；② 若新增字段，须断言与边**同源**（无第二真源）；③ 归并可回滚（`promote_rollback` 既有能力不得退化）；④ 全量回归零新增失败。
-- **落地状态（2026-09-19）：未开工** · 资格裁决=**ACCEPT，但落点与 gbrain 不同形**（依据：归并机制已在、边已写入、读侧不消费——缺口位置已由代码注释自证）。
-- **与缺口矩阵的关系**：本条与 `docs/theory/理论_机制_代码_实验_缺口矩阵_v0.1.md` **#27（P-T-92 睡眠整理/联想保留 → `consolidate.promote` 三门槛，状态 🟡「机制在，本仓无治理前后数字」）** 同一工作面——**标关系、不另立**：#27 管「整理是否有效」的度量，本条管「整理结果是否可见可追溯」。
-
-### ①P1 记忆动词协议冻结与 conformance 认证（third：有工具面、无契约承诺）
-
-- **gbrain 机制**：七动词 `recall / remember / entity / synthesize / forget` + `context_pack / delta` 构成**线缆协议**，与实现分离；冻结政策三条——① 字段名与语义**永久冻结**（不删/不改名/不改型）；② 新字段新动词**只增不破坏**（v1 客户端必须忽略未知字段）；③ `protocol_version` 只在破坏性变更时递增且政策预期「never」；枚举值属契约。任何实现同一协议者可经 `gbrain protocol conformance --target <endpoint>` **认证**（报告 §1–§2、§10 第 1 条）。另设 surface 阶梯 `verbs ⊆ starter(~27) ⊆ full`，monotonic 由测试钉死，**fail-closed**（隐藏操作被点名也返回 `unknown_tool`）。
-- **灵枢现状**（实测取证，**含对报告表述的修正**）：
-  - `MEMORY_VERBS` **全仓零命中** → 「记忆动词契约」概念确为空白。
-  - **修正报告的「无冻结承诺」更精确表述**：`PROTOCOL_VERSION` 存在但**语义不同**——`md_cg/mcp_server.py:48` 与 `md_cg/whitebox.py:51` 是 **MCP 传输协议版本**（JSON-RPC 侧），`md_cg/theory.py:38` 是**理论版本**（3.4）；三者**均非「记忆工具面契约版本」**。故本条缺口不是「没有版本号」，而是「**没有以工具面为对象的契约版本**」。
-  - 工具面**形态已在**：`mcp_server.py:499` `KERNEL_TOOLS`（2 基元 `cg`/`stg`）+ `:907` `ALL_TOOLS = KERNEL_TOOLS + TOOLS`（+31 细粒度）=33；`:908` `SURFACE = env MDCG_MCP_SURFACE`（默认 kernel）；`:912 tools_for_surface()` 经 `tool_face.slim_tools` 投影；`MDCG_TOOL_FACE=full` 关闭投影。
-  - **已有的守卫是「投影一致性」而非「跨版本只增」**：Pi① 已落地 `md_cg/tool_face.py`（投影真源）+ `md_cg/test_tool_face.py`（23 断言，含**工具名/参数名/顺序/required/类型/枚举值集逐位不变**）+ `cg(op=help)` 按需取回。该断言保证「瘦身前后契约不变」（**同一版本内**），**不含**「版本 A 的消费方在版本 B 下仍可用」的跨版本断言。
-  - **Pi⑤ 的 `conformance.py` 与本条要求同名不同物（必须区分，防误判已完成）**：`md_cg/conformance.py` 自陈为「**数据健康不变量断言集**」（答「数据是否失真」：混层比例/重复度/字段覆盖率/闸门分布），挂 `sustain._tick_conformance` 6h 节奏、超阈值**告警不自动改数据**；而 gbrain 的 conformance 是「**协议一致性认证**」（答「外部实现是否合规」）。**两者同名不同物，不得因前者存在而判本条已完成。**
-  - surface 阶梯**有形态差异**：灵枢 `SURFACE` 是**进程级 env**（部署时定档），gbrain 是**每客户端天花板**（服务端解析 `min(ceiling, client_row ?? default)`，可逐客户端收窄）。差异如实列出。
-- **建议落点**：`md_cg/` 新增**工具面契约真源**（建议形态：把 `KERNEL_TOOLS` + `op` 枚举 + 参数名/类型/枚举值集导出为**可版本化的契约清单**，与既有 `tool_face.py` 投影真源**共源不复制**）+ 契约断言集（跨版本只增：既有项不得消失/改名/改型；新增项允许；`op` 枚举只增）；`cg(op=help)` 出口可附契约版本。**⚠️ 前置裁决（不可跳过）**：先划定「冻结面」边界——冻结 **kernel 2 基元**（对外承诺面）还是含 full 31 工具（兼容/调试面）？**建议只冻结 kernel**：full 面在 Pi① 中已定位为「兼容与调试」，冻结它会锁死后续瘦身空间（与 Pi① 的投影层方向冲突）。此项须使用者裁决后再动工。
-- **验收**：① 契约清单可由管线生成（**禁止手工维护**——与「手写行号必腐化」同构）；② 断言「删除/改名任一冻结项」在测试中**必红**（反向注入探针，参考 cogmap 的单引号静默漏报守卫做法：正向与恢复双向断言）；③ 新增项不触发红灯（只增语义正确）；④ 既有 `test_tool_face` 23 断言与 MCP 回归零变化。
-- **落地状态（2026-09-19）：未开工** · 资格裁决=**ACCEPT**（依据：三端已是事实独立消费方，而现有守卫只覆盖同版本投影一致性；缺失维度=冻结面边界）。
-
-### ④P2 能力探测降级（fourth：裁决为 DEFER，先取证再动工）
-
-- **gbrain 机制**：`gbrain/src/core/capability.ts` 探测 embeddings 可用性 → `search: 'semantic' | 'keyword-only'`；无 key 时 **BM25 关键词检索完全可用**，加 OpenAI/Voyage key 升级语义检索（混合向量+关键词）。「keyless 先行、按需升级」是其 30k★ 体验的一部分（报告 §0、§6、§10 第 4 条）。
-- **灵枢现状**（实测取证）：
-  - `bm25` **全仓零命中**（区分大小写检索确认）——灵枢**没有 BM25**，其词法侧是 char-bigram 主链路 + 独立的中英归一原子 + Jaccard 路（`md_cg/semantic/REPRODUCE.md` 双语双路裁定）。
-  - 所有相关开关都是**部署期 env**，不是运行期探测：`MDCG_SEMANTIC`（`md_cg/mdcg.py:221-232` `semantic_on()`，注释「默认关闭零回归」）、`MDCG_EN_ATOMS`（`mdcg.py:235-301`，默认 `"0"`）、`MDCG_TOOL_FACE`、`MDCG_MCP_SURFACE`、`MDCG_S7_FRESHNESS`。
-  - **灵枢天然零依赖**（无 `requirements.txt` / `pyproject.toml`，主链路纯标准库）→ 「无 API key 完全可用」是**结构性的**，比 gbrain 的「keyless 先行」更彻底：gbrain 无 key 需**退**到 BM25，灵枢**根本不存在该调用**。
-  - **降级先例已在（但非探测）**：`mdcg.py:254` 注释「semantic 模块缺失时**静默降级**（不阻断主链路）」；`hive/exec.py` 有**零依赖探测**先例（PNG IHDR / JPEG SOF 读尺寸，不读像素）。
-- **建议落点**：**先取证，暂无落点**。真正可迁移的不是「检索降级」（无靶：问题本体是 gbrain 的 embedding 依赖），而是「**能力差异应自动判定而非部署期人工配置**」——即在**多端部署面**把 `MDCG_SEMANTIC` / `MDCG_EN_ATOMS` 一类开关改为「能力自动判定 + 显式覆盖」。但此改动的前提是：存在**真实受损场景**（使用者或某端因不知要开开关而实际损失召回）。
-- **验收（DEFER 的解除条件）**：先取证「semantic 路默认关闭导致的可感知召回损失」是否有实例（对齐 Pi⑦「取证结论：默认路径结构性已满足，未做无靶改动」的先例）。**有实例** → 落点=开关改能力自适应，验收=断言「能力可用且未显式覆盖时自动启用 + 显式 override 优先 + 能力探测失败静默降级不阻断」（须保持零依赖）；**无实例** → 本条结案为「**结构性已满足，不学**」，并把它写进 §4 反面清单的姊妹条（避免后续重复立项）。
-- **落地状态（2026-09-19）：未开工** · 资格裁决=**DEFER**（依据：capability.ts 解决的是灵枢不存在的问题本体；缺失维度=条件边界「谁是受损者」未取证；**不得为对齐外部做无靶改动**）。
-
-## 4. 反面清单（不学什么）
-
-> 素材来源：报告 §4（治理例外清单）、§5（HTTP/MCP 治理）、§8（多 agent 与信任边界）、§9（哲学对照表）。
-
-| 对方做法 | 为什么不学 | 灵枢对应原则 |
-|---|---|---|
-| **DB-only by design**：凭证 / `mcp_request_log` / 任务队列 / `raw_data` / `dream_verdicts`（30 天 TTL）/ withdrawal ledger / durable receipts / outbox 均只落 DB，不进 Markdown | 灵枢**真源唯一且是 md 文件**——主链路零 SQLite、派生索引可随时重建是架构决定；一旦开设「DB-only 例外清单」，例外会随需求扩张并最终使 md 真源名存实亡 | 真源唯一 · 派生可重建 · 主链路零外部依赖 |
-| **「DB-only for now」偷懒路径**（gbrain 用 CI 门程序化拦截「新增派生表持用户知识却不 FS-first」） | ——**这条不是不学，是学做法**：其价值在「**把偷懒路径做成机器红灯**」而非「人工评审记得拦」 | 与 `scripts/cogmap_sync.py check`（手写行号禁令 / 文件链接守卫）、`scripts/verify_discipline.py`（声明出口 strict）同构——**门禁化是仓内既有方针**，本条作为正面做法单列 |
-| **ambient writeback**（对话随口陈述自动写回知识库；默认关闭，公司脑永不开启） | 灵枢写路径已有三道闸（六要素校验 DEFER → 审核队列 / 冲突拦截 / REJECT 负记忆）；自动写回会让「未发现拒绝理由」冒充「确认适用」——灵枢已明确 REJECT 过同类设计 | 未验证不写入 · 写入须过闸门 · 判定归使用者 |
-| **队列 TTL 自动放行**（`dream_verdicts` 30 天过期即视为通过） | 灵枢已在审核队列议题上**显式 REJECT 过该候选**（理由：TTL 放行=「未发现拒绝理由冒充确认适用」）；裁决必须显式发生（`cg(op=review, decision, reason)`），不设静默过期 | 裁决显式化 · 未验证不固化 |
-| **信任外推**（哲学=「仓库即大脑，真源/备份/验证都推给用户自管」） | 灵枢的定位是**治理内置**（五层 + 条件论 + 白箱化）：结构强制可复算、revision 乐观并发、权限按 op 分档、审计留痕——把验证责任外推给使用者与「白箱化」方向直接冲突 | 治理内置 · 结构强制可复算 · 可审计 |
-| **单智能体笔记本定位**（gbrain 作者自述：单写入者假设，无多 agent 并发语义） | 灵枢是**蜂群互联**形态（hive Rust 并发调度 + `session`/`writer` 归属 + `branches` 实验分支隔离 + 互维心跳）；引入单写入者假设会击穿既有的归属与隔离语义 | 多会话归属 · 分支隔离 · 蜂群并发 |
-| **PGLite（嵌入式 Postgres/WASM）作为派生索引底座** | 灵枢主链路零依赖（无 `requirements.txt` / `pyproject.toml`）；为对齐其检索形态而引入 DB 运行时，会同时牺牲「零配置可跑」与「派生可重建」两条既有资产 | 零依赖 · 零配置可用 |
-| **BM25 词法引擎**（gbrain 无 key 时的检索引擎） | 灵枢词法侧已是 char-bigram 主链路 + 中英归一原子 + Jaccard 路（双语双路已裁定），加 BM25 属**同层第二实现**（对照 §3④：`bm25` 全仓零命中，问题本体不存在） | 单一真源 · 不设同层重复实现 |
-
-## 5. 与既有工作线的边界（防撞车）
-
-| 既有工作线 | 关系 | 处置 |
-|---|---|---|
-| **Pi 交接七项**（`docs/Pi可学习优点_灵枢大脑改进交接_20260915.md`） | 运行时/上下文工程面（fork、writepipe 钩子、工具瘦身、状态机、两段式、conformance 巡检、上下文组装），与本文件四条**无重叠** | 并行安全；**唯一接壤处**=本文件 §3① 与 Pi①（`tool_face` 投影）/ Pi⑤（`conformance.py`）——已在 §3① 显式区分「投影一致性守卫」与「协议一致性认证」，动工前**必须**先读那两处，避免误判已有 |
-| **缺口矩阵 `#27`（P-T-92 睡眠整理/联想保留）** | 与本文件 §3③ 同一工作面（`consolidate.promote` 三门槛） | **标关系、不另立**：矩阵管「整理有效性的度量」，本文件管「整理结果的可见与可追溯」 |
-| **缺口矩阵 §2-6（`mdcg.search` 重复实现清理）** | 与本文件 §3② 可能落在**同一函数面**（检索入口过滤） | ② 动工前先查该项是否已施工，避免双改冲突 |
-| **rust 只读检索核心（`rust/`，mdcgr 评测器）** | §3② 的有效期过滤若落在**读侧默认行为**，可能触发 py↔rust 镜像义务（既有口径：py 改动须确认是否落在 rust 已对齐的读侧默认行为域） | ② 施工前**必须**评估镜像义务；若默认开启则须同步 rust，否则 rust 侧召回口径与 python 漂移 |
-| **bench 口径（bench6 / LoCoMo 500）** | §3② 改动会改变召回集 | 若为 **opt-in 默认关闭**，bench 零漂移（对齐仓内既有惯例）；若转默认，须复跑并如实更新 README 对外数字（**数字未达标不动对外声明**） |
-| **在途未提交改动**（`README.md`、`docs/mdcg/功能调用映射表_v0.1.md`、`scripts/cogmap_sync.py`） | 与本文件无交集 | 施工轮次须与此三件隔离，避免混淆提交 |
-
-## 6. 建议施工顺序
-
-> 每步统一节奏：**实现 → 全量回归（模块方式）→ 灵枢归档（第 16 条）→ 看板/文档同步**。前置裁决未完成**不得**动工。
-
-1. **② 有效期进查询语义（P0，先裁后动）**
-   - 1a. **前置裁决**：`expired` 与 `not_yet` 是否同为用户不可召回？（建议：同为不可召回，但须 `unknown` 保持原样——否则旧库无时间戳节点会被静默排除）
-   - 1b. 落点实现：`mdcos._candidates` 一处过滤（与 `session=` / `branch=` 同构）+ `mdcg._candidates` 同步；**默认 opt-in**
-   - 1c. 回归 + 断言（§3② 验收四条）
-   - 1d. **rust 镜像义务评估** → 若涉默认行为则同步
-   - 1e. 归档 + 更新本文件落地状态
-2. **③ 巩固结果读侧可达（P0）**
-   - 先核 S3 图扩散对 `_link_concept` 边类型的覆盖面 → 补齐读侧可达 → 再评估是否需要显式指针字段（须过「单一真源」裁决）
-3. **① 工具面契约冻结（P1，须使用者裁决冻结面）**
-   - 划冻结面（建议仅 kernel 2 基元 + op 枚举）→ 契约清单管线化（禁手工）→ 只增断言 + 反向注入探针
-4. **④ 能力自适应（P2，先取证）**
-   - 取证受损场景 → 有则改「能力自动判定 + 显式覆盖」；无则结案「结构性已满足，不学」并回写 §4
-
-## 7. 快速上手（施工前一分钟自检）
-
-```bash
-# 0) 先读形态模板与素材（防版本不一致、防重新发明范式）
-#    docs/Pi可学习优点_灵枢大脑改进交接_20260915.md  §3 五段式 / §4 反面清单
-#    docs/GBrain记忆机制学习报告_供CodeBuddy端_20260914.md  §10 四条原文
-
-# 1) 复核四条现状基线（本文件 §3 各条「灵枢现状」的来源命令）
-#    grep 手法：搜索范围限定 md_cg/，逐条核对下列符号是否仍如本文件所述
-#      §3①  MEMORY_VERBS / PROTOCOL_VERSION / KERNEL_TOOLS / ALL_TOOLS / tools_for_surface
-#      §3②  valid_from / valid_until / trust.validity / _candidates 的过滤维度
-#      §3③  consolidated_at / consolidated_into / induce_memories / _link_concept
-#      §3④  bm25 / MDCG_SEMANTIC / MDCG_EN_ATOMS
-
-# 2) 回归（模块方式，勿用 pytest md_cg/）
-python -m md_cg.test_p2_mcp
-python -m md_cg.test_p33
-# …按改动面选套件；改动后须跑全量
-
-# 3) 收尾（第 16 条）：提炼核心修改 → cg(op=write) → cg(op=read) 读回确认
-```
-
----
-
-**交接摘要**：四条任务中 **②③ 为 P0 且证据充分**（确定性缺口，非相似度推断），**① 为 P1 但须先裁冻结面**，**④ 已裁 DEFER**（先取证，不得为对齐外部做无靶改动）。四条**均为未开工**——依 §1 完成度判据，动工前请重新取证而非信任本文件标注。
+# GBrain 可借鉴点 · 灵枢大脑改进交接文档
+
+> 交接方：CodeBuddy 端 · 接收方：**CodeBuddy 端后续施工轮次 / 其他端**
+> 交接时间：2026-09-19 · 依据：荣指令「GBrain 记忆机制学习报告也可以列新任务来补充功能了」
+> 素材：`docs/GBrain记忆机制学习报告_供CodeBuddy端_20260914.md`（自包含报告）· 源项目 gbrain（MIT，TypeScript/bun，30.1k★，本地参考克隆）
+> **本轮范围声明（重要）**：本文件**只出任务清单、不改代码**。四条任务的代码实施另立施工轮次，沿用 Pi 交接「先文档后施工」的既有节奏。
+
+---
+
+## 0. 一句话交接
+
+gbrain 把**「记忆如何变化」做成了数据模型的一等公民**——冻结的动词线缆协议、事实有效期双时间戳、巩固指针、能力探测降级；本文件将其 §10 四条可借鉴点逐项映射到灵枢大脑（`md_cg`）的落点，每项带 gbrain 源码证据、**本轮实测的灵枢现状基线**、建议落点与可裁决验收口径；并附「不学什么」反面清单（§4）与既有工作线边界（§5）。
+
+**本文件与 Pi 交接的分工**：Pi 交接（`docs/Pi可学习优点_灵枢大脑改进交接_20260915.md`）解决的是**运行时与上下文工程**（fork/钩子/瘦身/状态机/两段式/不变量巡检/组装细节）；本文件解决的是**记忆数据模型与接口契约**（协议冻结/有效期语义/巩固字段/能力降级）。两者无重叠面，可并行施工。
+
+## 1. 版本与落点纪律（⚠️ 防版本不一致，先读）
+
+| 仓 | 角色 | 本次改动落点 |
+|---|---|---|
+| `dsh-memory/` | **大脑 · 唯一主线** | ✅ **本文件全部改进落这里**（`md_cg/` 为主） |
+| `AEIS/` | 身体仓：记忆真源数据 + 可视化管线 | ❌ 不改代码 |
+| gbrain 源码克隆 | **只读参考件**（MIT，思想可吸收） | ❌ 不引入其运行时、不引依赖 |
+
+- 记忆真源 = md 文件（纯 md，主链路零 SQLite、零外部依赖）；`md_cg` 经 `--root`/`MDCG_ROOT`/datapath 访问，**不得**在 `md_cg` 内硬编码本机路径。
+- **gbrain 的存储形态不学**：其真源是 Markdown、派生索引在 PGLite（嵌入式 Postgres/WASM）。灵枢主链路**零 SQLite**是既有架构决定，只吸收其**数据模型与契约设计**，不引入任何 DB 依赖。
+- 改动后必须跑全量回归（`python -m md_cg.test_pXX` 形式）；测试只能模块方式跑，直接 `pytest md_cg/` 会崩（相对导入，已知缺陷）。
+- **引用纪律（内容政策）**：本文件所有 gbrain 侧证据一律以「**仓名 + 报告锚点行号**」引用（如「报告 §2 冻结政策」），**不写本机克隆绝对路径**；报告头部现有的本机路径不复制。
+
+> **完成度判据（沿用 Pi 交接 §3 纪律，同为本文件的硬约束）**：各项「落地状态」是**手工标注、无机械守卫**，历史上必滞后于代码（Pi 交接已实证：① ② ④ ⑥ 已入库而文档长期漏标，曾据「未标」误判未落地）。
+> **判断某项是否完成，请以认知图落地记录 + `git log` 提交取证为准**，本文件标注只作索引——与「手写行号必腐化」同构：无守卫的手工标注必漂移。
+> **本文件四条初始状态一律为「未开工」，依上纪律，动工前请先重新取证而非信任此标注。**
+
+## 2. gbrain 素材位置（查证入口）
+
+| 内容 | 位置（仓内可见） |
+|---|---|
+| 学习报告（主素材，自包含、逐条带源码锚点） | `docs/GBrain记忆机制学习报告_供CodeBuddy端_20260914.md` |
+| 四条可借鉴点原文 | 同上 **§10**（行号见 §3 各条「证据行」） |
+| 七动词协议与冻结政策 | 同上 §1–§2（对应 gbrain 仓 `gbrain/docs/protocol/MEMORY_VERBS_v1.md`、`gbrain/src/mcp/surface.ts`） |
+| 数据模型逐字段解剖 | 同上 §3（对应 gbrain 仓 `gbrain/src/core/migrate.ts:2395` 起建表语句） |
+| 能力探测两级降级 | 同上 §6（对应 gbrain 仓 `gbrain/src/core/capability.ts`） |
+| 巩固 / dream cycle | 同上 §7 |
+| 反面素材（治理/多 agent/哲学） | 同上 §4、§5、§8、§9 |
+| 动手验证清单（6 条复核路径） | 同上 §11 |
+
+## 3. 可借鉴点清单（按建议优先级排序）
+
+> 每条五段式：**gbrain 机制** → **灵枢现状**（2026-09-19 实测取证）→ **建议落点** → **验收** → **落地状态**。
+
+### ②★P0 事实有效期进入查询语义（highest：字段与判定已在，只差消费）
+
+- **gbrain 机制**：`facts` 表把「记忆的后半生」做成一等公民——`valid_from / valid_until / expired_at` 三戳表达有效期，「过期」由查询侧判定，不是人工清理任务（报告 §3 生命周期行、§10 第 2 条）。配套 `superseded_by BIGINT REFERENCES facts(id)` 自引用链：**纠错不是删除**。
+- **灵枢现状**（实测取证，逐条可复核）：
+  - 字段**已在**：`valid_from` / `valid_until` —— `md_cg/nodefile.py:122-123`（`VALID_FROM_FIELD` / `VALID_UNTIL_FIELD`，注释自陈「`valid_until` 既有（已被 scrub 的过期消费面使用）；`valid_from` 本轮补齐」）+ `md_cg/trust.py:61-62`（`FROM_FIELD` / `UNTIL_FIELD`）。
+  - **`expired_at` 在灵枢零命中**（全仓唯一命中即本报告自身）——灵枢以 `valid_until` + 验证态 `expired` 表达过期，**不设第三戳**。故本条的灵枢形态是「**双时间戳 + 状态**」，与 gbrain 的「双时间戳 + 过期戳」是**同构不同形**（差异如实列出，不视为缺陷）。
+  - 判定函数**已在**：`md_cg/trust.py:225-242` `validity(fm, now)` → `unknown / not_yet / active / expired` 四态。
+  - 消费面**只在治理/展示侧**：`trust.patrol`（`trust.py:500-524` 巡检粗判 expired/not_yet 清单出报表）、`md_cg/statushdr.py:77`（状态头展示）、`md_cg/coldverify.py:148`（冷启动复核转 expired 态）。
+  - **检索面零处理（关键缺口）**：`mdcg.search` / `mdcos.search_rrf` / `mdcos.recall` / `mdcg._candidates` / `mdcos._candidates` **均无 `validity` 调用**——`_candidates` 的过滤维度现有 layer / session / branch / roles，**没有有效期**。即：**过期节点仍会作为正常候选参与召回**。
+- **建议落点**：`md_cg/mdcos.py` 的 `_candidates`（一处过滤全链路生效，与既有 `session=` / `branch=` 过滤同构——该位置已被 Pi④ 验证为「改一处、search/search_rrf/recall 三签名透传」的正确落点）；`mdcg._candidates` 同步（子类覆盖，历史教训：首轮漏改被测试抓住）。**处置语义建议先出裁决再动手**：`expired` 与 `not_yet` 是否同等对待（gbrain 的三戳里 `expired_at` 与 `valid_until` 可分离，灵枢无第三戳 → 需明确「未生效」与「已过期」是否同为不可召回）。参数建议 **opt-in 开关注入**（对齐 `session=`/`branch=` 的「一处过滤全链路生效」与仓内「默认零回归」惯例）。
+- **验收**：① 断言 `validity=expired` 节点**不入候选池**（口径同 Pi④ 分支过滤：以「nid 不在命中集」为准，而非「结果为空」）；② `not_yet` 处置按裁决断言；③ `active` / `unknown` 节点召回**逐位不变**（零回归）；④ 全量回归零新增失败。
+- **落地状态（2026-09-19）：未开工** · 资格裁决=**ACCEPT**（依据：字段在+判定在+查询面缺位，「已有的判定函数无人消费」是确定性缺口，非相似度推断）。
+
+### ③★P0 巩固结果显式化与可追溯（second：已有归并，缺「可被查询看见」）
+
+- **gbrain 机制**：夜间 dream cycle 做「事实抽取 → 引用修复 → **合并** → 嵌入去重」，合并动作在 `facts` 上留下 `consolidated_at / consolidated_into BIGINT`——**合并可追溯**，且是**结果节点上的显式指针**（报告 §3 巩固行、§7）。
+- **灵枢现状**（实测取证）：
+  - `consolidated_at` / `consolidated_into` **全仓零命中**（唯一命中即本报告自身）。
+  - 归并机制**已在**：`md_cg/consolidate.py:1217` `induce_memories`（聚类归纳）+ `:1153` `_link_concept`（建**概念节点** + `edges` 成员边）+ `:1200` `_concept_payload`；`:799` `promote_memories`（三门槛层级提升）+ `:871` `rollback_promotion`（可回滚）；`contextualize_*` 语境化归位。入口 `md_cg/mcp_server.py:2201` 分派 `_consolidate_call`，action 枚举 `promote / promote_rollback / promote_history / induce / contextualize / contextualize_rollback / contextualize_history`。
+  - 另有**分支级**合并：`md_cg/branches.py` 的 `merge`（逐节点按 `branched_from` 溯源回写，`relation=merged_from`）——**是分支级而非节点级**，与本条目标不同层。
+  - **关键取证（决定落点）**：`md_cg/mdcg.py:2079-2080` 注释自陈「S3 图扩散激活……**为何：edges 一直只被写入、检索从不使用（审计偏差 1）**」→ **归并产生的成员边在检索面长期不可达**，即「合并可追溯」在**查询侧实际不成立**。
+- **建议落点**：**优先补读侧可达**（概念节点 ↔ 成员边的检索消费，S3 图扩散已部分在做——先确认其覆盖面是否已包含 `_link_concept` 产出的边类型）；**其次**再评估是否需要在结果节点落 `consolidated_into` 式显式指针字段——**须先答「字段 vs 边」的单一真源问题**（两者并存即双真源，违反仓内「真源唯一」纪律，可能反被判 REJECT）。gbrain 的字段指针形态与其 DB 行模型绑定，灵枢用结构化边表达同一语义**已是对等设计**，不可照搬字段。
+- **验收**：① 对既有 `induce` 产出的概念节点，断言「成员节点可经该边被检索/追溯到达」（口径可裁决、可复跑）；② 若新增字段，须断言与边**同源**（无第二真源）；③ 归并可回滚（`promote_rollback` 既有能力不得退化）；④ 全量回归零新增失败。
+- **落地状态（2026-09-19）：未开工** · 资格裁决=**ACCEPT，但落点与 gbrain 不同形**（依据：归并机制已在、边已写入、读侧不消费——缺口位置已由代码注释自证）。
+- **与缺口矩阵的关系**：本条与 `docs/theory/理论_机制_代码_实验_缺口矩阵_v0.1.md` **#27（P-T-92 睡眠整理/联想保留 → `consolidate.promote` 三门槛，状态 🟡「机制在，本仓无治理前后数字」）** 同一工作面——**标关系、不另立**：#27 管「整理是否有效」的度量，本条管「整理结果是否可见可追溯」。
+
+### ①P1 记忆动词协议冻结与 conformance 认证（third：有工具面、无契约承诺）
+
+- **gbrain 机制**：七动词 `recall / remember / entity / synthesize / forget` + `context_pack / delta` 构成**线缆协议**，与实现分离；冻结政策三条——① 字段名与语义**永久冻结**（不删/不改名/不改型）；② 新字段新动词**只增不破坏**（v1 客户端必须忽略未知字段）；③ `protocol_version` 只在破坏性变更时递增且政策预期「never」；枚举值属契约。任何实现同一协议者可经 `gbrain protocol conformance --target <endpoint>` **认证**（报告 §1–§2、§10 第 1 条）。另设 surface 阶梯 `verbs ⊆ starter(~27) ⊆ full`，monotonic 由测试钉死，**fail-closed**（隐藏操作被点名也返回 `unknown_tool`）。
+- **灵枢现状**（实测取证，**含对报告表述的修正**）：
+  - `MEMORY_VERBS` **全仓零命中** → 「记忆动词契约」概念确为空白。
+  - **修正报告的「无冻结承诺」更精确表述**：`PROTOCOL_VERSION` 存在但**语义不同**——`md_cg/mcp_server.py:48` 与 `md_cg/whitebox.py:51` 是 **MCP 传输协议版本**（JSON-RPC 侧），`md_cg/theory.py:38` 是**理论版本**（3.4）；三者**均非「记忆工具面契约版本」**。故本条缺口不是「没有版本号」，而是「**没有以工具面为对象的契约版本**」。
+  - 工具面**形态已在**：`mcp_server.py:499` `KERNEL_TOOLS`（2 基元 `cg`/`stg`）+ `:907` `ALL_TOOLS = KERNEL_TOOLS + TOOLS`（+31 细粒度）=33；`:908` `SURFACE = env MDCG_MCP_SURFACE`（默认 kernel）；`:912 tools_for_surface()` 经 `tool_face.slim_tools` 投影；`MDCG_TOOL_FACE=full` 关闭投影。
+  - **已有的守卫是「投影一致性」而非「跨版本只增」**：Pi① 已落地 `md_cg/tool_face.py`（投影真源）+ `md_cg/test_tool_face.py`（23 断言，含**工具名/参数名/顺序/required/类型/枚举值集逐位不变**）+ `cg(op=help)` 按需取回。该断言保证「瘦身前后契约不变」（**同一版本内**），**不含**「版本 A 的消费方在版本 B 下仍可用」的跨版本断言。
+  - **Pi⑤ 的 `conformance.py` 与本条要求同名不同物（必须区分，防误判已完成）**：`md_cg/conformance.py` 自陈为「**数据健康不变量断言集**」（答「数据是否失真」：混层比例/重复度/字段覆盖率/闸门分布），挂 `sustain._tick_conformance` 6h 节奏、超阈值**告警不自动改数据**；而 gbrain 的 conformance 是「**协议一致性认证**」（答「外部实现是否合规」）。**两者同名不同物，不得因前者存在而判本条已完成。**
+  - surface 阶梯**有形态差异**：灵枢 `SURFACE` 是**进程级 env**（部署时定档），gbrain 是**每客户端天花板**（服务端解析 `min(ceiling, client_row ?? default)`，可逐客户端收窄）。差异如实列出。
+- **建议落点**：`md_cg/` 新增**工具面契约真源**（建议形态：把 `KERNEL_TOOLS` + `op` 枚举 + 参数名/类型/枚举值集导出为**可版本化的契约清单**，与既有 `tool_face.py` 投影真源**共源不复制**）+ 契约断言集（跨版本只增：既有项不得消失/改名/改型；新增项允许；`op` 枚举只增）；`cg(op=help)` 出口可附契约版本。**⚠️ 前置裁决（不可跳过）**：先划定「冻结面」边界——冻结 **kernel 2 基元**（对外承诺面）还是含 full 31 工具（兼容/调试面）？**建议只冻结 kernel**：full 面在 Pi① 中已定位为「兼容与调试」，冻结它会锁死后续瘦身空间（与 Pi① 的投影层方向冲突）。此项须使用者裁决后再动工。
+- **验收**：① 契约清单可由管线生成（**禁止手工维护**——与「手写行号必腐化」同构）；② 断言「删除/改名任一冻结项」在测试中**必红**（反向注入探针，参考 cogmap 的单引号静默漏报守卫做法：正向与恢复双向断言）；③ 新增项不触发红灯（只增语义正确）；④ 既有 `test_tool_face` 23 断言与 MCP 回归零变化。
+- **落地状态（2026-09-19）：未开工** · 资格裁决=**ACCEPT**（依据：三端已是事实独立消费方，而现有守卫只覆盖同版本投影一致性；缺失维度=冻结面边界）。
+
+### ④P2 能力探测降级（fourth：裁决为 DEFER，先取证再动工）
+
+- **gbrain 机制**：`gbrain/src/core/capability.ts` 探测 embeddings 可用性 → `search: 'semantic' | 'keyword-only'`；无 key 时 **BM25 关键词检索完全可用**，加 OpenAI/Voyage key 升级语义检索（混合向量+关键词）。「keyless 先行、按需升级」是其 30k★ 体验的一部分（报告 §0、§6、§10 第 4 条）。
+- **灵枢现状**（实测取证）：
+  - `bm25` **全仓零命中**（区分大小写检索确认）——灵枢**没有 BM25**，其词法侧是 char-bigram 主链路 + 独立的中英归一原子 + Jaccard 路（`md_cg/semantic/REPRODUCE.md` 双语双路裁定）。
+  - 所有相关开关都是**部署期 env**，不是运行期探测：`MDCG_SEMANTIC`（`md_cg/mdcg.py:221-232` `semantic_on()`，注释「默认关闭零回归」）、`MDCG_EN_ATOMS`（`mdcg.py:235-301`，默认 `"0"`）、`MDCG_TOOL_FACE`、`MDCG_MCP_SURFACE`、`MDCG_S7_FRESHNESS`。
+  - **灵枢天然零依赖**（无 `requirements.txt` / `pyproject.toml`，主链路纯标准库）→ 「无 API key 完全可用」是**结构性的**，比 gbrain 的「keyless 先行」更彻底：gbrain 无 key 需**退**到 BM25，灵枢**根本不存在该调用**。
+  - **降级先例已在（但非探测）**：`mdcg.py:254` 注释「semantic 模块缺失时**静默降级**（不阻断主链路）」；`hive/exec.py` 有**零依赖探测**先例（PNG IHDR / JPEG SOF 读尺寸，不读像素）。
+- **建议落点**：**先取证，暂无落点**。真正可迁移的不是「检索降级」（无靶：问题本体是 gbrain 的 embedding 依赖），而是「**能力差异应自动判定而非部署期人工配置**」——即在**多端部署面**把 `MDCG_SEMANTIC` / `MDCG_EN_ATOMS` 一类开关改为「能力自动判定 + 显式覆盖」。但此改动的前提是：存在**真实受损场景**（使用者或某端因不知要开开关而实际损失召回）。
+- **验收（DEFER 的解除条件）**：先取证「semantic 路默认关闭导致的可感知召回损失」是否有实例（对齐 Pi⑦「取证结论：默认路径结构性已满足，未做无靶改动」的先例）。**有实例** → 落点=开关改能力自适应，验收=断言「能力可用且未显式覆盖时自动启用 + 显式 override 优先 + 能力探测失败静默降级不阻断」（须保持零依赖）；**无实例** → 本条结案为「**结构性已满足，不学**」，并把它写进 §4 反面清单的姊妹条（避免后续重复立项）。
+- **落地状态（2026-09-19）：未开工** · 资格裁决=**DEFER**（依据：capability.ts 解决的是灵枢不存在的问题本体；缺失维度=条件边界「谁是受损者」未取证；**不得为对齐外部做无靶改动**）。
+
+## 4. 反面清单（不学什么）
+
+> 素材来源：报告 §4（治理例外清单）、§5（HTTP/MCP 治理）、§8（多 agent 与信任边界）、§9（哲学对照表）。
+
+| 对方做法 | 为什么不学 | 灵枢对应原则 |
+|---|---|---|
+| **DB-only by design**：凭证 / `mcp_request_log` / 任务队列 / `raw_data` / `dream_verdicts`（30 天 TTL）/ withdrawal ledger / durable receipts / outbox 均只落 DB，不进 Markdown | 灵枢**真源唯一且是 md 文件**——主链路零 SQLite、派生索引可随时重建是架构决定；一旦开设「DB-only 例外清单」，例外会随需求扩张并最终使 md 真源名存实亡 | 真源唯一 · 派生可重建 · 主链路零外部依赖 |
+| **「DB-only for now」偷懒路径**（gbrain 用 CI 门程序化拦截「新增派生表持用户知识却不 FS-first」） | ——**这条不是不学，是学做法**：其价值在「**把偷懒路径做成机器红灯**」而非「人工评审记得拦」 | 与 `scripts/cogmap_sync.py check`（手写行号禁令 / 文件链接守卫）、`scripts/verify_discipline.py`（声明出口 strict）同构——**门禁化是仓内既有方针**，本条作为正面做法单列 |
+| **ambient writeback**（对话随口陈述自动写回知识库；默认关闭，公司脑永不开启） | 灵枢写路径已有三道闸（六要素校验 DEFER → 审核队列 / 冲突拦截 / REJECT 负记忆）；自动写回会让「未发现拒绝理由」冒充「确认适用」——灵枢已明确 REJECT 过同类设计 | 未验证不写入 · 写入须过闸门 · 判定归使用者 |
+| **队列 TTL 自动放行**（`dream_verdicts` 30 天过期即视为通过） | 灵枢已在审核队列议题上**显式 REJECT 过该候选**（理由：TTL 放行=「未发现拒绝理由冒充确认适用」）；裁决必须显式发生（`cg(op=review, decision, reason)`），不设静默过期 | 裁决显式化 · 未验证不固化 |
+| **信任外推**（哲学=「仓库即大脑，真源/备份/验证都推给用户自管」） | 灵枢的定位是**治理内置**（五层 + 条件论 + 白箱化）：结构强制可复算、revision 乐观并发、权限按 op 分档、审计留痕——把验证责任外推给使用者与「白箱化」方向直接冲突 | 治理内置 · 结构强制可复算 · 可审计 |
+| **单智能体笔记本定位**（gbrain 作者自述：单写入者假设，无多 agent 并发语义） | 灵枢是**蜂群互联**形态（hive Rust 并发调度 + `session`/`writer` 归属 + `branches` 实验分支隔离 + 互维心跳）；引入单写入者假设会击穿既有的归属与隔离语义 | 多会话归属 · 分支隔离 · 蜂群并发 |
+| **PGLite（嵌入式 Postgres/WASM）作为派生索引底座** | 灵枢主链路零依赖（无 `requirements.txt` / `pyproject.toml`）；为对齐其检索形态而引入 DB 运行时，会同时牺牲「零配置可跑」与「派生可重建」两条既有资产 | 零依赖 · 零配置可用 |
+| **BM25 词法引擎**（gbrain 无 key 时的检索引擎） | 灵枢词法侧已是 char-bigram 主链路 + 中英归一原子 + Jaccard 路（双语双路已裁定），加 BM25 属**同层第二实现**（对照 §3④：`bm25` 全仓零命中，问题本体不存在） | 单一真源 · 不设同层重复实现 |
+
+## 5. 与既有工作线的边界（防撞车）
+
+| 既有工作线 | 关系 | 处置 |
+|---|---|---|
+| **Pi 交接七项**（`docs/Pi可学习优点_灵枢大脑改进交接_20260915.md`） | 运行时/上下文工程面（fork、writepipe 钩子、工具瘦身、状态机、两段式、conformance 巡检、上下文组装），与本文件四条**无重叠** | 并行安全；**唯一接壤处**=本文件 §3① 与 Pi①（`tool_face` 投影）/ Pi⑤（`conformance.py`）——已在 §3① 显式区分「投影一致性守卫」与「协议一致性认证」，动工前**必须**先读那两处，避免误判已有 |
+| **缺口矩阵 `#27`（P-T-92 睡眠整理/联想保留）** | 与本文件 §3③ 同一工作面（`consolidate.promote` 三门槛） | **标关系、不另立**：矩阵管「整理有效性的度量」，本文件管「整理结果的可见与可追溯」 |
+| **缺口矩阵 §2-6（`mdcg.search` 重复实现清理）** | 与本文件 §3② 可能落在**同一函数面**（检索入口过滤） | ② 动工前先查该项是否已施工，避免双改冲突 |
+| **rust 只读检索核心（`rust/`，mdcgr 评测器）** | §3② 的有效期过滤若落在**读侧默认行为**，可能触发 py↔rust 镜像义务（既有口径：py 改动须确认是否落在 rust 已对齐的读侧默认行为域） | ② 施工前**必须**评估镜像义务；若默认开启则须同步 rust，否则 rust 侧召回口径与 python 漂移 |
+| **bench 口径（bench6 / LoCoMo 500）** | §3② 改动会改变召回集 | 若为 **opt-in 默认关闭**，bench 零漂移（对齐仓内既有惯例）；若转默认，须复跑并如实更新 README 对外数字（**数字未达标不动对外声明**） |
+| **在途未提交改动**（`README.md`、`docs/mdcg/功能调用映射表_v0.1.md`、`scripts/cogmap_sync.py`） | 与本文件无交集 | 施工轮次须与此三件隔离，避免混淆提交 |
+
+## 6. 建议施工顺序
+
+> 每步统一节奏：**实现 → 全量回归（模块方式）→ 灵枢归档（第 16 条）→ 看板/文档同步**。前置裁决未完成**不得**动工。
+
+1. **② 有效期进查询语义（P0，先裁后动）**
+   - 1a. **前置裁决**：`expired` 与 `not_yet` 是否同为用户不可召回？（建议：同为不可召回，但须 `unknown` 保持原样——否则旧库无时间戳节点会被静默排除）
+   - 1b. 落点实现：`mdcos._candidates` 一处过滤（与 `session=` / `branch=` 同构）+ `mdcg._candidates` 同步；**默认 opt-in**
+   - 1c. 回归 + 断言（§3② 验收四条）
+   - 1d. **rust 镜像义务评估** → 若涉默认行为则同步
+   - 1e. 归档 + 更新本文件落地状态
+2. **③ 巩固结果读侧可达（P0）**
+   - 先核 S3 图扩散对 `_link_concept` 边类型的覆盖面 → 补齐读侧可达 → 再评估是否需要显式指针字段（须过「单一真源」裁决）
+3. **① 工具面契约冻结（P1，须使用者裁决冻结面）**
+   - 划冻结面（建议仅 kernel 2 基元 + op 枚举）→ 契约清单管线化（禁手工）→ 只增断言 + 反向注入探针
+4. **④ 能力自适应（P2，先取证）**
+   - 取证受损场景 → 有则改「能力自动判定 + 显式覆盖」；无则结案「结构性已满足，不学」并回写 §4
+
+## 7. 快速上手（施工前一分钟自检）
+
+```bash
+# 0) 先读形态模板与素材（防版本不一致、防重新发明范式）
+#    docs/Pi可学习优点_灵枢大脑改进交接_20260915.md  §3 五段式 / §4 反面清单
+#    docs/GBrain记忆机制学习报告_供CodeBuddy端_20260914.md  §10 四条原文
+
+# 1) 复核四条现状基线（本文件 §3 各条「灵枢现状」的来源命令）
+#    grep 手法：搜索范围限定 md_cg/，逐条核对下列符号是否仍如本文件所述
+#      §3①  MEMORY_VERBS / PROTOCOL_VERSION / KERNEL_TOOLS / ALL_TOOLS / tools_for_surface
+#      §3②  valid_from / valid_until / trust.validity / _candidates 的过滤维度
+#      §3③  consolidated_at / consolidated_into / induce_memories / _link_concept
+#      §3④  bm25 / MDCG_SEMANTIC / MDCG_EN_ATOMS
+
+# 2) 回归（模块方式，勿用 pytest md_cg/）
+python -m md_cg.test_p2_mcp
+python -m md_cg.test_p33
+# …按改动面选套件；改动后须跑全量
+
+# 3) 收尾（第 16 条）：提炼核心修改 → cg(op=write) → cg(op=read) 读回确认
+```
+
+---
+
+**交接摘要**：四条任务中 **②③ 为 P0 且证据充分**（确定性缺口，非相似度推断），**① 为 P1 但须先裁冻结面**，**④ 已裁 DEFER**（先取证，不得为对齐外部做无靶改动）。四条**均为未开工**——依 §1 完成度判据，动工前请重新取证而非信任本文件标注。