dsh-plugin-tool-management 0.20.3 → 0.21.1

package/CHANGELOG.md

@@ -10,6 +10,78 @@
 
 ---
 
+## [0.21.1] - 2026-10-18
+
+### 新增
+
+- **侧栏入口**：侧栏加一行「工具管理」，兼容页可随时关闭 / 开启（默认开启）。
+- **插件行显示名**：中文显示「工具管理」，英文显示 "Tools Management"。
+
+### 变更
+
+- **「工具」改名「工具管理」**：设置分区、侧栏入口与界面指路文案一并对齐。
+- **场景一条一行**：单列排列，描述固定第二行，开关与 ⋯ 右对齐。
+- **来源卡头目录下移**：目录改到标题下一行，窄面板里也照常显示。
+- **归档会话行放宽**：标题、目录与日期不再挤在一起。
+- **会话页标题去掉加粗**：目录卡头与其余页一致。
+- **令牌提示压成一行**。
+- **模式横幅按钮**：「退出模式」红字红框；「锁定」加粗，悬停才泛琥珀。
+- **场景卡片精简**：锁定键只在进入场景后出现在「退出模式」旁，提示词标签只留异常两种。
+- **回收站详情补全**：场景与记忆补上条目信息，技能条目套用技能详情排版。
+- **提示词页场景提示**：与 MCP 页同一句。
+
+### 修复
+
+- **MCP 备注改到编辑页**：详情页只读，并带一格空备注位。
+- **MCP 关掉后状态灯立刻变灰**。
+- **先打文字再打斜杠没有菜单**。
+- **场景开关与 ⋯ 没有垂直居中**。
+- **场景里的技能被删除后就退不出场景**。
+- **归档会话行内按钮没有边框**。
+- **锁定键悬停时字色变黑**。
+- **回收站详情里的技能来源显示成 uuid**。
+- **开关圆角与官方不一致**：方肩改为正圆角。
+
+---
+
+## [0.21.0] - 2026-10-17
+
+适配 DSH 0.2.1-rc.2。
+
+### 新增
+
+- **提示词页显示共享的全局指令文件**：`~/.agents/AGENTS.md` 也在被注入，改这里没生效时能看出是那一份在说话。
+- **兼容页功能总览新增四条宿主契约行**：子智能体人设委派、子代理工具限制、子代理创建时序、Web 连接准入 —— 这几项缺了不抛错、只是功能少一半，升级后第一眼可见。
+- **兼容页新增「裸模块解析」一块**：列出插件按裸名 require 的四个官方包（MCP 客户端 / 人设 / AGENTS.md / 技能目录）与各自守住的契约标识，官方撤包或改契约从此在界面上可见，不再只有命令行能看见。
+- **兼容页功能总览的依据写实**：子智能体与提示词两行改报「依赖的宿主模块在场」，不再用一句恒真的「无降级上报」糊过去。
+
+### 修复
+
+- **人设的工具限制不再慢一步**：改为在子代理创建时就施加，首轮工具调用前已生效。
+- **面板可以挂在反向代理子路径下**：请求地址按页面地址解析，不再固定写死根路径。
+- **带工具限制的 fork 委派会明确报错**，不再静默放宽权限。
+- **Web 版鉴权补上调用方身份**：只有本机所有者身份的请求才会被受理。
+
+### 变更
+
+- **插件依赖与兼容范围对齐 DSH 0.2.1-rc.2**：兼容范围按代设上界，跨 minor 升级需同步适配。
+- **doctor 不再把 `connection.admit` 误报成缺失**：该包不是插件依赖，静态检查改从宿主安装读取；宿主安装也取不到时如实报「只能对活宿主查」，而不是编一个「缺失」。
+- **子智能体临时预设改为引用计数**：同一组合复用定义，失败时释放，不再在预设库里堆积。
+- **允许追问的回执改说结算通知**：完成后会收到一条带着最终产出的通知。
+- **子代理嵌套深度的注释修正为官方默认 1**。
+- **注入到模型的模板文案改成英文**：板块标题、取代声明、补充说明、清空 / 截断 / 未列出这些提示；提示词正文首行改用官方的 `Instructions from:` 写法。场景名与说明、记忆正文、备注、`AGENTS.md` 等你自己写的内容仍原样注入。
+- **模型侧的工具输出与报错也改英文**：工具回执、校验失败与警告一律英文；面板文案仍中英双语，你自己写的名称与正文原样。
+- **技能、MCP、子智能体三个注入了工具名的板块补上触发条件**：写清什么时候该查这张表、什么时候该走带人设的委派；并说明取正文的工具被关掉、服务器未连接、人设不可调用时该怎么读。技能块首句补一句定义（技能是按需加载的任务指令集）。
+- **场景块补一句定义**：说明记忆、提示词、工具与人设都已按当前场景筛过，不再只给场景名与说明。
+- **MCP 段常驻，并补上第三档状态**：只要有一台该说的 server 就发，不因没有备注而省略；「连着但工具全被停掉」标成 `no tools enabled here`，不再与「没配过」混为一谈；说明行仍按内容发，超过上限时点名 `mcp_manager_list`。
+- **记忆段的截断态改成给模型读的文案**：截断标记不再是一句 HTML 注释，未注入清单不再带字节数；真截断时不再声称「这是全部」。
+- **「已清空」通知按原因分叉**：官方接管时说明是官方在送、旧内容作废；用户关掉或子会话不适用时说明这里不发送。
+- **注入的首份内容不再带「取代」声明**：「同一类内容以最新一份为准」只在替换旧消息时发，「只列了启用的技能」这类边界陈述每份都发。
+- **提示词块补一句效力声明**：说明这些规则要遵循、你在对话里说的优先。
+- **对抗性审查收口**：场景域「this one」改「it」（兼容多场景同时启用的历史态）；提示词域「for this machine」改「right now」（场景预设接管时不是机器全局）；记忆段截断标记与折叠行不再重复；有记忆被截掉但信号放不下时强制追加标记（不再静默截断）；记忆段截断时 how 行点名 `memory_manager_list` 给出查询出口。
+
+---
+
 ## [0.20.3] - 2026-10-17
 
 界面与官方对齐一批：焦点环、圆角、等宽字体改用官方 token；修好 MCP 连接失败时状态灯不红、新建记忆弹窗误关丢内容。

