dsh-plugin-tool-management 0.6.0 → 0.8.0

package/docs/update.md

@@ -1,54 +1,72 @@
 # 版本更新概要
 
-每个版本**大致改了什么**——想知道「升上去会变什么」看这里就够了。
-逐条细节、边界与已知限制见 [Changelog](./Changelog.md)；功能说明见 [README](../README.md) / [README_EN](../README_EN.md)。
-
-> 版本号 = npm 上实际发布的发布号（`npm view dsh-plugin-tool-management versions`）。
-> 日期 = npm 发布时刻（**UTC**）；本地时间（UTC+8）比它晚 8 小时。
-> 开发期的内部编号 `v0.3` / `v0.4` 没有单独发布，内容随 v0.5.0 一起出去。
+每个版本大致改了什么——想知道「升上去会变什么」看这里就够了。逐条细节见 [Changelog](../CHANGELOG.md)，功能说明见 [README](../README.md) / [README_EN](../README_EN.md)。
 
 | 版本 | 发布 | 主题 |
 |---|---|---|
-| [v0.6.0](#v0602026-09-14) | 2026-09-14 | 宿主兼容体检 + 「兼容」页 |
-| [v0.5.1](#v0512026-09-13) | 2026-09-13 | 场景档案默认不勾选 + 场景页排版重做 |
-| [v0.5.0](#v0502026-09-13) | 2026-09-13 | 数据目录统一 + 场景显式化 + 界面重做 |
-| [v0.2.0 及更早](#v020-及更早2026-09-12) | 2026-09-12 | 五域合并进一个「工具」面板 |
+| [0.8.0](#080---2026-09-15) | 2026-09-15 | 场景锁定 + 子智能体开关 + 四域导出 |
+| [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 | 五域合并进一个「工具」面板 |
 
 ---
 
-## v0.6.0（2026-09-14）
+## 0.8.0 - 2026-09-15
+
+- **场景锁定**：锁住后 MCP / 技能 / 子智能体 / 记忆 / 提示词整体只读（勾没勾的都不能动）；未启动不能上锁，锁定中关不掉也切不走。
+- **子智能体开关**：默认只把启用的人设注入上下文；启动场景时档案勾选的人设自动启用，退出按快照精确停回。
+- **四个管理域补上导出**（技能 / 子智能体 / 提示词 / 记忆）：导出弹窗分组折叠、默认不勾选、固定尺寸；记忆按场景分组、技能按来源文件夹分组。
+- **导入入口统一**：提示词补上与技能页同源的拖拽弹窗；四个导入弹窗一律「文件要求」清单。
+- **删除场景 = 连它下面的全部记忆一起进回收站**（含未启用与 bundle 附件），恢复时整条按原路径放回。
+- **场景名、人设名现在可以改**（改名连带目录搬迁与绑定同步）。
+- **提示词预设支持描述**：只显示在插件界面里，存 `meta.json`，绝不写进 AGENTS.md。
+- 子智能体人设目录与 MCP 服务器备注进入系统提示词（模型知道有哪些人设可委派、哪些 server 可用）。
+- 修复：进/退模式报 EPERM、开关要点两次（Windows 文件占用时 rename 自动重试）。
+- 修复：退出场景模式后 MCP 服务器级与技能目录不回滚（快照字段在读盘时被剥掉）。
+- 技能回收站重做：弹窗内上下两块（目录 / 技能）、各占一半、各自滚动；「删除记录」与「永久删除」统一为红色。
+- MCP 新增默认级别改为全局；「Profile 级」改名「应用级」，全局排在上面。
+- 界面统一化：按钮四级语义、弹窗固定尺寸只允许列表层滚动、命名统一「新增 / 导入 / 导出 + 页名」。
+
+## 0.7.0 - 2026-09-15
+
+- 回收站扩到子智能体 / 场景 / 提示词预设（删除都进回收站，可恢复）。
+- 子智能体工具限制按 Agent 预设（每预设一份白/黑名单）。
+- 兼容页「预设注入边界」五列标签（绿/红/灰框）。
+- 明文密钥改为一律要令牌（没配 `token` 就不给明文）。
+- MCP「整理补丁」重新上线（删多余启停块，状态不变）。
+
+## 0.6.0 - 2026-09-14
 
-- **新增「工具 → 兼容」页**（第 8 个页签）：一屏看清宿主版本与要求范围、插件适配版本、能力可用数（如 15/15）、每个宿主动作走**原生入口 / 插件适配层 / 不可用**、以及哪些能力已降级与原因。只读体检，不改任何数据。
-- **兼容判定换底座**：不再拿**源码文本**比对官方实现（上游改一行注释就整体拒绝服务），改为「模块实体是否同一份 + 能力探测」。缺能力时按能力路由（原生 → 适配层 → 拒绝），拒绝信息写明**缺什么、后果、怎么修**，并且永远发生在**任何写入之前**。配套新增 `node scripts/doctor.mjs`（只读体检）与 `node scripts/host-deps.mjs`（把插件依赖 junction 到宿主安装，`--fix` / `--restore`）。
-- **归档会话不再丢工作区归属**：工作区登记被删除后，分组按会话目录自动重建（标「工作区已移除」/「未登记的工作区」），目录仍在时可一键**重新登记**；恢复归档会话时会顺带把它挂回工作区记账（此前恢复出来只会掉进「未分组」）。归档账本 / 保留期 / 登记快照搬出插件目录，避免 `dsh plugin update` 覆盖整个目录时丢账本。
-- **技能来源权限语义修正**：默认来源（`DSH 技能` / `导入技能`）**必须读取**——不可移除、不可停用，但**里面的技能可以删**（进回收站、可从回收站原样放回）；外部 Agent 目录与自定义目录可以停用 / 移除（不再读取），但里面的技能**只读、不能删**。顺带修好「导入技能里删掉的技能无法从回收站恢复」。
-- **切换场景 = 直接换 AGENTS.md**：启用/切换场景、改绑提示词、编辑"正在生效的那份预设"的正文，都会把那份预设**真写进 `~/.dsh/AGENTS.md`**（覆盖前多代备份，最近 5 代保留在 `agents-md/__last-applied__/`）；**关掉场景时按原文恢复进场景之前的基线**（手写内容也能原样回来）。除保留场景「全局」外**同时只能启用一个场景**（启用后其余开关置灰），**新建场景默认不启动**；场景表单里的提示词默认选中**当前生效的那份**（没有「不绑定」选项）。「提示词」页把这一份标成**「生效中」**并写明来源（`当前：life（场景「A」）`），**正在生效的那份不能删除**（按钮禁用 + 宿主拒绝），换绑或应用别的预设后即可删。「进入模式」会连同档案、记忆、提示词一起生效。
-- **提示词预设**：新建弹窗改成「id + 正文文本框」（可直接把内容粘进去，也可从现有预设复制一份再改）；编辑时 **id 与正文都能改**——改 id 就是目录改名，**场景绑定会自动跟着改**，不留悬空绑定。id 不再限定小写字母/数字/连字符，**中文、空格、点、下划线都行**（只挡路径分隔符这类文件系统非法字符与 `__last-applied__` 备份槽）。
-- **安全与界面**：插件 HTTP 路由接上宿主鉴权栅栏（Host/Origin 判定 + browser-session cookie；`token` 作为脚本与局域网部署的逃生门）；AGENTS.md 预设「应用」改为保留最近 **5 代**备份；全站 24 处弹窗的「取消 / 关闭」统一只在右上角；英文界面不再露中文（面板跟随宿主语言，会话页与 AGENTS.md 页接入词典）。
+- 新增「兼容」页（第 8 栏）+ doctor/host-deps 脚本。
+- 兼容判定从源码文本比对改为模块实体 + 能力探测。
+- 归档会话不再丢工作区归属（登记被删后重建分组 + 一键重新登记）。
+- 技能来源权限语义修正（默认来源必须读取但技能可删）。
+- 场景可绑提示词预设，切换场景直接改写 AGENTS.md（关掉自动恢复）。
+- 场景启用改单选，新场景默认不启动。
 
-## v0.5.1（2026-09-13）
+## 0.5.1 - 2026-09-13
 
-- **场景档案弹窗：新加的段默认一项都不勾**——MCP 工具集 / 技能集 / 子智能体绑定是**空集**，记忆段只预勾**本场景里已启用**的那几条；「全选」= 本场景全部。代价写进界面：空段 = 该域全部停用（子智能体段例外：空段 = 不限制）。
-- **档案弹窗「记忆」段只列被编辑场景自己的记忆**：列别的场景（含「全局」）勾了不起作用，属于陷阱，已删除；记忆描述按 80 字截断，长描述不再横向溢出段边框。
-- **场景页排版重做**：卡片只留「名字 + 标签 + 开关 / 一行描述 / 动作行」，数量收进页首「当前模式」条（只在真的进入模式后出现）；描述上限 60 字。
-- **保留场景「全局」不再出现在场景页与档案弹窗**：它恒定注入、不是可切换的预设，MCP / 技能 / 人设各有专页；标签「任何对话都注入」压成「常驻」。
-- 客户端契约测试补上「档案弹窗默认勾选」「记忆段只认本场景的记忆」「场景页不列全局」等用例；两份 README 的测试组清单同步校正。
+- 场景档案弹窗新加段默认不勾选。
+- 档案「记忆」段只列本场景的记忆。
+- 场景页排版重做（卡片只留名字+描述+动作）。
+- 保留场景「全局」不再出现在场景页与档案弹窗。
 
-## v0.5.0（2026-09-13）
+## 0.5.0 - 2026-09-13
 
-- **破坏性：数据全部收进 `~/.dsh/tool-management/`**（记忆 / 人设 / AGENTS.md 预设 / 新建导入的技能 / 回收站 / 索引 / 配置）。旧位置首次启动**自动搬入**：只搬不删、绝不覆盖、每进程一次、失败不阻断（`~/.dsh/skills/` 不搬，仍作为可切换来源）。
-- **场景从「恰好有这个名字的目录」升级为显式记录**（带描述与顺序）：空场景合法；保留场景「全局」恒在不可删；`memories/` 根层的裸 `.md` 不再注入并在体检里报 `noScene`。
-- **技能来源**：新增插件自有来源 **「导入技能」**（新建 / 导入的落点，优先级高于 `~/.dsh/skills/`）；新增 **「移除来源」** = 连目录都不再扫描（源文件一个字节都不动，可一键恢复读取）。
-- **界面**：工具页七栏；场景档案编辑器新增第 4 段「记忆」（只影响注入，不动记忆文件）；人设的模型与工具限制收进「高级选项」；四个表单的辅助提示去冗余。
-- **修掉三个真故障**：工具页整页白屏、导出静默丢失（导出写在 `apply` 方法体内，`apply` 提前返回就没落地）、技能状态文件被判非法导致 Skills 页锁死。
-- 斜杠命令 `/mcp`、`/skills`、`/agents-md`、`/scene-memory` 全部下线（面板里每一项都有等价入口）。
+- 数据全部收进 `~/.dsh/tool-management/`（旧位置自动搬入）。
+- 场景升级为显式记录；根层裸 `.md` 不再注入。
+- 新增「导入技能」来源 + 「移除来源」操作。
+- 场景档案新增第 4 段「记忆」。
+- 修掉三个真故障：整页白屏、导出静默丢失、Skills 页锁死。
+- 斜杠命令全部下线。
 
-## v0.2.0 及更早（2026-09-12）
+## 0.2.0 - 2026-09-12
 
-- 五个域合并进一个「工具」设置面板：**MCP / Skills / AGENTS.md 预设 / History（归档会话）**。
-- **MCP**：工具级独立启停（模型看不见也调不到）、重启只重连**不改变启停状态**、密钥默认打码、改写补丁前自动 `.bak`（保留 5 份）、重复 loader id 写前拦截、跨级迁移失败自动回滚。
-- **Skills**：接入 `~/.agents` / `~/.codex` / `~/.claude` 与自定义目录（只读接入、重叠拒绝）；创建 / ZIP 与文件夹导入 / 回收站；技能目录后台监听，编辑器改完自动刷新。
-- **AGENTS.md 预设库**：多套全局基线，一键「应用」写入 `~/.dsh/AGENTS.md`（新会话生效，当前会话不变）。
-- **History**：归档会话按项目分组、搜索、全选、批量恢复 / 永久删除、保留期自动清理；支持从 Claude Code / Cursor（JSONL）、Codex（Markdown）、任意文本导入；导出 Markdown / JSONL。
+- 五域合并进一个「工具」面板：MCP / Skills / AGENTS.md 预设 / History。
+- MCP 工具级启停、重启只重连、密钥打码、补丁备份。
+- Skills 接入 ~/.agents / ~/.codex / ~/.claude + 自定义目录。
+- History 按项目分组、批量操作、保留期清理、对话导入导出。
 
-> 文档对 **0.1.1 / 0.1.2 / 0.1.3** 没有独立记录（只有 git tag），因此上表不拆分它们的差异，也不补写没有证据的条目。
+> 0.1.1 / 0.1.2 / 0.1.3 无独立记录（仅 git tag）。

package/lib/agents-md/service.js

@@ -3,7 +3,7 @@
 // DSH 全局指令基线只有一个文件 ~/.dsh/AGENTS.md（USER_GLOBAL_FILE 固定），
 // 没有内置的「多份全局 AGENTS.md 切换」机制。本服务在 hub 内维护一个
 // 预设库（每套一个子目录 + AGENTS.md），「应用」= 把选中预设内容写入
-// ~/.dsh/AGENTS.md，新会话生效（当前会话不变，DSH 本身如此）。
+// ~/.dsh/AGENTS.md，下一轮对话生效（宿主每个 agent/pre-step 都会 stat 并重读该文件）。
 //
 // id 即目录名：字符集口径见 `./preset-id.ts`（用户裁定「什么都能写」，只留
 // 文件系统安全约束）；`__last-applied__` 是备份槽，不算用户预设。
@@ -13,7 +13,10 @@ import { mkdir, readdir, readFile, rename, rm, stat, writeFile } from 'node:fs/p
 import { join } from 'node:path';
 import { createHash } from 'node:crypto';
 import { isValidPresetId, LAST_APPLIED_PRESET_ID, normalizePresetId } from './preset-id.js';
+import { listTrashEntries, moveOutOfTrash, moveToTrash, purgeTrashEntry, readTrashEntry } from '../hub.js';
 const FILENAME = 'AGENTS.md';
+/** 描述侧车：与 AGENTS.md 同目录，避免把「只给使用者看」的文字注入提示词。 */
+const META_FILE = 'meta.json';
 const LAST_APPLIED_ID = LAST_APPLIED_PRESET_ID;
 /** 新建预设的初始正文（空模板）；用户也可以直接粘贴自己的内容。 */
 const BLANK_TEMPLATE = '# AGENTS.md\n\n（DSH 全局指令基线预设，待编辑）\n';
@@ -35,6 +38,38 @@ export function createAgentsMdService(_ctx, deps) {
             return null;
         }
     }
+    // ── 描述（「只给使用者看」）────────────────────────────────────────────────
+    // 存在预设目录的 `meta.json` 里，**不写进 AGENTS.md**：那个文件的正文会被原样注入
+    // 系统提示词，把「这份预设是干什么的」写进去等于凭空给模型加了一段说明。
+    // 读写都 best-effort：描述坏掉/写不进去不该让「保存预设」失败（正文才是本体）。
+    async function readDescription(id) {
+        try {
+            const raw = await readFile(join(deps.presetsDir, id, META_FILE), 'utf8');
+            const parsed = JSON.parse(raw);
+            return typeof parsed.description === 'string' ? parsed.description : '';
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * 写描述。`undefined` = 不动（老调用方 / 只想改正文时不该顺手把描述抹掉），
+     * 空串 = 明确清空（连文件一起删，避免留一个空壳 meta.json）。
+     */
+    async function writeDescription(id, description) {
+        if (description === undefined)
+            return;
+        const text = String(description).trim();
+        const file = join(deps.presetsDir, id, META_FILE);
+        try {
+            if (text === '') {
+                await rm(file, { force: true });
+                return;
+            }
+            await writeFile(file, JSON.stringify({ description: text }, null, 2) + '\n', 'utf8');
+        }
+        catch { /* 描述写不进去不该让保存失败 */ }
+    }
     // 幂等初始化：仅当库完全无预设且全局 AGENTS.md 存在时，拷贝全局为 default
     // 预设（首次运行引导）。用户已 create/apply 过任何预设则不插手，避免把
     // 当前生效内容误存成 default 与真正生效的预设冲突。
@@ -83,6 +118,7 @@ export function createAgentsMdService(_ctx, deps) {
                 return {
                     id,
                     active: globalHash !== null && contentHash !== null && globalHash === contentHash,
+                    description: await readDescription(id),
                 };
             }));
             presets.sort((a, b) => a.id.localeCompare(b.id));
@@ -141,13 +177,14 @@ export function createAgentsMdService(_ctx, deps) {
         }
         await mkdir(dir, { recursive: true });
         await writeFile(join(dir, FILENAME), content, 'utf8');
+        await writeDescription(safeId, options?.description);
         return { ok: true, id: safeId };
     }
     /**
      * 保存预设：正文写入 + 可选**改名**（目录改名，内容随目录一起走）。
      * 改名冲突（目标已存在）直接拒绝，不合并、不覆盖。
      */
-    async function update(id, content, nextId) {
+    async function update(id, content, nextId, description) {
         const bad = idError(id);
         if (bad)
             return { ok: false, error: '非法 id：' + bad };
@@ -179,6 +216,7 @@ export function createAgentsMdService(_ctx, deps) {
             }
         }
         await writeFile(join(deps.presetsDir, targetId, FILENAME), String(content ?? ''), 'utf8');
+        await writeDescription(targetId, description);
         return { ok: true, id: targetId, ...(targetId === safeId ? {} : { renamedFrom: safeId }) };
     }
     /**
@@ -285,6 +323,10 @@ 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 ?? '').trim();
         if (safeId === LAST_APPLIED_ID)
@@ -299,11 +341,47 @@ 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) {
+    async function importPreset(id, content, description) {
         const bad = idError(id);
         if (bad)
             return { ok: false, error: '非法 id：' + bad };
@@ -316,7 +394,8 @@ export function createAgentsMdService(_ctx, deps) {
         catch { /* 不存在，继续 */ }
         await mkdir(dir, { recursive: true });
         await writeFile(join(dir, FILENAME), String(content ?? ''), 'utf8');
+        await writeDescription(safeId, description);
         return { ok: true, id: safeId };
     }
-    return { list, read, create, update, apply, restore, getCurrent, remove, importPreset };
+    return { list, read, create, update, apply, restore, getCurrent, remove, trashList, trashRestore, trashDelete, importPreset };
 }