前言¶
在 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 操作，同时保证了配置的持久化，适合需要在运行时动态管理插件依赖的开发者使用。
