dsh-plugin-tool-management 0.20.2 → 0.21.0

package/lib/memories/constants.js

@@ -34,10 +34,22 @@ export const GLOBAL_SCENE = 'global';
 export const GLOBAL_SCENE_LABEL = '全局';
 export const SHARED_GROUP = '_shared'; // 保留场景名：公共基线（历史语义，仍可使用）
 // ── 段渲染 ─────────────────────────────────────────────────────────────────
-export const TRUNCATION_MARKER = '<!-- truncated -->';
+/**
+ * 截断标记。**给模型看的一句英文**，不再是 `<!-- truncated -->`（2026-10-18 审查）。
+ *
+ * 旧值是个 HTML 注释：对人眼不可见（要的就是"别显示"），但模型读的是**原始 markdown** ——
+ * 它看到的是一串 `<!-- truncated -->`，既不知道这是什么、也不知道该拿它怎么办。注入正文里
+ * 没有"注释"这个概念，凡是进上下文的东西都该是给模型的一句话。
+ *
+ * 现在的写法说清两件事：有内容没进来（`Truncated`）、进来的是少于全部的（`not shown`）。
+ * 具体漏了哪些由段尾的 `## Not injected` 清单回答，标记只在清单本身也放不下时才独自出现。
+ */
+export const TRUNCATION_MARKER = '(Truncated: some entries are not shown.)';
 // 段尾清单：让模型知道自己漏了什么。去掉伞标题后这里也不再挂「场景记忆」前缀 ——
-// 它紧跟在场景块之后，`参考信息` 与段首引导语同一说法。
-export const DROPPED_HEADING = '## 未注入的参考信息（超出预算）';
+// 它紧跟在场景块之后，与段首引导语同一说法。2026-10-18 起两者都是英文（见 SCENE_MEMORY_NOTE）。
+// 每行只有 `场景/名称`：原先还带 `(N B)`，那个字节数对人有用、对模型零动作价值
+// （它不能凭"这条 800 B"决定读不读）—— 2026-10-18 审查按"注入只写模型能用的信息"删掉。
+export const DROPPED_HEADING = '## Not injected (over the size limit)';
 /** 单行正文的最大长度：超过就退回「标题 + 正文块」，避免出现一条几千字符的列表行。 */
 export const INLINE_BODY_MAX = 120;
 /** 附件行里最多列几个文件名；多的只报总数（路径已经给了，缺的名字模型自己列目录即可）。 */
@@ -63,7 +75,7 @@ export const ATTACHMENT_LIST_MAX = 10;
  *
  * 用词：不用「常驻」「注入」这类内部行话（模型没有先验）。
  * ⚠️ 「用『信息』而不是『记忆』」那条**已被 2026-09-23 第四次裁定推翻**（见下）：用户
- * 给定的定稿文案里就是「记忆」，而板块标题本来就是「当前记忆」—— 两者同名反而更好，
+ * 给定的定稿文案里就是「记忆」，而板块标题本来就是 `Current memories` —— 两者同名反而更好，
  * 当时那条理由（「记忆」在系统提示词里指代不明）在板块标题定名之后也不成立了。
  *
  * 2026-09-17 重写（用户：「当前模式会不重视这些提示词」）。上一版的三个毛病都在**授权**
@@ -110,7 +122,7 @@ export const ATTACHMENT_LIST_MAX = 10;
  * 时以实际情况为准、④ 与用户当场说的冲突时以用户为准、⑤ 无关不必提 + 完整性声明（防探测，
  * 见上，那半句是整句里唯一不能删的）。77 → 48 字符（219 → 144 字节），而它**每个场景块各来
  * 一次**，所以省的是 N 倍。删掉的只有修饰与重复：「以下是用户为本机写的记录」→「本机记录」
- * （板块标题 `# 当前记忆` 已经把"这是本机的记忆"说过了），两句"冲突时以…为准"
+ * （板块标题 `# Current memories` 已经把"这是本机的记忆"说过了），两句"冲突时以…为准"
  * 合成一句。
  *
  * 2026-09-23 第四次裁定（用户直接给定稿文案，逐字）：
@@ -118,7 +130,7 @@ export const ATTACHMENT_LIST_MAX = 10;
  * 相对第三版有三处变化，都不是措辞偏好：
  *   ① 「本机记录」→「以下是**当前场景对应的**记忆」：说清这是**哪个范围**的记忆。记忆本来
  *      就按场景组织，而这一段列出的条目确实全来自"当前启用的场景 + 两个保留桶" —— 比
- *      "本机记录"准确，也解释了为什么下面的条目按 `## 场景：X` 分组。
+ *      "本机记录"准确，也解释了为什么下面的条目按 `## Scene: X` 分组。
  *   ② 「用户当场说的」→「用户**目前的对话**」：同一个意思，后者更贴注入发生的场合。
  *   ③ **删掉「可能已过期」，以及完整性声明「以下就是全部信息」**。
  *      - 「可能已过期」：用户判断它与紧接的「冲突时以实际情况为准」重复 —— 后半句已经把
@@ -139,12 +151,32 @@ export const ATTACHMENT_LIST_MAX = 10;
  *   ② **`global` 的分组标题从 `## 场景：全局` 改成 `## 常驻信息`**（见 `sceneHeading`）：
  *      全局是恒常生效的保留桶，不是"一个场景"，写成场景会让模型以为它是当前场景的另一种
  *      取值。
