前言¶
在 DeepSeek Harness（DSH Desktop）裏用技能，常見路徑是輸入 / 打開命令面板，從一長串條目裏挑一個。列表裏往往只有技能名和一段英文描述；技能一多，很難快速判斷「這個技能具體做什麼、當前對話該不該用」。
dsh-skill-pilot 是面向客戶端（Composer 輸入區）的 DSH 插件：在輸入框一側提供可搜索的中文技能面板，並在你打字時根據草稿內容給出最多三條推薦。下面介紹它的定位、能力、安裝方式與使用要點。資料來源爲插件 GitHub README 與 package.json（當前版本 1.1.5，MIT 許可證，維護者 ITxuezhe / 楊靖）。
這是什麼¶
dsh-skill-pilot（npm 包名 dsh-skill-pilot）自稱「技能領航員」：裝好後，輸入框左側會出現帶技能數量角標的「技能」入口；點開展開面板，或在輸入框內輸入時於上邊框看到推薦條。
插件歸屬社區倉庫 ITxuezhe/dsh-skill-pilot，在 SkillHub 等目錄中歸類爲客戶端插件。它不改變 DSH 的技能執行機制，只改善發現與插入 /技能名 的體驗。
它解決什麼問題¶
README 歸納了兩點：
- 中文一句話說明：每個技能用一行中文用途展示，並按類別分組，支持搜索。
- 跟着草稿推薦：在輸入框裏打字，停頓約 260ms（防抖，兼顧中文輸入法）後，輸入區上邊框浮出最多 3 個推薦技能；點選即將
/技能名插入輸入框。
相對僅靠 / 面板瀏覽英文名與長英文描述，更適合中文環境下快速選型。
核心功能¶
以下能力均來自官方 README，安裝前可自行對照源碼覈實。
技能面板¶
- 左側分類欄：豎排分類（如代碼開發、辦公文檔、圖像設計、數據圖表、論文科研、測試排查、版本發佈、寫作潤色、檢索抓取、集成接入、筆記知識庫等），右側爲技能列表，兩欄各自滾動。
- 中英混合搜索：技能名、中文說明、英文描述、分類均可作爲檢索條件。
- 重讀：面板底部「重讀」會重新掃描技能目錄，新安裝的技能可儘快出現在列表中。
輸入即推薦¶
草稿停頓 260ms 後排序推薦，最多 3 條；可忽略推薦條，不會自動執行技能。
中文說明如何生成¶
README 寫明：全部本地生成——中文說明由本地規則與技能文件中的中文原句合成，不聯網、不調模型、不外傳內容。
單條說明優先取各技能 SKILL.md frontmatter 的 description；若已含中文則直接採用，否則用內置關鍵詞表合成一行中文類別提示。
技能掃描來源¶
按優先級掃描（同名技能先命中者勝）：
| 來源 | 路徑 |
|---|---|
| DSH 用戶技能 | $DSH_HOME/skills |
| Agent 技能 | ~/.agents/skills |
| CodeBuddy | ~/.codebuddy/skills |
| WorkBuddy | ~/.workbuddy/skills |
| Claude | ~/.claude/skills |
| 內置 / 插件 | DSH 技能服務註冊的條目 |
技術結構（便於排查問題）¶
- host（
lib/index.js）：註冊只讀 HTTP 路由 GET /api/skill-pilot/index— 技能目錄（30 秒緩存）GET /api/skill-pilot/rebuild— 強制重掃- client（
lib/client.js）：注入conversation.input.left插槽，渲染按鈕、面板與推薦條。
基於 webServer 與 skills 核心服務；README 稱純 JS，無 onnxruntime、sharp 等需編譯的原生依賴。package.json 要求 DSH 引擎 >=0.2.0-rc.2。
安裝與啓用¶
官方推薦命令如下（須與資料原文一致，勿自行拼接 GitHub 前綴）：
dsh plugin add dsh-skill-pilot
也可在 DSH 插件市場搜索 skill-pilot。安裝後完全退出並重啓 DeepSeek Harness，角標與面板纔會穩定出現。
手動安裝時，在 profile 目錄（通常爲 ~/.dsh/profiles/desktop）執行：
pnpm add -w --save-exact dsh-skill-pilot
並在該 profile 的 package.json 裏把包名加入 dsh.profile.bundles 數組末尾，例如：
"bundles": [ "...", "dsh-skill-pilot" ]
典型用法¶
- 點輸入框左側「技能」→ 打開面板；未搜索時按類別分組，輸入關鍵詞後變爲扁平結果。
- 點列表中任一行 → 自動向輸入框插入
/技能名，繼續補全你的問題即可。 - 直接在輸入框打字 → 停頓後出現推薦條（最多 3 個），點一下同樣插入
/技能名。 - 不需要某條推薦時忽略即可；插件不攔截輸入，也不會自動觸發技能執行。
適用場景與注意¶
適合誰：本機技能較多、經常靠 / 切換工作流的用戶；希望用中文分類和搜索縮小範圍，或希望在寫長 prompt 時被輕量推薦引導到合適技能的場景。
權限與安全：插件以當前 DSH 進程權限運行，會讀取本機技能目錄與 SKILL.md 並通過本地 HTTP 提供目錄接口。安裝前建議閱讀 倉庫源碼 與 MIT 許可證，確認符合你的合規要求。
生態說明：DSH 社區插件目錄（如 SkillHub 上的 dsh-skill-pilot 頁）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；本文不將其描述爲官方應用商店。
結尾¶
dsh-skill-pilot 把「看懂技能」和「此刻該用哪個」拆成面板瀏覽與草稿推薦兩條路徑，並在本地完成中文說明與索引，適合作爲 DSH Desktop Composer 的日常輔助。進一步細節與 Issue 見 GitHub：https://github.com/ITxuezhe/dsh-skill-pilot；目錄頁：https://www.skillhub.cn/plugins/ITxuezhe/dsh-skill-pilot。
