dsh-skill-picker:在 DSH 輸入框裏選技能、裝技能

前言

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/list RPC 與 conversation.input.left slot);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)。輸入框左下角 ➕ 一排最右側應出現「技能」按鈕。

典型用法

插入一個技能

  1. 點「技能」
  2. 左側選階段(如「④ 測試驗證」),或在搜索框輸入 測試
  3. 點對應行 → /技能名 進入草稿,面板關閉
  4. 繼續寫需求併發送

一次掛多個技能

右上角切到「多選」→ 勾選 → 底部「插入 N」。

裝一個新技能

「添加技能」→ 選來源 → 填寫或粘貼 → 「安裝」。成功後切「本地已裝」查看;新技能若未立刻出現在列表,可切換標籤或重開面板,必要時重啓 DSH(宿主需重新掃描)。

卸載插件

  1. 從 cordis.patch.yml 刪除上述三行 - insert:
  2. 刪除 node_modules/@local/dsh-skill-picker 目錄
  3. 重啓 DSH

適用場景與注意

適合誰:經常在 DSH Web Composer 裏組合多個 agent skill、又不想背英文 slug 或反覆開終端裝技能的用戶。

常見問題(README 摘要):

  • 重啓後無按鈕:檢查 patch 縮進、目錄是否多一層、client.js 是否在正確層級;設置 → 插件中看 @local/dsh-skill-picker 是否報錯
  • 面板爲空:接口失敗時較新版本會回退內置清單;若完全空白,多爲 client.js 未加載
  • 「添加技能」報宿主接口不可用:index.js 側接口需 重啓進程,僅刷新頁面不夠
  • 插入後模型無反應:/技能名 須與技能目錄名一致;用面板點選可避免拼寫錯誤

結尾

dsh-skill-picker 把 DSH 技能目錄做成可瀏覽、可搜、可裝的一體化入口,減輕「只記得兩個技能名」的使用摩擦。細節與更新以倉庫爲準。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