+ *
+ * 2026-10-18（用户裁定）：**模型侧模板一律英文**，这句引导语的五个功能一个不动 ——
+ * ① 这是当前场景对应的记忆 ② 冲突时以实际情况与用户当场说的为准 ③ 无关勿提（不必提及，
+ * 不是不采用）④ 完整性声明（防探测）。**用户写的内容（记忆正文、场景名与说明）原样注入。**
+ *
+ * 同日晚些时候二次收紧（用户：「让 agent 更能注意到信息，信息高效，也不要冗余」）：
+ * `when` → `where`，`do not bring them up unless relevant` → `bring them up only when relevant`。
+ * 后者不是同义改写：否定式读起来像"对内容的态度许可"（正是第三次裁定要拆掉的那个毛病），
+ * 正向式说的是"可以提，只是别主动提"。四个功能一个没少，字数少 11 个。
  */
 /**
  * 记忆段（`memory-manager-catalog`）的授权语：条目是**记录**（权威等级低于"用户当场说的"）。
  * 放在**板块层**（第一个场景块之前），整段只出现一次 —— 见 `renderBody` 尾部。
  */
-export const SCENE_MEMORY_NOTE = '**以下是当前场景对应的记忆；冲突时以实际情况和用户目前的对话为准；无关勿提；以下就是全部信息：**';
+export const SCENE_MEMORY_NOTE = '**Memories for the current scene; where they conflict with what you observe or with what the user says in this conversation, trust that instead; bring them up only when relevant; this is the complete set:**';
+/**
+ * 同一条授权语，**去掉完整性声明**的版本 —— 只在真发生截断时用（2026-10-18 审查恢复分叉）。
+ *
+ * 第五次裁定当时判定"真截断时的矛盾可以接受"，理由是默认 128 KiB 正常碰不到。但
+ * `rulesMaxBytes` 是公开旋钮（`index.ts` 的 config），预算配小时这个矛盾就是**每一条注入都在
+ * 说谎**：段首说"这就是全部"，段尾的 `## Not injected` 紧接着列出没进来的条目。模型按段首
+ * 那句判断"没有别的记忆了"，正好是这条声明本来要防的那个误判。
+ *
+ * 预算仍按全量版预留（`sceneNoteBytes`），而截断态这句更短，所以恢复分叉不会挤掉任何条目。
+ */
+export const SCENE_MEMORY_NOTE_PARTIAL = '**Memories for the current scene; where they conflict with what you observe or with what the user says in this conversation, trust that instead; bring them up only when relevant:**';
 // ── bundle 与索引 ──────────────────────────────────────────────────────────
 // bundle 附件限制（body 走 HTTP JSON + base64，故比技能上传收紧一档）。
 export const MAX_ATTACH_ENTRY_BYTES = 8 << 20; // 单个附件 8 MiB

package/lib/memories/projection.js

