前言¶
DeepSeek Harness(DSH)的核心理念是“一切皆插件”。在開發過程中,管理第三方插件需要手動在終端執行安裝命令,或者從外部目錄複製粘貼,缺乏統一的入口。99galaxy/dsh-plugin-market 解決了這個問題,它是一個 DSH bundle,在設置面板中新增了“DSH 插件市場”一節,提供目錄瀏覽、狀態管理和一鍵安裝的能力。
核心功能¶
這個插件市場連接了維護在 awesome-dsh-plugin 的官方目錄,提供以下能力:
- 瀏覽與安裝:在設置面板內直接瀏覽插件目錄,點擊“安裝”按鈕即可執行官方安裝命令。
- 篩選與排序:支持按分類篩選,以及按 Star 數、下載量、名稱或收錄時間進行排序。
- 狀態管理:提供三個標籤頁。全部插件顯示完整目錄;已安裝列出當前 profile 已安裝的插件;可更新列出目錄中有新版本可升級的插件。
- 中英切換:插件簡介支持中文/英文實時切換。
- 本地緩存:目錄數據緩存於本地,1 小時內複用;如需最新數據,可點擊“強制重新獲取”。
- 降級策略:在獲取目錄時,採用四級降級機制(官方域名 → 鏡像 → CDN → npm),確保可用性。
安裝與啓用¶
這是一個 DSH bundle,安裝後需重啓 DSH 才能自動加載。
首先,進入你的 profile 目錄(默認爲 ~/.dsh/profiles/web),使用 pnpm 安裝包:
cd ~/.dsh/profiles/web
pnpm add github:99galaxy/dsh-plugin-market
安裝完成後,必須將該包名顯式聲明在 package.json 的 dsh.profile.bundles 列表中,DSH 纔會識別並加載它:
{
"dsh": {
"profile": {
"bundles": ["...", "@99galaxy/dsh-plugin-market"]
}
}
}
保存文件並重啓 DSH。
使用步驟¶
- 打開 DSH 設置面板,找到“DSH 插件市場”一節。
- 在“全部插件”標籤頁瀏覽或搜索,點擊卡片右側的“安裝”按鈕。
- 安裝完成後重啓 DSH,插件纔會生效。
- 在“已安裝”標籤頁確認安裝狀態,在“可更新”標籤頁處理版本升級。
注意事項¶
- 包名識別:雖然倉庫名爲
99galaxy/dsh-plugin-market,但在package.json中聲明時必須使用 scope 包名@99galaxy/dsh-plugin-market。 - 更新行爲:點擊“更新”執行的是目錄中記錄的官方安裝命令,這可能導致插件來源變更(例如從 GitHub 安裝變爲從 npm 安裝)。如果需要鎖定特定來源,不建議點擊更新。
- 安裝限制:目錄中列出的安裝命令,其包名不能以
-開頭,否則會被拒絕執行。 - 接口安全:HTTP 接口要求同源調用(校驗
Sec-Fetch-Site與Origin)以及Content-Type: application/json,以確保安全。