dsh-plugin-tool-management 0.20.3 → 0.21.1

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/ops/trash.js

@@ -269,7 +269,18 @@ export function buildTrashOps(rc) {
         catch {
             return fail('error.rules.notFound', `回收站条目不存在：${id}`);
         }
-        return { ok: true, id, domain, files: await readTrashPayloadFiles(dir) };
+        // 清单也一并回给界面（用户 2026-10-18：「回收站的详细功能做的不够好，显示的内容不够全，
+        // 例如场景没有显示勾选了什么」）：场景的档案、记忆的场景 / 形态都在 `manifest.json` 里，
+        // 只回文件列表的话，详情页能看到的就只剩"有几个文件"。
+        // 读不到 / 坏了就回 null —— 详情页按"只有文件"那一档渲染，不因为清单缺了就整页报错。
+        let manifest = null;
+        try {
+            manifest = JSON.parse(await readFile(join(dir, 'manifest.json'), 'utf8'));
+        }
+        catch {
+            manifest = null;
+        }
+        return { ok: true, id, domain, manifest, files: await readTrashPayloadFiles(dir) };
     }
     return { rulesRemove, rulesRestore, rulesTrashList, rulesTrashRemove, trashPreview };
 }

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/settings-sidecars.js

@@ -10,6 +10,7 @@ import { hubPath } from './hub.js';
 import { DEFAULT_INJECT_SETTINGS, normalizeInjectSettings } from './context-inject.js';
 import { normalizeSceneSettings } from './scene-settings.js';
 import { normalizeSlashSettings } from './slash-settings.js';
+import { normalizeSidebarSettings } from './sidebar-settings.js';
 export function createSettingsSidecars(deps) {
     // 注入设置（侧车 `inject-settings.json`，界面在「兼容」页）：
     //   - underSuppressingPresets：压制型预设（persona complete / 关运行时上下文，如极简）
@@ -131,6 +132,40 @@ export function createSettingsSidecars(deps) {
             return { ok: true, settings: next };
         });
     }
+    // 侧栏入口的开关（侧车 `sidebar-settings.json`）：只一项 —— 侧栏里挂不挂本插件那一行。
+    // 与 `slash-settings` 同规格：入口开关，不冻结；读侧不带 `set` 是纯读（客户端 boot 时
+    // 必问一次决定注不注册，那一次不能要令牌，否则没配令牌的宿主上这个入口永远出不来）。
+    const SIDEBAR_SETTINGS_FILE = 'sidebar-settings.json';
+    const SIDEBAR_SETTINGS_TTL_MS = 3000;
+    let sidebarSettingsCache = null;
+    async function readSidebarSettings(force = false) {
+        if (sidebarSettingsCache && !force && Date.now() - sidebarSettingsCache.at < SIDEBAR_SETTINGS_TTL_MS)
+            return sidebarSettingsCache.value;
+        await deps.ensurePaths();
+        const raw = await deps.readJsonFile(hubPath(SIDEBAR_SETTINGS_FILE));
+        const value = normalizeSidebarSettings(raw);
+        sidebarSettingsCache = { at: Date.now(), value };
+        return value;
+    }
+    async function sidebarSettingsOp(args) {
+        const current = await readSidebarSettings();
+        if (!args || args.set !== true)
+            return { ok: true, settings: current };
+        const next = normalizeSidebarSettings({
+            enabled: typeof args.enabled === 'boolean' ? args.enabled : current.enabled,
+        });
+        await deps.ensurePaths();
+        return deps.withWriteLock(async () => {
+            try {
+                await deps.writeJsonFile(hubPath(SIDEBAR_SETTINGS_FILE), next);
+            }
+            catch (e) {
+                return { ok: false, error: '设置保存失败: ' + deps.message(e) };
+            }
+            sidebarSettingsCache = { at: Date.now(), value: next };
+            return { ok: true, settings: next };
+        });
+    }
     return {
         readInjectSettings,
         injectSettingsSync,
@@ -140,5 +175,7 @@ export function createSettingsSidecars(deps) {
         sceneSettingsOp,
         readSlashSettings,
         slashSettingsOp,
+        readSidebarSettings,
+        sidebarSettingsOp,
     };
 }

package/lib/sidebar-settings.js

