dsh-restart-systemd
English summary.
A DeepSeek Harness WebUI restart button (systemd edition). Adds a sidebar‑footer
restart trigger next to the remote‑web‑ui phone icon plus a /restart command.
Clicking schedules systemctl --user restart dsh-web (~3s later, so the browser
gets its 202 first), dups are refused (409), non‑loopback callers are refused
(403), a flag‑file + residual‑window design prevents restart loops, and after the
service comes back up the browser auto‑reconnects without a manual refresh
(ConnectionController exponential backoff 500ms→10s) while interrupted agent turns
are auto‑resumed. Platform: WSL/Linux → systemctl --user (primary, tested);
Windows → detached helper branch is present but unused on WSL.
GitHub topics（主代理创建仓库时使用）: dsh · dsh-plugin · restart · systemd
设计总览
双面插件（与 dsh-client-ui-aionui-panel 同构）：
| 半边 | entry（exports） | 运行环境 | 职责 |
|---|
| host | "." → lib/index.js | node（宿主导进） | /api/restart-dsh 路由、/restart 命令、flag/resume 状态、restart-recover |
| client | "./client" → lib/client.js | 浏览器（WebUI） | 侧边栏 footer 重启按钮 + 二次确认 + 状态反馈 |
src/
index.ts # host apply()：串联路由 + 命令 + boot 消费/resume
host/gate.ts # loopback fence（照抄 dsh-aionui-panel 的 gate）
host/restart.ts # 调度 + 延迟 spawn + 平台分支 + flag/单飞锁
host/recover.ts # agent/created -> lastTurnInterrupted -> followup continue
client/index.ts # client apply()：locale + sidebar.footer.action 注入
client/RestartButton.tsx # 按钮 + 确认对话框（内联样式，无需 CSS bundle）
client/api.ts # POST 助手 + 重连探活
内部依赖：官方 socket sidebar.footer.action（list/root additive，remote-web-ui 电话图标同座）+ 备选 conversation.session.header.utilities。
重启流程
- 点按钮（或输入
/restart）→ 二次确认：“进行中的 agent 任务将中断并自动续接，页面约几秒后自动重连。”
- 确认 →
POST /api/restart-dsh（或命令回调）。
- host 把当前 running 的 agent id 快照到
$DSH_HOME/dsh-restart-resume.json，写 flag $DSH_HOME/dsh-restart.flag，随即回 202 {scheduled:true, delayMs:3000}。
- 3s 后 host 用白名单 argv（无 shell 拼串）spawn
systemctl --user restart dsh-web。服务重启；浏览器靠 ConnectionController 指数退避（500ms→10s）自动重连，无需手动刷新。
- 重启后插件消费（删除）flag token，装上
agent/created 监听，读 resume 列表——对每个最后 turn 被中断（存在未闭合 turn/start 或最近的 turn/end.reason === 'interrupted'）的会话，agent.followup("Continue.") 自动续接；idle/正常结束的会话绝不打扰。
平台三态
| 平台 | 行为 | 代码位置 |
|---|
| WSL | process.platform === 'linux' → systemctl --user restart dsh-web（本机主场景，已实测） | restartArgv() / platformSupported() |
| Linux | 同上（systemd 用户态） | 同上 |
| Windows（原生 win32，非 WSL） | spawn(process.execPath, [helper, 'win-restart.mjs']) detached helper，重启可脱离当前进程存活（机器相关，WSL 场景不走此分支） | 同上 |
安全（三合一 + 单飞）
- flag 文件
$DSH_HOME/dsh-restart.flag：spawn 前写入，boot 消费一次即删，绝不自行触发重启 → 残留 flag 无法造成二次重启。
- 残留窗口：插件驱动的 boot（flag 被消费）后 15s 内再次点击 → 429，防重试乒乓。
- 单飞锁：已有一发在途时重复 POST → 409。
- loopback fence：socket/Host 非 127.0.0.1/::1 或
sec-fetch-site === 'cross-site' 或 Origin 不同源 → 403；X-Forwarded-For 永不被信任。
状态文件（$DSH_HOME → ~/.dsh）
| 文件 | 用途 |
|---|
dsh-restart.flag | 一次性 boot token { reason, ts, sessionIds } |
dsh-restart-resume.json | 续接列表 { ts, reason, sessionIds } |
独立仓库 / 发布形态
本目录即一个独立 Git + npm 包（社区格式 dsh-<feature>，systemd 版包名唯一且表意）：
创建 GitHub 仓库时建议 topics：dsh、dsh-plugin、restart、systemd。
安装
# 1) 构建（需 devDependencies）
cd dsh-restart-systemd
npm install
npm run build # tsc -b → lib/（host=lib/index.js，client=lib/client.js，内联样式无需 CSS bundle）
# 2) 装入 web profile（注册 bundle + 补丁插件行）
dsh plugin --profile web add /tmp/dsh-restart-systemd
# 或 pnpm add /tmp/dsh-restart-systemd + 手补 cordis.patch.yml 行到 profile bundle 列表
# 3) 无热重载，需重启生效
systemctl --user restart dsh-web
exports."." → lib/index.js，exports."./client" → lib/client.js；main/types 与之对应。
验证
- 插件加载：新会话打开；
journalctl --user -u dsh-web 出现 dsh-restart-systemd: ...。
- 侧边栏按钮：设置按钮旁的 footer 行出现重启图标（在 remote-web-ui 电话图标旁边），悬停标题“重启 DeepSeek Harness”。
- 点击→确认→202→重启：确认后页面短暂显示“正在重启…”，~3s 后服务重启，页面自动重连：
- journald 依次出现
restart scheduled … delayMs=3000 → spawning restart for dsh-web … → 新 boot 的 consumed leftover restart flag。
/restart 命令：聊天输入 /restart → 返回确认文本。- 会话自动续接：重启前若有 running agent，boot 后 journald 出现
recovery armed for N session(s) 与 resuming interrupted agent <id>，agent 自动继续。
- 单飞：快速点两次 → 第二次返回 409
already-scheduled。
- loopback：
curl -H 'Host: evil.example' -X POST http://127.0.0.1:3080/api/restart-dsh → 403 forbidden: loopback-only。
- 失败兜底：
systemctl --user status dsh-web 确认单元存活。
回滚
dsh plugin --profile web remove ui-dsh-restart-systemd
# 或手删包 + bundle 行后
systemctl --user restart dsh-web
# 清理残留状态（随时可删）
rm -f ~/.dsh/dsh-restart.flag ~/.dsh/dsh-restart-resume.json
重启后按钮与命令即消失，不改动其它配置。
平台说明
- WSL/Linux：
systemctl --user restart dsh-web，主目标已实测。
- Windows（原生，非 WSL）：
restartArgv() 走 detached spawn(process.execPath, [helper])
win-restart.mjs（未随包附带；参考 anweat/dsh-restart 的 detached helper、
LnsiAxe/dsh-web-restart 的 WMI Win32_Process.Create、shaoyi1991 的 lsof 杀端口+spawn）。
路由、单飞、flag、loopback fence、restart-recover 均平台无关。WSL 本机场景不进入此分支。
- 重启后前端自动重连，无需手动刷新（ConnectionController 指数退避 500ms→10s）。
已知限制
- 单一服务单元：systemctl 命令固定
dsh-web（SYSTEMD_UNIT）。
- 非 systemctl 启动则不生效：若以
node … 手跑，spawn systemctl 会失败并记日志，不产生重启。
- 恢复为尽力而为：60s
RECOVERY_TIMEOUT_MS 窗口内未重建的 agent 会被丢弃；无法判定“最后 turn 被中断”的会话会被跳过（clean 会话永不被主动续接）。
- Windows helper 为占位：仅提供 spawn 目标，helper 本体机器相关，超出 WSL 主目标范围。
- 路由避开
/plugins（官方 client-modules 拥有该前缀），仅注册 /api/restart-dsh，无 bundle 供数冲突。
License
MIT — see LICENSE.
