企业官网建设流程全解析

Codex历史会话消失？一键恢复可见！Codex Provider Sync使用教程

大家好 这里是「代码简单说」`,欢迎大家关注同名公众号,不定时更新更多实用有趣的教程 也欢迎大家在评论区一起讨论交流!~

关键词：Codex历史会话恢复、Codex Provider切换、Codex会话丢失、Codex Desktop、Codex Provider Sync、Codex历史记录找回、Codex会话不可见解决方法

最近不少开发者在使用 Codex 时遇到一个非常头疼的问题：切换了 model_provider 之后，之前的聊天记录突然没了。

codex客户端下载:https://codexdown.cn/

明明会话文件还在磁盘中，但是：

• Codex Desktop看不到
• /resume找不到
• 项目侧边栏显示空白
• 历史对话仿佛消失

很多人第一反应以为是数据丢失了。

实际上，大多数情况下并不是会话丢失，而是 Codex 内部的 Provider 元数据没有同步导致的。

今天分享一个开源工具：

codex-provider-sync

专门用于修复 Codex Provider 切换后历史会话不可见的问题。

什么是 codex-provider-sync

GitHub项目：

codex-provider-sync

作用非常简单：

当切换 model_provider 后，自动同步 Codex 的各种元数据，让历史会话重新显示出来。

它不会修改你的聊天内容。

不会修改历史记录。

不会修改消息数据。

仅修复：

• Provider 元数据
• Rollout 元数据
• SQLite状态数据
• 项目缓存数据

从而让 Codex Desktop 和 CLI 能重新识别这些历史会话。

为什么会出现历史会话消失

Codex内部会维护多种状态文件：

~/.codex/sessions

~/.codex/archived_sessions

~/.codex/state_5.sqlite

.codex-global-state.json

当你切换：

model_provider = "openai"

改成：

model_provider = "apigather"

或者其它 Provider 时：

这些文件中的 Provider 信息可能不一致。

结果就是：

会话文件存在 ↓ SQLite记录不匹配 ↓ Desktop过滤掉 ↓ 历史会话不可见

所以看起来像丢失了。

实际上数据还在。

codex-provider-sync解决方案

工具会自动同步：

同步后：

Desktop重新识别 CLI重新识别 历史会话恢复显示

软件下载

Windows图形版使用教程

对于大部分用户来说：

直接使用 EXE 即可。

启动：

CodexProviderSync.exe

操作步骤：

第一步：刷新状态

点击：

Refresh

扫描当前Codex环境。

第二步：选择Provider

例如：

openai

或者：

apigather

选择你当前正在使用的Provider。

第三步：执行同步

点击：

Execute

即可开始修复。

CLI安装方式

如果你喜欢命令行。

安装：

npminstall-ggit+https://github.com/Dailin521/codex-provider-sync.git

要求：

Node.js 24+

如果是：

Node 20 Node 22

可能出现：

node:sqlite

相关错误。

建议升级到：

Node.js 24+

常用命令详解

查看状态

codex-provider status

用于诊断：

• 当前Provider
• SQLite状态
• Rollout状态
• 项目可见性

同步历史会话

codex-providersync

功能：

不切换Provider 只同步历史会话元数据

指定Provider同步

codex-providersync--provideropenai

示例：

codex-providersync--providerapigather

切换Provider并同步

codex-provider switch apigather

执行过程：

修改config.toml ↓ 切换Provider ↓ 同步所有元数据

一步完成。

恢复备份

codex-provider restore backup_path

例如：

codex-provider restore C:\Users\Admin\.codex\backups_state\provider-sync\20260608

支持：

--no-config

--no-db

--no-sessions

选择性恢复。

清理旧备份

codex-provider prune-backups--keep5

表示：

保留最近5份备份 删除更早备份

关于最近50条会话限制

这是很多人误判的问题。

即使同步成功：

Desktop仍然看不到历史记录

原因可能不是同步失败。

而是：

Codex Desktop只加载最近50条会话

官方前端存在限制。

例如：

项目A有20条 项目B有30条 项目C有100条

Desktop首屏：

只显示最近50条

那么：

项目C的旧记录

即使恢复成功。

仍然不会出现在列表中。

如何判断是不是50条限制

执行：

codex-provider status

或者GUI：

Refresh

如果看到：

first page 0/50

或者：

ranks 64-77

类似提示。

说明：

会话已经恢复 只是没有进入前50条列表

不是同步失败。

工具不会做什么

为了安全性。

作者明确限制了修改范围。

不会修改：

登录状态

auth.json

不处理。

账号切换

第三方切号工具不处理。

聊天内容

不会修改：

消息内容 会话标题 历史记录

会话排序

不会修改：

updated_at

不会通过作弊方式把会话顶到前面。

加密内容转换

不会重新加密：

encrypted_content

因此：

跨Provider 跨账号

虽然能恢复列表显示。

但继续聊天时仍可能出现：

invalid_encrypted_content

错误。

自动备份机制

每次执行：

sync

或者：

switch

之前。

工具都会自动创建备份。

路径：

~/.codex/backups_state/provider-sync/<timestamp>

例如：

~/.codex/backups_state/provider-sync/20260608123000

这样即使出现异常。

也能随时恢复。

常见问题

state_5.sqlite被占用

出现：

database locked

解决：

关闭：

Codex Codex Desktop app-server

然后重新执行。

SQLite损坏

出现：

malformed

或者：

unreadable

说明数据库已经损坏。

工具会停止同步。

避免进一步破坏数据。

EXE无法启动

检查：

是否已经解压

然后查看：

%AppData%\codex-provider-sync\startup-error.log

或者PowerShell运行：

./CodexProviderSync.exe

查看具体错误。

项目特点总结

总结

如果你经常在多个 Codex Provider 之间切换，那么大概率会遇到：

历史会话突然消失

的问题。

事实上绝大部分情况下：

数据没丢 只是元数据不一致

而codex-provider-sync正是专门解决这个问题的工具。

它能够同步：

• sessions
• archived_sessions
• state_5.sqlite
• 项目缓存

让 Codex Desktop 和 CLI 重新识别历史会话。

对于频繁使用：

• OpenAI
• API聚合平台
• 本地Provider

等多Provider环境的开发者来说，是一个非常实用的辅助工具。

下载地址

如果你经常遇到 Codex 历史记录消失的问题，建议收藏备用。