@furongjun1999/dsh-memory 0.4.11 → 0.5.0

package/docs/mdcg/release_v0.4.11.md

@@ -0,0 +1,49 @@
+## v0.4.11（2026-09-20）
+
+**npm**：`@furongjun1999/dsh-memory@0.4.11`（前置不变：Node ≥ 22.19 · DSH 内核 ≥ 0.1.2-rc.1）
+
+> **本版三件事**：①修第三方 v15 报告九项 ②修首装平台差异（issue #19）③**发版门禁**建立与**发布件收口**——0.4.9 / 0.4.10 两个已发布 tarball 夹带非追踪件（4009 件 / ~28 MB）的缺陷由 `cee729a` 收口，**0.4.11 发布件为 1306 件**（本地门禁实测）；事实、根因与处置裁定见 [发布件回溯说明](../发布件回溯说明_v0.1.md)。
+
+> **版本一致性（如实披露）**：npm `0.4.11` 的 tarball **早于本 tag 一步**——其 `docs/工作纪律_认知图条目_v1.1.json` 与各端纪律产物（`codebuddy/CODEBUDDY.md`、`zcode/AGENTS.md`、`codex/AGENTS.md`、`claude/CLAUDE.md`、两份 plugin skill）为 **17 条**；本 tag 为 **18 条**（新增「工作区索引优先」），并含工作区索引管线与投影同步器修复。差异**仅限纪律增量与仓库内工具面**（`scripts/` 不在 npm `files` 白名单内，故脚本增量不入包），功能面一致。npm 同版本号不可覆盖，故此处留痕而不回溯——口径与 §发布件回溯说明一致。
+
+### 本版变更（0.4.10 → 0.4.11，共 7 次提交）
+
+**新增：发版门禁（拦下一次夹带）**
+- `scripts/check_publish_artifact.py`：四类硬失败——R1 凭据/密钥 · R2 私有数据面 · R3 隐私文本 · R4 非追踪件；本地模式（`npm pack --dry-run` 清单 × 工作区内容）与 `--registry` 后置核验双模式；退出码 fail-closed（0 通过 / 1 有命中 / 2 环境错误）；内置 `--selftest`。
+- `.github/workflows/publish-artifact-check.yml` + `package.json` 的 `prepublishOnly` 挂载：**红着即拦下一次发布**。
+
+**修复**
+- **首装平台差异**（issue #19）：解释器默认值写死 `python`，而 Linux / macOS 依 PEP 394 只提供 `python3`（发行版默认状态）→ `spawn ENOENT` → 桥重试 8 次进终态：插件加载不报错、但工具不注册、记忆永不落盘、不自愈；日志被「灵枢调用超时」这一次生现象掩盖第一因。新增 `src/lib/python_path.ts`（平台默认 + `MDCG_PYTHON` 覆盖 + ENOENT 指引文案），`mutual.ensureHarness` 与各端配置样例同步去掉写死的解释器。
+- **发布清单解析缺陷**（CI 恒红）：`prepare` 生命周期脚本会向 stdout 打印文本（`[prepare] 跳过构建…`），而清单解析以 `find("[")` 定位 JSON 起点 → 命中 `[prepare]` 首字符 → 解析失败 exit 2。本地装了 typescript 故 `prepare` 静默、该路径从未暴露 → 「本地恒绿 / CI 恒红」双环境盲区。改 `json.JSONDecoder.raw_decode` 逐候选点试解析。
+- **`.npmignore` 收口**：`files` 白名单粒度到目录，且 npm 在存在该白名单时**不读根级 `.npmignore`** → 白箱 KB 运行时数据 / `docs/experiments` / 本地记忆面 / 字节码缓存随包分发（R2/R4 各命中 2449 件）。改**子目录级** `.npmignore`（`md_cg/` · `docs/` · `skills/`）：发布清单 4009 → 1306 件。
+
+**第三方 v15 报告九项**
+- `coldverify`：`patrol_check` 与 `propagate_depth` 的 `ok` 由**内层结论**决定（不再硬编码 `True`），失败计入 `stats.errors`；`_load_persisted` 与 `enqueue` 同白名单校验 action（拒收计 `skipped`）——冷队列回执不再「假装成功」。
+- **147 条 Python 套件接入 CI**：`.github/workflows/python-tests.yml`（此前不在任何 workflow 内，红基线无人可见）；刻意不加 `paths` 过滤，避免「改动不入门禁」盲区。
+- `hive/exec.py` 落盘面补 `TOOL_DUMP_MAX_CHARS` 上限（此前回喂面已收紧、磁盘面无天花板），docstring 与实现对齐。
+- `md_cg/trust.py` 澄清 `propagate` 的 `reachable/updated` 口径（本次需新标记数，完整波及集须叠加 `passed_doubted`）；`test_datapath_root` 按 `os.path.isabs` 判据复算（POSIX 不再必红）；编码「唯一构造点」由主张升为**被守护的不变量**（互斥面站点扫描，剥离注释与字符串避免字面量自伤）。
+
+**纪律与文档**
+- **工作纪律新增第 18 条「工作区索引优先」**：查工作区文件先读 `WORKSPACE_INDEX.md`（仓根，由 `scripts/workspace_index.py` 从 git 追踪面机械生成），无则先生成再读，不以重复全盘浏览代替；索引纳入 CI 陈化守卫（`.github/workflows/workspace-index-check.yml`）——守卫面已在文档内显式声明（目录集合 / 根级文件集合 / 职责与关键入口 / 正文逐字），**承诺项与守卫面一致**。
+- 修纪律投影节点同步器两处缺陷：①同批次「新建」节点的 nid 碰撞——`now` 在循环外只取一次，多条纪律共用同一文件名，后写覆盖前写（实测 18 条只留最后 1 条）；②root 缺 `_md_cg_` 前缀守卫——该前缀目录是工具链导出/评测产物，禁止作为认知图 root（与 MCP server 同名守卫同口径，fail-closed）。
+- 详情 README 更名 `README详细版_v0.4.10.md`（7 处引用同步）+ 新增「0.4.6 → 0.4.10 变更速览」表；智能论 v3.4 同步（白箱 KB 种子实体逐字节取自 `docs/theory/智能论3.4.md`）。
+
+### 验证
+
+- `npm test` **26/26** 通过
+- Python 套件 **147/147** 通过（本版起全量接入 CI）
+- 三门禁全绿：`verify_discipline` **8/8**（含认知图投影节点 **18/18**）· `cogmap check` · `link_check`（OK 190 / BROKEN 0）
+- 发布件门禁 `VERDICT=PASS`：清单 **1306 件**、非追踪件 24 = 允许上限 24
+- 新件自检：`test/python-path.test.ts` 8 断言 · `python-utf8-mode.test.ts` 语义匹配 · 门禁 `--selftest` 全绿
+
+### 升级
+
+```bash
+npm i -g @furongjun1999/dsh-memory@0.4.11
+# 或（DSH profile）
+dsh plugin --profile web add @furongjun1999/dsh-memory
+```
+
+**Linux / macOS 用户**：本版起解释器默认值**平台感知**（`python3`），首装不再需要手工改配置；仍可用 `MDCG_PYTHON` 指定自有解释器。
+
+> 详情见 [README](https://github.com/FuRongJun-1999/dsh-memory) · 发布件口径见 [发布件回溯说明](../发布件回溯说明_v0.1.md)

package/docs/mdcg/release_v0.4.5.md

@@ -1,55 +1,55 @@
-## v0.4.5（2026-09-10）
-
-**npm**: `@furongjun1999/dsh-memory@0.4.5`
-
-> **前置**：Node ≥ 22.19 · DSH 内核 ≥ 0.1.2-rc.1（0.4.x 用新版 `dsh-tools` 调度器/`defineTool`；旧内核 0.1.1-rc.2 结构不兼容，**旧内核用户请用 0.4.2**）。
-> **大脑零安装**：`md_cg` 认知图（记忆唯一真源）随包自带，无需 pip 安装任何引擎；AEIS 仅作可选「身体」能力后端，默认不启动。
-
-### 本版变更（0.4.4 → 0.4.5，累计 29 次提交）
-
-**新能力**
-- **白箱知识库内迁 + P8–P44 能力阶段**：认知图记忆 OS 单元、跨节点证据存储（P24）、位置权重矩阵（P25）、连接层（P23，可插拔签名契约 D-4）；六域条件单元真源 + 语境化 / 视觉证据 / 精炼工单 / 演化巡检 / 来源追溯 / 池化。
-- **代码索引与文档索引**：`cg(op=index_code)` 渲染 CCG、`cg(op=index_doc)` 文档索引、`cg(op=ref)` 回读；R3 增量水位 + 漂移/悬空巡检并接入 `sustain` 自愈。
-- **`skills/` 灵枢自我认知技能包**：686 条件单元生成投影 + 设计者视角元技能。
-- 认知图记忆操作系统抽出为顶层包（`md_cg/`）。
-
-**修复**
-- **白箱库冷启动重入死锁**（`md_cg/whitebox_kb/engine.py`）：懒初始化锁由 `threading.Lock` 改为**可重入锁 `RLock`**——初始化路径会在同线程内递归获取同一把锁，此前表现为「冷启动卡死 / 极慢」，修复后冷启动一次通过、并发热加载不再阻塞。
-- R0 基线收口：修清空与编码四缺陷；修复索引落盘缺陷。
-- 安全：`llm-adapter-poc` 移出公开仓库 + 移除硬编码 API Key。
-
-**重构**
-- TypeScript：实验模块归入 `src/lib/`；新增 `src/lib/datapath.ts` 统一数据路径解析（消除相对 / 绝对路径错位），`src/lib/mdcg_client.ts` 为插件侧唯一显式入口；`src/tools.ts` / `src/hooks.ts` / `src/index.ts` 随 MCP 工具面一并调整。
-
-**文档与工程**
-- README 精简重写（以「AGI 七维评分标尺」组织），原文归档为 [README 详细版](README详细版_v0.4.10.md)。
-- **移除 `docker/`**：该目录对外四个入口**全部不可用**——镜像自述「Docker Hub 待发布」故 `docker run` 必然失败、`npx @lingxu/dsh-memory` 包名错误（实际 `@furongjun1999/dsh-memory`）、`build.sh` 的 aeis 源码取自他仓路径；且主 README 与 CI 对 `docker/` **零引用**，v0.4.x 已从 python 引擎转向 npm 插件。需要时可用 git 历史取回。
-- `package-lock.json` 用当前 npm 重新生成，`npm ci` 可复现。
-- 工作纪律第 15 条：命令执行统一走 python / UTF-8（显式 encoding + `PYTHONUTF8=1`，规避 GBK）。
-
-### 写入闸门（首次使用必读）
-
-`cg(op=write)` **不是无条件落盘**：须依次穿过 audit → 一致性 → gated 三问四态三道闸门，**仅最终判定 ACCEPT 才新增落盘点**。
-
-未落盘时返回体形如 `{"ok": true, "committed": false, "moved_to": "review_queue"}` —— **`ok` 只表示请求被受理，是否落盘只看 `committed`**。
-`content_kind` 省略或填 `text` 时，未配置 `MDCG_POLICY_FILE` 的审核器一律判 **`DEFER`**（缺能力返回 DEFER，绝不假装通过），内容进审核队列而非落盘；要立刻落盘请用可验证类型，如 `content_kind: 'code'`（AST 解析通过即 ACCEPT）。
-
-### 工具面
-
-`cg`（31 op）+ `stg`（4 op）= **35 op 全部可达**（0 未知 op、0 次意外崩溃）。
-`tools` 模式：`'core'`（默认）暴露 **2** · `'brain'` 暴露 **30** · `'all'` 暴露 **30**（full 面 33 − 3 个宿主级风险工具 `mdcg_forget` / `mdcg_restore` / `mdcg_review_decide`，均需 `can_admin`）。
-
-### 安装
-
-```bash
-dsh plugin --profile web add @furongjun1999/dsh-memory
-# 或从 GitHub 安装
-dsh plugin --profile web add github:FuRongJun-1999/dsh-memory
-```
-
-### 验证
-
-- 构建 ✅ · 测试 **8/8** 通过（`npm test`：最小 Cordis host 隔离 + spawn 本机灵枢验证握手 / 往返 / 注册 / 卸载）
-- 35 op 全量可达性冒烟 ✅
-
-> 详情见 [README](https://github.com/FuRongJun-1999/dsh-memory)
+## v0.4.5（2026-09-10）
+
+**npm**: `@furongjun1999/dsh-memory@0.4.5`
+
+> **前置**：Node ≥ 22.19 · DSH 内核 ≥ 0.1.2-rc.1（0.4.x 用新版 `dsh-tools` 调度器/`defineTool`；旧内核 0.1.1-rc.2 结构不兼容，**旧内核用户请用 0.4.2**）。
+> **大脑零安装**：`md_cg` 认知图（记忆唯一真源）随包自带，无需 pip 安装任何引擎；AEIS 仅作可选「身体」能力后端，默认不启动。
+
+### 本版变更（0.4.4 → 0.4.5，累计 29 次提交）
+
+**新能力**
+- **白箱知识库内迁 + P8–P44 能力阶段**：认知图记忆 OS 单元、跨节点证据存储（P24）、位置权重矩阵（P25）、连接层（P23，可插拔签名契约 D-4）；六域条件单元真源 + 语境化 / 视觉证据 / 精炼工单 / 演化巡检 / 来源追溯 / 池化。
+- **代码索引与文档索引**：`cg(op=index_code)` 渲染 CCG、`cg(op=index_doc)` 文档索引、`cg(op=ref)` 回读；R3 增量水位 + 漂移/悬空巡检并接入 `sustain` 自愈。
+- **`skills/` 灵枢自我认知技能包**：686 条件单元生成投影 + 设计者视角元技能。
+- 认知图记忆操作系统抽出为顶层包（`md_cg/`）。
+
+**修复**
+- **白箱库冷启动重入死锁**（`md_cg/whitebox_kb/engine.py`）：懒初始化锁由 `threading.Lock` 改为**可重入锁 `RLock`**——初始化路径会在同线程内递归获取同一把锁，此前表现为「冷启动卡死 / 极慢」，修复后冷启动一次通过、并发热加载不再阻塞。
+- R0 基线收口：修清空与编码四缺陷；修复索引落盘缺陷。
+- 安全：`llm-adapter-poc` 移出公开仓库 + 移除硬编码 API Key。
+
+**重构**
+- TypeScript：实验模块归入 `src/lib/`；新增 `src/lib/datapath.ts` 统一数据路径解析（消除相对 / 绝对路径错位），`src/lib/mdcg_client.ts` 为插件侧唯一显式入口；`src/tools.ts` / `src/hooks.ts` / `src/index.ts` 随 MCP 工具面一并调整。
+
+**文档与工程**
+- README 精简重写（以「AGI 七维评分标尺」组织），原文归档为 [README 详细版](README详细版_v0.4.10.md)。
+- **移除 `docker/`**：该目录对外四个入口**全部不可用**——镜像自述「Docker Hub 待发布」故 `docker run` 必然失败、`npx @lingxu/dsh-memory` 包名错误（实际 `@furongjun1999/dsh-memory`）、`build.sh` 的 aeis 源码取自他仓路径；且主 README 与 CI 对 `docker/` **零引用**，v0.4.x 已从 python 引擎转向 npm 插件。需要时可用 git 历史取回。
+- `package-lock.json` 用当前 npm 重新生成，`npm ci` 可复现。
+- 工作纪律第 15 条：命令执行统一走 python / UTF-8（显式 encoding + `PYTHONUTF8=1`，规避 GBK）。
+
+### 写入闸门（首次使用必读）
+
+`cg(op=write)` **不是无条件落盘**：须依次穿过 audit → 一致性 → gated 三问四态三道闸门，**仅最终判定 ACCEPT 才新增落盘点**。
+
+未落盘时返回体形如 `{"ok": true, "committed": false, "moved_to": "review_queue"}` —— **`ok` 只表示请求被受理，是否落盘只看 `committed`**。
+`content_kind` 省略或填 `text` 时，未配置 `MDCG_POLICY_FILE` 的审核器一律判 **`DEFER`**（缺能力返回 DEFER，绝不假装通过），内容进审核队列而非落盘；要立刻落盘请用可验证类型，如 `content_kind: 'code'`（AST 解析通过即 ACCEPT）。
+
+### 工具面
+
+`cg`（31 op）+ `stg`（4 op）= **35 op 全部可达**（0 未知 op、0 次意外崩溃）。
+`tools` 模式：`'core'`（默认）暴露 **2** · `'brain'` 暴露 **30** · `'all'` 暴露 **30**（full 面 33 − 3 个宿主级风险工具 `mdcg_forget` / `mdcg_restore` / `mdcg_review_decide`，均需 `can_admin`）。
+
+### 安装
+
+```bash
+dsh plugin --profile web add @furongjun1999/dsh-memory
+# 或从 GitHub 安装
+dsh plugin --profile web add github:FuRongJun-1999/dsh-memory
+```
+
+### 验证
+
+- 构建 ✅ · 测试 **8/8** 通过（`npm test`：最小 Cordis host 隔离 + spawn 本机灵枢验证握手 / 往返 / 注册 / 卸载）
+- 35 op 全量可达性冒烟 ✅
+
+> 详情见 [README](https://github.com/FuRongJun-1999/dsh-memory)

package/docs/mdcg/tool_table_v0.3.0.md

@@ -1,117 +1,117 @@
-# 工具总数: 75
-
-### 记忆与长期记忆（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` | 灵枢 · 角色扮演注入块（锚点/价值观/条件空间组装，供外部前端注入）。 |
-
-### 代码（2）
-| 工具 | 功能 |
-|---|---|
-| `code_compose` | 白箱代码组合生成（零 LLM）：语言识别 → 任务识别 → 代码单元 → 模板填充 → 自校验。未预写完整代码，单元库未覆盖时诚实拒绝。question 必填。 |
-| `code_qa` | 白箱代码问答（零 LLM）：代码理解路由——影响分析/依赖/并行测试/仓库统计。repo 为代码仓库路径（可选，默认当前目录）。未覆盖时诚实拒绝。 |
-
-### 身体与设备（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）。自动化会话与模型生成内容永远无法获得此权限。 |
-
+# 工具总数: 75
+
+### 记忆与长期记忆（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` | 灵枢 · 角色扮演注入块（锚点/价值观/条件空间组装，供外部前端注入）。 |
+
+### 代码（2）
+| 工具 | 功能 |
+|---|---|
+| `code_compose` | 白箱代码组合生成（零 LLM）：语言识别 → 任务识别 → 代码单元 → 模板填充 → 自校验。未预写完整代码，单元库未覆盖时诚实拒绝。question 必填。 |
+| `code_qa` | 白箱代码问答（零 LLM）：代码理解路由——影响分析/依赖/并行测试/仓库统计。repo 为代码仓库路径（可选，默认当前目录）。未覆盖时诚实拒绝。 |
+
+### 身体与设备（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）。自动化会话与模型生成内容永远无法获得此权限。 |
+