@furongjun1999/dsh-memory 0.4.4 → 0.4.5

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

@@ -1,7 +1,7 @@
 # md_cg · 记忆操作系统（Memory OS）· 实现与接入
 
 > 在 MdCG（P0/P1 已验证引擎）之上补齐「记忆操作系统」能力，并暴露为 MCP 服务。
-> 2026-09-08 · 全部经 dsh 端独立实跑验证
+> 2026-09-09 · 全部经 dsh 端独立实跑验证
 
 ---
 
@@ -9,12 +9,20 @@
 
 | 文件 | 职责 |
 |---|---|
-| `md_cg/mdcos.py` | **MdCGOS**：在 MdCG 上新增 7 项记忆 OS 能力 |
-| `md_cg/mcp_server.py` | **MCP server**（stdio + JSON-RPC 2.0，协议 2024-11-05，17 工具，零依赖）|
-| `md_cg/test_p2.py` | P2 验收（7 项能力）**31/31** |
-| `md_cg/test_p2_mcp.py` | MCP 协议验收 **23/23** |
+| `md_cg/mdcos.py` | **MdCGOS**：在 MdCG 上新增记忆 OS 能力（7 项 + 后续 P8–P11） |
+| `md_cg/mcp_server.py` | **MCP server**（stdio + JSON-RPC 2.0，协议 2024-11-05，零依赖）；**默认只暴露 2 个认知基元 `cg`/`stg`**（`MDCG_MCP_SURFACE=full` 才另见 29 个细粒度工具，供兼容/调试）|
+| `md_cg/consistency.py` | **节点间自动冲突检测**（三级决策：情绪 → 反思 → 递归反思）· 冲突自动触发飞轮 · **已接入 `cg(op=write)` 写入前校验** |
+| `md_cg/test_p2.py` | P2 验收（7 项能力）**36/36** |
+| `md_cg/test_p2_mcp.py` | MCP 协议验收 **63/63** |
 
-回归：**P0 25/25 · P1 37/37 仍全绿**（未修改 MdCG 既有语义）。
+回归：**P0 25 · P1 37 · P2 36 · P2-MCP 63 · P3 33 · P4 44 · P5 36 · P6 72 · P7 36 ·
+P8 34 · P9 37 · P10 24 · P11 27 · P12 32 · P13 42 · P14 44 · P15 53 · P16 46 · P17 55 ·
+并发锁 300/300 全绿（共 776 项）**。
+
+> **2026-09-10 增补（md_cg 唯一真源）**：白箱 LLM provider 下线、AEIS 降为**能力库**；
+> 新增 `md_cg/whitebox.py`（`cg(op=whitebox)` 显式调用白箱并验证其「编码 / 已有知识回答」能力，
+> P18 **20/20**）与 `md_cg/migrate_roleplay.py`（角色/转录/互维 → 认知图，P19 **13/13**）。
+> **功能 → 代码 全表见 [功能调用映射表_v0.1.md](功能调用映射表_v0.1.md)。**
 
 ---
 
@@ -39,9 +47,10 @@
 ### 3.1 启动
 
 ```bash
-MDCG_ROOT="D:/Program Files/2_ai/AEIS/data/mdcg" \
+# 在仓库根目录启动：路径全部相对当前目录，无需改任何绝对路径
+MDCG_ROOT="data/mdcg" \
 MDCG_ACTOR="dsh" \
-PYTHONPATH="D:/Program Files/2_ai/dsh-memory/llm-adapter-poc" \
+PYTHONPATH="." \
 python -m md_cg.mcp_server
 ```
 
@@ -54,29 +63,87 @@ python -m md_cg.mcp_server
     command: python
     args: ["-m", "md_cg.mcp_server"]
     env:
-      MDCG_ROOT: "D:/Program Files/2_ai/AEIS/data/mdcg"
+      MDCG_ROOT: "data/mdcg"      # 相对 DSH 进程 cwd；cwd 不稳定时改成绝对路径
       MDCG_ACTOR: "dsh"
-      PYTHONPATH: "D:/Program Files/2_ai/dsh-memory/llm-adapter-poc"
+      PYTHONPATH: "."             # 需在仓库根目录启动 DSH，python 才能 import md_cg
 ```
 
-### 3.3 工具面（17）
+### 3.3 工具面（默认 kernel：只暴露 `cg` / `stg` 两个认知基元）
+
+> **架构**：对外只提供**认知图**工具。`cg(op=route)` 按情境条件路由，返回知识 +
+> **建议能力名（不执行）**，由调用方用本地代码执行——「认知图只给能力名，执行权归调用方」。
+> 下列 29 个细粒度工具仅在 `MDCG_MCP_SURFACE=full` 时可见，供兼容/调试。
 
 ```
