dsh-plugin-tool-management 0.19.1 → 0.20.1

package/lib/tools/remove.js

@@ -0,0 +1,206 @@
+// 删除 / 回收站族的 model 工具（2026-10-15）：五个域各一条 `*_manager_remove`。
+//
+// 为什么单开一族：此前模型**只能停用、不能删除** —— "把这条过时的记忆删掉"这类要求手里
+// 没有出口，模型会去调 `*_switch(enabled:false)` 然后回一句"已停用"，用户以为删了。面板上
+// 每个域都有删除，模型侧一条都没有。
+//
+// 三条纪律：
+//   · **删除一律进回收站**（可恢复），与面板同一条路 —— 回执如实说"可恢复"。
+//   · **不做 purge**（永久删除）：低频且不可恢复，用户裁定"使用频率低的可以不要，
+//     太多功能反而冗余" —— 清空回收站留给面板。
+//   · `list` 是只读（不进场景冻结守卫，与 `trash-preview` 只读口径一致）；`trash` /
+//     `restore` 是写，过 `lockedSceneGuard()`。
+//
+// 参数名统一 `id`：`trash` 时是资源标识（记忆 `<场景>/<名>`、技能名、人设名、预设 id、
+// 场景名），`restore` 时是 `action=list` 给出的**回收站条目 id** —— 两种含义在描述里写清。
+import { locateSkillRoot, text } from './deps.js';
+/** 三个动词共用的描述骨架。 */
+function removeDescription(noun) {
+    return 'Delete one ' + noun + ' (moves it to the trash), restore one from the trash, or list the trash. '
+        + 'Nothing here is permanent — emptying the trash is a panel action. '
+        + 'Blocked while the active scene is locked. Only on the user\'s instruction.';
+}
+/** `action` 参数：三个动词 + 每个动词要哪个 `id`。 */
+const ACTION_DESC = 'trash = delete the item named in `id` (moves it to the trash); restore = put back the trash entry `id` (get its id from action=list); list = list the trash (no `id`).';
+/**
+ * 恢复 op 回传的**最终落盘名**。五个域把名字放在不同字段上：
+ *   · 记忆 / 技能 / 人设 / 场景 → `name`（退号恢复时它是新名字，不是回收站里的原名）
+ *   · 提示词预设               → `id`（预设的 id 就是它的名字）
+ * 记忆还会把投影对象放在 `rule.id` 上，作为第三顺位兜底。
+ *
+ * 还要解一层 `data`（2026-10-15 复核 P1-6 时漏掉的那半）：技能的 op 表外面包了
+ * `wrap`（`skills/service.ts:239` —— `{ ok: true, data: result }`），名字在 `r.data.name`，
+ * 不在 `r.name` 上。其余四个域的 op 是扁平返回。两边都要看，否则技能域的回执仍会退回 trashId。
+ */
+function restoredName(r) {
+    const pick = (o) => {
+        if (!o || typeof o !== 'object')
+            return '';
+        if (typeof o.name === 'string' && o.name !== '')
+            return o.name;
+        if (o.rule && typeof o.rule.id === 'string' && o.rule.id !== '')
+            return o.rule.id;
+        if (typeof o.id === 'string' && o.id !== '')
+            return o.id;
+        return '';
+    };
+    return pick(r) || pick(r && r.data);
+}
+/** 一条删除工具的 execute：三个动词的分派与回执。 */
+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 || '(空)') + '）');
+    }
+    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')
+            : '回收站是空的。';
+    }
+    // 进 / 出回收站都是写：过场景冻结守卫（与面板的删除按钮同一档）。
+    const blocked = await deps.lockedSceneGuard();
+    if (blocked)
+        throw new Error(blocked);
+    const id = String((args && args.id) || '').trim();
+    if (id === '')
+        throw new Error('缺少参数：id（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' ? '移入回收站失败' : '恢复失败'));
+    if (action === 'trash') {
+        return 'OK: ' + cfg.label + '「' + id + '」已移入回收站（可恢复；永久删除在面板的回收站里）';
+    }
+    // 恢复的回执要说**恢复成了什么**，而不是回收站条目 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 + '）');
+}
+export function buildRemoveTools(deps) {
+    const { defineTool, register } = deps;
+    const mem = deps.memoryOps;
+    const sk = deps.skillOps;
+    const sub = deps.subagentOps;
+    const pr = deps.promptOps;
+    const sc = deps.sceneOps;
+    const memoryCfg = {
+        noun: 'memory', label: '记忆',
+        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) || '读取回收站失败');
+            return (r.entries || []).map((e) => ({ id: String(e.trashId), name: String(e.name), deletedAt: e.deletedAt }));
+        },
+    };
+    const skillCfg = {
+        noun: 'skill', label: '技能',
+        // 与 `skill_manager_switch` 同一条（smoke-test P0-1）：不给 root 就按名字在全部来源里
+        // 找胜出的那一份。默认值原本是 dsh，而 `skill_manager_save` 落 hub —— 「建完就删」
+        // 必然报「技能不存在」。删一个真的不存在的技能时退回 dsh，交给 op 报它自己的错。
+        trash: async (a) => {
+            const name = String((a && a.id) || '');
+            const explicit = String((a && a.root) || '').trim();
+            const root = explicit !== '' ? explicit : ((await locateSkillRoot(sk, name)).root || 'dsh');
+            return sk['skill-delete']({ root, name });
+        },
+        restore: (a) => sk['skill-trash-restore']({ id: String(a.id || '') }),
+        // 技能没有独立的回收站列表 op：它挂在 `skill-state` 的 `data.trash` 上（界面同一条来源）。
+        list: async () => {
+            const r = await sk['skill-state']({});
+            if (!r || r.ok === false)
+                throw new Error((r && r.error) || 'skill-state failed');
+            return ((r.data && r.data.trash) || []).map((e) => ({ id: String(e.id), name: String(e.name), deletedAt: e.deletedAt }));
+        },
+    };
+    const subagentCfg = {
+        noun: 'persona', label: '人设',
+        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) || '读取回收站失败');
+            return (r.trash || []).map((e) => ({ id: String(e.id), name: String(e.name), deletedAt: e.deletedAt }));
+        },
+    };
+    const promptCfg = {
+        noun: 'preset', label: '提示词预设',
+        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) || '读取回收站失败');
+            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: '场景',
+        // 删场景走 handlers 里那份（`withAgentsMdSync` 包过）：直调 `memoriesService.ops` 会漏掉
+        // 「场景绑的预设曾写进 AGENTS.md，删了要跟着处理」那一步。
+        trash: (a) => deps.sceneRemove({ name: String(a.id || '') }),
+        restore: (a) => sc['scene-trash-restore']({ id: String(a.id || '') }),
+        list: async () => {
+            const r = await sc['scene-trash-list']({});
+            if (!r || r.ok === false)
+                throw new Error((r && r.error) || '读取回收站失败');
+            return (r.trash || []).map((e) => ({ id: String(e.id), name: String(e.name), deletedAt: e.deletedAt }));
+        },
+    };
+    register(defineTool({
+        name: 'memory_manager_remove',
+        description: removeDescription('memory'),
+        parameters: {
+            action: { type: 'string', required: true, enum: ['trash', 'restore', 'list'], description: ACTION_DESC },
+            id: { type: 'string', description: 'For trash: the memory id `<scene>/<name>`. For restore: the trash entry id from action=list. Not needed for list.' },
+        },
+        output: { schema: { type: 'string' }, render: (_a, v) => text(String(v)) },
+        async execute(args) { return runRemove(deps, memoryCfg, args); },
+    }));
+    register(defineTool({
+        name: 'skill_manager_remove',
+        description: removeDescription('skill'),
+        parameters: {
+            action: { type: 'string', required: true, enum: ['trash', 'restore', 'list'], description: ACTION_DESC },
+            id: { type: 'string', description: 'For trash: the skill name. For restore: the trash entry id from action=list. Not needed for list.' },
+            root: { type: 'string', description: 'Source root the skill lives in. Default: whichever source holds that skill; only used by action=trash.' },
+        },
+        output: { schema: { type: 'string' }, render: (_a, v) => text(String(v)) },
+        async execute(args) { return runRemove(deps, skillCfg, args); },
+    }));
+    register(defineTool({
+        name: 'subagent_manager_remove',
+        description: removeDescription('persona'),
+        parameters: {
+            action: { type: 'string', required: true, enum: ['trash', 'restore', 'list'], description: ACTION_DESC },
+            id: { type: 'string', description: 'For trash: the persona name. For restore: the trash entry id from action=list. Not needed for list.' },
+        },
+        output: { schema: { type: 'string' }, render: (_a, v) => text(String(v)) },
+        async execute(args) { return runRemove(deps, subagentCfg, args); },
+    }));
+    register(defineTool({
+        name: 'prompt_manager_remove',
+        description: removeDescription('AGENTS.md preset'),
+        parameters: {
+            action: { type: 'string', required: true, enum: ['trash', 'restore', 'list'], description: ACTION_DESC },
+            id: { type: 'string', description: 'For trash: the preset id. For restore: the trash entry id from action=list. Not needed for list.' },
+        },
+        output: { schema: { type: 'string' }, render: (_a, v) => text(String(v)) },
+        async execute(args) { return runRemove(deps, promptCfg, args); },
+    }));
+    register(defineTool({
+        name: 'scene_manager_remove',
+        description: removeDescription('scene'),
+        parameters: {
+            action: { type: 'string', required: true, enum: ['trash', 'restore', 'list'], description: ACTION_DESC },
+            id: { type: 'string', description: 'For trash: the scene name. For restore: the trash entry id from action=list. Not needed for list.' },
+        },
+        output: { schema: { type: 'string' }, render: (_a, v) => text(String(v)) },
+        async execute(args) { return runRemove(deps, sceneCfg, args); },
+    }));
+}

