前言¶
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 技能目錄做成可瀏覽、可搜、可裝的一體化入口,減輕「只記得兩個技能名」的使用摩擦。細節與更新以倉庫爲準。