dsh-web-lifecycle
DSH web 插件：侧边栏底部的“重启”和“关闭”按钮。“重启”会在同一主机和端口上重新启动 `dsh web` 服务器，使标签页自动重新连接；“关闭”会停止服务器以释放终端，然后关闭浏览器标签页。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:DDA-DIGITAL/dsh-web-lifecycle#3673f12bbf2e9a53d19cccad0ebe62d26780c9c1Web Lifecycle 以 dsh-web-lifecycle 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DSH web plugin that puts two buttons in the sidebar footer:
sidebar footer → [ ⟳ Restart ] stop the server, bring an identical
instance back on the same host/port,
and reload this page
→ [ ⏻ Shutdown ] stop the server for good so the terminal
is free, then close this tab
Both ask for confirmation first. No more switching to a terminal several times a day to restart the harness — and nothing to clean up when you are done for the night.
dshweb
wrapper.webServer / no appExit → nothing mounts, the
host is never affected.# from GitHub
dsh plugin --profile web add github:DDA-DIGITAL/dsh-web-lifecycle
# from a local checkout
dsh plugin --profile web add /path/to/dsh-web-lifecycle
# from npm, once published
dsh plugin --profile web add dsh-web-lifecycle
Then restart dsh web once so the host half loads, and refresh the page for the
client half:
dsh --profile web --dump-config # the row `web-lifecycle` should be listed
| Launch mode | What happens |
|---|---|
dshweb (supervised) | Exits with code 75; the wrapper relaunches in the same terminal in about a second. |
plain dsh web (detached) | A coordinator in its own process session outlives the dying process, waits for the port to be released, spawns an identical dsh web, health-checks it, and logs the chain to $DSH_HOME/plugins-data/dsh-web-lifecycle/restart.log. |
Either way the page waits for the origin to drop, waits for it to answer, then reloads itself.
Shutdown exits with code 0 — deliberately not 75 — so the wrapper's relaunch condition is false and your prompt comes back:
dshweb: dsh web stopped (exit 0); supervisor exiting
No coordinator is spawned, so nothing can bring the server back. Under plain
dsh web the process simply exits (it was detached, so your terminal was already
free).
The plugin does try to close the tab for you (window.close()), and that works
when the GUI runs as an installed PWA or app window. For an ordinary browser tab
it will not work: browsers only let a page close windows that a script
opened, and DSH hands the URL to your OS browser, so there is no opener.
So the tab is handled in two steps: try to close, then — if it is still there —
show a full-screen card that says "dsh web has stopped", retitles the tab to
dsh web stopped, and reminds you to press ⌘W / Ctrl+W. There is no
auto-reload on shutdown: there is nothing left to load.
Mode A keeps the server attached to your terminal and makes restarts ~1 second:
install -m 0755 scripts/dshweb ~/bin/dshweb # or /usr/local/bin
dshweb # same flags as `dsh web`
dshweb --port 3080
The wrapper runs dsh web in a loop and treats exit code 75 as "relaunch
me". Ctrl-C still works (SIGINT exits 130, which is not 75, so the loop stops),
and a Shutdown exits 0, which also stops the loop. Without the wrapper the plugin
still works — it just falls back to the detached relaunch.
Defaults live in the plugin row (cordis.patch.yml) and are re-applied by the
plugin itself:
- id: web-lifecycle
config:
confirm: true # show the confirmation popover before either action
allowShutdown: true # false hides the Shutdown row entirely
healthTimeoutMs: 30000 # how long a detached restart waits for the new server
logToConsole: true # log the plugin's decisions into the dsh web log
Override the row by id in $DSH_HOME/profiles/web/cordis.patch.yml — that file is
watched live, so the change applies without a restart.
Both actions interrupt everything the process was running: active turns,
subagents, background jobs and scheduled work. Sessions themselves are durable and
reopen after a restart, but anything in flight is gone — which is why the
confirmation popovers are on by default. Turn them off with confirm: false if
you prefer a single click.
After a shutdown, the only way back is a terminal: dshweb or dsh web.
| Symptom | What to do |
|---|---|
| The buttons are missing | Check dsh --profile web --dump-config lists web-lifecycle, then restart dsh web and refresh the page. |
| Overlay says "did not come back" | Read $DSH_HOME/plugins-data/dsh-web-lifecycle/restart.log; it ends with the failing startup output. Start the server manually with dsh web. |
| Red status dot | The channel is not answering — the host half is not mounted, or the page is stale. Refresh; if it persists, restart once from the terminal. |
| Restart works but the tab asks you to authenticate | The port changed. Do not start the server with --port 0, and keep the wrapper's flags identical to the original invocation. |
| Shutdown card stays open | Expected on an ordinary tab — press ⌘W. It closes by itself in a PWA/app window. |
| A supervisor (launchd/systemd/pm2) keeps resurrecting the server | Unsupported: shutdown stops the process, the supervisor starts it again. |
lib/index.js) registers a prefix route on webServer at
/dsh-web-lifecycle with POST /status, POST /restart and POST /shutdown.
Requests pass through the host's own browser fence
(connection.requestRejection: Host/Origin trust plus the signed cookie),
falling back to a loopback check.lib/client.js) is served by the client-modules host at
/plugins/dsh-web-lifecycle/client.js and registers one entry into the
sidebar.footer.action slot. That slot's container is a flex row, so a second
entry would render beside Restart rather than under it; both rows therefore live
inside one entry and are stacked by the plugin's own column container.Two host quirks are worked around deliberately, both found while building this:
connection.rpc.handle is unusable in @deepseek-ai/dsh 0.1.5-rc.1 — it
reaches webServer through a context that never injected it, so every call
throws cannot get property "webServer" without inject. Registering the route
directly is exactly what the connection plugin does for its own /api route.ctx.get("connection") returns undefined on a context that never declared
it, which silently downgrades the browser fence to loopback-only. The service
is therefore named in the inject list and read as a property, which is the
only access shape cordis permits.npm test # node --test: config, argv planning, waits, lifecycle policy, HTTP envelope, client bundle shape
npm run check
Layout:
lib/relaunch.js pure helpers shared by both halves (argv planning, waits, ports, exit codes)
lib/index.js host half: route, restart/shutdown policy, coordinator spawn
lib/restart-agent.mjs detached coordinator (detached restart only)
lib/client.js browser half: footer rows, popovers, status card, tab close
scripts/dshweb supervisor wrapper (exit 75 = relaunch, anything else = stop)
test/ unit tests
MIT — see LICENSE.
Repository: https://github.com/DDA-DIGITAL/dsh-web-lifecycle