dsh-self-update

English | 简体中文

In-app self-update for DeepSeek Harness git-source installs — with an optional native macOS shell.

What is this?

If you run DeepSeek Harness from a git checkout (git clone + pnpm dsh web) — the way most self-hosted setups do — there is no built-in way to update it. Every release means manually running git pull, pnpm install, pnpm build, then restarting the service, and if anything breaks you dig out the old commit by hand.

dsh-self-update turns that whole cycle into a button. It is a harness plugin that:

• checks quietly in the background (every 6 h by default) and on demand, from the settings page or the macOS menu bar;
• shows a "new version" entry in the sidebar when there is something to install — clicking it opens an update panel with a version comparison and exactly the three commands about to run;
• installs in one click: git pull --ff-only → pnpm install → pnpm build:official (official branding build), with live per-step progress;
• refuses to touch a dirty or diverged working tree — it will never discard your local changes;
• rolls back in one click if a step fails (and ships a CLI fallback for when the UI itself is down);
• restarts the service through a simple contract: the process exits with code 75, and your supervisor — systemd, PM2, or the bundled macOS shell — brings it back up.

Not for you if you installed dsh via npm i -g @deepseek-ai/dsh: there is no git working copy to update, so this plugin hides itself entirely. Use an npm-based updater such as dsh-update-checker instead.

Install (any platform)

cd <your-deepseek-harness-checkout>
pnpm dsh plugin --profile web add dsh-self-update

Restart the dsh service once and you are done. No configuration needed — the plugin uses the process working directory as the harness checkout (override with the plugin config repoRoot if yours differs).

Closing the restart loop

The Restart now button makes the process exit with code 75 ("please restart me"). Teach your supervisor to honor it:

macOS shell (optional)

A native Swift + WKWebView app (no Electron) that owns the dsh service: click the icon to open the UI, closing the window keeps the service running, ⌘Q stops it. It adds a "Check for Updates…" menu item that opens the in-app update panel, and it automatically relaunches the service when it exits with code 75.

node macapp/build-mac-app.mjs        # requires Xcode command line tools
# outputs ~/Applications/DSH.app

First launch: right-click → Open (the app is ad-hoc signed, not notarized).

How it compares

The exit-code-75 restart contract is the piece the community has been asking the harness core for (see upstream discussions #1231 and #2717) — this plugin is a working implementation of it.

Interface contract

• HTTP — /self-update/api/update/{status,check,install,rollback,restart}. Write routes require Content-Type: application/json and a local Origin (CSRF line of defense).
• Panel event — dispatch dsh-self-update:open on window (detail: { check: true } to check immediately). This is exactly what the macOS menu item does via evaluateJavaScript.
• Restart — process exit code 75 means "restart requested". Anything else is a crash.
• State — persisted at ~/.dsh-self-update/update-state.json.

When the UI is gone

If an update leaves dsh unable to boot (plugin/core seam breakage), the Web UI — rollback button included — is gone with it. Fall back to the CLI:

node scripts/rollback-harness.mjs          # target = previousSha from the state file
node scripts/rollback-harness.mjs --sha <commit>   # or pick a commit yourself

The updater records previousSha before every install precisely for this moment.

Development

Sibling layout, same as the rest of the dsh plugin ecosystem: this repo must be checked out next to deepseek-harness — the @deepseek-ai/* dev dependencies are link:../deepseek-harness/....

pnpm install
pnpm typecheck && pnpm test && pnpm build

The updater test suite runs against real (offline) git repositories; only the install/build commands are stubbed.

License

MIT