一个用于恢复 Codex Desktop 本地历史对话显示的小工具。

当你切换 API、provider、模型或登录方式之后，Codex Desktop 有时会出现“本地历史明明还在，但侧边栏看不到”的情况。这个工具会检查本机的本地历史数据库、会话文件和侧边栏索引，并把旧线程重新挂到当前正在使用的 model_provider / model 下面。

• 查看当前本机 Codex 历史线程属于哪些 provider
• 查看当前本机 Codex 历史线程属于哪些 model
• 一键把旧 provider / model 下的线程、会话元数据和侧边栏索引同步到当前设置
• Codex Desktop 正在运行时也可以同步；如果本地数据库正在写入，工具会等待空闲后继续
• 在同步前自动备份数据库、侧边栏索引和会话元数据
• 从备份恢复数据库
• 提供一个可直接点击的 Windows 图形界面

• 你切换了不同 API
• 你切换了不同 provider
• 你切换了不同模型
• 你切换了登录方式
• 你确认本地历史文件还在，但 Codex Desktop 左侧历史列表变空了

• 云端账号之间的聊天记录互相同步
• 本地历史文件已经被删除
• 不同电脑之间迁移聊天记录

• Windows
• PowerShell 5.1 或更高版本
• 已安装 Python 3.10 或更高版本，并可通过 py -3 调用
• 本机存在 Codex Desktop 本地数据目录，通常是 %USERPROFILE%\\.codex

powershell -NoProfile -ExecutionPolicy Bypass -File .\launch_ui.ps1

powershell -NoProfile -ExecutionPolicy Bypass -File .\launch_ui.ps1 -InstallShortcutOnly

py -3 .\sync_backend.py --json status

py -3 .\sync_backend.py --json sync

py -3 .\sync_backend.py --json backup

py -3 .\sync_backend.py --json restore

py -3 -m unittest discover -s tests -v

• 每次同步前都会自动创建一份备份
• 每次恢复前也会先创建一份安全备份
• 备份默认保存在 %USERPROFILE%\\.codex\\history_sync_backups
• 新版备份会同时保存 session_index.jsonl 和会话文件首行元数据，恢复时会一起还原

• Codex Desktop 开着也可以同步；如果它正在生成回复或保存历史，工具可能会等待几秒
• 恢复备份会覆盖当前状态，最稳妥的做法仍然是在恢复前暂停正在运行的 Codex 任务
• 如果同步完成后历史列表没有立刻刷新，重开一次 Codex Desktop 即可
• 新版 Codex 可能还会按当前项目目录显示历史。如果同步后仍然看不到旧对话，先确认是否打开了旧对话原来的项目目录；本工具默认不会批量改写线程的 cwd 项目归属。

• sync_backend.py：后端同步、备份、恢复逻辑
• launch_ui.ps1：Windows 图形界面

这个工具直接操作本机 Codex 的本地状态数据库。虽然已经做了自动备份，但仍建议你在使用前先理解它的作用，并自行确认本地数据目录状态。