DSH Web GUI 插件控制中心：以卡片列表聚合展示當前 profile 已安裝插件，顯示名稱、版本與簡介，並提供在線啓用/停用開關。
前言¶
在使用 DeepSeek Harness (DSH) 進行智能體開發時，插件是核心組件。管理這些插件通常涉及編輯配置文件或重啓服務。停用插件時，如果僅僅移除加載邏輯，可能會導致插件殘留（例如寵物插件變成不可交互的“殭屍”）。本插件旨在通過 Web GUI 提供可視化的插件管理入口，解決手動維護配置與狀態同步的問題。
核心功能¶
- 設置頁新增一級區塊「插件控制」。
- 卡片展示每個 Loader 插件條目：名稱、版本、簡介、啓用狀態。
- 支持搜索與「僅顯示已安裝插件」過濾。
- 在線開關直接寫入 profile 層
cordis.patch.yml，由 DSH 現有 HMR watcher 熱生效。 - 設置感知開關：對通過自身設置項控制界面的插件（如 dsh-pet），停用會寫它的設置開關，確保插件真正消失而非殘留。
- 核心基礎設施條目與本插件自身不可關閉，避免誤操作。
安裝¶
通過官方 CLI 命令安裝：
dsh plugin --profile web add https://github.com/CloudFan-cyf/dsh-plugin-control
安裝後需重啓 dsh web 以加載新界面。後續的插件開關操作將利用 HMR 熱更新，無需再次重啓。
典型用法¶
- 重啓
dsh web。 - 打開 設置 → 插件控制。
- 在卡片列表中查看當前 profile 已安裝的插件。
- 點擊卡片上的開關即可啓用或停用插件。
適用場景與注意事項¶
- 適用場景：需要快速查看和管理已安裝插件狀態的 Web 環境用戶。
- 層級衝突：本插件僅管理 profile 層的
cordis.patch.yml。如果 home 層（~/.dsh/cordis.patch.yml）存在同名補丁，需要用戶自行處理。 - 註釋處理：改寫 patch 文件時，YAML 註釋可能會被規範化處理導致丟失，但語義會被保留。
- 安全限制：API 路徑前綴爲
/api/dsh-plugin-control，且僅允許 loopback + 同源請求。 - 權限要求：插件以當前 dsh 進程權限運行，安裝前請檢查源碼與許可證。
- 自動備份：首次改寫 patch 文件前，系統會自動備份爲
cordis.patch.yml.dsh-plugin-control.bak。
生態背景¶
DSH 理念是「一切皆插件」，社區目錄與 DeepSeek / 幻方無官方從屬關係。本插件由社區開發者 CloudFan-cyf 維護，遵循 MIT 許可證。
