dsh-desktop-enhance 0.3.0 → 0.3.2

package/README.md

@@ -102,13 +102,22 @@ Web 版（浏览器里打开的那种）键位是 **`Cmd+Shift+.`** —— `Cmd+
 
 ### 工具管理
 
-在主对话区右上角「会话信息」悬浮看板内展示 **「可用工具 `X/Y` · `[管理 ↗]`」** 摘要行与已禁用微标签预览，点击 **`[管理 ↗]`** 在卡片旁弹出 `520px` 宽的**可折叠前缀树大浮层**（跨全局层与所有 Agent Presets 全量扫描）：
+支持**「设置页全局默认 + 会话右上角单会话覆盖」**两级管理：
 
+- **设置页全局默认**：在插件设置页展示「全局默认可用工具 `X/Y` · `[管理全局默认 ↗]`」，修改对所有项目和新建会话默认生效
+- **会话右上角单会话覆盖**：在主对话区右上角「会话信息」看板内展示 **「可用工具 `X/Y` · `[管理 ↗]`」**，点击弹出 `520px` 宽的**可折叠前缀树大浮层**；在此处修改仅作为当前会话的临时覆盖（显示「已自定义」徽标），并支持一键「重置为全局默认」
+- **前缀分组与批量启停**：自动将有多个工具的前缀（如 `mcp`、`job`、`schedule`、`web`、`cordis`）收拢为可折叠分组，支持一键「全部禁用 / 全部启用」整组工具
+- **两层一致拦截**：被禁用的工具既从发给模型的 Prompt Tool Schemas 中隐藏（节省上下文 Token），又在执行守卫层（`ctx.tools.guard`）拒绝调用
+
+### Skill 管理
+
+按 **📁 项目级 Skill**（`.dsh/skills`、`.agents/skills`）、**🌐 全局级 Skill**（`~/.dsh/skills`、`~/.agents/skills`）、**🧩 插件与内置 Skill**（如 `dsh-office`、`dsh-agent-preset`、`dsh-badge`）三大来源分类展示与管理：
+
+- **设置页全局默认**：在插件设置页展示跨项目共享的「全局级 + 插件注入 Skill」默认配置，所有会话默认继承
+- **会话右上角单会话覆盖 + 项目级 Skill**：在每个会话右上角「会话信息」看板的 Skill 分节中展示当前会话 `可用 Skill X/Y · [管理 ↗]`；点击弹出按三大来源分组的 `520px` 浮层（包含当前会话工作目录下的项目级 Skill），在浮层中修改开关仅对当前会话生效，可一键重置回全局默认
+- **一键预览 `SKILL.md`**：在浮层中点击任意 Skill 的「预览 ↗」，即便该 Skill 尚未在对话中触发，也可直接在右侧栏查看其完整 `SKILL.md` 指令
+- **彻底禁用并触发 DSH 刷新目录**：禁用某个 Skill 后，既阻止模型通过 `skill` 工具调用和 `/name` 手势注入，又自动触发宿主在下一轮请求前发送 `<available_skills>` 替换目录消息，节省首轮与后续上下文 Token
 
-- **前缀分组与批量启停**：自动将有多个工具的前缀（如 `mcp`、`job`、`schedule`、`web`、`cordis`）收拢为可折叠分组，显示启用计数（如 `2/2`），支持一键「全部禁用 / 全部启用」整组工具；只有 1 个工具的普通名称（如 `working_directory`、`todo_write`）直接展示为单行条目，不套多余目录
-- **实时搜索**：支持按工具名或描述关键词即时过滤
-- **两层一致拦截**：被禁用的工具既从发给模型的 Prompt Tool Schemas 中隐藏（节省上下文 Token），又在执行守卫层（`ctx.tools.guard`）拒绝调用，跨会话持久化
-- **总开关无损控制**：关闭「工具管理」总开关时立即放行所有工具，同时保留已保存的禁用列表；重新开启总开关即恢复生效
 
 
 ## 安装
@@ -140,7 +149,7 @@ dsh plugin --profile desktop update dsh-desktop-enhance
 
 只改插件内容的话，**刷新页面即可**，不必重启。
 
-> ⚠️ **例外：如果插件更新里改了「宿主半侧」（`src/index.ts` / `src/suggest/**` / `src/session-info/**` / `src/tools-manager/**`），必须重启 App** —— 刷新页面不够。此时设置卡片会直接把不可用的项**置灰**并提示你重启，而不是等你点了几次之后才报「设置没写进去」。**看到那句提示 = 重启即可解决。**
+> ⚠️ **例外：如果插件更新里改了「宿主半侧」（`src/index.ts` / `src/suggest/**` / `src/session-info/**` / `src/tools-manager/**` / `src/skills-manager/**`），必须重启 App** —— 刷新页面不够。此时设置卡片会直接把不可用的项**置灰**并提示你重启，而不是等你点了几次之后才报「设置没写进去」。**看到那句提示 = 重启即可解决。**
 
 ## 开关
 
@@ -148,7 +157,8 @@ dsh plugin --profile desktop update dsh-desktop-enhance
 
 > 侧栏 **插件** → 插件列表里选中 **`dsh-desktop-enhance`** → 页面里的 **「UI 增强」** 一栏
 
-开关列表：**页内查找** / **轮次编号** / **压缩行高亮** / **建议** / **每步耗时** / **会话信息** / **工具管理**。默认全开，装完与之前行为一致，除非你自己去关。
+开关列表：**页内查找** / **轮次编号** / **压缩行高亮** / **建议** / **每步耗时** / **会话信息** / **工具管理** / **Skill 管理**。默认全开，装完与之前行为一致，除非你自己去关。
+
 
 
 「建议」关掉时，它那三个参数（模型 / 推理强度 / 指令模板）也会一并收起 —— 功能关着时它们不起作用。