package/README.md

@@ -23,7 +23,7 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest      # web 版
 dsh plugin --profile desktop add dsh-plugin-tool-management@latest  # 桌面版
 ```
 
-装完 web 版硬刷新浏览器（Cmd/Ctrl+Shift+R），桌面版重启应用，设置 → **工具**。插件只写自己的文件，不改技能源文件；重启与升级后配置都在。
+装完 web 版硬刷新浏览器（Cmd/Ctrl+Shift+R），桌面版重启应用，设置 → **工具管理**。插件只写自己的文件，不改技能源文件；重启与升级后配置都在。
 
 ---
 
@@ -83,7 +83,7 @@ dsh plugin --profile desktop add dsh-plugin-tool-management@latest     # 桌面
 dsh plugin --profile desktop remove dsh-plugin-tool-management         # 桌面版 · 卸载
 ```
 
-装完 web 版硬刷新浏览器、桌面版重启应用，设置 → **工具** 出现八栏即成功。界面改动即时生效，宿主侧改动需重启（web 重启 `dsh web`，桌面重启桌面应用）。
+装完 web 版硬刷新浏览器、桌面版重启应用，设置 → **工具管理** 出现八栏即成功。界面改动即时生效，宿主侧改动需重启（web 重启 `dsh web`，桌面重启桌面应用）。
 
 也可以让模型代劳：
 
@@ -147,6 +147,7 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest
 - **「取消应用」一步回到链起点**，不是只退一步：这一串应用 / 取消往复开始之前是什么样就恢复成什么样（起点没有 `AGENTS.md` 就把文件删掉）；中途每一份内容都留在 `__last-applied__/AGENTS.md.bak-*`（保留 5 代），随时能再应用回来。
 - **两类不能直接删**：**被场景绑定的**、以及**当前应用的那一份**（后者先点开关「取消应用」就能删）；首次打开时自动生成的那份没「应用」过，可以直接删。删除一律进回收站。
 - **快捷提示词**（同页第二段）：存一段常用的话，`/` 里点一下就原样贴进输入框；场景可以绑定一组（进入只启用勾的那几条、退出按进场景前还原，也可选「无」）。
