DeepSeek Harness(DSH)基於 Cordis 架構,所有功能以插件形式存在。此前,控制插件啓用狀態需手動編輯 ~/.dsh/cordis.patch.yml。dsh-plugin-manager 插件在設置 → 插件 中新增“插件管理”標籤頁,提供可視化的開關操作與狀態查看。
功能¶
插件管理頁面主要包含兩個分區:
-
自定義插件
- 默認展開,列出所有非官方核心組件(模塊名不在
@deepseek-ai/*範圍內)。 - 每個插件帶有一個開關,支持即時啓用或停用,無需重啓 DSH。
- 開關狀態會寫入用戶級補丁層
~/.dsh/cordis.patch.yml,重啓後保持。 - 以後新安裝的插件會自動出現在這個分區。
- 默認展開,列出所有非官方核心組件(模塊名不在
-
核心組件
- 默認收起,展示所有核心組件的掛載狀態(如已掛載、等待依賴、掛載失敗等)。
- 界面與服務端雙重保護,開關處於禁用態,保持現有狀態不可切換。
每個條目同時顯示模塊全名、條目 id、啓用狀態與運行狀態指示燈。
安裝¶
CLI 安裝(推薦)¶
使用 DSH CLI 安裝會將插件打包進 profile(pnpm),並藉助包內聲明的 dsh.bundle.patch 層自動完成掛載。
dsh plugin --profile web add github:big-lixin/dsh-plugin-manager
該命令依賴 bundle 層棧,安裝後需重啓一次 DSH 才能生效。
手動安裝¶
手動安裝支持熱掛載,無需重啓。
- 將倉庫複製到
~/.dsh/profiles/web/node_modules/dsh-plugin-manager。 - 在
~/.dsh/profiles/web/cordis.patch.yml中追加掛載行:
- insert:
- id: plugin-manager
name: dsh-plugin-manager
- 保存後 Host 半件立即掛載,刷新瀏覽器頁面即可在 設置 → 插件 中看到“插件管理”標籤頁。
使用方法¶
- 啓用/停用:在管理頁切換自定義插件的開關,操作會立即寫入補丁文件並生效。
- 升級插件:通過 CLI 更新插件。
dsh plugin --profile web update dsh-plugin-manager
注意事項¶
- 自身停用:本插件自身也會出現在“自定義插件”分區。停用它會導致管理頁失效;恢復方法爲編輯
~/.dsh/cordis.patch.yml,刪掉標記塊中對應的掛載行。 - 卸載:卸載需摘掉
profiles/web/cordis.patch.yml中的掛載行(熱卸載立即生效),再刪除包目錄。如果曾用開關停用過某插件,卸載後建議順手清理~/.dsh/cordis.patch.yml標記塊中的殘留條目。 - 手動安裝風險:手動複製進
node_modules的目錄不屬於 pnpm 管理。若以後對 profile 重新執行pnpm install,該目錄可能被清空,需按手動安裝步驟重新操作。
結語¶
dsh-plugin-manager 將插件配置從命令行或編輯器轉移到了 Web 界面,降低了 DSH 開發者的配置門檻。如需查看源碼或提交 Issue,可訪問 GitHub 倉庫。