用途：当切换 Codex 的 model_provider（如 OpenAI 与 Anthropic 互切）后，历史会话可能因 rollout 文件、SQLite thread 表与项目路径缓存中的 provider/可见性元数据不一致而在 Codex Desktop 或 /resume 中不可见。本工具用于同步这些元数据。
主要能力：同步 ~/.codex/sessions、~/.codex/archived_sessions、~/.codex/state_5.sqlite 的 threads 表以及 .codex-global-state.json 项目根路径缓存；提供状态检查（dry run）、同步元数据、切换 provider 并同步、按时间戳备份恢复、清理旧备份。
使用方式：Windows 可下载 CodexProviderSync.exe，解压运行后 Refresh 扫描、选择目标 provider、Execute 同步。CLI 需 Node.js 24+，安装：npm install -g git+https://github.com/Dailin521/codex-provider-sync.git。常用命令：codex-provider status、codex-provider sync、codex-provider switch anthropic、codex-provider restore <backup-dir>、codex-provider prune-backups --keep 5。也提供 Node.js 编程接口 checkStatus、syncProvider、switchProvider、restoreBackup。
限制：不修改会话内容、消息或标题；不处理认证或 auth.json；不跨 provider 重新加密 encrypted_content；不修改 updated_at 以改变排序。含 encrypted_content 的会话可能仅恢复列表可见性，继续使用仍可能报 invalid_encrypted_content。Codex Desktop 首屏仅加载最近 50 个会话，超出部分不会显示。当前不支持仅同步特定 provider。数据库被占用时需先关闭 Codex 应用。
适用场景：切换 provider 前后检查与同步会话可见性、恢复因元数据不一致而隐藏的历史会话、回滚同步操作。