miisaka19800/dsh-restart-fab
A floating one-click restart button for the DeepSeek Harness web GUI — self-contained, cross-platform.
Listed
1
Ui
Bundle verified
Preview
What it does
Floating restart button for the DSH web GUI: restarts the dsh process in place with a full-screen overlay and auto-reloads the page; no launcher script required, works on Windows/macOS/Linux.
Best for
- DSH Web GUI users who frequently need to restart the host after configuration or plugin changes.
- Cross-platform setups that need to relaunch DSH with the same command line, workspace, port, profile, and flags.
- Users who want restart progress, automatic host polling, and page reload in the existing tab.
Not ideal for
- Headless or non-Web DSH workflows where a floating GUI control adds no value.
- Situations where interrupting the current dsh web process is unacceptable, even though persisted sessions can resume afterward.
- Deployments that require an external supervisor or launcher to own restart policy rather than an in-process button.
- Users expecting the plugin to restart unrelated services or change launch arguments.
README
dsh-restart-fab
A floating one-click restart button for the DeepSeek Harness web GUI.
Pinned to the bottom-right corner of the page: one click arms a confirmation, a second click restarts DeepSeek Harness in place — the page shows a full-screen “restarting” overlay and automatically reloads onto the new host once it is back up. No manual refresh, no second tab, no launcher script.
Features
-
Fully self-contained — the restarted host is relaunched with the exact
same command line that started the current one (
node …/bin.js web --port N), preserving workspace, port, profile and flags. No dependency on any launcher script (DSH启动器.exe, shell wrappers, etc.). -
Cross-platform — Windows (force kill via
taskkill), macOS/Linux (gracefulSIGTERMthenSIGKILL). - Fast — the old process is killed ~1.6 s after you confirm; the new host starts immediately.
- Clean UX — full-screen overlay with a spinner and elapsed timer while restarting; the page polls the host every second and reloads itself the moment the new host responds. A “refresh now” fallback appears after 60 s.
- Sessions survive — DeepSeek Harness persists sessions, so your conversations resume automatically after the restart.
- Same-origin only — the restart route rejects requests from other origins.
Install
Once published, install into the web profile with one command:
# from npm (once the package is published)
dsh plugin --profile web add dsh-restart-fab
# or straight from GitHub (works even before the npm release)
dsh plugin --profile web add github:miisaka19800/dsh-restart-fab
Then restart DeepSeek Harness once (close the console window / stop the process and start it again) — from then on the button is always there.
Install from a local checkout (development)
dsh plugin --profile web add /path/to/dsh-restart-fab
The profile keeps a link: dependency, so edits to this folder are live after
the next restart.
Uninstall
dsh plugin --profile web remove dsh-restart-fab
How it works
button (2nd click) ──POST /dsh-restart-fab/restart──▶ server route
│ spawns detached helper
│ node restart-helper.mjs <pid> <relaunch-spec-json>
helper: sleep 1.6s ──▶ kill server process ──▶ sleep 400ms ──▶ relaunch
(same argv, same cwd)
Windows: new visible console
(close it to stop; child processes
attach to it — no stray popups)
──▶ poll new host ──▶ exit
page: overlay + poll /dsh-restart-fab/ping every 1s
── boot id changed? ──▶ location.reload() on the new host
-
GET /dsh-restart-fab/ping— health check; reports the hostbootid (<pid>-<timestamp>). The page reloads when it changes. -
POST /dsh-restart-fab/restart— same-origin only; schedules the restart throughlib/restart-helper.mjs, spawned as a detached, hidden child so it survives however the server dies. It kills the server process, relaunches the same command line, and exits once the new host answers.
Project layout
| path | purpose |
|---|---|
client/client.js |
hand-authored CJS bundle, injected into the shell.overlay slot (bottom-right button + restart overlay), zh/en locale |
lib/index.js |
server-side cordis plugin: ping + restart routes on the webServer service |
lib/restart-helper.mjs |
detached helper: kill + relaunch (cross-platform) |
cordis.patch.yml |
profile bundle patch that inserts the plugin entry |
No build step — plain ESM server code and a hand-authored client bundle.
Security
The restart route only accepts same-origin POSTs (the page served by the host
itself). Restarting stops the current dsh web process and starts a new one —
anything running inside it (including model sessions) is interrupted, then
resumed from persistence.
License
MIT
Frequently Asked QuestionsFAQ
Use the verified command dsh plugin --profile default add github:miisaka19800/dsh-restart-fab in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.
Compatibility follows the bundle and profile status shown above. If a profile is not detected, keep the plugin disabled there and check the repository documentation before enabling it in production.
The GitHub link and activity metadata are the source of truth for releases and maintenance. Revisit this page after a new release to confirm the catalog has observed the latest version.