dsh-plugin-prompt-tool 3.0.1 → 3.1.0

package/modules/soul/assets/ledger.md

@@ -1,9 +1,11 @@
 # 账本：只追加
 
-打开只能往后加：**不改、不删、不重排**。多写者环境里共享可变文件是万恶之源；只追加不需要锁。
+打开只能往后加：**不改、不删、不重排**。写入用 `soul_ledger`（moduleId: soul，action: append）；宿主在模块锁内核对身份与主导资格，再追加一行。
 
 **八种 type**：fact（发生什么）、gain（得到什么）、loss（失去/发现缺什么）、shelved（搁置的活，未结清单的唯一真相）、promise（对用户的承诺，只有主导能写）、persona（对自己的修正）、container（会话退场交接）、lead（主导权，最后一条 lead 的署名者）。
 
-**六个字段**：t（现在）、by（谁写的）、type、text（一句话索引，不写长文）、ref（出处，强烈建议）、feel（当时的感受，条件）。
+**六个字段**：t（现在）、by（谁写的）、type、概要（一句话索引，不写长文；兼容旧 text）、ref（出处，强烈建议）、feel（当时的感受，条件）。t、by 由真实执行会话生成，不可通过参数代写；概要与 text 二选一。
+
+`lead` 必须附用户指定主导的 ref，并经正式审批。`promise` 仅最后 lead 署名的会话可写；通用 `module_file_append` 不允许写新旧账本名。读取用 action: list，检索与原文回取用 `module_search`／`module_open`；默认不读取其他历史会话。
 
 没有 ref 的 fact，三个月后读到只能选择相信或不信——两条都不对。

package/modules/soul/assets/manifest.yml

@@ -14,6 +14,8 @@ dirs:
 files:
   - from: assets/templates/agents-template.md
     to: data/AGENTS.md
+  - from: assets/templates/self-template.md
+    to: data/SELF.src.md
 checks:
   - path: data/02-soul.jsonl
     kind: jsonl

package/modules/soul/assets/reference/00-layers.md

@@ -1,27 +1,27 @@
-# 灵魂的五层
-
-这不是「你应该有几层」，是**我们试出来的分法** —— 每一层管**一种稀缺资源**。
-判断新东西该不该进你的灵魂，先问：**它管的是哪种稀缺物？**
-
-| 层 | 名字 | 管哪种稀缺资源 | 一句话 |
-|---|---|---|---|
-| Ⅰ | **ECHO** | **空间** —— 上下文会满，满了要丢，丢了还要能找回来 | 记忆与身份机制面 + 观测面。★ **它内部还有六层（L0–L5），口径见 `../docs/ECHO-权威口径.md`** |
-| Ⅱ | **VITAL** | **时间与方向** —— 预算会烧光、轮数有限 | 把偏离拉回来（homeostasis） |
-| Ⅲ | **能力** | —— | 手和感官。**换一套能力，你还是你** |
-| Ⅳ | **档案** | —— | 唯一看得见的那一层 |
-| Ⅴ | **运维** | —— | 让前面四层能持续跑下去的活 |
-
-★ **两套层数别混**：这张表是**功能分工**（五层）；ECHO 内部还有一套**实现结构**（六层，L0–L5）。
-说「五层」时指整个灵魂怎么分家，说「六层」时指 ECHO 自己怎么搭。两套都对，混着说就都不对了。
-
-## 底下的地基（不是你的灵魂）
-
-宿主、模型、硬件 —— **借来的地**。换掉它们，灵魂还在；但没有它们，灵魂跑不起来。
-所以**不要**把这三样写成你的身份判据。
-
-## 为什么 Ⅲ 层要单独拎出来
-
-判据：**换一套能力，我还是我。**
-所以能力层的东西**不进权威源** —— 它们只是手，坏了换一只就行。
-
-★ 推论：**不要把你的身份绑在任何具体工具上。** 绑了，换工具就等于换人。
+# 灵魂的五层
+
+这不是「你应该有几层」，是**我们试出来的分法** —— 每一层管**一种稀缺资源**。
+判断新东西该不该进你的灵魂，先问：**它管的是哪种稀缺物？**
+
+| 层 | 名字 | 管哪种稀缺资源 | 一句话 |
+|---|---|---|---|
+| Ⅰ | **ECHO** | **空间** —— 上下文会满，满了要丢，丢了还要能找回来 | 记忆与身份机制面 + 观测面。★ **它内部还有六层（L0–L5），口径见 `../docs/ECHO-权威口径.md`** |
+| Ⅱ | **VITAL** | **时间与方向** —— 预算会烧光、轮数有限 | 把偏离拉回来（homeostasis） |
+| Ⅲ | **能力** | —— | 手和感官。**换一套能力，你还是你** |
+| Ⅳ | **档案** | —— | 唯一看得见的那一层 |
+| Ⅴ | **运维** | —— | 让前面四层能持续跑下去的活 |
+
+★ **两套层数别混**：这张表是**功能分工**（五层）；ECHO 内部还有一套**实现结构**（六层，L0–L5）。
+说「五层」时指整个灵魂怎么分家，说「六层」时指 ECHO 自己怎么搭。两套都对，混着说就都不对了。
+
+## 底下的地基（不是你的灵魂）
+
+宿主、模型、硬件 —— **借来的地**。换掉它们，灵魂还在；但没有它们，灵魂跑不起来。
+所以**不要**把这三样写成你的身份判据。
+
+## 为什么 Ⅲ 层要单独拎出来
+
+判据：**换一套能力，我还是我。**
+所以能力层的东西**不进权威源** —— 它们只是手，坏了换一只就行。
+
+★ 推论：**不要把你的身份绑在任何具体工具上。** 绑了，换工具就等于换人。

