dsh-plugin-tool-management 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -10,6 +10,54 @@
 
 ---
 
+## [0.8.0] - 2026-09-15
+
+### 新增
+
+- 场景锁定：锁定后 MCP / 技能 / 子智能体 / 记忆 / 提示词五个域整体只读；未启动不能上锁，锁定中不能关闭或切换，先解锁再改。
+- 子智能体开关：停用的人设不注入上下文、模型不可见（文件不动）；新建 / 导入 / 回收站恢复的人设自动启用，首次升级全部启用。
+- 场景联动：启动场景时档案勾选的子智能体自动启用，退出按快照精确停回。
+- 子智能体人设目录进入系统提示词：只列名字 + 描述，正文仅在委派时传给子代理。
+- MCP 服务器状态与用户备注进入系统提示词：只列当前真正可用的 server，备注作为决策提示带给模型。
+- 四个管理域补上导出（技能 / 子智能体 / 提示词 / 记忆）：勾选条目打包 zip 写到指定目录，只读源文件。
+- 提示词预设支持描述：只显示在插件界面，不写进 AGENTS.md。
+
+### 变更
+
+- 导出弹窗重做：固定宽高、默认不勾选、条目分组折叠（技能按来源文件夹、记忆按场景、会话按工作区目录），组内同名条目全部展示。
+- 导入入口统一：提示词补上与技能页同源的导入弹窗；四个导入弹窗一律用「文件要求」清单。
+- 删除场景不再要求先清空：连它下面的全部记忆一起进同一条回收站条目，恢复按原路径整条放回；使用中的场景仍拒绝删除。
+- 场景名与人设名可以改了：改名连带目录与档案绑定同步；保留场景、重名、正在使用的场景明确拒绝。
+- 场景开关成为唯一入口：打开 = 进入场景（应用档案 + 启用），关闭 = 恢复全局默认；「退出模式」与开关走同一条路径。
+- 记忆改为单一真相源 `enabled`：档案弹窗的勾选就是记忆自身的开关；新建与导入的记忆默认不开启。
+- 提示词「应用」生效时机口径修正：下一轮对话即生效（宿主每轮重读 AGENTS.md），不再说「新会话生效」。
+- 技能回收站弹窗重做：上下两块（目录 / 技能）各占一半、各自滚动，两组的后果差异写进界面；入口移到工具栏。
+- MCP 新增默认级别改为全局；「Profile 级」更名「应用级」，级别下拉全局在上。
+- 界面统一化：按钮四级语义、列表类弹窗固定尺寸且只允许列表层滚动、工具栏顺序固定、命名统一「新增 / 导入 / 导出 + 页名」；提示词 / 子智能体页补统计行。
+- 备注输入框加 200 字上限，备注标签如实说明（会随请求发送给模型）。
+
+### 修复
+
+- 进 / 退模式报 EPERM 且开关要点两次：索引与技能管理状态的原子写遇文件占用（EPERM/EACCES/EBUSY）自动重试。
+- 退出场景模式后 MCP 服务器级与技能目录不回滚：快照的服务器级 / 来源级名单在读盘时被剥掉，现在原样保留。
+- 列表类弹窗条目多时看不到滚动条：列表组被 flex 收缩后条目直接被裁掉；现在列表层正常滚动并带常驻细滚动条。
+- 顶部「当前模式」横幅永远不显示：开关与按钮各写一个状态、互不同步，现在两者恒等。
+- 长文本排版错位与截断丢失：标题截断补齐并加 `title` 提示。
+- 历史页两个工作区分组标签区分无实际意义，统一为「已移除」。
+- 兼容页把 semver 上界当受支持版本展示。
+- 清理 CSS 死规则、未定义类名与 i18n 死键；滚动容器改为向上查找。
+
+### 移除
+
+- 「切入此模式」按钮（开关承担）。
+- 场景档案的 `memories` 段：老档案里的该字段被忽略，不做自动迁移。
+- `memoryAllowed` / `computeMemoriesPlan`（单一真相源后不再需要）。
+
+### 说明
+
+- 新建记忆默认不开启是行为变更：已有记忆的 `enabled` 原样保留，不受影响。
+- 老数据里 `mode.scene` 与 `active` 可能不一致：不做一次性迁移，下次拨动任一场景开关时自然对齐。
+
 ## [0.7.0] - 2026-09-15
 
 ### 新增