-写：mdcg_remember · mdcg_rejected · mdcg_unresolved · mdcg_propose
-读：mdcg_get · mdcg_search · mdcg_recall · mdcg_review_list
-认知：mdcg_reflect · mdcg_verify · mdcg_flywheel · mdcg_mine_fix_pairs
-生命周期：mdcg_forget · mdcg_restore · mdcg_review_decide
-运维：mdcg_health · mdcg_service_info
+写：mdcg_remember（gated=true 走主动遗忘闸门；consistency=true 走冲突检测）·
+    mdcg_rejected · mdcg_unresolved · mdcg_propose
+读：mdcg_get · mdcg_search · mdcg_recall · mdcg_review_list · mdcg_review_records
+认知：mdcg_reflect · mdcg_verify · mdcg_flywheel · mdcg_mine_fix_pairs ·
+    mdcg_consistency（check/history/stats/catalog）·
+    mdcg_metacognition（观测面/校准/盲区/信任/self_check）·
+    mdcg_predict（routes/feedback/stats/catalog）·
+    mdcg_causal（path/gate/chain/explain/catalog）
+生命周期：mdcg_forget（override）· mdcg_restore · mdcg_review_decide
+保护/遗忘：mdcg_protect（盘点/查询/标记/快照/历史）· mdcg_forgetting_history
+身份识别：mdcg_identity（observe/anchor/trait/profile/positions/catalog）
+自我状态：mdcg_self_state（snapshot/refresh/bootstrap/relate/relations/index/
+    dimensions/audit/history/summary/catalog）
+运维：mdcg_health · mdcg_whoami · mdcg_ingest · mdcg_watermarks · mdcg_service_info
+能力库：mdcg_whitebox（ask/remember/verify_encoding/verify_existing/ping/report）
 ```
 
+写保护：`self` / `anchor` 层与 `protected` 标记、`importance≥0.7` 的节点**不可遗忘**，
+删除/降级需显式 `override=true`（自动快照 + `_protected_audit.jsonl` 留痕）。
+
+**白箱能力库**（`cg(op=whitebox)`，`md_cg/whitebox.py`，2026-09-10）：
+白箱 LLM provider 已下线（不再注册 `lingshu-whitebox`）；白箱能力改由 md_cg 显式调用并留痕：
+`action=ask` 问答 · `remember` 编码 · `verify_encoding` 验证编码能力（口令→追问命中）·
+`verify_existing` 验证已有知识回答能力（`route=self` 且非空）· `ping` · `report`。
+结论写回 `self` 层（`tags` 含 `whitebox:verify`）。详见
+[功能调用映射表_v0.1.md](功能调用映射表_v0.1.md) §3。
+
+**持续性自维持**（`cg(op=sustain)`，P14 `sustain.py`）：
+心跳戳（`~/.mdcg/sustain/heartbeat.<name>.stamp`，含 ts / pid / uptime / task_running）
+→ 分级判定（2.5× / 3.5× 心跳间隔；**任务执行中阈值放宽**，长任务不被误判死亡）
+→ 只读诊断（索引漂移 / 孤儿索引 / 陈旧临时文件 / 半截日志行 / 增量积压 / 缺密钥私有节点）
+→ 自愈（只重建索引、清陈旧临时、补日志换行——**永不删节点**；缺密钥只报告不修）
+→ 会话水位续接（`_sessions.json` 记 (last_t, last_seq, events)，重启不重复摄取）。
+MCP 进程启动即自维持（`MDCG_SUSTAIN=0` 关闭；`MDCG_SUSTAIN_BEAT/HEAL` 调间隔）。
+
+主动遗忘闸门（写入侧三问 → 四态）：重复？→ `redundancy`；重要？→ `importance`；
+惊奇？→ 自信息代理 `-log2(dup+ε)`（结构类比量，非香农熵）。裁决
+`ACCEPT / MERGE / DROP / DEFER` 全部写入 `_forgetting.jsonl`，可审计。
+
+身份特征识别（取代单一「用户画像」）：识别每个主体（`self` / `user` / `role` / `agent`）
+的**身份锚点 + 位置效应 + 条件特征**。位置效应取自智能论 v3.4 §十三 五大单元
+（记录=全 / 反思=新 / 验证=稳 / 输出=通 / 维生=存），按行为证据投票推断，
+返回 `confidence / votes / evidence_count`，可审计「为什么判成这个位置」。
+扮演论三接口：`memory`（历史证据→知识层）/ `anchor`（身份锚点→self|anchor 层，
+不可遗忘；`role` 不得进 self 层）/ `values`（条件特征→结构层，条件空间即触发时机）。
+留痕 `_identity.jsonl`。
+
+节点间自动冲突检测（信息写入前校验 · 三级决策）：`md_cg/consistency.py`。
+**L0 情绪** = 信息差二阶变化 d²D/dt²（approaching / stable / avoiding；原文强制
+**独立通道，不参与信任/资格计算**，只做流程调度）→ **L1 反思** = 条件论「反题」
+检测（自否定 / 违反纪律 / 条件互斥）→ 四态路由 **ACCEPT / REJECT / DEFER / BLINDSPOT**
+→ **L2 递归反思**（沿关系链找「区分条件」，受**深度 / 节点数 / 循环 / 信息增益门槛**
+约束，智能论 :273：「若递归没有减少候选空间，就不应继续搜索」）。
+冲突**自动触发知识飞轮**（误差 → 补条件 → 结构更新，:725），落 `unresolved` 条目；
+留痕 `_consistency.jsonl`，可审计「为什么冲突 / 为什么放行」。
+写入侧：`mdcg_remember(consistency=true)` 默认校验，`on_conflict=reject|defer|record`。
+诚实边界：**条件级（结构化）冲突检测，非语义蕴含证明**；无法建立比对路径时返回
+BLINDSPOT，不假装确定。
+
 ### 3.4 典型调用序列
 
 ```text
 会话开始   → mdcg_recall(query=用户请求, budget_tokens=1200)
