dsh-app-restart

Adds a Restart application section to the DeepSeek Harness desktop app Settings, with a guarded button that restarts the whole application — the Electron shell, the hosted Web GUI, and the cordis Host process.

English | 中文

What it does

• Settings gains a new section ("Restart App") listing what the restart will do and whether the environment supports it.
• The button is two-step (click, then confirm) to prevent accidental restarts.
• Restart = graceful quit + automatic relaunch:
  1. a detached relauncher waits for the app main process to exit, then reopens the app bundle;
  2. the plugin triggers the platform's normal quit path — on macOS the Quit Apple Event, which the shell treats exactly like Cmd+Q, including its active-task confirmation dialog;
  3. if the user cancels that dialog, the relauncher times out and its final open merely focuses the running app — a harmless no-op.

The Electron shell offers plugins no restart IPC (app.relaunch() is main-process only), so the restart is orchestrated at the OS level from the Host process. No DSH source modifications are needed.

The navigation icon is registered into the shell’s own settings.section.icon slot (DSH 0.2.2+), keyed by the same section id — no label markup, stylesheet override, or DOM probing. On older shells that predate that slot the section still works and simply keeps the shell’s fallback gear.

Install

From GitHub (one command)

dsh plugin --profile desktop add "https://github.com/foreee/dsh-app-restart"

The Web Plugins page can install the same address through its install-by-path/git dialog.

Manual equivalent

The two steps the plugin manager performs:

cd ~/.dsh/profiles/desktop
pnpm add "file:/absolute/path/to/dsh-app-restart"   # or the GitHub address
# then add "dsh-app-restart" to package.json -> dsh.profile.bundles

Restart the desktop app once to load the plugin; the section appears under Settings from then on.

Routes

Route	Method	Purpose
api/dsh-app-restart/status	GET	availability facts for the button
api/dsh-app-restart/restart	POST	perform the restart

Both sit behind a loopback-only trust fence (loopback socket and loopback Host header, same-origin markers enforced). Paired remote devices are deliberately rejected: only the machine's own GUI may restart the app.

Configuration

Field	Default	Meaning
enabled	true	set false to mount nothing
dryRun	false	POST /restart answers with the computed plan and spawns nothing — for verification

Platform support

Platform	Quit via	Relaunch via	Status
macOS	Quit Apple Event (bundle id, then app name)	open <bundle> after the main PID exits	primary target
Windows	taskkill /PID (graceful WM_CLOSE)	PowerShell Start-Process after the PID exits	best effort; if the app cannot be closed gracefully the relauncher still reopens it after the next manual quit
Linux	SIGTERM	nohup <exe> after the PID exits	best effort

The plugin refuses to run against a development Electron checkout (no app.asar beside the executable, or the generic com.github.Electron bundle id) — a stray relaunch of the generic Electron binary would not boot DSH anyway.

Development

The client half (lib/client.js) is a hand-written window.__ModuleLoader__ bundle — the same shape tsdown emits for official client plugins — so no build step is required; edit and reinstall.

# one-time test setup (kept out of the plugin manifest on purpose)
npm i react@18.3.1 react-dom@18.3.1 react-test-renderer@18.3.1 --prefix test/react-env --cache test/react-env/.npm-cache

node test/plan.test.mjs        # plan builder + trust fence
node test/client.test.mjs      # browser bundle: registration + interaction flow
node test/host-routes.test.mjs # host routes: guards, status, dry-run, dispose

License

MIT