在 DeepSeek Harness（DSH）桌面端开发智能体时，技能库通常以文件形式分散在本地，难以快速浏览、检索，且技能调用后的生效状态难以追踪。dsh-skill-browser 插件将本地技能库转化为可视化的悬浮球面板，提供两级分类、实时搜索与失效台账自动登记功能。
插件简介¶
dsh-skill-browser 是 DSH 客户端插件，由 loyalchiiina 维护，采用 MIT 许可证。它解决的核心问题是：如何在一个统一的 UI 入口下，高效浏览本地技能库，并自动记录技能调用的执行结果。插件不内置预设路径，确保展示的是用户本地技能库的真实内容。
核心功能¶
1. 悬浮球
固定在屏幕角落，点击开关面板；可拖拽换位置（位置记忆），Alt+点击收起成小圆点。
2. 技能库位置可配置
首次使用在面板 ⚙ 设置里选择技能库文件夹（弹系统目录选择框），或手动粘贴路径；未配置时自动探测官方默认根 ~/.dsh/skills。插件不含任何预设路径。
3. 两级分类
按技能目录名模式自动归类（16 个一级分类与 Fluent/DSH 域二级分类）。
4. 中文简介与搜索
技能简介直接取自各技能 SKILL.md frontmatter 的 description。支持按技能名 / 中文简介 / 原始描述实时过滤。
5. 详情查看
点击卡片查看 SKILL.md 全文，可一键复制。
6. 失效台账
监听 DSH 官方 tools/result 事件，自动记录每次 skill 工具调用结果（成功记「生效 ✅」，加载失败记「未生效 ❌」并带上错误信息）。人工台账与自动登记分开显示，人工维护区插件永不改动。
7. 台账智能发现
初始化时全库搜索台账文件，文件名含「失效台账 / 失败台账 / 生效-失效」等关键词，约定路径 skill-master/references/ 优先；搜到就复用，没搜到才创建默认台账。
安装与启用¶
1、把本目录完整复制到 ~/.dsh/profiles/desktop/node_modules/dsh-skill-browser（真实目录，不要 junction/link）。
2、在 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 数组加 "dsh-skill-browser"（不要加进 dependencies，本插件零 npm 依赖）。
3、重启 DSH，右下角出现 🧩 悬浮球；打开 ⚙ 设置选择你的技能库文件夹即可。
典型用法¶
- 浏览技能：点击悬浮球打开面板浏览技能库。
- 配置路径：在面板 ⚙ 设置里选择你的技能库文件夹。
- 上报失败：在对话中使用「触发失败，登记」或「登记失败：技能名 原因」口令上报失败。
- 控制显隐：在 DSH 设置页分区「悬浮球导航」中控制悬浮球显示与隐藏。
- 复位位置：点击悬浮球的一键恢复默认位置按钮复位（清位置记忆/收起状态）。
注意事项¶
- 发布 24 小时内安装报错？这是供应链安全策略（minimumReleaseAge）导致的，不是插件问题，需等一天再装。
- 路径配置：插件不含任何预设路径。
- 台账独立性：人工台账与自动登记分开显示，插件永不改动人工台账。
- 数据准确性：插件不内置任何技能名清单/字典，保证看到的是自己技能库的准确描述。
适用场景¶
适合需要在 DSH 桌面端集中管理本地技能库，并希望自动化追踪技能生效状态的开发者。
