dsh-plugin-tool-management 0.5.1 → 0.7.0

package/cordis.patch.yml

@@ -1,60 +1,14 @@
-# Bundle patch layer for the official CLI install:
+# Install only this plugin. History composes the already active host services.
+# Do NOT disable workspace/session-projection-cache, insert competing service
+# providers, or infer capabilities from another package's name.
+# Existing explicit user-layer overrides remain the user's responsibility.
 #
-#   dsh plugin --profile web add dsh-plugin-tool-management@latest
+# Double-mount guard: inspect raw options only. Entry.disabled is a computed
+# getter and reading it from another disabled expression can recurse at boot.
 #
-# `dsh plugin add` reconciles `dsh.profile.bundles` against installed packages
-# and, seeing the `dsh.bundle.patch` declaration in package.json, appends
-# `dsh-plugin-tool-management` to the bundle stack. The profile boot then merges
-# THIS patch (a single `insert` of the plugin row). No profile file edits
-# needed — one command installs and mounts.
-#
-# Double-mount guard: an aggregate bundle (or a hand-written loader row) may
-# already mount this plugin under a different entry id. Two mounts both register the
-# /dsh-plugin-tool-management/api route and fail the whole plugin tree at boot
-# ("duplicate prefix route"). The `!!js` disabled expression backs THIS row
-# off when another *enabled* entry already mounts the plugin; the existing
-# instance then owns the API. The loader evaluates the expression at entry
-# activation — the full entry tree is composed by then, so user-layer
-# (profile cordis.patch.yml) rows are visible too.
-#
-# ORDER MATTERS — do not move `!e.disabled` ahead of the id/name checks.
-# `Entry.disabled` is an uncached getter that re-evaluates the expression,
-# so touching `e.disabled` of THIS entry re-enters this very expression
-# (infinite recursion → "Maximum call stack size exceeded" at boot). The
-# `id !==` check short-circuits on our own row and the `name` check
-# short-circuits on every unrelated entry (e.g. dsh-better-sidebar's own
-# guard), so `!e.disabled` is only ever read on a genuinely matching
-# legacy/aggregate row (a plain boolean, no re-entry).
-# 折叠 dsh-archive-manager：替换官方 workspace 与 session-projection-cache
-# 服务为归档感知子类（永久删除 + unarchive + 批量 + archivedAt 保留期账本）。
-# 官方 ui-workspace 保持启用；归档菜单仍由官方 UI 提供，删除/恢复/保留期
-# 由本插件的 TOOLS → History 页面经 HTTP API 驱动。
-#
-# 冲突告警：不要同时安装独立的 @michengai/dsh-archive-manager——两个补丁都
-# 禁用官方 workspace 行并插入替换，会导致重复服务注册、启动失败。
-#
-# spawn provider（子智能体）挂载：本文件**故意不**插入
-# `@deepseek-ai/dsh-subagent-spawn-in-process` 行。取舍理由：
-#   1) insert 行在启动期解析：换台没有该包的宿主会因单行加载失败拖垮整棵插件树，
-#      而缺 provider 时受影响面只有一个 subagent_run 调用；
-#   2) 该行与本插件运行时的 ctx.plugin 兜底挂载存在双挂载窗口（同名 provider 重复注册）。
-# 改由 src/subagents/service.ts 走官方通道：ctx.subagents.list() 探测到 spawn 即跳过；
-# 缺失才经 createRequire + apply(ctx, {providerName:'spawn'}) 挂载；失败把原因原样抛给模型。
-# 该包在 package.json 声明为**可选** peerDependency（peerDependenciesMeta.optional）——
-# 宿主/profile 自带时可以照常挂载。设计 §3.2 字面要求「挂载声明进 cordis.patch.yml」，
-# 这里按上述风险裁定为有意偏离（记录见 docs/审查/2026-09-13-场景档案v2双轴评审.md）。
-- id: workspace
-  disabled: true
-- id: session-projection-cache
-  disabled: true
+# The optional subagent spawn provider is resolved at runtime by the subagent
+# service; an unavailable optional package must not prevent the host from booting.
 - insert:
     - id: dsh-plugin-tool-management
       name: 'dsh-plugin-tool-management'
