miisaka19800/dsh-restart-fab

A floating one-click restart button for the DeepSeek Harness web GUI — self-contained, cross-platform.

Bundle 已验证 MIT JavaScript 未知
Bundle 已验证

已收录

1

Ui

Bundle 已验证

版本未知
语言JavaScript
许可证MIT
在 GitHub 查看

预览

功能介绍

DSH 网页界面右下角的一键重启按钮:全屏遮罩原地重启 dsh 进程并自动刷新页面;无需启动脚本,跨 Windows/macOS/Linux。

适合

  • 经常需要在配置或插件变更后重启主机的 DSH Web GUI 用户。
  • 需要按原命令行、工作区、端口、profile 和参数重新启动 DSH 的跨平台环境。
  • 希望在当前标签页查看重启进度、自动轮询主机并刷新页面的用户。

不适合

  • 无头或非 Web 的 DSH 工作流,悬浮 GUI 控件在这些场景中没有实际价值。
  • 不能接受当前 dsh web 进程被中断的场景,即使持久化会话之后可以恢复。
  • 要求由外部进程监管器或启动器统一控制重启策略,而非使用进程内按钮的部署。
  • 希望插件重启无关服务或修改启动参数的用户。

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.

button platform license

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 (graceful SIGTERM then SIGKILL).
  • 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 host boot id (<pid>-<timestamp>). The page reloads when it changes.
  • POST /dsh-restart-fab/restart — same-origin only; schedules the restart through lib/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

常见问题常见问题

在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:miisaka19800/dsh-restart-fab。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。