前言¶
DeepSeek Harness 的設計理念是「一切皆插件」。在擴展能力時,手動編輯配置文件管理第三方插件容易出錯。dsh-plugin-manager-lite 是一個靜態 bundle 插件,通過 Web GUI 的「設置 -> 插件 -> 第三方插件」頁面,提供對第三方插件的統一管理入口,支持列表查看、啓用/停用、卸載以及檢查更新。
核心功能¶
該插件主要解決第三方插件分散管理的問題,提供以下能力:
- 列表與過濾:自動讀取
package.json,展示非官方(非@deepseek-ai/*)插件的名稱、版本、作者及描述,並標註來源類型(本地安裝 / npm)。 - 啓用與停用:支持熱切換插件運行狀態。停用狀態會持久化寫入
~/.dsh/cordis.patch.yml,重啓 DSH 後依然生效。 - 卸載:執行停用操作,並從 profile 配置中移除依賴。
- 更新管理:對比 npm registry 檢查更新,支持一鍵安裝/升級到最新版本(僅限 npm 安裝的插件,本地
file:安裝的插件不支持)。 - 調試:提供
/tppm/debug排錯端點,可查看列表數據源的各環節實際值。
前置要求¶
- DeepSeek Harness (DSH):版本 0.1.0-rc.7 或更高(需爲 developer preview)。
- Node.js:版本 >= 18。
- Peer Dependency:
@deepseek-ai/cordis^4.0.1。
安裝¶
使用 dsh plugin 命令安裝,該命令會自動處理 profile 依賴的添加:
dsh plugin --profile web add github:ShanHaiFish/dsh-plugin-manager-lite
安裝完成後,Host 會從 ~/.dsh/profiles/web/node_modules/dsh-plugin-manager-lite/ 加載該插件。
使用方法¶
- 重啓 DSH:確保新插件生效。
- 進入界面:打開瀏覽器,進入 Web GUI -> 設置 -> 插件 -> 第三方插件。
- 操作插件:
- 點擊「刷新」重新拉取插件列表。
- 點擊「啓用」或「停用」切換插件運行狀態。
- 點擊「檢查更新」或「卸載」執行相應操作。
- 操作成功後列表會自動刷新。
開發與注意事項¶
- 同步機制:Host 實際加載的是 profile 目錄下的副本(
~/.dsh/profiles/web/node_modules/dsh-plugin-manager-lite/)。如果在開發期修改源碼,必須將改動同步到該副本再重啓 DSH 才能生效。 - 調試:遇到問題時,可訪問調試端點
/tppm/debug獲取診斷信息。 - 許可證:本項目採用 MIT 許可證。