前言¶
在使用 DeepSeek Harness (DSH) 進行智能體開發或服務管理時，插件系統的靈活性至關重要。默認情況下，啓用或禁用已安裝的插件通常需要重啓 DSH 進程，這會中斷當前的運行狀態。爲了解決這一痛點，下面介紹 dsh-plugin-toggle。
這是什麼¶
dsh-plugin-toggle 是一個由 aorucshiea 維護的 DSH 插件。它爲已安裝的插件提供了熱插拔的開關功能，允許在不重啓 DSH 的情況下實時啓用或禁用插件。該插件通過修補官方的客戶端/主機文件來擴展 DeepSeek Harness Web UI 的功能。
核心功能¶
- 插件列表與描述：在 DSH Web UI 的插件列表中展示已安裝插件及其描述。
- 熱插拔開關：提供啓用/禁用插件的功能，無需重啓服務。
- 核心插件保護：內置
CORE_DENYLIST，防止核心插件被意外禁用。 - UI 自動修補：啓動時自動應用補丁，修復官方插件清單 UI 的顯示問題。
- 預設菜單自動隱藏：當
dsh-preset-switch被禁用時，會話頭部的預設下拉菜單會自動隱藏（每 5 秒輪詢一次 + 窗口焦點事件觸發，無需手動刷新）。
安裝與啓用¶
通過 DSH 的插件管理器安裝此插件：
dsh plugin --profile web add github:aorucshiea/dsh-plugin-toggle
安裝完成後，插件會隨 DSH 服務啓動並自動應用相關補丁。
典型用法¶
- 打開 DSH Web UI。
- 進入 Settings（設置） -> Plugins（插件）。
- 在插件列表中找到目標插件，點擊 Disable / Enable 按鈕。
- 注意查看核心插件，它們會被標記爲 Protected（受保護）狀態，無法被禁用。
注意事項¶
- 文件修補機制：該插件在啓動時會修補官方的客戶端或主機文件。該過程是冪等的，如果目標文件處於損壞狀態，它會恢復安全行爲。
- 運行權限：插件在當前 DSH 進程的權限下運行。
- 安全與合規：倉庫中不存儲任何 API 密鑰或憑據。在安裝前，建議檢查源碼和許可證（MIT）。
總結¶
通過 dsh-plugin-toggle，開發者可以更精細地控制 DSH 插件環境，利用熱插拔特性提高調試和部署效率，而無需頻繁重啓服務。
