LoopX状态备份与恢复指南：跨天重启后目标如何精确续跑

LoopX状态备份与恢复指南跨天重启后目标如何精确续跑【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopxLoopX 是一个面向 Codex、Claude Code 等多种 Agent 运行框架的长时任务控制平面Long-horizon Agent Control Plane。它会把 Goal目标拆成可持续运行的循环让 Agent 跨天、跨会话地推进任务——也因此状态备份与恢复成了长时目标能否精确续跑的关键。本指南用最少的命令帮你掌握 LoopX 状态备份、归档校验与重启续跑的完整流程。为什么长时目标必须做状态备份一个 LoopX Goal 很少在一次会话内跑完。它的进度、待办、调度与运行历史会持续写入磁盘上的多个位置例如状态类别典型位置LoopX 运行时根目录~/.codex/loopx含全局注册表registry.global.json项目内状态项目根目录下的.loopx/、.codex/goals/、.claude/goals/、.local/goals/目标活动状态文件注册表中每个 goal 指向的state_file自动化与技能$CODEX_HOME/automations、$CODEX_HOME/skills/loopx-*一旦电脑重启、系统升级、迁移机器或发生误操作任何一处状态丢失目标就可能失忆甚至从错误的进度上重新执行。LoopX 内置的backup-state命令就是为这个场景设计的它把上述所有状态打包成一个本地私有归档 一份清单manifest让你随时可以精确还原。下图中可以看到一个真实长时 ML 实验目标会经历数十次决策节点每一步的中间状态都需要被妥善保存跨天后才能沿着原轨迹继续而不是推倒重来一键备份先预览后执行️backup-state采用先 dry-run、后执行的安全设计不加--execute时只生成备份计划不写任何文件。第 1 步预览备份计划loopx backup-state --project .命令会输出一份计划Markdown 或 JSON告诉你Included将被打包的目标清单运行时根、项目状态、注册表各项目等Missing注册表中声明但本地不存在的路径附原因Warnings无法 stat 或列目录的异常Recommended action官方给出的下一步建议通常是执行loopx backup-state --project . --execute。第 2 步执行写入归档确认计划无误后loopx backup-state --project . --execute成功后会在runtime-root/backups/下生成两个文件loopx-state-backup-id.tar.gz状态归档可用--backup-id指定稳定名称默认用 UTC 时间戳loopx-state-backup-id.manifest.json清单含每个文件的统计、归档整体sha256与压缩比是恢复时的对账单。⚠️ 备份属于private recovery material私有恢复材料请保留在本机私有位置不要提交到代码仓库或对外公开。常用可选参数参数作用--output-dir自定义归档输出目录默认runtime-root/backups--no-automations不备份$CODEX_HOME/automations--no-skills不备份loopx-*技能目录--current-project-only只备份当前项目不从全局注册表发现其他项目备份里到底有什么备份发现逻辑_discover_targets会按 5 类目标自动收集状态并对重复包含的路径做去重统计避免虚胖runtime_rootLoopX 运行时根目录含全局注册表project_state当前项目的.loopx/与各 harness 的 goals 目录registry_projects / active_state_routes / source_registries遍历registry.global.json中所有 goal逐项目备份其状态目录、活动状态文件与来源注册表automationsCodex 自动化配置skillsloopx-*技能目录。该逻辑的核心实现见 state_backup.pyCLI 参数注册见 support_control_backup.py。跨天重启后三步恢复并精确续跑第 1 步校验归档完整性sha256sum loopx-state-backup-id.tar.gz与 manifest 中execution.archive_sha256比对一致才说明归档未被篡改或损坏。第 2 步按清单还原状态路径manifest 中每个 included 项都记录了source_path原始路径与archive_path归档内路径的映射。恢复时只需将归档中对应条目解压回原位置例如运行时根、项目的.loopx/、各 goal 的state_file。注册表指向哪个状态文件就还原哪个状态文件——目标下次唤醒时读取的仍是重启前的精确进度而不是从空白状态重来。第 3 步重启验证loopx doctor loopx statusstatus会核对项目注册表、Goal、Todo 与投影是否一致在 Dashboard 上确认目标卡片显示的进度、待办与调度计划和你重启前看到的一致即完成精确续跑升级与迁移场景的备份 SOP官方参考文档建议升级前若涉及 risky migration、scheduler 或 runtime repair先预览再执行一次私有本地备份再进入升级流程。相关说明见getting-started.md含backup-state首次使用步骤appendix-reference.md升级前备份与回滚建议loopx-state-migration-sop.md状态迁移标准作业流程先备份、再migrate-state预览与执行另外仓库提供了一个可运行的备份冒烟示例适合想深入理解计划结构的读者state-backup-smoke.py。小结loopx backup-state默认 dry-run 预览加--execute才落盘安全可控归档 一个 tar.gz 一份含 sha256 的 manifest天然支持校验与精确还原备份覆盖运行时根、项目状态、注册表各项目、automations 与 skills 五大类重启后按 manifest 还原 →loopx doctor/loopx status验证 → 目标从原进度精确续跑长时任务不断档。把备份变成每次跨天长任务前的 10 秒习惯你的目标就能放心地过夜。【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考