前言¶
DeepSeek Harness (DSH) 採用插件化架構,用戶會安裝大量的技能與插件。在默認的交互中,管理這些已安裝的組件通常需要直接查看文件系統或依賴命令行。這個插件將技能和插件的可視化瀏覽與管理引入了 DSH 的設置界面。
它解決了組件分散、難以快速識別(特別是使用自定義名稱時)以及難以批量管理插件狀態(啓用/禁用/卸載)的問題。
核心功能¶
技能管理¶
進入“設置 → 倉庫”即可查看技能列表。插件會讀取 ~/.dsh/skills 下的目錄結構,解析 SKILL.md 內容。
* 自定義元數據:支持爲技能設置自定義顯示名、標籤、簡介以及 GitHub 倉庫鏈接。
* AI 雙語介紹:支持一鍵生成 AI 生成的介紹,並保存爲雙語內容(中文 / English)。內容通過特定標記分隔,客戶端支持語言切換。
插件管理¶
插件列表讀取 profile 的配置,支持對已安裝的插件進行操作:
* 啓用與禁用:操作會寫入 cordis.patch.yml,與官方插件市場的狀態保持一致。
* 卸載:會移除 dsh.profile.bundles 中的條目、dependencies 依賴以及 node_modules 中的對應文件。
* 內置插件保護:對於 @deepseek-ai/dsh-* 系列的內置插件,插件禁止執行啓用、禁用或卸載操作。
狀態管理與別名¶
- 新裝提醒:首次出現的技能或插件會在列表和卡片上顯示紅點,點擊確認即可清除。
- 日期維護:支持爲每個條目維護安裝或更新日期,新條目會自動填入當前日期。
- 輸入別名:允許用戶使用自定義顯示名(別名)來調用 Skill。在輸入框輸入
/時,候選列表會列出帶有別名的 Skill,選中後會自動替換爲原始名稱調用,不影響 DSH 的 kebab-case 命名規範。
安裝與啓用¶
使用以下命令安裝插件:
dsh plugin --profile web add <your-repo-or-package>
# 本地聯調示例:
# dsh plugin --profile web add link:/path/to/dsh-skill-browser
安裝後,請重啓 DSH。進入 設置 → 倉庫 即可看到“技能倉庫”與“插件倉庫”兩個分頁。
使用流程¶
- 查看與詳情:在技能列表中點擊技能名稱進入詳情頁,可以查看 Markdown 正文、文件列表及文件預覽。
- 生成 AI 介紹:在技能詳情頁右上角點擊“生成 AI 介紹”,AI 會在會話中生成雙語內容並保存。刷新頁面後,可通過右上角按鈕切換中英文。
- 編輯元數據:在技能或插件卡片上,可以通過“重命名”、“簡介”或“GitHub”字段編輯自定義信息。
- 插件管理:在插件倉庫中,點擊卡片右下角的按鈕進行啓用、禁用或卸載操作。
- 使用別名:在對話輸入框輸入
/,在候選列表中找到帶有自定義顯示名的 Skill 並選中,即可使用別名調用。
技術說明與注意事項¶
- 生效時機:所有的啓用、禁用或卸載操作均爲“下次啓動生效”,UI 上會有相應提示。
- 運行環境:該插件使用 React 渲染,通過注入的方式掛載到“設置 → 倉庫”區域,依賴 Node 內置模塊,無額外運行時依賴。
- 內置插件限制:嚴禁嘗試修改
@deepseek-ai/dsh-*系列內置插件的狀態,系統會攔截相關操作。 - 生態背景:該插件由社區維護,目錄與 DeepSeek 官方無隸屬關係。
源碼與文檔¶
- GitHub 倉庫:https://github.com/yustillrain/dsh-plugin-tool-repository
- 目錄頁:https://www.skillhub.cn/plugins/yustillrain/dsh-plugin-tool-repository
注:本文檔基於 2026 年 10 月 7 日的版本編寫。