plugin-switch

English | 中文

给 DeepSeek Harness (DSH) 的插件清单页加上滑块开关：点一下即可启用/停用任何插件，立即生效、不用重启服务端，重启后状态保持。

功能

• 实时启停（主动重放通道，绕开平台 watcher 死锁，确定性生效）
• 分组（系统/第三方/本地）、状态筛选、排序、搜索
• 批量启用/停用（单事务：一次备份，撤销一步全回）
• 撤销 + 自动备份（保留最近 20 份）
• 关键条目强确认、被依赖提示 + 停用确认警告、停用来源分层、config 预览、失败诊断
• 多标签页实时同步、CLI 恢复工具、双语界面与动画

快速开始

方式一：dsh plugin add（推荐）

dsh plugin --profile web add github:cynch18/plugin-switch

方式二：直接下载（不用 git）

在 Releases 下载 plugin-switch.zip，解压后运行：

powershell -ExecutionPolicy Bypass -File .\install.ps1

方式三：git clone

git clone https://github.com/cynch18/plugin-switch.git
cd plugin-switch
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1

然后重启 dsh web，按 Ctrl+Shift+R 刷新 → 设置 → 插件 → 插件清单，每个插件右侧就是滑块开关。

⚠️ 三种方式任选其一：dsh plugin add、zip、install.ps1 不要重复安装（同一 profile 装两次会产生重复条目，重启报错）。

方式二/三的 -KeepOriginal 参数保留原只读清单（仅启用 HTTP API）；-Dev 参数建 junction 指向源码，改代码直接生效。

常见问题（FAQ）

Q：我把"插件开关"自己关了，页面消失了，怎么恢复？

打开 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml，找到 plugin-switch 条目，把 disabled: true 改回 false（或删掉这一行），保存后约 3 秒自动生效，无需重启。

Q：开关点了没反应？

重启 dsh web 再试；若仍无效，见下方故障排查。

Q：误操作了想回退？

页面上的"↺ 撤销"按钮恢复到上一次开关前的配置（每次开关前自动备份，保留最近 20 份）。

故障排查

症状	处理
开关页没出现	确认只用了一种安装方式、已重启 dsh、已强制刷新（Ctrl+Shift+R）；检查 cordis.patch.yml 里 ui-settings-plugin-inventory 与 plugin-inventory 两行是 disabled: true
开关后状态没变	重启 dsh web 再试
服务端报错	看 dsh 启动窗口日志（loader apply/error 行）
无法打开 GUI	用 CLI 恢复工具：node scripts/dsh-plugin-fix.mjs list / enable <id> / disable <id> / undo / backups（在仓库目录运行）
配置文件损坏	备份在 %USERPROFILE%\.dsh\profiles\web\backups\，把最新一份复制回 cordis.patch.yml 即可

卸载 / 恢复原版

• 恢复原只读清单：把 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml 里 ui-settings-plugin-inventory、plugin-inventory 的 disabled: true 改回 false，同时删除 plugin-switch 条目。
• 彻底卸载：删除 %USERPROFILE%\.dsh\profiles\web\node_modules\dsh-profile-plugin-switch，并移除 cordis.patch.yml 中的相关条目。

注意事项

• 需要以 web profile 运行 DSH（npx @deepseek-ai/dsh web），Node ≥ 22。
• 关闭"插件开关"自身会让开关页消失，恢复需手动把 cordis.patch.yml 里 plugin-switch 的 disabled: true 改回 false（页面上会弹确认）。
• /plugin-switch 是无鉴权的本地 HTTP 路由（与 DSH 自带 /plugins/... 同级信任），仅限个人本机使用。
• 改包内 index.js 需重启 dsh；改 client.js 刷新页面即可。

开发

npm install
npm test   # 单元测试（applyPatchEdit / 备份轮换 / 来源判定 / baked-disabled scrub）

License

MIT © 2026 CYNCH18