cynch18/plugin-switch

English | 中文

Adds toggle switches to the DeepSeek Harness (DSH) plugin inventory page: enable or disable any plugin with one click, live, without restarting the server — and the state persists across restarts.

Features

• Live enable/disable via an active recompose channel (bypasses the platform watcher deadlock; deterministic application)
• Groups (system / third-party / local), status filters, sorting, search
• Bulk enable/disable as one transaction (single backup; undo reverts it all)
• Undo with automatic backups (latest 20 kept)
• Critical-entry confirmations, depended-on warnings with confirmation, disabled-source layering, config preview, failure diagnostics
• Multi-tab live sync, CLI recovery tool, bilingual UI, animations

Quick start

Option 1: dsh plugin add (recommended)

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

Option 2: direct download (no git)

Download plugin-switch.zip from Releases, extract it, then run:

powershell -ExecutionPolicy Bypass -File .\install.ps1

Option 3: git clone

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

Then restart dsh web, press Ctrl+Shift+R, and go to Settings → Plugins → Plugin list — every plugin row has a slider switch on the right.

⚠️ Pick ONE installation method: dsh plugin add, the zip, and install.ps1 must not be combined — installing twice in the same profile creates duplicate rows and the profile fails to start.

Options 2/3 accept -KeepOriginal (keep the original read-only inventory; HTTP API only) and -Dev (junction to the source tree for live development).

FAQ

Q: I disabled the plugin switch itself and the page disappeared — how do I get it back?

Open %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml, find the plugin-switch entry, and change disabled: true back to false (or delete the line). It takes effect within ~3 seconds, no restart needed.

Q: Toggling does nothing?

Restart dsh web and try again; if it still fails, see Troubleshooting below.

Q: I made a mistake — can I roll back?

The "↺ Undo" button restores the configuration from the backup taken before your last toggle (every toggle is backed up automatically; the latest 20 are kept).

Troubleshooting

Symptom	Fix
Toggle page missing	Use only one install method, restart dsh, hard-refresh (Ctrl+Shift+R); check that ui-settings-plugin-inventory and plugin-inventory are disabled: true in cordis.patch.yml
State does not change	Restart dsh web and retry
Host errors	Check the dsh launcher window log (loader apply/error lines)
GUI unreachable	Use the CLI recovery tool: node scripts/dsh-plugin-fix.mjs list / enable <id> / disable <id> / undo / backups (run from the repo directory)
Config file broken	Backups live in %USERPROFILE%\.dsh\profiles\web\backups\; copy the latest one back to cordis.patch.yml

Uninstall / restore the original list

• Restore the original read-only inventory: in %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml, set disabled: true back to false for ui-settings-plugin-inventory and plugin-inventory, and remove the plugin-switch entry.
• Full uninstall: delete %USERPROFILE%\.dsh\profiles\web\node_modules\dsh-profile-plugin-switch and remove the related rows from cordis.patch.yml.

Notes

• Requires DSH running the web profile (npx @deepseek-ai/dsh web), Node ≥ 22.
• Disabling the plugin switch itself removes the toggle page; restore it by changing plugin-switch's disabled: true back to false in cordis.patch.yml (the page asks for confirmation first).
• /plugin-switch is an unauthenticated local HTTP route (same trust level as DSH's built-in /plugins/...), for personal localhost use only.
• Editing index.js inside the package requires a dsh restart; editing client.js only needs a page refresh.

Development

npm install
npm test   # unit tests (applyPatchEdit / backup rotation / source detection / baked-disabled scrub)

License

MIT © 2026 CYNCH18