前言¶
在 DSH Desktop 里用技能,常见做法是记 slash 命令名,或在菜单里翻找。技能装得多了之后,来源分散在 ~/.dsh、~/.agents、~/.claude 和安装目录等处,名称多为英文,分类也不统一。下面介绍社区插件 dsh-skill-groups(维护者 shijiacheng520,分类:客户端):在对话输入框左侧增加「技能」入口,用带图标的中文分组面板浏览、搜索并一键插入技能调用。
这是什么¶
dsh-skill-groups 是 DSH Desktop 的客户端插件:在 composer 输入框左侧注入一枚技能按钮,点开自绘面板,按分类下钻查看全部技能,支持中文说明与即时搜索,选中后通过官方插入通道写入 /技能名,不直接改动草稿状态机。
数据由 host 侧合并注册表与磁盘扫描;client 负责分类状态机、搜索与 UI。插件要求 DSH 引擎版本 >=0.2.0-rc.2,许可证 MIT,当前 package 版本为 1.0.0。
核心功能¶
双层下钻与自动分类¶
根页展示分类(如科研写作、办公文档、数据图表等,共 7 类,可在 client 配置中定义 icon 与 label)。点分类进入该组技能列表。分类规则为:显式映射优先(EXPLICIT),其余按关键词规则兜底(KEYWORD_RULES),新装技能默认无需额外配置。
中文说明¶
技能展示说明采用三级兜底:SKILL.md 中的中文描述 → 内置中文表(ZH_DESC)→ host 从 SKILL.md 提取摘要(/api/skill-picker/describe)。
全量技能来源¶
host 合并注册表与磁盘扫描,覆盖 ~/.dsh、~/.agents、~/.claude 及安装目录中的 office-runtime;preset 层技能同样可见。注册表优先,磁盘扫描按名称去重补全。
搜索与安全插入¶
面板顶部输入即过滤,跨分类匹配名称与说明。插入走官方 inputActions.captureInsertion / insertText,不碰草稿状态机。host 不可达时,withDeadline(3000) 兜底:面板仍可打开(可能为空列表),避免拖死输入框。
安装与启用¶
本插件采用 DSH Desktop web profile 下的本地依赖布局,资料未提供 dsh plugin add 一类的一行安装命令。先做目录准备,再改 package.json,最后重启客户端。
- 将本仓库内容放到 profile 下的
.local-plugins/dsh-skill-groups/。 - 在
node_modules中建立指向该目录的链接:node_modules/@local/dsh-skill-groups→../../.local-plugins/dsh-skill-groups。 - 在 profile 根目录的
package.json中增加依赖与 bundle 配置:
{
"dependencies": { "@local/dsh-skill-groups": "file:./.local-plugins/dsh-skill-groups" },
"dsh": { "profile": { "bundles": ["@local/dsh-skill-groups"] } }
}
web profile 路径示例:Windows 为 %APPDATA%\dsh-desktop\harness\profiles\web;其下应有 package.json、.local-plugins/ 与 node_modules/ 如上结构。
重启 DSH Desktop 后,输入框左侧出现「🧩 技能」按钮即表示启用成功。
典型用法¶
- 在任意对话的 composer 输入框左侧点击「🧩 技能」。
- 在根页选择分类,进入技能列表;或在顶部搜索框输入关键词,跨分类过滤。
- 点击目标技能,输入框插入对应
/技能名文本,继续编辑或发送即可。
面板行为如需调整,编辑插件包内 lib/client.js 顶部常量:CATEGORIES(分类)、EXPLICIT(显式映射)、KEYWORD_RULES(关键词兜底)、ZH_DESC(可选中文一句话)。lib/index.js 侧无需配置;若 office-runtime 定位失败,其余技能仍可用,仅少 12 个内置 office 技能。
适用场景与注意¶
适合在 DSH Desktop 上长期积累较多技能、希望用中文分组和搜索快速插入的开发者。插件以当前 DSH 进程权限运行,安装前请阅读 GitHub 仓库 源码与 MIT 许可证,自行评估信任边界。
社区目录 SkillHub 插件页 与 GitHub 为独立信息来源,与 DeepSeek / 幻方无官方从属关系;星标等元数据以各站点当时展示为准。
卸载时:删除 node_modules/@local/dsh-skill-groups 链接、.local-plugins/dsh-skill-groups 目录,并移除 package.json 中上述两处条目,重启 DSH Desktop。
结尾¶
dsh-skill-groups 把分散技能收成输入框旁的分组面板:自动分类、中文说明、全量扫描与搜索,插入走官方 API。需要细节与架构图见仓库 README。
- 目录页:https://www.skillhub.cn/plugins/shijiacheng520/dsh-skill-groups
- GitHub:https://github.com/shijiacheng520/dsh-skill-groups