package/lib/tools/scene.js

@@ -26,8 +26,9 @@
 // 不因为多了一条工具就破例（工具描述本来就是写"什么时候该用它"的地方）。
 import { text, toolNameList } from './deps.js';
 import { FACTORY_TOOL_TABLE_PRESET } from './table.js';
-/** 档案里由模型设置的三个段（`memories` 段在 P5 已废弃，不再是档案的一部分）。 */
-const ARCHIVE_SECTIONS = ['mcp', 'skills', 'subagents'];
+/** 档案里由模型设置的段（`memories` 段在 P5 已废弃，不再是档案的一部分）。
+ *  `mcpNotes`（0.20.0）与其余三段同族：整段替换、段缺席 = 不碰这一域。 */
+const ARCHIVE_SECTIONS = ['mcp', 'mcpNotes', 'skills', 'subagents'];
 /** 段里的名单：数组段是名字列表，`mcp` 段是 serverName → `'*'` | 工具名数组。段缺席 = 空。 */
 function segmentNames(value) {
     if (Array.isArray(value))
@@ -36,6 +37,21 @@ function segmentNames(value) {
         return Object.keys(value);
     return [];
 }
+/**
+ * `quickPrompts` 入参 → 档案值：去空、去重、保序（与 op 侧 `quickPromptsArg` 同一口径）。
+ *
+ * ⚠️ 空数组是**合法值**（= 进入后全部停用），不能在这里被当成"没给"滤掉 —— 它与
+ * "这一域不碰"（段缺席）是两句相反的话（见 `SceneArchive.quickPrompts` 的注释）。
+ */
+function quickPromptIds(value) {
+    const out = [];
+    for (const item of Array.isArray(value) ? value : []) {
+        const id = String(item == null ? '' : item).trim();
+        if (id && out.indexOf(id) < 0)
+            out.push(id);
+    }
+    return out;
+}
 /**
  * 档案里绑的工具表方案 → 给人读的那一句。`factory-default` 是个哨兵值而不是本机存过的方案，
  * 原样打出来模型会去找一份叫这个名字的方案（`_save` 那边也没有这一栏，它改不了）。
@@ -69,6 +85,16 @@ function archiveText(archive) {
     const tt = toolTableLabel(archive.toolTablePreset);
     if (tt)
         parts.push('工具表方案「' + tt + '」');
+    // 快捷提示词绑定（0.20.0）：进了这个场景会动到 `/` 菜单里哪些条目，不报就只能靠猜。
+    // 空表是"进入后全部停用"，与"没绑"（这一域不碰）是两句相反的话，不能压成一个 "0 条"。
+    //
+    // 印 **id 而不是条数**（2026-10-15）：`scene_manager_save.quickPrompts` 的描述让模型
+    // "copy them from a scene binding in the listing" —— 而此前这里只印「N 条」，清单里根本
+    // 没有 id 可抄，那句是一条**指不到的死路**（模型照做只会白跑一趟，然后去问用户）。
+    // 与 `skills` / `subagents` 两段同款（那两段本来就是 `toolNameList` 印名字）。
+    const qp = archive.quickPrompts;
+    if (Array.isArray(qp))
+        parts.push(qp.length ? '快捷提示词 ' + toolNameList(qp) : '快捷提示词：进入后全部停用');
     return parts.join(' ｜ ');
 }
 /**
@@ -122,16 +148,16 @@ export function buildSceneTools(deps) {
         // 这种筛选（未启用的场景照样要能被进入，藏着只会让模型以为它不存在）。
         // 描述与参数说明里**不点名同族工具**（scene_manager_list / _switch / _save 三条都在出厂
         // 默认的隐藏名单里）：静态文本没法按 toolVisible 改写，点名一条模型没有的工具只会让它
-        // 白跑一趟。要说"去哪看"就用中性说法（the scene listing / the「本机当前的场景」reminder
+        // 白跑一趟。要说"去哪看"就用中性说法（the scene listing / the「当前场景」reminder
         // —— 后者是常驻源，只要场景域开着就在）。点名只留在**运行时回执**里、按可见性分叉。
-        description: 'List every scene with its archive (what entering it switches on: MCP servers, skills, personas, and the bound model tool-table scheme when there is one), bound prompt preset, memory count and enabled / entered / locked state. Read the archive here before saving a scene: a section you give later replaces it whole. Read-only; the scene in effect now is also 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「当前场景」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) || '读取场景失败');
-            // 档案与「当前进入的是哪个」要额外读一次（纯读盘，`scene-mode-get`）。
+            // 档案与「已进入哪个场景」要额外读一次（纯读盘，`scene-mode-get`）。
             // 读不到**不阻断**清单：场景行退化成只有名字与启用状态，而不是让整条工具失败 ——
             // 一份少了档案的清单仍然有用，一次失败什么都没有。
             // `archives = null` 是"没读到"，与"读到了但某个场景没建档案"是两件事：混成一份会让
@@ -183,10 +209,10 @@ export function buildSceneTools(deps) {
         // 为什么 `action` 是必填枚举而不是一个布尔：与 `mcp_manager_switch` 同一条理由 ——
         // 让模型在 enter / exit 两个动词里选一个，比让它猜"scene 传 null 是什么意思"省一次往返。
         // 参数里刻意不出现 `null`：那是 op（`scene-mode-set`）的形态，模型照着填只会填错。
-        description: 'Enter a scene, or leave the one currently entered. Entering switches on exactly what its archive lists and everything else off — MCP servers, skills, personas, and the model tool table when the scene binds a scheme — narrows injection to its memories, and applies its bound prompt preset to AGENTS.md. Leaving restores the runtime snapshot taken on entry. Check the scene\'s archive in the scene listing before entering. Only when the user asks or approves.',
+        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「当前场景」reminder both print names.' },
         },
         output: { schema: { type: 'string' }, render: (_a, v) => text(v) },
         async execute(args) {
@@ -271,15 +297,27 @@ export function buildSceneTools(deps) {
         // 「写入指引」保留（"写成指令而不是备注"—— 这是场景说明质量的杠杆），但不再声称
         // "注入后模型会被要求照办"：2026-09-23 定稿把场景段的授权语删了（注入只陈述现状），
         // 参数说明与注入侧各说各话时，模型信的那份是错的。改为如实说明去向。
-        description: 'Save a scene — a named bundle the user enters: entering it switches on exactly what its archive lists and everything else off. Creates it if absent, else updates it. An archive section you give replaces that section whole — include what should stay; the receipt reports what got displaced. Saving does not enter it; entering is a separate action. Only on the user\'s instruction.',
+        description: 'Save a scene — a named bundle the user enters: entering it switches on exactly what its archive lists (MCP servers, scene-level MCP note overrides, skills, personas, quick prompts, and the model tool table when a scheme is bound) and everything else off. Creates it if absent, else updates it. An archive section you give replaces that section whole — include what should stay; the receipt reports what got displaced. Saving does not enter it; entering is a separate action. Only on the user\'s instruction.',
         parameters: {
-            scene: { type: 'string', required: true, description: 'Scene name (one path segment, no slashes). Created if absent.' },
-            label: { type: 'string', description: 'Display name shown in the UI. 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.' },
+            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.' },
             // 与下面 `mcp` / `skills` / `subagents` 同一句式（"Omit = keep; X = 一个都不"）：
             // 界面 2026-10-10 补了「无」这个选项，工具侧的空串语义要跟着说清，否则模型只知道
             // 「省略 = 保持」，不知道还有一条「解绑」的路。
             prompt: { type: 'string', description: 'Prompt preset id to bind; while this scene is on it is the global baseline. Omit = keep; \'\' = bind none (this scene leaves AGENTS.md alone).' },
+            // 模型工具表方案绑定（0.20.0 补上模型侧入口：0.15.0 起界面可绑、档案里一直有这一栏，
+            // `_list` / `_switch` 也读它，唯独 `_save` 写不了）。'' = 解绑只能走
+            // `rules-update-scene` —— `scene-archive-save` 对载荷里**不带的栏**一律保留现值
+            // （archive-engine 的「不带 ≠ 解绑」），所以解绑与设置分成两条路，见 execute 的 ②。
+            // 哨兵 `factory-default` 与界面下拉同值（tools/table.ts 的 FACTORY_TOOL_TABLE_PRESET）；
+            // 不存在的方案名由引擎按 stale 丢弃并在进入时报告，op 不硬拒（与悬空绑定同口径）。
+            toolTablePreset: { type: 'string', description: "Model tool-table scheme to bind while this scene is on. Omit = keep; '' = unbind (the scene leaves the tool table alone); 'factory-default' = the factory default; otherwise the name of a scheme saved in the panel. An unknown name is dropped and reported." },
+            // 快捷提示词绑定（0.20.0）。段语义与上面三个档案段相反：**空数组是合法值**
+            // （进入后全部停用），不是"清除这一段"。本工具不提供解绑（界面可解）—— 与
+            // mcp / skills / subagents 三段没有解绑参数同一条口径。id 从场景清单里别的场景的
+            // 绑定、或用户口述里来；不存在的 id 被引擎丢弃并在回执报出来。
+            quickPrompts: { type: 'array', items: { type: 'string' }, description: 'Quick-prompt ids to switch on when this scene is entered; every other one is switched off, and the pre-entry state is restored on exit. Omit = keep; [] = switch all off on entry. Unknown ids are dropped and reported — copy them from a scene binding in the listing, or ask the user.' },
             mcp: {
                 type: 'object',
                 // 官方要求对象类型**显式声明开放性**（`additionalProperties` 是必需字段，且只能是
@@ -288,6 +326,14 @@ export function buildSceneTools(deps) {
                 additionalProperties: true,
                 description: "Archive: serverName -> '*' (whole server) or a list of tool names to leave on. Omit = keep; {} = switch none on.",
             },
+            // 场景级 MCP 备注覆盖（0.20.0）：进入这个场景时用这份盖掉全局备注，退出时还原。
+            // 与 mcp 段同一句式（省略 = 保持；{} = 一个都不覆盖）—— 界面存档编辑器早就能改，
+            // `_list` 也显示它，`_save` 此前不接这一段。
+            mcpNotes: {
+                type: 'object',
+                additionalProperties: true,
+                description: "Archive: serverName -> note that overrides that server's global note while this scene is on (the global note comes back on exit). Omit = keep; {} = drop every scene-level override.",
+            },
             skills: { type: 'array', items: { type: 'string' }, description: 'Archive: skill keys `<root>/<name>` to switch on. Omit = keep; [] = switch none on.' },
             subagents: { type: 'array', items: { type: 'string' }, description: 'Archive: persona names to switch on. Omit = keep; [] = switch none on.' },
         },
@@ -326,22 +372,72 @@ export function buildSceneTools(deps) {
             const created = await deps.rulesOps['rules-create-scene'](payload);
             if (!created || created.ok === false)
                 throw new Error((created && created.error) || '保存场景失败');
-            // ② 档案三段。**必须 read-modify-write**：`scene-archive-save` 是**整份替换**
-            //    （`slice.archives[scene] = archive`），只把模型给的段传过去，没给的段会被静默
-            //    清掉 —— 与 0.14.0 里 `subagent_manager_save` 省略字段被清空同一形状，只是这次
-            //    清掉的是"这个场景进入时要开哪些东西"。
-            //    注意档案的段语义：**段不存在 = 不限制（全部照常）**，段存在但为空 = 全部停用。
-            //    所以模型给 `mcp: {}` 得到的是"全不勾"，不是"清除该段" —— 后者只能靠不给。
+            // ② 两处「解绑」只能走 `rules-update-scene`：`scene-archive-save` 对载荷里**不带的栏**
+            //    一律保留现值（archive-engine 的「不带 ≠ 解绑」），从现值复制出来的合并档案会把
+            //    刚解掉的绑定又写回去 —— 所以解绑与设置分成两条路，合并前还要先摘掉刚解掉的键。
+            //    · `prompt` 的 '' 此前也走不到实处 —— `rules-create-scene` 的 upsert 分支把空串
+            //      当"没给"（ops/scene-records.ts），旧绑定原样保留而回执报"已更新"。
+            //    · `toolTablePreset` 的 '' 同解（那个 op 的更新分支认空串 = 解绑）。
+            const clearPrompt = args.prompt !== undefined && String(args.prompt).trim() === '';
+            const unbindToolTable = args.toolTablePreset !== undefined && String(args.toolTablePreset).trim() === '';
+            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 数组（[] = 进入后全部停用；解绑需用户手动操作，本工具不提供）');
+            }
             const touched = ARCHIVE_SECTIONS.filter((k) => args[k] !== undefined);
-            let archiveNote = '';
-            if (touched.length) {
+            const mustWriteArchive = touched.length > 0 || setToolTable || setQuickPrompts;
+            // 档案现状在读的时候就取一次，且必须在 ② **之前** —— 解绑落盘后这一栏已经没了，
+            // 回执的「X → 解绑」要的是解绑前的那个 X。只为看回执的 diff 而读时（解绑且不写档案）
+            // 容忍读失败：那一步已经写成功了，别为一句对比话把整次调用判失败。
+            let before = {};
+            let beforeKnown = false;
+            if (mustWriteArchive || unbindToolTable) {
                 const cur = await deps.archiveOps['scene-mode-get']({});
-                if (!cur || cur.ok === false)
-                    throw new Error((cur && cur.error) || '读取场景档案失败');
-                const before = (cur.archives || {})[scene] || {};
+                if (!cur || cur.ok === false) {
+                    if (mustWriteArchive)
+                        throw new Error((cur && cur.error) || '读取场景档案失败');
+                }
+                else {
+                    before = (cur.archives || {})[scene] || {};
+                    beforeKnown = true;
+                }
+            }
+            let clearWarn = '';
+            if (clearPrompt || unbindToolTable) {
+                const upd = { name: scene };
+                if (clearPrompt)
+                    upd.prompt = '';
+                if (unbindToolTable)
+                    upd.toolTablePreset = '';
+                const u = await deps.rulesOps['rules-update-scene'](upd);
+                if (!u || u.ok === false) {
+                    // 主路径已成功、解绑没写上：如实报，别让回执假装绑定已经没了。
+                    clearWarn = '\nWARN: 解绑未写入（' + ((u && u.error) || '未知错误') + '），旧绑定仍然有效';
+                }
+            }
+            // ③ 档案 read-modify-write：段（mcp / mcpNotes / skills / subagents）与两个绑定栏的
+            //    「设置」方向合并成一份，只经 `scene-archive-save` 一条路落盘。
+            //    **必须 read-modify-write**：`scene-archive-save` 是**整份替换**，只把模型给的段
+            //    传过去，没给的段会被静默清掉 —— 与 0.14.0 里 `subagent_manager_save` 省略字段被
+            //    清空同一形状，只是这次清掉的是"这个场景进入时要开哪些东西"。
+            //    注意段语义：**段不存在 = 不限制（全部照常）**，段存在但为空 = 全部停用。所以模型给
+            //    `mcp: {}` 得到的是"全不勾"，不是"清除该段" —— 后者只能靠不给。
+            //    `quickPrompts` 与三段都不同：段缺席 = 这一域不碰，空数组 = 进入后全部停用。
+            let archiveNote = '';
+            let toolTableNote = '';
+            let quickNote = '';
+            let warnTail = '';
+            if (mustWriteArchive) {
                 const archive = { ...before };
                 for (const k of touched)
                     archive[k] = args[k];
+                if (unbindToolTable)
+                    delete archive.toolTablePreset;
+                if (setToolTable)
+                    archive.toolTablePreset = String(args.toolTablePreset).trim();
+                if (setQuickPrompts)
+                    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) || '保存场景档案失败');
@@ -349,18 +445,41 @@ export function buildSceneTools(deps) {
                 // 静默清掉，所以"模型给什么就是什么"），但"给出去的段盖掉了原来的勾选"是**静默**的
                 // —— 不写出来，模型只会看到一句"档案段：mcp"，以为只是加了一项。
                 const diffs = touched.map((k) => segmentDiff(k, before[k], args[k]));
-                archiveNote = '档案段：' + diffs.map((d) => d.text).join('；');
-                if (diffs.some((d) => d.dropped.length > 0)) {
-                    archiveNote += '\n注意：这些段是整段替换，上面标 - 的项已被挤掉；要保留就把它们一并写进这次调用。';
+                if (diffs.length) {
+                    archiveNote = '档案段：' + diffs.map((d) => d.text).join('；');
+                    if (diffs.some((d) => d.dropped.length > 0)) {
+                        warnTail += '\n注意：这些段是整段替换，上面标 - 的项已被挤掉；要保留就把它们一并写进这次调用。';
+                    }
                 }
-                // 当前环境里不存在的键会被 op 丢弃并报告（改名或删除留下的）：如实说，
-                // 否则模型以为勾上了而实际没有。
+                // 当前环境里不存在的键会被 op 丢弃并报告（改名或删除留下的，含工具表方案名与
+                // 快捷提示词 id）：如实说，否则模型以为勾上了而实际没有。
                 if (r.stale && r.stale.length)
-                    archiveNote += '（丢弃了当前环境不存在的键：' + r.stale.join('、') + '）';
+                    warnTail += '\n（丢弃了当前环境不存在的键：' + r.stale.join('、') + '）';
                 // 存盘成功但应用到运行时失败：`scene-archive-save` 对"正是当前模式的那个场景"会就地
                 // 重应用，失败不回滚档案。如实报出去，别假装生效了（与界面同口径）。
                 if (r.applyError)
-                    archiveNote += '（已存盘，但应用到运行时失败：' + r.applyError + '）';
+                    warnTail += '\n（已存盘，但应用到运行时失败：' + r.applyError + '）';
+            }
+            // 解绑写失败了就别输出「X → 解绑」—— 上面那句 WARN 才是事实；设置方向不受 ② 影响。
+            if (args.toolTablePreset !== undefined && !(unbindToolTable && clearWarn !== '')) {
+                toolTableNote = beforeKnown
+                    ? '工具表方案：' + (toolTableLabel(before.toolTablePreset) || '未绑') + ' → ' +
+                        (unbindToolTable ? '解绑' : toolTableLabel(String(args.toolTablePreset).trim()))
+                    : '工具表方案：已解绑（档案现状读不到，无法对比）';
+            }
+            if (setQuickPrompts && beforeKnown) {
+                const beforeIds = Array.isArray(before.quickPrompts) ? before.quickPrompts.map((x) => String(x)) : [];
+                const afterIds = quickPromptIds(args.quickPrompts);
+                const added = afterIds.filter((id) => beforeIds.indexOf(id) < 0);
+                const dropped = beforeIds.filter((id) => afterIds.indexOf(id) < 0);
+                const marks = [];
+                if (added.length)
+                    marks.push('+' + toolNameList(added));
+                if (dropped.length)
+                    marks.push('-' + toolNameList(dropped));
+                quickNote = '快捷提示词：' + beforeIds.length + ' 条 → ' + afterIds.length + ' 条' +
+                    (afterIds.length === 0 ? '（进入后全部停用）' : '') +
+                    (marks.length ? '（' + marks.join(' ') + '）' : '');
             }
             // 收敛提示：`rules-create-scene` 在"历史默认（全部启用）"状态下会把启用集合收窄成
             // 单选（`collapseActiveForNewScene`）—— 那是一次**会改变运行时**的动作，必须说出来。
@@ -369,15 +488,19 @@ export function buildSceneTools(deps) {
             const parts = [touchedRecord.length ? '场景记录已更新（' + touchedRecord.join('、') + '）' : '场景已确保存在'];
             if (archiveNote)
                 parts.push(archiveNote);
+            if (toolTableNote)
+                parts.push(toolTableNote);
+            if (quickNote)
+                parts.push(quickNote);
             // 点名 scene_manager_switch 的那句按可见性分叉（它在出厂默认名单里就是关着的）：
             // 部分启用（开 save 不开 switch）时指向一条模型没有的工具，只会让它白跑一趟 ——
             // 与 mcp/skill 的 listHint 同一条纪律。
             const enterHint = deps.toolVisible('scene_manager_switch')
                 ? '要让它生效，用 scene_manager_switch 进入。'
-                : '要让它生效，由用户在「场景」页进入。';
-            return 'OK: scene「' + scene + '」' + parts.join('；') +
+                : '要让它生效，需用户手动进入该场景（本会话未开放 scene_manager_switch）。';
+            return 'OK: scene「' + scene + '」' + parts.join('；') + warnTail + clearWarn +
                 (collapsed
-                    ? '\n注意：此前所有场景都处于启用状态（历史「全部启用」默认），本次已收窄为只启用一个，新建的这个不在其中 —— 让用户到「场景」页确认。'
+                    ? '\n注意：此前所有场景都处于启用状态（历史「全部启用」默认），本次已收窄为只启用一个，新建的这个不在其中 —— 需用户确认启用状态。'
                     : '') +
                 '\n保存不改运行时：' + enterHint;
         },