+情景写入   → mdcg_remember(content, gated=true)       # 三问→四态筛选
 重要判断   → mdcg_search(query, context=当前情境)     # 拿 state（四态）
 踩坑/修好  → mdcg_mine_fix_pairs(events)              # 自动沉淀负记忆 + 修复知识
 新知识候选 → mdcg_propose(...) → 人工/agent 审核 → mdcg_review_decide
 需要清理   → mdcg_forget(id, reason) → 审计可查
+保护审计   → mdcg_protect(action=stats|check) / mdcg_forgetting_history
 ```
 
 ---
@@ -84,12 +151,21 @@ python -m md_cg.mcp_server
 ## 四、验证命令
 
 ```bash
-cd "D:/Program Files/2_ai/dsh-memory/llm-adapter-poc"
+cd <dsh-memory 仓库根目录>
 set PYTHONPATH=.
-python -m md_cg.test_p2        # 31/31  七项能力
-python -m md_cg.test_p2_mcp    # 23/23  MCP 协议
-python -m md_cg.test_p0        # 25/25  回归
-python -m md_cg.test_p1        # 37/37  回归
+python -m md_cg.test_p0        # 25/25  引擎基线回归
+python -m md_cg.test_p1        # 37/37  白箱架构回归
+python -m md_cg.test_p2        # 36/36  七项 OS 能力
+python -m md_cg.test_p2_mcp    # 63/63  MCP 协议端到端
+python -m md_cg.test_p3        # 33/33  权限 + 设备驱动
+python -m md_cg.test_p4_fuzzy  # 44/44  模糊检索
+python -m md_cg.test_p5_semantic       # 36/36  语义路
+python -m md_cg.test_p6_consolidate    # 72/72  固化
+python -m md_cg.test_p7_goals_recent   # 36/36  目标 / 近期
+python -m md_cg.test_p8_subgraph_chain # 34/34  子图 / 关系链
+python -m md_cg.test_p9_forget_protect # 37/37  主动遗忘 / 写保护
+python -m md_cg.test_p10_identity      # 24/24  身份特征识别
+python -m md_cg.test_p11_consistency   # 27/27  节点间冲突检测（三级决策）
 ```
 
 ---
@@ -104,8 +180,8 @@ python -m md_cg.test_p1        # 37/37  回归
 | 审核 | — | inbox→decisions（含 edit/merge）| **✅ 含 edit/merge** |
 | 隐私 | 索引时 redact | 敏感度+墓碑+payload-free | **✅ tombstone + 恢复检查 + payload-free** |
 | 预算控制 | budgeted digest | budget-driven pack | **✅ 跳过超大** |
-| 系统调用面 | 单二进制 | MCP stdio | **✅ MCP stdio（17 工具）** |
-| 独有 | — | — | **条件路由 + 资格四态 + CCG 五要素 + 信息差 D/d²D + 飞轮** |
+| 系统调用面 | 单二进制 | MCP stdio | **✅ MCP stdio（默认 2 个认知基元 cg/stg）** |
+| 独有 | — | — | **条件路由 + 资格四态 + CCG 五要素 + 信息差 D/d²D + 飞轮 + 三级冲突检测（情绪/反思/递归反思）** |
 
 ---
 
@@ -127,6 +203,19 @@ python -m md_cg.test_p1        # 37/37  回归
 | **夹紧** | `principal_for(tenant)` 把调用方 clearance 夹到租户上限（不能越租户） |
 | **审计** | 每条审计带 `tenant / session / clearance`（可追溯到哪个会话做了什么） |
 
+**私有内容加密（`md_cg/crypto.py` + `MdCGSecure`）**：
+
+| 机制 | 说明 |
+|---|---|
+| **加密范围** | 仅 `private` / `secret` 节点正文加密；`public` / `internal` 保持明文（可正常全文检索） |
+| **算法** | ChaCha20-Poly1305（RFC 8439）纯标准库实现，延续「核心零外部依赖」约束 |
+| **密钥层级** | KEK（`MDCG_MASTER_KEY` → `~/.mdcg/master.key`，缺失自动生成、0600、**在仓库外**）→ 包裹 → DEK（每 `tenant\|actor` 一把，存 `_keys.json`） |
+| **身份一致性** | 节点 AAD = `mdcg-node\|v\|tenant\|actor\|node_id`：换身份 / 跨节点挪用 / 换 KEK 一律解密失败 |
+| **密钥即访问权** | fail-closed：无密钥不降级明文——读按「不可见」处理，写 `private`/`secret` 直接拒绝 |
+| **统一写盘口** | 所有节点写入经 `_write_node`（先封装再原子写），杜绝 `get()` 解密后的明文被回写降级 |
+| **密文不检索** | 密文不参与全文索引，无密钥者只能走元数据；固化时密文节点跳过（不二次加密） |
+| **审计** | `_crypto.jsonl` 只记事件与指纹（`kek_fp` / `id_fp`），不含载荷 |
+
 MCP 侧通过环境变量配置：
 ```yaml
 env:
