开机会话恢复 TuringCorp-net/dsh-boot-restore

dsh-boot-restore

DSH 插件：服务重启后自动恢复上次活跃（值班）会话，让定时任务无人值守继续跑，不用开浏览器。

为什么需要

DSH 的定时子系统只把提醒投递到活跃会话（会话本地设计如此）。浏览器打开会话，会话才活跃。服务一旦重启（每日自动更新、崩溃、重启机器），所有会话都是冷的，直到有人打开浏览器——这段时间里定时任务（每小时摘要、健康检查、维护）会悄悄停掉。

这个插件补上这个缺口：服务启动时调用 ctx.agents.resume()，把配置好的会话拉回活跃状态，恢复定时投递和智能体循环，不需要任何客户端连接。

安装

1. 把 index.cjs 复制到固定路径（例如 ~/.dsh/plugins/dsh-boot-restore/index.cjs）。
2. 创建配置 ~/.dsh/boot-restore.json： { "sessionId": "session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" }

3. 在 web 配置档的 overlay 里挂载（~/.dsh/profiles/web/cordis.patch.yml）：
- insert:
- id: boot-restore
name: '/absolute/path/to/index.cjs'

4. 重启服务：sudo systemctl restart harness.service。

日志（成功 / 失败 / 重试）写到 ~/.dsh/boot-restore.log。

工作原理

service start → plugin apply (inject: agents) → setTimeout 10s
→ ctx.agents.resume({ resumeSessionId, agentOptions: { agentPreset } })
→ session live → schedule delivery resumes → tasks run unattended

- 为什么等 10s 再重试：避开 cordis ready 事件的竞态（插件可能在 ready 已经触发之后才激活；激活期间访问 ctx.ready 会抛错——永远不要碰未注入的代理属性）。
- 为什么显式传 agentPreset：从 rc.7 起，resume 不带显式 preset 会拼装提示词失败（{{model}} 没有值，section deployment:persona）。传会话的 preset id（看会话头部或设置）。
- 幂等：浏览器先连上时，resume 直接跳过（「already live」）。
- 容错：日志损坏 / 会话不存在 → 记日志继续，绝不阻塞启动。

版本历史

| 版本 | 变更 |
| v0.6 | resume 显式传 agentPreset（rc.7 拼装修复） |
| v0.5 | 「already live」视为成功（不再做无用重试） |
| v0.4 | inject: ['agents'] + setTimeout 重试；修复 v0.3 崩溃（访问 ctx.ready 抛「without inject」） |
| v0.1 | 初版原型，走 ctx.on('ready')——受 ready 事件时序竞态影响 |

兼容性

- rc.6：可用（v0.1+）；preset 从会话头部自动套用。
- rc.7+：需要 v0.6（显式 agentPreset）。

许可证

MIT