尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
Codex Provider Sync CLI 实战教程:3 条命令搞定 Codex 会话同步、切换与备份
Codex Provider Sync CLI 实战教程3 条命令搞定 Codex 会话同步、切换与备份【免费下载链接】codex-provider-syncSynchronize Codex session provider metadata across rollout files and SQLite state.项目地址: https://gitcode.com/gh_mirrors/co/codex-provider-syncCodex Provider Sync 是一款开源本地同步工具负责把 Codex 会话文件与 SQLite 索引里的 Provider 元数据对齐到当前配置让切换 Provider 后的旧会话恢复可用。本文带你用status、sync、switch3 条命令完成检查、同步与切换并讲清自动备份与恢复的兜底机制。它解决什么问题切换 Provider 后旧会话文件与 SQLite 聊天索引里记录的仍是原来的 Provider元数据不一致会导致历史会话不可用。Codex Provider Sync 的作用就是把这份 Provider 信息对齐到当前配置——只改 Provider 元数据不碰聊天正文同步如何读写速度取决于什么原地写当 Provider 名称字节等长等条件满足时直接改写 Provider不生成整份会话副本流式替换其他情况更新首行后流式复制正文到新文件再替换原文件。两种方式自动选择无需调任何加速选项。速度主要取决于需更新的会话数量详细原理见 docs/WORKING_PRINCIPLE_ZH.md。准备工作一键安装 CLICLI 通过 npm 发布要求 Node.js16.20.2npm install -g dailin521/codex-provider-sync codex-provider help命令是否可用以安装版本的--help为准。完整 CLI 入口逻辑在 src/cli.js同步业务核心在 packages/core/src/application/provider-sync.js。第 1 条命令codex-provider status 只读检查codex-provider statusstatus是纯只读检查重点核对当前 Provider来自config.toml根级model_providerCodex Home / SQLite Home确认工具看到的是你想操作的那份数据Provider 分布会话文件数与索引行数不一定相等Provider 分布才是同步判断的主要依据。状态未完整读取时不能把命令退出 0 当作已同步。第 2 条命令codex-provider sync 同步到当前配置如果你已用 CCSwitch 等工具切好 Provider只需要codex-provider sync关键行为目标始终来自config.toml不修改配置不调整历史模型、目录或消息标记无实际写入时不产生备份noop有实际写入时先创建受管备份默认保留最近 2 份问题会话会被跳过并保留关联索引正常会话继续处理显示部分完成。写前会自动备份备份位于Codex Home/backups_state/provider-sync/同一 Home 的操作共用备份池。第 3 条命令codex-provider switch 切换 Provider希望由本工具直接切换 Provider 时codex-provider switch openai codex-provider switch my-provider --keep-root-model codex-provider switch my-provider --model model-name模型策略对根级model的影响不传模型选项目标 Provider 配置了model时采用该值否则保留当前根模型--keep-root-model保留当前根模型--model NAME设置为指定名称三种方式都先修改配置再执行同一个 ProviderSync不会修改历史会话记录的模型。自定义 Provider 需要预先配置不会由此命令创建。安全兜底恢复备份与清理codex-provider restore 备份目录 codex-provider sync --keep 2 codex-provider prune-backups --keep 2restore默认恢复备份实际包含的配置、索引和会话元数据--no-config、--no-db、--no-sessions可排除对应内容恢复依赖的受保护备份不会被强制裁剪prune-backups的0表示删除全部可清理备份不是关闭清理Restore 会先保存目标当前状态再用独立 journal 和补偿机制恢复不要用删除锁文件绕过未完成状态。一个核心三个入口Windows 桌面版、Local Web 和 CLI 使用同一套同步、切换、备份与恢复逻辑——选择入口只影响操作方式不影响同步结果设计决策见 docs/adr/0002-node-core-as-single-authority.md。想先预览影响再确认推荐桌面或 Web 界面Web 模式通过codex-provider web启动默认只监听127.0.0.1:8791打开浏览器完成配对即可。进阶技巧JSON 输出与退出码自动化脚本务必加--jsonstdout 只输出一个终态对象{schemaVersion, command, ok, outcome, result, warnings, error}codex-provider sync --json退出码含义0成功或无需修改1普通失败可能已回滚结合outcome判断2输入无效、计划过期或状态变化3部分完成查看失败阶段与重试建议4 / 5需要恢复处理 / 正忙或无法验证锁130已取消另外codex-provider watch可长期监听配置与 SQLite 状态事件自动调用同一 Sync默认防抖 750 msCtrlC 停止。常见问题速查Provider 未定义先修复配置Sync 不会擅自切回 OpenAI数据已变化 / 计划过期重新检查并运行命令不要重放旧 planId会话占用结束相关写入后再同步重试只处理未对齐的目标部分完成查看操作日志中跳过原因最多 200 项处理数据后重新预览即可纳入WSL 场景Windows 对 WSL 的 SQLite Home 只做诊断写入请进入 WSL 后运行 CLI不要从 Windows 直接操作 WSL SQLite。完整故障处理见 docs/README_CLI_ZH.md。参考资料CLI 指南docs/README_CLI_ZH.md精确 CLI 合同docs/architecture/contracts/CLI_CONTRACT_ZH.mdNode Core 架构与 Provider I/O 不变量docs/architecture/NODE_CORE_ARCHITECTURE_ZH.md工作原理与路径解析docs/WORKING_PRINCIPLE_ZH.md错误码说明docs/architecture/contracts/ERROR_CODES_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),仅供参考
RELATED