package/README.md

@@ -37,8 +37,9 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest
 | 能力 | 说明 |
 |---|---|
 | 场景记忆 | 启用场景里的 `.md` 正文**自动进系统提示词**，下一个请求即生效 |
-| 场景档案 | 每个场景自由搭配 **MCP 工具集 / 技能集 / 子智能体 / 记忆**；可「切入模式」一键收窄 |
+| 场景档案 | 每个场景自由搭配 **MCP 工具集 / 技能集 / 子智能体 / 记忆**；打开场景即应用，关闭按快照恢复 |
 | 场景提示词 | 场景绑一份提示词预设，切换场景直接改写 `~/.dsh/AGENTS.md`（关掉自动恢复） |
+| 场景锁定 | 锁住一个场景 = **五个管理域整体只读**（勾没勾的都不能动）；未启动不能上锁，锁定中关不掉，先解锁再改 |
 | MCP 工具级开关 | 单台服务器里**单个工具**可独立启停：模型看不见也调不到 |
 | 重启语义 | 重启只重连，**不改变启停状态** |
 | 密钥安全 | 密钥默认打码；「显示密钥」与导出**必须带令牌**——没配 `token` 就不给明文 |
@@ -47,7 +48,9 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest
 | AGENTS.md 预设 | 多套全局基线，一键应用，保留 5 代备份 |
 | 归档会话 | 按项目分组、批量恢复 / 删除、保留期清理；工作区登记被删后可重建 |
 | 对话导入导出 | 接管 Claude Code / Cursor / Codex / 任意文本；导出 Markdown / JSONL |
-| 子智能体 | 一个文件一个人设，即用即弃不进 History，自动继承场景记忆 |
+| 导入导出成对 | 技能 / 子智能体 / 提示词 / 记忆都有导出：勾选条目 → 打包 zip 到指定目录（只读源文件） |
+| 子智能体 | 一个文件一个人设，**启停开关**决定是否注入上下文；即用即弃不进 History，自动继承场景记忆 |
+| 上下文可见性 | 人设目录与「当前可用的 MCP server + 你的备注」进入系统提示词，模型自己知道有什么可用 |
 | 前缀缓存友好 | 注入段只由「启用场景 + 文件内容」决定，逐字节稳定 |
 | 兼容体检 | 「兼容」页一屏看清宿主能力、每个动作走原生还是适配、哪些降级 |
 | 模型工具 | **14 个**（`skill_mcp_manager_*` / `skill_manager_*` / `agentsmd_*` / `rule_manager_*` / `subagent_*`） |
@@ -83,15 +86,20 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest
 - **场景 = 分组，记忆 = `.md` 文件**。`memories/<场景>/<名>.md`，整篇正文自动进系统提示词，文件名支持中文。
 - **单选启用**：同时只启用一个场景（其余置灰），关掉全部 = 只注入「全局」与 `_shared`。新场景默认不启动。
 - **场景绑提示词**：切换场景直接改写 `~/.dsh/AGENTS.md`（覆盖前 5 代备份，关掉自动恢复基线）。
-- **场景档案**：每个场景搭配 MCP 工具集 / 技能集 / 子智能体 / 记忆（任意组合）；可「切入模式」一键应用并收窄注入，退出按快照原文恢复。
+- **场景档案**：每个场景搭配 MCP 工具集 / 技能集 / 子智能体 / 记忆（任意组合）；打开场景即应用并收窄注入，关闭按快照原文恢复（开关是唯一入口）。
 - **导入**：`.md` / `.zip`（目录名 = 场景，bundle 带附件），同名跳过绝不覆盖，超限逐条回报。