+- **共享的全局指令也能看见**：`~/.agents/AGENTS.md` 与别的 agent 工具共用、也在被注入；它存在时提示词页会标出来（只读，改它要去改那个文件）。
 
 ### 历史会话
 
@@ -157,10 +158,12 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest
 ### 宿主兼容
 
 - **「兼容」页**：宿主版本、能力可用数、每个动作走原生 / 适配 / 不可用、降级项与原因；三个写入口：访问令牌、注入设置、模型工具表。
+- **兼容页功能总览**：一行一个功能点，宿主契约四条（子智能体人设委派 / 工具限制 / 创建时序 / Web 准入）与「裸模块解析」四包都列在这里，升级后哪一处悄悄不工作一眼可见。
+- **侧栏入口**：侧栏里多一行「工具管理」，点开就是同一套八页；兼容页那颗「关闭侧栏 / 开启侧栏」随时能把这一行撤掉或挂回去（默认挂出，与「设置 → 工具管理」并存）。
 - **命令行**：`node scripts/doctor.mjs`（体检）、`node scripts/host-deps.mjs --fix`（依赖对齐）。
 - **压制型预设**（`minimal` 这类）下本插件的注入默认停用，可在「兼容」页按域强制打开。
 - **关掉「技能」「提示词」的勾选 = 连宿主那份一起停**（这两域在标准预设下由官方送）；其余三域勾选完全生效。
-- **注入长什么样**：每个域一条 `<system-reminder>`，`# 板块标题` + 正文 + 一句"以本份为准"；正文里的 `</system-reminder>` 会被转义。
+- **注入长什么样**：每个域一条 `<system-reminder>` —— 英文模板（`# Current …` 等板块标题 + 一句"以本份为准"）包着你自己的内容，名称、说明、备注、正文一律原样注入；正文里的 `</system-reminder>` 会被转义。
 
 ---
 
@@ -194,7 +197,7 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest
 | `tokenDisabled` | `true` = 令牌保留在配置里但当前不生效（兼容页「关闭保护」写的就是这一行）。写操作不再要求令牌，明文查看仍然要。                                |
 | `maxBodyBytes`  | 请求体上限，默认 88 MiB。                                                                                                                      |
 
-**磁盘上的明文（必读）**：打码**只发生在界面展示**；MCP 的 `env` / `headers` 与插件自己的 `token` 在 `cordis.patch.yml`（及各 profile 副本）里始终明文，改配置前整份文件会备份进 `~/.dsh/tool-management/backups/`（不加密、不轮转、卸载也不回收）—— 一份密钥最多有 `5 ×（含它的 patch 文件数）+ 1` 份明文副本。令牌门禁**管不到磁盘读取**，防线是操作系统的文件权限。清理入口：**设置 → 工具 → 兼容 → 「清理旧备份」**。
+**磁盘上的明文（必读）**：打码**只发生在界面展示**；MCP 的 `env` / `headers` 与插件自己的 `token` 在 `cordis.patch.yml`（及各 profile 副本）里始终明文，改配置前整份文件会备份进 `~/.dsh/tool-management/backups/`（不加密、不轮转、卸载也不回收）—— 一份密钥最多有 `5 ×（含它的 patch 文件数）+ 1` 份明文副本。令牌门禁**管不到磁盘读取**，防线是操作系统的文件权限。清理入口：**设置 → 工具管理 → 兼容 → 「清理旧备份」**。
 
 - **浏览器**：读写走 cookie，不需要令牌；**明文密钥**（显示密钥 / 导出）要令牌。令牌在「兼容」页的「访问令牌」块管理：本次启动填一次管到 DSH 退出；写进配置文件要重启生效。
 - **销毁方向一律要当场再输一次当前令牌**（关闭保护 / 修改 / 删除）—— 本次启动解锁过不算。
