bigfurma-bot/dsh-web-restart

dsh-web-restart

为 DeepSeek Harness Web UI 提供一键重启 —— 一个固定在 设置 ▸ 通用 右下角 的小型 Restart DSH 控件，带有待确认保护机制和实时存活状态指示点。

这是 1123762794/dsh-web-restart 的 Linux 移植版，针对 web-profile 插件层进行了重构。

功能特性

- 固定角落位置 —— 位于设置面板内部（通用 的最后一项），绝对定位到面板的右下角；即使设置列表滚动也保持不动。侧边栏中没有任何内容，不会误点。
- 待确认机制 —— 第一次点击只是让按钮进入待命状态（红色，"再次点击以确认 · 5s"）；需要刻意进行第二次点击才会触发。5 秒后自动解除待命，因此绝不会意外触发，也不会一直处于待命状态。
- 存活状态指示点 —— 每 5 秒轮询一次 GET /dsh-health：绿色 = harness 在线，红色 = 离线/重启中。
- 重启后依然存活 —— 作为 bundle 层 profile 插件安装，因此它会随它刚刚重启的 harness 一起恢复。

截图

| | | |
|---|---|---|
| 截图 1 | 截图 2 | 截图 3 |

工作原理

| 组件 | 文件 | 作用 |
|---|---|---|
| 宿主 | host.js | 在 webServer 上注册 GET /dsh-health 和 POST /restart-dsh；在重启之前响应，以便 UI 能够渲染状态 |
| 重启器 | restart-dsh-web.sh | 单个文件中包含两个阶段：外层将自身重新执行到一个全新的 setsid 会话中并退出（执行器拆除时无可杀进程）；内层捕获 TERM/INT/HUP，杀掉源码检出实例，等待端口 3080 关闭，然后以分离方式重新启动 pnpm dsh web |
| 客户端 | client.js | 工厂形式的 bundle，注册 设置 ▸ 通用 项 |

安全说明

- 来源防护：对 /restart-dsh 的跨站 no-cors POST 请求会以 403 拒绝（防止 drive-by 重启 DoS；上游没有此防护）。
- 没有黑盒：实际的重启逻辑在仓库内完全可读（上游委托给仓库外部的一个 PowerShell 脚本）。
- 无依赖、无遥测、无网络出口 —— 一切都只与 localhost 通信。
- 单击无需确认是上游的默认行为；此分支刻意要求在 5 秒内进行两次点击。

安装（DSH web profile）

git clone https://github.com/bigfurma-bot/dsh-web-restart.git /path/to/dsh-web-restart

添加依赖（使用 link:，这样以后的修改无需重新安装）：

// ~/.dsh/profiles/web/package.json
{
"dependencies": {
"@deepseek-ai/dsh-web-restart": "link:/path/to/dsh-web-restart"
}
}

添加加载器行：

~/.dsh/profiles/web/cordis.patch.yml
- insert:
- id: web-restart
name: '@deepseek-ai/dsh-web-restart'

然后：

cd ~/.dsh/profiles/web && pnpm install
然后手动重启一次 dsh web——之后，Settings ▸ General 中的按钮会自行处理每次重启（停机时间约 15–20 秒；会话会持久保存在磁盘上）。

配置

路径是每个文件顶部的常量——请根据你的机器进行调整：

- host.js：SCRIPT（重启脚本路径）、LOG（日志文件）
- restart-dsh-web.sh：LOG、kill 模式，以及底部的检出目录 + 启动命令（默认：cd /home/prime/deepseek-harness && pnpm dsh web）

要求：Linux、DSH web 配置文件（bundle-layer 插件）、pnpm 在 PATH 中。

许可证

MIT——参见 LICENSE。