+- **导出**：勾选记忆打包成 zip，保留「场景/名称」层级；bundle 型连目录里的附件一起打进去。只读源文件。
 - **注入预算**：默认 64 KiB，放不下的跳过并列出清单。删除进回收站。
+- **场景锁定**：锁定后 MCP / 技能 / 子智能体 / 记忆 / 提示词整体只读，界面禁用 + 服务端守卫双侧拦截；未启动不能上锁，锁定中不能关闭，先解锁再改。
+- **删除场景 = 连记忆一起删**：场景记录、档案与全部记忆进同一条回收站条目，恢复按原路径整条放回；使用中的场景拒绝删除。场景名可改（连带目录与档案，记忆正文不动）。
 
 ### 子智能体
 
 - **一个文件一个人设**：`agents/<人设>.md`，frontmatter 全可选。
 - **工具限制按 Agent 预设**：每个预设一份白/黑名单（互相排斥），运行期按当前预设生效——堵掉旧「全体并集」名单换预设后子代理起不来的坑。
 - **即用即弃**：`subagent_run` 带人设运行、只回传结果、不进 History，自动继承场景记忆。场景可绑定可用人设。
+- **启停开关**：停用的人设不注入上下文、模型不可见（文件不动）；新建 / 导入 / 恢复自动启用。启动场景时档案勾选的人设自动启用，退出按快照精确停回。
+- **人设目录进系统提示词**：只列名字 + 描述，模型知道有哪些人设可委派；人设名可改，场景绑定自动跟着改。
 
 ### MCP 服务
 
@@ -99,17 +107,19 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest
 - **工具级开关**：单个工具可独立停用（模型看不见也调不到），整台支持批量。
 - **密钥打码**：默认 `••••••`，「显示密钥」要令牌。
 - **迁移与备份**：跨项目级/全局迁移失败自动回滚；JSON 导出导入。
+- **状态与备注进系统提示词**：只列当前真正可用的 server，你的备注作为决策提示带给模型；级别分「全局 / 应用级」，新增默认全局。
 
 ### 技能
 
 - **来源一览**：项目级 / DSH / Agents / Codex / Claude / 自定义目录，按来源分组。
 - **两组权限相反**：默认来源（DSH / 导入技能）必须读取但技能可删；外部目录可停用/移除但技能只读。
 - **移除 ≠ 停用**：移除 = 连目录都不扫（文件零改动，可恢复）；停用 = 仍列出但不可调用。
-- **同名自选 / 自定义目录 / ZIP 导入 / 回收站**。
+- **同名自选 / 自定义目录 / ZIP 导入导出 / 回收站**。
 
 ### 提示词预设
 
-- 多套 `~/.dsh/AGENTS.md` 基线，一键应用（新会话生效，当前会话不变），保留 5 代备份。
+- 多套 `~/.dsh/AGENTS.md` 基线，一键应用（宿主每轮重读该文件，下一轮对话生效），保留 5 代备份。
+- **描述**：每条预设可写一句「这份是干什么的」，只显示在插件界面里；它存在同目录的 `meta.json`，不进 AGENTS.md，也就不会被注入提示词。
 - 新建即可写正文，编辑可改 id（= 目录改名，场景绑定自动跟着改）。正在生效的不能删；删除进回收站。
 
 ### 历史会话
@@ -135,6 +145,7 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest
 | MCP 定义 | `cordis.patch.yml`（改前自动 `.bak`） |
 | 技能策略 / 自定义目录 | `~/.dsh/tool-management/state.json` |
 | 技能 / 记忆 / 人设 / 预设 | `~/.dsh/tool-management/{skills,memories,agents,agents-md}/` |
+| 子智能体启停 | `~/.dsh/tool-management/agents-index.json` |
 | 回收站 | `~/.dsh/tool-management/trash/` |
 | 归档账本 / 保留期 | `~/.dsh/tool-management/history-*.json` |
 | 记忆索引 / 场景 / 档案 | `~/.dsh/tool-management/rules-index.json` |

package/README_EN.md