@@ -210,7 +213,8 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest
 | 装完没有页面                                | 硬刷新；不行重启 DSH。                                                                                                                      |
 | 重复 MCP 页签                               | 删 `cordis.patch.yml` 里的旧 loader 行后重启。                                                                                              |
 | 改坏配置 DSH 起不来                         | 从 `~/.dsh/tool-management/backups/` 取最近的 `cordis.patch.yml.<层级>.bak-<时间戳>` 覆盖回去（每份 patch 各留 5 份）。                     |
-| 升级 DSH 后动作不可用                       | 设置 → 工具 → **兼容** 看原因；`doctor.mjs` → `host-deps.mjs --fix`。                                                                       |
+| 升级 DSH 后动作不可用                       | 设置 → 工具管理 → **兼容** 看原因；`doctor.mjs` → `host-deps.mjs --fix`。                                                                       |
+| 升级 DSH 后装不上 / 提示 peer 不符           | 兼容范围逐代带上界（当前一代到 `<0.2.2`），跨 minor 升级要等插件同步适配（装新宿主前先升插件）。                                               |
 | 模型调不到某条工具                          | 「兼容」页的**模型工具表**看它是不是被关了（出厂默认关着 19 条）；面板和脚本不受影响。                                                      |
 | `approval=never` 还要确认吗                 | 不弹卡，直接放行并记日志；想问回来切回「工作区内修改」。                                                                                    |
 | `subagent_manager_run` 报 provider 不可用   | 对应 provider 没注册：`spawn`（默认）/ `fork`（`inherit`）分别挂 `@deepseek-ai/dsh-subagent-spawn-in-process` / `-fork-in-process` 后重启。 |

package/README_EN.md

@@ -23,7 +23,7 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest      # web
 dsh plugin --profile desktop add dsh-plugin-tool-management@latest  # desktop
 ```
 
-Hard-refresh the browser after installing for web (Cmd/Ctrl+Shift+R), or restart the desktop app after installing for desktop — a **Tools** panel in Settings means it worked. The plugin only writes its own files, never touches skill sources, and your configuration survives restarts and upgrades.
+Hard-refresh the browser after installing for web (Cmd/Ctrl+Shift+R), or restart the desktop app after installing for desktop — a **Tools Management** panel in Settings means it worked. The plugin only writes its own files, never touches skill sources, and your configuration survives restarts and upgrades.
 
 ---
 
@@ -81,7 +81,7 @@ dsh plugin --profile desktop add dsh-plugin-tool-management@latest     # desktop
 dsh plugin --profile desktop remove dsh-plugin-tool-management         # desktop · uninstall
 ```
 
-Hard-refresh the browser (web) or restart the desktop app, then a **Tools** panel with eight tabs means it worked. Client changes hot-reload; host-side changes need the client restarted (`dsh web` / the desktop app).
+Hard-refresh the browser (web) or restart the desktop app, then a **Tools Management** panel with eight tabs means it worked. Client changes hot-reload; host-side changes need the client restarted (`dsh web` / the desktop app).
 
 You can also ask the model:
 
@@ -145,6 +145,7 @@ For the desktop app, swap `web` for `desktop` and end with "remind me to restart
 - **"Un-apply" goes back to the start of the chain, not one step**: it restores whatever was there before this run of apply / un-apply began (deleting the file if there was none); every intermediate version stays in `__last-applied__/AGENTS.md.bak-*` (5 generations), so it can be applied again.
 - **Two kinds cannot be deleted directly**: a scene-bound preset, and the one currently applied (un-apply it first). The copy auto-created on first open was never applied and can be deleted. Deletes always go to the recycle bin.
 - **Quick prompts** (the second section on the same page): save a piece of text you keep typing, then hit `/` and click it to paste it in; a scene can bind a set of them (only the ticked ones are on while the scene is entered, restored on exit, or pick "None").
+- **The shared global instruction file is visible too**: `~/.agents/AGENTS.md` is shared with other agent tools and is also injected; when it exists the page says so (read-only — edit that file to change it).
 
 ### Archived sessions
 
