DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在管理多設備環境或使用非官方插件時,缺乏統一的分發渠道會增加維護成本。dsh-plugin-repo 作爲一個純 Cordis 插件,解決了這一痛點。
它是什麼¶
這是一個自託管插件倉庫,運行在 DSH 進程之上。每臺設備可以獨立提供 HTTP 服務,支持對 .tgz 包的列表、上傳和下載。插件內置了對非官方插件的檢測能力,並支持基於版本的感知安裝。它不修改 @deepseek-ai/* 核心包,完全通過 Cordis 擴展實現。
核心功能¶
- 自託管插件倉庫 (HTTP 服務):在本地啓動一個 HTTP 服務,提供插件分發能力。
- 包管理:支持列表、上傳和下載
.tgz包。 - 官方插件保護:檢測非官方插件,確保官方
@deepseek-ai/*插件永不在此倉庫中列出或修改。 - 跨設備同步:支持跨設備拉取和推送,實現插件分發自動化。
- 版本感知安裝:安裝前對比版本,防止意外降級。
- 設置界面:提供帶選項卡的 UI(本機/跨設備同步/高級)。
- 模型工具:提供
repo_list、repo_install等命令行工具。 - HTTP API:提供完整的 RESTful API 接口。
安裝與啓用¶
- 通過 npm 安裝插件:
dsh plugin --profile web add dsh-plugin-repo
或者從本地 tarball 安裝:
dsh plugin --profile web add ./dsh-plugin-repo-1.7.0.tgz
-
重啓 DSH 服務。
-
打開設置,進入「插件倉庫」頁面。建議使用
Ctrl+Shift+R進行硬刷新以加載新界面。
典型用法¶
安裝完成後,可以通過配置目錄 repoDir 來管理本地倉庫。在設置中,你可以直接在「本機」選項卡中查看已安裝的插件,通過「跨設備同步」選項卡在不同設備間傳遞插件,或在「高級」選項卡中配置額外的搜索路徑。
注意事項與架構¶
- 配置方式:配置使用 schemastery 風格,字段默認爲可選。
- 憑據管理:插件不嵌入登錄憑據,跨設備認證依賴本地 DSH 服務器。
- 請求發起:跨設備請求由本地 DSH 服務器發起(非瀏覽器直接請求),這確保了安全性。
- 權限要求:插件以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。
短結尾¶
dsh-plugin-repo 爲 DSH 提供了可控的插件管理方案。它不僅支持自託管,還通過 HTTP API 和跨設備同步增強了工作流。查看目錄或 GitHub 倉庫獲取更多細節。