5分钟上手 Codex Provider Sync安装到首次完成 Codex Provider 同步的保姆级教程【免费下载链接】codex-provider-syncSynchronize Codex session provider metadata across rollout files and SQLite state.项目地址: https://gitcode.com/gh_mirrors/co/codex-provider-syncCodex Provider Sync是一款本地元数据一致性工具用于在切换 Provider 后把 Codex 的会话文件rollout与 SQLite 聊天索引中的 Provider 信息对齐到当前配置让旧会话有机会重新可用。只需 3 条命令你就能完成从安装到首次 Codex Provider 同步的全部流程。它只对齐 Provider 元数据不修改聊天正文也不读取或改动登录凭据auth.json。一、它解决什么问题用 CCSwitch 等工具切换 Provider 后config.toml已经指向了新 Provider但旧会话文件和 SQLite 索引里仍记录着原来的 Provider。这份元数据不一致常常是旧会话无法正常继续的原因之一。同步前的不一致状态会变成同步后的一致状态而聊天内容本身逐字节不变。更多细节见 docs/WORKING_PRINCIPLE_ZH.md。二、先选入口桌面版、Local Web 还是 CLI一个核心三个入口Windows 桌面版、Local Web 和 CLI 共用同一套同步、切换、备份与恢复逻辑选择入口只影响操作方式不影响同步结果。入口适合谁前置条件️ Windows 桌面版日常双击使用的新手无需 Node.js下载即用 Local Web跨平台、想在浏览器里操作Node.js16.20.2 CLI脚本、自动化、WSL 用户Node.js16.20.2 新手推荐Windows 用户直接选桌面版其他平台选 CLI教程中的命令同样适用于 Local Web。三、第一步安装 Codex Provider Sync方式 1Windows 桌面版到项目的官方 Release 页面下载Windows x64安装版或便携 ZIP未签名便携版须完整解压不要只复制一个 EXE。下载入口说明见 README.md 的下载 Windows 桌面版一节完整操作说明见 docs/README_DESKTOP_ZH.md。方式 2CLI / Local Webnpm 安装安装 Node.js16.20.2后一条命令装好npm 包名为dailin521/codex-provider-syncCLI 入口即 src/cli.jsnpm install -g dailin521/codex-provider-sync方式 3从源码使用如果你想在本地跑 Web UI 或参与开发可先克隆仓库git clone https://gitcode.com/gh_mirrors/co/codex-provider-sync开发环境使用 Node 24完整构建与测试命令见 CONTRIBUTING.md。四、第二步检查当前状态同步前先确认当前 Provider、Codex Home、SQLite Home 和实际数据库文件是否正确。CLI 用户执行只读检查不会写入任何数据codex-provider status桌面版用户打开概览页面即可看到相同信息当前 Provider、rollout 文件数、SQLite threads 数、按 Provider 分布的会话柱状图以及待执行的同步入口。核对要点详见 docs/README_CLI_ZH.md✅ 当前 Provider 是你要使用的目标✅ 会话文件数量与索引行数不一定相等Provider 分布才是同步判断的主要依据⚠️ 若状态尚未完整读取不要把命令退出 0 当作已同步。五、第三步完成首次 Codex Provider 同步确认状态无误后正式执行同步。CLI 用户codex-provider sync同步目标始终来自config.toml根级model_provider缺失时使用内置openai。sync不修改配置也不调整历史模型、目录或消息标记。桌面版用户两种方式内部走同一套计划、锁、复核和备份检查预览同步先查看影响范围和备份提示确认后执行适合第一次使用直接同步点击即执行没有第二次确认。同步完成后你会看到最终结果更新数量、跳过数量、备份位置。若出现部分完成通常是某些会话正被占用或首行格式异常——结束相关占用会话后重试即可已完成的部分不会自动全量回滚。️ 安全机制存在实际写入时会先创建受管备份默认保留最近 2 份无需修改时不产生备份。备份位于Codex Home/backups_state/provider-sync/。六、同步出问题三步自救查看原因桌面版在操作日志查看失败阶段与错误码CLI 可用codex-provider sync --json检查outcome字段退出码 3 表示部分完成需查看失败阶段。等待占用结束正在被 Codex 写入的会话会被跳过等它停止写入后重新同步。手动恢复若同步错了在备份 / 恢复中选择对应操作前的备份恢复CLI 使用codex-provider restore BACKUP_ID具体步骤见 docs/README_DESKTOP_ZH.md 与 docs/README_CLI_ZH.md。七、常见问题速答Q已经用 CCSwitch 切换了 Provider还需要做什么只需打开本工具确认当前 Provider 正确再点击同步。若会话文件和索引中的 Provider 已一致就无需重复同步。Q同步会修改聊天内容或登录信息吗不会。只对齐 Provider 元数据不碰聊天正文、历史模型、排序时间也不读取auth.json。Q同步后旧会话仍无法继续怎么办Provider 一致只是继续会话的一个条件。请查看 Codex 的具体报错若涉及加密内容或模型兼容问题可回到原 Provider / 账号或新建会话。Q想省得手动执行可以自动同步吗可以。CLI 运行codex-provider watch持续监听配置与 SQLite 状态事件桌面版在设置中开启 Watch 即可。总结5 分钟回顾步骤操作耗时1️⃣ 安装npm install -g dailin521/codex-provider-sync或下载桌面版~1 分钟2️⃣ 检查codex-provider status核对 Provider 与分布~1 分钟3️⃣ 同步codex-provider sync完成首次 Codex Provider 同步~3 分钟至此你已经完成了从安装到首次同步的全部流程。接下来可以继续探索按项目浏览聊天记录的 Local Webdocs/README_WEB_UI_ZH.md、桌面版完整功能docs/README_DESKTOP_ZH.md、版本变更CHANGELOG.md以及同步的工作原理docs/WORKING_PRINCIPLE_ZH.md。【免费下载链接】codex-provider-syncSynchronize Codex session provider metadata across rollout files and SQLite state.项目地址: https://gitcode.com/gh_mirrors/co/codex-provider-sync创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考