前言¶
DeepSeek Harness (DSH) 採用“一切皆插件”的架構。爲了方便管理社區插件,需要一種集中式的目錄與驗證機制。dsh-plugin-store 將插件市場直接集成到 DSH Web GUI 的設置中,提供精選目錄、GitHub 發現以及結構驗證功能,讓用戶無需離開界面即可完成插件的校驗與安裝。
核心功能¶
- 目錄與發現:提供基於
awesome-dsh-plugin生態的精選目錄(包含離線優先快照)以及 GitHubtopic:dsh-plugin的實時發現(取前 30 個非 Fork 倉庫)。 - 結構驗證:僅允許安裝根目錄
package.json聲明瞭name、version和dsh.bundle.patch的插件。安裝前會進行實時重新驗證。 - 安全機制:所有修改操作(POST)限制在 8KB 以下,必須通過同源檢查和進程級隨機令牌驗證。
安裝與啓用¶
通過 CLI 安裝到 web 配置文件:
dsh plugin --profile web add github:anjaymi/dsh-plugin-store
安裝完成後需重啓 Web GUI:
dsh web
重啓後,在 Web GUI 的「設置 → 插件」中會出現「插件市場 / Plugin Store」標籤頁。
使用方法¶
- 過濾與搜索:支持按倉庫名或描述搜索;標籤頁提供「全部 / 精選 / 新發現 / 結構已驗證 / 已安裝」的分類篩選;支持按分類篩選。
- 操作:點擊「校驗並安裝」或「安裝」觸發驗證或安裝流程。任務面板會實時顯示安裝狀態和輸出。
- 星標展示:顯示真實的 GitHub 星標數量。精選條目缺失星標時,會通過後臺接口回填。
注意事項¶
- 卸載:v0.1 版本暫不支持卸載功能。
- 安裝限制:僅接受
owner/repo格式的 Git 規範,不接受二進制文件或本地路徑。 - 重啓要求:安裝成功後,需重啓
dsh web才能使插件生效。 - 緩存機制:目錄緩存每 2 小時刷新一次。
- 配置要求:插件以當前 DSH 進程的權限運行,安裝前應檢查源碼與許可證。
結尾¶
該插件解決了 DSH Web 環境下插件管理的痛點,通過結構化驗證和安全限制,確保了安裝的可靠性。更多細節請參考項目主頁。