前言¶
在 DeepSeek Harness(DSH)裏用技能,常見做法是手打 /技能名,或從文檔裏複製路徑。技能一多,很難快速找到「這次任務該用哪一條」,也缺少「這一輪到底調了哪些 skill」的直觀反饋。桌面端輸入框旁本來可以有一顆「技能」按鈕;維護者 AlLHHH 把這套交互拆成獨立插件 dsh-skill-palette(README 裏也叫 SkillMate / 技能助手),用分類、搜索、收藏和中文說明把選 skill 和寫進輸入框連成一步,並在回答末尾標出本輪用到的技能。
這是什麼¶
dsh-skill-palette 是 DSH 的客戶端類插件:在會話輸入框右側提供「技能」按鈕,點開是全部技能的清單;選一項會在光標處插入 /技能名(帶尾隨空格),由 DSH 渲染成藍色 chip。包名 dsh-skill-palette,當前版本 0.1.4,許可證 MIT。目錄頁:skillhub.cn/plugins/AlLHHH/dsh-skill-palette;源碼與說明:github.com/AlLHHH/dsh-skill-palette。
核心功能¶
下面按 README 已寫明的行爲歸納,不超出資料範圍。
瀏覽與插入¶
- 按用途分類:設計、寫代碼、審查、寫東西、視頻、辦公文件、逆向、通用八個桶,外加「其他」。分類表是手寫的;新技能未歸類時,按名稱和描述裏的關鍵詞自動進桶,都不中才進「其他」。
- 搜索:可匹配技能名稱、英文描述、中文說明、分類名。
- 最近使用:保留最近 24 條,每用一次頂到最前。
- 收藏:每行右側 ☆ / ★;收藏頁裏每用一次自動置頂。
- 圖釘:釘住後點技能不收起面板,可連續選多個;未激活爲灰色描邊,激活爲藍色描邊。
- 點選即寫入輸入框:插入
/技能名,不走剪貼板複製。
回答下方的 skill 展示¶
每條回答末尾可顯示一行小膠囊(例如 /systematic-debugging),鼠標懸停可看中文說明;一輪未用技能則不顯示。顯示位置可在設置裏改:回答下方 / 輸入框右邊 / 兩者 / 不啓用(默認回答下方)。
中文說明與翻譯¶
內置約 90 個常用技能的中文一句話說明。新技能沒有說明時,面板頂部會出現「N 個技能還沒有中文說明」和「翻譯 N 條」按鈕;點擊後用「設置 → 模型」裏選的默認模型翻譯,結果寫入 <dsh home>/skill-zh.json,之後不重複翻。翻譯只把技能名和英文描述發給模型,不發對話、不發文件、不記日誌。
設置頁(設置 → 技能助手)¶
- 增強 skill 的使用率:在系統提示里加一段「先匹配技能再動手」(默認開,約 90 token/次)。
- 顯示會話調用 skill 的位置:見上文四種選項。
- 翻譯相關:缺中文提示、立即翻譯所有缺中文的技能、新技能自動翻譯;界面會提醒會消耗 token。
- 底部顯示當前版本與「檢查更新」(只讀 registry,10 分鐘內複用同一次結果,不會自動下載安裝)。
安裝與啓用¶
官方安裝方式如下。
# npm
dsh plugin add dsh-skill-palette
# 從 GitHub 裝
dsh plugin add github:AlLHHH/dsh-skill-palette
插件自帶 cordis.patch.yml,裝進 profile 後會自動插入 skill-picker 一行,無需手改配置。裝完後刷新頁面,或在「應用菜單 → 重啓應用」。
環境要求:DSH >= 0.2.0-0;README 寫明實測桌面版 0.2.1-rc.3。客戶端通過 window.__ModuleLoader__.load 與 slots(conversation.input.right、settings.section、conversation.chat.turnTail)接入;宿主提供翻譯、增強開關、版本檢查等 /api 路由,依賴 connection、llm、agentDefaultModel、systemPrompt 等服務——缺某項時僅對應功能不可用,不會拖垮啓動。
典型用法與自檢¶
確認插件在工作¶
- 看輸入框右邊是否有「技能」按鈕;點開標題爲「技能 · N」,N 應等於已裝技能總數(
~/.dsh/skills/*/SKILL.md加上技能包內置入口)。 - 新技能是否出現:在
~/.dsh/skills/下新建目錄並放入SKILL.md(frontmatter 至少含name和description),重新打開面板應多一行;面板開着時最多約 60 秒自動刷新。 - 翻譯:對新技能點「翻譯 N 條」,成功後該行顯示中文,且
~/.dsh/skill-zh.json多一條記錄。請求走POST /api/dsh-skill-palette/skill-zh,用已配置的默認模型,無需另填 key;失敗會在按鈕旁寫出原因(例如未選默認模型)。 - 版本:設置頁底部「檢查更新」向 registry 查詢
latest標籤。
日常操作¶
需要某類能力時,點「技能」→ 按分類或搜索找到條目 → 單擊插入 /技能名 → 照常發送。若要連續插入多個 skill,先打開圖釘再點選。回答完成後,在默認配置下於回答下方查看本輪用到的 skill 膠囊。
適用場景與注意¶
適合:本地技能數量較多、希望按任務類型瀏覽而非死記命令;需要中文說明或批量補譯;希望在對話裏看見「這一輪用了哪些 skill」的開發者。
已知限制(來自 README):中文說明表手寫,新技能需按鈕翻譯或提 issue 補表;翻譯一次最多 40 條,客戶端按 20 條一批串行,模型返回非 JSON 時整批失敗;分類靠關鍵詞,個別技能可能落在不理想的桶;「檢查更新」不自動安裝。
安全與權限:插件在當前 DSH 進程權限下運行,安裝前建議閱讀倉庫源碼與 MIT 許可證,確認翻譯與增強提示等行爲符合你的環境策略。社區目錄 skillhub 爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-skill-palette 把「選 skill → 寫進輸入框 → 看見本輪調用」串成一條線,並附帶分類、收藏、搜索與可選的中文翻譯。需要安裝或 issue 時,見 GitHub 倉庫 與 SkillHub 目錄頁。