dsh-app-restart

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.

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

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

Platform support

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