dsh-desktop-enhance 0.2.5 → 0.3.0

package/README.md

@@ -1,8 +1,9 @@
 # dsh-desktop-enhance
 
-为 **DeepSeek Harness 桌面版**（DSH Desktop `0.2.0-rc.2`）补六个界面能力的插件。**自用**。
+为 **DeepSeek Harness 桌面版**（DSH Desktop `0.2.1-rc.2`）补界面与效率增强能力的插件。**自用**。
+
+## 功能列表
 
-## 六个功能
 
 ### 页内查找
 
@@ -99,6 +100,17 @@ Web 版（浏览器里打开的那种）键位是 **`Cmd+Shift+.`** —— `Cmd+
 - **折叠与展开**：点击顶栏可把整张卡片收起成一枚紧凑胶囊（`会话信息 · Skill N`），点击分节头可单独收起/展开该分节
 - **全量 + 实时**：实时监听前端会话事件流，同时向 Host 查询完整会话日志基线，即使几百轮的长会话只加载了尾部窗口，第 1 轮注入的 Skill 也不会漏掉；被上下文压缩或裁剪替换掉的节点会自动剔除
 
+### 工具管理
+
+在主对话区右上角「会话信息」悬浮看板内展示 **「可用工具 `X/Y` · `[管理 ↗]`」** 摘要行与已禁用微标签预览，点击 **`[管理 ↗]`** 在卡片旁弹出 `520px` 宽的**可折叠前缀树大浮层**（跨全局层与所有 Agent Presets 全量扫描）：
+
+
+- **前缀分组与批量启停**：自动将有多个工具的前缀（如 `mcp`、`job`、`schedule`、`web`、`cordis`）收拢为可折叠分组，显示启用计数（如 `2/2`），支持一键「全部禁用 / 全部启用」整组工具；只有 1 个工具的普通名称（如 `working_directory`、`todo_write`）直接展示为单行条目，不套多余目录
+- **实时搜索**：支持按工具名或描述关键词即时过滤
+- **两层一致拦截**：被禁用的工具既从发给模型的 Prompt Tool Schemas 中隐藏（节省上下文 Token），又在执行守卫层（`ctx.tools.guard`）拒绝调用，跨会话持久化
+- **总开关无损控制**：关闭「工具管理」总开关时立即放行所有工具，同时保留已保存的禁用列表；重新开启总开关即恢复生效
+
+
 ## 安装
 
 从 npm 装：
@@ -128,15 +140,16 @@ dsh plugin --profile desktop update dsh-desktop-enhance
 
 只改插件内容的话，**刷新页面即可**，不必重启。
 
-> ⚠️ **例外：如果插件更新里改了「宿主半侧」（`src/index.ts` / `src/suggest/**`），必须重启 App** —— 刷新页面不够。此时设置卡片会直接把不可用的项**置灰**并提示你重启，而不是等你点了几次之后才报「设置没写进去」。**看到那句提示 = 重启即可解决。**
+> ⚠️ **例外：如果插件更新里改了「宿主半侧」（`src/index.ts` / `src/suggest/**` / `src/session-info/**` / `src/tools-manager/**`），必须重启 App** —— 刷新页面不够。此时设置卡片会直接把不可用的项**置灰**并提示你重启，而不是等你点了几次之后才报「设置没写进去」。**看到那句提示 = 重启即可解决。**
 
 ## 开关
 
-六个功能各有一个开关，在**本插件自己的页面**上：
+每个功能各有一个开关，在**本插件自己的页面**上：
 
 > 侧栏 **插件** → 插件列表里选中 **`dsh-desktop-enhance`** → 页面里的 **「UI 增强」** 一栏
 
-六个开关：**页内查找** / **轮次编号** / **压缩行高亮** / **建议** / **每步耗时** / **会话信息**。默认全开，装完与之前行为一致，除非你自己去关。
+开关列表：**页内查找** / **轮次编号** / **压缩行高亮** / **建议** / **每步耗时** / **会话信息** / **工具管理**。默认全开，装完与之前行为一致，除非你自己去关。
+
 
 「建议」关掉时，它那三个参数（模型 / 推理强度 / 指令模板）也会一并收起 —— 功能关着时它们不起作用。