dsh-skill-browser 🧩 技能浏览器
把技能库变成看得见、搜得到、管得住的资产。
DeepSeek Harness（DSH）桌面端 / 网页端插件：右下角一个「技」字悬浮球，点开即技能浏览器面板——115+ 技能秒级浏览、树状/平铺双视图、手动 + 关键词 + AI 三种分组、调用台账看板、130 款三球同步皮肤。分组只是视图归档，绝不移动任何技能文件。
技能浏览面板：分组/平铺/开关/移动
功能一览
🗂 三个 Tab
| Tab | 内容 |
|---|
| 技能浏览 | 搜索框 + 分组栏 + 技能卡片墙（名称 / 中文简介 / 版本徽章 / 分类 / 修改时间 / 启停开关 / 移动到分组） |
| 调用台账 | 统计卡 + 趋势图 + 技能调用排行 + 原始流水 |
| 快速上手 | 7 步图文引导，黑白线性图标，60 秒上手 |
📂 技能浏览
- 悬浮球入口：固定在屏幕角落，点击开关面板；可拖拽换位置（位置记忆），拖到屏幕顶部也不会丢（
app-region: no-drag 保护，配合 DSH 设置页「回到右下角」随时复位）
- 技能库位置自己定：⚙ 设置里选文件夹（弹系统目录选择框），或手动粘贴路径；未配置时自动探测官方默认根
~/.dsh/skills，不含任何预设路径
- 树状 / 平铺双视图：树状模式每个大类独占一整行，子类常驻缩进
├─ / └─ 挂在下方；平铺模式保留卡片墙。选择持久化记忆
- 搜索：按技能名 / 中文简介 / 原始描述实时过滤
- 版本号徽章：优先 SKILL.md frontmatter
version，其次同目录 package.json，没有则显示「暂未编版本号」
- 技能启停：单卡开关 / 分类级聚合滑块 / 全库批量启停（自动备份
.bak-toggle，停用即从模型技能目录摘除，随时可恢复）
- 详情：点卡片看 SKILL.md 全文（触发词 / 路径 / 最近调用记录），一键复制
🗃 分组管理
- 手动新建分组：「+ 新建分组」建大类 → 子类两级；技能卡片菜单里「移动」到分组
- ⚡ 关键词分组：本地正则按触发词自动归类，零 token、毫秒级、结果确定
- 🤖 AI 自动分组：读技能清单让模型出方案（模型可选），AI 封面自动配图
- 三种方式都只出方案不落盘，弹层里确认「替换 / 追加」才写入
groups.json
- 存在自定义分组时，默认分类行自动隐藏，视图更干净
📋 调用台账
插件监听 DSH 官方 tools/result 事件，自动登记每一次 skill 工具调用结果（成功「生效 ✅」/ 失败「未生效 ❌」含错误信息），人工台账与自动登记分开显示、人工维护区永不改动。
看板提供：起止日期 + 今天 / 近 7 天 / 近 30 天 / 本月 / 上月 / 今年 / 全部七个快捷区间 + 日/周/月/年四种粒度 + 6 张统计卡（调用次数 / 活跃技能 / 活跃天数 / 成功率 / 失败 / 日均）+ 趋势图 + 排行榜（按调用、失败、成功率、最后调用、技能名排序，带版本号与迷你占比条）。实测规模参考：1141 次调用、95.2% 成功率、122 个活跃技能的全库统计秒级出图。
调用台账：统计卡 + 趋势图 + 排行榜
🎨 130 款皮肤（三球同步）
- 与 dsh-todo-float-ball / dsh-font-enhancer 共享同一套皮肤系统，任一处切换三个悬浮球与面板实时同步
- 内置「跟随系统（深/浅自动）」+ 官方深色 + 官方浅色等 130 款，全部面板控件按当前皮肤实算对比度配色，浅色主题 WCAG 达标
- 皮肤菜单 6 列宽屏布局，130 款一屏尽览；设置页提供「三球皮肤同步」开关
- 头部按钮全部为黑白线性 SVG 图标（皮肤 / 设置 / 热重载 ⚡ / 刷新 ↻ / 关闭 / GitHub Star），任何皮肤下清晰可读
📖 快速上手（7 步，黑白线性图标）
- 选技能库位置（第一步）→ 设置 → 选择文件夹 → 保存自动重扫
- 刷新 让新技能进列表 → 不重启 DSH 立即生效再点热重载 ⚡（顺序：先选库 → 再刷新 → 最后热重载）
- 搜索与筛选：关键词 / 树状平铺 / 关键词分组 / AI 自动分组
- 看详情 / 启停：卡片展开全文，可直接禁用/启用
- 调用台账：日期区间 + 粒度 → 排行、失败率与趋势
- 分组管理：新建大类/子类、移动技能；删分组不删技能文件
- 认识面板按钮：皮肤（130 款三球同步）→ 设置 → 热重载 → 刷新 → 关闭 → Star
⚙ DSH 设置页「悬浮球导航」分区（本插件提供）
- 🧩 技能球 / 🔤 字体球 / 📋 Todo 球三球显隐开关（未安装的自动标注）
- 悬浮球皮肤下拉（130 款分组列出）
- 「回到右下角」金色按钮：悬浮球被拖出屏幕外卡住时一键复位，无需重启
- 作者插件 12 款清单：字体插件 / 技能浏览器 / Todo 进度球 / 图片灯箱 / 语音提醒 / 文献检索 / QQ 群摘要 / 模型菜单分组 / 对话归档 / 外挂识图 / 文件点击直达 / DeepSeek 网页端
安装
方式一：DSH 插件市场 / npm（推荐）
在 DSH 插件市场搜索 dsh-skill-browser 安装，或：
pnpm add dsh-skill-browser
并把 "dsh-skill-browser" 加入 profile 的 dsh.profile.bundles 数组，重启 DSH，右下角出现 🧩 悬浮球。
方式二：本地目录安装（desktop profile）
- 把本仓库完整复制到
~/.dsh/profiles/desktop/node_modules/dsh-skill-browser（真实目录，不要 junction/link）
- 在
~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 数组加 "dsh-skill-browser"（不要加进 dependencies——本插件零 npm 依赖）
- 重启 DSH，右下角出现 🧩 悬浮球；打开 ⚙ 设置选择你的技能库文件夹即可
适配版本
- DSH 内核（
@deepseek-ai/dsh）：0.2.1-rc.3（package.json 的 engines.dsh 已声明 >=0.1.7-rc.1）
- DSH 桌面端：2.0.20-next（DSH NEXT）
- Node.js：
^22.19.0 || >=24.0.0
- 已在上述版本实测通过；低版本
0.1.7-rc.1 及以上兼容。
⚠️ 发布 24 小时内安装报错？ 这不是插件问题。DSH 桌面端内置供应链安全策略（minimumReleaseAge）：刚发布不到 24 小时的 npm 包会被 pnpm 拒绝安装（报错含 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION）。等一天再装即可，无需任何配置。
API（宿主端，仅回环可访问）
| 路由 | 说明 |
|---|
GET /dsh-skill-browser/health | 健康检查（含 root 与识别来源） |
GET /dsh-skill-browser/rev | 当前加载代号与版本（热重载探针） |
POST /dsh-skill-browser/reload | 热重载 host 半代码，返回新代号 |
GET/POST /dsh-skill-browser/config | 读取/保存运行时配置（skillsDir、ledgerEnabled） |
GET /dsh-skill-browser/skills[?refresh=1] | 全量技能清单（含 version）+ 分类元数据 + 总数 |
GET /dsh-skill-browser/skill?dir=<name> | 读取某技能 SKILL.md 全文 |
GET/POST /dsh-skill-browser/groups | 读取/写入两级分组（groups.json），action：create/rename/delete/move/assign/assign-batch/ai-classify/kw-classify/ai-apply/ai-cover/model-info |
GET /dsh-skill-browser/ledger[?refresh=1] | 人工台账表 + 自动登记统计与流水 |
GET /dsh-skill-browser/ledger/stats?from=&to=&gran=&sort=&top= | 调用台账看板聚合（gran=day|week|month|year，sort=calls|fails|rate|last|name） |
POST /dsh-skill-browser/ledger/report | 手动上报失败 { skill, note, kind } |
POST /dsh-skill-browser/ledger/flush | 立即落盘队列中的登记 |
GET /dsh-skill-browser/ledger-detail?skill=<name> | 该技能的人工明细 + 全部自动记录 |
POST /dsh-skill-browser/pick-dir | 弹系统目录选择框（Windows） |
POST /dsh-skill-browser/toggle | 单技能启停（改写 frontmatter，自动备份） |
POST /dsh-skill-browser/toggle-batch | 批量启停 |
GET/POST /dsh-skill-browser/diag | 诊断信息（扫描耗时、缓存状态、最近错误） |
GET /dsh-skill-browser/orb/<orb-*.html> | 悬浮球静态资源 |
技能根目录解析顺序：设置页覆盖（~/.dsh/data/dsh-skill-browser/config.json）→ 环境变量 DSH_SKILLS_DIR → 插件 config skillsDir → ~/.dsh/skills（官方默认根）。
测试
node test/run.js <你的技能库路径> # 扫描/分类/frontmatter 解析
node test/ledger-test.mjs # 台账引擎（38 项断言）
License
MIT