@@ -155,10 +156,12 @@ For the desktop app, swap `web` for `desktop` and end with "remind me to restart
 ### Host compatibility
 
 - **Host tab**: host version, usable capability count, per-action routing (native / adapter / unavailable), degradations and reasons; three write entries: access token, injection settings, model tool table.
+- **Compatibility page overview**: one row per feature point. The four host contracts (subagent persona delegation / tool restriction / creation ordering / Web admission) and the "bare module resolution" block all live there — a feature that silently stops working after a host upgrade shows up at a glance.
+- **Sidebar entry**: a "Tools Management" row in the sidebar opens the same eight pages; the Host tab's "Hide from sidebar / Show in sidebar" button adds or removes that row at any time (on by default, alongside Settings → Tools Management).
 - **Command line**: `node scripts/doctor.mjs` (health check), `node scripts/host-deps.mjs --fix` (align dependencies).
 - Under a **suppressing preset** such as `minimal`, this plugin's injection is off by default; the Host tab can force any domain back on.
 - Unchecking "Skills" or "Prompt" really stops them — under standard presets the host delivers those two itself; the other three domains follow the checkbox exactly.
-- **What the injection looks like**: one `<system-reminder>` per domain — `# heading` + body + a "this one wins" line; a `</system-reminder>` inside the body is escaped.
+- **What the injection looks like**: one `<system-reminder>` per domain — an English frame (`# Current …` headings plus a "this one wins" line) around your own content: names, descriptions, notes and bodies are injected verbatim; a `</system-reminder>` inside the body is escaped.
 
 ---
 
