cynch18/plugin-switch

Name: cynch18/plugin-switch
Author: cynch18

Plugin插件 Native原生 ⭐ 4 MIT Dev Workflow开发与代码工作流 UI & Themes界面与主题

DSH Web 插件：无需重启服务器即可在图形界面中启用/禁用插件

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

plugin-switch adds toggle switches to the DeepSeek Harness (DSH) plugin inventory page, enabling or disabling plugins live without restarting the service. It includes grouping, search, batch operations, one-click undo with automatic backups (last 20), multi-tab sync, a CLI recovery tool, and a bilingual interface. Requires the web profile and Node 22+. Do not install twice in the same profile: duplicate entries from repeated installation cause dsh startup errors.

plugin-switch 为 DeepSeek Harness (DSH) 插件清单页添加滑块开关，支持实时启停插件而无需重启服务，并具备分组筛选、批量操作、撤销与自动备份（保留 20 份）、多标签页同步、CLI 恢复工具及双语界面。需以 web profile 运行、Node ≥ 22；切勿重复安装，同一 profile 二次安装会因条目重复导致 dsh 启动报错。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我了解并安装插件：【plugin-switch】【https://github.com/cynch18/plugin-switch】

Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

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

把 cynch18/plugin-switch 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

4.5 KB · 缓存于 2026-09-07 19:40:37 · 4.5 KB

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

渲染基于仓库 cynch18/plugin-switch 的 README.md。在 GitHub 查看原文 →

CLI Install命令行安装 Copy Install复制安装命令