相关推荐

用 OpenPencil Vue SDK 打造自定义编辑器外壳:provideEditor、CanvasRoot 与无样式组件实战

用 OpenPencil Vue SDK 打造自定义编辑器外壳:provideEditor、CanvasRoot 与无样式组件实战

前端桌面应用AI 应用MCP 服务 【免费下载链接】open-pencil AI-native design editor. Open-source Figma alternative. 项目地址: https://gitcode.com/gh_mirrors/op/open-pencil 点击查看 免费下载 导读:OpenPencil 不仅是开箱即用的 AI 原生设计编辑…

📅 2026/9/26 13:43:30
将Figma画布接入Codex/CC:用TaoToken统一Key打通MCP配置链路

将Figma画布接入Codex/CC:用TaoToken统一Key打通MCP配置链路

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📅 2026/9/26 13:38:30
金融场景下AI Agent协作与工程化落地:Claude、Cowork与Managed Agents API实践

金融场景下AI Agent协作与工程化落地:Claude、Cowork与Managed Agents API实践

1. 从"financial-services"这个标题说起:一个被低估的工程化命题第一次看到financial-services这个标题,很多人第一反应是"这不就是个行业分类吗"。但如果你真的在金融科技领域待过,就会明白这四个字背后压着的东西有多重…

📅 2026/9/26 13:38:30
MORE NEWS

更多资讯

📰

Vue集成WebUploader实现金融大文件断点秒传实战

做金融保险系统的客户资料上传模块,是我这几年在Vue项目里反复打磨的一个环节。最近又被问起“WebUploader能不能做断点秒传”,因为理赔资料、投保单影像、体检报告这些大附件,动不动就是几十上百MB,甚至几百MB,网络一…

📰

贪心算法核心:单调区间收割与分类极值四类模型精讲

贪心算法大概是所有算法专题里最“反直觉”的一个。明明每一步都只盯着眼前的最优解,最后却常常能交出全局最优的答卷;可换一道题,同样的“眼前最优”又会把你带进沟里。这个专题(二)我想集中拆一类特别典型的贪心场景…

📰

基于umeditor的机械行业截图OCR识别插件开发实战

搞机械行业信息化的朋友,应该都经历过这种场景:工艺员拿到一张零件图,要把标题栏里的图号、材料、表面处理逐行敲进ERP;技术员翻着几百页的《机械设计手册》,要把里面的参数、公式抄到技术文档里。字一多、符号一杂&am…

📰

VB6.0鼠标点击移动操作程序代码:用TaoToken统一Key接入AI辅助排查

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📰

LabVIEW与Halcon语义分割集成实战:从模型训练到上位机部署

1. 为什么是LabVIEWHalcon,而不是其他搭配1.1 各干各的:LabVIEW是"壳",Halcon是"核"做机器视觉项目的人都知道,现场最怕的不是算法本身难写,而是算法在上位机里跑不起来。LabVIEW的强项从来没变过…

📰

MySQL binlog反序列化报错排查:Error while deserializing event at offset

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