dsh-skill-catalog

DSH Web GUI 的技能面板——点一下 ⚡，全部技能带中文备注与分类排在你面前，搜索、筛类、点选、插入，随消息发出自动加载。

解决什么问题

DSH 官方内置了 / 技能补全，但它是记忆驱动的：你得先记得技能名，打 / + 前缀才能过滤出来。装了几十个技能之后，谁也记不住。

本插件在输入框旁加一个 ⚡ 按钮，点开就是全部技能：

全量发现——磁盘扫描与宿主注册表合并，连 bundled / custom / runtime 三类结构上看不见的技能也列得出来
8 类分类——工程 / 排错 / 需求 / 设计 / 文档 / 调研 / 技能 / 自动化，点 chip 只看该分类
中文备注——只影响显示层，不改任何 SKILL.md，模型的技能路由判断完全不受影响
拼音搜索——ji yi / jiyi / jy 都能搜到中文技能
智能排序——置顶 → 最近使用 → 常用 → 其余，再按「自动 / 手动」区分模型能否自行调用
技能管理——右键置顶 / 关闭 / 定位 / 卸载（移入备份，可撤回）
跨端共享——桌面端与网页端的置顶、使用记录共用一份

选中后把官方 /技能名 手势插进发送框，随消息发出，由 DSH 原生机制加载技能——零 agent 侧改动。

记得名字用官方 /，忘了名字用 ⚡，两者互补，可同时使用。

安装

本插件不发布到 npm，从 GitHub 装：

dsh plugin --profile web add "git+https://github.com/frzzaxszz/dsh-skill-catalog.git#path:/plugin"

⚠️ #path:/plugin 不能省。 这个仓库是「插件在子目录」的布局：根目录放仓库说明，真正的 package.json 与 cordis.patch.yml 在 plugin/ 里。少了这一段，pnpm 在仓库根找不到 package.json，安装会失败。

固定到某个 commit：

dsh plugin --profile web add "git+https://github.com/frzzaxszz/dsh-skill-catalog.git#path:/plugin&commit=<sha>"

重启 dsh web（或刷新页面）即生效。

国内 HTTPS 受限时改用 SSH（同样要带 #path:/plugin）： dsh plugin --profile web add "git+ssh://git@github.com/frzzaxszz/dsh-skill-catalog.git#path:/plugin" 或先执行 git config --global url."git@github.com:".insteadOf "https://github.com/"

自带技能

装插件会一并装上它自己的维护技能，不需要另外手放到 ~/.agents/skills：

技能	什么时候用
`sync-catalog-zh-descriptions`	新装了技能、面板上还有英文备注、或新技能没落进分类 chip 时，调它一次，同时补中文备注与分配分类

因为 DSH 读技能的四个根（~/.agents/skills、$DSH_HOME/skills、<cwd>/.agents/skills、<cwd>/.dsh/skills）都不包含 node_modules，光把文件塞包里没人读得到——所以 host 半边启动时向 skills 服务注册了一个 provider（rank 350），机制与 dsh-mattpocock-skills-deck 的随包技能一致。

优先级：项目级（100/200）> 随包（350）> 你自己装在 ~/.agents/skills 的同名副本（500）。同名的以你那份为准——用户的选择优先。

为什么这件事要「调用一个 skill」，而不是全自动

装了插件之后，新技能应该一进来就自动被翻译、自动归类——这是更理想的形态，本插件也确实能做到：host 侧用 ctx.on('agent/pre-step', ({ agent }) => …) 拿到活 agent，再 agent.followup(msg) 把任务塞进会话，模型自己就去做，不需要任何外部 API。同机的 meow-memory 就是这么把记忆整理做成全自动的。

但我们仍然设计成由你显式调用，理由有三个，都不是技术限制：

① 自动化要往你正在跑的会话里插话。 followup/steer 不排队、不弹窗，表现为对话里凭空多出一次助手动作。对后台任务（记忆整理）这无所谓；但技能面板是个高频 UI，你点开面板只是想看一眼技能列表，却撞见 agent 在自动改写分类表——这个体验是有争议的，而且它会花你的 token。

② 判定「这是新技能」需要一份基线。 插件每次都是全量扫盘，本身没有「上次处理到哪」的记忆。要自动，就得再存一份已处理技能的快照（按 name + 描述哈希），多一个状态文件、多一类需要迁移和清理的数据。

③ 自动生成的质量会低于一次显式调用。 分类判据里有大量边界：「写文档 ≠ 文档」「pr 该归调研」「prototype 该归需求」这类需要揣摩技能实际用法；中文备注更要求读懂它在什么场景下被用。顺手做的版本大概率比不上专门做一遍。更麻烦的是它错了不会报错——只是安静地待在一个错的 chip 里，没人发现。

所以当前的取舍是：把你「记得去调哪个技能」的负担降到零（插件自带它、面板上就能看到它），而不是把你「审一眼结果」的机会也一起拿走。

如果以后确实想要全自动，可行路线是加一个默认关闭的开关（设置里打开才走 pre-step 自动模式），或者做成「面板上显示『有 N 个技能未分类』，点一下补」——后者不插话、也不花多余 token，是更稳妥的一步。这些都还没做。

文档在哪

想看什么	去哪
完整功能说明、分类表、用法、原理、更新日志	`plugin/README.md`
动手改这个插件	`AGENTS.md`（三副本结构与同步纪律）
参与贡献	`CONTRIBUTING.md`
Issue 跟踪与分诊约定	`docs/agents/issue-tracker.md`

仓库结构

plugin/          ← 插件的真相源（Git 跟踪的就是这份）
  src/           ← 可读的源码（client 半 + host 半）
  lib/           ← 实际运行的编译产物；无构建链，与 src 手维护同步
  bundled-skills/← 随包技能
  scripts/       ← 把 src 内联进 lib 的手工工具（幂等可重跑）
docs/agents/     ← 工程技能读取的约定
backup/          ← 本地回滚件（不进仓库）

plugin/ 是真相源，但它不是实际在跑的那份。 详见 AGENTS.md—— 改代码必须同步到 profile 的 local-plugins/ 与 node_modules/ 两处，否则下次 pnpm install 会把改动冲掉。

贡献

Issue 与 PR 都欢迎。发现 Bug 请附上：DSH 版本、操作系统、在哪个面板看到的（本机输入框旁有两个 ⚡，左边是 dsh-skill-market，右边才是本插件）、以及控制台的 [dsh-skill-catalog] 日志。

License

MIT

dsh-skill-catalog (plugin)

安装

README