前言¶
DSH 的理念是「一切皆插件」。對於需要頻繁調用外部技能的開發者來說,直接在 DSH 設置中管理 Skills.sh 上的資源比手動下載和配置更高效。DSH Skills 插件解決了這一痛點,提供了一個可視化的入口來搜索、安裝和管理技能。
這是什麼¶
DSH Skills 是一個由 Zh0uHX 維護的客戶端插件(MIT 許可證)。它將 Skills.sh 的技能庫集成到 DSH 的設置界面中,允許用戶在本地搜索、安裝、更新和卸載技能文件,無需離開 DSH 環境。
安裝¶
在終端中執行以下命令安裝插件:
npx --yes @deepseek-ai/dsh@0.1.7-alpha.1 plugin --profile web add github:Zh0uHX/dsh-skills
安裝完成後,啓動 DSH 進程:
npx --yes @deepseek-ai/dsh@0.1.7-alpha.1 web
打開 設置 → Skills。如果 DSH 進程已在運行,需要重啓以加載插件。
使用方法¶
- 搜索:在搜索框輸入至少兩個字符,系統會調用官方
/api/search接口返回結果。 - 查看結果:列表展示技能的簡介、來源、安裝量以及 Skills.sh 的原頁面鏈接。
- 管理技能:
- 進入「已安裝」標籤頁。
- 選擇技能,可以檢查更新、更新或卸載。
- 更新和卸載操作需要確認。
- 更新時會比較完整文件內容摘要,覆蓋安裝會替換本地修改。
技術細節與限制¶
- 權限與配置:管理技能不需要配置模型 API Key。插件默認寫入
~/.dsh/skills,若設置了DSH_HOME則寫入$DSH_HOME/skills。 - 目錄隔離:插件只管理自己安裝的技能,不接管其他工具寫入的目錄。
- 衝突處理:
- 如果技能根目錄存在同名技能,安裝會中止。
- 項目技能等其他目錄中的同名技能,仍可能按 DSH 原生優先級覆蓋它。
- 數據來源與安全:
- 搜索和下載僅訪問
skills.sh或www.skills.sh,無需 API Key。 - 公共接口無版本保證,格式變化會報錯且不寫入目錄。
- 下載接口提供文本快照,不支持圖片、字體等二進制附件的完整下載。
- 插件拒絕路徑穿越、符號鏈接、重複路徑及文件/目錄衝突,不執行下載的腳本。
- 搜索和下載僅訪問
- 文件限制:單個技能最多支持 256 個文件,單文件限制爲 2 MiB,總大小限制爲 8 MiB。
- 可靠性聲明:插件不聲稱能抵禦同一系統用戶的惡意進程製造的文件系統競爭條件。