前言¶
DeepSeek Harness (DSH) 的插件生態需要便捷的管理入口。現有方式往往依賴外部目錄或非集成的界面，開發者需要手動查找、覈對源碼與許可證，效率較低。該插件通過本地化的界面，將瀏覽、搜索、過濾與安裝流程集成在 DSH 環境內部，提供穩定的插件發現與使用體驗。
插件簡介¶
lovstudio/dsh-plugin-marketplace 是一個本地優先的插件市場。它通過 GitHub 和 dshfind 兩個提供商，將公開倉庫的元數據同步到本地 IndexedDB 快照中，供 Web 設置和側邊欄使用。所有瀏覽、搜索和過濾操作均基於本地快照，無需實時訪問外部 API。
核心功能¶
- 本地優先架構：將倉庫元數據同步到 IndexedDB，支持本地讀取。
- 多提供商支持：支持 GitHub（通過
topic:dsh-plugin主題）和 dshfind。 - 搜索與過濾：支持 Google 風格語法，支持排序、分頁、方面篩選和關鍵詞建議。
- 界面集成：
- 在設置中註冊
settings.plugins.tab(id market)。 - 在側邊欄底部註冊
sidebar.footer.action。 - 提供
shell.overlay模態框。 - 在設置插件項中註冊
settings.plugin.item卡片。 - 質量評估：提供等級（S/A/B/C）、評分（0-100）和風險標記。
安裝與啓用¶
在使用前，請確保環境滿足以下前置條件：
- Node.js 22.19+ 或 24+
- pnpm 11
通過以下命令安裝插件：
pnpm dsh plugin --profile web add -w github:lovstudio/dsh-plugin-marketplace#v0.1.9
安裝後，在 DSH 的 Web 設置界面中即可看到名爲 “market” 的選項卡，或在側邊欄底部看到相應的操作入口。
典型用法¶
安裝完成後，可通過以下方式啓動並使用市場：
方式一：從源碼構建（推薦）
git clone --depth 1 --branch dsh-v0.1.2-rc.1 https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness && pnpm install && pnpm run build
pnpm dsh plugin --profile web add -w github:lovstudio/dsh-plugin-marketplace#v0.1.9
pnpm dsh web
方式二：使用 npx（無需構建源碼）
npx @deepseek-ai/dsh plugin --profile web add -w github:lovstudio/dsh-plugin-marketplace#v0.1.9
npx @deepseek-ai/dsh web
啓動後，在設置或側邊欄中打開市場，即可瀏覽、搜索插件並查看其質量評估信息。
注意事項¶
- 權限與安全：該插件以當前 DSH 進程的權限運行。在安裝前，請務必檢查插件的源碼與許可證（MIT）。
- Token 管理：在設置頁面測試 Token 時，系統不會保存草稿。若測試失敗或拒絕寫入，草稿會被保留並報告保存失敗。留空 Token 字段可保留已存儲的 Token。
- GitHub 速率限制：當觸發 GitHub 速率限制時，系統會保留當前頁面和冷卻時間，然後重試該頁面最多三次。
- 本地開發：若需本地開發，需將倉庫置於 Harness 目錄外，並通過
DSH_HOME環境變量和-w link:/path/to/...進行鏈接。
結語¶
該插件通過本地緩存和 IndexedDB，爲 DSH 提供了一個高效、穩定的插件管理入口。通過質量評估和清晰的搜索過濾功能，降低了插件管理的複雜度。更多細節與源碼，可參考其 GitHub 倉庫。
