- Home
- Plugin
- Sessioni e messaggi
- dsh-plugin-restart
dsh-plugin-restart
threadripper123/dsh-plugin-restart
Checkpoint and restart DSH through an independent watchdog so interrupted sessions resume automatically.
Installazione
dsh plugin --profile web add github:threadripper123/dsh-plugin-restartREADME
DSH 重启与断点恢复插件
已安装到本机 desktop profile。首次需要完全退出 DSH 后重新打开,模型才会看到新增工具。
模型工具
- dsh_restart(reason, checkpoint):保存断点,取消当前运行并保留队列,等待空闲,再刷新全部会话持久化。保存成功才允许外部监控停止并重新启动桌面程序。
- dsh_restart_status():查看事务、监控状态及恢复错误。
checkpoint 应包括用户目标、完成项、未完成项、最后一次操作的实际结果及下一步。重启影响整个桌面程序;调用会话与其他正在运行的主会话在启动后恢复。空闲会话保持原历史,不自动发送消息。子会话不能发起重启。
外部监控
0.1.1 监控通过交互桌面的 Explorer COM 代理启动独立 Node,脱离 DSH 进程树,防止终止旧桌面进程树时连带杀死监控。使用文件心跳,不硬编码 GUI 动态端口;Web 服务实际绑定端口后自动恢复会话,不依赖不存在的 ready 事件。启动前核对桌面主进程的路径、命令行与创建时间。当前版本没有生产版公开的优雅重启接口:监控先发关闭窗口请求,10 秒仍未退出时终止已核验的桌面进程树,因此插件先完成对话持久化。
每次启动最多等待 120 秒,失败收集最新崩溃日志及启动诊断,按 5/10/20/40/60 秒退避,初次启动加最多五次重试,超过上限保留断点并停止。诊断仅收集和脱敏;不会擅自修改配置、删除插件或自动修代码。监控仅处理显式重启事务,正常退出不会被重新拉起。
状态目录:DSH_HOME/restart-watchdog;DSH_HOME 未设置时为用户目录 .dsh/restart-watchdog。request.json 保存重启事务和恢复记录,status.json 保存监控阶段,diagnostic-summary.json 保存脱敏日志摘要,events.jsonl 保存轮转事件日志。不要随意改 armed 事务或在旧程序仍活着时手工重新执行。
恢复采用原 sessionController,沿用原模型和 preset;恢复通知使用插件来源。先把确定 ID 的通知写入持久队列,再唤醒模型。同一事务重复恢复不会重复投递通知。模型应先核实被中断的外部操作结果,消息幂等不等于所有外部操作恰好执行一次。
验证和边界
已通过真实 DSH defineTool 注册、输出渲染,以及模拟持久化的恢复、重复投递和子会话拒绝验证;监控状态机 9 项测试通过,涵盖失败退避、超时、PID 复用和互斥锁。2026-11-12 已完成真实桌面退出→自动拉起→原会话自动继续执行验收:事务 e4f4ee54-3a47-47e6-b6d9-81818118f32f completed,桌面 PID 150920→152100,Explorer 启动的监控 PID 147376 及创建时间跨退出保持不变;新窗口位于用户交互会话,原会话收到恢复通知并实际执行后续工具。首次 0.1.0 测试曾因监控是旧桌面后代被 taskkill /T 连带终止,0.1.1 已修复。
本插件保存的是已提交对话历史与文本断点,不是进程内存快照;突然断电之前尚未提交或写入的内容无法凭空恢复。物理断电后的系统开机自启不在本版范围。
Plugin correlati
billion-context
ranxianglei/billion-context
dsh-web-ui (dsh-chat-recovery)
zhu1090093659/dsh-web-ui
dsh-synapse
liangmianya/dsh-synapse
dsh-archive-manager
michengai/dsh-archive-manager