@@ -129,38 +129,38 @@ export function sceneLabel(scene, index) {
 /**
  * 记忆段里的场景**分组**标题。
  *
- * `global` 是恒常生效的保留桶，不是"一个场景" —— 叫它 `## 场景：全局` 会让模型以为"全局"
+ * `global` 是恒常生效的保留桶，不是"一个场景" —— 叫它 `## Scene: 全局` 会让模型以为"全局"
  * 是当前场景的另一种取值（用户 2026-09-23：「全局不需要写成场景」）。所以它单独成一种标题：
- * `## 常驻信息`。其余场景仍是 `## 场景：X`。
+ * `## Always-on memories`。其余场景仍是 `## Scene: X`。
  *
- * `_shared`（历史保留名）保持 `## 场景：_shared` 不动 —— 它只在旧数据里出现，且没有
+ * `_shared`（历史保留名）保持 `## Scene: _shared` 不动 —— 它只在旧数据里出现，且没有
  * "全局"这种"它不是场景"的语义歧义（它确实曾是一个共享场景）。
  */
-export const sceneHeading = (scene) => scene === GLOBAL_SCENE ? '## 常驻信息' : `## 场景：${sceneLabel(scene)}`;
+export const sceneHeading = (scene) => scene === GLOBAL_SCENE ? '## Always-on memories' : `## Scene: ${sceneLabel(scene)}`;
 /**
- * 场景段（`scene-manager-catalog`）里的一行：`**「<场景名>」—— 用户描述：<场景说明>**`。
+ * 场景段（`scene-manager-catalog`）里的一行：`**"<场景名>" — user description: <场景说明>**`。
  *
- * 2026-09-23 用户裁定，替换了原来的两行式（`## 场景：X` + `**场景说明：X**`）。三条理由都是
+ * 2026-09-23 用户裁定，替换了原来的两行式（`## Scene: X` + `**场景说明：X**`）。三条理由都是
  * 用户看到**实际注入**之后提的：
  *   - **场景名只出现一次**。上一版里它出现三次（框架线索"现在处在哪个场景"、引导语里的
- *     「代码」、标题里的 `## 场景：代码`），而说明行只是把同一件事换个标签再说一遍。
+ *     「代码」、标题里的 `## Scene: 代码`），而说明行只是把同一件事换个标签再说一遍。
  *   - **场景说明是「标签」，不是「约定」**。它答的是"这个场景是干什么的"，用户的实例就是
  *     「写代码」「前端相关」。上一版把它写成"一律照办、覆盖你的默认做法"，等于要求模型
  *     "照办一个标签" —— 那正是它读不懂这一段的根源。授权语已删，说明只作注解跟在名字后面。
  *   - **没填说明就不带后缀**。上一版会补 `defaultSceneDescription` 的默认句，而
  *     "用户配置的上下文，当前启用"贴在名字后面，读起来像一句真的说明。
  *
- * `用户描述：` 这个前缀是同日追加的（用户：「防止模型误解这是场景名或者其它」）：破折号后面
+ * `user description:` 这半句是同日追加的（用户：「防止模型误解这是场景名或者其它」）：破折号后面
  * 那截的形态本来有歧义 —— `**「代码」—— 写代码**` 读起来像"名字 —— 别名"，而它其实是
- * **用户写的一句说明**。加四个字把来源点明，模型就不会把它当成场景的另一个名字或某种标识符。
- * 前缀只在真有描述时出现（没填描述时整截不出现，不存在"用户描述："后面空着）。
+ * **用户写的一句说明**。加这半句把来源点明，模型就不会把它当成场景的另一个名字或某种标识符。
+ * 前缀只在真有描述时出现（没填描述时整截不出现，不存在"user description:"后面空着）。
  *
  * 为什么不再用 `##` 标题：这一段只讲"当前启用的是哪个 + 它是什么"，一行说完就够。
  * 场景**分组**标题仍在记忆段里用（`sceneHeading`），两段各自承担自己的职责。
  */
 export const sceneLine = (scene, index) => {
     const described = String(index?.scenes?.[scene]?.description ?? '').replaceAll(/\s+/g, ' ').trim();
-    return `**「${sceneLabel(scene)}」${described === '' ? '' : `—— 用户描述：${described}`}**\n\n`;
+    return `**"${sceneLabel(scene)}"${described === '' ? '' : ` — user description: ${described}`}**\n\n`;
 };
 /** 场景渲染顺序：全局 `global` 最先（它的记忆对任何对话都成立，先讲总则），
  *  其次 `_shared`（历史保留名），其余按（索引 scenes.order, 场景名）。 */
@@ -246,7 +246,7 @@ export function attachmentLine(file) {
         return '';
     const shown = names.slice(0, ATTACHMENT_LIST_MAX);
     const more = names.length - shown.length;
-    return `附件：${file.bundleDir}（${shown.join('、')}${more > 0 ? ` 等 ${names.length} 个` : ''}）`;
+    return `Attachments: ${file.bundleDir} (${shown.join(', ')}${more > 0 ? `, ${names.length} total` : ''})`;
 }
 // ── 单条记忆的渲染 ─────────────────────────────────────────────────────────
 /**
@@ -254,7 +254,7 @@ export function attachmentLine(file) {
  *
  * 为什么不是"缩进 2 格就完事"（这是上一版的实现，被实测推翻）：markdown 里缩进 ≤3 格的 `#`
  * **仍然算标题**，所以正文里一句手写的 `# 代码/需求` 会渲染成 H1，**盖过容器自己的
- * `## 场景：X`** —— 用户看到的就是这个：内容看起来"逃出了条目"，与场景标题平级甚至更高。
+ * `## Scene: X`** —— 用户看到的就是这个：内容看起来"逃出了条目"，与场景标题平级甚至更高。
  * 缩到 4 格能压住标题（块级标记都要求 ≤3 格缩进），但正文里的列表/引用只是被"压平"，
  * 视觉上仍与条目正文同级，达不到"明显从属"。
  *
@@ -279,8 +279,8 @@ export const explicitDescriptionOf = (f) => (f.descriptionDerived || !f.descript
 /**
  * 单条信息的渲染形态 —— **能一行就一行，但恒为列表项**。
  *
- *   单行且不长的正文 → `- **名称**（描述） — 正文`（与 MCP / 子智能体两个段的列表同形；无显式描述时括号不出现）
- *   多行或过长的正文 → `- **名称**（描述）` + 空行 + **围栏代码块里的正文**（挂在条目下；理由见 `bodyBlock`）
+ *   单行且不长的正文 → `- **名称** (描述) — 正文`（与 MCP / 子智能体两个段的列表同形；无显式描述时括号不出现）
+ *   多行或过长的正文 → `- **名称** (描述)` + 空行 + **围栏代码块里的正文**（挂在条目下；理由见 `bodyBlock`）
  *
  * 名称恒为标题：它就是这条记忆的身份（工具 id `<场景>/<名称>`、bundle 目录/文件名都以它为准），
  * 用户说「记忆里的 X」、模型再调 `memory_manager_*` 时都对得上号；显式描述是括号注解，不抢标题。
@@ -293,14 +293,14 @@ export const explicitDescriptionOf = (f) => (f.descriptionDerived || !f.descript
  * 为什么要分两种：用户常有十几条「一句话事实」（「提交格式：PDF」），每条都占标题 + 空行 +
  * 正文三行，整段会散成一长串标题；压成一行后十条信息就是十行。多行正文是**用户写的完整
  * Markdown**（可能自带标题、代码块、嵌套列表），放进围栏块挂到条目下 —— 上一版让它以普通
- * 段落参与外围排版，结果正文里的 `#` 会盖过 `## 场景：X`（见 `bodyBlock` 的说明）。
+ * 段落参与外围排版，结果正文里的 `#` 会盖过 `## Scene: X`（见 `bodyBlock` 的说明）。
  *
  * 返回值带 `inline`：调用方据此决定下一条记忆前要不要空行（单行条目连续排列，其余空行分隔）。
  */
 export function memoryBlock(file) {
     const desc = explicitDescriptionOf(file);
-    // 加粗的只有名称：`- **名称**（描述） — 正文`，与 MCP 段 `- **server**（N 个工具） — …` 同形。
-    const title = `**${file.name}**` + (desc === '' ? '' : `（${desc}）`);
+    // 加粗的只有名称：`- **名称** (描述) — 正文`，与 MCP 段 `- **server**（N 个工具） — …` 同形。
+    const title = `**${file.name}**` + (desc === '' ? '' : ` (${desc})`);
     const text = String(file.body ?? '').trim();
     const inline = text === '' || (!text.includes('\n') && text.length <= INLINE_BODY_MAX);
     const head = text === ''

package/lib/memories/service.js

@@ -661,9 +661,10 @@ export function createMemoriesService(ctx, deps) {
      * sha1 hex）：算的是**文件内容**（AGENTS.md 取截断前的原文），是"文件这一版"的身份，
      * 不是"这次注入了什么"；界面只拿它当悬停提示，不参与任何判定。
      *
-     * `text` 是**模型侧**正文，开头一行 `来源：<展示路径>` —— 照抄官方 agent-instructions 的
-     * 写法（`Instructions from: <path>`，`render.js` 的 `sectionText`）。模型据此知道这些规则
-     * 写在哪个文件里：用户说"把这条记下来"时它知道该改哪份文件，而不是只能凭印象回答。
+     * `text` 是**模型侧**正文，开头一行 `Instructions from: <展示路径>` —— 与官方 agent-instructions
+     * 逐字同形（`render.js` 的 `sectionText`；2026-10-18 由 `Source:` 改过来：官方注入本来就用
+     * 这个措辞，模型对它有现成的先验）。模型据此知道这些规则写在哪个文件里：用户说"把这条记下来"
+     * 时它知道该改哪份文件，而不是只能凭印象回答。
      */
     const resolvePrompt = () => {
         // 场景提示词与 AGENTS.md 正文在用户眼里就是同一件事（"全局提示词"）：场景期间前者取代后者，
@@ -678,11 +679,11 @@ export function createMemoriesService(ctx, deps) {
             const body = Buffer.byteLength(scene.text, 'utf8') <= AGENTS_MD_MAX_BYTES
                 ? scene.text
                 : Buffer.from(scene.text, 'utf8').subarray(0, AGENTS_MD_MAX_BYTES).toString('utf8') +
-                    `\n\n（…预设正文超过 ${Math.floor(AGENTS_MD_MAX_BYTES / 1024)} KiB，已截断。）`;
+                    `\n\n(Truncated: the preset body is over ${Math.floor(AGENTS_MD_MAX_BYTES / 1024)} KiB.)`;
             return {
                 path,
                 digest: createHash('sha1').update(scene.text).digest('hex'),
-                text: `来源：${path}\n\n${body}`,
+                text: `Instructions from: ${path}\n\n${body}`,
             };
         }
         const raw = readGlobalAgentsMdSync();
@@ -692,8 +693,8 @@ export function createMemoriesService(ctx, deps) {
         const body = Buffer.byteLength(raw, 'utf8') <= AGENTS_MD_MAX_BYTES
             ? raw
             : Buffer.from(raw, 'utf8').subarray(0, AGENTS_MD_MAX_BYTES).toString('utf8') +
-                `\n\n（…文件超过 ${Math.floor(AGENTS_MD_MAX_BYTES / 1024)} KiB，已截断。）`;
-        return { path, digest: createHash('sha1').update(raw).digest('hex'), text: `来源：${path}\n\n${body}` };
+                `\n\n(Truncated: the file is over ${Math.floor(AGENTS_MD_MAX_BYTES / 1024)} KiB.)`;
+        return { path, digest: createHash('sha1').update(raw).digest('hex'), text: `Instructions from: ${path}\n\n${body}` };
     };
     /**
      * 模型侧的提示词正文（`''` = 没有可注入的内容）。

package/lib/memories/snapshot.js

@@ -11,7 +11,7 @@ import { readdirSync, statSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { parseSkillDoc } from '../skills/core.js';
-import { MAX_SOURCE_DEPTH, MAX_DIRECTORIES, MAX_ENTRIES, DEFAULT_ORDER, DEFAULT_GROUP_ORDER, GLOBAL_SCENE, TRUNCATION_MARKER, DROPPED_HEADING, SCENE_MEMORY_NOTE, LEGACY_BUNDLE_DOC, bundleDocName, SHARED_GROUP, byteLen, message, isValidGroupSegment } from './constants.js';
+import { MAX_SOURCE_DEPTH, MAX_DIRECTORIES, MAX_ENTRIES, DEFAULT_ORDER, DEFAULT_GROUP_ORDER, GLOBAL_SCENE, TRUNCATION_MARKER, DROPPED_HEADING, SCENE_MEMORY_NOTE, SCENE_MEMORY_NOTE_PARTIAL, LEGACY_BUNDLE_DOC, bundleDocName, SHARED_GROUP, byteLen, message, isValidGroupSegment } from './constants.js';
 import { ensureSceneRecords, resolveActiveScenes, signatureOfIndex, sceneLabel, sceneHeading, sceneLine, compareSceneBuckets, memoryBlock } from './projection.js';
 import { isIndexQuarantined, readIndex, writeIndex, readFileOrThrowSync, isAbsentError } from './index-io.js';
 // 来源发现与投影（扫目录读成条目 / frontmatter 投成规则 / 老布局搬家）2026-10-01 整段搬到
@@ -326,7 +326,7 @@ export function renderSceneMemory(probe, index, maxBytes) {
         // 场景块只留标题：**场景说明归场景段**（`renderSceneCatalog`），否则同一句话会在
         // 上下文里出现两遍。记忆段要的是"这些条目属于哪个场景"这个分组标签。
         // `sceneHeading` 只给标题、不自带结尾空行（场景段的 `sceneLine` 才自带），这里补上 ——
-        // 否则标题会与紧跟的引导语/条目贴成一行（`## 场景：全局**以下是…**`）。
+        // 否则标题会与紧跟的引导语/条目贴成一行（`## Always-on memories**Memories for…**`）。
         const header = sceneHeading(scene) + '\n\n';
         for (const file of sceneFiles) {
             const { text: block, inline } = memoryBlock(file);
@@ -344,16 +344,16 @@ export function renderSceneMemory(probe, index, maxBytes) {
         return { text: '', bytes: 0, truncated: probe.truncated, maxBytes, scenes: [], items: [], dropped: [] };
     }
     /**
-     * 选中块 → 段正文（同一场景的 `## 场景：x` 只在首次出现时发出）。
+     * 选中块 → 段正文（同一场景的 `## Scene: x` 只在首次出现时发出）。
      *
-     * 授权语**只有一版**：2026-09-23 第四次裁定删掉了完整性声明（「以下就是全部信息」），
-     * 于是"按截断状态选长短两版"的自适应失去意义（两版会完全相同），`dropped` 参数一并移除。
-     * 详见 `SCENE_MEMORY_NOTE` 的注释 —— 代价是这一段不再有防探测手段。
+     * 授权语**两版**（2026-10-18 审查恢复分叉，理由见 `SCENE_MEMORY_NOTE_PARTIAL`）：不截断时带
+     * "this is the complete set"，截断时去掉 —— 否则段首的完整性与段尾的 `## Not injected` 直接
+     * 打架。预算仍按全量版预留（`sceneNoteBytes()`），截断态那句更短，不会多占。
      */
-    const renderBody = (selected) => {
+    const renderBody = (selected, truncated) => {
         if (selected.length === 0)
             return '';
-        const note = SCENE_MEMORY_NOTE;
+        const note = truncated ? SCENE_MEMORY_NOTE_PARTIAL : SCENE_MEMORY_NOTE;
         const chunks = [];
         let current = null;
         let buf = '';
@@ -380,7 +380,7 @@ export function renderSceneMemory(probe, index, maxBytes) {
         // 引导语只出现**一次**，放在板块层（第一个场景块之前）。
         //
         // 为什么挪上来（用户 2026-09-23 看到实际注入后要求）：此前它跟着**每个场景块**各来一遍
-        // —— 2 个场景就是 272 B ≈68 tok/轮，占记忆段整段的 22%；而且它夹在 `## 场景：X` 与条目
+        // —— 2 个场景就是 272 B ≈68 tok/轮，占记忆段整段的 22%；而且它夹在 `## Scene: X` 与条目
         // 之间，把"分组"和"内容"隔开了。它管的本来就是整段（授权语讲的是这一整段条目的效力，
         // 不是某个场景的），放在最前面才对得上。
         //
@@ -401,7 +401,8 @@ export function renderSceneMemory(probe, index, maxBytes) {
         const lines = [];
         let used = byteLen(head) + byteLen(marker);
         for (const c of missed) {
-            const line = `- ${sceneLabelOf(c.scene)}/${c.item.name}（${c.item.bytes} B）\n`;
+            // 只给 `场景/名称`：字节数对人有用、对模型没有动作价值（2026-10-18 审查）。
+            const line = `- ${sceneLabelOf(c.scene)}/${c.item.name}\n`;
             if (used + byteLen(line) > space)
                 break;
             lines.push(line);
@@ -410,8 +411,13 @@ export function renderSceneMemory(probe, index, maxBytes) {
         if (lines.length === 0)
             return byteLen(marker) <= space ? marker : '';
         const rest = missed.length - lines.length;
-        const fold = `- …（其余 ${rest} 条未列出）\n`;
-        const tail = `${head}${lines.join('')}${rest > 0 && used + byteLen(fold) <= space ? fold : ''}${marker}`;
+        const fold = `- ... (${rest} more not listed)\n`;
+        // 清单已经列全时**不再加标记**：`## Not injected` 这个标题本身就说清了"有东西没进来"，
+        // 再补一句 `(Truncated: …)` 只是把同一件事说两遍。标记只在清单**自己也不全**（有没列出的
+        // 条目）时才有信息量 —— 注意判据是 `rest > 0`，不是"折叠行放得下"：折叠行放不下时清单
+        // 同样是残缺的，标记不能跟着一起消失（那会让残缺的清单看起来是全部）。
+        const folded = rest > 0 && used + byteLen(fold) <= space;
+        const tail = `${head}${lines.join('')}${folded ? fold : ''}${rest > 0 ? marker : ''}`;
         return tail;
     };
     // ── ① 贪心：放得下就放，越界**跳过**（而不是整体停止）──────────────────
@@ -436,13 +442,17 @@ export function renderSceneMemory(probe, index, maxBytes) {
     }
     missed.sort((a, b) => a.seq - b.seq);
     // ── ② 尾注自身也占字节：放不下就把已入选的块从后往前退回，直到回到预算内 ──
-    let body = renderBody(selected);
-    let tail = renderTail(missed, maxBytes - byteLen(body), probe.truncated || missed.length > 0);
+    // 引导语要不要带完整性声明，取决于**最终**有没有截断 —— 所以每轮重算 body（贪心阶段不知道
+    // 结论）。两版字数差在 3 个词以内，预算按全量版预留，不会因此挤掉条目。
+    let truncatedNow = probe.truncated || missed.length > 0;
+    let body = renderBody(selected, truncatedNow);
+    let tail = renderTail(missed, maxBytes - byteLen(body), truncatedNow);
     while (byteLen(body) + byteLen(tail) > maxBytes && selected.length > 0) {
         missed.push(selected.pop());
         missed.sort((a, b) => a.seq - b.seq);
-        body = renderBody(selected);
-        tail = renderTail(missed, maxBytes - byteLen(body), true);
+        truncatedNow = true;
+        body = renderBody(selected, truncatedNow);
+        tail = renderTail(missed, maxBytes - byteLen(body), truncatedNow);
     }
     let text = `${body}${tail}`.replace(/^\n+/, '');
     // ③ 兜底：预算小到连标记都放不下时也宁可超出几个字节——"有记忆没注入"这件事
@@ -456,7 +466,7 @@ export function renderSceneMemory(probe, index, maxBytes) {
     return {
         text,
         bytes: byteLen(text),
-        truncated: probe.truncated || missed.length > 0,
+        truncated: truncatedNow,
         maxBytes,
         scenes,
         items: selected.map((c) => c.item),

package/lib/ops/compat.js

@@ -11,7 +11,22 @@ import { INJECT_DOMAIN_KEYS } from '../context-inject.js';
 import { MCP_TOOL_PREFIX } from '../host-names.js';
 import { assessPresetReach } from '../compat/preset-reach.js';
 import { runtimeNotes } from '../compat/runtime-notes.js';
+import { AGENTS_MD_REFRESH_PACKAGE } from '../compat/host-contracts.js';
 import { pluginLog } from '../skills/service.js';
+/**
+ * 功能总览里那几条「宿主契约」行对应的**能力 id**（capability-specs.ts 那张表）。
+ *
+ * 为什么要一张显式映射：`findings` 的 id 是宿主侧的稳定契约名（`agentPreset.register` /
+ * `tools.restrict-method` / `agent.created-event` / `connection.admit`），而行 key 是本插件自己
+ * 的界面标识（`subagent-persona` / ...）。两边命名空间不同，写成字面量表最直白，也最不容易
+ * 在改名时悄悄对错。
+ */
+const CONTRACT_CAPABILITY_IDS = {
+    'subagent-persona': 'agentPreset.register',
+    'subagent-tool-restrict': 'tools.restrict-method',
+    'subagent-created-event': 'agent.created-event',
+    'web-admission': 'connection.admit',
+};
 export function buildCompatOps(deps) {
     return {
         'compat-status': async (args) => {
@@ -72,6 +87,9 @@ export function buildCompatOps(deps) {
                     // 修复指引按实际形态给：`scripts/` 不在 `files` 里，npm 安装形态下没有
                     // `scripts/doctor.mjs` 与 `scripts/host-deps.mjs`，指了也跑不了。
                     sourceInstall: isSourceInstall(),
+                    // 宿主非 peer 契约的实况：插件按裸模块名 require 的那几个官方包。与 findings 不同源
+                    // （模块层 vs 服务层），所以单独一个字段，界面据此列出"裸模块解析"那一块。
+                    ...(assessment.contracts === undefined ? {} : { contracts: assessment.contracts }),
                     findings,
                     degraded,
                     blockers: assessment.identity.blockers,
@@ -297,9 +315,53 @@ export function buildCompatOps(deps) {
                         ...(asarHost === undefined ? {} : { asarHost: true, asarName: asarHost.asarName }),
                     }),
                 });
-                // 无独立装配点的域：没有上报就是正常（如实说明依据是"没有降级上报"）。
+                // 宿主契约层（0.2.1 新增的两处 + 一个连接面）：这几条**不是**上面那些从 0.1.x 起
+                // 就在表里的能力，而是本版适配真实依赖的宿主成员。它们的共同点是缺了**不抛错**，
+                // 只是功能少一半 —— 所以必须在总览里占一行，让"升级后某处悄悄不工作"有地方看。
+                //
+                // 逐条的后果（与 capability-specs.ts 里的 fallback 一一对应）：
+                //   · agentPreset.register 没了 → 带人设的子代理委派失败（临时预设注册不上去）；
+                //   · tools.restrict-method 没了 → 人设的 tools/toolsDeny 不生效，子代理继承父级全部工具；
+                //   · agent.created-event 串不起来 → 工具限制慢一步（首轮看到的还是继承来的工具集）；
+                //   · connection.admit 没了 → Web 鉴权退回 requestRejection，再缺则退回本地回环判定。
+                const findingOf = (id) => assessment === undefined ? undefined : assessment.findings.find((item) => item.id === id);
+                const contractRows = [
+                    ['subagent-persona', '子智能体人设委派', 'subagents'],
+                    ['subagent-tool-restrict', '子代理工具限制', 'subagents'],
+                    ['subagent-created-event', '子代理创建时序', 'subagents'],
+                    ['web-admission', 'Web 连接准入', 'compat'],
+                ];
+                for (const [key, label, tab] of contractRows) {
+                    const finding = findingOf(CONTRACT_CAPABILITY_IDS[key] ?? '');
+                    push({
+                        key, label, tab,
+                        state: finding === undefined ? 'unknown' : finding.state === 'ok' ? 'ok' : 'degraded',
+                        detail: finding === undefined ? '能力探测不可用（归档服务未挂载）' : finding.detail,
+                        ...(finding === undefined ? {} : { capabilityId: finding.id }),
+                    });
+                }
+                // 无独立装配点的域：这一行的依据必须是**真的查过什么**，不能拿一句"无降级上报"糊过去 ——
+                // 那句话对没有上报通道的域恒真（它只说明"没坏到会上报"，不说明"现在好不好"）。
+                // 有宿主模块可核的域（提示词走 AGENTS.md 裸模块，子智能体还要加上人设包）按实况说；
+                // 记忆 / 场景档案确实没有可核的宿主模块，那才停留在"无降级上报"。
+                const contractFeature = (packageName) => assessment?.contracts?.packages.find((item) => item.package === packageName);
                 for (const [key, label, tab] of [['memory', '记忆', 'memory'], ['prompts', '提示词', 'prompts'], ['subagents', '子智能体', 'subagents'], ['scenes', '场景档案', 'scenes']]) {
-                    push({ key, label, tab, state: 'ok', detail: '无降级上报（装配失败会出现在这里）' });
+                    // 子智能体的依据是那三条宿主契约 + AGENTS.md 裸模块（人设正文要走它注入）。
+                    const persona = contractFeature('@deepseek-ai/dsh-persona');
+                    const instructions = contractFeature(AGENTS_MD_REFRESH_PACKAGE);
+                    const deps = key === 'subagents'
+                        ? [persona, instructions].filter((item) => item !== undefined)
+                        : key === 'prompts' ? [instructions].filter((item) => item !== undefined) : [];
+                    const broken = deps.filter((item) => item.resolved === null || item.missingMarkers.length > 0);
+                    push({
+                        key, label, tab,
+                        state: broken.length > 0 ? 'degraded' : 'ok',
+                        detail: broken.length > 0
+                            ? '宿主契约缺失：' + broken.map((item) => item.feature).join('、')
+                            : deps.length > 0
+                                ? '依赖的宿主模块在位（' + deps.map((item) => item.feature).join('、') + '）'
+                                : '无降级上报（装配失败会出现在这里）',
+                    });
                 }
                 return { ok: true, rows, generatedAt: Date.now() };
             }

package/lib/ops/memory.js

@@ -9,7 +9,7 @@ import { lstat, mkdir, readFile, rename, rm } from 'node:fs/promises';
 import { basename, dirname, join } from 'node:path';
 import { parseSkillDoc, unquote } from '../skills/core.js';
 import { expandUploads, planMemoryImport } from '../imports/upload.js';
-import { MAX_DESCRIPTION_LENGTH, MAX_RULE_BYTES, DEFAULT_ORDER, DEFAULT_GROUP_ORDER, GLOBAL_SCENE, GLOBAL_SCENE_LABEL, TRUNCATION_MARKER, MAX_ATTACH_ENTRY_BYTES, MAX_ATTACH_TOTAL_BYTES, MAX_ATTACH_ENTRIES, LEGACY_BUNDLE_DOC, bundleDocName, SEGMENT_RULE_HINT, isValidGroupSegment, isValidGroupPath, message, fail } from '../memories/constants.js';
+import { MAX_DESCRIPTION_LENGTH, MAX_RULE_BYTES, DEFAULT_ORDER, DEFAULT_GROUP_ORDER, GLOBAL_SCENE, GLOBAL_SCENE_LABEL, MAX_ATTACH_ENTRY_BYTES, MAX_ATTACH_TOTAL_BYTES, MAX_ATTACH_ENTRIES, LEGACY_BUNDLE_DOC, bundleDocName, SEGMENT_RULE_HINT, isValidGroupSegment, isValidGroupPath, message, fail } from '../memories/constants.js';
 import { normalizeActive, enabledSceneOf, sceneOf, sceneLabel, attachmentSummarySync } from '../memories/projection.js';
 import { writeFileAtomically, writeFileAtomicBinary, readIndex, writeIndex, pathExists } from '../memories/index-io.js';
 import { deriveDescription } from '../memories/snapshot.js';
@@ -195,7 +195,7 @@ export function buildMemoryOps(rc) {
             issues.push({
                 severity: 'warning',
                 code: 'sceneMemoryTruncated',
-                message: `场景记忆段超出预算（${projection.bytes} 字节 > ${projection.maxBytes} 字节），已按确定性顺序截断并追加 ${TRUNCATION_MARKER}；请精简记忆或只保留 _shared。`,
+                message: `场景记忆段超出预算（${projection.bytes} 字节 > ${projection.maxBytes} 字节），已按确定性顺序截断，段尾附未注入清单与截断标记；请精简记忆或只保留 _shared。`,
             });
         }
         return {

package/lib/ops/prompts.js

@@ -2,7 +2,28 @@
 //
 // 与 ops/compat.ts 同一条纪律：只负责 op 实现，依赖显式传参；MCP 写后刷新、场景锁定守卫
 // 仍作用在组装后的整张表上（见 index.ts）。
+import { resolveAgentsHome } from '../skills/homes.js';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
 export function buildPromptOps(deps) {
+    /**
+     * 共享 agents 根的 `AGENTS.md`（`~/.agents/AGENTS.md`）。
+     *
+     * 0.2.1 起这条文件**也在被注入**：官方 `dsh-agent-instructions` 的用户全局链是
+     * `$DSH_HOME/AGENTS.md` → `<agentsHome>/AGENTS.md` 两份并列（内容相同只渲染一次），
+     * 而本插件的提示词页只管得到第一份。于是"我改了什么都没变化"有了第二个成因：
+     * 真正在说话的是第二份。这里只回答**它在不在、路径在哪**，不提供写入入口 ——
+     * 写入会与官方自己的去重/刷新规则互相覆盖，而这份文件的读者还包括别的 agent 工具。
+     */
+    const agentsHomeAgentsMd = () => {
+        const path = join(resolveAgentsHome(), 'AGENTS.md');
+        let exists = false;
+        try {
+            exists = existsSync(path);
+        }
+        catch { /* 读不到 = 当作不在，不阻塞列表 */ }
+        return { path, exists };
+    };
     return {
         // 提示词预设库（由 ../prompts/service.ts 提供）。这里把两件事对齐成用户看到的一份状态：
         //   - `active`（界面「生效中」）= **当前真正在起作用的基线**：启用的场景绑了预设就是它，
@@ -40,7 +61,7 @@ export function buildPromptOps(deps) {
                     refs: refs ? refs.get(p.id) || [] : [],
                 };
             });
-            return { ...base, presets, ...(scenePrompt ? { scenePrompt } : {}) };
+            return { ...base, presets, ...(scenePrompt ? { scenePrompt } : {}), agentsHomeAgentsMd: agentsHomeAgentsMd() };
         },
         'agentsmd-read': (args) => deps.promptsService.read(String((args && args.id) || '')),
         // content 与 from 都可选：新建弹窗里直接写正文（content），或从现有预设复制（from）。
@@ -107,7 +128,14 @@ export function buildPromptOps(deps) {
             }
             return res;
         },
-        'agentsmd-get-current': () => deps.promptsService.getCurrent(),
+        // 与 `agentsmd-list` 同一份事实：两处都要展示"共享 agents 根那一份在不在"（列表用来
+        // 提示，当前页用来对照），分成两个实现必然会出现"列表说在、当前页说不在"。
+        'agentsmd-get-current': async () => {
+            const res = await deps.promptsService.getCurrent();
+            if (!res || res.ok === false)
+                return res;
+            return { ...res, agentsHomeAgentsMd: agentsHomeAgentsMd() };
+        },
         // 删除：**场景绑定**与**当前应用的那份**拦得住（判据见下方注释）。拒绝时逐条说明「谁在用」，
         // 用户知道该先改哪里。引用清单由 scene-prompt-sync 与显示/注入同源算出。
         //

package/lib/request-gate.js

@@ -31,9 +31,10 @@ export function createAccessToken(deps) {
     //   2. defense in depth — when set, every state-changing op additionally
     //      requires `x-dsh-token: <token>`.
     // It is NOT the primary gate anymore: the route calls the host's
-    // connection.requestRejection fence first (Host must be loopback/LAN
-    // IP-literal → defeats DNS rebinding, plus browser-session cookie auth),
-    // so an unset token no longer means "anyone may call writes".
+    // connection.admit fence first (Host must be loopback/LAN IP-literal →
+    // defeats DNS rebinding, plus browser-session cookie auth, plus the
+    // owner-Principal check an exact route owes), so an unset token no longer
+    // means "anyone may call writes".
     // NOTE: the entry config arrives as the SECOND apply argument (Cordis
     // calls `callback(ctx, config)`) — never read it off `ctx.config`, which
     // is not an injected service and throws "cannot get property without
@@ -151,7 +152,7 @@ export function createSceneLock(deps) {
         if (!scene)
             return null;
         const locked = await lockedSceneNames();
-        return locked.includes(scene) ? `场景「${scene}」已锁定，本次写入被拒：锁定期间该域不可修改，需用户解锁后再试。` : null;
+        return locked.includes(scene) ? `scene "${scene}" is locked, so this write was refused: that domain cannot be modified while the scene is locked; the user has to unlock it first.` : null;
     }
     return { lockedSceneNames, activeSceneName, lockedSceneGuard };
 }

package/lib/skills/catalog.js

@@ -81,8 +81,8 @@ export function renderSkillCatalog(data, maxEntries = SKILL_CATALOG_MAX_ENTRIES,
     // 它只会去猜名字。数量照报 —— 那是实话，与有没有出口无关。
     if (hidden > 0) {
         out.push('', listToolVisible
-            ? `（另有 ${hidden} 个未列出，用 \`skill_manager_list\` 查。）`
-            : `（另有 ${hidden} 个未列出。）`);
+            ? `(${hidden} more not listed — see them with \`skill_manager_list\`.)`
+            : `(${hidden} more not listed.)`);
     }
     return out.join('\n');
 }

package/lib/subagents/catalog.js

@@ -13,7 +13,7 @@ export const DEFAULT_CATALOG_DESCRIPTION_MAX_LENGTH = 500;
 /** 段里最多列几个人设；超出部分只报数量，让模型自己去调 subagent_manager_list。 */
 export const DEFAULT_CATALOG_MAX_ENTRIES = 50;
 /** 无描述时的占位，与 `subagent_manager_list` 工具的输出保持同一口径。 */
-const NO_DESCRIPTION = '(无描述)';
+const NO_DESCRIPTION = '(no description)';
 /**
  * 描述归一化 + 截断 —— 逐字对齐官方 `dsh-tool-skill` 的实现：
  * 先把所有空白折叠成单空格，再按长度截断并补省略号。保证「一人设一行」。
@@ -57,12 +57,12 @@ export function renderSubagentCatalog(allowed, maxEntries = DEFAULT_CATALOG_MAX_
     const out = [...lines];
     // 查询工具**只在真被 40 条上限截掉时**才出现：常态下不提，省常驻字符，也免得模型为了
     // 「确认一遍」去调它（用户裁定：没列出来的就是当前不想要的）。与 MCP 状态段的
-    // `（另有 N 台未列出。）` 同一句式，但这里多给一个出口——不给人设就真的找不回来了。
+    // `(${N} more not listed.)` 同一句式，但这里多给一个出口——不给人设就真的找不回来了。
     if (hidden > 0) {
         // 与技能目录同一条纪律：点名一个被关掉的工具只会让模型去猜名字。数量照报。
         out.push('', listToolVisible
-            ? `（另有 ${hidden} 个未列出，用 \`subagent_manager_list\` 查。）`
-            : `（另有 ${hidden} 个未列出。）`);
+            ? `(${hidden} more not listed — see them with \`subagent_manager_list\`.)`
+            : `(${hidden} more not listed.)`);
     }
     return out.join('\n');
 }