恢复Codex历史需严格按顺序操作：先检查备份可用性，再依粒度选择全部、项目或单一会话恢复，执行前必须关闭Codex Desktop，完成后重启并验证会话与数据库更新。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你已经用 codexbak 工具完成了一次本地历史任务备份，现在需要把某次会话、某个项目或整套历史恢复回来，操作路径其实很明确——但必须严格按数据依赖顺序执行，否则 Codex Desktop 无法识别已恢复的会话。
确认备份可用性
打开 codexbak.exe → 点击【检查状态】→ 等待右侧“可用备份”列表刷新完成。如果列表为空，说明当前目录下没有 .codex/bak/ 子目录，或备份文件被手动删改过，【此时不可点击恢复按钮，否则会触发空目录覆盖】。
备份文件名格式为 codex-bak-20260730-142218.zip，时间戳精确到秒，对应当时 SQLite 和 sessions/ 的完整快照。
选择恢复粒度
codexbak 支持三种恢复方式，根据你丢失的内容范围选择：
方法一：恢复全部历史（含所有项目、会话、索引、数据库）
点击【恢复完整备份】→ 在弹出窗口中选中一个 .zip 备份文件 → 点击【开始恢复】→ 工具会自动创建当前状态的安全快照（名为 codex-pre-restore-xxx.zip），再解压覆盖。
方法二：只恢复指定项目下的会话
在“备份内容概览”面板中展开目标备份 → 查看“项目数量”和下方树形列表 → 勾选你要恢复的项目路径（如 /Users/john/project-api）→ 点击【恢复选中项目】。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
方法三：只恢复特定会话（适合找回单个 rollout 文件）
进入备份 ZIP 内部的 sessions/ 目录 → 找到对应日期子目录（如 2026/07/28）→ 定位 rollout-2026-07-28T10-33-12-abcdef12-3456-7890-abcd-ef1234567890.jsonl → 右键复制该文件 → 手动粘贴到当前 .codex/sessions/ 对应路径下 → 重启 Codex Desktop。
执行恢复并验证
第一步：关闭 CodexDesktop。这是硬性前提，【若进程仍在运行，恢复后的 session_index.jsonl 和 state_5.sqlite 可能被写入锁阻塞，导致索引不生效】。
第二步：在 codexbak 中选定方案并点击恢复 → 观察底部进度条，等待显示“✅ 恢复完成”。
第三步：重新打开 CodexDesktop → 进入对应项目 → 查看左侧会话栏是否出现历史会话标题；若仍为空，打开终端执行：codex resume 019e3431-b161-7f12-9e91-cd1100b05c9d（ID 来自 rollout 文件中的 payload.id）。
第四步：检查 sessions/ 目录下文件修改时间是否更新，state_5.sqlite 中 threads 表是否有新增记录。
