Codex 切换 model_provider 后，旧会话可能从 Desktop 或 /resume 中消失。会话通常没有丢失，而是 rollout、SQLite 和项目可见性 metadata 仍指向原 Provider。
适合使用本工具：
- 在官方订阅（内部 Provider 为
openai）和自定义中转之间切换。 - 多个配置必须使用不同的
model_provider，切换后旧会话不可见。 - rollout 与 SQLite 中的 Provider 或 model 信息不一致。
- 希望在配置或 SQLite/WAL 变化后自动重新同步。
如果所有中转都能稳定复用同一个 model_provider，并且历史会话始终可见，那么统一 Provider ID 是更简单的方案，不需要额外同步。本工具主要用于无法统一 Provider ID，或需要在官方订阅与自定义 Provider 之间切换的场景。
本工具不负责登录、认证或切换账号；请先用原有方式完成 Provider 切换，再执行同步。
- 同步
~/.codex/sessions和~/.codex/archived_sessions中的 rollout metadata。 - 同步 Codex SQLite 线程记录；优先检测
~/.codex/sqlite/state_5.sqlite，并兼容旧路径~/.codex/state_5.sqlite。 - 修复项目可见性相关路径信息，并在需要时同步相关 model metadata。
- 每次同步前自动备份，支持恢复和清理旧备份。
- 大型 rollout 文件在满足条件时原地更新，否则自动使用完整安全重写。
- CLI
watch可监听config.toml、SQLite 及 WAL 变化并自动同步。
普通 Windows 用户建议直接从 Releases 下载并解压：
- 打开
CodexProviderSync.exe - 点击“刷新”
- 选择目标 Provider
- 点击“立即同步”
GUI 会保留备份并显示同步结果。每天首次启动会在后台检查一次稳定版更新，网络查询最多等待 10 秒；也可以随时手动检查。执行日志保存在 %AppData%\codex-provider-sync\logs。
项目目前未做 Windows 代码签名，从浏览器下载后可能出现 SmartScreen 提示。请从本项目 Release 下载，并按需核对同版本 SHA-256。
Windows 完整说明见 README_GUI_ZH.md。macOS 用户可自行构建 Avalonia 桌面版，参见 README_MAC_GUI_ZH.md。
CLI 支持 Node.js 16+：
npm install -g git+https://github.com/Dailin521/codex-provider-sync.git
codex-provider status
codex-provider sync常用命令：
| 命令 | 用途 |
|---|---|
codex-provider status |
检查当前 Provider、rollout、SQLite 和项目可见性 |
codex-provider sync |
将历史会话同步到当前 Provider，不修改登录状态 |
codex-provider switch <provider-id> |
修改根级 model_provider 后执行同步 |
codex-provider restore <backup-dir> |
从指定备份恢复 |
codex-provider prune-backups --keep 5 |
只保留最近 5 份托管备份 |
codex-provider watch |
监听配置、SQLite 和 WAL 变化并自动同步 |
codex-provider watch --once |
第一次变化并成功同步后退出 |
switch 支持 --model <NAME> 显式设置根级 model，或使用 --keep-root-model 只切换 Provider。所有主要命令都支持 --codex-home <PATH>。
每次 sync / switch 前都会备份到：
~/.codex/backups_state/provider-sync/<timestamp>
- 不修改消息历史、会话标题、认证信息、
auth.json或updated_at。 - 不在多台设备之间复制配置或会话文件；它只修复当前 Codex Home 的 metadata。
- SQLite 被占用时，需要先关闭 Codex、Codex App 和 app-server 后重试。
- 活跃会话锁住 rollout 文件时，工具会跳过该文件并继续处理其它会话；结束活跃会话后可再次同步。
- 含
encrypted_content的会话跨 Provider/account 后，可能只能恢复列表可见性，继续对话或 compact 仍可能报invalid_encrypted_content。 - Codex Desktop 首屏目前只显示最近 50 条会话。若
/resume可见但项目侧仍不显示，请查看状态中的first page/ranks诊断；本工具不会修改时间戳来绕过此限制。
git clone https://github.com/Dailin521/codex-provider-sync.git
cd codex-provider-sync
npm test
dotnet test desktop/CodexProviderSync.Core.Tests/CodexProviderSync.Core.Tests.csproj
pwsh ./scripts/publish-gui.ps1
./scripts/publish-gui-macos.shMIT