前言¶
DeepSeek Harness(DSH)里调用技能,默认走输入框的 / 菜单:你得先记住技能的 kebab-case 英文名、拼写无误,候选列表还会按会话缓存,刚装上的技能经常刷不出来。装了很多技能,实际常用的往往只有记得住名字的那几个。
维护者 Sakura025 的客户端插件 dsh-skill-picker(GitHub:Sakura025/dsh-skill-picker,社区目录:skillhub.cn 条目)把宿主同一份 skills/list 目录做成常驻入口,并补上浏览、中文搜索、点选插入,以及在面板内安装新技能等能力。下面介绍它做什么、怎么装、怎么用。
这是什么¶
dsh-skill-picker 是面向 DSH 网页 Composer 的 技能选择器与应用内安装器:按开发阶段浏览技能,中英文搜索,单击插入 /技能名,并支持从仓库、URL、粘贴内容或 skills.sh 注册表安装,无需离开面板开终端。
- 分类:客户端插件(挂到
conversation.input.left等宿主槽位) - 许可:MIT
- 当前包版本(资料中的发布包):1.1.0
- 支持范围(README):DSH 0.2.x(依赖
skills/listRPC 与conversation.input.leftslot);Windows / macOS / Linux 的 Web 界面;Node.js ≥ 22.19;无额外运行时依赖
插件在 当前 DSH 进程权限 下运行;安装前请自行查看仓库源码与 LICENSE,社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
与原生 / 菜单的差异¶
原生 / 菜单 |
dsh-skill-picker |
|---|---|
| 要记英文名 | 中文名 + 一句话说明,点哪行插哪行 |
| 只有名字,用途不直观 | 六段开发阶段分组,左侧导航 |
| 主要搜英文名 | 中文、英文、说明全文可搜 |
| 装技能常需终端 | 面板内填地址、粘贴或搜注册表 |
核心功能¶
面板与浏览¶
- 920×720 对话框:左侧阶段导航(带计数)+ 右侧列表
- 六段开发阶段:① 定义需求 → ② 规划拆解 → ③ 写代码 → ④ 测试验证 → ⑤ 评审加固 → ⑥ 交付上线
- 每条显示 中文名、
/英文名、一句话中文说明 - 三个标签页:本次可用 / 本地已装 / 添加技能
搜索与插入¶
- 中文可搜:例如
测试、评审、上线等;也支持英文名与描述 - 默认单选:点一行立即把
/技能名写入草稿并关闭面板(与手打/同一条宿主通路) - 多选:右上角切换后勾选多个,底部「插入 N」,拼成
/a /b /c - 最近使用:最近插入的前 8 个置顶
- 键盘:
↑↓移动、Enter插入、Esc关闭、Tab退出多选
添加技能(四种来源)¶
安装结果落在 $DSH_HOME/skills/<name>/SKILL.md。
| 方式 | 填写内容 | 例子 |
|---|---|---|
| 仓库路径 | owner/repo 或 owner/repo/sub/path |
addyosmani/agent-skills/skills/code-review-and-quality |
| 原始地址 | 以 SKILL.md 结尾的 URL,或仓库 URL |
https://raw.githubusercontent.com/owner/repo/main/SKILL.md |
| 粘贴全文 | 完整 SKILL.md | 自写或从网页复制 |
| 公共库搜索 | 关键词,点结果安装 | review、pdf、测试(走 skills.sh) |
「本地已装」可查看真实路径并删除;卸载插件不会删 $DSH_HOME/skills/ 里已装技能。
安装与启用¶
前提:已安装 DSH 桌面版或 dsh web,Node.js ≥ 22.19。
资料中的安装方式为 解压发布包 + 修改 profile 的 patch 文件,不是 dsh plugin add github:...。
1. 找到 profile 目录¶
# macOS / Linux
ls ~/.dsh/profiles/
# Windows (PowerShell)
Get-ChildItem $env:USERPROFILE\.dsh\profiles
常见目录名:desktop、standard、web。下文用 <profile> 代指你的 profile。
2. 解压到 node_modules¶
从 GitHub Releases 或仓库说明取得 dsh-skill-picker-1.1.0.zip 后:
# macOS / Linux
mkdir -p ~/.dsh/profiles/<profile>/node_modules/@local
unzip dsh-skill-picker-1.1.0.zip -d ~/.dsh/profiles/<profile>/node_modules/@local/
# Windows
$dst = "$env:USERPROFILE\.dsh\profiles\<profile>\node_modules\@local"
New-Item -ItemType Directory -Force -Path $dst | Out-Null
Expand-Archive .\dsh-skill-picker-1.1.0.zip -DestinationPath $dst -Force
解压后 client.js 应直接在 node_modules/@local/dsh-skill-picker/ 下,不要多嵌套一层目录:
node_modules/@local/dsh-skill-picker/
├── package.json
├── cordis.patch.yml
├── index.js
├── client.js
├── locale/{zh,en}.json
└── icon.svg
3. 追加 patch¶
打开 ~/.dsh/profiles/<profile>/cordis.patch.yml,在文件最末尾追加(注意缩进:- insert: 顶格,下面两行 4 空格与 6 空格):
- insert:
- id: dsh-skill-picker
name: '@local/dsh-skill-picker'
原有内容不要改动。Loader 不监听 patch 文件变更,改完后必须 完全退出 DSH 进程(含托盘),再启动。
4. 硬刷新页面¶
Ctrl+Shift+R(macOS 为 Cmd+Shift+R)。输入框左下角 ➕ 一排最右侧应出现「技能」按钮。
典型用法¶
插入一个技能¶
- 点「技能」
- 左侧选阶段(如「④ 测试验证」),或在搜索框输入
测试 - 点对应行 →
/技能名进入草稿,面板关闭 - 继续写需求并发送
一次挂多个技能¶
右上角切到「多选」→ 勾选 → 底部「插入 N」。
装一个新技能¶
「添加技能」→ 选来源 → 填写或粘贴 → 「安装」。成功后切「本地已装」查看;新技能若未立刻出现在列表,可切换标签或重开面板,必要时重启 DSH(宿主需重新扫描)。
卸载插件¶
- 从
cordis.patch.yml删除上述三行- insert: - 删除
node_modules/@local/dsh-skill-picker目录 - 重启 DSH
适用场景与注意¶
适合谁:经常在 DSH Web Composer 里组合多个 agent skill、又不想背英文 slug 或反复开终端装技能的用户。
常见问题(README 摘要):
- 重启后无按钮:检查 patch 缩进、目录是否多一层、
client.js是否在正确层级;设置 → 插件中看@local/dsh-skill-picker是否报错 - 面板为空:接口失败时较新版本会回退内置清单;若完全空白,多为
client.js未加载 - 「添加技能」报宿主接口不可用:
index.js侧接口需 重启进程,仅刷新页面不够 - 插入后模型无反应:
/技能名须与技能目录名一致;用面板点选可避免拼写错误
结尾¶
dsh-skill-picker 把 DSH 技能目录做成可浏览、可搜、可装的一体化入口,减轻「只记得两个技能名」的使用摩擦。细节与更新以仓库为准。