@@ -163,9 +252,20 @@ MCP 工具：`mdcg_ingest`（`source=auto` 自动发现本机 DSH 会话）、`m
 |---|---|---|
 | `test_p0` | 引擎基线（分桶/回退阶梯/只读契约/并发） | **25/25** |
 | `test_p1` | 白箱架构 9 维 | **37/37** |
-| `test_p2` | 七项 OS 能力 | **31/31** |
+| `test_p2` | 七项 OS 能力 | **36/36** |
+| `test_p2_mcp` | MCP 协议端到端（含权限/摄取/冲突拦截） | **63/63** |
 | `test_p3` | #2 权限 + #3 设备驱动 | **33/33** |
-| `test_p2_mcp` | MCP 协议端到端（含权限/摄取） | **29/29** |
+| `test_p4_fuzzy` | 模糊检索 | **44/44** |
+| `test_p5_semantic` | 语义路 | **36/36** |
+| `test_p6_consolidate` | 固化 | **72/72** |
+| `test_p7_goals_recent` | 目标 / 近期记忆 | **36/36** |
+| `test_p8_subgraph_chain` | 子图 / 关系链 | **34/34** |
+| `test_p9_forget_protect` | 主动遗忘 / 写保护 | **37/37** |
+| `test_p10_identity` | 身份特征识别 | **24/24** |
+| `test_p11_consistency` | **节点间冲突检测（三级决策）** | **27/27** |
+| `test_p12_metacognition` | 元认知 / 反思回路 | **32/32** |
+| `test_p13_encryption` | 私有内容加密 / 身份一致性 | **42/42** |
+| `test_p14_sustain` | **持续性自维持（心跳 / 自愈 / 会话续接）** | **44/44** |
 
 ---
 
@@ -173,6 +273,9 @@ MCP 工具：`mdcg_ingest`（`source=auto` 自动发现本机 DSH 会话）、`m
 
 1. **单一权威存储**：AEIS 私有记忆迁移 —— **暂缓**（开源仓库不能承载私有内容；
    须等私有租户根（仓库外）就绪后再做）。
-2. **常驻服务**：会话/心跳/自愈（当前 MCP 进程已常驻，缺心跳与重启策略）。
+2. ~~**常驻服务**：会话/心跳/自愈~~ —— **已完成（P14 `sustain.py`）**：
+   心跳戳 + 分级判定（任务中阈值放宽）→ 只读诊断 → 自愈（索引/临时文件/日志边界，
+   **永不删节点**）→ 会话水位续接 → `SustainLoop` 常驻线程 + `cg(op=sustain)`。
+   MCP 进程启动即自维持（`MDCG_SUSTAIN=0` 可关）。
 3. **更多驱动**：视觉/语音产出接入（`sources.py` 已是可插拔，加 Source 即可）。
 

package/lib/bridge.d.ts

