前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在 DSH Web 界面中管理非官方（第三方）插件，通常需要手動編輯配置文件或重啓進程。dsh-plugin-toggle 是由 huntersxy 開發的客戶端插件，它將第三方插件的管理能力下沉到 Web 設置頁，通過界面操作即可啓用或禁用插件。
功能¶
該插件主要提供以下能力：
- 列出非官方插件：列出每個 profile 中非官方的 bundle（不包含
@deepseek-ai/*前綴的 bundle 棧）以及用戶補丁插入的行。列表會顯示版本、描述和當前狀態。 - 熱重載生效：啓用或禁用插件時，插件會直接改寫 profile 下的
cordis.patch.yml文件（添加或移除disabled: true標記）。DSH 會監視該文件變化並自動熱重載，無需重啓進程。 - 刷新頁面按鈕：在「第三方插件」頁籤底部提供「刷新頁面」按鈕，用於應用修改後的界面狀態。
安裝¶
安裝該插件需要使用 DSH 的命令行工具。在終端中執行以下命令：
dsh plugin --profile web add dsh-plugin-toggle
或者，如果你本地已有該插件的壓縮包，也可以直接安裝：
dsh plugin --profile web add ./dsh-plugin-toggle-0.1.0.tgz
安裝完成後，需要重啓 dsh web 進程以加載插件。
使用方法¶
安裝並重啓後，打開 DSH Web 設置頁面，導航至「設置」→「插件」，切換到「第三方插件」頁籤即可看到已列出的非官方插件列表。在這裏你可以進行啓用或禁用操作。
工作原理與限制¶
- 實現方式：插件通過 Host 端註冊自定義路由
POST /plugin-toggle/api/<method>（支持list和set-enabled）來讀寫配置。由於 DSH 的api-proxy對第三方 settings 命名空間有寫死的白名單限制，本插件採用自定義路由通道而非內置的 settings RPC。 - 列表來源：列表基於對 profile 補丁文件的靜態解析。它只管理 bundle 棧中非
@deepseek-ai/*的 bundle 行與用戶補丁插入的行，且運行時前綴會自動歸一化。 - 安裝/卸載限制：列表僅支持開關操作。若要安裝新插件或卸載現有插件（修改 bundle 棧），必須重啓進程才能生效（頁面上的刷新按鈕僅刷新客戶端界面）。
- 熱禁用警告：若插件的 bundle 補丁包含配置行或表達式行（非純 insert），熱禁用可能不完整。插件列表會顯示警告提示，並在禁用時提醒用戶重啓進程後完全生效。
