cynch18/plugin-switch

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

Project Overview项目介绍

plugin-switch is a native plugin built exclusively for DeepSeek Harness (DSH), designed to add toggle switches to DSH’s plugin inventory page. After installation, every plugin listed in the inventory gets a toggle switch that lets users enable or disable it with a single click. Changes take effect immediately without requiring a restart of the DSH server, and the enabled/disabled state is preserved across system restarts. The plugin also supports grouping plugins by type, filtering by status, searching, bulk enable/disable operations, automatic backups, undo functionality, dependency warnings, and failure diagnosis. It also offers bilingual interface support to meet different user needs.

There are three supported installation methods, and users only need to choose one to avoid duplicate entries that cause startup errors. The recommended method is to install directly via the DSH CLI with the command dsh plugin --profile web add github:cynch18/plugin-switch. Alternatively, users can download the latest release zip from GitHub, unzip it, and run the included powershell install script. A third option is to clone the Git repository to your local machine and run the install script from the scripts folder. After installation, restart DSH web and refresh the page with Ctrl+Shift+R to see the new toggles.

This plugin has a few requirements and known caveats users should be aware of before installation. It requires DSH to be run with the web profile and Node.js version 22 or higher. If you accidentally disable the plugin-switch plugin itself, the toggle page will disappear, and you will need to manually edit the cordis.patch.yml file to re-enable it. The plugin automatically keeps up to 20 recent backups of your configuration, so you can undo any accidental changes with a single click on the undo button. If you run into issues opening the GUI, you can use the included CLI recovery tool to adjust states, and it is released under the open source MIT license.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件,功能是给DSH的插件清单页面添加滑块开关。用户点击开关即可一键启用或停用任意插件,修改立即生效,无需重启DSH服务端,开关状态在重启后也会保持。它还支持插件分组筛选搜索、批量启停、自动备份与撤销、依赖提示和故障诊断等实用功能。

三种安装方式任选其一即可,推荐使用dsh plugin命令直接安装,也可以下载发布页的压缩包运行安装脚本,或者克隆仓库后执行安装脚本。安装完成后重启DSH网页端,强制刷新页面就能在设置的插件清单看到每个插件右侧的开关。注意不要重复安装同一配置文件,否则会产生重复条目,导致DSH启动报错。

使用时,如果误关了插件开关自身导致页面消失,可以手动修改cordis.patch.yml配置文件恢复设置。插件要求DSH运行在web profile下,且Node.js版本不低于22。项目采用MIT许可开源,误操作后可以通过页面上的撤销按钮恢复到上次操作前的配置,最多保留最近20份自动备份。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

CLI Install命令行安装

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

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

READMEREADME

plugin-switch

awesome · DSH plugin release test Listed on DSH Directory

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 即可

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-mcp-admin 下一个 Next dsh-plugin-vision →