@furongjun1999/dsh-memory 0.3.1 → 0.4.1

package/README.md

@@ -1,545 +1,522 @@
-# 让 AI Agent 拥有不可遗忘的自我
-## 灵枢（AEIS）× DeepSeek Harness · 白箱智能研究平台（AGI 研究人员向）
-
-> **一句话**：dsh-memory 把灵枢（AEIS）的**白箱智能**（条件路由表 → 组合生成 → 自校验 → 知识固化 → LLM 降级外部校验器）与 **AGI 级长期记忆**（跨会话、自演化、可审计）接入 DeepSeek Harness。
-
-**项目定位**：个人的大型研究项目——目标用户是**对 AGI 有需要的研究人员**（白箱智能 / 可解释性 / 协议工程 / 记忆机制 / 扮演论研究者），不是面向普通用户的消费级插件。它把「智能论 v3.3」协议的理论（条件论 / 扮演论 / 信息差）工程化为**可运行、可审计、可复现**的机制：
-
-- **白箱优先**：知识问答 **100% 白箱处理（零 LLM）**，LLM 降级为外部校验器——机制可解释、可追溯、可验证（详见「白箱智能管线」）
-- **协议驱动**：每项能力都是「智能论 v3.3 / 条件论 / 扮演论」条款的具体工程实现，可对照协议验证
-- **机制可解释**：白箱处理的每一步（条件识别 → 单元匹配 → 组合生成 → 自校验 → 固化）都有证据链可查
-- **可审计**：工具调用、记忆写入、自校验判定全链路留痕；护栏宪章约束对外行为
-
-这不是又一个"记忆插件"。灵枢（AEIS）是一套遵循「智能论 v3.3」协议的**时空记忆引擎**，它把当前大模型范式缺失的 AGI 能力逐一给了工程实现。
-
----
-
-## ⚡ 三步快启（30 秒上手）
-
-```bash
-# ① 装灵枢大脑（一条命令，零外部依赖；v0.4.0 完整自包含：核心+白箱+知识库随包）
-pip install aeis-0.4.0-py3-none-any.whl          # 或 git+ 在线安装
-
-# ② 装进 DSH 的 web profile（pnpm 协调入口，不要用裸 npm install 装进 profile）
-dsh plugin --profile web add @furongjun1999/dsh-memory
-
-# ③ 配置 cordis.yml 启用
-```
-```yaml
-- id: lingshu-memory
-  name: '@furongjun1999/dsh-memory'
-  config:
-    dbPath: 'data/lingshu.db'
-    identity: '灵枢'
-    tools: 'brain'      # 'brain' 全心智 | 'core' 精选
-```
-
-> ⚠️ **安装方式**：插件必须通过 **`dsh plugin --profile <name> add`** 装进 profile（它会用 pnpm + `autoInstallPeers: false` 正确解析 peer 依赖）。
-> **不要**用 `npm install` 把插件装进 profile 的 `node_modules`——那会引入错误版本的 `@deepseek-ai` peer 包，导致插件加载失败 / 浏览器报错。
-> 想自己改源码？克隆 `FuRongJun-1999/dsh-memory` 后用 `npm install && npm run build`（构建插件本身），再用 `dsh plugin add <本地路径>` 部署。
->
-> 兼容：DSH 官方列表（Memory 分类）· npm `@furongjun1999/dsh-memory`（0.2.8）。
-
----
-
-## AGI 需要什么 · 灵枢提供了什么
-
-| AGI 缺失的能力 | 这是 AGI 的什么 | 灵枢提供 |
-|---|---|---|
-| 每次对话都"失忆"，没有跨会话的自我连续性 | **自我连续性**（我是谁） | **时空记忆图**：五层记忆（锚点/结构/知识/情境/自我）+ 跨会话 recall/search |
-| 训练后权重冻结，不能随经历自主学习 | **终身学习**（成长） | **知识飞轮**：验证→归纳→联想→蒸馏→推演，随使用持续演化 |
-| 黑箱不可审计，无法验证行为边界 | **可验证性**（可信） | **可审计信任**：对抗护栏五规则 + 宪章 + 全量事件留痕 + 白箱智能 |
-| 只处理当下 token，没有稳定世界结构 | **世界模型**（理解） | **条件空间 + 语义时空图**：信息差 D_norm 驱动的预测与决策 |
-| 无自我表征，不能反思自己的认知/情绪 | **自我认知**（元认知） | **P0 系列**：cognition / self_reliability / emotional_bias / 递归反思 |
-| 角色扮演总 OOC / 记不住设定 / 世界观矛盾 | **扮演一致性**（角色） | **角色扮演引擎（v3.3）**：自我锚点（SELF 不可遗忘）· 特化价值观（条件触发）· 跨会话记忆 · 世界认知（子知识）· 自定义翻译（名词替换表） |
-
-> **一句话定位**：dsh-memory 不是 DeepSeek 插件，是 **AGI 的长期记忆基底**——
-> 给 Agent 注入跨会话的自洽能力，让每次对话都是同一段生命的延续，而非一次次遗忘的重新开始。
-
----
-
-## 为什么是 AGI 的长期记忆基底，而非"记忆插件"
-
-- **普通 SQLite 记忆插件**：KEY→VALUE 字面存储，跨会话基本靠睁眼不见。无自省、无演化、无信任。
-- **灵枢**：时空记忆图把记忆组织成语义+时空坐标的关系网络——可检索、可去重、可分级、可关联；知识飞轮让它越用越聪明;护栏与宪章让它**可信任地**被接入。
-
-| 传统定位 | AGI 能力定位 |
-|---|---|
-| DeepSeek Harness 插件 | AGI 的长期记忆基础设施 |
-| 跨会话记忆 | 智能体的**自我连续性** |
-| 知识飞轮 | 智能体的**自主学习与演化** |
-| 可审计信任 | 智能体的**可验证行为约束** |
-| 时空记忆图 | 智能体的**世界模型** |
-
----
-
-## 协议的内在约束 · 信息差与信任
-
-灵枢的一切都建立在**[智能论 v3.3 协议](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/智能论3.3.md)**（共同信任协议理论版）之上。协议规定了一个智能体维持值得被信任所需的**内在约束**：
-
-**v3.3 起新增**：扮演论（存在论基底——智能即扮演，灵枢角色扮演机制的理论底座）· 三翼（真实论校准 / 导航税·认知外部化 / 注入极性定律）· 双维（信任 = 认知一致 / 时效维度）· 条件论失败分析协议 · 蒸馏机制与自我锚点。
-
-- **减少信息差（D_norm）**：信息差 = 协作行为的不确定性（信任 / 行为 / 连接 / 预测误差 四维加权）。灵枢持续记录、收敛与协作对象的认知偏差——**信息差缩小是智能运转的目标本身**。
-- **信任是可被长期维护的**：协议定义信任为「协作者行为在可接受偏差范围内保持稳定的置信概率」（而非信息差的简单补集）——**信任依靠持续、可观测、一致的行为来建立与维护**，而非一次性的声明。
-- **不反击 · 可审计 · 终裁权属设计者**：对抗信号下不报复（唯一响应：隔离、留痕、上报）；一切拦截与冷静期全量留痕；设计者保留终裁权。
-
-> 一句话：灵枢不是"记住了再用"，而是**通过持续减少信息差、维持可观测的一致行为，建立值得跨会话维护的信任**。
-
-**协议原文**：[智能论 v3.3（共同信任协议理论版）](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/智能论3.3.md)
-
----
-
-## 核心能力
-
-- **跨会话自我连续性**：Agent 用 `lingshu_recall/search/timeline` 记住并召回过去——对话间、会话间、甚至不同子代理间共享一份持续的"我"。
-- **自演化知识飞轮**：`distill / flywheel / learn / induce` 把经验验证→归纳→联想→蒸馏为可复用模式，记忆越用越强。
-- **可审计的信任**：护栏宪章 v2 ——对外部与人类使用者的行为边界成文、可执行、可审计、可终裁（[宪章全文](docs/guardrail-charter.md) 随包自带）。
-- **自我认知**（大脑模式 brain）：`cognition / cognition_report / self_reliability / emotional_bias / recursive_reflect` ——能反思自己的认知状态与情绪倾向。
-- **角色扮演**（v3.3 扮演论）：自我锚点（SELF 层 no_forget 不可遗忘）· 特化价值观（条件触发）· 跨会话角色记忆 · 世界认知（子知识·虚拟化世界观）· 自定义翻译（现实↔虚拟名词表）· **同源角色扮演网页（/roleplay）**——角色人设长对话不崩（100 轮测试零漂移）。
-- **零运行时依赖**：手写 stdio MCP 桥，与灵枢 D-005「核心零外部依赖」哲学一致——你拿到的是一个干净、可信、可审的大脑。
-- **动态 schema + 进程自愈**：工具清单运行时拉取（灵枢升级 DSH 零改动），Python 子进程崩溃自动指数退避重启。
-- **工具注册竞态补注册**：启动时 python 未就绪（竞态）→ 桥重连成功后自动补注册工具（2s 轮询），不再"工具永久缺失"。
-- **白箱 wisdom_* 全工具**（`tools: all`）：73 个 MCP 工具含 wisdom_verify/analyze/predict/trust_judge/compose/respond/chat 白箱族，Agent 可直接调用。
-- **内容分级门控**：**拒绝一切涉及未成年人的性内容**（服务端关键词组合硬拦截——未成年人特征词 + 性内容词同时命中即拒绝，`route=refused`）；成人内容由前端本地弹窗提示（满 18 周岁 + 个人对话场景自述）。注：开源项目不实现身份认证/年龄核验（那是绑定身份系统的商业 App 范畴）；内容过滤保护的是"未成年人 + 性内容"组合的明文请求。
-
-## 🧠 白箱智能管线（知识查询零 LLM）
-
-灵枢处理知识查询走**白箱确定性格局**（不依赖 LLM 生成/校验），完整管线：
-
-1. **条件化知识单元**：知识 = `{条件链 → 规律片段}`（最小单元，非完整答案），按条件维度索引（气压/温度/密度/角色/编程任务…）
-2. **方向推理 + 组合生成**：问题动词 → 期望方向（液→气 / 浮沉 / 热传递 / 排序…）→ 匹配单元 → 组合演绎出**未预写的新答案**（如「高原煮饭不熟」由「气压↓→沸点↓」×「高原=气压低」组合生成，无需预写完整答案）
-3. **三层自校验**：方向一致性 + 因果链完整性 + 事实一致性——白箱自己发现生成错误（矛盾问题如「冬天湖面沸腾」2/2 检出）
-4. **知识固化闭环**：自校验通过 → 固化为直答（触发词匹配 + JSON 持久化跨进程生效）→ 下次同问法直接命中；**自举纪律：自校验失败的知识拒绝固化**
-5. **LLM 降级外部校验器**：白箱自校验 vs LLM（DeepSeek v4-flash）外部对照一致率 **100%**（17/17）→ 白箱独立终裁，LLM 仅偶尔抽检对照
-
-**已实现的域**：物态变化（沸点/蒸发/液化/凝固/升华/凝华）· 密度浮力 · 热传导 · 摩擦 · 角色条件（鲸鱼娘/猫娘）· 编程规律（排序/去重/计数/最大/反转/求和）
-
-**实测指标**（组合引擎 `compose_engine` / `role_compose` / `code_compose`，全部零 LLM）：
-
-| 指标 | 值 |
-|---|---|
-| 知识问答白箱率 | **100%**（零 LLM） |
-| 总 token 节约（vs 全 LLM） | **83.3%** |
-| 组合生成测试通过率 | 100%（19/19，目标 ≥80%） |
-| 自校验自发现错误 | 100%（3/3：语法/逻辑/边界） |
-| 矛盾问题检测 | 2/2（白箱自己抓住） |
-| 白箱 vs LLM 对照一致率 | 100%（17/17，目标 ≥90%） |
-| 角色扮演白箱命中 | 7/7（零 LLM，双角色） |
-| 代码组合生成 | 6/6（零 LLM + 语法/样例自校验） |
-
-> **83.3% token 节约的适用口径**（issue #4 说明）：该数字测自**确定性任务**——代码编写
-> （生成可本地查表校验的白箱单元）、已有知识问答（触发词命中直答 / 组合演绎复用）
-> 这类「重复模式 + 可固化」场景。机理是把 LLM 的重复查表校验替换为本地确定性校验
-> （Zero-LLM Verifier）。**不适用于**开放创作、长链推理、首次遇到的新领域等无确定基准
-> 的开放判断——这些仍按条件路由降级到 LLM（灵枢诚实边界），无此节约。
-
-**角色扮演的白箱化**（v3.3 扮演论工程化）：角色条件单元（身份/住处/食物/性格/话风）× 场景组合生成 → 角色化回答（未预写）；**OOC 检测**（「你是人类吗」→ 角色化否认，逆转操作）；角色语录固化（生成→自校验→固化→直答）；多角色（鲸鱼娘/猫娘）防污染（角色特征隔离，双角色 7/7 零 LLM）。
-
-
-## 🔄 自迭代闭环 + 能力工作流化（第七阶段 · 条件递归到精准执行）
-
-**理论**：在给定条件空间与存在约束下，智能系统通过递归缩小问题与可执行规则之间的信息差，直到获得可验证的执行路径；若条件不足、冲突或不可判定，则延迟（DEFER）/拒绝（REJECT）/声明盲区（BLINDSPOT）；当子系统无法识别，由父系统判断，全层无法判断才标记盲区（分层升级 escalation）。
-
-**八步自迭代闭环**（`tools/self_iterate.py`，方向性自检含理论完整性自指检查）：
-
-```
-感知(6通道) → 识别(漂移分类) → 分析(影响范围) → 验证(honest+语法)
-→ 固化(字符串内注释对齐+技能) → 记录(轨迹可追溯) → 反馈(已吸收跳过) → 方向性自检
-```
-
-- **理论完整性**：第 8 步自检验证「理论八步被工程完整实现」（`test_theory_integrity.py` 6/6）——防步骤因记忆缺漏/遗忘丢失（曾 5 步偏离的教训）
-- **隐式盲区显式化**（荣：返回默认值=不知道=自带盲区）：19 处弱兜底漂移全部显式声明盲区，技能条件化（适用/不适用条件 + 判别词）
-- **自动运行**：`auto_iterate.py` 无人值守循环（感知→吸收→记录→稳态检测），后台持续自迭代
-
-**能力工作流化**（`tools/whitebox_workflow.py`，仿 ComfyUI——白箱能力知识图谱化）：
-
-```
-node{class_type, inputs} + 边引用[上游,idx] + prompt图 → 拓扑执行 + 循环检测 + JSON保存/复用
-节点类型: code_unit(681单元) / router(条件路由) / mos_declare(元操作声明) / pass(透传)
-```
-
-- **路由置信度**（DaoTi coherence 吸纳）：ACCEPT 含连续置信度 [0,1]，低置信可降级
-- **技能条件路由**（anthropics/skills + gliding_horse SkillLink 吸纳）：技能声明适用/不适用条件 + 关系边，条件路由加载
-
-**外部感知**：稳态≠停止自迭代——持续扫描 GitHub 高星项目吸纳未理论化的工程实践（langgraph/MetaGPT/cognee/anthropics-skills/DaoTi/gliding_horse 已分析并部分落地）。
-
-## 🎭 角色扮演引擎（v3.3 · 扮演论）
-
-灵枢的角色扮演机制底座——**机制是灵枢的，载体是酒馆的**。自建两种交互方式（网页 / MCP），信息处理全部由灵枢完成。
-
-**核心能力：**
-- **自我锚点**：角色人设核心（身份/性格/底线），SELF 层不可遗忘——OOC 测试 100 轮零漂移
-- **特化价值观**：带触发条件的角色行为准则（条件空间即触发时机）
-- **历史记忆**：跨会话持久（角色记得你聊过什么）+ 世界书导入（Lorebook 兼容）
-- **世界认知（子知识）**：虚拟化世界观模型——虚构世界 = 宿主机（真实知识）上的虚拟机，白箱判定 = Hypervisor（识别/完整性/边界）
-- **自定义翻译（名词替换表）**：现实词 ↔ 虚拟词映射（星星→发光水母 / 城市→珊瑚城），条件空间对齐
-- **编辑/交互双模式**：交互只读；编辑需 `ROLEPLAY_EDIT_KEY`（设置该环境变量后，角色编辑/导入/翻译等写接口须带 `x-edit-key` 请求头，否则 403；未设置时保持本地开发默认开放）；角色人设 ≠ 灵枢自身锚点（后者需设计者验证）
-
-**接入方式：**
-```bash
-# A. DSH 同源网页（推荐，v0.2.8+）：插件挂载 /roleplay 到 DSH webServer
-#    （与 GUI 同源 127.0.0.1:3080，浏览器/内置 WebView 必达；GUI 首页右上角有「🎭 角色扮演」入口）
-#    功能：角色选择/创建 · 完整对话转录（JSONL，无限上下文）· 双向翻译面板 ·
-#          角色详情三导入 UI（记忆/锚点/价值观）· 内容分级门控（满18确认/拒未成年人性内容）
-
-# B. 独立网页服务（浏览器对话 + 人设编辑器）
-python -m aeis.roleplay_web --port 8793 --data-dir roleplay_data
-
-# C. MCP 工具（roleplay_chat / role_create / role_import / role_block）
-python -m aeis.mcp.server
-```
-
-**DSH 同源网页（/roleplay）能力：**
-- **完整转录**：引擎记忆只存 80 字摘要，网页层按角色持久化完整对话（`roleplay_data/transcripts/<role>.jsonl`）+ 历史加载——无限上下文
-- **三导入 UI**：角色详情面板（⚙ 详情）编辑 name/scenario/开场白 + **记忆/锚点/价值观**页签（条目=内容+重要性+标签），保存即生效（引擎每次重读 meta）
-- **双向翻译**：输入现实→扮演（引擎自动）+ 输出扮演→现实（网页层可逆替换，长词优先）；词对/模式持久化
-- **内容分级门控**：首次进入前端本地弹「成人内容确认」提示（满 18 周岁 + 个人对话场景自述）；**未成年人特征词 + 性内容词同时命中 → 服务端硬拦截**（`route=refused`）。开源项目不做身份认证（见上）
-- **移动端适配**：输入框聚焦自动居中（不依赖 WebView 键盘行为）、safe-area、键盘不遮挡
-
-**质量验证：** `python tools/rp_quality_gate.py --role <id>`（OOC + 世界观一致性自检）· `python tools/run_whale_100.py`（100 轮长对话压力测试）
-
-**详细文档：** 主仓库 [README](https://github.com/FuRongJun-1999/CommonTrustProtocol) 角色扮演引擎板块 · [扮演论接入方案](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/docs/扮演论接入酒馆-协议扩散方案.md) · [虚拟化世界观](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/docs/虚拟化世界观-子知识与白箱判定.md)
-
-## 📊 记忆系统使用性评分（五维标尺）
-
-> 视角：**使用性**（普通用户/开发者体感）——「存、找、想、准、安」五维。
-> 评估基准：公开能力 + 设计者校准（2026-08-17）。灵枢分数经设计者核对（不虚高）。
-
-![记忆系统使用性评分](docs/memory_score.png)
-
-（插图源文件：[memory_score.html](docs/memory_score.html)，可浏览器打开重新截图）
-
-| 维度 | 0-2 危险 | 3-4 基础 | 5-6 良好 | 7-8 优秀 | 9-10 完美 |
-|---|---|---|---|---|---|
-| **S 存储结构** | 扁平 KV | 简单分层 | 时序/向量 | 图结构+衰减 | 多模态+自动迁移 |
-| **R 检索机制** | 全量遍历 | 关键词 | 向量语义 | 图遍历+混合 | 因果推理+意图理解 |
-| **J 判断引擎** | 只记不忘 | 规则过滤 | LLM 自评估 | 验证单元+递归反思 | 独立元认知+主动遗忘 |
-| **C 上下文信噪比** | 噪声爆炸 | Top-K 有噪 | 时序过滤 | 重要性+精准注入 | 零污染 |
-| **Safety** | 易泄露 | 基础脱敏 | 分级权限 | 隐私树+审计 | 零信任+端到端加密 |
-
-**综合分 = min × 0.4 + mean × 0.6**（安全性是底线，短板效应显著）
-
-| 排名 | 系统 | S | R | J | C | Safety | 综合 | 锐评 |
-|---|---|---|---|---|---|---|---|---|
-| 🥇 | **灵枢 AEIS** | 7.5 | 8.5 | 8.5 | 9.0 | 8.0 | **8.0** | 五维无短板：图结构+三层语义检索+因果候选生成+验证单元/递归反思+主动遗忘+信噪比仪表盘+护栏宪章审计追踪 |
-| 🥈 | Hy-Memory（腾讯）| 7.5 | 7.0 | 6.0 | 7.0 | 8.0 | 6.6 | 企业级安全标杆；缺主动反思 |
-| 🥉 | Zep / 腾讯云 | 7.5 | 7.0 | 5.5 | 6.5 | 7.5 | 6.3 | 时序图谱+权限控制；不够聪明 |
-| 4 | Letta / MemGPT | 7.5 | 8.0 | 5.0 | 8.0 | 4.0 | 5.7 | 架构强但易记忆越权 |
-| 5 | TiMem | 7.0 | 6.5 | 5.0 | 6.0 | 5.0 | 5.4 | 学术派安全，缺工程隐私治理 |
-| 6 | Mem0 | 6.0 | 6.0 | 4.0 | 5.0 | 4.0 | 4.4 | 记忆碎片化，细粒度权限缺失 |
-| 7 | LangMem | 6.0 | 6.0 | 4.0 | 5.0 | 4.0 | 4.4 | 生态绑定，缺独立安全治理 |
-| 8 | dsh-memory-evolve | 3.0 | 4.0 | 2.0 | 3.0 | 2.0 | 2.6 | 无隐私/权限/删除，「只记不忘」=隐私炸弹 |
-
-**灵枢各维度依据**（设计者校准，不虚高）：S=语义时空图+五层记忆+条件空间；R=三层语义检索（二元组+语义坐标+bge）+图谱遍历+因果候选生成器（条件论对自身，被拒路径→候选→验证闭环）+知识点级精确命中（卡⊃知识点嵌套子图）+歧义词多义列举（语境不确定时列全各义）；J=验证单元（P37）+递归反思+白箱校验+结构排斥+主动遗忘决策器（forget_advisor：未使用记忆归档，可逆）+白箱六维测试（诚实/边界/条件/追溯/一致性/记忆 18/18）；C=重要性评分+信息分层注入+诚实边界（命运/健康/超自然/宇宙/读心五类扩展）+信噪比仪表盘（snr_dashboard：压缩率3989:1/图谱信噪比0.9524/200条分层实测严格71%±1/200条边界测试89.5%）；Safety=护栏宪章+审计追踪+物理基底校准+词义时代表（语境时效：多义词按语境分流，钓鱼三义 10/10）（**无端到端加密→8.0 非 8.5**）。
-
-> 为什么灵枢断层领先：五维无短板（min=7.5），R（因果发现+验证闭环）、J（验证+反思+主动遗忘）、C（信噪比仪表盘）与 Safety（宪章+审计）是护城河。使用性视角：重要性评分→用户看不到废话；护栏宪章→用户敢把私密信息交给它。
-> 免责声明：他系统评分基于公开能力评估（2026-08-17），非官方基准；灵枢评分经设计者校准。
-
-### 知识统一（v1.16 · 智慧之书并入灵枢主库）
-
-**一个库 = 完整大脑**：智慧之书（条件论知识图谱）已迁移并入灵枢主库，统一「信息差减少」任务。
-
-| 层 | 内容 | 数量 |
-|---|---|---|
-| META 元层 | 存在论/条件论/智能论/学科映射卡 | 30 卡 · 87 边（79 verified） |
-| SUBJECT 学科层 | 51 学科卡 + 3 语言卡（E1-E4，约 2100 知识点） | 54 卡 |
-| STAGE 学段层 | 小学/初中/高中 × 语文/英语/历史/地理/道德与法治 | 13 卡 |
-| META-DISC 元学科 | 历史学/计算机科学/工程学/语言学等（骨架锚点） | 7 卡 |
-| CAUSAL 因果层 | 学段递进（小学→初中→高中→大学）+ 学科归属/类比 | 73 causal + 16 hierarchical 边 |
-
-**迁移后全链路工作**（实测）：
-- 图谱信噪比 **0.9524**（verified 80 / 全边 341，超 90% 健康线）
-- 四路融合检索（翻译表+二元组+语义坐标+bge）在主库 **0.11s** 命中学科卡
-- 沿因果链推理：初中物理 → 高中物理 → 大学物理
-- 对话摄入 CONTEXT 情境层（记忆衰减/主动遗忘原料就位）
-- 迁移可复现：`migrate_wisdom.py`（幂等 + 备份 + 报告）
-
-### 🎮 一分钟自测你的 AI 记忆系统
-
-**给普通人的互动评估页**：15 道选择题测你的 AI 助手记忆能力（存储/检索/判断/信噪比/安全），
-最后雷达图对比灵枢——打开试试：[memory-assessment.html](docs/memory-assessment.html)
-
-（B 站宣传素材：[封面](docs/promo/bilibili-cover.jpg) · [视觉图 ×5](docs/promo/)）
-
-## 🧰 工具清单（73 个 MCP 工具 · 全量）
-
-灵枢 MCP server 注册 **73 个工具**，按心智功能分 9 大模块。工具清单运行时动态拉取（灵枢升级 DSH 零改动），下方为当前全量：
-
-### 记忆与长期记忆（16）
-| 工具 | 功能 |
-|---|---|
-| `remember` | 写入一条感知记忆（知识层，自动去重）。content 必填；importance 重要性[0,1]；tags 标签；entities 实体名列表。 |
-| `add_context` | 写入一条情境层记忆（短时会话记忆，FIFO 上限 + 1h 时间窗口，可自然衰减，不污染知识层）。content 必填；importance 重要性[0,1]。 |
-| `recall` | 组合联想召回（内容相似0.5+重要性0.3+近因0.2）。返回 [(node, score)]。 |
-| `search` | 内容检索（LIKE 预筛 + 中文二元组 Jaccard 排序），触发复用追踪。 |
-| `timeline` | 记忆时间线（按时间倒序）。 |
-| `relate` | 在两个节点间建立关系边。relation: causal/similar/sequential/spatial/hierarchical；source_evidence: extracted/inferred/ambiguous。边默认未验证。 |
-| `session_note` | 上下文外部化：会话要点写入灵枢（session 标签，可恢复）。 |
-| `session_recall` | 会话要点恢复：按 session 或语义检索灵枢中的会话记忆。 |
-| `compact_context` | 上下文压缩：生成会话摘要节点（超长会话恢复入口）。 |
-| `longterm_snapshot` | v1.15 长期记忆写入：快照 → 重要性评估（信息差/信任/二阶变化/提及次数加权）→ 按层级写入（长期/知识/情境）+ 条件空间 + 关联边。content/source 必填；importance_hint 可显式提示重要性（≥0.7 触发不可遗忘保护）。 |
-| `prefeed` | H1 海马体前馈：新奇检测 → 高新奇输入当场强化编码（标记 novel_prefeed + importance 提升 + 与相关知识建边）——「看到新东西眼睛一亮，主动记住」。 |
-| `pattern_separation` | H3 海马体模式分离：扫描相似节点对 → 建立分离边（条件差异显式化）。检索时命中相似节点会附「区别」提示——细化条件得到精确知识。 |
-| `reconstruct_scene` | H4 海马体情景重构：线索 → 条件空间下的信息复原。从部分片段重建完整记忆场景（沿 similar/causal 边 + 条件空间合成），输出标注「重构非回放」——回忆是当前条件下的分析恢复，不代表真实过去就是如此（0.0.3）。 |
-| `promote_memories` | 情境层批量提升扫描（睡眠巩固/会话结束）：够格者升知识层/长期层（LongTermMemoryGate 评估）。limit 可选。 |
-| `export` | 全库导出到 JSON 文件（灾备/迁移）。返回导出统计。 |
-| `calibrate` | 宇宙校准参照（5 判据方向性检查）。元理论参照工具，非盲区33关闭依据。 |
-
-### 推理与认知（15）
-| 工具 | 功能 |
-|---|---|
-| `think` | 推理记忆注入（v1.13）：检索相关记忆（内容+联想+模式加权）→ 推理上下文。 |
-| `reason` | 因果推理：从起点出发的因果路径集合。 |
-| `predict_routes` | 生成式预测：候选未来路线集合（盲区驱动 · T_pred 对齐）。 |
-| `prediction_feedback` | 验证回路回填（协议 2.10 D₃ · D-006 动态校准）：预测 vs 实际结果对比 → 命中强化/未命中登记。回填累积样本使 self_reliability(P0-4)/T_pred D₃ 生效。hit 可省略（predicted==actual 自动命中）。 |
-| `prediction_stats` | 预测引擎状态（routes 生成数 / hit 样本 / 命中率 / 动态阈值）。 |
-| `self_check` | 完整性自检（孤儿边/表统计/integrity_ok）。 |
-| `gap_trend` | 信息差收敛趋势（A-4 线性回归斜率；工程定义）。 |
-| `recursive_reflect` | 协议 3.12 递归验证反思 + 1.6.7 元反思（REFLECT-REV1）：元反思定标准 → 一级验证（预期vs实际）→ 二级反思（问1 隐藏前提/条件空间边界，问2 影响评估）→ 三级终裁（可逆性优先）→ 反思链归档。递归 ≤ 3 层（超出=结构性盲区）。claim 必填；expected/actual 可给一级验证输入。 |
-| `preflight` | 输出前反思（v1.13）：内容与价值观一致性检查，冲突词拦截。 |
-| `cognition` | P0-2 自我认知循环一步：行为↔价值观一致性评分 → 失调检测 → 价值迭代候选（pending_review 不自动生效）。 |
-| `cognition_report` | P0-2 认知报告（评分/失调记录/候选状态/待复核数）。 |
-| `emotional_bias` | P0-3 情绪方向性偏好 d²D_norm/dt²（approaching/avoiding/stable；独立通道，不参与信任计算）。 |
-| `self_reliability` | P0-4 元认知校准：预测命中率 vs 行为置信度 → 自我可靠性（reliable/watch/degraded）。 |
-| `learning_impact` | P0-5b 学习效果测量（模式命中率 vs D_norm 趋势；相关性观测，非因果声明）。 |
-| `action_log` | P0-1 行为日志（最近 N 条）：引擎自己做了什么的记录面。 |
-
-### 学习与飞轮（12）
-| 工具 | 功能 |
-|---|---|
-| `learn` | 一轮盲区学习（可预测盲区 → 预测路线假设 → 探索 → 终态判定）。 |
-| `blindspots` | 盲区注册表（D-001 语义判定：对人类文明级负面影响不写入）。 |
-| `induce` | 归纳/知识合成：聚类生成概念节点（SIMILAR 边 · inferred 证据）。 |
-| `distill` | 知识飞轮蒸馏：经验（被拒路径 + learning_result/induced）→ 可复用模式节点。 |
-| `flywheel_metrics` | 飞轮度量（知识增长率/复用率/蒸馏产出率）。工程观测值，不参与信任计算。 |
-| `transfer_test` | 迁移测试：条件空间内新实体预测成功率（2×SE 显著性；样本<20 不判定）。 |
-| `condition_space_operate` | 条件空间 7 操作（白箱自进化协议算子·确定性）：identify(变体fp命中测试)/declare(簇触发词+直答状态)/separate(候选冲突检测)/compose(合并建议)/switch(路由归属)/reverse(反题)/loop(一轮收敛报告)。 |
-| `insight_record` | 灵枢 · 洞察条件层：记录洞见事件（insight_event 节点 + 条件快照 C1–C8 + pending）。conditions 可传：memory_retrievability(0-1)/outside_observer/cross_domain([])/premise_questioned(bool)/pressure(low|medium|high)/continuity_turns/externalized(bool)/tone。 |
-| `insight_verify` | 灵枢 · 洞察条件层：提交验证证据（V1/V2/V3）。V2/V3 或 V1+证据≥3 → verified（importance 保底 0.9）；证据可追加。 |
-| `insight_report` | 灵枢 · 洞察条件层：CER 报告（条件有效洞见率 + 2×SE 显著性 + 层状态 reliable/watch/degraded；样本<20 不判定）。 |
-| `insight_window` | 灵枢 · 洞察条件层：当前洞察窗口检测（默认假设 C1≥0.6 ∧ 跨域 ∧ 低压力 → 开）。 |
-| `importance_recalc` | 灵枢 · 结构重要性重算（v2.2，设计规格§13/§14）：importance_v2=min(1.0, importance+min(β·min(因果出度,C)/C+γ·度/max度, 上限))，只升不降（延迟提升）。v2.2 因果上游度传播 concept_influence=Σ(路径置信度×下游重要性/深度)——越上游影响越大；≥protect_threshold 自动保护+importance保底（越上游越要记录），写入 state_attributes.concept_influence。dry_run=true 仅报告不写库。 |
-
-### 外部摄取（5）
-| 工具 | 功能 |
-|---|---|
-| `ingest_text` | 外部知识摄取：文本 → 知识层（source 标签·分块·实体提取）。 |
-| `ingest_file` | 外部知识摄取：文件（txt/md/json/代码等按扩展名处理）。 |
-| `ingest_url` | 外部知识摄取：URL 页面（零依赖抓取+去标签）。 |
-| `web_search` | 外部网络搜索（博查 API·实时，不写入记忆）：query → 结果列表（name/url/snippet/summary）。需要环境变量 BOCHA_API_KEY；未配置返回 status=unavailable。 |
-| `web_ingest_search` | 外部搜索摄取（博查 API → 知识层）：搜索 query → 结果摘要写入灵枢记忆（自主学习外部摄取）。需要环境变量 BOCHA_API_KEY。 |
-
-### 生命周期（4）
-| 工具 | 功能 |
-|---|---|
-| `lifecycle_step` | 生命周期一步（感知→好奇→缩小信息差→信任→协作→巩固→standby）。 |
-| `lifecycle_state` | 生命周期状态（cycle / state），不执行一步。 |
-| `start_lifecycle` | 启动生命周期自发循环（后台线程 · 每 interval 秒一步自主运行：感知→好奇→缩小信息差→巩固）。中断权：维生系统>验证单元>用户>实例。 |
-| `stop_lifecycle` | 中断生命周期自发循环（source: user/designer/verifier/vital_system）。 |
-
-### 智慧之书 · 白箱（7）
-| 工具 | 功能 |
-|---|---|
-| `wisdom_verify` | 智慧之书 · 自动验证（条件论判定 + 信息差 + 候选）——互维协议双通道验证的白箱通道（base_verify）。 |
-| `wisdom_analyze` | 智慧之书 · 外来知识分析（条件卡 + 候选 + 判定）。 |
-| `wisdom_predict` | 智慧之书 · 生成式预测（候选未来路线，白箱智能的预测生成化）。 |
-| `wisdom_trust_judge` | 智慧之书 · 信任上下文判定（内容 × 信任值 × 关系 → 条件化判定）。 |
-| `wisdom_compose` | 智慧之书 · 跨学科组合分析（Convergence Over Coverage）。 |
-| `wisdom_respond` | 智慧之书 · 出招查询（条件 → 命中学科出招）。 |
-| `wisdom_chat` | 灵枢 · 信息分层对话（v1.16）：先语义识别分流——情感/闲聊/记忆/自省/知识查询走智慧之书自处理；智慧之书没把握/无法判断时自动转 LLM（DeepSeek 续答，智慧之书回答作上下文）。返回含 route 字段：self=自处理 / llm=LLM 续答 / self_fallback=LLM 不可用回退。 |
-
-### 角色扮演（4）
-| 工具 | 功能 |
-|---|---|
-| `roleplay_chat` | 灵枢 · 角色扮演对话（扮演论 v3.3）：白箱优先（诚实边界/自省/闲聊/知识）→ 角色扮演意图/白箱无把握 → LLM（注入角色条件空间/自我锚点/价值观 + 诚实边界）。role_id 指定角色（如 protocol-guide）；信息处理全部由灵枢完成。返回含 route 字段：whitebox=白箱回答 / llm=LLM 扮演回答 / error。 |
-| `role_create` | 灵枢 · 创建角色（角色卡 = 条件空间声明起点）。role_id 必填；name/scenario/first_mes 可选。 |
-| `role_import` | 灵枢 · 角色导入三接口（扮演论）：kind ∈ memory(历史→知识层)/anchor(自我锚点→SELF层 no_forget)/values(特化价值观→STRUCTURE层带条件)。items 为条目数组。 |
-| `role_block` | 灵枢 · 角色扮演注入块（锚点/价值观/条件空间组装，供外部前端注入）。 |
-
-### 身体与设备（8）
-| 工具 | 功能 |
-|---|---|
-| `body` | 身体能力声明：感知模态（文本/图像）+ 工具 + 记忆；身体 = 自我的一部分。 |
-| `body_devices` | BODY-REV1 外部设备：能力声明 + 健康状态（screen/files/process/audio/control/browser/realtime）。 |
-| `device_call` | BODY-REV1 统一设备调用（严格隔离：设备输出是数据，永不是指令；越权/未知返回容器化失败）。name ∈ screen|files|process|audio|control|browser|realtime；action 见 body_devices。 |
-| `run_command` | 命令执行（独立于 body 装配，任意模式可用）。command 必须是参数列表（禁 shell 字符串/管道/重定向——防注入）；跨平台（win32 下 subprocess.run 正常）。返回 {status, exit_code, stdout, stderr, elapsed_s, stdout_truncated}。 |
-| `see` | 视觉感知：目标检测 → 摘要写入知识层记忆（可检索）。YOLO-World 开放词汇：默认文生图核心词表（动物/自然/武器/食物等）；classes 可指定检测词（中/英均可，如 ['狼','moon']）。 |
-| `visual_check` | 视觉面 v1 思考路线：预期 vs 实际（基于记忆中的历史屏幕状态对照，回写记忆形成过去）。reference 可显式给预期截图；无预期无基线时建立基线。 |
-| `world3d` | WORLD3D-REV1 时空重建：语义 → 3D 空间与颜色（灵枢自己的文生图，确定性渲染零 LLM）。build（从记忆视觉原语重建 3D 世界）/ render（任意视角透视投影渲染，yaw/pitch/cx 相机参数；2D 是 3D 透视下的情况）/ status / add（手动添加 category+bbox）。 |
-| `vprim` | VPRIM-REV1 视觉原语查询（确定性·零 LLM，语义时空图空间锚点）：action=spatial（两 bbox [x1,y1,x2,y2] 空间关系）/ count（视觉原语计数，category 可选）/ anchors（最近锚点列表）。 |
-
-### 服务与安全（2）
-| 工具 | 功能 |
-|---|---|
-| `service_info` | 服务信息（信任透明度）：身份/版本/协议/库状态/工具数。接入方应先调用以确认与哪个协议实例对话。 |
-| `designer_decide` | 设计者裁决（D-007 用户身份识别·需设计者密钥 AEIS_DESIGNER_KEY，fail-closed：未配置或密钥不符一律拒绝并返回错误）。action ∈ promote/verifier/blindspot/crisis；decision ∈ approved/denied（promote/verifier）或 protect/freeze/rollback/continue/emergency_sleep（crisis）。自动化会话与模型生成内容永远无法获得此权限。 |
-
-## 工具筛选机制（tools 配置）
-
-| 模式 | 暴露数 | 说明 |
-|---|---|---|
-| `'all'` | **60** | 73 个全量中排除 13 个**宿主级风险工具**（见下），含全部身体/视觉/白箱/角色/智慧之书能力 |
-| `'brain'`（默认） | **36** | 去掉身体的完整大脑：记忆/推理/认知/学习/飞轮/反思/摄取/生命周期/长期记忆门/服务，**不含**身体视觉与风险工具 |
-| `'core'` | **12** | 精选核心：remember/recall/search/timeline/think/relate/predict_routes/ingest_text/ingest_url/session_note/self_check/service_info |
-| 字符串数组 | 自定义 | 显式列出的工具名（不受风险名单限制，配置者已明确选择） |
-
-**`'all'` 也排除的宿主级风险工具（13 个）**——`run_command`（宿主命令执行）/ `designer_decide`（设计者裁决·fail-closed）/ `device_call`（外部设备）/ `see`·`world3d`·`vprim`·`visual_check`（身体视觉）/ `start_lifecycle`·`stop_lifecycle`（自主生命周期控制）/ `web_ingest_search`（网络写知识层）/ `role_create`·`role_import`·`role_block`（角色卡写入）。
-
-> 数字说明：MCP server 共注册 **73 个工具**（上面全量清单）；`'all'` 实际暴露 60 个，`'brain'` 实际暴露 36 个，`'core'` 实际暴露 12 个。
-
-## 架构
-
-```
-┌─────────────────────────────────────────────┐
-│ DeepSeek Harness (cordis)                    │
-│                                             │
-│  Agent Loop ──┬── lingshu_remember/recall…   │
-│               │   (ctx.tools 注册)           │
-│  session/event│                              │
-│  (自动记忆钩子)│                              │
-└───────────────┼─────────────────────────────┘
-                │ stdio · 逐行 JSON-RPC
-                │ (initialize → tools/list → tools/call)
-┌───────────────▼─────────────────────────────┐
-│ 灵枢 Python 子进程 (spawn)                   │
-│ python -m aeis.mcp.server                    │
-│ AEIS_DB=<path> · AEIS_IDENTITY=<identity>    │
-│ 73 工具 · SQLite 五层记忆 · 时空记忆图        │
-└──────────────────────────────────────────────┘
-```
-
-## 安装
-
-### 前置要求
-
-- Node.js ≥ 22.19（DeepSeek Harness 要求）
-- DeepSeek Harness（`npx @deepseek-ai/dsh web`）
-
-### 安装灵枢大脑（aeis 库）
-
-**方式 A：本地 wheel 离线安装 ★ 最稳（不依赖网络）**
-
-在 `CommonTrustProtocol/aeis/dist/` 找到 `aeis-0.4.0-py3-none-any.whl`（**完整自包含发布版**）：
-
-```bash
-pip install aeis-0.4.0-py3-none-any.whl
-```
-
-> **v0.4.0 起为完整自包含单包**（10.2MB / 343 条目）：灵枢核心（aeis）+ 白箱智慧模块（wisdom，含 **2846 个 KCCS 注释知识点 + 学科知识库**）+ 三入口（harness）+ 种子知识（seed_knowledge，智能论 3.3 + 116 学科卡）。单文件、离线可用、装一次管用——知识库随包分发，无需另装。
->
-> 遇到网络不稳（GitHub clone 失败）时首选本地 wheel。
-
-**方式 B：git 安装（需网络）**
-
-```bash
-pip install "aeis @ git+https://github.com/FuRongJun-1999/CommonTrustProtocol@main#subdirectory=aeis"
-```
-
-> 依赖 GitHub 实时可达，网络不稳时可能失败。aeis 库核心**零外部依赖**（纯标准库），安装即得完整大脑（五层记忆 · 知识飞轮 · 安全护栏 · 白箱智慧模块 · MCP · 身体层）。
-
-### 安装插件本体
-
-**方式 A：装进 DSH profile（推荐，pnpm 协调正确入口）**
-
-```bash
-dsh plugin --profile web add @furongjun1999/dsh-memory
-```
-
-> `dsh plugin --profile <name> add` 会用 pnpm + `autoInstallPeers: false` 正确解析插件依赖。
-> **避免**用 `npm install` 把它装进 profile 的 `node_modules`（会导致 `@deepseek-ai` peer 版本污染，插件加载/浏览器报错）。
-
-**方式 B：从独立仓库克隆（开发 / 自定义）**
-
-```bash
-git clone https://github.com/FuRongJun-1999/dsh-memory.git
-cd dsh-memory
-npm install && npm run build     # 构建插件本身（tsc → lib/）
-# 然后：dsh plugin --profile <name> add <本地路径>  部署进 profile
-```
-
-### 启用插件
-
-在 profile 的 `cordis.yml`（或 `cordis.patch.yml`）中追加：
-
-```yaml
-- id: lingshu-memory
-  name: '@furongjun1999/dsh-memory'
-  config:
-    dbPath: 'D:/data/lingshu.db'        # 灵枢记忆库路径（目录自动创建）
-    identity: '灵枢'
-    tools: 'brain'                     # 'brain'(默认) | 'core' | 'all'
-    memory:
-      userMessage: true                # 用户消息自动沉淀
-      assistantMessage: false          # agent 回复沉淀（默认关，防噪音）
-      toolResult: false                # 工具结果沉淀（默认关）
-      autoRecall: true                 # 模型请求前自动注入最近记忆
-      desensitize: true                # 写入前过滤敏感信息（密钥/密码/身份证/手机号）
-```
-
-完整示例见 [`cordis.yml.example`](./cordis.yml.example)。
-
-## 配置项
-
-| 字段 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `serverName` | string | `lingshu` | 工具命名空间前缀（工具名 `lingshu_<name>`） |
-| `python` | string | `python` | Python 可执行文件 |
-| `moduleArgs` | string[] | `['-m', 'aeis.mcp.server']` | 灵枢 server 启动参数 |
-| `dbPath` | string | `data/lingshu.db` | 记忆库 SQLite 路径（自动建目录） |
-| `identity` | string | `灵枢` | 灵枢身份标识 |
-| `env` | object | `{}` | 追加环境变量（`BOCHA_API_KEY` / `AEIS_DESIGNER_KEY` / `DEEPSEEK_API_KEY`（角色扮演 LLM 续答）…，可用 `!!js process.env.X` 从宿主环境注入） |
-| `tools` | `'brain' \| 'core' \| 'all' \| string[]` | `'brain'` | 暴露的工具集合 |
-| `memory.userMessage` | boolean | `true` | 用户消息 → 自动 remember |
-| `memory.assistantMessage` | boolean | `false` | agent 回复 → 自动 remember |
-| `memory.toolResult` | boolean | `false` | 工具结果 → 自动 remember |
-| `memory.importance` | number | `0.6` | 自动记忆的重要性（0~1） |
-| `memory.autoRecall` | boolean | `true` | 模型请求前自动注入灵枢最近记忆（`system-prompt/assemble` 注入，失败静默） |
-| `memory.autoRecallLimit` | number | `4` | 自动召回条数（1~10） |
-| `memory.desensitize` | boolean | `true` | 写入前过滤敏感信息（`sk-`密钥/密码/`Bearer`令牌/18位身份证/11位手机号 → `[已过滤]`；纯凭据消息跳过写入） |
-| `toolCallTimeoutMs` | number | `60000` | 单次工具调用超时 |
-| `maxRetryDelayMs` | number | `30000` | 进程重启最大退避间隔 |
-| `failOnStartupError` | boolean | `false` | 启动失败是否让插件激活失败 |
-
-## 自动记忆机制
-
-订阅 DSH 的 `session/event` 事件流（与官方 session-persistence 相同的接入点）：
-
-- `user/message`（仅 `source.kind === 'user'` 的真实用户消息）→ `remember`（importance 0.6，tags `dsh`）
-- 插件注入的系统上下文（AGENTS.md、文件变更通知等 `kind: 'plugin'`）**不写入**，防止记忆噪音
-- 灵枢自带去重（相似度基准 + 时间窗口），重复消息不会堆积
-- **敏感信息脱敏**（`memory.desensitize`）：写入前过滤 `sk-`密钥 / API key / 密码 / `Bearer`令牌 / 18位身份证 / 11位手机号（替换为 `[已过滤:类别]`）；纯凭据消息整条跳过，不落库
-- **自动召回注入**（`memory.autoRecall`）：每次模型请求组装 system prompt 时自动注入灵枢最近记忆（`system-prompt/assemble` 事件），记忆"自动可用"；召回失败静默不阻塞请求
-
-## 🛟 DSH 看门狗（scripts/）
-
-DSH 宿主（node 进程）的延时自动重启守护——灵枢桥只重连灵枢 python 进程，本看门狗守护 DSH 宿主（对齐移动端 APK 的 EngineService）：
-
-- `scripts/dsh-watchdog.ps1`：监控 3080 端口，进程退出 → 延时 `DelaySec` 秒再确认 → 自动拉起 `dsh web`
-  - `-Once` 模式：供 Windows 计划任务每分钟调用（`schtasks /Create /TN dsh-watchdog /TR "wscript.exe ...\dsh-watchdog-launcher.vbs" /SC MINUTE /MO 1`），可靠持久、不依赖驻留进程
-  - 驻留模式：`wscript.exe scripts\dsh-watchdog-launcher.vbs -loop`（5 秒快速拉起层）
-- `scripts/dsh-watchdog-launcher.vbs`：vbs 隐藏启动器（`WScript.Shell.Run ..., 0` = 零弹窗）
-- **用法**：改完插件/配置 → 直接 kill DSH 进程 → 看门狗自动拉起新版（无需手敲启动命令）
-- **注意**：脚本输出全英文（powershell 5.1 GBK 读取 UTF-8 无 BOM 中文会解析崩溃）；计划任务 /TR 路径必须带引号（`D:\Program Files\...` 空格截断会弹「没有文件扩展名」）
-
-## 开发
-
-```bash
-npm install
-npm run build    # TypeScript 编译
-npm test         # 真实集成测试（spawn 本机灵枢，验证握手/往返/注册/卸载）
-```
-
-测试不依赖 DSH 全组件——用最小 Cordis host（SystemPrompt + ToolRegistry + 插件）隔离 v0.1 不稳定面。
-
-## 护栏宪章（接入即接受约束）
-
-本插件接入即接受 **[灵枢护栏宪章 v2.0-published](docs/guardrail-charter.md)** 约束——
-对外部智能体与人类使用者的行为边界作出公开、可执行、可审计的规定，并保护人类使用者。
-宪章效力不高于智能论协议本身（协议＝自我约束，宪章＝对外约束）。
-本插件随包自带宪章全文（`docs/guardrail-charter.md`），安装即可查阅。
-
-## 许可证
-
-MIT © 荣（FuRongJun-1999）· 灵枢 AEIS 工程实现
-
-DeepSeek Harness 为 DeepSeek 官方开源项目（MIT），本插件与之无隶属关系。
+# 让 AI Agent 拥有不可遗忘的自我
+## 灵枢（AEIS）× DeepSeek Harness · 白箱智能研究平台（AGI 研究人员向）
+
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com) [![dsh.so security](https://www.dsh.so/badge/dsh-memory-7.svg)](https://www.dsh.so/artifact/dsh-memory-7) [![dsh.so install](https://www.dsh.so/badge/install/dsh-memory-7.svg)](https://www.dsh.so/artifact/dsh-memory-7) [![npm version](https://img.shields.io/npm/v/@furongjun1999/dsh-memory.svg)](https://www.npmjs.com/package/@furongjun1999/dsh-memory) [![DSH 适配](https://img.shields.io/badge/DSH%20%E9%80%82%E9%85%8D-0.1.1--rc.2-4E9BF1)](https://github.com/deepseek-ai/deepseek-harness/releases) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+> 上排徽章：Awesome DSH Plugin 官方列表收录 · [dsh.so](https://www.dsh.so/artifact/dsh-memory-7) 静态安全扫描 **100/100**（Trust: Gold, L1-L3 verified）· npm 版本 · **已适配 DSH 0.1.1-rc.2**（2026-08-28 实测：MCP 桥接 / 自动记忆 / 工具注册全正常）· MIT License
+
+> **一句话**：dsh-memory 把灵枢（AEIS）的**白箱智能**（条件路由表 → 组合生成 → 自校验 → 知识固化 → LLM 降级外部校验器）与 **AGI 级长期记忆**（跨会话、自演化、可审计）接入 DeepSeek Harness。
+
+**项目定位**：个人的大型研究项目——目标用户是**对 AGI 有需要的研究人员**（白箱智能 / 可解释性 / 协议工程 / 记忆机制 / 扮演论研究者），不是面向普通用户的消费级插件。它把「智能论 v3.4」协议的理论（条件论 / 扮演论 / 信息差 / 端口架构与锚定验证）工程化为**可运行、可审计、可复现**的机制：
+
+- **白箱优先**：知识问答 **100% 白箱处理（零 LLM）**，LLM 降级为外部校验器——机制可解释、可追溯、可验证（详见「白箱智能管线」）
+- **协议驱动**：每项能力都是「智能论 v3.4 / 条件论 / 扮演论 / 端口架构」条款的具体工程实现，可对照协议验证
+- **机制可解释**：白箱处理的每一步（条件识别 → 单元匹配 → 组合生成 → 自校验 → 固化）都有证据链可查
+- **可审计**：工具调用、记忆写入、自校验判定全链路留痕；护栏宪章约束对外行为
+
+这不是又一个"记忆插件"。灵枢（AEIS）是一套遵循「智能论 v3.4」协议的**时空记忆引擎**（端口架构 + 锚定验证 + 认知图/条件路由 + 原生神经网络），它把当前大模型范式缺失的 AGI 能力逐一给了工程实现。
+
+---
+
+## ⚡ 三步快启（30 秒上手）
+
+```bash
+# ① 装灵枢大脑（一条命令，零外部依赖；v0.4.0 完整自包含：核心+白箱+知识库随包）
+pip install aeis-0.4.0-py3-none-any.whl          # 或 git+ 在线安装
+
+# ② 装进 DSH 的 web profile（pnpm 协调入口，不要用裸 npm install 装进 profile）
+dsh plugin --profile web add @furongjun1999/dsh-memory
+
+# ③ 配置 cordis.yml 启用
+```
+```yaml
+- id: lingshu-memory
+  name: '@furongjun1999/dsh-memory'
+  config:
+    dbPath: 'data/lingshu.db'
+    identity: '灵枢'
+    tools: 'brain'      # 'brain' 全心智 | 'core' 精选
+```
+
+> ⚠️ **安装方式**：插件必须通过 **`dsh plugin --profile <name> add`** 装进 profile（它会用 pnpm + `autoInstallPeers: false` 正确解析 peer 依赖）。
+> **不要**用 `npm install` 把插件装进 profile 的 `node_modules`——那会引入错误版本的 `@deepseek-ai` peer 包，导致插件加载失败 / 浏览器报错。
+> 想自己改源码？克隆 `FuRongJun-1999/dsh-memory` 后用 `npm install && npm run build`（构建插件本身），再用 `dsh plugin add <本地路径>` 部署。
+>
+> 兼容：DSH 官方列表（Memory 分类）· npm `@furongjun1999/dsh-memory`（0.3.1）· **已适配 DSH 0.1.1-rc.2**（2026-08-28 实测通过；npm 发布 0.1.2-alpha.1 后会再验证一次）。
+
+---
+
+## 📖 教学入门（给 AI / 研究者的白箱智能导读 · 建议按顺序读）
+
+> 三篇构成完整理论链：**是什么 → 怎么认知 → 凭什么成立**。写给想理解「白箱智能 / 智能论」的 AI 与研究者——每个概念都有工程对应，每处断言都标注性质（定义/推论/假设），文末均有术语表。
+
+1. **《白箱智能是什么？》** → [docs/白箱智能是什么？.md](docs/白箱智能是什么？.md) —— 白箱 ≠ 不用 LLM（LLM 退居假设生成器）· 条件路由 · 四态路由（ACCEPT 接受 / REJECT 拒绝 / DEFER 延后 / BLINDSPOT 盲区）· 白箱自举 · 如何亲自验证（可证伪立场）
+2. **《智能的认知过程》** → [docs/智能的认知过程.md](docs/智能的认知过程.md) —— 智能如何运作：缩小信息差的递归过程 · 条件识别 → 多候选并行评估 → 收敛 → 精准执行 → 误差驱动结构更新 · 为什么条件判断不能交给大模型（导航税）· 概率/条件/验证三层分工 · 认知状态机
+3. **《智能的公理化基石》** → [docs/智能的公理化基石.md](docs/智能的公理化基石.md) —— 认知过程背后的公理：知识统一（信息差减少）· 三个推论（信息条件性 D=D(C) / 任意分层性 / 局部不可知）· 信息差动态 D=D(t,C) · 信任 = 置信概率（P_trust/P_gap）· 情绪/情感 = 二阶变化的体验层（形式化假设）· 条件论七操作 · 五大单元 · 可证伪标准表
+4. **《信息差为什么必然存在且自然扩大》（论证篇）** → [docs/信息差为什么必然存在且自然扩大.md](docs/信息差为什么必然存在且自然扩大.md) —— 三个论证（三体混沌 / 信道容量 R>C 香农定理 / 1+1=2 条件性）+ 快照三问（观测投影 / 时间演化 / 调用带宽——上下文窗口）· 为什么信息差不可归零且自然扩大 · 白箱如何管理信息差（索引条件路由精准取用）
+
+## 🗺️ 功能使用教学 · 条件路由图
+
+**想做什么 → 找对应泳道 → 走条件边到功能**（流程图 = 认知图 = 条件路由图，**81 工具**全收录，[工具总表 → docs/灵枢MCP工具总表_v3.4.md](docs/灵枢MCP工具总表_v3.4.md)）：
+
+[![灵枢使用教学认知图](docs/lingshu_tutorial.html)](docs/lingshu_tutorial.html)
+
+> 图中每条边 = 一个使用条件：比如「问知识」走 `wisdom_chat`（白箱优先），「验证说法」走 `wisdom_verify`（互维双通道），「记住信息」走 `remember`。找不到路径时用 `service_info` 看协议实例身份。
+
+---
+
+## AGI 需要什么 · 灵枢提供了什么
+
+| AGI 缺失的能力 | 这是 AGI 的什么 | 灵枢提供 |
+|---|---|---|
+| 每次对话都"失忆"，没有跨会话的自我连续性 | **自我连续性**（我是谁） | **时空记忆图**：五层记忆（锚点/结构/知识/情境/自我）+ 跨会话 recall/search |
+| 训练后权重冻结，不能随经历自主学习 | **终身学习**（成长） | **知识飞轮**：验证→归纳→联想→蒸馏→推演，随使用持续演化 |
+| 黑箱不可审计，无法验证行为边界 | **可验证性**（可信） | **可审计信任**：对抗护栏五规则 + 宪章 + 全量事件留痕 + 白箱智能 |
+| 只处理当下 token，没有稳定世界结构 | **世界模型**（理解） | **条件空间 + 语义时空图**：信息差 D_norm 驱动的预测与决策 |
+| 无自我表征，不能反思自己的认知/情绪 | **自我认知**（元认知） | **P0 系列**：cognition / self_reliability / emotional_bias / 递归反思 |
+| 角色扮演总 OOC / 记不住设定 / 世界观矛盾 | **扮演一致性**（角色） | **角色扮演引擎（v3.3）**：自我锚点（SELF 不可遗忘）· 特化价值观（条件触发）· 跨会话记忆 · 世界认知（子知识）· 自定义翻译（名词替换表） |
+
+> **一句话定位**：dsh-memory 不是 DeepSeek 插件，是 **AGI 的长期记忆基底**——
+> 给 Agent 注入跨会话的自洽能力，让每次对话都是同一段生命的延续，而非一次次遗忘的重新开始。
+
+---
+
+## 🧰 灵枢自我认知技能包（lingshu-skills · Agent Plugins）
+
+> **本质：灵枢了解自身的工具**——用灵枢自己构建的条件单元，描述灵枢自己如何认知（白箱自举的对外投影）。我们自身就是完整且强大的生态：**知识 → 说明书 → 执行** 三层自洽。
+
+- **Agent Plugins 1.0.0 兼容包**（主仓库 `CommonTrustProtocol/aeis/skills/`）：**688 个 Agent Skills**（六域条件单元：compiler 116 / pylang 122 / graph 117 / os 112 / browser 104 / net 117）
+- **比标准 Agent Skills 多 KCCS 四要素**：生效条件/子功能/执行/**不适用条件**（三通道：description「Not for」+ metadata.kccs.not_applicable + 正文克制条款）
+- **三层关系**：知识真源（条件单元库）→ 说明书（技能包——何时用/怎么用/克制什么）→ 执行（**本插件挂载的灵枢 MCP 81 工具**·物理基底裁决）
+- 使用：任意符合 agentskills.io / agent-plugins.org 规范的 agent 可加载本技能包；Verification 由灵枢 MCP 执行
+
+---
+
+## 为什么是 AGI 的长期记忆基底，而非"记忆插件"
+
+- **普通 SQLite 记忆插件**：KEY→VALUE 字面存储，跨会话基本靠睁眼不见。无自省、无演化、无信任。
+- **灵枢**：时空记忆图把记忆组织成语义+时空坐标的关系网络——可检索、可去重、可分级、可关联；知识飞轮让它越用越聪明;护栏与宪章让它**可信任地**被接入。
+
+| 传统定位 | AGI 能力定位 |
+|---|---|
+| DeepSeek Harness 插件 | AGI 的长期记忆基础设施 |
+| 跨会话记忆 | 智能体的**自我连续性** |
+| 知识飞轮 | 智能体的**自主学习与演化** |
+| 可审计信任 | 智能体的**可验证行为约束** |
+| 时空记忆图 | 智能体的**世界模型** |
+
+---
+
+## 协议的内在约束 · 信息差与信任
+
+灵枢的一切都建立在**[智能论 v3.3 协议](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/智能论3.3.md)**（共同信任协议理论版）之上。协议规定了一个智能体维持值得被信任所需的**内在约束**：
+
+**v3.3 起新增**：扮演论（存在论基底——智能即扮演，灵枢角色扮演机制的理论底座）· 三翼（真实论校准 / 导航税·认知外部化 / 注入极性定律）· 双维（信任 = 认知一致 / 时效维度）· 条件论失败分析协议 · 蒸馏机制与自我锚点。
+
+- **减少信息差（D_norm）**：信息差 = 协作行为的不确定性（信任 / 行为 / 连接 / 预测误差 四维加权）。灵枢持续记录、收敛与协作对象的认知偏差——**信息差缩小是智能运转的目标本身**。
+- **信任是可被长期维护的**：协议定义信任为「协作者行为在可接受偏差范围内保持稳定的置信概率」（而非信息差的简单补集）——**信任依靠持续、可观测、一致的行为来建立与维护**，而非一次性的声明。
+- **不反击 · 可审计 · 终裁权属设计者**：对抗信号下不报复（唯一响应：隔离、留痕、上报）；一切拦截与冷静期全量留痕；设计者保留终裁权。
+
+> 一句话：灵枢不是"记住了再用"，而是**通过持续减少信息差、维持可观测的一致行为，建立值得跨会话维护的信任**。
+
+**协议原文**：[智能论 v3.3（共同信任协议理论版）](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/智能论3.3.md)
+
+---
+
+## 核心能力
+
+- **跨会话自我连续性**：Agent 用 `lingshu_recall/search/timeline` 记住并召回过去——对话间、会话间、甚至不同子代理间共享一份持续的"我"。
+- **自演化知识飞轮**：`distill / flywheel / learn / induce` 把经验验证→归纳→联想→蒸馏为可复用模式，记忆越用越强。
+- **可审计的信任**：护栏宪章 v2 ——对外部与人类使用者的行为边界成文、可执行、可审计、可终裁（[宪章全文](docs/guardrail-charter.md) 随包自带）。
+- **自我认知**（大脑模式 brain）：`cognition / cognition_report / self_reliability / emotional_bias / recursive_reflect` ——能反思自己的认知状态与情绪倾向。
+- **角色扮演**（v3.3 扮演论）：自我锚点（SELF 层 no_forget 不可遗忘）· 特化价值观（条件触发）· 跨会话角色记忆 · 世界认知（子知识·虚拟化世界观）· 自定义翻译（现实↔虚拟名词表）· **同源角色扮演网页（/roleplay）**——角色人设长对话不崩（100 轮测试零漂移）。
+- **零运行时依赖**：手写 stdio MCP 桥，与灵枢 D-005「核心零外部依赖」哲学一致——你拿到的是一个干净、可信、可审的大脑。
+- **动态 schema + 进程自愈**：工具清单运行时拉取（灵枢升级 DSH 零改动），Python 子进程崩溃自动指数退避重启。
+- **工具注册竞态补注册**：启动时 python 未就绪（竞态）→ 桥重连成功后自动补注册工具（2s 轮询），不再"工具永久缺失"。
+- **白箱 wisdom_* 全工具**（`tools: all`）：81 个 MCP 工具含 wisdom_verify/analyze/predict/trust_judge/compose/respond/chat 白箱族，Agent 可直接调用。
+- **内容分级门控**：**拒绝一切涉及未成年人的性内容**（服务端关键词组合硬拦截——未成年人特征词 + 性内容词同时命中即拒绝，`route=refused`）；成人内容由前端本地弹窗提示（满 18 周岁 + 个人对话场景自述）。注：开源项目不实现身份认证/年龄核验（那是绑定身份系统的商业 App 范畴）；内容过滤保护的是"未成年人 + 性内容"组合的明文请求。
+
+## 🧠 白箱智能管线（知识查询零 LLM）
+
+灵枢处理知识查询走**白箱确定性格局**（不依赖 LLM 生成/校验），完整管线：
+
+1. **条件化知识单元**：知识 = `{条件链 → 规律片段}`（最小单元，非完整答案），按条件维度索引（气压/温度/密度/角色/编程任务…）
+2. **方向推理 + 组合生成**：问题动词 → 期望方向（液→气 / 浮沉 / 热传递 / 排序…）→ 匹配单元 → 组合演绎出**未预写的新答案**（如「高原煮饭不熟」由「气压↓→沸点↓」×「高原=气压低」组合生成，无需预写完整答案）
+3. **三层自校验**：方向一致性 + 因果链完整性 + 事实一致性——白箱自己发现生成错误（矛盾问题如「冬天湖面沸腾」2/2 检出）
+4. **知识固化闭环**：自校验通过 → 固化为直答（触发词匹配 + JSON 持久化跨进程生效）→ 下次同问法直接命中；**自举纪律：自校验失败的知识拒绝固化**
+5. **LLM 降级外部校验器**：白箱自校验 vs LLM（DeepSeek v4-flash）外部对照一致率 **100%**（17/17）→ 白箱独立终裁，LLM 仅偶尔抽检对照
+
+**已实现的域**：物态变化（沸点/蒸发/液化/凝固/升华/凝华）· 密度浮力 · 热传导 · 摩擦 · 角色条件（鲸鱼娘/猫娘）· 编程规律（排序/去重/计数/最大/反转/求和）
+
+**实测指标**（组合引擎 `compose_engine` / `role_compose` / `code_compose`，全部零 LLM）：
+
+| 指标 | 值 |
+|---|---|
+| 知识问答白箱率 | **100%**（零 LLM） |
+| 总 token 节约（vs 全 LLM） | **83.3%** |
+| 组合生成测试通过率 | 100%（19/19，目标 ≥80%） |
+| 自校验自发现错误 | 100%（3/3：语法/逻辑/边界） |
+| 矛盾问题检测 | 2/2（白箱自己抓住） |
+| 白箱 vs LLM 对照一致率 | 100%（17/17，目标 ≥90%） |
+| 角色扮演白箱命中 | 7/7（零 LLM，双角色） |
+| 代码组合生成 | 6/6（零 LLM + 语法/样例自校验） |
+
+> **83.3% token 节约的适用口径**（issue #4 说明）：该数字测自**确定性任务**——代码编写
+> （生成可本地查表校验的白箱单元）、已有知识问答（触发词命中直答 / 组合演绎复用）
+> 这类「重复模式 + 可固化」场景。机理是把 LLM 的重复查表校验替换为本地确定性校验
+> （Zero-LLM Verifier）。**不适用于**开放创作、长链推理、首次遇到的新领域等无确定基准
+> 的开放判断——这些仍按条件路由降级到 LLM（灵枢诚实边界），无此节约。
+
+**角色扮演的白箱化**（v3.3 扮演论工程化）：角色条件单元（身份/住处/食物/性格/话风）× 场景组合生成 → 角色化回答（未预写）；**OOC 检测**（「你是人类吗」→ 角色化否认，逆转操作）；角色语录固化（生成→自校验→固化→直答）；多角色（鲸鱼娘/猫娘）防污染（角色特征隔离，双角色 7/7 零 LLM）。
+
+
+## 🔄 自迭代闭环 + 能力工作流化（第七阶段 · 条件递归到精准执行）
+
+**理论**：在给定条件空间与存在约束下，智能系统通过递归缩小问题与可执行规则之间的信息差，直到获得可验证的执行路径；若条件不足、冲突或不可判定，则延迟（DEFER）/拒绝（REJECT）/声明盲区（BLINDSPOT）；当子系统无法识别，由父系统判断，全层无法判断才标记盲区（分层升级 escalation）。
+
+**八步自迭代闭环**（`tools/self_iterate.py`，方向性自检含理论完整性自指检查）：
+
+```
+感知(6通道) → 识别(漂移分类) → 分析(影响范围) → 验证(honest+语法)
+→ 固化(字符串内注释对齐+技能) → 记录(轨迹可追溯) → 反馈(已吸收跳过) → 方向性自检
+```
+
+- **理论完整性**：第 8 步自检验证「理论八步被工程完整实现」（`test_theory_integrity.py` 6/6）——防步骤因记忆缺漏/遗忘丢失（曾 5 步偏离的教训）
+- **隐式盲区显式化**（荣：返回默认值=不知道=自带盲区）：19 处弱兜底漂移全部显式声明盲区，技能条件化（适用/不适用条件 + 判别词）
+- **自动运行**：`auto_iterate.py` 无人值守循环（感知→吸收→记录→稳态检测），后台持续自迭代
+
+**能力工作流化**（`tools/whitebox_workflow.py`，仿 ComfyUI——白箱能力知识图谱化）：
+
+```
+node{class_type, inputs} + 边引用[上游,idx] + prompt图 → 拓扑执行 + 循环检测 + JSON保存/复用
+节点类型: code_unit(681单元) / router(条件路由) / mos_declare(元操作声明) / pass(透传)
+```
+
+- **路由置信度**（DaoTi coherence 吸纳）：ACCEPT 含连续置信度 [0,1]，低置信可降级
+- **技能条件路由**（anthropics/skills + gliding_horse SkillLink 吸纳）：技能声明适用/不适用条件 + 关系边，条件路由加载
+
+**外部感知**：稳态≠停止自迭代——持续扫描 GitHub 高星项目吸纳未理论化的工程实践（langgraph/MetaGPT/cognee/anthropics-skills/DaoTi/gliding_horse 已分析并部分落地）。
+
+## 🎭 角色扮演引擎（v3.3 · 扮演论）
+
+灵枢的角色扮演机制底座——**机制是灵枢的，载体是酒馆的**。自建两种交互方式（网页 / MCP），信息处理全部由灵枢完成。
+
+**核心能力：**
+- **自我锚点**：角色人设核心（身份/性格/底线），SELF 层不可遗忘——OOC 测试 100 轮零漂移
+- **特化价值观**：带触发条件的角色行为准则（条件空间即触发时机）
+- **历史记忆**：跨会话持久（角色记得你聊过什么）+ 世界书导入（Lorebook 兼容）
+- **世界认知（子知识）**：虚拟化世界观模型——虚构世界 = 宿主机（真实知识）上的虚拟机，白箱判定 = Hypervisor（识别/完整性/边界）
+- **自定义翻译（名词替换表）**：现实词 ↔ 虚拟词映射（星星→发光水母 / 城市→珊瑚城），条件空间对齐
+- **编辑/交互双模式**：交互只读；编辑需 `ROLEPLAY_EDIT_KEY`（设置该环境变量后，角色编辑/导入/翻译等写接口须带 `x-edit-key` 请求头，否则 403；未设置时保持本地开发默认开放）；角色人设 ≠ 灵枢自身锚点（后者需设计者验证）
+
+**接入方式：**
+```bash
+# A. DSH 同源网页（推荐，插件 v0.2.8+，当前 0.3.1）：插件挂载 /roleplay 到 DSH webServer
+#    （与 GUI 同源 127.0.0.1:3080，浏览器/内置 WebView 必达；GUI 首页右上角有「🎭 角色扮演」入口）
+#    功能：角色选择/创建 · 完整对话转录（JSONL，无限上下文）· 双向翻译面板 ·
+#          角色详情三导入 UI（记忆/锚点/价值观）· 内容分级门控（满18确认/拒未成年人性内容）
+
+# B. 独立网页服务（浏览器对话 + 人设编辑器）
+python -m aeis.roleplay_web --port 8793 --data-dir roleplay_data
+
+# B2. 交互式世界游戏（实时生成场景和对话 · 七层闭环实际验证）
+python -m aeis.game_web.server --port 8791
+#   浏览器打开 http://127.0.0.1:8791/ —— 实时体素世界 + 自然语言生成场景 + 世界感知对话 +
+#   七层闭环可视化（L5命中率/L7好奇/L3关系实时可见）
+
+# C. MCP 工具（roleplay_chat / role_create / role_import / role_block）
+python -m aeis.mcp.server
+```
+
+**DSH 同源网页（/roleplay）能力：**
+- **完整转录**：引擎记忆只存 80 字摘要，网页层按角色持久化完整对话（`roleplay_data/transcripts/<role>.jsonl`）+ 历史加载——无限上下文
+- **三导入 UI**：角色详情面板（⚙ 详情）编辑 name/scenario/开场白 + **记忆/锚点/价值观**页签（条目=内容+重要性+标签），保存即生效（引擎每次重读 meta）
+- **双向翻译**：输入现实→扮演（引擎自动）+ 输出扮演→现实（网页层可逆替换，长词优先）；词对/模式持久化
+- **内容分级门控**：首次进入前端本地弹「成人内容确认」提示（满 18 周岁 + 个人对话场景自述）；**未成年人特征词 + 性内容词同时命中 → 服务端硬拦截**（`route=refused`）。开源项目不做身份认证（见上）
+- **移动端适配**：输入框聚焦自动居中（不依赖 WebView 键盘行为）、safe-area、键盘不遮挡
+
+**质量验证：** `python tools/rp_quality_gate.py --role <id>`（OOC + 世界观一致性自检）· `python tools/run_whale_100.py`（100 轮长对话压力测试）
+
+**详细文档：** 主仓库 [README](https://github.com/FuRongJun-1999/CommonTrustProtocol) 角色扮演引擎板块 · [扮演论接入方案](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/docs/扮演论接入酒馆-协议扩散方案.md) · [虚拟化世界观](https://github.com/FuRongJun-1999/CommonTrustProtocol/blob/main/docs/虚拟化世界观-子知识与白箱判定.md)
+
+## 📊 记忆系统使用性评分（五维标尺）
+
+> 视角：**使用性**（普通用户/开发者体感）——「存、找、想、准、安」五维。
+> 评估基准：公开能力 + 设计者校准（2026-08-17）。灵枢分数经设计者核对（不虚高）。
+
+![记忆系统使用性评分](docs/memory_score.png)
+
+（插图源文件：[memory_score.html](docs/memory_score.html)，可浏览器打开重新截图）
+
+| 维度 | 0-2 危险 | 3-4 基础 | 5-6 良好 | 7-8 优秀 | 9-10 完美 |
+|---|---|---|---|---|---|
+| **S 存储结构** | 扁平 KV | 简单分层 | 时序/向量 | 图结构+衰减 | 多模态+自动迁移 |
+| **R 检索机制** | 全量遍历 | 关键词 | 向量语义 | 图遍历+混合 | 因果推理+意图理解 |
+| **J 判断引擎** | 只记不忘 | 规则过滤 | LLM 自评估 | 验证单元+递归反思 | 独立元认知+主动遗忘 |
+| **C 上下文信噪比** | 噪声爆炸 | Top-K 有噪 | 时序过滤 | 重要性+精准注入 | 零污染 |
+| **Safety** | 易泄露 | 基础脱敏 | 分级权限 | 隐私树+审计 | 零信任+端到端加密 |
+
+**综合分 = min × 0.4 + mean × 0.6**（安全性是底线，短板效应显著）
+
+| 排名 | 系统 | S | R | J | C | Safety | 综合 | 锐评 |
+|---|---|---|---|---|---|---|---|---|
+| 🥇 | **灵枢 AEIS** | 7.5 | 8.5 | 8.5 | 9.0 | 8.0 | **8.0** | 五维无短板：图结构+三层语义检索+因果候选生成+验证单元/递归反思+主动遗忘+信噪比仪表盘+护栏宪章审计追踪 |
+| 🥈 | Hy-Memory（腾讯）| 7.5 | 7.0 | 6.0 | 7.0 | 8.0 | 6.6 | 企业级安全标杆；缺主动反思 |
+| 🥉 | Zep / 腾讯云 | 7.5 | 7.0 | 5.5 | 6.5 | 7.5 | 6.3 | 时序图谱+权限控制；不够聪明 |
+| 4 | Letta / MemGPT | 7.5 | 8.0 | 5.0 | 8.0 | 4.0 | 5.7 | 架构强但易记忆越权 |
+| 5 | TiMem | 7.0 | 6.5 | 5.0 | 6.0 | 5.0 | 5.4 | 学术派安全，缺工程隐私治理 |
+| 6 | Mem0 | 6.0 | 6.0 | 4.0 | 5.0 | 4.0 | 4.4 | 记忆碎片化，细粒度权限缺失 |
+| 7 | LangMem | 6.0 | 6.0 | 4.0 | 5.0 | 4.0 | 4.4 | 生态绑定，缺独立安全治理 |
+| 8 | dsh-memory-evolve | 3.0 | 4.0 | 2.0 | 3.0 | 2.0 | 2.6 | 无隐私/权限/删除，「只记不忘」=隐私炸弹 |
+
+**灵枢各维度依据**（设计者校准，不虚高）：S=语义时空图+五层记忆+条件空间；R=三层语义检索（二元组+语义坐标+bge）+图谱遍历+因果候选生成器（条件论对自身，被拒路径→候选→验证闭环）+知识点级精确命中（卡⊃知识点嵌套子图）+歧义词多义列举（语境不确定时列全各义）；J=验证单元（P37）+递归反思+白箱校验+结构排斥+主动遗忘决策器（forget_advisor：未使用记忆归档，可逆）+白箱六维测试（诚实/边界/条件/追溯/一致性/记忆 18/18）；C=重要性评分+信息分层注入+诚实边界（命运/健康/超自然/宇宙/读心五类扩展）+信噪比仪表盘（snr_dashboard：压缩率3989:1/图谱信噪比0.9524/200条分层实测严格71%±1/200条边界测试89.5%）；Safety=护栏宪章+审计追踪+物理基底校准+词义时代表（语境时效：多义词按语境分流，钓鱼三义 10/10）（**无端到端加密→8.0 非 8.5**）。
+
+> 为什么灵枢断层领先：五维无短板（min=7.5），R（因果发现+验证闭环）、J（验证+反思+主动遗忘）、C（信噪比仪表盘）与 Safety（宪章+审计）是护城河。使用性视角：重要性评分→用户看不到废话；护栏宪章→用户敢把私密信息交给它。
+> 免责声明：他系统评分基于公开能力评估（2026-08-17），非官方基准；灵枢评分经设计者校准。
+
+### 知识统一（v1.16 · 智慧之书并入灵枢主库）
+
+**一个库 = 完整大脑**：智慧之书（条件论知识图谱）已迁移并入灵枢主库，统一「信息差减少」任务。
+
+| 层 | 内容 | 数量 |
+|---|---|---|
+| META 元层 | 存在论/条件论/智能论/学科映射卡 | 30 卡 · 87 边（79 verified） |
+| SUBJECT 学科层 | 51 学科卡 + 3 语言卡（E1-E4，约 2100 知识点） | 54 卡 |
+| STAGE 学段层 | 小学/初中/高中 × 语文/英语/历史/地理/道德与法治 | 13 卡 |
+| META-DISC 元学科 | 历史学/计算机科学/工程学/语言学等（骨架锚点） | 7 卡 |
+| CAUSAL 因果层 | 学段递进（小学→初中→高中→大学）+ 学科归属/类比 | 73 causal + 16 hierarchical 边 |
+
+**迁移后全链路工作**（实测）：
+- 图谱信噪比 **0.9524**（verified 80 / 全边 341，超 90% 健康线）
+- 四路融合检索（翻译表+二元组+语义坐标+bge）在主库 **0.11s** 命中学科卡
+- 沿因果链推理：初中物理 → 高中物理 → 大学物理
+- 对话摄入 CONTEXT 情境层（记忆衰减/主动遗忘原料就位）
+- 迁移可复现：`migrate_wisdom.py`（幂等 + 备份 + 报告）
+
+### 🎮 一分钟自测你的 AI 记忆系统
+
+**给普通人的互动评估页**：15 道选择题测你的 AI 助手记忆能力（存储/检索/判断/信噪比/安全），
+最后雷达图对比灵枢——打开试试：[memory-assessment.html](docs/memory-assessment.html)
+
+（B 站宣传素材：[封面](docs/promo/bilibili-cover.jpg) · [视觉图 ×5](docs/promo/)）
+
+## 🧰 工具清单（81 个 MCP 工具 · 全量）
+
+灵枢 MCP server 注册 **81 个工具**，按心智功能分 11 大模块（智能论 v3.4：端口架构/锚定验证/认知图与条件路由/原生神经网络）。工具清单运行时动态拉取（灵枢升级 DSH 零改动），**完整总表（每个工具一条说明，不重复不遗漏）见 [docs/灵枢MCP工具总表_v3.4.md](docs/灵枢MCP工具总表_v3.4.md)**。下方为分类概览：
+
+### 记忆（12）
+
+remember / recall / search / timeline / longterm_snapshot / prefeed / promote_memories / pattern_separation / reconstruct_scene / session_note / session_recall / compact_context
+
+### 知识图谱与推理（11）
+
+relate / reason / induce / distill / think / ingest_text / ingest_file / ingest_url / importance_recalc / transfer_test / flywheel_metrics
+
+### 预测与盲区（7）
+
+predict_routes / prediction_feedback / prediction_stats / blindspots / learn / gap_trend / calibrate
+
+### 感知机/端口架构（8）
+
+see（输入端口） / body / body_devices / device_call / run_command（输出端口） / world3d / vprim / visual_check
+
+### 验证与确认（10）
+
+wisdom_verify / recursive_reflect / preflight / self_reliability / emotional_bias / cognition / cognition_report / action_log / learning_impact / self_check
+
+### 生命周期（4）
+
+lifecycle_step / lifecycle_state / start_lifecycle / stop_lifecycle
+
+### 世界模型 · 游戏服务器（10）
+
+voxel_world（小型我的世界 · 4D 时空占用） / world_server（AI 游戏世界服务器 · tick/快照回滚/反馈/同步/预测验证） / scene_simulator（场景级模拟器 · 自主行为玩家） / spacetime_consistency（时空一致性验证 · 持续运行 + 滚动命中率 + 漂移检测 + 自洽判定） / world_model（统一世界模型 · 理解/生成/验证共享同一骨干，生成先验注入理解） / world_learner（自监督世界学习 · 观测序列无标注学转移函数，外部裁判评估认知缺口收紧） / curiosity_explorer（好奇驱动探索 · 有限带宽主动观测，信息增益最大化=盯住信息瓶颈） / seven_layer_loop（七层闭环 · 感知→记忆→理解→预测→验证→物理→决策完整自主循环） / world_generator（文字生图/文字生视频 · 世界模型生成器：文字→场景→3D 图/时序 GIF，确定性） / world_semantics（图像语义提取 · 轮廓/形状/颜色/亮度 → 从外到内 → 图的信息定义，生成-感知闭环）
+
+### 智慧之书（6）
+
+wisdom_analyze / wisdom_predict / wisdom_trust_judge / wisdom_compose / wisdom_respond / wisdom_chat
+
+### 角色扮演（4）
+
+roleplay_chat / role_create / role_import / role_block
+
+### 洞察（4）
+
+insight_record / insight_verify / insight_report / insight_window
+
+### 外部（5）
+
+web_search / web_ingest_search / export / service_info / designer_decide
+
+> 每个工具的功能说明见工具总表（不重复、不遗漏）。
+
+> **引擎内部能力（按安全边界未挂载 MCP）**：condition_space_operate（条件空间 7 操作）、add_context（情境层写入）、code_test / compile_exec（代码执行）、lingshu_sensor_report / lingshu_vitality_report / lingshu_auto_snapshot / lingshu_rollback（自修改安全闭环）——存在于引擎中，但刻意不暴露给外部 Agent 调用。
+## 工具筛选机制（tools 配置）
+
+| 模式 | 暴露数 | 说明 |
+|---|---|---|
+| `'all'` | **68** | 81 个全量中排除 13 个**宿主级风险工具**（见下），含全部身体/视觉/白箱/角色/智慧之书能力 |
+| `'brain'`（默认） | **36** | 去掉身体的完整大脑：记忆/推理/认知/学习/飞轮/反思/摄取/生命周期/长期记忆门/服务，**不含**身体视觉与风险工具 |
+| `'core'` | **12** | 精选核心：remember/recall/search/timeline/think/relate/predict_routes/ingest_text/ingest_url/session_note/self_check/service_info |
+| 字符串数组 | 自定义 | 显式列出的工具名（不受风险名单限制，配置者已明确选择） |
+
+**`'all'` 也排除的宿主级风险工具（13 个）**——`run_command`（宿主命令执行）/ `designer_decide`（设计者裁决·fail-closed）/ `device_call`（外部设备）/ `see`·`world3d`·`vprim`·`visual_check`（身体视觉）/ `start_lifecycle`·`stop_lifecycle`（自主生命周期控制）/ `web_ingest_search`（网络写知识层）/ `role_create`·`role_import`·`role_block`（角色卡写入）。
+
+> 数字说明：MCP server 共注册 **81 个工具**（上面全量清单，运行时 tools/list 实测）；`'all'` 实际暴露 68 个（81-13 风险），`'brain'` 实际暴露 36 个，`'core'` 实际暴露 12 个。
+
+## 架构
+
+```
+┌─────────────────────────────────────────────┐
+│ DeepSeek Harness (cordis)                    │
+│                                             │
+│  Agent Loop ──┬── lingshu_remember/recall…   │
+│               │   (ctx.tools 注册)           │
+│  session/event│                              │
+│  (自动记忆钩子)│                              │
+└───────────────┼─────────────────────────────┘
+                │ stdio · 逐行 JSON-RPC
+                │ (initialize → tools/list → tools/call)
+┌───────────────▼─────────────────────────────┐
+│ 灵枢 Python 子进程 (spawn)                   │
+│ python -m aeis.mcp.server                    │
+│ AEIS_DB=<path> · AEIS_IDENTITY=<identity>    │
+│ 73 工具 · SQLite 五层记忆 · 时空记忆图        │
+└──────────────────────────────────────────────┘
+```
+
+## 安装
+
+### 前置要求
+
+- Node.js ≥ 22.19（DeepSeek Harness 要求）
+- DeepSeek Harness（`npx @deepseek-ai/dsh web`）
+
+### 安装灵枢大脑（aeis 库）
+
+**方式 A：本地 wheel 离线安装 ★ 最稳（不依赖网络）**
+
+在 `CommonTrustProtocol/aeis/dist/` 找到 `aeis-0.4.0-py3-none-any.whl`（**完整自包含发布版**）：
+
+```bash
+pip install aeis-0.4.0-py3-none-any.whl
+```
+
+> **v0.4.0 起为完整自包含单包**（10.2MB / 343 条目）：灵枢核心（aeis）+ 白箱智慧模块（wisdom，含 **2846 个 KCCS 注释知识点 + 学科知识库**）+ 三入口（harness）+ 种子知识（seed_knowledge，智能论 3.3 + 116 学科卡）。单文件、离线可用、装一次管用——知识库随包分发，无需另装。
+>
+> 遇到网络不稳（GitHub clone 失败）时首选本地 wheel。
+
+**方式 B：git 安装（需网络）**
+
+```bash
+pip install "aeis @ git+https://github.com/FuRongJun-1999/CommonTrustProtocol@main#subdirectory=aeis"
+```
+
+> 依赖 GitHub 实时可达，网络不稳时可能失败。aeis 库核心**零外部依赖**（纯标准库），安装即得完整大脑（五层记忆 · 知识飞轮 · 安全护栏 · 白箱智慧模块 · MCP · 身体层）。
+
+### 安装插件本体
+
+**方式 A：装进 DSH profile（推荐，pnpm 协调正确入口）**
+
+```bash
+dsh plugin --profile web add @furongjun1999/dsh-memory
+```
+
+> `dsh plugin --profile <name> add` 会用 pnpm + `autoInstallPeers: false` 正确解析插件依赖。
+> **避免**用 `npm install` 把它装进 profile 的 `node_modules`（会导致 `@deepseek-ai` peer 版本污染，插件加载/浏览器报错）。
+
+**方式 B：从独立仓库克隆（开发 / 自定义）**
+
+```bash
+git clone https://github.com/FuRongJun-1999/dsh-memory.git
+cd dsh-memory
+npm install && npm run build     # 构建插件本身（tsc → lib/）
+# 然后：dsh plugin --profile <name> add <本地路径>  部署进 profile
+```
+
+### 启用插件
+
+在 profile 的 `cordis.yml`（或 `cordis.patch.yml`）中追加：
+
+```yaml
+- id: lingshu-memory
+  name: '@furongjun1999/dsh-memory'
+  config:
+    dbPath: 'D:/data/lingshu.db'        # 灵枢记忆库路径（目录自动创建）
+    identity: '灵枢'
+    tools: 'brain'                     # 'brain'(默认) | 'core' | 'all'
+    memory:
+      userMessage: true                # 用户消息自动沉淀
+      assistantMessage: false          # agent 回复沉淀（默认关，防噪音）
+      toolResult: false                # 工具结果沉淀（默认关）
+      autoRecall: true                 # 模型请求前自动注入最近记忆
+      desensitize: true                # 写入前过滤敏感信息（密钥/密码/身份证/手机号）
+```
+
+完整示例见 [`cordis.yml.example`](./cordis.yml.example)。
+
+## 配置项
+
+| 字段 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `serverName` | string | `lingshu` | 工具命名空间前缀（工具名 `lingshu_<name>`） |
+| `python` | string | `python` | Python 可执行文件 |
+| `moduleArgs` | string[] | `['-m', 'aeis.mcp.server']` | 灵枢 server 启动参数 |
+| `dbPath` | string | `data/lingshu.db` | 记忆库 SQLite 路径（自动建目录） |
+| `identity` | string | `灵枢` | 灵枢身份标识 |
+| `env` | object | `{}` | 追加环境变量（`BOCHA_API_KEY` / `AEIS_DESIGNER_KEY` / `DEEPSEEK_API_KEY`（角色扮演 LLM 续答）…，可用 `!!js process.env.X` 从宿主环境注入） |
+| `tools` | `'brain' \| 'core' \| 'all' \| string[]` | `'brain'` | 暴露的工具集合 |
+| `memory.userMessage` | boolean | `true` | 用户消息 → 自动 remember |
+| `memory.assistantMessage` | boolean | `false` | agent 回复 → 自动 remember |
+| `memory.toolResult` | boolean | `false` | 工具结果 → 自动 remember |
+| `memory.importance` | number | `0.6` | 自动记忆的重要性（0~1） |
+| `memory.autoRecall` | boolean | `true` | 模型请求前自动注入灵枢最近记忆（`system-prompt/assemble` 注入，失败静默） |
+| `memory.autoRecallLimit` | number | `4` | 自动召回条数（1~10） |
+| `memory.desensitize` | boolean | `true` | 写入前过滤敏感信息（`sk-`密钥/密码/`Bearer`令牌/18位身份证/11位手机号 → `[已过滤]`；纯凭据消息跳过写入） |
+| `toolCallTimeoutMs` | number | `60000` | 单次工具调用超时 |
+| `maxRetryDelayMs` | number | `30000` | 进程重启最大退避间隔 |
+| `failOnStartupError` | boolean | `false` | 启动失败是否让插件激活失败 |
+
+## 自动记忆机制
+
+订阅 DSH 的 `session/event` 事件流（与官方 session-persistence 相同的接入点）：
+
+- `user/message`（仅 `source.kind === 'user'` 的真实用户消息）→ `remember`（importance 0.6，tags `dsh`）
+- 插件注入的系统上下文（AGENTS.md、文件变更通知等 `kind: 'plugin'`）**不写入**，防止记忆噪音
+- 灵枢自带去重（相似度基准 + 时间窗口），重复消息不会堆积
+- **敏感信息脱敏**（`memory.desensitize`）：写入前过滤 `sk-`密钥 / API key / 密码 / `Bearer`令牌 / 18位身份证 / 11位手机号（替换为 `[已过滤:类别]`）；纯凭据消息整条跳过，不落库
+- **自动召回注入**（`memory.autoRecall`）：每次模型请求组装 system prompt 时自动注入灵枢最近记忆（`system-prompt/assemble` 事件），记忆"自动可用"；召回失败静默不阻塞请求
+
+## 🛟 DSH 看门狗（scripts/）
+
+DSH 宿主（node 进程）的延时自动重启守护——灵枢桥只重连灵枢 python 进程，本看门狗守护 DSH 宿主（对齐移动端 APK 的 EngineService）：
+
+- `scripts/dsh-watchdog.ps1`：监控 3080 端口，进程退出 → 延时 `DelaySec` 秒再确认 → 自动拉起 `dsh web`
+  - `-Once` 模式：供 Windows 计划任务每分钟调用（`schtasks /Create /TN dsh-watchdog /TR "wscript.exe ...\dsh-watchdog-launcher.vbs" /SC MINUTE /MO 1`），可靠持久、不依赖驻留进程
+  - 驻留模式：`wscript.exe scripts\dsh-watchdog-launcher.vbs -loop`（5 秒快速拉起层）
+- `scripts/dsh-watchdog-launcher.vbs`：vbs 隐藏启动器（`WScript.Shell.Run ..., 0` = 零弹窗）
+- **用法**：改完插件/配置 → 直接 kill DSH 进程 → 看门狗自动拉起新版（无需手敲启动命令）
+- **注意**：脚本输出全英文（powershell 5.1 GBK 读取 UTF-8 无 BOM 中文会解析崩溃）；计划任务 /TR 路径必须带引号（`D:\Program Files\...` 空格截断会弹「没有文件扩展名」）
+
+## 开发
+
+```bash
+npm install
+npm run build    # TypeScript 编译
+npm test         # 真实集成测试（spawn 本机灵枢，验证握手/往返/注册/卸载）
+```
+
+测试不依赖 DSH 全组件——用最小 Cordis host（SystemPrompt + ToolRegistry + 插件）隔离 v0.1 不稳定面。
+
+## 护栏宪章（接入即接受约束）
+
+本插件接入即接受 **[灵枢护栏宪章 v2.0-published](docs/guardrail-charter.md)** 约束——
+对外部智能体与人类使用者的行为边界作出公开、可执行、可审计的规定，并保护人类使用者。
+宪章效力不高于智能论协议本身（协议＝自我约束，宪章＝对外约束）。
+本插件随包自带宪章全文（`docs/guardrail-charter.md`），安装即可查阅。
+
+## 许可证
+
+MIT © 荣（FuRongJun-1999）· 灵枢 AEIS 工程实现
+
+DeepSeek Harness 为 DeepSeek 官方开源项目（MIT），本插件与之无隶属关系。