dsh-restart-confirm
Sidebar one-click restart button for the DeepSeek Harness Web UI — with a mandatory two-step confirmation before anything happens.
| |
|---|
| Button | A compact restart icon (↻) pinned to the sidebar fold toggle — left of "收起侧边栏" when expanded, above "打开侧边栏" in the 56px rail |
| Safety | You must confirm twice before the restart is triggered |
| Scope | Restarts the dsh web process — the WebUI and the harness backend are the same process, so both come back together |
| Relaunch | Automatically re-runs the exact command that started DSH (process.execPath + process.argv) — no hardcoded paths, all flags (--host, --port, --trusted-host, profile) preserved |
| Platform | macOS · Linux · Windows (detached helper survives the kill) |
| Pending dot | Hidden by default; polls the marketplace operation snapshot every 5s and turns green only when another plugin is pending install/update/removal (restart required) |
Features
- Two-step confirmation — clicking the button opens a first dialog ("restart?"), then a final warning dialog. Only the second confirm sends the request. Both dialogs can be cancelled.
- Adaptive placement and sizing — the button is pinned next to the sidebar fold toggle via DOM placement: left of the collapse toggle when the sidebar is expanded, above the expand toggle in the 56px rail. Its SVG is 16px in the expanded row and 18px in the rail; a MutationObserver keeps it pinned through re-renders and collapse/expand transitions.
- Auto-relaunch and immediate refresh — after killing the process, the plugin re-launches DSH with the same argv from the same working directory. The client compares the health endpoint's per-process boot identity and reloads immediately when the new process is ready; there is no fixed 15–20 second client wait.
- Cross-platform, zero hardcoded paths — the relaunch command is reconstructed from the running process itself. Works with any launcher (CLI, PWA, supervisor script).
- Graceful kill — SIGTERM first, SIGKILL only if the process lingers.
- Configurable — delay before kill, delay before relaunch, optional custom restart command, optional kill-only mode (external supervisor).
- Re-entry guard — a second request while a restart is in flight is rejected.
- Loopback-only — the restart endpoint refuses non-loopback callers.
- Theme-aware UI — uses DSH's own
--dsw-alias-* tokens, so the button and dialogs follow light/dark theme.
Compatibility
Version 0.1.2 is adapted for DSH 0.1.0-rc.6 through 0.1.0-rc.8. The
client injects only the runtime and locates the sidebar through public labels,
slot/data attributes, and class suffixes; it does not require the sidebar
client package to be in this plugin's own injection graph. The host also sends
the workspace root in its shell sandbox policy for the newer shell contract.
Install
Option A — GitHub (recommended)
dsh plugin --profile web add github:seanwhy/dsh-restart-confirm
Then restart dsh web once so the bundle layer loads.
Option B — DSH Plugin Marketplace
The repo carries the dsh-plugin topic, so it is indexed by the DSH Plugin Marketplace. Open Settings → Plugins → Plugin Marketplace, search dsh-restart-confirm, and install with one click.
Option C — Manual
- Add the dependency to
~/.dsh/profiles/web/package.json:
{
"dependencies": {
"dsh-restart-confirm": "github:seanwhy/dsh-restart-confirm"
}
}
- Add the loader row to
~/.dsh/profiles/web/cordis.patch.yml (or install via the dsh plugin command which does it for you):
- insert:
- id: dsh-restart-confirm
name: dsh-restart-confirm
pnpm install in the profile, then restart dsh web.
Configuration
Plugin config (Settings → Plugins → dsh-restart-confirm → config, or the profile manifest):
| Option | Type | Default | Meaning |
|---|
delaySeconds | number | 3 | Seconds after the response before the process is killed (gives the browser time to show the "restarting" state) |
relaunchDelaySeconds | number | 2 | Seconds after the kill before DSH is relaunched |
customRestartCommand | string | '' | Custom shell command used to relaunch instead of the auto-reconstructed argv |
killOnly | boolean | false | Only kill the process; never relaunch (use when an external supervisor restarts DSH) |
How it works
| Layer | File | What it does |
|---|
| Host | lib/index.js | Registers GET /dsh-health (including a per-process bootId) + POST /restart-dsh; launches a detached helper that sleeps → SIGTERM → (SIGKILL) → relaunches with the original argv |
| Client | lib/client.js | Vanilla (no React) client that pins the sized icon button by DOM placement; shows a dot only for marketplace pending plugin operations; waits for a changed bootId and reloads as soon as the new server is healthy |
| Bundle | cordis.patch.yml | The loader row that mounts both halves |
The handler replies before the kill happens; the helper script carries the kill/relaunch delays. The client does not guess when the restart is done: it polls the health endpoint and reloads as soon as the boot identity changes.
Why an independent helper process?
If the plugin killed DSH from inside its own process, nothing would be left to relaunch it. The helper is detached (nohup sh … & on Unix, Start-Process -WindowStyle Hidden on Windows), so it survives the harness exit and brings DSH back up.
Security notes
POST /restart-dsh only accepts loopback callers (127.0.0.1 / ::1) and only POST.- The webServer binds to the loopback address by default in the shipped web profile.
- The plugin never sends data anywhere;
/dsh-health is a local-only liveness probe.
Development
The client bundle is hand-written in the exact wire format (window.__ModuleLoader__.load({ id, factory })) with no build step. It is dependency-free (no React), locating the sidebar fold toggle by stable aria-labels plus public slot/data hooks and CSS-module class suffixes so no hashed class is hard-coded:
node --check lib/index.js
node --check lib/client.js
License
MIT