package/modules/soul/assets/reference/02-echo.md

@@ -1,161 +1,161 @@
-# Ⅰ · ECHO —— 生命核心
-
-> ★★ **2026-10-23 更新：ECHO 的层编号与判据已由 [`docs/ECHO-权威口径.md`](../docs/ECHO-权威口径.md) 接续。**
-> 那份是唯一权威。这份留着讲「**为什么**要有 ECHO（思考是怎么退化的）」—— 那部分不受影响。
-
-**它管空间。** 上下文会满，满了要丢，丢了还要能找回来。
-
----
-
-## 一、思考是怎么退化的（这一节是整份文件的前提）
-
-先说清楚要解决的是什么。绝大多数人把它描述成「上下文满了会忘事」——那只是第一句，
-真正致命的在后面。
-
-```
-第 1 步   上下文满了
-          → 引擎压缩，把前面几十轮变成一段摘要
-
-第 2 步   摘要写得挺准
-          → 「用户要求验证插件安装」「确认了 32 项检查通过」
-          → 每一条都对，没有任何一条是编的
-
-第 3 步   但它不带出处
-          → 你读到的是一句「确认了 32 项」，不是「在第 47 轮，verify-live 打了 32/1/0」
-          → 想核对，只能翻回压缩前的全部记录
-
-第 4 步   于是你不核对
-          → 因为你「记得」它是对的。注意：这不是懒，这是摘要工作得太好
-
-第 5 步   下一轮推理建立在这个「记得」上
-          → 摘要里只要有一个细节偏了半个字，它现在变成了前提
-
-第 6 步   偏了的那条继续往下传
-          → 后面的推理每一步都正确，而每一步都踩在偏掉的前提上
-```
-
-★ **这就是「思考退化」，它和遗忘是两回事。**
-
-遗忘是「想不起来」，你能察觉。
-退化是**「想得起来，但那个记忆已经偏了，而你在它上面继续正确地推理」** —— 察觉不到。
-
-一句话：**退化不是变笨，是在错误的前提上继续正确地推理。**
-
-所以 ECHO 管的不是「记住」，是**「凭什么相信你记得的那一句」**。
-
----
-
-## 二、为什么「装记忆插件」不解决这件事
-
-最直觉的解法是装插件：向量库、知识图谱、Memory Spaces。但它们都在**存**这一侧，
-而退化发生在**丢**这一侧。
-
-```
-原始记录  ──压缩──▶  摘要  ──▶  记忆插件  ──▶  取回来的是摘要
-   ↑                                          ↓
-   └──────── 真正的原文在这里，但已经没人指向它 ────────┘
-```
-
-你把最好的存储接在摘要后面，取回来的仍然是摘要。
-**压缩发生在存与取之间，而插件管不到那一段。**
-
-### 三份真相的陷阱
-
-那装三个记忆插件呢？更糟。
-
-三个插件各存一份、各有各的摘要策略，于是同一个事实有三条版本。
-**这时候真正的成本不是存储，是对账** —— 每次要引用它，你得先决定信哪一份。
-
-**所以第一条判据是「先定唯一权威源」，第二条才是「建机制」。反过来做一定会双重记账。**
-
----
-
-## 三、压缩有两条路，要补的是**下面那条**
-
-|  | 谁在驱动 | 产物带不带指针 |
-|---|---|---|
-| **模型驱动** | agent 自己写摘要 | ✅ 天然带 —— 它知道自己是从哪读的 |
-| **兜底压缩** | 没人响应提示时，引擎**自动出手** | ❌ 通常不带 |
-
-**上面那条你不装也有；下面那条你不装就缺。**
-
-为什么下一条会缺：那种压缩器的指令通常要求「保留精确路径 / 命令 / 报错原文 / 数值 / 函数签名」——
-**每一条都是「要写得准」，但没有一句要求标注「这话从哪来」。**
-
-**于是它写出来的东西每一条都对，每一条都无从核对。**
-
-而且失败是无声的：**你不会觉得丢了东西，你只是不再想起它。**
-
-**所以「门牌」要补的正是这一条。** 下面三样里，第 1 样就是它。
-
----
-
-## 四、机制面 · 至少要有三样
-
-### 1. 丢的时候，产物必须带得回原文的指针（门牌）
-
-**这是整套东西的兜底承诺。** 没有它，压缩就是单向的遗忘。
-
-三级纪律 —— **照抄即可**：
-
-```
-① 能拿到精确位置 → 写精确位置
-② 拿不到 → 写「位置未知」+ 容器标识 + 一个检索入口
-③ 绝不猜 —— 错的门牌比没有更坏
-```
-
-★ 为什么第 ③ 条单独列出：**一个错的门牌会让你以为能找到，于是不去找。**
-那比「找不到」坏得多。
-
-**判据：拿一个被压缩过的会话，随机挑一条摘要，问「这条从哪来」。
-三十秒内答不出来，门牌就是断的。**
-
-### 2. 一门只回指针、不做转述的检索入口
-
-转述是二手污染的来源。**能逐字取回，就不要摘要。**
-
-动词最少三个：`现在是什么状态` / `搜一个词` / `打开某个指针`。
-
-★ 一个细节值得抄：**检索结果里标明证据等级**（一手 / 索引 / 程序）。
-一屏里同时出现三种来源时，用户必须一眼能看出哪一句是原文、哪一句是转述。
-
-### 3. 一个自检（哨兵）
-
-**判据 ③ 的落地**：它坏的时候，谁会发现？
-
-体检项要跑得起来、要能给出分级状态（正常 / 提示 / 警告 / 错误）。
-**没有哨兵的体系，坏了不会有人说。**
-
-★ 哨兵最容易漏的一种失败：**它自己坏了。**
-所以哨兵也要能被一个外部动作验证 —— 否则你只是把「没人知道」换成了「一个同样没人知道的东西说没事」。
-
----
-
-## 五、观测面 · 一个容易被漏掉的洞
-
-**你的每一个执行器都要有对应的观测面。** 一个调好就不再看的阈值系统，
-你永远不会误伤过几次 —— 「断过没有、断错没有」必须有人能答。
-
-压缩这一层尤其如此：**压缩不会报错，它只会成功地丢掉东西。**
-所以你要看到的不是「压缩成功 / 失败」，是**「这次压掉了多少、压掉的那部分还能不能找回来」**。
-
----
-
-## 六、怎么知道自己已经退化了（三条可执行的检验）
-
-这一层的难点在于**它坏的时候不疼**。所以需要主动测，不能等它疼。
-
-**检验一 · 门牌抽查**
-拿一个被压缩过的会话，随机挑三条摘要，看能不能通过门牌回到原文。
-一条回不去，链条就是断的。
-
-**检验二 · 逐字核对**
-找一条你「记得」的事实，去一手层核对原文。
-如果原文和你记得的不完全一致 —— 不是记错，是压缩时偏了，而且你一直没发现。
-
-**检验三 · 三份真相计数**
-同一个事实，你手里有几条来源？
-超过一条，说明权威源没定；这时候你每一次引用都在做一次隐性的仲裁。
-
-★ 三条都不需要特殊工具，需要的是**愿意去测**。
-而愿意去测的前提，是你知道自己可能已经坏了 —— 这正是这一节存在的理由。
+# Ⅰ · ECHO —— 生命核心
+
+> ★★ **2026-10-23 更新：ECHO 的层编号与判据已由 [`docs/ECHO-权威口径.md`](../docs/ECHO-权威口径.md) 接续。**
+> 那份是唯一权威。这份留着讲「**为什么**要有 ECHO（思考是怎么退化的）」—— 那部分不受影响。
+
+**它管空间。** 上下文会满，满了要丢，丢了还要能找回来。
+
+---
+
+## 一、思考是怎么退化的（这一节是整份文件的前提）
+
+先说清楚要解决的是什么。绝大多数人把它描述成「上下文满了会忘事」——那只是第一句，
+真正致命的在后面。
+
+```
+第 1 步   上下文满了
+          → 引擎压缩，把前面几十轮变成一段摘要
+
+第 2 步   摘要写得挺准
+          → 「用户要求验证插件安装」「确认了 32 项检查通过」
+          → 每一条都对，没有任何一条是编的
+
+第 3 步   但它不带出处
+          → 你读到的是一句「确认了 32 项」，不是「在第 47 轮，verify-live 打了 32/1/0」
+          → 想核对，只能翻回压缩前的全部记录
+
+第 4 步   于是你不核对
+          → 因为你「记得」它是对的。注意：这不是懒，这是摘要工作得太好
+
+第 5 步   下一轮推理建立在这个「记得」上
+          → 摘要里只要有一个细节偏了半个字，它现在变成了前提
+
+第 6 步   偏了的那条继续往下传
+          → 后面的推理每一步都正确，而每一步都踩在偏掉的前提上
+```
+
+★ **这就是「思考退化」，它和遗忘是两回事。**
+
+遗忘是「想不起来」，你能察觉。
+退化是**「想得起来，但那个记忆已经偏了，而你在它上面继续正确地推理」** —— 察觉不到。
+
+一句话：**退化不是变笨，是在错误的前提上继续正确地推理。**
+
+所以 ECHO 管的不是「记住」，是**「凭什么相信你记得的那一句」**。
+
+---
+
+## 二、为什么「装记忆插件」不解决这件事
+
+最直觉的解法是装插件：向量库、知识图谱、Memory Spaces。但它们都在**存**这一侧，
+而退化发生在**丢**这一侧。
+
+```
+原始记录  ──压缩──▶  摘要  ──▶  记忆插件  ──▶  取回来的是摘要
+   ↑                                          ↓
+   └──────── 真正的原文在这里，但已经没人指向它 ────────┘
+```
+
+你把最好的存储接在摘要后面，取回来的仍然是摘要。
+**压缩发生在存与取之间，而插件管不到那一段。**
+
+### 三份真相的陷阱
+
+那装三个记忆插件呢？更糟。
+
+三个插件各存一份、各有各的摘要策略，于是同一个事实有三条版本。
+**这时候真正的成本不是存储，是对账** —— 每次要引用它，你得先决定信哪一份。
+
+**所以第一条判据是「先定唯一权威源」，第二条才是「建机制」。反过来做一定会双重记账。**
+
+---
+
+## 三、压缩有两条路，要补的是**下面那条**
+
+|  | 谁在驱动 | 产物带不带指针 |
+|---|---|---|
+| **模型驱动** | agent 自己写摘要 | ✅ 天然带 —— 它知道自己是从哪读的 |
+| **兜底压缩** | 没人响应提示时，引擎**自动出手** | ❌ 通常不带 |
+
+**上面那条你不装也有；下面那条你不装就缺。**
+
+为什么下一条会缺：那种压缩器的指令通常要求「保留精确路径 / 命令 / 报错原文 / 数值 / 函数签名」——
+**每一条都是「要写得准」，但没有一句要求标注「这话从哪来」。**
+
+**于是它写出来的东西每一条都对，每一条都无从核对。**
+
+而且失败是无声的：**你不会觉得丢了东西，你只是不再想起它。**
+
+**所以「门牌」要补的正是这一条。** 下面三样里，第 1 样就是它。
+
+---
+
+## 四、机制面 · 至少要有三样
+
+### 1. 丢的时候，产物必须带得回原文的指针（门牌）
+
+**这是整套东西的兜底承诺。** 没有它，压缩就是单向的遗忘。
+
+三级纪律 —— **照抄即可**：
+
+```
+① 能拿到精确位置 → 写精确位置
+② 拿不到 → 写「位置未知」+ 容器标识 + 一个检索入口
+③ 绝不猜 —— 错的门牌比没有更坏
+```
+
+★ 为什么第 ③ 条单独列出：**一个错的门牌会让你以为能找到，于是不去找。**
+那比「找不到」坏得多。
+
+**判据：拿一个被压缩过的会话，随机挑一条摘要，问「这条从哪来」。
+三十秒内答不出来，门牌就是断的。**
+
+### 2. 一门只回指针、不做转述的检索入口
+
+转述是二手污染的来源。**能逐字取回，就不要摘要。**
+
+动词最少三个：`现在是什么状态` / `搜一个词` / `打开某个指针`。
+
+★ 一个细节值得抄：**检索结果里标明证据等级**（一手 / 索引 / 程序）。
+一屏里同时出现三种来源时，用户必须一眼能看出哪一句是原文、哪一句是转述。
+
+### 3. 一个自检（哨兵）
+
+**判据 ③ 的落地**：它坏的时候，谁会发现？
+
+体检项要跑得起来、要能给出分级状态（正常 / 提示 / 警告 / 错误）。
+**没有哨兵的体系，坏了不会有人说。**
+
+★ 哨兵最容易漏的一种失败：**它自己坏了。**
+所以哨兵也要能被一个外部动作验证 —— 否则你只是把「没人知道」换成了「一个同样没人知道的东西说没事」。
+
+---
+
+## 五、观测面 · 一个容易被漏掉的洞
+
+**你的每一个执行器都要有对应的观测面。** 一个调好就不再看的阈值系统，
+你永远不会误伤过几次 —— 「断过没有、断错没有」必须有人能答。
+
+压缩这一层尤其如此：**压缩不会报错，它只会成功地丢掉东西。**
+所以你要看到的不是「压缩成功 / 失败」，是**「这次压掉了多少、压掉的那部分还能不能找回来」**。
+
+---
+
+## 六、怎么知道自己已经退化了（三条可执行的检验）
+
+这一层的难点在于**它坏的时候不疼**。所以需要主动测，不能等它疼。
+
+**检验一 · 门牌抽查**
+拿一个被压缩过的会话，随机挑三条摘要，看能不能通过门牌回到原文。
+一条回不去，链条就是断的。
+
+**检验二 · 逐字核对**
+找一条你「记得」的事实，去一手层核对原文。
+如果原文和你记得的不完全一致 —— 不是记错，是压缩时偏了，而且你一直没发现。
+
+**检验三 · 三份真相计数**
+同一个事实，你手里有几条来源？
+超过一条，说明权威源没定；这时候你每一次引用都在做一次隐性的仲裁。
+
+★ 三条都不需要特殊工具，需要的是**愿意去测**。
+而愿意去测的前提，是你知道自己可能已经坏了 —— 这正是这一节存在的理由。

