dsh-plugin-tool-management 0.10.0 → 0.11.0

package/lib/tools/prompt.js

@@ -0,0 +1,70 @@
+// AGENTS.md 预设域的 model 工具（2026-09-19 从 index.ts 的注册区抽出）：
+// prompt_manager_list / prompt_manager_apply。
+//
+// 模型可查、可切，**不能造 / 不能删** —— 避免模型乱删用户预设。
+import { join } from 'node:path';
+import { text } from './deps.js';
+export function buildPromptTools(deps) {
+    const { defineTool, register } = deps;
+    register(defineTool({
+        name: 'prompt_manager_list',
+        description: 'List AGENTS.md presets (id, active state, file path). Read that file to see a preset body. The preset in effect right now is injected into your context each turn (the「本机提示词」system-reminder, whose「来源：」line names the file). Defaults to the preset currently in effect; pass all=true for the whole library.',
+        parameters: {
+            all: { type: 'boolean', description: 'Include inactive presets (default false).' },
+        },
+        output: { schema: { type: 'string' }, render: (_a, v) => text(v) },
+        async execute(args, exec) {
+            const showAll = Boolean(args && args.all === true);
+            const r = await deps.promptsService.list();
+            if (!r.ok)
+                throw new Error(r.error);
+            const all = r.presets || [];
+            // 默认只列「当前这份 ~/.dsh/AGENTS.md 是从哪个预设来的」（用户裁定 2026-09-16）。
+            // 判定分两级：内容逐字节相同 = 生效；否则看服务层记下的「最近一次应用」——
+            // 用户手改过全局文件时，第二级仍能给出答案，不必退化成全列（那会白烧上下文）。
+            const active = all.filter((p) => p.active === true);
+            const fallback = active.length ? active : all.filter((p) => p.lastApplied === true);
+            const shown = showAll ? all : fallback;
+            // 路径这一列是「名单 → 全文」的闭环：预设正文既不进提示词、也没有读取工具，
+            // 给出文件路径让模型用宿主的文件工具读，比再造一个 read 工具省一条常驻 schema。
+            const summary = shown.map((p) => {
+                const mark = p.active ? ' [active]'
+                    : p.lastApplied ? ' [last applied — ~/.dsh/AGENTS.md has changed since]'
+                        : '';
+                return p.id + mark + ' | ' + join(deps.promptsDir, p.id, 'AGENTS.md');
+            });
+            const header = 'AGENTS.md presets: ' + (showAll
+                ? all.length + ' in the library'
+                : fallback.length
+                    ? fallback.length + (active.length ? ' active' : ' last applied') + ' of ' + all.length +
+                        (fallback.length === all.length ? '' : ' (pass all=true for the whole library)')
+                    : '0 active of ' + all.length + ' (pass all=true for the whole library)') + '\n';
+            // 同上：AGENTS.md 由官方 dsh-agent-instructions 行承载（极简没挂这一行），
+            // 这一行不在时文件内容不会进上下文。
+            const notice = await deps.reachNoticeForAgent(deps.presetRoster(), exec && exec.agent && exec.agent.ctx, deps.injectNoticeOptions());
+            return header + (summary.join('\n') || '(none)') + '\n(DSH re-reads ~/.dsh/AGENTS.md every turn, so applying takes effect on the next turn.)' + notice;
+        },
+    }));
+    register(defineTool({
+        name: 'prompt_manager_apply',
+        description: 'Apply one AGENTS.md preset by id; effective on the next turn. If a scene currently drives the baseline, this does NOT refuse: it rebinds that scene\'s prompt binding to the preset and re-syncs the scene, so ~/.dsh/AGENTS.md ends up holding the scene\'s (new) binding — tell the user which scene was rebound. Otherwise the preset is written to ~/.dsh/AGENTS.md directly. A locked scene blocks the call.',
+        parameters: {
+            id: { type: 'string', required: true, description: 'Preset id (lowercase letters, digits, hyphens).' },
+        },
+        output: { schema: { type: 'string' }, render: (_a, v) => text(v) },
+        async execute(args) {
+            const blocked = await deps.lockedSceneGuard();
+            if (blocked)
+                throw new Error(blocked);
+            const r = await deps.applyPresetGuarded(args.id);
+            if (!r.ok)
+                throw new Error(r.error);
+            // 场景驱动时写的是「场景绑定」，回执必须说清改的是哪个场景 —— 只说「已应用到
+            // AGENTS.md」会让模型对用户谎报（用户不知道自己的场景绑定被换掉了）。
+            if (r.viaScene) {
+                return 'OK: preset ' + args.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 ' + args.id + ' applied to ~/.dsh/AGENTS.md (next session; current session unchanged' + (r.backedUp ? '; previous backed up to __last-applied__' : '') + ')';
+        },
+    }));
+}

package/lib/tools/skills.js

@@ -0,0 +1,139 @@
+// 技能域的 model 工具（2026-09-19 从 index.ts 的注册区抽出）：
+// skill_manager_list / skill_manager_set_enabled / skill_manager_create。
+import { text } from './deps.js';
+export function buildSkillTools(deps) {
+    const { defineTool, register } = deps;
+    // Skill-facing tools: list, toggle, create. create is gated by the
+    // tools/pre-execute hook below (the model must ask before writing files).
+    register(defineTool({
+        name: 'skill_manager_list',
+        description: 'List DSH skills with enabled state, effective/shadowed status and source file path. The injected「本机技能目录」system-reminder carries callable skills and summaries only; use this tool to get a source file path (read the file for the full body) and to see entries that are off. Defaults to enabled skills only; pass all=true for every entry. A copy marked "shadowed by <root>" stays inactive even if enabled.',
+        parameters: {
+            all: { type: 'boolean', description: 'Include disabled and shadowed entries (default false).' },
+        },
+        output: { schema: { type: 'string' }, render: (_a, v) => text(v) },
+        async execute(args, exec) {
+            const showAll = Boolean(args && args.all === true);
+            const r = await deps.skillsOps['skill-state']({});
+            if (!r || r.ok === false)
+                throw new Error((r && r.error) || 'skill-state failed');
+            const data = r.data || {};
+            // 同名（canonical = declaredName || name）跨根重复时只有**一份**生效，排序规则是
+            // 「同名首选 > 来源优先级 rank」，**与启用状态无关**（core 的 groupLoadableSkillsByName）。
+            // 于是「启用被覆盖的那份」是静默无效的：工具会回 OK，技能却依然不可用 —— 用户实测
+            // 踩到的正是这个坑（同一技能在 dsh/agents/claude/custom 各有一份，启错根等于没启）。
+            // 这里把生效/被覆盖如实标出来，让模型（和人）不必猜。
+            //
+            // 默认只列启用的（2026-09-16 用户裁定）：本机 36 条里只有 1 条启用，全列一次约 4.3k
+            // 字符且永久留在 transcript。表头始终给出全量口径（多少条 / 多少同名组），所以
+            // 「还有没列出来的」不会变成盲区 —— 要看就传 all=true。
+            const rows = [];
+            const counts = new Map();
+            for (const root of data.roots || []) {
+                for (const skill of root.skills || []) {
+                    const key = String(skill.declaredName || skill.name || '');
+                    counts.set(key, (counts.get(key) || 0) + 1);
+                    // `enabled` 只写在「胜出者」上（core 的 markWinners）；影子副本与不可加载的技能
+                    // 没有这个字段。原先直接读 skill.enabled，这些技能一律被报成 disabled ——
+                    // 这里改用与界面同口径的兜底推导（client 的 isSkillEnabled）。
+                    const enabled = skill.enabled !== undefined
+                        ? skill.enabled === true
+                        : (skill.invocationPolicyValid && skill.modelInvocable && skill.userInvocable && skill.managerEnabled !== false);
+                    const marks = [];
+                    if (skill.shadowedBy && skill.shadowedBy.root)
+                        marks.push('shadowed by ' + skill.shadowedBy.root);
+                    if (skill.preferred === true)
+                        marks.push('preferred');
+                    rows.push({
+                        root: String(root.key || ''),
+                        enabled,
+                        text: (skill.name || skill.declaredName || '') + ' | ' + (root.key || '') + ' | ' + (enabled ? 'enabled' : 'disabled') +
+                            (marks.length ? ' | ' + marks.join(' ') : '') +
+                            (skill.path ? ' | ' + skill.path : ''),
+                    });
+                }
+            }
+            const dupGroups = [...counts.values()].filter((n) => n > 1).length;
+            const shown = showAll ? rows : rows.filter((row) => row.enabled);
+            const header = 'Skills: ' + (showAll
+                ? rows.length + ' entries'
+                : shown.length + ' enabled of ' + rows.length + ' entries') +
+                (dupGroups ? ' · ' + dupGroups + ' duplicated names' : '') +
+                (showAll || shown.length === rows.length ? '' : ' (pass all=true to include disabled and shadowed entries)') + '\n';
+            // 注入边界：预设没挂 dsh-tool-skill（如极简）时官方技能目录不在，本插件的
+            // 「技能目录」注入域会在开关打开时兜底（见上面的注入通道）；两者都没有时模型看到的
+            // 只是这份名单 —— 说清边界，别让它以为上下文里已经有技能正文（正文用路径读）。
+            const notice = await deps.reachNoticeForAgent(deps.presetRoster(), exec && exec.agent && exec.agent.ctx, deps.injectNoticeOptions());
+            return header + (shown.map((row) => row.text).join('\n') || '(none)') + notice;
+        },
+    }));
+    register(defineTool({
+        name: 'skill_manager_set_enabled',
+        description: 'Enable or disable one DSH skill (manager policy only; source files are never modified). Enabling a shadowed copy has no effect.',
+        parameters: {
+            name: { type: 'string', required: true, description: 'Skill name (kebab-case).' },
+            enabled: { type: 'boolean', required: true, description: 'true to enable, false to disable.' },
+            root: { type: 'string', description: 'Source root key (dsh/agents/codex/claude or a project key); default dsh.' },
+        },
+        output: { schema: { type: 'string' }, render: (_a, v) => text(v) },
+        async execute(args) {
+            const blocked = await deps.lockedSceneGuard();
+            if (blocked)
+                throw new Error(blocked);
+            const root = String(args.root || 'dsh');
+            const op = args.enabled ? 'skill-enable' : 'skill-disable';
+            const r = await deps.skillsOps[op]({ name: args.name, root });
+            if (!r || r.ok === false)
+                throw new Error((r && r.error) || 'skill toggle failed');
+            // 场景未锁定时同步进当前场景档案（与 handlers 层同一套同步）。
+            const syncErr = await deps.syncSwitchToScene(op, { name: args.name, root, enabled: args.enabled === true });
+            // 静默无效是这个工具最容易骗人的地方：同名胜负只由「首选 > 来源优先级」决定，
+            // 与启用状态无关。对影子副本操作会返回 OK，但技能依然不可用。如实说一句。
+            let shadowedBy = '';
+            try {
+                const state = await deps.skillsOps['skill-state']({});
+                for (const rt of (state && state.data && state.data.roots) || []) {
+                    for (const skill of rt.skills || []) {
+                        if (String(skill.declaredName || skill.name || '') !== String(args.name))
+                            continue;
+                        if (String(rt.key || '') !== root)
+                            continue;
+                        if (skill.shadowedBy && skill.shadowedBy.root)
+                            shadowedBy = String(skill.shadowedBy.root);
+                    }
+                }
+            }
+            catch {
+                shadowedBy = '';
+            }
+            const warn = shadowedBy
+                ? ' — BUT this copy is shadowed by the same-name skill in "' + shadowedBy + '", so it stays inactive: enable that copy instead, or make this root the preferred copy in the panel'
+                : '';
+            const sceneWarn = syncErr ? '\nWARN: 当前场景档案未同步（' + syncErr + '）' : '';
+            return 'OK: ' + args.name + ' now ' + (args.enabled ? 'enabled' : 'disabled') + warn + sceneWarn;
+        },
+    }));
+    register(defineTool({
+        name: 'skill_manager_create',
+        // 落点必须和 UI「创建技能」一致：两者都走 core 的默认落点（hub 的
+        // tool-management/skills/，hub 缺失时退回 DSH_HOME/skills）。以前这里硬编码
+        // root:'dsh'，于是同一个「新建技能」动作，人点界面和模型调用会落到两个不同的根。
+        description: 'Create a new DSH skill under DSH_HOME/tool-management/skills. Use only when the user explicitly asks to create or save a reusable skill.',
+        parameters: {
+            name: { type: 'string', required: true, description: 'Skill name; normalized to kebab-case.' },
+            description: { type: 'string', required: true, description: 'A concise routing description for when to use the skill.' },
+            body: { type: 'string', required: true, description: 'Markdown instructions that form the skill body.' },
+        },
+        output: { schema: { type: 'string' }, render: (_a, v) => text(v) },
+        async execute(args) {
+            const blocked = await deps.lockedSceneGuard();
+            if (blocked)
+                throw new Error(blocked);
+            const r = await deps.skillsOps['skill-create']({ name: args.name, description: args.description, body: args.body });
+            if (!r || r.ok === false)
+                throw new Error((r && r.error) || 'skill create failed');
+            const data = r.data || {};
+            return 'Created DSH skill ' + (data.name || args.name) + ' at ' + (data.path || '(unknown)');
+        },
+    }));
+}

package/lib/tools/subagent.js

@@ -0,0 +1,40 @@
+// 子智能体域的 model 工具（2026-09-19 从 index.ts 的注册区抽出）：
+// subagent_manager_list / subagent_manager_run。
+//
+// exec.agent / exec.signal 由工具运行时提供（parent 与取消信号的官方通道）。
+//
+// 两个工具**各自** try/catch：一个注册失败不该把另一个也带走，而且失败必须说得出
+// 「是哪一个没注册上」——只打一行日志时，模型侧只会「查无此工具」、界面毫无痕迹。
+import { defineSubagentManagerListTool, defineSubagentManagerRunTool } from '../subagents/tools.js';
+export function buildSubagentTools(deps) {
+    const { defineTool, register } = deps;
+    const recordFailure = (name, e) => {
+        deps.failures.list.push({ name, reason: deps.message(e) });
+        if (deps.failures.logged)
+            return;
+        deps.failures.logged = true;
+        console.error('[dsh-plugin-tool-management] subagent tool registration failed:', name, deps.message(e));
+    };
+    try {
+        // 与其余 12 个工具同一条注册通道：defineTool 负责编译 parameters（object root + required），
+        // 裸 register 会把未编译的参数声明直接发给模型 API。
+        register(defineTool(defineSubagentManagerListTool({
+            list: () => deps.subagentService.list(),
+            sceneLists: deps.sceneLists,
+            // 与其余发现型工具同口径：压制型预设下不注入时，人设目录不在模型上下文里，
+            // 只有工具可用。挂上边界提示，模型才不会把「看不到人设」当成「没有人设」。
+            noticeFor: (exec) => deps.reachNoticeForAgent(deps.presetRoster(), exec && exec.agent && exec.agent.ctx, deps.injectNoticeOptions()),
+        })));
+    }
+    catch (e) {
+        recordFailure('subagent_manager_list', e);
+    }
+    try {
+        // 工具限制按**当前会话的 Agent 预设**下发：父会话跑在哪个预设，就用那个预设那一行的
+        // 白/黑名单（`decideToolFilter`），名单里已消失的工具名会被丢掉并在结果里如实说明。
+        register(defineTool(defineSubagentManagerRunTool({ ...deps.subagentService, sceneLists: deps.sceneLists, toolFilterFor: deps.toolFilterFor })));
+    }
+    catch (e) {
+        recordFailure('subagent_manager_run', e);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-tool-management",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "DSH plugin: one settings panel for MCP servers, skills, scenes, memories, subagents, AGENTS.md presets and archived sessions — scene memory injects into the system prompt, scene lock freezes all five domains, deleted workspaces re-register with one click. Settings UI + HTTP API + 14 model tools (mcp_manager_*, skill_manager_*, prompt_manager_*, memory_manager_*, subagent_*). Install with one command: dsh plugin --profile web add dsh-plugin-tool-management@latest",
   "repository": {
     "type": "git",
@@ -11,7 +11,7 @@
   "exports": {
     ".": "./lib/index.js",
     "./client": "./lib/client.js",
-    "./workspace": "./lib/history/workspace.js",
+    "./workspace": "./lib/sessions/workspace.js",
     "./package.json": "./package.json"
   },
   "files": [
@@ -32,15 +32,15 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json && node scripts/sync-client.mjs",
-    "build:client": "node scripts/sync-client.mjs",
-    "prepublishOnly": "npm run build",
+    "build": "tsc -p tsconfig.json && node scripts/sync-client.mjs && node scripts/sync-profile.mjs",
+    "prepublishOnly": "npm run build && npm run lint && node --test test/client-exports.test.mjs",
     "lint": "node --check lib/client.js && node --check lib/index.js",
-    "check:i18n": "node scripts/check-i18n.mjs src/client.js",
+    "typecheck:client": "node scripts/sync-client.mjs && tsc -p tsconfig.client.json",
+    "check:i18n": "node scripts/check-i18n.mjs lib/client.js",
     "check:host": "node scripts/host-deps.mjs && node scripts/doctor.mjs",
     "host-deps": "node scripts/host-deps.mjs --fix",
     "doctor": "node scripts/doctor.mjs",
-    "test": "npm run build && npm run check:i18n && node --test test/contracts.test.mjs test/client-exports.test.mjs test/client-render.test.mjs",
+    "test": "npm run build && npm run check:i18n && node --test test/contracts.test.mjs test/client-exports.test.mjs",
     "sync:profile": "node scripts/sync-profile.mjs"
   },
   "keywords": [

package/lib/agents-md/preset-id.js

@@ -1,49 +0,0 @@
-// dsh-plugin-tool-management —— 提示词预设 id 的唯一口径。
-//
-// 用户裁定（2026-09-15）：「id 应该什么都能写」——不再限定小写字母/数字/连字符，
-// 中文、空格、下划线、点都可以。id 同时也是**磁盘目录名**，所以只保留两类硬约束：
-//   ① 文件系统安全：不含路径分隔符与 Windows 非法字符、不以点开头/结尾、
-//      不是 `.` / `..`、不是 Windows 保留设备名；
-//   ② 一个保留字：`__last-applied__`（apply 的备份槽，不是用户预设）。
-// 这套口径由提示词服务（agents-md/ 目录）与场景绑定（`scenes[].prompt`）共用，避免两处漂移。
-// 约定镜像 @deepseek-ai/dsh-agent-presets 的「id 即目录名」，但放宽了字符集。
-/** id 长度上限（字符数；目录名过长在 Windows 上还受 MAX_PATH 约束）。 */
-export const PRESET_ID_MAX = 64;
-/** apply 的备份槽：不是用户预设，任何入口都不得当作预设 id。 */
-export const LAST_APPLIED_PRESET_ID = '__last-applied__';
-/** Windows 保留设备名（不区分大小写，带扩展名同样非法）。 */
-const WINDOWS_RESERVED = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;
-/**
- * 校验并归一化一个预设 id。
- * @param raw - 用户输入或来自索引的原始值。
- * @returns `{ ok: true, id }`（已 trim）或 `{ ok: false, error }`（给人看的中文原因）。
- */
-export function normalizePresetId(raw) {
-    const id = String(raw ?? '').trim();
-    if (id === '')
-        return { ok: false, error: 'id 不能为空' };
-    if (id.length > PRESET_ID_MAX)
-        return { ok: false, error: `id 过长（≤${PRESET_ID_MAX} 字符，当前 ${id.length}）` };
-    if (id === LAST_APPLIED_PRESET_ID)
-        return { ok: false, error: `「${LAST_APPLIED_PRESET_ID}」是「应用」的备份槽，不能用作预设 id` };
-    if (id === '.' || id === '..')
-        return { ok: false, error: 'id 不能是「.」或「..」' };
-    if (id.startsWith('.'))
-        return { ok: false, error: 'id 不能以「.」开头' };
-    if (/[\\/]/.test(id))
-        return { ok: false, error: 'id 不能含路径分隔符（/ 或 \\）' };
-    if (/[<>:"|?*]/.test(id))
-        return { ok: false, error: 'id 不能含 < > : " | ? * 这些字符' };
-    if (/[.\s]$/.test(id))
-        return { ok: false, error: 'id 不能以点或空格结尾（Windows 会静默去掉）' };
-    if (WINDOWS_RESERVED.test(id))
-        return { ok: false, error: `「${id}」是 Windows 保留设备名` };
-    // 控制字符（含换行/制表）会让目录名与日志不可读，直接拒绝。
-    if (/[\u0000-\u001f\u007f]/.test(id))
-        return { ok: false, error: 'id 不能含控制字符' };
-    return { ok: true, id };
-}
-/** 便捷判定（索引解析等只关心"能不能用"的地方）。 */
-export function isValidPresetId(raw) {
-    return normalizePresetId(raw).ok;
-}