dsh-plugin-tool-management 0.8.5 → 0.9.1

package/CHANGELOG.md

@@ -1,206 +1,275 @@
-# 变更日志
-
-本文件记录本项目的所有重要变更。
-
-格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循[语义化版本](https://semver.org/lang/zh-CN/)。
-
-- 只想看「大致改了什么」→ [版本更新概要](docs/update.md)
-- 功能说明与用法 → [README](README.md) / [README_EN](README_EN.md)
-- 工程细节（根因分析、实测数据、设计取舍）在 git 历史里，不在这里。
-
----
-
-## [0.8.5] - 2026-09-16
-
-### 新增
-
-- 场景级 MCP 服务器备注：场景档案的 MCP 段可为每台勾选的服务器写专属备注，进入该场景时覆盖全局备注（写入 notes.json），退出场景时按快照恢复改动前的备注；未配场景备注的服务器照常使用全局备注。
-- 未运行服务器的工具可见性：新增「已知工具」侧车（`dsh-plugin-tool-management-mcp-tools.json`），枚举到 live 工具时按服务器记下名单——未运行的服务器不再永远显示 0 工具，工具勾选框也能列出最后一次见过的工具。从未运行过的服务器可在编辑弹窗点「启动服务器读取工具」：临时启用、轮询等工具注册（≤30s）、记入名单后恢复原启停状态。
-
-### 变更
-
-- 新增技能 / 子智能体 / MCP 一律默认不启动（用户裁定，三域同口径）：新建与导入的技能显式写入停用名单；新建/导入/回收站恢复的人设默认停用；新增 MCP 服务器创建即停用（显式传 `enabled: true` 才创建即启动）。启动与否由用户手动开启。
-- 场景档案 MCP「编辑」弹窗重做：行内备注输入框移除，「选工具」改为「编辑」，点击打开固定尺寸次级弹窗——第一栏备注、第二栏工具勾选（含全选/清空），有备注的服务器行显示「有备注」标签。
-- 系统提示词注入段文案优化：子智能体人设段措辞改为「可从下面的人设中选用」（此前读起来像"只能调用这几个"），并补充委派机制说明；场景记忆段标题下加固定引导语，让模型明确这是当前场景的常驻参考知识；MCP 备注前缀由「用户备注：」统一为「备注：」。
-- peer 依赖去掉 semver 上界（`>=0.1.5-rc.2 <0.2.0-0` → `>=0.1.5-rc.2`）：宿主跨 minor 升级不再被 pnpm peer 校验挡住安装，兼容性改由运行时能力探测兜底。
-
-### 修复
-
-- 历史页「已移除」标签红灰两色统一为灰色：此前红色 = 从未登记、灰色 = 曾登记被移除，颜色区分无实际意义。
-- 目录真实存在但没有「重新登记」按钮：`canRegister` 判定从「宿主会话索引命中」放宽为「磁盘目录真实存在」（带 stat 缓存，同一目录只探一次盘），与 `registerWorkspace` 的 realpath 目录校验一致——目录在即可一键重新登记；目录已删除的组显示「⚠ 目录已不存在」提示。
-- MCP 状态段缓存不刷新：MCP 工具加载完成（`tools/change`）与进/退/切换场景后均主动重算状态段——此前段停留在「空/旧集合」的缓存值，出现「切换 MCP 后系统提示词没有 MCP 段」「退出场景后备注看似没恢复」的现象。
-- 退出场景备注永不回退：rules-index.json 读盘时的快照规范化按白名单解析，漏掉了 `snapshot.mcpNotes`——进入时拍下的恢复名单一读回来就被剥掉，退出模式拿不到名单、备注永远停在场景值。现已透传该字段（并补进入覆盖/退出恢复/未勾选不触碰三条直证回归测试；未勾选服务器的场景备注不再在进入时覆盖其全局备注）。
-
-### 说明
-
-- 人设"文件缺失 = 全部启用"的老数据兼容语义保留：只有首次新建/导入/恢复时物化现状并排除新名；已有技能与人设的启用状态不动。
-
----
-
-## [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
-
-### 新增
-
-- 回收站扩到子智能体 / 场景 / 提示词预设三处：删除都进回收站，可恢复或永久删除（恢复绝不覆盖）。
-- 子智能体工具限制改为按 Agent 预设：每个预设一份白/黑名单（互相排斥），运行期按当前预设生效。
-- 兼容页「预设注入边界」改版：五列标签（记忆 / 提示词 / 技能 / MCP / 子智能体），绿/红/灰框一眼看出哪个域被预设关掉。
-
-### 变更
-
-- 已移除的来源并入回收站（分目录/技能两部分，目录支持永久删除）。
-- 五处回收站排版统一（固定高度容器、行内边距收紧）。
-- MCP「整理补丁」重新上线：删多余启停覆盖块（生效状态不变），界面只留一个按钮。
-
-### 修复
-
-- 技能页「移除来源 / 恢复读取」死按钮：补客户端 op 映射 + 补进 writeOps 门禁清单。
-- `rules-toggle` 不传 `enabled` 时静默 no-op 却返回成功：改为缺参明确拒绝、不写盘。
-- 场景档案「技能集」把来源 key 当技能名显示：改为技能名与来源名分开回传，不再显示 `custom-<hash>`。
-
-### 安全
-
-- 明文密钥改为一律要令牌：「显示密钥」与配置导出没配 `token` 时一律拒绝，不再只靠宿主栅栏。
-
----
-
-## [0.6.0] - 2026-09-14
-
-### 新增
-
-- 「工具 → 兼容」页（第 8 个页签，只读）：宿主版本、能力可用数、每个动作走原生/适配/不可用、降级项与原因。
-- `node scripts/doctor.mjs`：命令行版兼容体检。
-- `node scripts/host-deps.mjs --fix/--restore`：把插件依赖 junction 到宿主安装。
-- 归档分组可重建：工作区登记被删后按会话目录自动重建，可一键重新登记。
-- 恢复归档顺带挂回工作区归属（此前会掉进「未分组」）。
-- 场景可绑定提示词预设；切换场景直接改写 `~/.dsh/AGENTS.md`（关掉自动恢复基线）。
-- 提示词预设库：新建即可写正文、编辑可改 id（= 目录改名，场景绑定自动跟着改）。
-- 正在生效的提示词预设不能删除。
-- 场景启用改单选（同时只启用一个，新场景默认不启动）。
-
-### 变更
-
-- 兼容判定换底座：源码文本比对 → 模块实体 + 能力探测；拒绝永远在写入之前。
-- 技能来源权限语义修正：默认来源必须读取但技能可删；外部目录可停用/移除但技能只读。
-- 用户数据搬出插件目录（归档账本等移入 hub）。
-- 归档服务改为独立门面：`cordis.patch.yml` 只插入本插件。
-- 弹窗按钮统一（取消/关闭只在右上角）。
-- 面板语言跟随宿主；会话页与 AGENTS.md 页接入中英词典。
-- AGENTS.md 应用保留 5 代备份。
-- 提示词预设 id 口径放宽（中文、空格等可用）。
-- `history-retention-set` 拒绝小数；`rules-set-active` 必须显式传参；`mcpm-set-enabled` 停用幂等。
-- 写操作门禁：先过宿主栅栏，`token` 作为脚本/局域网逃生门。
-
-### 修复
-
-- 进出场景模式会静默改写技能策略（数据污染）：快照只取生效项，已处于目标状态的不再写。
-- 导入技能删进回收站拿不回来：按作用域分岔，用户级来源按 key 重新解析路径。
-- 技能回收站显示字面量 `undefined`。
-- 面板不随宿主语言切换、两页硬编码中文、词条键写错导致界面露原始键名。
-- `subagent_run` 确认门早于参数校验：人设不存在时不再先弹卡。
-- 删除链路前置实现检查：在任何破坏性步骤之前校验所需方法。
-- 英文界面下兼容页结论条仍是中文：改为客户端按当前语言拼。
-- 两处过时文案（AGENTS.md 应用说明、创建技能确认卡落点）。
-
-### 安全
-
-- `mcpm-reveal` / `mcpm-export` 额外要求带 `Origin` 头。
-- `history-workspace-register` 补入 WRITE_OPS（此前漏了 token 门禁）。
-
----
-
-## [0.5.1] - 2026-09-13
-
-### 新增
-
-- 场景档案弹窗新加段默认一项都不勾：记忆段只预勾本场景已启用的，其余三段是空集。
-
-### 变更
-
-- 档案弹窗「记忆」段只列被编辑场景自己的记忆。
-- 场景页排版重做：卡片只留名字+描述+动作，数量收进页首「当前模式」条。
-- 保留场景「全局」不再出现在场景页与档案弹窗。
-
----
-
-## [0.5.0] - 2026-09-13
-
-### 新增
-
-- 插件自有技能来源「导入技能」（新建/导入落点，优先级高于 `~/.dsh/skills/`）。
-- 「移除来源」= 连目录都不再扫描（文件零改动，可恢复）。
-- 场景档案编辑器新增第 4 段「记忆」。
-- 人设模型与工具限制收进「高级选项」折叠区。
-
-### 变更
-
-- **破坏性**：插件产生的文件全部收进 `~/.dsh/tool-management/`（旧位置自动搬入）。
-- 场景升级为显式记录（带描述与顺序）；空场景合法；根层裸 `.md` 不再注入。
-- 斜杠命令全部下线。
-
-### 修复
-
-- 工具页整页白屏（`sceneLabel` 闭包作用域错）。
-- 导出静默丢失（导出写在 `apply` 体内）。
-- Skills 页被锁死（状态文件缺键被判非法 → 改为缺键自愈）。
-
----
-
-## [0.2.0] - 2026-09-12
-
-### 新增
-
-- 五个域合并进一个「工具」设置面板：MCP / Skills / AGENTS.md 预设 / History。
-- MCP：工具级独立启停、重启只重连不改启停、密钥默认打码、改写补丁前自动 `.bak`（保留 5 份）。
-- Skills：接入 `~/.agents` / `~/.codex` / `~/.claude` 与自定义目录；创建 / ZIP 导入 / 回收站；目录后台监听自动刷新。
-- AGENTS.md 预设库：多套全局基线，一键应用。
-- History：归档会话按项目分组、批量恢复 / 删除、保留期清理；从 Claude Code / Cursor / Codex / 任意文本导入；导出 Markdown / JSONL。
-
-> 0.1.1 / 0.1.2 / 0.1.3 没有独立记录（只有 git tag），此处不拆分它们的差异。
+# 变更日志
+
+本文件记录本项目的所有重要变更。
+
+格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循[语义化版本](https://semver.org/lang/zh-CN/)。
+
+- 只想看「大致改了什么」→ [版本更新概要](docs/update.md)
+- 功能说明与用法 → [README](README.md) / [README_EN](README_EN.md)
+- 工程细节（根因分析、实测数据、设计取舍）在 git 历史里，不在这里。
+
+---
+
+## [0.9.1] - 2026-09-17
+
+### 新增
+
+- **兼容页「注入实况」**：显示最近活跃会话里模型**实际看到**的五域文本，并如实分清「在上下文中 / 未投递 / 官方注入 / 已关闭」——勾了开关却没送到时一眼可见。
+- **「全选」统一成「全选 ↔ 取消全选」二合一**（不再并列两个按钮），并给技能管理页、记忆管理页、记忆的每个场景卡片补上缺的批量开关。
+- **场景未锁定时页面开关照常可用**，改动会同步写进当前场景的档案（MCP / 技能 / 子智能体 / 提示词四域，锁定才冻结）。
+- **人设也严格「退出即还原」**：快照记下进场景时全部人设的开与关，退出逐个恢复。
+- **技能管理页每个来源（目录）卡片也能批量开关**，点它或点来源开关会顺带把卡片展开。
+- **bundle 记忆在列表里显示附件数量**：多一颗「N 个附件」标签（0 个也显示，灰色），悬停给出总量与文件名，点它打开编辑弹窗并跳到附件区。
+
+### 变更
+
+- MCP 页的「全部启用 / 全部停用」移到页头动作栏，会话页的「全选」移到「导出会话」旁。
+- 场景横幅与提示词接管提示改口：从「开关已停用、请到档案编辑器里改」改成「改动会同步写进该场景的档案」。
+- 技能目录卡片的「移除来源」改为纯图标按钮（悬停说明后果，点击仍弹确认框）。
+
+### 修复
+
+- **退出模式失败、卡在场景里**：项目级技能来源在恢复时解析不到就中断整个退出，现在按 key 前缀解析，且逐行容错、不再因为一行把人困住。
+- **场景内打开技能，档案不跟着变**：同步逻辑读错了开关字段，「打开」被当成「关闭」而跳过写盘；现在按操作名判方向，档案没写成时页面也不再只报「已更新」。
+- **被同名技能覆盖的副本、结构不完整的技能不再进场景档案**：前者档案与运行时各说各话，后者曾让整个场景进不去。
+- **场景档案的 MCP / 技能 / 子智能体段全勾满仍显示「全选」**（没有「取消全选」态）；并列的「全选 + 清空」收敛成一个按钮。
+- **按钮文案一变就把整行挤走**：「全选 / 取消全选」与「刷新 / 刷新中…」的宽度改为按较宽的那份固定，八个管理页一致。
+- **点刷新没有「刷新中…」**：MCP / 提示词 / 会话三页的刷新从不立起加载标记，现在手动刷新会真的切过去（后台轮询不算），会话页并补上缺失的失败分支。
+- **MCP 工具描述的「展开」按钮**：改为按真实溢出显示，真被裁到两行才给按钮。
+- **flat 记忆的描述与「已启用」之间空出一段**：窄布局下空标签行不再占位置。
+
+---
+
+## [0.9.0] - 2026-09-16
+
+### 新增
+
+- **五个域各有自己的上下文注入**（用户裁定）：场景和记忆 / MCP / 技能 / 子智能体 / 提示词各发一条消息、轨迹里各占一行；只改一个域只重发那一条，域被关掉或清空时单独发一条「已清空」。
+- **提示词与技能目录两个新域**：官方那两条行挂得到就让官方送（标准等），挂不到（极简）才由插件兜底，不会出现两份；场景提示词与 `~/.dsh/AGENTS.md` 在官方语义里是同一件事，合并为一个「提示词」域。
+- **兼容页「注入」块**：总开关「极简模式也注入」+ 五个域勾选，设置存 `tool-management/inject-settings.json`。
+- **模型侧信息补全**：技能同名标出 `shadowed by <root>`（被覆盖）与 `preferred`（首选），启用被覆盖的副本不再回 OK 而无效；`skill_manager_list` / `prompt_manager_list` 给出源文件路径；MCP 备注进 `mcp_manager_list` 输出（字段 `user-hint`）；未运行的服务器也显示工具描述（按「上次运行时」缓存），超两行默认折叠。
+- **AGENTS.md 预设库记住「最近一次应用」**：手改过全局文件也能答出「来自预设 X（此后文件有变）」，不再退化成全列。
+- **`npm run sync:profile`**：把构建产物镜像进 DSH profile——profile 里是硬链接拷贝，构建新增的文件不会自动过去。
+
+### 变更
+
+- **注入不再依赖系统提示词段**（用户裁定）：四个域从 `systemPrompt.section()` 改走官方自己用的那条通道（`agent/pre-step` 合成消息）——persona `complete` 的预设（极简）再也压不掉；内容没变不重发，引导语压成一句。
+- **域名与顺序**：`记忆` → **场景和记忆**、`全局提示词` → **提示词**；从左到右 **场景和记忆 → MCP → 技能 → 子智能体 → 提示词**（注入块、可达矩阵、注入消息三处一致）。
+- **兼容页「预设注入边界」与页脚重写**：页脚区分「可调用 ≠ 已知晓」——工具任何预设下都可调用，但呈现由预设决定（`ptc` 会把工具编成生成 SDK，要在 `run_code` 里调）。
+- **破坏性**：四个工具族改名——`agentsmd_*` → `prompt_manager_*`、`rule_manager_*` → `memory_manager_*`、`skill_mcp_manager_*` → `mcp_manager_*`、`subagent_list/run` → `subagent_manager_list/run`；提示词或工作流里点名过旧名的一起改。
+- **插件文件全部收进 `tool-management/` 并按域改名**（`agents-md/` → `prompts/`、`agents/` → `subagents/`、`rules-index.json` → `memories-index.json`、`state.json` → `skills-state.json` 等），启动时自动迁移（只搬不删、绝不覆盖）。
+- **四个列表工具默认只列生效条目**（各带 `all=true` 看全量，表头给出全量口径）；工具描述精简 37%。
+- **MCP 详情页运行状态改成标题右侧的彩色标签**；备注的模型侧前缀统一为「用户提示：」。
+- **场景记忆段排版重做**：场景上提到 `##`、条目挂在各自场景下；名称恒为标题、显式描述进括号；bundle 补一行附件目录与文件名；正文文件 `SKILL.md` → `<名>.md`（旧名只读兼容，不迁移）。
+
+### 修复
+
+- **子智能体人设弹窗三个毛病一起修**：候选不自动拉、已启用模式的名单进不去、「关闭」后再「启动」清空勾选；现在自动展开也拉候选，**点行首即可展开 / 收起名单**，右侧按钮只管启用 / 停用，停用后再启用记得勾选。
+- **「预设注入边界」三处口径纠正**：子智能体列答「人设目录到不到得了模型」；技能 / 提示词列以官方为准（官方那条行挂着就是绿的）；MCP 列按提示词平面作答（被压制即红框）。
+- **每个场景块恒有一行加粗的「场景说明：」**（未填描述给默认句）。
+- **场景内的开关统一收归档案**（四域同口径，模型工具同样拒绝）；改档案立即生效、失败如实回报。
+- **人设域与 MCP / 技能进场景按档案勾选集全量对齐**（整段未定义 = 全部停用），退出按快照双向还原。
+- **场景接管提示词时四条状态共用一套事实**：只有场景绑定的那份可「重新应用」；删除保护扩成引用清单；文件被手改时两页都标出「文件里不是它」。
+- **场景退出后 MCP 行「开关已关、进程已停、却仍显示已运行」**：补丁说停用即不可能在运行，显示跟着控制面走。
+- **「N 个工具」不再把停用工具算进去**（有停用时显示 `可用/总数`）；工具全被停用的服务器不进段。
+- **场景名与记忆名相同会「吃掉」整个场景**：统一为「根下的一级目录恒为场景」（发现 / 定位 / 导入三处）。
+- **进场景被关掉的人设，退出没开回来**：快照名单落盘读回时被剥掉，现在原样透传。
+- **未启用的场景不再整片标红**：记忆页里「场景未启用」此前与真问题（游离记忆、被同名覆盖）共用同一个错误色，整块红读起来像出了错；现在未启用 = 灰色置灰（标签同色），红色只留给真问题——场景页与档案编辑器里的「未启用」标签同步改灰。
+- **小项**：注入边界提示不再点名工具（此前让模型去用刚用过的工具）；`skill_manager_list` 修影子技能误报停用；删 `subagent_manager_list` 空参数 `scene`、修 `create_skill` 老文案。
+
+---
+
+## [0.8.5] - 2026-09-16
+
+### 新增
+
+- 场景级 MCP 服务器备注：场景档案的 MCP 段可为每台勾选的服务器写专属备注，进入该场景时覆盖全局备注（写入 notes.json），退出场景时按快照恢复改动前的备注；未配场景备注的服务器照常使用全局备注。
+- 未运行服务器的工具可见性：新增「已知工具」侧车（`dsh-plugin-tool-management-mcp-tools.json`），枚举到 live 工具时按服务器记下名单——未运行的服务器不再永远显示 0 工具，工具勾选框也能列出最后一次见过的工具。从未运行过的服务器可在编辑弹窗点「启动服务器读取工具」：临时启用、轮询等工具注册（≤30s）、记入名单后恢复原启停状态。
+
+### 变更
+
+- 新增技能 / 子智能体 / MCP 一律默认不启动（用户裁定，三域同口径）：新建与导入的技能显式写入停用名单；新建/导入/回收站恢复的人设默认停用；新增 MCP 服务器创建即停用（显式传 `enabled: true` 才创建即启动）。启动与否由用户手动开启。
+- 场景档案 MCP「编辑」弹窗重做：行内备注输入框移除，「选工具」改为「编辑」，点击打开固定尺寸次级弹窗——第一栏备注、第二栏工具勾选（含全选/清空），有备注的服务器行显示「有备注」标签。
+- 系统提示词注入段文案优化：子智能体人设段措辞改为「可从下面的人设中选用」（此前读起来像"只能调用这几个"），并补充委派机制说明；场景记忆段标题下加固定引导语，让模型明确这是当前场景的常驻参考知识；MCP 备注前缀由「用户备注：」统一为「备注：」。
+- peer 依赖去掉 semver 上界（`>=0.1.5-rc.2 <0.2.0-0` → `>=0.1.5-rc.2`）：宿主跨 minor 升级不再被 pnpm peer 校验挡住安装，兼容性改由运行时能力探测兜底。
+
+### 修复
+
+- 历史页「已移除」标签红灰两色统一为灰色：此前红色 = 从未登记、灰色 = 曾登记被移除，颜色区分无实际意义。
+- 目录真实存在但没有「重新登记」按钮：`canRegister` 判定从「宿主会话索引命中」放宽为「磁盘目录真实存在」（带 stat 缓存，同一目录只探一次盘），与 `registerWorkspace` 的 realpath 目录校验一致——目录在即可一键重新登记；目录已删除的组显示「⚠ 目录已不存在」提示。
+- MCP 状态段缓存不刷新：MCP 工具加载完成（`tools/change`）与进/退/切换场景后均主动重算状态段——此前段停留在「空/旧集合」的缓存值，出现「切换 MCP 后系统提示词没有 MCP 段」「退出场景后备注看似没恢复」的现象。
+- 退出场景备注永不回退：rules-index.json 读盘时的快照规范化按白名单解析，漏掉了 `snapshot.mcpNotes`——进入时拍下的恢复名单一读回来就被剥掉，退出模式拿不到名单、备注永远停在场景值。现已透传该字段（并补进入覆盖/退出恢复/未勾选不触碰三条直证回归测试；未勾选服务器的场景备注不再在进入时覆盖其全局备注）。
+
+### 说明
+
+- 人设"文件缺失 = 全部启用"的老数据兼容语义保留：只有首次新建/导入/恢复时物化现状并排除新名；已有技能与人设的启用状态不动。
+
+---
+
+## [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
+
+### 新增
+
+- 回收站扩到子智能体 / 场景 / 提示词预设三处：删除都进回收站，可恢复或永久删除（恢复绝不覆盖）。
+- 子智能体工具限制改为按 Agent 预设：每个预设一份白/黑名单（互相排斥），运行期按当前预设生效。
+- 兼容页「预设注入边界」改版：五列标签（记忆 / 提示词 / 技能 / MCP / 子智能体），绿/红/灰框一眼看出哪个域被预设关掉。
+
+### 变更
+
+- 已移除的来源并入回收站（分目录/技能两部分，目录支持永久删除）。
+- 五处回收站排版统一（固定高度容器、行内边距收紧）。
+- MCP「整理补丁」重新上线：删多余启停覆盖块（生效状态不变），界面只留一个按钮。
+
+### 修复
+
+- 技能页「移除来源 / 恢复读取」死按钮：补客户端 op 映射 + 补进 writeOps 门禁清单。
+- `rules-toggle` 不传 `enabled` 时静默 no-op 却返回成功：改为缺参明确拒绝、不写盘。
+- 场景档案「技能集」把来源 key 当技能名显示：改为技能名与来源名分开回传，不再显示 `custom-<hash>`。
+
+### 安全
+
+- 明文密钥改为一律要令牌：「显示密钥」与配置导出没配 `token` 时一律拒绝，不再只靠宿主栅栏。
+
+---
+
+## [0.6.0] - 2026-09-14
+
+### 新增
+
+- 「工具 → 兼容」页（第 8 个页签，只读）：宿主版本、能力可用数、每个动作走原生/适配/不可用、降级项与原因。
+- `node scripts/doctor.mjs`：命令行版兼容体检。
+- `node scripts/host-deps.mjs --fix/--restore`：把插件依赖 junction 到宿主安装。
+- 归档分组可重建：工作区登记被删后按会话目录自动重建，可一键重新登记。
+- 恢复归档顺带挂回工作区归属（此前会掉进「未分组」）。
+- 场景可绑定提示词预设；切换场景直接改写 `~/.dsh/AGENTS.md`（关掉自动恢复基线）。
+- 提示词预设库：新建即可写正文、编辑可改 id（= 目录改名，场景绑定自动跟着改）。
+- 正在生效的提示词预设不能删除。
+- 场景启用改单选（同时只启用一个，新场景默认不启动）。
+
+### 变更
+
+- 兼容判定换底座：源码文本比对 → 模块实体 + 能力探测；拒绝永远在写入之前。
+- 技能来源权限语义修正：默认来源必须读取但技能可删；外部目录可停用/移除但技能只读。
+- 用户数据搬出插件目录（归档账本等移入 hub）。
+- 归档服务改为独立门面：`cordis.patch.yml` 只插入本插件。
+- 弹窗按钮统一（取消/关闭只在右上角）。
+- 面板语言跟随宿主；会话页与 AGENTS.md 页接入中英词典。
+- AGENTS.md 应用保留 5 代备份。
+- 提示词预设 id 口径放宽（中文、空格等可用）。
+- `history-retention-set` 拒绝小数；`rules-set-active` 必须显式传参；`mcpm-set-enabled` 停用幂等。
+- 写操作门禁：先过宿主栅栏，`token` 作为脚本/局域网逃生门。
+
+### 修复
+
+- 进出场景模式会静默改写技能策略（数据污染）：快照只取生效项，已处于目标状态的不再写。
+- 导入技能删进回收站拿不回来：按作用域分岔，用户级来源按 key 重新解析路径。
+- 技能回收站显示字面量 `undefined`。
+- 面板不随宿主语言切换、两页硬编码中文、词条键写错导致界面露原始键名。
+- `subagent_manager_run` 确认门早于参数校验：人设不存在时不再先弹卡。
+- 删除链路前置实现检查：在任何破坏性步骤之前校验所需方法。
+- 英文界面下兼容页结论条仍是中文：改为客户端按当前语言拼。
+- 两处过时文案（AGENTS.md 应用说明、创建技能确认卡落点）。
+
+### 安全
+
+- `mcpm-reveal` / `mcpm-export` 额外要求带 `Origin` 头。
+- `history-workspace-register` 补入 WRITE_OPS（此前漏了 token 门禁）。
+
+---
+
+## [0.5.1] - 2026-09-13
+
+### 新增
+
+- 场景档案弹窗新加段默认一项都不勾：记忆段只预勾本场景已启用的，其余三段是空集。
+
+### 变更
+
+- 档案弹窗「记忆」段只列被编辑场景自己的记忆。
+- 场景页排版重做：卡片只留名字+描述+动作，数量收进页首「当前模式」条。
+- 保留场景「全局」不再出现在场景页与档案弹窗。
+
+---
+
+## [0.5.0] - 2026-09-13
+
+### 新增
+
+- 插件自有技能来源「导入技能」（新建/导入落点，优先级高于 `~/.dsh/skills/`）。
+- 「移除来源」= 连目录都不再扫描（文件零改动，可恢复）。
+- 场景档案编辑器新增第 4 段「记忆」。
+- 人设模型与工具限制收进「高级选项」折叠区。
+
+### 变更
+
+- **破坏性**：插件产生的文件全部收进 `~/.dsh/tool-management/`（旧位置自动搬入）。
+- 场景升级为显式记录（带描述与顺序）；空场景合法；根层裸 `.md` 不再注入。
+- 斜杠命令全部下线。
+
+### 修复
+
+- 工具页整页白屏（`sceneLabel` 闭包作用域错）。
+- 导出静默丢失（导出写在 `apply` 体内）。
+- Skills 页被锁死（状态文件缺键被判非法 → 改为缺键自愈）。
+
+---
+
+## [0.2.0] - 2026-09-12
+
+### 新增
+
+- 五个域合并进一个「工具」设置面板：MCP / Skills / AGENTS.md 预设 / History。
+- MCP：工具级独立启停、重启只重连不改启停、密钥默认打码、改写补丁前自动 `.bak`（保留 5 份）。
+- Skills：接入 `~/.agents` / `~/.codex` / `~/.claude` 与自定义目录；创建 / ZIP 导入 / 回收站；目录后台监听自动刷新。
+- AGENTS.md 预设库：多套全局基线，一键应用。
+- History：归档会话按项目分组、批量恢复 / 删除、保留期清理；从 Claude Code / Cursor / Codex / 任意文本导入；导出 Markdown / JSONL。
+
+> 0.1.1 / 0.1.2 / 0.1.3 没有独立记录（只有 git tag），此处不拆分它们的差异。