DWJZ/dsh-restart

---

description: "dsh-restart: 在 dsh Web 设置面板里一键重启宿主进程。"

dsh-restart

English | 中文

在 DeepSeek Harness(dsh)Web 设置面板里多出一个「重启」页:点一下就把正在运行的宿主进程换成新的。

它做什么

• 宿主半在 Web 服务器上注册三个路由,都只接受本机同源的直接请求:
  • GET /dsh-restart/status — 当前进程的 boot id、PID、启动时间、端口
  • POST /dsh-restart/restart — 替换当前进程(应答 202 后宿主退出)
  • POST /dsh-restart/stop — 结束当前进程,不拉起任何替代(同样是先应答后退出)
• 浏览器半注册一个 settings.section 页面:显示上述信息,并给出重启与停止两个按钮。重启后它轮询 /dsh-restart/status,一旦应答的 boot id 变了就刷新页面;停止之后没有可等的东西,所以页面以「status 不再应答」作为成功信号,并明确告诉你:想再跑起来要回终端执行启动命令。
• 快捷键 —— Cmd+Shift+K（macOS）或 Ctrl+Shift+K（Windows）不打开设置就能重启宿主，可在设置的「快捷键」页改绑。它在页面以及输入框等可编辑区域有焦点时都触发（终端输入区除外）；标签与其它命令一样列在设置的「快捷键」页里。web 上的 Linux 不绑定：客户端的组合键白名单会拒绝所有 primary+alt 组合，注册它会让插件激活失败。

重启由 detached helper 完成:宿主在 400ms 后退出,helper 等到端口不再接受连接,才用完全相同的启动命令拉起替代进程(Node 可执行文件、execArgv、入口绝对路径、其余 argv、工作目录)。这个顺序保证了替代进程不会在旧 socket 还占着端口时死于 EADDRINUSE。日志写在系统临时目录的 dsh-restart-<时间戳>.out.log / .err.log。

停止是同一个 400ms 的 SIGTERM,只是后面没有 helper——这正是 CLI 能在它自己的超时强退之前先落盘会话、dispose 插件的原因。因为没有替代进程,从页面重启出来的那个进程同时也就不再挂在你的终端上:此后要停它,就是这个按钮、kill <pid>,或 curl -X POST http://127.0.0.1:<端口>/dsh-restart/stop。

会话记录保存在磁盘上,重启后仍然在;已安装但尚未生效的插件会在下次启动时加载。

安装

# from GitHub
dsh plugin --profile web add github:DWJZ/dsh-restart

# local development (the profile links the checkout, so edits apply directly)
dsh plugin --profile web add link:/path/to/dsh-restart

上面两条命令分别是:从 GitHub 源安装,以及本地开发时软链检出目录(link:),后者改完代码即生效。

首次安装后需要重启一次(在终端重启宿主,或临时用一次 dshmarket 的重启按钮),这个页面才会出现;之后就都用它来重启。

端点约定

POST /dsh-restart/restart 只接受对端为回环地址、且 Origin 与 Host 一致的请求;任何转发头(Forwarded、X-Forwarded-For、X-Real-IP)或非回环对端都会以 403 拒绝。应答 202 后宿主退出,由 helper 拉起替代进程。

POST /dsh-restart/stop 用同一套校验,并在退出之前先应答 202——这样浏览器是从响应里知道结果,而不是从一次断连里猜。它绝不发 SIGKILL:优雅信号才是会话落盘的保证。

测试

node test/smoke.mjs

覆盖:detached helper 真的能拉起替代进程、同源校验的四种拒绝路径、客户端 bundle 的注册与渲染。设置 DSH_CHECKOUT=<dsh 检出目录> 时额外用该检出里的 React 做一次 SSR 渲染断言;不设置则跳过该条。

许可证

MIT