前言¶
在使用 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 插件环境，利用热插拔特性提高调试和部署效率，而无需频繁重启服务。