@@ -0,0 +1,13 @@
+// 侧栏入口的开关（侧车 `sidebar-settings.json`，按钮在「兼容」页页头）。
+//
+// 与 `slash-settings.ts` 同一档：它是个**入口开关**，不是管理动作 —— 所以不进场景冻结
+// （锁着场景的人照样能把它关掉），也不参与任何门禁判定。
+//
+// 为什么存服务端而不是 localStorage：与其余入口开关同一个家，换浏览器也在；存本地就
+// 只有那个浏览器认，而这条开关的用途正是"这台机器上我不想在侧栏看到它"。
+export const DEFAULT_SIDEBAR_SETTINGS = { enabled: true };
+/** 把任意输入夹成合法设置：读不到 / 形状不对一律按默认开启。 */
+export function normalizeSidebarSettings(raw) {
+    const obj = (raw && typeof raw === 'object' ? raw : {});
+    return { enabled: typeof obj.enabled === 'boolean' ? obj.enabled : DEFAULT_SIDEBAR_SETTINGS.enabled };
+}

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');
 }

package/lib/subagents/child-preset.js

@@ -0,0 +1,120 @@
+// Agent Preset helpers for persona-scoped child composition.
+//
+// DSH 0.2.1 removed persona/toolFilter from SubagentStartRequest. A spawn child
+// can still select an independent preset, so this module clones the parent's
+// declared preset, replaces its persona row, and registers a short-lived preset
+// id for that child. The clone is mounted by the official registry; nothing in
+// the official package is patched.
+import { createHash } from 'node:crypto';
+import { JSON_SCHEMA, Type, load } from 'js-yaml';
+import { renderPersonaPrompt } from './persona-parse.js';
+const CHILD_PRESET_PREFIX = 'tool-management-child-';
+const JS_EXPR_TAG = 'tag:yaml.org,2002:js';
+const jsExprType = new Type(JS_EXPR_TAG, {
+    kind: 'scalar',
+    resolve: (data) => typeof data === 'string',
+    construct: (data) => ({ __jsExpr: data }),
+    represent: (data) => data.__jsExpr,
+});
+const entryListSchema = JSON_SCHEMA.extend(jsExprType);
+/** `!!js` 标量（官方 `entryListSchema` 的 `JsExpr`）：克隆时只带 `__jsExpr` 一个键。 */
+function isJsExpr(value) {
+    return typeof value === 'object' && value !== null && '__jsExpr' in value;
+}
+function presetRosterOf(ctx) {
+    try {
+        return ctx?.get?.('agentPresets');
+    }
+    catch {
+        return undefined;
+    }
+}
+function cloneEntry(value) {
+    if (isJsExpr(value))
+        return { __jsExpr: value.__jsExpr };
+    if (!value || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value))
+        return value.map(cloneEntry);
+    const copy = {};
+    for (const [key, item] of Object.entries(value))
+        copy[key] = cloneEntry(item);
+    return copy;
+}
+function isPersonaOrPresetSwitch(row) {
+    if (row.name === '@deepseek-ai/dsh-persona')
+        return true;
+    // A custom preset row would replace the whole composition; cloning it would
+    // silently change the parent instead of merely overriding its persona.
+    return row.name === '@deepseek-ai/dsh-agent-preset';
+}
+function removePersonaRows(rows) {
+    const kept = [];
+    for (const value of rows) {
+        // 不是对象的行：官方 entry list 不接受它，说明这份组合已不是本插件读懂的形状。
+        // 静默原样保留会把"人设"语义悄悄换掉（克隆出来的预设带着看不懂的行），所以明确报错。
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            throw new Error('the parent agent preset composition contains a non-object plugin row; cannot clone it safely');
+        }
+        const row = value;
+        if (isPersonaOrPresetSwitch(row))
+            continue;
+        if (row.group === true) {
+            const config = Array.isArray(row.config) ? removePersonaRows(row.config) : row.config;
+            kept.push(cloneEntry({ ...row, config }));
+        }
+        else {
+            kept.push(cloneEntry(row));
+        }
+    }
+    return kept;
+}
+/** Read the parent preset's declared rows and return a child definition. */
+export async function childPresetDefinition(parentAgent, persona) {
+    const parentCtx = parentAgent?.ctx;
+    const roster = presetRosterOf(parentCtx);
+    if (!roster || typeof roster.composedPreset !== 'function' || typeof roster.readDocument !== 'function' || typeof roster.register !== 'function') {
+        throw new Error('this host lacks the agent-preset read/register API, so no standalone persona can be created for the subagent; upgrade to DSH >= 0.2.1 and enable the agentPresets service');
+    }
+    const parentPresetId = String(roster.composedPreset(parentCtx) ?? '');
+    if (!parentPresetId)
+        throw new Error('this parent session has no agent preset bound; cannot safely create a subagent with a persona');
+    const document = await roster.readDocument(parentPresetId);
+    if (!document || typeof document.content !== 'string') {
+        throw new Error(`failed to read the parent agent preset "${parentPresetId}": readDocument returned no composition YAML`);
+    }
+    let parsed;
+    try {
+        parsed = load(document.content, { schema: entryListSchema });
+    }
+    catch (error) {
+        throw new Error(`failed to parse the parent agent preset "${parentPresetId}": ${String(error?.message ?? error)}`);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error(`the composition of the parent agent preset "${parentPresetId}" is not a list of plugin rows; cannot clone it`);
+    }
+    const plugins = removePersonaRows(parsed);
+    plugins.unshift({
+        id: 'tool-management-child-persona',
+        name: '@deepseek-ai/dsh-persona',
+        config: { prefix: renderPersonaPrompt(persona) },
+    });
+    // hash 必须覆盖**父预设的组合正文**：同一个 id 的内容可以被 profile 补丁改写，只按
+    // id + 人设定哈希会让改过的内容继续复用旧定义（冷恢复/追问时加载的是上一版插件树）。
+    const hash = createHash('sha256')
+        .update(parentPresetId)
+        .update('\0')
+        .update(document.content)
+        .update('\0')
+        .update(persona.name)
+        .update('\0')
+        .update(renderPersonaPrompt(persona))
+        .digest('hex')
+        .slice(0, 16);
+    return {
+        id: CHILD_PRESET_PREFIX + hash,
+        name: `persona:${persona.name}`,
+        description: `Ephemeral child preset cloned from ${parentPresetId}`,
+        plugins: plugins,
+    };
+}