@@ -192,7 +195,7 @@ The six recycle bins each own one directory under `trash/`: `{skills,memories,su
 | `tokenDisabled` | `true` = the token stays in the config but is not enforced (this is the line written by "Turn protection off"). Writes no longer need it; revealing plaintext still does.                                                                                       |
 | `maxBodyBytes`  | Request body cap, 88 MiB by default.                                                                                                                                                                                                                            |
 
-**Plaintext on disk (read this)**: masking is **display-only**; MCP `env` / `headers` and the plugin's own `token` stay in cleartext inside `cordis.patch.yml` (and each profile copy), and every config change copies the whole file into `~/.dsh/tool-management/backups/` — unencrypted, never rotated, not reclaimed on uninstall. One secret can therefore exist as `5 × (patch files holding it) + 1` plaintext copies. The token gate decides *who may read plaintext over HTTP*; it does nothing about *reading the files*, where the only defence is your filesystem permissions. **To clean up: Settings → Tools → Host → "Clean old backups"**.
+**Plaintext on disk (read this)**: masking is **display-only**; MCP `env` / `headers` and the plugin's own `token` stay in cleartext inside `cordis.patch.yml` (and each profile copy), and every config change copies the whole file into `~/.dsh/tool-management/backups/` — unencrypted, never rotated, not reclaimed on uninstall. One secret can therefore exist as `5 × (patch files holding it) + 1` plaintext copies. The token gate decides *who may read plaintext over HTTP*; it does nothing about *reading the files*, where the only defence is your filesystem permissions. **To clean up: Settings → Tools Management → Host → "Clean old backups"**.
 
 - **Browser**: reads and writes go through cookies, no token needed; **plaintext credentials** (reveal / export) do. The token is managed in the **Access token** block on the Host tab.
 - **Every destructive direction asks for the current token again** (turn protection off / change / delete). Being unlocked this run does not count.
@@ -207,7 +210,8 @@ The six recycle bins each own one directory under `trash/`: `{skills,memories,su
 | Pages missing after install                                           | Hard refresh; restart DSH if that fails.                                                                                                                                               |
 | Duplicate MCP tabs                                                    | Remove the stale loader row from `cordis.patch.yml`, restart.                                                                                                                          |
 | Broken config, DSH won't boot                                         | Restore the newest `cordis.patch.yml.<level>.bak-<timestamp>` from `~/.dsh/tool-management/backups/` (5 per patch file).                                                               |
-| Action stopped working after a DSH upgrade                            | Settings → Tools → **Host** for the reason; `doctor.mjs` → `host-deps.mjs --fix`.                                                                                                      |
+| Action stopped working after a DSH upgrade                            | Settings → Tools Management → **Host** for the reason; `doctor.mjs` → `host-deps.mjs --fix`.                                                                                                      |
+| Won't install / peer mismatch after a DSH upgrade                    | Each generation has its own upper bound (the current one stops below 0.2.2); a minor upgrade needs a matching plugin release (upgrade the plugin before the host).                        |
 | The model cannot call a tool it should have                           | Check the **Model tool table** on the Host tab — 19 tools ship switched off. The panel and scripts are unaffected either way.                                                          |
 | Still asked to confirm with `approval=never`?                         | No card appears — straight through with a log line. Switch back to "workspace write" to get the questions again.                                                                       |
 | `subagent_manager_run` reports provider unavailable                   | The provider is not registered: `spawn` (default) / `fork` (`inherit`) come from `@deepseek-ai/dsh-subagent-spawn-in-process` / `-fork-in-process` — mount and restart.                |

package/docs/images/icon.svg

@@ -0,0 +1 @@
+<?xml version="1.0" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg t="1792285388879" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="1697" xmlns:xlink="http://www.w3.org/1999/xlink" width="200" height="200"><path d="M592 336h-416c-52.928 0-96 43.072-96 96v416c0 52.928 43.072 96 96 96h416c52.928 0 96-43.072 96-96v-416c0-52.928-43.072-96-96-96z m32 512a32 32 0 0 1-32 32h-416c-17.632 0-32-14.336-32-32v-416c0-17.632 14.368-32 32-32h416c17.664 0 32 14.368 32 32v416z" p-id="1698"></path><path d="M720 208h-416a32 32 0 0 0 0 64h416c17.664 0 32 14.368 32 32v416a32 32 0 1 0 64 0v-416c0-52.928-43.072-96-96-96zM528 752h-288a32 32 0 1 0 0 64h288a32 32 0 1 0 0-64z" p-id="1699"></path><path d="M848 80h-416a32 32 0 0 0 0 64h416c17.664 0 32 14.368 32 32v416a32 32 0 1 0 64 0v-416c0-52.928-43.072-96-96-96z" p-id="1700"></path></svg>

package/docs/update.md

@@ -4,6 +4,8 @@
 
 | 版本                                        | 发布       | 主题                                                                                                                                                                                                                                                                                                    |
 | ------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [0.21.1](../CHANGELOG.md#0211---2026-10-18) | 2026-10-18 | 侧栏加「工具管理」入口与插件行显示名；场景改单列、描述第二行、开关与 ⋯ 居中，锁定键挪进模式横幅；来源目录挪到标题下、归档会话行放宽；开关圆角对齐官方；回收站详情补全条目信息；修好技能被删后退不出场景、斜杠菜单在行内不弹等一批问题 |
+| [0.21.0](../CHANGELOG.md#0210---2026-10-17) | 2026-10-17 | 适配 DSH 0.2.1-rc.2：人设工具限制提到创建时生效、面板可挂反代子路径、Web 鉴权补调用方身份、提示词页显示 ~/.agents/AGENTS.md；兼容页补四条宿主契约行与「裸模块解析」一块；注入模板文案改英文（自己的内容原样注入） |
 | [0.20.3](../CHANGELOG.md#0203---2026-10-17) | 2026-10-17 | 界面与官方对齐一批（焦点环、圆角、等宽字体）；修好 MCP 连接失败状态灯不红、新建记忆弹窗误关丢内容、焦点环盖掉宿主「不要轮廓」设定（#18） |
 | [0.20.2](../CHANGELOG.md#0202---2026-10-16) | 2026-10-16 | 界面降噪一批：行尾动作收进 ⋯、没在用的分组默认折叠、会话整行可点勾选；修好折叠卡片要点两次才展开与 npm 包带上演示视频 |
 | [0.20.1](../CHANGELOG.md#0201---2026-10-16) | 2026-10-16 | 修好技能状态文件出错时全线停用等三处；新增五个域的删除 / 回收站工具；MCP 支持粘贴补丁片段导入；创建技能可带附件；弹窗误关不再丢内容；一批排版与文案收短 |