前言¶
在 DeepSeek Harness（DSH）的使用中，管理插件狀態通常涉及重啓進程或手動編輯配置文件。dsh-plugin-toggle 插件在設置 → 插件頁面新增了一個「啓用/停用」標籤頁，允許直接在 UI 中切換加載器條目的狀態。
插件介紹¶
該插件由 Zenjibad 維護，是一個客戶端插件。它通過在設置界面中添加一個可交互的標籤頁，實現插件開關的實時控制與持久化存儲。
核心功能¶
- 新增「啓用/停用」標籤頁：在設置 → 插件頁面旁添加一個新的標籤頁，顯示插件列表及其開關狀態。
- 實時切換插件狀態：切換開關會立即調用加載器的接口停止或啓動對應的插件條目，無需重啓 DSH。
- 跨重啓持久化：插件的狀態變更會被記錄到用戶配置的
cordis.patch.yml文件中，重啓後狀態依然保留。 - 狀態與階段顯示：列表中展示插件名稱、啓用/停用標籤以及當前的加載器階段（active/pending/failed/not mounted）。
- 安全鎖定機制：加載器的包含項和插件本身處於鎖定狀態，無法通過此功能切換。
- 主題適配：界面樣式適配 DSH 的明暗主題。
安裝與啓用¶
插件通過 DSH 的包管理工具安裝，安裝後需硬刷新頁面以加載新界面。
dsh plugin --profile web add github:Zenjibad/dsh-plugin-toggle
安裝完成後，必須執行硬刷新（Ctrl+F5）以使新標籤頁生效。
使用方法¶
- 打開 DSH 客戶端，進入 設置 → 插件。
- 點擊新增的 「啓用/停用」 標籤頁。
- 在列表中查看插件狀態，點擊開關即可實時啓用或停用插件。
注意事項¶
- 硬刷新生效：安裝或更新插件後，必須硬刷新瀏覽器頁面（Ctrl+F5），HMR（熱模塊替換）無法加載新的標籤頁。
- 鎖定條目：加載器的
include條目以及該插件自身處於鎖定狀態，無法切換。未知 ID 會返回 404，鎖定 ID 會返回 403。 - 持久化路徑：插件狀態變更會追加寫入當前 Profile 對應的
cordis.patch.yml文件。 - 非卸載操作：禁用操作只會停止插件運行並記錄狀態，不會從系統中卸載該插件包。
總結¶
dsh-plugin-toggle 解決了在 DSH 中快速調整插件運行狀態的痛點。它提供了直觀的 UI 操作，同時保證了配置的持久化，適合需要在運行時動態管理插件依賴的開發者使用。