package/lib/subagents/persona-parse.js

@@ -238,12 +238,12 @@ export const DEFAULT_PERSONA_CATALOG_DEPTH = 1;
  * 放在本模块（叶子）而不是 `catalog.ts`：`tools.ts` 也要用它，而 `catalog.ts` 反向依赖
  * `tools.ts` 的 `filterBySceneBinding` —— 放那边会形成 tools ↔ catalog 的循环。
  */
-export const CONTINUABLE_MARK = '（允许追问）';
+export const CONTINUABLE_MARK = ' (continuable)';
 /**
  * 「不限制嵌套」的目录注入深度（界面下拉的第四档，前端同值见 client.js 的
  * `CATALOG_DEPTH_UNLIMITED`）。
  *
- * 取值远大于宿主能嵌套到的深度（官方 `dsh-tool-subagent` 默认 `maxDepth: 3`），所以判据
+ * 取值远大于宿主能嵌套到的深度（0.2.1 的 `dsh-subagent` 默认 `maxDepth: 1`），所以判据
  * `深度 < catalogDepth` 在任何可达的会话里都成立 —— 判据本身不必为它加特例分支。
  */
 export const UNLIMITED_PERSONA_CATALOG_DEPTH = 99;
@@ -330,18 +330,18 @@ export function textOfBlocks(blocks, type) {
 export function emptyResultNote(output, stopReason) {
     // 连思考都没有 → 子代理确实什么都没产出，这时说「没干活」是对的。
     if (textOfBlocks(output, 'reasoning') === '')
-        return '(子代理无输出)';
-    const head = '子代理没有返回正文 —— 它产出了思考';
+        return '(the subagent produced no output)';
+    const head = 'the subagent returned no text — only reasoning';
     switch (stopReason) {
         case 'max-tokens':
-            return `(${head}，但写出结论前就用完了 token 上限；需要结果请把任务拆小些再委派。)`;
+            return `(${head}, but it hit the token limit before writing a conclusion; split the task smaller and delegate again if you need a result.)`;
         case 'error':
-            return `(${head}，但中途出错了；诊断信息见后。)`;
+            return `(${head}, but it errored; diagnostics follow.)`;
         case 'aborted':
-            return `(${head}，但写出结论前被中止了。)`;
+            return `(${head}, but it was aborted before writing a conclusion.)`;
         case 'refusal':
-            return `(${head}，但它拒绝了这项任务。)`;
+            return `(${head}, but it refused this task.)`;
         default:
-            return `(${head}，但没有写出结论；可以拆小任务重新委派，或你自己接着做。)`;
+            return `(${head}, and wrote no conclusion; split the task and delegate again, or carry on yourself.)`;
     }
 }