1123762794/dsh-web-restart
One-click restart button for the DeepSeek Harness Web UI: sidebar footer button, single click restarts the dsh web process. / DSH Web 界面一键重启按钮。
已收录
4
Dev
Bundle 已验证
预览
功能介绍
DSH Web 界面一键重启按钮:侧边栏底部按钮,单击即重启 dsh web 进程,且重启后按钮常驻。
适合
- 经常需要从侧边栏立即重启兼容 DSH Web 安装的运维人员。
- 愿意根据自身主机环境调整内置重启命令和脚本路径的 Windows 用户。
不适合
- 无法直接使用作者硬编码 Windows PowerShell 脚本路径,又不准备派生或修改插件的安装环境。
- 要求确认步骤、优雅排空工作负载或跨平台可移植重启机制的环境;单击会立即触发重启。
README
dsh-web-restart
One-click restart button for the DeepSeek Harness Web UI.
Adds a small circular restart button (↻) to the sidebar footer, next to Settings. A single click immediately restarts the dsh web process — the page disconnects for ~15–20 seconds, then you refresh and everything is back (sessions are persisted on disk and recover automatically). The button is persistent: it survives the restart it triggers.
Windows-specific: the restart launches
dsh webthrough an independent hidden PowerShell process, so the script keeps running after the harness process is killed.
Features
- Single-click restart — no confirmation step, no double-click dance.
- Persistent: survives the DSH restart it triggers (installed as a bundle-layer plugin, not a dynamic session plugin).
- Small footprint: sits beside the Settings trigger in the sidebar footer; icon-only in the 56px rail, icon + label in the wide sidebar.
- In-flight feedback: the button turns red and shows “重启中…” → “已触发” while the request is being processed.
- Re-entry guard: a second click while a restart is already in flight is rejected.
- Online status dot: the button also shows DSH liveness — a green dot polls
GET /dsh-healthevery 5s (red when the harness is unreachable/restarting).
Install
From GitHub (this repo)
dsh plugin --profile web add github:YOUR_OWNER/dsh-web-restart
Then restart dsh web once so the bundle layer loads.
Manual (edit profile files)
- Add the dependency:
// ~/.dsh/profiles/web/package.json
{
"dependencies": {
"dsh-web-restart": "github:YOUR_OWNER/dsh-web-restart"
}
}
- Add the plugin row (this repo ships its own
cordis.patch.yml— either merge its row into your profile’scordis.patch.yml, or install via thedsh plugincommand above which does it for you):
# ~/.dsh/profiles/web/cordis.patch.yml
- insert:
- id: dsh-web-restart
name: dsh-web-restart
-
pnpm installin the profile directory, then restartdsh web.
How it works
| Layer | File | What it does |
|---|---|---|
| Host | lib/index.js |
Registers an exact POST /restart-dsh route on the webServer; launches the restart script as an independent hidden PowerShell under danger-full-access sandbox policy |
| Client | lib/client.js |
Registers the sidebar footer button (slot sidebar.footer.action); single click fetches POST /restart-dsh; polls GET /dsh-health every 5s for the status dot |
| Bundle | cordis.patch.yml |
The loader row that mounts both halves |
The host routes return before the restart happens (~1s host timer + 3s inner sleep), giving the browser time to render the “restarting” state before the page drops.
Why not ctx.timeout in the route handler
ctx.timeout is a Cordis mixin backed by ctx.effect(), which is scoped to the Cordis fiber lifecycle. A webServer route handler runs as a plain Node HTTP callback — outside any fiber — so ctx.effect-registered timers are silently dropped and the restart never fires. This plugin uses Node’s native setTimeout in the handler instead.
Compatibility
- DeepSeek Harness
0.1.0-rc.6(web profile). - The restart script path (
D:\1\dsh-web-host.ps1) is hard-coded for this author’s machine — fork and adjust it (or replace the command inlib/index.js) for your own environment. Contributions to make this configurable are welcome.
Development
The client bundle is hand-written in the exact wire format (window.__ModuleLoader__.load({ id, factory })), so no build step is required:
node --check lib/index.js
node --check lib/client.js
License
MIT
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:1123762794/dsh-web-restart。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到,请先保持禁用,并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页,确认目录已经观察到最新版本。