-      disabled: !!js "[...ctx.loader.entries()].some((e) => e.options.id !== 'dsh-plugin-tool-management' && e.options.name === 'dsh-plugin-tool-management' && !e.disabled)"
-    - id: workspace-tool-management-history
-      name: 'dsh-plugin-tool-management/workspace'
-    - id: session-projection-cache-tool-management-history
-      name: 'dsh-plugin-tool-management/projcache'
-      config:
-        writeEveryEvents: 200
-        writeIntervalMs: 5000
+      disabled: !!js "[...ctx.loader.entries()].some((e) => e.options.id !== 'dsh-plugin-tool-management' && e.options.name === 'dsh-plugin-tool-management' && e.options.disabled !== true && typeof e.options.disabled !== 'object')"

package/docs/update.md

@@ -0,0 +1,55 @@
+# 版本更新概要
+
+每个版本大致改了什么——想知道「升上去会变什么」看这里就够了。逐条细节见 [Changelog](../CHANGELOG.md)，功能说明见 [README](../README.md) / [README_EN](../README_EN.md)。
+
+| 版本 | 发布 | 主题 |
+|---|---|---|
+| [0.7.0](#070---2026-09-15) | 2026-09-15 | 回收站全量 + 预设注入可见性 + 密钥令牌化 |
+| [0.6.0](#060---2026-09-14) | 2026-09-14 | 宿主兼容体检 + 兼容页 |
+| [0.5.1](#051---2026-09-13) | 2026-09-13 | 场景档案默认不勾选 + 场景页排版重做 |
+| [0.5.0](#050---2026-09-13) | 2026-09-13 | 数据目录统一 + 场景显式化 + 界面重做 |
+| [0.2.0](#020---2026-09-12) | 2026-09-12 | 五域合并进一个「工具」面板 |
+
+---
+
+## 0.7.0 - 2026-09-15
+
+- 回收站扩到子智能体 / 场景 / 提示词预设（删除都进回收站，可恢复）。
+- 子智能体工具限制按 Agent 预设（每预设一份白/黑名单）。
+- 兼容页「预设注入边界」五列标签（绿/红/灰框）。
+- 明文密钥改为一律要令牌（没配 `token` 就不给明文）。
+- MCP「整理补丁」重新上线（删多余启停块，状态不变）。
+
+## 0.6.0 - 2026-09-14
+
+- 新增「兼容」页（第 8 栏）+ doctor/host-deps 脚本。
+- 兼容判定从源码文本比对改为模块实体 + 能力探测。
+- 归档会话不再丢工作区归属（登记被删后重建分组 + 一键重新登记）。
+- 技能来源权限语义修正（默认来源必须读取但技能可删）。
+- 场景可绑提示词预设，切换场景直接改写 AGENTS.md（关掉自动恢复）。
+- 场景启用改单选，新场景默认不启动。
+
+## 0.5.1 - 2026-09-13
+
+- 场景档案弹窗新加段默认不勾选。
+- 档案「记忆」段只列本场景的记忆。
+- 场景页排版重做（卡片只留名字+描述+动作）。
+- 保留场景「全局」不再出现在场景页与档案弹窗。
+
+## 0.5.0 - 2026-09-13
+
+- 数据全部收进 `~/.dsh/tool-management/`（旧位置自动搬入）。
+- 场景升级为显式记录；根层裸 `.md` 不再注入。
+- 新增「导入技能」来源 + 「移除来源」操作。
+- 场景档案新增第 4 段「记忆」。
+- 修掉三个真故障：整页白屏、导出静默丢失、Skills 页锁死。
+- 斜杠命令全部下线。
+
+## 0.2.0 - 2026-09-12
+
+- 五域合并进一个「工具」面板：MCP / Skills / AGENTS.md 预设 / History。
+- MCP 工具级启停、重启只重连、密钥打码、补丁备份。
+- Skills 接入 ~/.agents / ~/.codex / ~/.claude + 自定义目录。
+- History 按项目分组、批量操作、保留期清理、对话导入导出。
+
+> 0.1.1 / 0.1.2 / 0.1.3 无独立记录（仅 git tag）。

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

@@ -0,0 +1,49 @@
+// 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;
+}

package/lib/agents-md/service.js

@@ -1,22 +1,32 @@
 // dsh-plugin-tool-management —— AGENTS.md 预设库 + 切换 服务层。
 //
 // DSH 全局指令基线只有一个文件 ~/.dsh/AGENTS.md（USER_GLOBAL_FILE 固定），
-// 没有内置的「多份全局 AGENTS.md 切换」机制。本服务在插件目录内维护一个
+// 没有内置的「多份全局 AGENTS.md 切换」机制。本服务在 hub 内维护一个
 // 预设库（每套一个子目录 + AGENTS.md），「应用」= 把选中预设内容写入
 // ~/.dsh/AGENTS.md，新会话生效（当前会话不变，DSH 本身如此）。
 //
-// 约定镜像 @deepseek-ai/dsh-agent-presets：id 即目录名，正则
-// /^[a-z0-9][a-z0-9-]*$/；__last-applied__ 是备份槽，不算用户预设。
+// id 即目录名：字符集口径见 `./preset-id.ts`（用户裁定「什么都能写」，只留
+// 文件系统安全约束）；`__last-applied__` 是备份槽，不算用户预设。
 // 「当前生效」靠比对 ~/.dsh/AGENTS.md 的 sha256 与各预设 sha256 推断，
 // 无状态文件——用户手改全局文件也能如实反映。
-import { mkdir, readdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { mkdir, readdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { createHash } from 'node:crypto';
-const PRESET_ID_RE = /^[a-z0-9][a-z0-9-]*$/;
+import { isValidPresetId, LAST_APPLIED_PRESET_ID, normalizePresetId } from './preset-id.js';
+import { listTrashEntries, moveOutOfTrash, moveToTrash, purgeTrashEntry, readTrashEntry } from '../hub.js';
 const FILENAME = 'AGENTS.md';
-const LAST_APPLIED_ID = '__last-applied__';
+const LAST_APPLIED_ID = LAST_APPLIED_PRESET_ID;
+/** 新建预设的初始正文（空模板）；用户也可以直接粘贴自己的内容。 */
+const BLANK_TEMPLATE = '# AGENTS.md\n\n（DSH 全局指令基线预设，待编辑）\n';
+/** 全局 AGENTS.md 的备份代际上限：与 mcpm patch 的 KEEP_PATCH_BACKUPS 同纪律。 */
+const KEEP_GLOBAL_BACKUPS = 5;
 export function createAgentsMdService(_ctx, deps) {
     const message = (e) => String((e && e.message) || e);
+    /** 校验 id 并返回错误文本（合法时返回 `null`）。 */
+    const idError = (raw) => {
+        const result = normalizePresetId(raw);
+        return result.ok ? null : result.error;
+    };
     async function sha256OfFile(abs) {
         try {
             const buf = await readFile(abs, 'utf8');
@@ -36,7 +46,7 @@ export function createAgentsMdService(_ctx, deps) {
             existing = await readdir(presetsDir, { withFileTypes: true });
         }
         catch { /* 库不存在 */ }
-        const hasPreset = existing.some((e) => e.isDirectory() && PRESET_ID_RE.test(e.name) && e.name !== LAST_APPLIED_ID);
+        const hasPreset = existing.some((e) => e.isDirectory() && isValidPresetId(e.name) && e.name !== LAST_APPLIED_ID);
         if (hasPreset)
             return;
         let globalContent;
@@ -67,7 +77,7 @@ export function createAgentsMdService(_ctx, deps) {
             }
             const globalHash = await sha256OfFile(globalPath);
             const ids = entries
-                .filter((e) => e.isDirectory() && PRESET_ID_RE.test(e.name) && e.name !== LAST_APPLIED_ID)
+                .filter((e) => e.isDirectory() && isValidPresetId(e.name) && e.name !== LAST_APPLIED_ID)
                 .map((e) => e.name);
             const presets = await Promise.all(ids.map(async (id) => {
                 const contentHash = await sha256OfFile(join(presetsDir, id, FILENAME));
@@ -84,11 +94,10 @@ export function createAgentsMdService(_ctx, deps) {
         }
     }
     async function read(id) {
-        const safeId = String(id || '');
-        // id 即目录名，严格校验防目录穿越：仅允许小写字母/数字/连字符。
-        // __last-applied__ 含下划线会被拒（它是备份槽，不走 read，由 apply 内部直写）。
-        if (!PRESET_ID_RE.test(safeId))
-            return { ok: false, error: '非法 id（仅允许小写字母、数字、连字符）：' + safeId };
+        const bad = idError(id);
+        if (bad)
+            return { ok: false, error: '非法 id：' + bad };
+        const safeId = String(id ?? '').trim();
         try {
             const content = await readFile(join(deps.presetsDir, safeId, FILENAME), 'utf8');
             return { ok: true, content };
@@ -97,39 +106,53 @@ export function createAgentsMdService(_ctx, deps) {
             return { ok: false, error: '预设不存在：' + safeId };
         }
     }
-    async function create(id, from) {
-        const safeId = String(id || '');
-        if (!PRESET_ID_RE.test(safeId))
-            return { ok: false, error: '非法 id（仅允许小写字母、数字、连字符）：' + safeId };
+    /** 新建预设：`content` 优先（用户在新建弹窗里直接写的内容），否则用 `from` 复制，否则空模板。 */
+    async function create(id, options) {
+        const bad = idError(id);
+        if (bad)
+            return { ok: false, error: '非法 id：' + bad };
+        const safeId = String(id ?? '').trim();
         const dir = join(deps.presetsDir, safeId);
         try {
             await stat(dir);
             return { ok: false, error: 'id 已存在：' + safeId };
         }
         catch { /* 不存在，继续 */ }
+        const explicit = options && typeof options.content === 'string' ? options.content : undefined;
         let content;
-        const srcId = String(from || '');
-        if (srcId) {
-            if (!PRESET_ID_RE.test(srcId))
-                return { ok: false, error: '非法 from id：' + srcId };
-            try {
-                content = await readFile(join(deps.presetsDir, srcId, FILENAME), 'utf8');
-            }
-            catch {
-                return { ok: false, error: '来源预设不存在：' + srcId };
-            }
+        if (explicit !== undefined) {
+            content = explicit;
         }
         else {
-            content = '# AGENTS.md\n\n（DSH 全局指令基线预设，待编辑）\n';
+            const srcId = String(options && options.from ? options.from : '').trim();
+            if (srcId) {
+                const badFrom = idError(srcId);
+                if (badFrom)
+                    return { ok: false, error: '非法来源 id：' + badFrom };
+                try {
+                    content = await readFile(join(deps.presetsDir, srcId, FILENAME), 'utf8');
+                }
+                catch {
+                    return { ok: false, error: '来源预设不存在：' + srcId };
+                }
+            }
+            else {
+                content = BLANK_TEMPLATE;
+            }
         }
         await mkdir(dir, { recursive: true });
         await writeFile(join(dir, FILENAME), content, 'utf8');
         return { ok: true, id: safeId };
     }
-    async function update(id, content) {
-        const safeId = String(id || '');
-        if (!PRESET_ID_RE.test(safeId))
-            return { ok: false, error: '非法 id（仅允许小写字母、数字、连字符）：' + safeId };
+    /**
+     * 保存预设：正文写入 + 可选**改名**（目录改名，内容随目录一起走）。
+     * 改名冲突（目标已存在）直接拒绝，不合并、不覆盖。
+     */
+    async function update(id, content, nextId) {
+        const bad = idError(id);
+        if (bad)
+            return { ok: false, error: '非法 id：' + bad };
+        const safeId = String(id ?? '').trim();
         const dir = join(deps.presetsDir, safeId);
         try {
             await stat(dir);
@@ -137,13 +160,64 @@ export function createAgentsMdService(_ctx, deps) {
         catch {
             return { ok: false, error: '预设不存在：' + safeId };
         }
-        await writeFile(join(dir, FILENAME), String(content ?? ''), 'utf8');
-        return { ok: true, id: safeId };
+        let targetId = safeId;
+        if (nextId !== undefined && String(nextId).trim() !== safeId) {
+            const badNext = idError(nextId);
+            if (badNext)
+                return { ok: false, error: '非法新 id：' + badNext };
+            targetId = String(nextId).trim();
+            const nextDir = join(deps.presetsDir, targetId);
+            try {
+                await stat(nextDir);
+                return { ok: false, error: '新 id 已存在：' + targetId };
+            }
+            catch { /* 可用 */ }
+            try {
+                await rename(dir, nextDir);
+            }
+            catch (e) {
+                return { ok: false, error: '改名失败：' + message(e) };
+            }
+        }
+        await writeFile(join(deps.presetsDir, targetId, FILENAME), String(content ?? ''), 'utf8');
+        return { ok: true, id: targetId, ...(targetId === safeId ? {} : { renamedFrom: safeId }) };
+    }
+    /**
+     * 覆盖写全局 `~/.dsh/AGENTS.md` 前的备份（多代 + `__last-applied__` 维护）。
+     * **必须留多代**：只有单个 `__last-applied__` 槽位时，连续写两次就会把用户原始手写内容
+     * 永久覆盖掉（第一次备份原始内容 → 第二次备份第一个预设），而「应用」只是点两下按钮。
+     * @returns 是否真的备份了（当前文件存在才备份）。
+     */
+    async function backupGlobal(current) {
+        if (current === null)
+            return false;
+        const backupDir = join(deps.presetsDir, LAST_APPLIED_ID);
+        await mkdir(backupDir, { recursive: true });
+        const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+        await writeFile(join(backupDir, `${FILENAME}.bak-${stamp}`), current, 'utf8');
+        await writeFile(join(backupDir, FILENAME), current, 'utf8');
+        try {
+            const gens = (await readdir(backupDir)).filter((n) => n.startsWith(FILENAME + '.bak-')).sort();
+            for (const stale of gens.slice(0, Math.max(0, gens.length - KEEP_GLOBAL_BACKUPS))) {
+                await rm(join(backupDir, stale), { force: true });
+            }
+        }
+        catch { /* 轮转失败不影响本次写入 */ }
+        return true;
+    }
+    async function readGlobal() {
+        try {
+            return await readFile(await deps.getGlobalAgentsMdPath(), 'utf8');
+        }
+        catch {
+            return null;
+        }
     }
     async function apply(id) {
-        const safeId = String(id || '');
-        if (!PRESET_ID_RE.test(safeId))
-            return { ok: false, error: '非法 id（仅允许小写字母、数字、连字符）：' + safeId };
+        const bad = idError(id);
+        if (bad)
+            return { ok: false, error: '非法 id：' + bad };
+        const safeId = String(id ?? '').trim();
         let content;
         try {
             content = await readFile(join(deps.presetsDir, safeId, FILENAME), 'utf8');
@@ -151,20 +225,27 @@ export function createAgentsMdService(_ctx, deps) {
         catch {
             return { ok: false, error: '预设不存在：' + safeId };
         }
-        const globalPath = await deps.getGlobalAgentsMdPath();
-        // 备份当前全局内容（若存在）到 __last-applied__，再覆盖写入。
-        let prev = null;
+        const prev = await readGlobal();
+        const backedUp = await backupGlobal(prev);
+        await writeFile(await deps.getGlobalAgentsMdPath(), content, 'utf8');
+        return { ok: true, id: safeId, backedUp };
+    }
+    /**
+     * 按**原文**写回全局基线（不经过任何预设）。
+     * 用途：场景切换的「关掉场景 → 恢复进场景之前的基线」——那份内容可能是用户手写的，
+     * 不一定对应任何预设。备份纪律与 `apply` 完全相同。
+     */
+    async function restore(content) {
+        const text = String(content ?? '');
+        const prev = await readGlobal();
+        const backedUp = await backupGlobal(prev);
         try {
-            prev = await readFile(globalPath, 'utf8');
+            await writeFile(await deps.getGlobalAgentsMdPath(), text, 'utf8');
         }
-        catch { /* 当前不存在，不备份 */ }
-        if (prev !== null) {
-            const backupDir = join(deps.presetsDir, LAST_APPLIED_ID);
-            await mkdir(backupDir, { recursive: true });
-            await writeFile(join(backupDir, FILENAME), prev, 'utf8');
+        catch (e) {
+            return { ok: false, error: '写入全局 AGENTS.md 失败：' + message(e) };
         }
-        await writeFile(globalPath, content, 'utf8');
-        return { ok: true, id: safeId, backedUp: prev !== null };
+        return { ok: true, backedUp };
     }
     async function getCurrent() {
         try {
@@ -185,7 +266,7 @@ export function createAgentsMdService(_ctx, deps) {
             }
             catch { /* 库不存在 */ }
             for (const e of entries) {
-                if (!e.isDirectory() || !PRESET_ID_RE.test(e.name) || e.name === LAST_APPLIED_ID)
+                if (!e.isDirectory() || !isValidPresetId(e.name) || e.name === LAST_APPLIED_ID)
                     continue;
                 let c;
                 try {
@@ -205,12 +286,17 @@ export function createAgentsMdService(_ctx, deps) {
             return { ok: false, error: message(e) };
         }
     }
+    /**
+     * 删除预设 = **移入回收站**（整个 `agents-md/<id>/` 目录搬走）。
+     * 备份槽 `__last-applied__` 不可删；正在生效的预设由调用方先拦（见 index.ts）。
+     */
     async function remove(id) {
-        const safeId = String(id || '');
+        const safeId = String(id ?? '').trim();
         if (safeId === LAST_APPLIED_ID)
             return { ok: false, error: '备份槽不可删除' };
-        if (!PRESET_ID_RE.test(safeId))
-            return { ok: false, error: '非法 id（仅允许小写字母、数字、连字符）：' + safeId };
+        const bad = idError(safeId);
+        if (bad)
+            return { ok: false, error: '非法 id：' + bad };
         const dir = join(deps.presetsDir, safeId);
         try {
             await stat(dir);
@@ -218,14 +304,51 @@ export function createAgentsMdService(_ctx, deps) {
         catch {
             return { ok: false, error: '预设不存在：' + safeId };
         }
-        await rm(dir, { recursive: true, force: true });
+        const moved = await moveToTrash('agents-md', safeId, [{ from: dir, dest: 'preset' }]);
+        if (moved.ok === false)
+            return { ok: false, error: '移入回收站失败：' + moved.error };
         return { ok: true, id: safeId };
     }
+    async function trashList() {
+        return { ok: true, trash: await listTrashEntries('agents-md') };
+    }
+    /** 从回收站恢复预设：同 id 已存在时**拒绝**（绝不覆盖）。 */
+    async function trashRestore(id) {
+        const entry = await readTrashEntry('agents-md', String(id ?? '').trim());
+        if (!entry)
+            return { ok: false, error: '回收站条目不存在：' + String(id ?? '').trim() };
+        const bad = idError(entry.name);
+        if (bad)
+            return { ok: false, error: '回收站里的 id 不合法：' + bad };
+        const target = join(deps.presetsDir, entry.name);
+        try {
+            await stat(target);
+            return { ok: false, error: '无法恢复，同 id 预设已存在：' + entry.name };
+        }
+        catch { /* 可用 */ }
+        try {
+            await mkdir(deps.presetsDir, { recursive: true });
+            await moveOutOfTrash('agents-md', entry.id, 'preset', target);
+        }
+        catch (e) {
+            return { ok: false, error: '恢复失败：' + message(e) };
+        }
+        await purgeTrashEntry('agents-md', entry.id);
+        return { ok: true, id: entry.name };
+    }
+    async function trashDelete(id) {
+        const clean = String(id ?? '').trim();
+        const gone = await purgeTrashEntry('agents-md', clean);
+        if (!gone)
+            return { ok: false, error: '回收站条目不存在：' + clean };
+        return { ok: true, id: clean };
+    }
     // 从外部文本内容（如导入的 .md 文件）建预设：id 校验 + 重复检查 + 写 AGENTS.md。
     async function importPreset(id, content) {
-        const safeId = String(id || '');
-        if (!PRESET_ID_RE.test(safeId))
-            return { ok: false, error: '非法 id（仅允许小写字母、数字、连字符）：' + safeId };
+        const bad = idError(id);
+        if (bad)
+            return { ok: false, error: '非法 id：' + bad };
+        const safeId = String(id ?? '').trim();
         const dir = join(deps.presetsDir, safeId);
         try {
             await stat(dir);
@@ -236,5 +359,5 @@ export function createAgentsMdService(_ctx, deps) {
         await writeFile(join(dir, FILENAME), String(content ?? ''), 'utf8');
         return { ok: true, id: safeId };
     }
-    return { list, read, create, update, apply, getCurrent, remove, importPreset };
+    return { list, read, create, update, apply, restore, getCurrent, remove, trashList, trashRestore, trashDelete, importPreset };
 }