前言¶
DeepSeek Harness（dsh）的理念是“一切皆插件”。當多個第三方插件部署到同一環境後，用戶需要在 Web UI 中查看這些插件、搜索插件項目，並能按需要關閉或啓動它們。
dsh-plugin-manager 是面向 DeepSeek Harness（dsh）的第三方插件管理器：在 Web UI 設置頁選擇第三方插件庫文件夾，搜索其中所有第三方插件，並一鍵關閉/啓動。
這是什麼¶
huabai-flowerwhite/dsh-plugin-manager 由 huabai-flowerwhite 維護，許可證爲 MIT。
它的核心作用不是替代 dsh 的插件加載機制，而是給已經部署的第三方插件提供一個設置頁入口：選擇第三方插件庫文件夾、掃描插件項目、展示插件列表，並通過 cordis.patch.yml 中的 disabled: true 標記切換啓停狀態。
核心功能¶
下面介紹幾個已明確的能力。
選擇插件庫文件夾並掃描¶
設置頁「第三方插件」支持選擇第三方插件庫文件夾，也支持手動粘貼路徑。點擊「掃描」後，插件會查找其中的第三方插件項目。
掃描時會識別：
dsh.plugin.yaml
package.json
並跳過：
node_modules
.git
dist
DSH 自身
設置頁啓停開關¶
「第三方插件」設置頁包含：
- 文件夾選擇
- 掃描
- 插件列表
- 啓停開關
在列表中點擊「關閉 / 啓動」即可切換插件狀態。
寫入 disabled 標記¶
一鍵關閉/啓動會寫入：
disabled: true
目標文件是：
cordis.patch.yml
寫入前會自動備份 .bak。
查詢當前狀態¶
插件提供：
/dsh-plugin-manager/status
該接口返回當前 patch 路徑與各插件啓停狀態。
安裝腳本¶
插件提供 Windows 與 POSIX 的冪等安裝腳本，重複運行無害。
安裝與啓用¶
安裝¶
安裝命令如下，按運行環境選擇對應腳本。
Windows¶
git clone https://github.com/huabai-flowerwhite/dsh-plugin-manager dsh-plugin-manager
cd dsh-plugin-manager
powershell -ExecutionPolicy Bypass -File install.ps1
Linux / macOS¶
git clone https://github.com/huabai-flowerwhite/dsh-plugin-manager dsh-plugin-manager
cd dsh-plugin-manager
bash install.sh
啓用¶
裝完後重啓 dsh：
npx dsh web
或：
dsh web
如果當前已經在運行 dsh，先按 Ctrl+C 停止，再重新啓動。
本插件隨 host composition 自動加載，啓動後進入 Web UI 即可使用。
典型用法¶
1、啓動 dsh，本插件隨 host composition 自動加載。
2、進入「設置 → 第三方插件」。
3、點擊「選擇文件夾」選擇第三方插件庫文件夾，也可以手動粘貼路徑，然後點擊「掃描」。
4、在插件列表中點擊「關閉 / 啓動」切換插件狀態。
注意：插件所在的文件夾名稱應爲“xx-xx-……”形式，即應當爲插件名，方可被本插件正確控制。
適用場景與注意¶
適合誰¶
適合已經在 dsh 中部署多個第三方插件、希望在 Web UI 裏集中查看和啓停這些插件的開發者。
生效時機¶
插件啓停在重啓 dsh 後生效。原因是 composition 在啓動時加載，本插件不改動運行中的 Loader。
啓動未掛載插件的前提¶
如果某個插件當前未掛載，點擊「啓動」時，要求該插件包已在：
profiles/node_modules
中可解析，否則 dsh 無法 import 該插件包。
目錄選擇¶
pickDirectory() 依賴官方目錄選擇器服務。該服務不可用時，可回退爲手動輸入路徑。
manifest 與權限¶
manifest 爲聲明式合規文檔；實際權限以運行時沙箱策略爲準。
運行權限¶
插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證，確認其操作範圍符合你的預期。
版本與依賴¶
package.json 中聲明：
{
"version": "1.1.0",
"engines": {
"node": ">=22 <25"
}
}
同時聲明 dsh 兼容範圍：
harness >=0.1.1-rc.2 <0.2.0
鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/huabai-flowerwhite/dsh-plugin-manager
- GitHub：https://github.com/huabai-flowerwhite/dsh-plugin-manager
