dsh-power-button
Self-contained power control for DSH: sidebar power button with an upward 重启/关机 menu plus a Windows-shutdown-style overlay. Own restart & shutdown engine (no dependency on other plugins), MIT licensed.
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add github:keyiadiannao/dsh-power-button#a5b1870f90b89205df348349aeeb077ae072fafa
Power Button is published as dsh-power-button and currently resolves to version 0.2.1. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
A self-contained power & lifecycle controller for DeepSeek Harness: a sidebar power button with a Restart / Shutdown menu and a full-screen transition overlay. The restart/shutdown engine is built into the plugin — no third-party dependencies.
Developed with DeepSeek AI assistance; reviewed before release.
.cjs helper that waits for the old process to exit and the port to free, then relaunches DSH with the same execPath/execArgv/argv/cwd. No PowerShell, no taskkill./restart and /shutdown commands, plus a restart_harness model tool (same name as anweat/dsh-restart; registration is skipped when another plugin already owns the name).locale.preference.restart-helper-*.log files older than 7 days are pruned from the runtime directory.① Sidebar power button — a theme-aware footer entry, styled to match the adjacent Settings trigger.
Power button in the sidebar footer
② Restart / Shutdown menu — opens from the power button; two actions, one click away.
③ Shutdown confirm dialog — guard against accidental shutdowns: the default focus sits on Cancel, and only an explicit confirm actually stops the process.
④ Shutdown progress overlay — a Windows-style full-screen transition showing the current stage while the process winds down.
⑤ Restart completed toast — after the page auto-reloads, a success notice confirms DSH is back.
dsh plugin --profile web add "github:keyiadiannao/dsh-power-button#master"
Restart DSH; a power button appears in the sidebar footer. Requires Node ≥ 22.19.
The plugin is configured through the profile's cordis layer (cordis.patch.yml or the settings UI):
| Key | Default | Meaning |
|---|---|---|
enableModelTool | true | Register the restart_harness model tool. Set false to keep restart exclusively on the GUI button and /restart. |
maxDelayMs | 5000 | Upper bound (ms) for the model tool's delayMs argument. The effective floor is 1000 ms. |
Example:
- id: dsh-power-button
config:
enableModelTool: true
click power → menu → Restart
[host] POST /api/dsh-power-button/restart
→ write ~/.dsh/restart-helper-<pid>-<ts>.cjs
→ spawn `node <helper>` (detached, windowsHide)
[helper] wait for old PID to exit → wait for port to free
→ spawn DSH again with same execPath/argv/cwd → self-delete
[host] terminate after the HTTP response flushes
[client] poll health → confirm new instanceId → auto reload
Shutdown posts /api/dsh-power-button/shutdown and terminates without relaunching. Because it is irreversible (the process must be started manually), the GUI confirms shutdown in a dialog before it fires — a second click is required. (/shutdown and the model tool remain single-action by design; the model never exposes shutdown.)
Design notes (from real issues hit during development):
detached + unref), otherwise terminating DSH kills the helper mid-flight..cjs file, not node -e: multi-line node -e scripts are mangled by Windows CreateProcess and die with a silent SyntaxError.instanceId that must change (old → new), so a brief outage alone never fakes success.(size, mtimeMs) until two consecutive samples are identical (bounded at ~15s) before relaunching. The old process's session write-behind buffer can keep draining after its main loop exits; relaunching into a file that is still being appended interleaves stale seq numbers and corrupts the session — this check closes that window.ctx.get('appExit'). appExit is an optional host value this plugin does not declare in inject, so the context proxy resolves ctx.appExit to undefined — reading it as a property silently skipped graceful disposal on every restart and shutdown, hard-killing through process.exit instead (losing the tree teardown, the storage flush, and the port release). Official readers (dsh-cmdline, dsh-headless) go through ctx.get for the same reason.appExit, a 15s watchdog hard-exits if the process is still alive. DSH disposes the tree under its own 5s cap, but that cap only forces exit while disposal is still running — a disposal that resolves early leaves the process to end on its own, and a single lingering handle (background job, MCP child, plugin-owned listener) can then keep the event loop alive past the helper's 30s patience, at which point the helper gives up without relaunching and the user is left with no server. The watchdog keeps the restart inside the helper's patience either way.Host must be a loopback authority, and a browser Origin must match.409).delayMs is floored at 1000 ms — the model cannot kill the process before its own turn settles.~/.dsh/restart-helper-<pid>.log); helper and marker files are written 0600, the runtime directory 0700.After a successful restart the plugin shows a small localized toast
("Restarted" / "已重启" depending on the UI language) in the corner of the UI.
This is purely a UI notice: nothing is written into any session log. (This
replaced an earlier design that
appended a synthetic assistant/message (turn: 0, step: 0) into the resumed
conversation — that approach tripped the token-meter's step-pairing invariant
and could corrupt large sessions, so it was removed. Tracked upstream:
deepseek-ai/DeepSeek-Harness#802.)
Mechanics:
/health reports
restarted: true, fromInstanceId: <old>./health also reports appExit: "available" | "missing" — whether the
launcher-provided exit channel actually resolves in this host. missing
means every restart falls back to process.exit (no graceful disposal), so
the field turns a 30s restart stall into a one-request diagnosis./health once after load; when restarted is true it
shows the toast, then ACKs via POST /api/dsh-power-button/notice-shown
so a later refresh does not re-show it.npm run build # tsdown: host + client bundle
npm run typecheck # tsc --noEmit
npm test # vitest: marker lifecycle, delayMs clamp, argv redaction, log pruning, exit channel
Tests isolate DSH_HOME via a vitest setup file, so they never touch your
real ~/.dsh. Artifacts: host at lib/index.js, client bundle at
lib/client.js (both committed — git installs are build-free).
MIT. The "detached helper relaunch" idea follows anweat/dsh-restart (MIT); the implementation is independently written (real .cjs file, no PowerShell, dynamic port), no code copied.