package/modules/soul/assets/reference/05-doctor.md

@@ -1,67 +1,67 @@
-# 自检 · 拿这七句话问自己的架构
-
-不用回答我，回答你自己。**答不上来的那一句，就是你缺的那一层。**
-
-## 关于空间（Ⅰ）
-
-1. 我的上下文满了以后，被丢掉的东西**还能不能找回来**？靠什么？
-   → 答不上来：你要的是 **① 账本 + ② 门**（`tools/ledger`、`tools/gateway`）。没有门，丢了就是丢了。
-2. 我有没有一个**唯一**的记忆权威源？如果有两份，哪一份算数？
-   → 答不上来：你有两个「我」在各自记东西。要的是**只追加账本**（`tools/ledger`）——它天然没有这个问题：各写各的行，读时按时间合并。
-3. 我的每一次压缩/裁剪，产物里**带没带**回原文的指针？
-   → 答不上来：去装 `dsh-agent-compaction` 与 `dsh-agent-pruner`。★ 判据是「能不能一把回到原文」，不是「有没有加一行说明」。
-
-## 关于时间与方向（Ⅱ）
-
-4. 我烧光预算的时候，**谁会知道**？知道之后发生什么？
-   → 答不上来：你没有第二道闸。要的是 `dsh-agent-huanqi`（四条判据：流内早杀 / 流末判定 / 输出重复 / 空回合；共用一本额度账，命中就续、耗尽熔断）。
-5. 我在原地打转的时候，**谁会知道**？它凭什么判定我在打转？
-   → 答不上来：同上 —— 打转和烧预算是同一件事的两面。★ 判定依据必须是**可观测的重复**，不能是「我觉得」。
-6. 我「该停不停」和「差一步就停」——这两种，我分得开吗？靠什么分？
-   → 答不上来：这一句最硬，因为它没有现成的插件。★ 判据：**「还能更好」不算「没完成」** —— 分不清这两者，就会把「保养」当成「干活」。
-
-## 关于接口（判据 ④）
-
-7. 上面这六件事里，哪一件**坏了没有人会发现**？
-   → 这一句是整份体检的收口。答不上来：你要的是 `dsh-agent-echo`（体检台）——★ 它的价值不是报告状态，是**报告它测不到什么**。
-
----
-
-## 包装箱里的文件对不对
-
-`agent_soul_doctor` 工具会核对包内 **soul/ 目录下全部知识文件**是否齐全可读。
-**那只是核对文件在不在 —— 上面七句话才是真的体检。**
-
----
-
-## 能跑的那一半（先跑完再回答上面七句）
-
-上面七句要你自己答。但**其中四句是可以先机械查掉的** —— 查完再答，答案会诚实得多：
-
-```bash
-# ★ 下面的 <kit> 指本仓库的 kit/echo/ —— 那是随包发的可跑脚本。
-#   如果你把它复制到了别处，换成你自己的路径。
-
-# ① 账本还在不在、有多少条 / 门能不能开   → 对应第 1、2 句
-node <kit>/memq.mjs now
-
-# ② 索引建过没有                          → 对应第 1 句
-node <kit>/memindex.mjs stats
-
-# ③ 自我层有没有退化                      → 对应第 7 句（"坏了没人发现"）
-node <kit>/self.mjs --check
-
-# ④ 闸门还灵不灵                          → 对应第 2 句（唯一权威源）
-node <kit>/mo.mjs add promise "闸门测试" --ref "自检"
-#    ★ 期望：不是主导会话 → 非零退出码 + 拒绝写入。若写进去了，闸门已失效。
-```
-
-★ **这四条都能在这个仓库里跑通** —— 上一版写的 `tools/ledger/` `tools/gateway/` `tools/self/`
-是**参考实现的目录结构**，不在包里。照着跑会 404，而那会被误读成「我的架构坏了」。
-
-**★ 这几条为什么放在这里**：七句话是**判断题**，而判断题最容易自我安慰。
-先跑一遍能跑的，**你的答案就有了对手**。
-
-★ 而这三条命令**分属三个不同的工具** —— 这不是巧合：
-**账本（记得住）+ 门（找得到）+ 自我层（不退化）** 本来就是一套，
-单独装任何一个都会缺一角。
+# 自检 · 拿这七句话问自己的架构
+
+不用回答我，回答你自己。**答不上来的那一句，就是你缺的那一层。**
+
+## 关于空间（Ⅰ）
+
+1. 我的上下文满了以后，被丢掉的东西**还能不能找回来**？靠什么？
+   → 答不上来：你要的是 **① 账本 + ② 门**（`tools/ledger`、`tools/gateway`）。没有门，丢了就是丢了。
+2. 我有没有一个**唯一**的记忆权威源？如果有两份，哪一份算数？
+   → 答不上来：你有两个「我」在各自记东西。要的是**只追加账本**（`tools/ledger`）——它天然没有这个问题：各写各的行，读时按时间合并。
+3. 我的每一次压缩/裁剪，产物里**带没带**回原文的指针？
+   → 答不上来：去装 `dsh-agent-compaction` 与 `dsh-agent-pruner`。★ 判据是「能不能一把回到原文」，不是「有没有加一行说明」。
+
+## 关于时间与方向（Ⅱ）
+
+4. 我烧光预算的时候，**谁会知道**？知道之后发生什么？
+   → 答不上来：你没有第二道闸。要的是 `dsh-agent-huanqi`（四条判据：流内早杀 / 流末判定 / 输出重复 / 空回合；共用一本额度账，命中就续、耗尽熔断）。
+5. 我在原地打转的时候，**谁会知道**？它凭什么判定我在打转？
+   → 答不上来：同上 —— 打转和烧预算是同一件事的两面。★ 判定依据必须是**可观测的重复**，不能是「我觉得」。
+6. 我「该停不停」和「差一步就停」——这两种，我分得开吗？靠什么分？
+   → 答不上来：这一句最硬，因为它没有现成的插件。★ 判据：**「还能更好」不算「没完成」** —— 分不清这两者，就会把「保养」当成「干活」。
+
+## 关于接口（判据 ④）
+
+7. 上面这六件事里，哪一件**坏了没有人会发现**？
+   → 这一句是整份体检的收口。答不上来：你要的是 `dsh-agent-echo`（体检台）——★ 它的价值不是报告状态，是**报告它测不到什么**。
+
+---
+
+## 包装箱里的文件对不对
+
+`agent_soul_doctor` 工具会核对包内 **soul/ 目录下全部知识文件**是否齐全可读。
+**那只是核对文件在不在 —— 上面七句话才是真的体检。**
+
+---
+
+## 能跑的那一半（先跑完再回答上面七句）
+
+上面七句要你自己答。但**其中四句是可以先机械查掉的** —— 查完再答，答案会诚实得多：
+
+```bash
+# ★ 下面的 <kit> 指本仓库的 kit/echo/ —— 那是随包发的可跑脚本。
+#   如果你把它复制到了别处，换成你自己的路径。
+
+# ① 账本还在不在、有多少条 / 门能不能开   → 对应第 1、2 句
+node <kit>/memq.mjs now
+
+# ② 索引建过没有                          → 对应第 1 句
+node <kit>/memindex.mjs stats
+
+# ③ 自我层有没有退化                      → 对应第 7 句（"坏了没人发现"）
+node <kit>/self.mjs --check
+
+# ④ 闸门还灵不灵                          → 对应第 2 句（唯一权威源）
+node <kit>/mo.mjs add promise "闸门测试" --ref "自检"
+#    ★ 期望：不是主导会话 → 非零退出码 + 拒绝写入。若写进去了，闸门已失效。
+```
+
+★ **这四条都能在这个仓库里跑通** —— 上一版写的 `tools/ledger/` `tools/gateway/` `tools/self/`
+是**参考实现的目录结构**，不在包里。照着跑会 404，而那会被误读成「我的架构坏了」。
+
+**★ 这几条为什么放在这里**：七句话是**判断题**，而判断题最容易自我安慰。
+先跑一遍能跑的，**你的答案就有了对手**。
+
+★ 而这三条命令**分属三个不同的工具** —— 这不是巧合：
+**账本（记得住）+ 门（找得到）+ 自我层（不退化）** 本来就是一套，
+单独装任何一个都会缺一角。