@@ -37,8 +37,9 @@ Hard-refresh the browser (Cmd/Ctrl+Shift-R) afterwards — a **Tools** panel in
 | Capability | Description |
 |---|---|
 | Scene memory | `.md` bodies in an enabled scene are **injected into the system prompt**, effective on the next request |
-| Scene profile | Every scene freely combines **MCP tools / skills / subagents / memories**; "Enter mode" narrows injection in one click |
+| Scene profile | Every scene freely combines **MCP tools / skills / subagents / memories**; opening a scene applies it, closing restores from the snapshot |
 | Scene prompt | A scene can bind a prompt preset; switching scenes rewrites `~/.dsh/AGENTS.md` (auto-restores on exit) |
+| Scene lock | Locking a scene freezes **all five domains read-only** (bound entries or not); a scene must be running to lock, and a locked scene can't be turned off — unlock first |
 | Per-tool switches | **Individual tools** inside one MCP server can be disabled: invisible to the model, blocked at call time |
 | Restart semantics | Restart only reconnects — it **never flips the enabled state** |
 | Secret safety | Secrets masked by default; "Reveal" & export **require a token** — no `token` configured means no plaintext |
@@ -47,7 +48,9 @@ Hard-refresh the browser (Cmd/Ctrl+Shift-R) afterwards — a **Tools** panel in
 | AGENTS.md presets | Multiple global baselines, one-click apply, 5-generation backup |
 | Archived sessions | Grouped by project, batch restore / delete, retention cleanup; rebuildable after workspace deletion |
 | Transcript import/export | Take over Claude Code / Cursor / Codex / any text; export Markdown / JSONL |
-| Subagents | One file per persona, run-and-discard, never enters History, inherits scene memories |
+| Import pairs with export | Skills / subagents / prompts / memories all export too: pick items → zip into a directory you choose (read-only on sources) |
+| Subagents | One file per persona, with an **on/off toggle** deciding whether it is injected; run-and-discard, never enters History, inherits scene memories |
+| Context visibility | The persona catalog and "currently usable MCP servers + your notes" enter the system prompt, so the model knows what is available |
 | Prefix-cache friendly | Section text depends only on enabled scenes + file contents, byte-stable |
 | Compatibility check | The **Host** tab shows host capabilities, per-action routing, and degradations at a glance |
 | Model tools | **14** (`skill_mcp_manager_*` / `skill_manager_*` / `agentsmd_*` / `rule_manager_*` / `subagent_*`) |
@@ -83,15 +86,20 @@ The model can manage everything above via 14 tools (see highlights); scripts use
 - **A scene = a group, a memory = a `.md` file**. `memories/<scene>/<name>.md`, the whole body is injected, file names can be non-ASCII.
 - **Single-choice toggle**: only one scene at a time (others greyed out); turning all off = only `global` and `_shared` inject. New scenes start off.
 - **Scene-bound prompt**: switching scenes rewrites `~/.dsh/AGENTS.md` (5-gen backup, auto-restore on exit).
-- **Scene profile**: every scene combines MCP tools / skills / subagents / memories (any mix); "Enter mode" applies and narrows in one click, exit restores verbatim.
+- **Scene profile**: every scene combines MCP tools / skills / subagents / memories (any mix); opening a scene applies and narrows injection, closing restores verbatim (the toggle is the only entry).
 - **Import**: `.md` / `.zip` (dir name = scene, bundles carry attachments), same names skipped never overwritten, over-limit items reported.
+- **Export**: pick memories and zip them, keeping the `scene/name` layout; bundle memories bring their attachments along. Sources are read-only.
 - **Injection budget**: default 64 KiB, oversized memories skipped with a list. Deletes go to recycle bin.
+- **Scene lock**: once locked, MCP / skills / subagents / memories / prompts are read-only — UI disabled plus a server-side guard; a scene must be running to lock, and a locked scene can't be closed until unlocked.
+- **Deleting a scene deletes its memories too**: the scene record, profile and every memory go into one recycle-bin entry, restored as a whole; a running scene refuses deletion. Scene names are renameable (dir and profile follow, memory bodies untouched).
 
 ### Subagents
 
 - **One file per persona**: `agents/<persona>.md`, frontmatter entirely optional.
 - **Tool limits per Agent preset**: each preset gets its own allow/deny list (mutually exclusive), effective at runtime by the current preset — fixes the old "union of all presets" list that broke subagents after a preset switch.
 - **Run and discard**: `subagent_run` runs with the persona, returns only the result, never enters History, inherits scene memories. Scenes can bind which personas are available.