@@ -1,5 +1,5 @@
 /**
- * 灵枢 MCP stdio 桥：管理灵枢（AEIS）Python 子进程的生命周期，
+ * 灵枢 MCP stdio 桥：管理大脑（md_cg）Python 子进程的生命周期，
  * 通过逐行 JSON-RPC 完成握手、工具发现与调用。
  *
  * 与官方 @deepseek-ai/dsh-mcp-client 不同，本桥零运行时依赖（不引入
@@ -23,11 +23,11 @@ export interface McpCallResult {
 }
 /** 启动灵枢子进程的配置。 */
 export interface BridgeOptions {
-    /** Python 可执行文件（或 aeis-mcp console script），默认 python。 */
+    /** Python 可执行文件（或 md_cg-mcp console script），默认 python。 */
     python: string;
-    /** 传给 python 的参数，默认 ['-m', 'aeis.mcp.server']。 */
+    /** 传给 python 的参数，默认 ['-m', 'md_cg.mcp_server']。 */
     args: string[];
-    /** 追加到子进程的环境变量（AEIS_DB / AEIS_IDENTITY / 密钥等）。 */
+    /** 追加到子进程的环境变量（MDCG_* / MDCG_MCP_SURFACE / 密钥等）。 */
     env: Record<string, string>;
     /** 子进程工作目录。 */
     cwd?: string;

package/lib/bridge.js

@@ -1,5 +1,5 @@
 /**
- * 灵枢 MCP stdio 桥：管理灵枢（AEIS）Python 子进程的生命周期，
+ * 灵枢 MCP stdio 桥：管理大脑（md_cg）Python 子进程的生命周期，
  * 通过逐行 JSON-RPC 完成握手、工具发现与调用。
  *
  * 与官方 @deepseek-ai/dsh-mcp-client 不同，本桥零运行时依赖（不引入
@@ -185,7 +185,7 @@ export class LingshuBridge {
                 this.unexpectedExits = this.unexpectedExits.filter((t) => Date.now() - t < 600_000);
                 this.unexpectedExits.push(Date.now());
                 if (uptimeS >= 0 && uptimeS < 5) {
-                    console.error('[lingshu-bridge] 进程启动后 5 秒内即退出——请检查 python 可执行文件与 aeis 安装。');
+                    console.error('[lingshu-bridge] 进程启动后 5 秒内即退出——请检查 python 可执行文件与 md_cg 依赖（python -m md_cg.mcp_server 可自检）。');
                 }
                 else if (this.unexpectedExits.length >= 3) {
                     console.error(`[lingshu-bridge] 10 分钟内已意外退出 ${this.unexpectedExits.length} 次，` +
@@ -244,7 +244,7 @@ export class LingshuBridge {
             this.readyState = 'failed';
             this.flushBootQueue(false);
             console.error(`[lingshu-bridge] 连续启动失败 ${this.retries} 次，已停止自动重启（不再后台空转）。` +
-                '请检查 python 可执行文件与 aeis 安装（pip install aeis），修复后在 DSH 中重新启用 dsh-memory 插件。');
+                '请检查 python 可执行文件与 md_cg 依赖（python -m md_cg.mcp_server 可自检），修复后在 DSH 中重新启用 dsh-memory 插件。');
             probe(`give up: ${this.retries} consecutive failures, entering failed terminal state`);
             return;
         }
@@ -270,7 +270,7 @@ export class LingshuBridge {
         // issue #6：放弃终态下快速失败——之前进程不在且不再重启，请求只能白等超时
         if (this.gaveUp) {
             return Promise.reject(new Error('灵枢进程不可用：连续启动失败已达上限，已停止重试。' +
-                '请检查 python 可执行文件与 aeis 安装（pip install aeis），修复后重新启用 dsh-memory 插件。'));
+                '请检查 python 可执行文件与 md_cg 依赖（python -m md_cg.mcp_server 可自检），修复后重新启用 dsh-memory 插件。'));
         }
         const id = this.nextId++;
         const timeout = this.options.timeoutMs;

package/lib/hooks.d.ts

@@ -1,19 +1,31 @@
 /**
  * 自动记忆钩子：把 DSH 的会话事件（经统一的 session/event 分发）沉淀进灵枢。
  *
+ * 记忆真源 = **md_cg 认知图（md 文档）**（2026-09-10 统一）：本钩子经
+ * MdcgClient.remember() 调 MCP `mdcg_remember(gated=true)`（主动遗忘闸门：
+ * ACCEPT 落盘 / MERGE 并入既有 = 去重强化 / DROP 低熵 / DEFER 待定），
+ * 落层 contextual，role 取 user | assistant | tool-output —— 与 md_cg 对 DSH
+ * 会话事件的约定一致（md_cg/sources.py 的 SESSION_LAYER / DSHSessionSource）。
+ * ⚠️ 不用 `cg(op=write)`：那条路径先过 audit，未声明 content_kind 时永不落盘
+ * （见 src/lib/mdcg_client.ts 文件头）。
+ * 不再走 AEIS：AEIS 已降为能力库，不存记忆。
+ *
+ * ⚠️ 写入需凭据：md_cg fail-closed，无 MDCG_TOKEN / MDCG_LEGACY_ENV_AUTH=1
+ * 时降级为只读 guest —— 本钩子的写入会失败（仅告警，不影响对话）。
+ *
  * 与 DSH 的 session-persistence 插件（保存会话日志）不同，这里是"语义沉淀"：
- * 用户消息写入灵枢知识层（带去重与重要性），agent 回复与工具结果可选开启。
+ * 带去重（闸门 MERGE）与重要性，写入前脱敏；agent 回复与工具结果可选开启。
  * 只记忆真实用户消息（source.kind === 'user'），过滤插件注入的噪音。
  *
- * P1 完善（GPT 审查·自动记忆只写不读）：新增 autoRecall——通过
- * system-prompt/assemble 事件（waterfall，异步允许）在每次模型请求组装
- * system prompt 时自动注入灵枢最近记忆（timeline），让记忆"自动可用"
- * 而不只依赖 Agent 主动调用 recall/think 工具。失败静默（不影响请求）。
+ * autoRecall：通过 system-prompt/assemble 事件（waterfall，异步允许）在每次
+ * 模型请求组装 system prompt 时自动注入灵枢最近记忆
+ * （`stg(op=timeline)`，最近记忆节点时间线），让记忆"自动可用"而不只依赖
+ * Agent 主动调用 recall/think 工具。失败静默（不影响请求）。
  */
 import '@deepseek-ai/dsh-session';
 import '@deepseek-ai/dsh-system-prompt';
 import type { Context } from '@deepseek-ai/cordis';
-import type { LingshuBridge } from './bridge.js';
+import type { MdcgClient } from './lib/mdcg_client.js';
 /** 自动记忆开关。 */
 export interface MemoryHooksOptions {
     /** 用户消息 → remember（默认 true）。 */
@@ -33,5 +45,8 @@ export interface MemoryHooksOptions {
 }
 /** 脱敏：替换敏感片段；返回 null 表示整条都是敏感内容（应跳过写入）。 */
 export declare function desensitize(text: string): string | null;
-/** 安装自动记忆钩子（effect 作用域内，随插件卸载自动移除）。 */
-export declare function installMemoryHooks(ctx: Context, bridge: LingshuBridge, opts: MemoryHooksOptions): void;
+/** 安装自动记忆钩子（effect 作用域内，随插件卸载自动移除）。
+ *
+ *  mdcg 为 null（config.mdcg.enabled=false）时自动记忆整体停用：记忆真源是
+ *  认知图，没有它就没有可写的去处——**不会退回 AEIS**（AEIS 已不存记忆）。 */
+export declare function installMemoryHooks(ctx: Context, mdcg: MdcgClient | null, opts: MemoryHooksOptions): void;

package/lib/hooks.js

@@ -1,14 +1,26 @@
 /**
  * 自动记忆钩子：把 DSH 的会话事件（经统一的 session/event 分发）沉淀进灵枢。
  *
+ * 记忆真源 = **md_cg 认知图（md 文档）**（2026-09-10 统一）：本钩子经
+ * MdcgClient.remember() 调 MCP `mdcg_remember(gated=true)`（主动遗忘闸门：
+ * ACCEPT 落盘 / MERGE 并入既有 = 去重强化 / DROP 低熵 / DEFER 待定），
+ * 落层 contextual，role 取 user | assistant | tool-output —— 与 md_cg 对 DSH
+ * 会话事件的约定一致（md_cg/sources.py 的 SESSION_LAYER / DSHSessionSource）。
+ * ⚠️ 不用 `cg(op=write)`：那条路径先过 audit，未声明 content_kind 时永不落盘
+ * （见 src/lib/mdcg_client.ts 文件头）。
+ * 不再走 AEIS：AEIS 已降为能力库，不存记忆。
+ *
+ * ⚠️ 写入需凭据：md_cg fail-closed，无 MDCG_TOKEN / MDCG_LEGACY_ENV_AUTH=1
+ * 时降级为只读 guest —— 本钩子的写入会失败（仅告警，不影响对话）。
+ *
  * 与 DSH 的 session-persistence 插件（保存会话日志）不同，这里是"语义沉淀"：
- * 用户消息写入灵枢知识层（带去重与重要性），agent 回复与工具结果可选开启。
+ * 带去重（闸门 MERGE）与重要性，写入前脱敏；agent 回复与工具结果可选开启。
  * 只记忆真实用户消息（source.kind === 'user'），过滤插件注入的噪音。
  *
- * P1 完善（GPT 审查·自动记忆只写不读）：新增 autoRecall——通过
- * system-prompt/assemble 事件（waterfall，异步允许）在每次模型请求组装
- * system prompt 时自动注入灵枢最近记忆（timeline），让记忆"自动可用"
- * 而不只依赖 Agent 主动调用 recall/think 工具。失败静默（不影响请求）。
+ * autoRecall：通过 system-prompt/assemble 事件（waterfall，异步允许）在每次
+ * 模型请求组装 system prompt 时自动注入灵枢最近记忆
+ * （`stg(op=timeline)`，最近记忆节点时间线），让记忆"自动可用"而不只依赖
+ * Agent 主动调用 recall/think 工具。失败静默（不影响请求）。
  */
 import '@deepseek-ai/dsh-session';
 import '@deepseek-ai/dsh-system-prompt';
@@ -23,7 +35,7 @@ function extractText(blocks) {
     return parts.join('\n').trim();
 }
 /**
- * 敏感信息模式（GPT 审查·自动记忆脱敏）：写入记忆库前过滤凭据/个人标识。
+ * 敏感信息模式（GPT 审查·自动记忆脱敏）：写入认知图前过滤凭据/个人标识。
  * 命中 → 替换为 [已过滤:类别]（保留对话主体）；过滤后只剩占位符/空白 → 整条跳过。
  * 纯内容过滤，不涉及身份认证——开源场景下的隐私保护。
  */
@@ -49,12 +61,41 @@ export function desensitize(text) {
         return null;
     return out;
 }
-/** 安装自动记忆钩子（effect 作用域内，随插件卸载自动移除）。 */
-export function installMemoryHooks(ctx, bridge, opts) {
-    const memorize = (tool, args) => {
-        void bridge
-            .callTool(tool, args)
-            .catch((err) => ctx.logger.warn(`dsh-memory: ${tool} 自动记忆失败: ${err.message}`));
+/** 时间线载荷 → 注入文本。
+ *  `stg(op=timeline)` 返回 {count, limit, items:[{id, layer, start, end, preview}]}。 */
+function formatTimeline(payload) {
+    const items = (payload && typeof payload === 'object'
+        && Array.isArray(payload.items))
+        ? payload.items
+        : [];
+    return items
+        .map((it) => {
+        const preview = String(it['preview'] ?? '').replace(/\s+/g, ' ').trim();
+        if (!preview)
+            return '';
+        const layer = it['layer'] ? `[${String(it['layer'])}] ` : '';
+        return `- ${layer}${preview}`;
+    })
+        .filter(Boolean)
+        .join('\n');
+}
+/** 安装自动记忆钩子（effect 作用域内，随插件卸载自动移除）。
+ *
+ *  mdcg 为 null（config.mdcg.enabled=false）时自动记忆整体停用：记忆真源是
+ *  认知图，没有它就没有可写的去处——**不会退回 AEIS**（AEIS 已不存记忆）。 */
+export function installMemoryHooks(ctx, mdcg, opts) {
+    if (!mdcg) {
+        ctx.logger.warn('dsh-memory: 认知图未启用（config.mdcg.enabled=false），自动记忆已停用');
+        return;
+    }
+    const graph = mdcg;
+    /** 记忆沉淀（fire-and-forget）。认知图未就绪则跳过并告警（不退回 AEIS）。 */
+    const memorize = (label, run) => {
+        if (!graph.isReady()) {
+            ctx.logger.warn(`dsh-memory: 认知图未就绪，跳过自动记忆（${label}）`);
+            return;
+        }
+        void run(graph).catch((err) => ctx.logger.warn(`dsh-memory: 自动记忆 ${label} 失败: ${err.message}`));
     };
     // P1 完善（GPT 审查·自动记忆脱敏）：写入前过滤敏感信息（默认开启）。
     // 命中敏感模式 → 替换为 [已过滤:类别]；纯凭据消息 → 跳过写入（不落库）。
@@ -69,14 +110,15 @@ export function installMemoryHooks(ctx, bridge, opts) {
         const recallLimit = Math.max(1, Math.min(10, opts.autoRecallLimit || 4));
         ctx.on('system-prompt/assemble', async (assembly, _ctx, next) => {
             try {
-                // 异步取最近记忆（失败静默——不阻塞模型请求）
-                const r = await bridge.callTool('timeline', { limit: recallLimit });
-                const text = extractText(r.content);
-                if (text) {
-                    assembly.contexts.push({
-                        name: 'lingshu:auto-recall',
-                        text: `【灵枢最近记忆】\n${text.slice(0, 600)}`,
-                    });
+                // 异步取最近记忆节点（失败静默——不阻塞模型请求）
+                if (graph.isReady()) {
+                    const text = formatTimeline(await graph.timeline(recallLimit));
+                    if (text) {
+                        assembly.contexts.push({
+                            name: 'lingshu:auto-recall',
+                            text: `【灵枢最近记忆】\n${text.slice(0, 600)}`,
+                        });
+                    }
                 }
             }
             catch { /* 静默：召回失败不影响请求 */ }
@@ -98,10 +140,13 @@ export function installMemoryHooks(ctx, bridge, opts) {
             const safe = sanitize(text); // 脱敏：纯凭据消息 → null → 跳过写入
             if (safe === null)
                 return;
-            memorize('remember', { content: safe, importance: opts.importance, tags: ['dsh', 'user'] });
-            // T4：用用户消息做一次语义召回——触发灵枢 _note_reuse 落库（复用观测），
-            // 召回结果同时预热灵枢检索缓存（timeline 只读不触发复用统计）
-            memorize('recall', { query: safe.slice(0, 200), limit: 3 });
+            memorize('user', (g) => g.remember(safe, {
+                role: 'user', tags: ['dsh', 'user'], importance: opts.importance,
+            }));
+            // T4：用用户消息做一次语义召回——md_cg 的读取会记 access log（复用观测，
+            // 供 importance / scrub 陈旧度使用），同时预热检索路径。
+            // （AEIS 侧的 `_note_reuse` 在 md_cg 中不存在，其等价物就是这次记访问。）
+            memorize('user-recall', (g) => g.recall(safe.slice(0, 200), 3));
         }
         else if (event.type === 'assistant/message' && opts.assistantMessage) {
             const text = extractText(event.data.message.content);
@@ -110,7 +155,9 @@ export function installMemoryHooks(ctx, bridge, opts) {
             const safe = sanitize(text);
             if (safe === null)
                 return;
-            memorize('remember', { content: safe, importance: opts.importance * 0.8, tags: ['dsh', 'assistant'] });
+            memorize('assistant', (g) => g.remember(safe, {
+                role: 'assistant', tags: ['dsh', 'assistant'], importance: opts.importance * 0.8,
+            }));
         }
         else if (event.type === 'tool/result' && opts.toolResult) {
             if (event.data.error)
@@ -121,7 +168,9 @@ export function installMemoryHooks(ctx, bridge, opts) {
             const safe = sanitize(text);
             if (safe === null)
                 return;
-            memorize('remember', { content: safe, importance: opts.importance * 0.6, tags: ['dsh', 'tool'] });
+            memorize('tool', (g) => g.remember(safe, {
+                role: 'tool-output', tags: ['dsh', 'tool'], importance: opts.importance * 0.6,
+            }));
         }
     });
 }

package/lib/index.d.ts

@@ -1,16 +1,40 @@
 /**
- * @furongjun1999/dsh-memory —— 灵枢（AEIS）DeepSeek Harness 插件
+ * @furongjun1999/dsh-memory —— 灵枢 DeepSeek Harness 插件
+ * （大脑唯一真源 = md_cg 认知图；aeis 能力库已下线）
  *
  * 把灵枢的时空记忆/知识飞轮/自我认知接入 DSH：
- * - 工具桥接：Agent 可调用 lingshu_remember / recall / search / think 等
- * - 自动记忆：DSH 对话自动沉淀进灵枢记忆库（去重+重要性）
+ * - 记忆唯一真源：**md_cg 认知图（md 文档）**，插件侧唯一显式入口
+ *   `src/lib/mdcg_client.ts`（每个方法 = 一条 MCP cg / stg 调用）
+ * - 工具桥接：Agent 可调用工具，经**唯一的大脑桥**（同一 md_cg 子进程）从
+ *   **md_cg.mcp_server** 拉取（`MDCG_MCP_SURFACE=full`：`cg` / `stg` 基元 +
+ *   `mdcg_*` 细粒度全家，再由 `config.tools` 选择表筛），注册为 `lingshu_<name>`
+ * - 自动记忆：DSH 对话经**认知图**自动沉淀（主动遗忘闸门去重 + 重要性 + 脱敏）
+ * - 使命分离：理论仓（CTP）只留方法论文档，工程代码全部在主仓 md_cg
  *
  * 用法（cordis.yml）：
  * ```yaml
  * - id: lingshu-memory
  *   name: '@furongjun1999/dsh-memory'
  *   config:
- *     dbPath: 'D:/path/to/lingshu.db'
+ *     mdcg:                              # 记忆真源：认知图（md 文档）
+ *       # root = 记忆写入路径（用户可改）。缺省 = 插件仓自身 data/mdcg。
+ *       # 覆盖优先级：env MDCG_ROOT > <插件仓>/data/paths.json > 本项 > 默认
+ *       # root: 'D:/somewhere/mdcg'        # 例：把记忆库放到别处
+ *       actor: 'dsh-memory'
+ *     env:                               # 写入凭据：默认【关闭】，由你决定是否打开
+ *       # 不配 → 只读 guest：读/召回/时间线可用，自动记忆/转录/落图不落盘（启动会告警）
+ *       # 打开①推荐：先签发再引用（明文不进配置文件）
+ *       #   python -m md_cg.tokens issue --role designer --actor dsh-memory \
+ *       #     --clearance internal \
+ *       #     --ops-allow info,route,read,write,recent,goal,identity,whitebox,verify \
+ *       #     --layers-allow knowledge,contextual,structural,self,goals,unresolved,rejected
+ *       # MDCG_TOKEN: !!js process.env.MDCG_TOKEN
+ *       # 打开②最小权限：--role recorder（无 whitebox/identity/verify，不能写 self 层）
+ *       # 打开③兼容旧部署（不推荐）：MDCG_LEGACY_ENV_AUTH: '1'
+ *     dbPath: '/path/to/legacy.db'       # 遗留：仅角色数据目录推导用（不存记忆）
+ *     capability:                        # 可选「身体」后端（默认关 → 单进程纯大脑）
+ *       enabled: false
+ *       args: ['-m', 'aeis.mcp.server']
  *     identity: '灵枢'
  *     memory:
  *       userMessage: true
@@ -30,17 +54,20 @@ export declare const inject: string[];
 export interface Config {
     /** 工具命名空间前缀（默认 lingshu → lingshu_remember）。 */
     serverName: string;
-    /** Python 可执行文件（或 aeis-mcp console script）。 */
+    /** Python 可执行文件（或 md_cg-mcp console script）。 */
     python: string;
-    /** 传给 python 的参数（默认启动灵枢 MCP server）。 */
+    /** 传给 python 的参数（默认启动 md_cg MCP server）。 */
     moduleArgs: string[];
-    /** 灵枢记忆库 SQLite 路径（目录自动创建）。 */
+    /** ⚠️ 遗留项：SQLite 库文件路径（经 `AEIS_DB` 传给子进程），目录自动创建。
+     * 大脑真源已统一到 `mdcg`（认知图）；此项仅供角色数据目录 roleDataDir
+     * （由它的父目录推导）使用，**不再存记忆**，md_cg server 也不读取它。 */
     dbPath: string;
     /** 灵枢身份标识（写入记忆的自我模型）。 */
     identity: string;
     /** 额外环境变量（BOCHA_API_KEY / AEIS_DESIGNER_KEY 等，可 !!js 注入）。 */
     env: Record<string, string>;
-    /** 暴露的工具集合：'core' | 'brain' | 'all' | 工具名数组。 */
+    /** 暴露的工具集合：'core'（默认，仅 cg/stg 两基元）| 'brain'（完整认知面）
+     *  | 'all' | 工具名数组。 */
     tools: ToolSelection;
     /** 护栏宪章版本声明（接入即接受宪章约束，docs/guardrail-charter.md）。 */
     charter: string;
@@ -57,6 +84,24 @@ export interface Config {
         enabled: boolean;
         heartbeatMs: number;
     };
+    /** 认知图（md_cg）= 记忆唯一真源；AEIS 降为能力库。 */
+    mdcg: {
+        enabled: boolean;
+        root: string;
+        actor: string;
+        tenant: string;
+        clearance: string;
+    };
+    /** 「身体」能力后端（可选）：角色扮演生成等「身」的生成能力。
+     *
+     *  默认**不挂载** —— 主仓保持纯大脑单进程（只起 md_cg）。配置 enabled 后
+     *  额外起一个能力库子进程（如 AEIS），仅角色扮演生成使用；记忆真源仍是
+     *  md_cg（大脑），本后端不存记忆。未挂载时角色生成接口 fail-closed。 */
+    capability: {
+        enabled: boolean;
+        python: string;
+        args: string[];
+    };
 }
 export declare const Config: z<Config>;
 /**