miisaka19800/dsh-restart-fab

dsh-restart-fab

一个用于 DeepSeek Harness Web GUI 的浮动一键重启按钮。

固定在页面右下角：点击一次进入确认状态，
再点击一次即可原地重启 DeepSeek Harness——页面会显示
全屏的“正在重启”遮罩层，并在新主机恢复运行后自动重新加载到新主机上。无需手动刷新，无需第二个标签页，无需启动器脚本。

button platform license

功能特性

- 完全自包含——重启后的主机会使用启动当前主机的完全相同
命令行（node …/bin.js web --port N）重新启动，
保留工作区、端口、配置文件和标志。不依赖任何启动器
脚本（DSH启动器.exe、shell 包装脚本等）。
- 跨平台——Windows（通过 taskkill 强制结束）、macOS/Linux
（先优雅地发送 SIGTERM，再发送 SIGKILL）。
- 快速——在你确认后约 1.6 秒旧进程即被结束；新主机
立即启动。
- 简洁的用户体验——重启期间显示带有加载动画和已用计时器的全屏遮罩层；
页面每秒轮询一次主机，并在新主机响应的那一刻自动重新加载。
60 秒后会出现“立即刷新”的备用选项。
- 会话得以保留——DeepSeek Harness 会持久化会话，因此你的
对话会在重启后自动恢复。
- 仅限同源——重启路由会拒绝来自其他源的请求。

安装

发布后，使用一条命令安装到 web 配置文件中：

从 npm 安装（包发布后）
dsh plugin --profile web add dsh-restart-fab

或直接从 GitHub 安装（即使在 npm 发布之前也可用）
dsh plugin --profile web add github:miisaka19800/dsh-restart-fab

然后重启一次 DeepSeek Harness（关闭控制台窗口 / 停止
进程并重新启动）——此后该按钮就会一直存在。

从本地检出安装（开发）

dsh plugin --profile web add /path/to/dsh-restart-fab

该配置文件会保留一个 link: 依赖，因此对此文件夹的编辑会在
下次重启后生效。

卸载

dsh plugin --profile web remove dsh-restart-fab

工作原理

按钮（第二次点击）──POST /dsh-restart-fab/restart──▶ 服务器路由
│ 启动分离的辅助进程
│   node restart-helper.mjs
辅助进程：  sleep 1.6s ──▶ 结束服务器进程 ──▶ sleep 400ms ──▶ 重新启动
（相同 argv，相同 cwd）
Windows：新的可见控制台
（关闭它以停止；子进程
附加到它 —— 没有游离的弹窗）
──▶ 轮询新主机 ──▶ 退出
页面：   覆盖层 + 每 1 秒轮询 /dsh-restart-fab/ping
── 启动 id 改变了吗？ ──▶ 在新主机上 location.reload()

- GET /dsh-restart-fab/ping —— 健康检查；报告主机的 boot id
（-）。当它改变时页面会重新加载。
- POST /dsh-restart-fab/restart —— 仅限同源；通过
lib/restart-helper.mjs 安排重启，该辅助程序作为分离的、隐藏的子进程启动，
因此无论服务器如何终止它都能存活。它杀死服务器进程，重新启动
相同的命令行，并在新主机响应后退出。

项目布局

| 路径 | 用途 |
|---|---|
| client/client.js | 手工编写的 CJS 包，注入到 shell.overlay 插槽（右下角按钮 + 重启覆盖层），zh/en 语言环境 |
| lib/index.js | 服务器端 cordis 插件：在 webServer 服务上的 ping + restart 路由 |
| lib/restart-helper.mjs | 分离的辅助程序：杀死 + 重新启动（跨平台） |
| cordis.patch.yml | 插入插件条目的 profile 包补丁 |

无需构建步骤 —— 纯 ESM 服务器代码和手工编写的客户端包。

安全性

重启路由仅接受同源 POST 请求（由主机自身提供的页面）。
重启会停止当前的 dsh web 进程并启动一个新的进程 ——
其中运行的任何内容（包括模型会话）都会被中断，然后
从持久化中恢复。

许可证

MIT