必须严格按路径操作还原备份，因会覆盖当前SQLite状态和索引文件；先确认备份有效性，再选择全量或项目级恢复，最后通过CodexDesktop界面、codex resume及codex-provider-sync三步验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你已经用 codexbak 工具完成本地会话记录备份，现在需要把某次历史会话或整个项目状态还原回来，必须严格按路径操作——因为恢复过程会覆盖当前 SQLite 状态和索引文件，错一步就可能让新会话无法加载。
确认备份有效性
打开 CodexBak.exe → 点击「检查状态」→ 等待底部显示「可用备份：X 个」且右侧列出至少一个带时间戳的备份条目。如果显示「无可用备份」，说明之前没成功执行过备份，或备份目录被手动清空过。
双击任意一条备份记录 → 查看弹窗中「会话数量」「项目数量」是否与你预期一致。例如你只备份过 frontend 项目，但这里显示 12 个会话、3 个项目，说明该备份是全量备份，不是单项目快照。
恢复完整备份
方法一：一键全量恢复
在备份列表中选中目标条目 → 点击「恢复完整备份」→ 弹窗提示「将覆盖当前所有会话索引和 SQLite 状态」→ 【点击确定前务必关闭 CodexDesktop】 → 确认后等待进度条走完（通常 8～25 秒）→ 工具自动重启 CodexDesktop 并刷新左侧会话栏。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
方法二：仅恢复指定项目
勾选备份条目 → 点击「恢复选中项目」→ 在弹出窗口中勾选你要恢复的项目路径（如 C:\work\my-api）→ 注意：此操作不会动其他项目的会话，但会重写全局 session_index.jsonl 和 state_5.sqlite 中对应字段 → 恢复完成后需手动重启 CodexDesktop 才生效。
验证恢复结果
第一步：打开 CodexDesktop → 观察左侧面板是否出现预期的会话标题。如果仍为空，不要立刻重试，先检查右下角状态栏是否显示「Provider: custom」或你当前配置的 provider 名称——【若 provider 不匹配，会话即使存在也不会显示】。
第二步：打开终端 → 进入项目根目录 → 执行 codex resume → 查看列表中是否出现 ID 带有你熟悉时间戳的会话（如 2026-07-15T14-22-33）。能列出来，说明文件已恢复；列不出来，问题出在索引同步环节。
第三步：若 resume 可见但桌面端不可见，运行 codex-provider-sync 工具修复元数据映射 → 它会扫描 sessions/ 下所有 rollout 文件，把 provider 字段批量更新为你当前 config.toml 中设置的值 → 同步完成后重启 CodexDesktop。
