Codex 桌面端侧边栏聊天记录消失：原因与修复方法 2026年7月25日

以下是用codex修复后给出的分析

问题表现

Codex Desktop 更新后，侧边栏中的“项目”和“最近”突然变成空白，但通过搜索仍然可以找到并打开以前的聊天记录。

问题主要出在新版侧边栏的显示模式和过滤条件。

原因分析

本次实际排查发现，新版会根据首次引导中保存的职业标签自动判断工作模式。例如职业标签为 legal（法律）时，客户端可能自动进入工作模式。

在部分自定义 API 登录环境中，该模式与本地会话侧边栏不兼容，前端状态会变成：

- sidebarMode = "chatgpt"（使用 ChatGPT 侧边栏模式）

- localConversationsAllowed = false（不允许显示本地会话）

因此，聊天记录本身还在，搜索也仍然有效，但“项目”和“最近”会被侧边栏过滤掉。

这是一次更新后的状态迁移或兼容性问题：旧版保存的职业标签被新版重新解释，并据此切换了侧边栏模式。只修改 workMode（工作模式）通常无效，因为客户端启动后还会根据 roles（职业标签）重新计算。

适用范围

以下特征同时出现时，可以优先按本文处理：

- 更新 Codex Desktop 后才出现问题。

- “项目”和“最近”均为空。

- 搜索仍能找到并打开以前的聊天记录。

如果搜索也找不到记录，可能是数据库、账号或数据目录问题，不一定属于本文所述故障。

通用修复方法

1. 完全退出 Codex Desktop

先关闭窗口，再确认系统托盘和任务管理器中没有残留的 Codex 进程。应用仍在后台运行时修改配置，退出时可能会把旧状态重新写回。

2. 备份配置

配置目录的一般位置为：```
C:\Users\*\.codex\
``需要修改的文件为：``
C:\Users\*\.codex\.codex-global-state.json
``在命令或脚本中，建议使用下面的写法，它会自动指向当前 Windows 用户：``
%USERPROFILE%\.codex\.codex-global-state.json
``修改前至少备份该文件；更稳妥的做法是备份整个 .codex` 目录。

3. 清除职业标签和工作模式

打开 .codex-global-state.json，找到以下对象：```
electron-persisted-atom-state
└─ electron:onboarding-welcome-v2-role-state
``把其中两个字段修改为：``
{
"roles": [],
"workMode": null
}
```只修改这两个字段，不要删除聊天、项目、插件、MCP、授权或其他配置。

4. 重新启动并验证

正常启动 Codex Desktop。修复成功后，“项目”和“最近”应恢复显示，本地侧边栏状态应回到：

- sidebarMode = "codex"（使用 Codex 本地侧边栏）

- localConversationsAllowed = true（允许显示本地会话）

让 Codex 命令行自动修复的提示词

先完全退出 Codex Desktop，再在 Codex CLI 中发送下面这段提示词：```
请修复当前 Windows 用户的 Codex Desktop 侧边栏聊天记录不显示问题。
​
已知现象：侧边栏的“项目”和“最近”都是空的，但搜索可以找到并打开旧聊天，说明聊天数据仍然存在。
​
请按以下要求处理：
1. 检查 %USERPROFILE%\.codex\.codex-global-state.json。
2. 不要读取、输出、复制或修改任何 API Key、令牌、密码及其他敏感信息。
3. 修改前把原文件备份到 %USERPROFILE%\.codex\ 下带日期时间的备份目录。
4. 在 electron-persisted-atom-state 中找到 electron:onboarding-welcome-v2-role-state。
5. 仅将 roles 设置为空数组 []，将 workMode 设置为 null；不要修改聊天、项目、插件、MCP、授权和其他配置。
6. 修改后重新读取相关字段，确认 JSON 有效，并告诉我备份位置和验证结果。
7. 如果字段结构与上述描述不一致，先停止修改，只报告实际结构和建议，不要猜测写入。