+- **On/off toggles**: a disabled persona is not injected and invisible to the model (file untouched); newly created / imported / restored personas start enabled. Starting a scene auto-enables the personas its profile binds; exit restores precisely from the snapshot.
+- **Persona catalog enters the system prompt**: names + descriptions only, so the model knows what it can delegate to; personas are renameable, scene bindings follow.
 
 ### MCP servers
 
@@ -99,17 +107,19 @@ The model can manage everything above via 14 tools (see highlights); scripts use
 - **Per-tool switches**: disable individual tools (invisible to the model, blocked at call), whole-server batch.
 - **Secret masking**: defaults to `••••••`, "Reveal" needs a token.
 - **Migrate & back up**: cross-project/global migration rolls back on failure; JSON export/import.
+- **Status & notes enter the system prompt**: only currently usable servers are listed, and your notes travel along as decision hints; levels are "global / app", new servers default to global.
 
 ### Skills
 
 - **Sources at a glance**: project / DSH / Agents / Codex / Claude / custom dirs, grouped by source.
 - **Opposite permissions**: default sources must be read but skills can be deleted; external dirs can be disabled/removed but skills are read-only.
 - **Remove ≠ disable**: remove = directory not scanned at all (files untouched, restorable); disable = still listed but not callable.
-- **Same-name picker / custom dirs / ZIP import / recycle bin**.
+- **Same-name picker / custom dirs / ZIP import & export / recycle bin**.
 
 ### Prompt presets
 
-- Multiple `~/.dsh/AGENTS.md` baselines, one-click apply (new sessions only, current unchanged), 5-gen backup.
+- Multiple `~/.dsh/AGENTS.md` baselines, one-click apply (the host re-reads that file every turn, so it takes effect on the next turn), 5-gen backup.
+- **Description**: one line saying what a preset is for — shown in this panel only. It lives in a sibling `meta.json`, never in AGENTS.md, so it is never injected into prompts.
 - Create with body inline, edit can change id (= dir rename, scene bindings follow). Active preset can't be deleted; deletes go to recycle bin.
 
 ### Archived sessions
@@ -135,6 +145,7 @@ The plugin uses the host's own `@deepseek-ai/*` libraries at runtime — they mu
 | MCP definitions | `cordis.patch.yml` (auto `.bak` before rewrite) |
 | Skill policy / custom dirs | `~/.dsh/tool-management/state.json` |
 | Skills / memories / personas / presets | `~/.dsh/tool-management/{skills,memories,agents,agents-md}/` |
+| Subagent toggles | `~/.dsh/tool-management/agents-index.json` |
 | Recycle bin | `~/.dsh/tool-management/trash/` |
 | Archive ledger / retention | `~/.dsh/tool-management/history-*.json` |
 | Memory index / scenes / profiles | `~/.dsh/tool-management/rules-index.json` |

package/docs/update.md

@@ -4,6 +4,7 @@
 
 | 版本 | 发布 | 主题 |
 |---|---|---|
+| [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 | 场景档案默认不勾选 + 场景页排版重做 |
@@ -12,6 +13,22 @@
 
 ---
 
+## 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
 
 - 回收站扩到子智能体 / 场景 / 提示词预设（删除都进回收站，可恢复）。

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__` 是备份槽，不算用户预设。
@@ -15,6 +15,8 @@ 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';
@@ -36,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 与真正生效的预设冲突。
@@ -84,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));
@@ -142,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 };
@@ -180,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 }) };
     }
     /**
@@ -344,7 +381,7 @@ export function createAgentsMdService(_ctx, deps) {
         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 };
@@ -357,6 +394,7 @@ 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, trashList, trashRestore, trashDelete, importPreset };