dsh-plugin-tool-management 0.20.2 → 0.21.0

package/lib/tools/prompt.js

@@ -19,7 +19,7 @@ export function buildPromptTools(deps) {
         // 那句 `(that reminder is absent when the preset carries the official instructions line)`
         // 删掉（2026-10-15 注入文本审查）：模型**观测不到**"official instructions line"这个条件，
         // 拿它做不了任何决定 —— reminder 在不在，它抬头就能看见，不必由描述来预告。
-        description: 'List AGENTS.md presets (id, description, active state, file path); read that file for a preset body. The one in effect is in the「当前提示词」reminder, whose「来源：」line names the file. Defaults to the one in effect; all=true for the whole library.',
+        description: 'List AGENTS.md presets (id, description, active state, file path); read that file for a preset body. The one in effect is in the "Current prompt" reminder, whose "Instructions from:" line names the file. Defaults to the one in effect; all=true for the whole library.',
         parameters: {
             all: { type: 'boolean', description: 'Include inactive presets (default false).' },
         },
@@ -28,7 +28,7 @@ export function buildPromptTools(deps) {
             const showAll = Boolean(args && args.all === true);
             const r = await deps.promptOps['agentsmd-list']({});
             if (!r || r.ok === false)
-                throw new Error((r && r.error) || '读取提示词预设失败');
+                throw new Error((r && r.error) || 'failed to read the AGENTS.md presets');
             const all = r.presets || [];
             // 默认只列「这份 AGENTS.md 来自哪个预设」（用户裁定 2026-09-16）。
             // 判定分两级：`active`（场景驱动时 = 场景绑的那份；否则 = 内容逐字节相同）优先，
@@ -88,21 +88,21 @@ export function buildPromptTools(deps) {
                 // 不说的话用户以为 AGENTS.md 还在（0.19.1 界面弹窗报的就是这两种）。
                 const r = await deps.unapplyPreset();
                 if (!r.ok)
-                    throw new Error(r.error || '取消应用失败');
+                    throw new Error(r.error || 'failed to cancel the application');
                 return r.removed === true
                     ? 'OK: application cancelled — ~/.dsh/AGENTS.md did not exist before the run started, so the file was removed (effective next turn).'
                     : 'OK: application cancelled — ~/.dsh/AGENTS.md is back to what it was before the run started (effective next turn).';
             }
             const id = String((args && args.id) || '').trim();
             if (id === '')
-                throw new Error('缺少参数：id（只有 apply=false 取消时才不用给）');
+                throw new Error('missing argument: id (only optional when apply=false cancels)');
             const r = await deps.applyPresetGuarded(id);
             if (!r.ok)
                 throw new Error(r.error);
             // 场景驱动时写的是「场景绑定」，回执必须说清改的是哪个场景 —— 只说「已应用到
             // AGENTS.md」会让模型对用户谎报（用户不知道自己的场景绑定被换掉了）。
             if (r.viaScene) {
-                return 'OK: preset ' + id + ' is now the prompt binding of scene 「' + (r.scene || '') + '」 and the scene was re-synced (effective next turn; ~/.dsh/AGENTS.md now carries that scene\'s binding).';
+                return 'OK: preset ' + id + ' is now the prompt binding of scene "' + (r.scene || '') + '" and the scene was re-synced (effective next turn; ~/.dsh/AGENTS.md now carries that scene\'s binding).';
             }
             // 生效时机与宿主行为对齐（index.ts 提示词服务一节考证过）：dsh-agent-instructions
             // 每个 pre-step 都 stat 比对版本，写文件即下一轮重读 —— 不是"下个会话"。说错了

package/lib/tools/remove.js

@@ -50,13 +50,13 @@ function restoredName(r) {
 async function runRemove(deps, cfg, args) {
     const action = String((args && args.action) || '');
     if (action !== 'trash' && action !== 'restore' && action !== 'list') {
-        throw new Error('action 只能是 trash / restore / list（收到：' + (action || '(空)') + '）');
+        throw new Error('action must be trash / restore / list (got: ' + (action || '(empty)') + ')');
     }
     if (action === 'list') {
         const entries = await cfg.list();
         return entries.length
-            ? '回收站（' + entries.length + ' 条）：\n' + entries.map((e) => '- ' + e.id + ' · ' + e.name + (e.deletedAt ? ' · ' + e.deletedAt : '')).join('\n')
-            : '回收站是空的。';
+            ? 'trash: ' + entries.length + ' item(s)\n' + entries.map((e) => '- ' + e.id + ' · ' + e.name + (e.deletedAt ? ' · ' + e.deletedAt : '')).join('\n')
+            : 'the trash is empty.';
     }
     // 进 / 出回收站都是写：过场景冻结守卫（与面板的删除按钮同一档）。
     const blocked = await deps.lockedSceneGuard();
@@ -64,19 +64,19 @@ async function runRemove(deps, cfg, args) {
         throw new Error(blocked);
     const id = String((args && args.id) || '').trim();
     if (id === '')
-        throw new Error('缺少参数：id（action=' + action + ' 需要）');
+        throw new Error('missing argument: id (required by action=' + action + ')');
     const r = action === 'trash' ? await cfg.trash(args) : await cfg.restore(args);
     if (!r || r.ok === false)
-        throw new Error((r && r.error) || (action === 'trash' ? '移入回收站失败' : '恢复失败'));
+        throw new Error((r && r.error) || (action === 'trash' ? 'failed to move it to the trash' : 'restore failed'));
     if (action === 'trash') {
-        return 'OK: ' + cfg.label + '「' + id + '」已移入回收站（可恢复；永久删除在面板的回收站里）';
+        return 'OK: ' + cfg.label + ' "' + id + '" moved to the trash (recoverable; permanent deletion lives in the panel trash)';
     }
     // 恢复的回执要说**恢复成了什么**，而不是回收站条目 id（2026-10-15 smoke-test P1-6）：
     // `id` 是 `action=list` 给的那一串（记忆 `mv…`、技能 `<时间戳>-<uuid>`），模型看到它
     // 认不出恢复了哪一条；退号恢复时最终落盘的名字还与回收站里的原名不同，更要说准。
     const name = restoredName(r) || id;
-    return 'OK: 已从回收站恢复 ' + cfg.label + '「' + name + '」' +
-        (name === id ? '' : '（回收站条目 ' + id + '）');
+    return 'OK: restored ' + cfg.label + ' "' + name + '" from the trash' +
+        (name === id ? '' : ' (trash entry ' + id + ')');
 }
 export function buildRemoveTools(deps) {
     const { defineTool, register } = deps;
@@ -86,18 +86,18 @@ export function buildRemoveTools(deps) {
     const pr = deps.promptOps;
     const sc = deps.sceneOps;
     const memoryCfg = {
-        noun: 'memory', label: '记忆',
+        noun: 'memory', label: 'memory',
         trash: (a) => mem['rules-remove']({ id: String(a.id || '') }),
         restore: (a) => mem['rules-restore']({ trashId: String(a.id || '') }),
         list: async () => {
             const r = await mem['rules-trash-list']({});
             if (!r || r.ok === false)
-                throw new Error((r && r.error) || '读取回收站失败');
+                throw new Error((r && r.error) || 'failed to read the trash');
             return (r.entries || []).map((e) => ({ id: String(e.trashId), name: String(e.name), deletedAt: e.deletedAt }));
         },
     };
     const skillCfg = {
-        noun: 'skill', label: '技能',
+        noun: 'skill', label: 'skill',
         // 与 `skill_manager_switch` 同一条（smoke-test P0-1）：不给 root 就按名字在全部来源里
         // 找胜出的那一份。默认值原本是 dsh，而 `skill_manager_save` 落 hub —— 「建完就删」
         // 必然报「技能不存在」。删一个真的不存在的技能时退回 dsh，交给 op 报它自己的错。
@@ -117,30 +117,30 @@ export function buildRemoveTools(deps) {
         },
     };
     const subagentCfg = {
-        noun: 'persona', label: '人设',
+        noun: 'persona', label: 'persona',
         trash: (a) => sub['subagent-delete']({ name: String(a.id || '') }),
         restore: (a) => sub['subagent-trash-restore']({ id: String(a.id || '') }),
         list: async () => {
             const r = await sub['subagent-trash-list']({});
             if (!r || r.ok === false)
-                throw new Error((r && r.error) || '读取回收站失败');
+                throw new Error((r && r.error) || 'failed to read the trash');
             return (r.trash || []).map((e) => ({ id: String(e.id), name: String(e.name), deletedAt: e.deletedAt }));
         },
     };
     const promptCfg = {
-        noun: 'preset', label: '提示词预设',
+        noun: 'preset', label: 'preset',
         trash: (a) => pr['agentsmd-remove']({ id: String(a.id || '') }),
         restore: (a) => pr['agentsmd-trash-restore']({ id: String(a.id || '') }),
         list: async () => {
             const r = await pr['agentsmd-trash-list']({});
             if (!r || r.ok === false)
-                throw new Error((r && r.error) || '读取回收站失败');
+                throw new Error((r && r.error) || 'failed to read the trash');
             const arr = Array.isArray(r) ? r : (r.presets || r.trash || r.entries || []);
             return arr.map((e) => ({ id: String(e.id), name: String(e.name || e.id), deletedAt: e.deletedAt }));
         },
     };
     const sceneCfg = {
-        noun: 'scene', label: '场景',
+        noun: 'scene', label: 'scene',
         // 删场景走 handlers 里那份（`withAgentsMdSync` 包过）：直调 `memoriesService.ops` 会漏掉
         // 「场景绑的预设曾写进 AGENTS.md，删了要跟着处理」那一步。
         trash: (a) => deps.sceneRemove({ name: String(a.id || '') }),
@@ -148,7 +148,7 @@ export function buildRemoveTools(deps) {
         list: async () => {
             const r = await sc['scene-trash-list']({});
             if (!r || r.ok === false)
-                throw new Error((r && r.error) || '读取回收站失败');
+                throw new Error((r && r.error) || 'failed to read the trash');
             return (r.trash || []).map((e) => ({ id: String(e.id), name: String(e.name), deletedAt: e.deletedAt }));
         },
     };

package/lib/tools/scene.js

@@ -60,7 +60,7 @@ function toolTableLabel(name) {
     const v = typeof name === 'string' ? name.trim() : '';
     if (!v)
         return '';
-    return v === FACTORY_TOOL_TABLE_PRESET ? '出厂默认' : v;
+    return v === FACTORY_TOOL_TABLE_PRESET ? 'factory default' : v;
 }
 /**
  * 一个档案的名单渲染（`_list` 用）。**点名而不是只给数量**：模型要判断"这个场景进入时会不会
@@ -68,23 +68,23 @@ function toolTableLabel(name) {
  */
 function archiveText(archive) {
     if (!archive || typeof archive !== 'object')
-        return '未建（进入时 MCP / 技能 / 人设 三个域全部停用）';
+        return 'not created (entering turns off all MCP / skill / persona domains)';
     const keys = (v) => (v && typeof v === 'object' && !Array.isArray(v) ? Object.keys(v) : []);
     const list = (v) => (Array.isArray(v) ? v.map((x) => String(x)) : []);
     const parts = [
         'MCP ' + toolNameList(keys(archive.mcp)),
-        '技能 ' + toolNameList(list(archive.skills)),
-        '人设 ' + toolNameList(list(archive.subagents)),
+        'skills ' + toolNameList(list(archive.skills)),
+        'personas ' + toolNameList(list(archive.subagents)),
     ];
     const notes = keys(archive.mcpNotes);
     if (notes.length)
-        parts.push('备注 ' + toolNameList(notes));
+        parts.push('notes ' + toolNameList(notes));
     // 模型工具表方案（0.15.0 起档案里有这一栏）：进入时换的是**模型自己能用什么**，不报就是
     // 让它事后发现自己少了工具却说不出原因。只给方案名 —— 关停名单不在档案里，硬算要多读一次
     // 方案清单，而真正需要条数的时机是切换之后（那条回执有）。没绑就不冒这一格（与备注同口径）。
     const tt = toolTableLabel(archive.toolTablePreset);
     if (tt)
-        parts.push('工具表方案「' + tt + '」');
+        parts.push('tool-table preset "' + tt + '"');
     // 快捷提示词绑定（0.20.0）：进了这个场景会动到 `/` 菜单里哪些条目，不报就只能靠猜。
     // 空表是"进入后全部停用"，与"没绑"（这一域不碰）是两句相反的话，不能压成一个 "0 条"。
     //
@@ -94,7 +94,7 @@ function archiveText(archive) {
     // 与 `skills` / `subagents` 两段同款（那两段本来就是 `toolNameList` 印名字）。
     const qp = archive.quickPrompts;
     if (Array.isArray(qp))
-        parts.push(qp.length ? '快捷提示词 ' + toolNameList(qp) : '快捷提示词：进入后全部停用');
+        parts.push(qp.length ? 'quick prompts ' + toolNameList(qp) : 'quick prompts: all off after entering');
     return parts.join(' ｜ ');
 }
 /**
@@ -115,9 +115,9 @@ function segmentDiff(key, beforeValue, afterValue) {
     if (dropped.length)
         marks.push('-' + toolNameList(dropped));
     if (!marks.length && JSON.stringify(beforeValue ?? null) !== JSON.stringify(afterValue ?? null))
-        marks.push('勾选范围有调整');
+        marks.push('the checked set changed');
     return {
-        text: key + ' ' + b.length + ' 项 → ' + a.length + ' 项' + (marks.length ? '（' + marks.join(' ') + '）' : ''),
+        text: key + ' ' + b.length + ' -> ' + a.length + ' items' + (marks.length ? ' (' + marks.join(' ') + ')' : ''),
         dropped,
     };
 }
@@ -133,11 +133,11 @@ function agentsMdNote(sync) {
     if (!sync || typeof sync !== 'object')
         return '';
     if (sync.error)
-        return '\nWARN: 全局基线（AGENTS.md）未同步：' + String(sync.error);
+        return '\nWARN: the global baseline (AGENTS.md) was not synced: ' + String(sync.error);
     if (sync.applied)
-        return '\nAGENTS.md ← 场景绑定的预设「' + String(sync.applied) + '」';
+        return '\nAGENTS.md <- the scene-bound preset "' + String(sync.applied) + '"';
     if (sync.restored === true)
-        return '\nAGENTS.md ← 已恢复进场景前的基线';
+        return '\nAGENTS.md <- restored the pre-scene baseline';
     return '';
 }
 export function buildSceneTools(deps) {
@@ -148,15 +148,15 @@ export function buildSceneTools(deps) {
         // 这种筛选（未启用的场景照样要能被进入，藏着只会让模型以为它不存在）。
         // 描述与参数说明里**不点名同族工具**（scene_manager_list / _switch / _save 三条都在出厂
         // 默认的隐藏名单里）：静态文本没法按 toolVisible 改写，点名一条模型没有的工具只会让它
-        // 白跑一趟。要说"去哪看"就用中性说法（the scene listing / the「当前场景」reminder
+        // 白跑一趟。要说"去哪看"就用中性说法（the scene listing / the "Current scene" reminder
         // —— 后者是常驻源，只要场景域开着就在）。点名只留在**运行时回执**里、按可见性分叉。
-        description: 'List every scene with its archive (what entering it switches on: MCP servers, skills, personas, quick prompts, and the bound model tool-table scheme when there is one), bound prompt preset, memory count and enabled / entered / locked state. The scene currently entered is also shown in the「当前场景」reminder.',
+        description: 'List every scene with its archive (what entering it switches on: MCP servers, skills, personas, quick prompts, and the bound model tool-table scheme when there is one), bound prompt preset, memory count and enabled / entered / locked state. The scene currently entered is also shown in the "Current scene" reminder.',
         parameters: {},
         output: { schema: { type: 'string' }, render: (_a, v) => text(v) },
         async execute() {
             const r = await deps.rulesOps['rules-list']({});
             if (!r || r.ok === false)
-                throw new Error((r && r.error) || '读取场景失败');
+                throw new Error((r && r.error) || 'failed to read scenes');
             // 档案与「已进入哪个场景」要额外读一次（纯读盘，`scene-mode-get`）。
             // 读不到**不阻断**清单：场景行退化成只有名字与启用状态，而不是让整条工具失败 ——
             // 一份少了档案的清单仍然有用，一次失败什么都没有。
@@ -180,28 +180,28 @@ export function buildSceneTools(deps) {
             const scenes = r.scenes || [];
             const lines = scenes.map((s) => {
                 const name = String(s.name);
-                const state = [s.active === true ? '启用' : '未启用'];
+                const state = [s.active === true ? 'on' : 'off'];
                 // 「启用」与「进入」是两个独立状态轴（见 README「进/出模式」），只报前者的话，
                 // 模型会把"启用着"读成"现在就是它" —— 而记忆与提示词只按**进入**的那一个注入。
                 if (entered !== null && name === entered)
-                    state.push('已进入');
+                    state.push('entered');
                 if (s.locked === true)
-                    state.push('已锁定');
+                    state.push('locked');
                 // 打**场景名**而不是 label：`scene_manager_save` / `_switch` 要的都是名字（单个
                 // 路径段），label 只是界面显示名。两者不同时把 label 放进括号，别让模型照抄错那个。
-                const title = name + (s.label && String(s.label) !== name ? '（' + String(s.label) + '）' : '');
-                const bits = ['- ' + title + ' [' + state.join('·') + '] · 记忆 ' + Number(s.count || 0) + ' 条'];
+                const title = name + (s.label && String(s.label) !== name ? ' (' + String(s.label) + ')' : '');
+                const bits = ['- ' + title + ' [' + state.join(', ') + '] · memories: ' + Number(s.count || 0)];
                 if (s.description)
-                    bits.push('说明：' + String(s.description));
+                    bits.push('description: ' + String(s.description));
                 if (s.prompt)
-                    bits.push('预设：' + String(s.prompt));
-                bits.push('档案：' + (archives === null ? '读不到（不代表没建）' : archiveText(archives[name])));
+                    bits.push('preset: ' + String(s.prompt));
+                bits.push('archive: ' + (archives === null ? 'unreadable (does not mean absent)' : archiveText(archives[name])));
                 return bits.join(' · ');
             });
-            return '场景（' + scenes.length + ' 个 · ' +
-                (r.activeMode === 'all' ? '启用集为历史默认（全部启用）' : '启用集已收窄为单选') +
-                (entered === null ? '；当前没有进入任何场景' : '；当前已进入「' + entered + '」') + '）：\n' +
-                (lines.join('\n') || '(无场景)');
+            return 'scenes (' + scenes.length + ' · ' +
+                (r.activeMode === 'all' ? 'the enabled set is the historical default (all enabled)' : 'the enabled set is narrowed to a single scene') +
+                (entered === null ? '; no scene is entered right now' : '; currently entered: "' + entered + '"') + '):\n' +
+                (lines.join('\n') || '(no scenes)');
         },
     }));
     register(defineTool({
@@ -212,13 +212,13 @@ export function buildSceneTools(deps) {
         description: 'Enter a scene, or leave the one currently entered. Entering switches on its archive and everything else off, narrows injection to its memories, and applies its bound prompt preset to AGENTS.md. Leaving restores the runtime snapshot taken on entry. Only when the user asks or approves.',
         parameters: {
             action: { type: 'string', required: true, enum: ['enter', 'exit'], description: 'enter = switch to the scene named in `scene`; exit = leave the current one (no scene needed).' },
-            scene: { type: 'string', description: 'Scene name (one path segment), required for enter. Use the exact name, not the display label — the scene listing and the「当前场景」reminder both print names.' },
+            scene: { type: 'string', description: 'Scene name (one path segment), required for enter. Use the exact name, not the display label — the scene listing and the "Current scene" reminder both print names.' },
         },
         output: { schema: { type: 'string' }, render: (_a, v) => text(v) },
         async execute(args) {
             const action = String((args && args.action) || '');
             if (action !== 'enter' && action !== 'exit') {
-                throw new Error('action 只能是 enter / exit（收到：' + (action || '(空)') + '）');
+                throw new Error('action must be enter / exit (got: ' + (action || '(empty)') + ')');
             }
             // 刻意**不过** `lockedSceneGuard()`：场景**自身**的启停不在冻结清单里（冻结的是五个
             // 域的内容）。锁定中的场景正被进入时不能退出 —— 那条守卫在 `scene-mode-set` 的包装里
@@ -227,10 +227,10 @@ export function buildSceneTools(deps) {
             if (action === 'enter') {
                 scene = String((args && args.scene) || '').trim();
                 if (scene === '')
-                    throw new Error('action=enter 需要 scene：场景名（照抄 scene_manager_list 里那一行）');
+                    throw new Error('action=enter needs scene: the scene name (copy it from the scene_manager_list line)');
                 // 场景名是**单个路径段**（与 scene_manager_save 同一条校验、同一句报错）。
                 if (scene.indexOf('/') >= 0 || scene.indexOf('\\') >= 0) {
-                    throw new Error('场景名是单个路径段，不能含 / 或 \\：' + scene);
+                    throw new Error('a scene name is a single path segment (no / or \\): ' + scene);
                 }
             }
             // 先读一次"现在在哪个场景"：用来在回执里说清是"从 A 换到 B"还是"本来就在 B"。
@@ -247,14 +247,14 @@ export function buildSceneTools(deps) {
             // `rules-set-active` 写。少调后者，记忆与提示词仍按旧场景注入 —— 而运行时看起来已经切了。
             const mode = await deps.archiveOps['scene-mode-set']({ scene: action === 'enter' ? scene : null });
             if (!mode || mode.ok === false)
-                throw new Error((mode && mode.error) || (action === 'enter' ? '进入场景失败：' + scene : '退出场景失败'));
+                throw new Error((mode && mode.error) || (action === 'enter' ? 'failed to enter the scene: ' + scene : 'failed to exit the scene'));
             const act = await deps.sceneActivate({ scenes: action === 'enter' ? [scene] : [] });
             if (!act || act.ok === false) {
                 // 半成品状态：运行时已经切了，启用集合没跟上。**必须说出来** —— 不说的话模型以为
                 // 切完了，而记忆与提示词还是旧场景的。重试一次是安全的（两个 op 都幂等）。
-                throw new Error((action === 'enter' ? '场景「' + scene + '」的运行时已切换' : '运行时已退出场景') +
-                    '，但启用集合未写入（记忆与提示词仍按旧场景注入）：' + ((act && act.error) || '未知错误') +
-                    ' —— 重试一次 scene_manager_switch 即可（两个 op 都幂等）');
+                throw new Error((action === 'enter' ? 'runtime switched to scene "' + scene + '"' : 'runtime left the scene') +
+                    ', but the enabled set was not written (memories and prompts still inject per the old scene): ' + ((act && act.error) || 'unknown error') +
+                    ' — retry scene_manager_switch once (both ops are idempotent)');
             }
             // 回执：说清"从哪到哪 + 实际切了几台 / 几个来源 + 工具表换到哪一份 + 有没有键被丢弃 + AGENTS.md 那一步"。
             // 都是界面会如实报的同一批事实（`memory.result.modeSet` / `modeSwitched` / `archive.stale`），
@@ -268,10 +268,10 @@ export function buildSceneTools(deps) {
                 ? (mode.applied === null || mode.applied === undefined)
                 : !mode.restored;
             const head = noop
-                ? (action === 'enter' ? 'OK: already in scene「' + scene + '」' : 'OK: not in any scene (nothing to leave)')
+                ? (action === 'enter' ? 'OK: already in scene "' + scene + '"' : 'OK: not in any scene (nothing to leave)')
                 : action === 'enter'
-                    ? 'OK: ' + (before === null ? 'entered' : '「' + before + '」→') + ' scene「' + scene + '」'
-                    : 'OK: left the scene「' + (before || '') + '」';
+                    ? 'OK: ' + (before === null ? 'entered' : 'left "' + before + '", entered ') + 'scene "' + scene + '"'
+                    : 'OK: left the scene "' + (before || '') + '"';
             const parts = [];
             if (count(sw.mcpServers) || count(sw.skillSources)) {
                 parts.push('switched ' + count(sw.mcpServers) + ' MCP server(s) / ' + count(sw.skillSources) + ' skill source(s)');
@@ -280,16 +280,16 @@ export function buildSceneTools(deps) {
             // 原因，用户问"刚才改了什么"时拿回去的就是半截话。引擎只在**名单真的换了**时才回方案名。
             const tt = toolTableLabel(mode && mode.toolTablePreset);
             if (tt) {
-                parts.push('工具表切到方案「' + tt + '」（关 ' + count(sw.toolTableHidden) + ' 条）');
+                parts.push('tool table switched to preset "' + tt + '" (' + count(sw.toolTableHidden) + ' hidden)');
             }
             else if (action === 'exit' && mode.restored && mode.restored.toolTable === true) {
-                parts.push('工具表按进场景前的快照还原');
+                parts.push('tool table restored from the pre-scene snapshot');
             }
             if (Array.isArray(mode.stale) && mode.stale.length) {
-                parts.push('丢弃了本机不存在的键：' + mode.stale.join('、'));
+                parts.push('dropped keys this machine does not have: ' + mode.stale.join(', '));
             }
             return head + (parts.length ? ' · ' + parts.join(' · ') : '') + agentsMdNote(act.agentsMd) +
-                (noop ? '\n（' + (action === 'enter' ? '目标就是当前场景' : '本来就不在任何场景') + '，运行时没有改动）' : '');
+                (noop ? '\n(' + (action === 'enter' ? 'already in the target scene' : 'already outside every scene') + ' — runtime unchanged)' : '');
         },
     }));
     register(defineTool({
@@ -301,7 +301,7 @@ export function buildSceneTools(deps) {
         parameters: {
             scene: { type: 'string', required: true, description: 'Scene name (one path segment, ≤64 chars, no / \\ or < > : " | ? *, not `_shared`). Created if absent.' },
             label: { type: 'string', description: 'Display name for this scene. Omit = keep.' },
-            description: { type: 'string', description: 'What this scene is for; shown beside the scene name in the「当前场景」reminder while the scene is on — write an instruction, not a note. Omit = keep.' },
+            description: { type: 'string', description: 'What this scene is for; shown beside the scene name in the "Current scene" reminder while the scene is on — write an instruction, not a note. Omit = keep.' },
             // 与下面 `mcp` / `skills` / `subagents` 同一句式（"Omit = keep; X = 一个都不"）：
             // 界面 2026-10-10 补了「无」这个选项，工具侧的空串语义要跟着说清，否则模型只知道
             // 「省略 = 保持」，不知道还有一条「解绑」的路。
@@ -344,12 +344,12 @@ export function buildSceneTools(deps) {
                 throw new Error(blocked);
             const scene = String((args && args.scene) || '').trim();
             if (scene === '')
-                throw new Error('缺少参数：scene 是场景名');
+                throw new Error('missing argument: scene (the scene name)');
             // 场景名是**单个路径段**（界面把场景当一级列表展示，场景名就是 `memories/<场景>/` 那级
             // 目录名）。`rules-create-scene` 会做完整校验，但档案那条路不经过它 —— 这里先挡一次，
             // 报错也更贴模型要的东西（它要的是"这个名字不行"，不是内部规则）。
             if (scene.indexOf('/') >= 0 || scene.indexOf('\\') >= 0) {
-                throw new Error('场景名是单个路径段，不能含 / 或 \\：' + scene);
+                throw new Error('a scene name is a single path segment (no / or \\): ' + scene);
             }
             // ① 场景记录：`rules-create-scene` 本身是**幂等 upsert**（已存在则更新描述/标签/绑定的
             //    预设，不报错），所以不必先查再分建/改 —— 与记忆 save 的"有则改、无则建"同一口径。
@@ -371,7 +371,7 @@ export function buildSceneTools(deps) {
             }
             const created = await deps.rulesOps['rules-create-scene'](payload);
             if (!created || created.ok === false)
-                throw new Error((created && created.error) || '保存场景失败');
+                throw new Error((created && created.error) || 'failed to save the scene');
             // ② 两处「解绑」只能走 `rules-update-scene`：`scene-archive-save` 对载荷里**不带的栏**
             //    一律保留现值（archive-engine 的「不带 ≠ 解绑」），从现值复制出来的合并档案会把
             //    刚解掉的绑定又写回去 —— 所以解绑与设置分成两条路，合并前还要先摘掉刚解掉的键。
@@ -383,7 +383,7 @@ export function buildSceneTools(deps) {
             const setToolTable = args.toolTablePreset !== undefined && String(args.toolTablePreset).trim() !== '';
             const setQuickPrompts = args.quickPrompts !== undefined;
             if (setQuickPrompts && !Array.isArray(args.quickPrompts)) {
-                throw new Error('quickPrompts 必须是 id 数组（[] = 进入后全部停用；解绑需用户手动操作，本工具不提供）');
+                throw new Error('quickPrompts must be an array of ids ([] = turn them all off on entry; unbinding is a manual step in the panel, not offered here)');
             }
             const touched = ARCHIVE_SECTIONS.filter((k) => args[k] !== undefined);
             const mustWriteArchive = touched.length > 0 || setToolTable || setQuickPrompts;
@@ -396,7 +396,7 @@ export function buildSceneTools(deps) {
                 const cur = await deps.archiveOps['scene-mode-get']({});
                 if (!cur || cur.ok === false) {
                     if (mustWriteArchive)
-                        throw new Error((cur && cur.error) || '读取场景档案失败');
+                        throw new Error((cur && cur.error) || 'failed to read the scene archive');
                 }
                 else {
                     before = (cur.archives || {})[scene] || {};
@@ -413,7 +413,7 @@ export function buildSceneTools(deps) {
                 const u = await deps.rulesOps['rules-update-scene'](upd);
                 if (!u || u.ok === false) {
                     // 主路径已成功、解绑没写上：如实报，别让回执假装绑定已经没了。
-                    clearWarn = '\nWARN: 解绑未写入（' + ((u && u.error) || '未知错误') + '），旧绑定仍然有效';
+                    clearWarn = '\nWARN: the unbind was not written (' + ((u && u.error) || 'unknown error') + '); the old binding still applies';
                 }
             }
             // ③ 档案 read-modify-write：段（mcp / mcpNotes / skills / subagents）与两个绑定栏的
@@ -440,32 +440,32 @@ export function buildSceneTools(deps) {
                     archive.quickPrompts = quickPromptIds(args.quickPrompts);
                 const r = await deps.archiveOps['scene-archive-save']({ scene, archive });
                 if (!r || r.ok === false)
-                    throw new Error((r && r.error) || '保存场景档案失败');
+                    throw new Error((r && r.error) || 'failed to save the scene archive');
                 // 回执必须回显**这一次替换挤掉了什么**。整段替换本身是对的（省略的段不填回就会被
                 // 静默清掉，所以"模型给什么就是什么"），但"给出去的段盖掉了原来的勾选"是**静默**的
                 // —— 不写出来，模型只会看到一句"档案段：mcp"，以为只是加了一项。
                 const diffs = touched.map((k) => segmentDiff(k, before[k], args[k]));
                 if (diffs.length) {
-                    archiveNote = '档案段：' + diffs.map((d) => d.text).join('；');
+                    archiveNote = 'archive segments: ' + diffs.map((d) => d.text).join('; ');
                     if (diffs.some((d) => d.dropped.length > 0)) {
-                        warnTail += '\n注意：这些段是整段替换，上面标 - 的项已被挤掉；要保留就把它们一并写进这次调用。';
+                        warnTail += '\nnote: these segments are replaced as a whole; entries marked "-" above were dropped. To keep them, include them in this same call.';
                     }
                 }
                 // 当前环境里不存在的键会被 op 丢弃并报告（改名或删除留下的，含工具表方案名与
                 // 快捷提示词 id）：如实说，否则模型以为勾上了而实际没有。
                 if (r.stale && r.stale.length)
-                    warnTail += '\n（丢弃了当前环境不存在的键：' + r.stale.join('、') + '）';
+                    warnTail += '\n(dropped keys the current environment does not have: ' + r.stale.join(', ') + ')';
                 // 存盘成功但应用到运行时失败：`scene-archive-save` 对"正是当前模式的那个场景"会就地
                 // 重应用，失败不回滚档案。如实报出去，别假装生效了（与界面同口径）。
                 if (r.applyError)
-                    warnTail += '\n（已存盘，但应用到运行时失败：' + r.applyError + '）';
+                    warnTail += '\n(saved, but applying it to the runtime failed: ' + r.applyError + ')';
             }
             // 解绑写失败了就别输出「X → 解绑」—— 上面那句 WARN 才是事实；设置方向不受 ② 影响。
             if (args.toolTablePreset !== undefined && !(unbindToolTable && clearWarn !== '')) {
                 toolTableNote = beforeKnown
-                    ? '工具表方案：' + (toolTableLabel(before.toolTablePreset) || '未绑') + ' → ' +
-                        (unbindToolTable ? '解绑' : toolTableLabel(String(args.toolTablePreset).trim()))
-                    : '工具表方案：已解绑（档案现状读不到，无法对比）';
+                    ? 'tool-table preset: ' + (toolTableLabel(before.toolTablePreset) || 'unbound') + ' -> ' +
+                        (unbindToolTable ? 'unbind' : toolTableLabel(String(args.toolTablePreset).trim()))
+                    : 'tool-table preset: unbound (the current archive is unreadable, no diff available)';
             }
             if (setQuickPrompts && beforeKnown) {
                 const beforeIds = Array.isArray(before.quickPrompts) ? before.quickPrompts.map((x) => String(x)) : [];
@@ -477,15 +477,15 @@ export function buildSceneTools(deps) {
                     marks.push('+' + toolNameList(added));
                 if (dropped.length)
                     marks.push('-' + toolNameList(dropped));
-                quickNote = '快捷提示词：' + beforeIds.length + ' 条 → ' + afterIds.length + ' 条' +
-                    (afterIds.length === 0 ? '（进入后全部停用）' : '') +
-                    (marks.length ? '（' + marks.join(' ') + '）' : '');
+                quickNote = 'quick prompts: ' + beforeIds.length + ' -> ' + afterIds.length + ' ids' +
+                    (afterIds.length === 0 ? ' (all off after entering)' : '') +
+                    (marks.length ? ' (' + marks.join(' ') + ')' : '');
             }
             // 收敛提示：`rules-create-scene` 在"历史默认（全部启用）"状态下会把启用集合收窄成
             // 单选（`collapseActiveForNewScene`）—— 那是一次**会改变运行时**的动作，必须说出来。
             // 界面上同样如实报（`scenes.result.created.collapsed`）。
             const collapsed = created.collapsedActive === true;
-            const parts = [touchedRecord.length ? '场景记录已更新（' + touchedRecord.join('、') + '）' : '场景已确保存在'];
+            const parts = [touchedRecord.length ? 'scene record updated (' + touchedRecord.join(', ') + ')' : 'scene existence ensured'];
             if (archiveNote)
                 parts.push(archiveNote);
             if (toolTableNote)
@@ -496,13 +496,13 @@ export function buildSceneTools(deps) {
             // 部分启用（开 save 不开 switch）时指向一条模型没有的工具，只会让它白跑一趟 ——
             // 与 mcp/skill 的 listHint 同一条纪律。
             const enterHint = deps.toolVisible('scene_manager_switch')
-                ? '要让它生效，用 scene_manager_switch 进入。'
-                : '要让它生效，需用户手动进入该场景（本会话未开放 scene_manager_switch）。';
-            return 'OK: scene「' + scene + '」' + parts.join('；') + warnTail + clearWarn +
+                ? 'To take effect, enter it with scene_manager_switch.'
+                : 'To take effect, the user has to enter this scene manually (scene_manager_switch is not available in this session).';
+            return 'OK: scene "' + scene + '"' + parts.join('; ') + warnTail + clearWarn +
                 (collapsed
-                    ? '\n注意：此前所有场景都处于启用状态（历史「全部启用」默认），本次已收窄为只启用一个，新建的这个不在其中 —— 需用户确认启用状态。'
+                    ? '\nnote: every scene was enabled until now (the historical all-enabled default); this call narrowed the enabled set to one scene, and the new one is not it — the user should confirm the enabled state.'
                     : '') +
-                '\n保存不改运行时：' + enterHint;
+                '\nSaving does not change the runtime: ' + enterHint;
         },
     }));
 }