Codex History Lens(Codex 聊天记录)
English | 简体中文
在 VS Code 里直接翻阅本机 Codex 的历史会话,并一键回到 Codex 继续对话。插件只读取 Codex 自己保存的 rollout 记录,不修改、不上传任何数据。
这是一个社区扩展,与 OpenAI 无隶属关系。

功能
- 侧栏按天分组列出 Codex 会话(今天、昨天、11月18日…),组内按时间倒序;标题取自 Codex 的会话索引。
- 聊天面板按气泡还原对话:你的消息、Codex 回复、思考过程、工具调用输入/输出、用户截图。
- 工具调用与思考过程默认折叠,可单条展开,也可一键展开/收起全部。
- 面板内搜索(
Ctrl+F),支持过滤消息、工具输入和输出。
- 跨会话全文搜索:命中后直接跳到对应消息。
- 点击回复里的本地文件链接可直接打开对应文件与行号;
http(s) 链接用系统浏览器打开。
- 一键导出为 Markdown,或打开原始
.jsonl 记录。
- 会话右键可在 Codex 中继续对话;已归档会话可还原到 Codex 对话,自动取消归档并打开。
- 监听
sessions/**/*.jsonl,会话进行中也能刷新/自动更新。
- 跟随 VS Code 明暗主题,除 VS Code 本身外无第三方依赖。
浅色主题下的聊天面板:

安装
方式一:在 VSIX 所在目录执行命令行安装。
code --install-extension .\dist\codex-history-lens-hkle-1.2.0.vsix
方式二:VS Code 里打开「扩展」视图,点右上角 ... → 从 VSIX 安装…,选择 dist\codex-history-lens-hkle-1.2.0.vsix。
安装后左侧活动栏会出现 Codex 聊天 图标;也可以按 Ctrl+Shift+P 执行 Codex: 打开聊天记录。
还原到 Codex
在侧栏的会话条目上点右键:
- 普通会话:在 Codex 中继续对话。插件通过
vscode://openai.chatgpt/local/<会话ID> 直接打开 Codex 侧栏里的对应会话。
- 已归档会话(需先开启
codexHistory.showArchived):还原到 Codex 对话。插件先执行 codex unarchive <会话ID>,再打开该对话。
还原需要能定位 codex 可执行文件。查找顺序为:codexHistory.codexPath → PATH → Codex VS Code 扩展自带的 bin/**/codex。
如果会话不在 Codex VS Code 扩展使用的数据目录(默认 ~/.codex)中,深链无法加载该会话,插件会改为在集成终端执行 codex resume <会话ID> --all,仍然可以继续原来的对话。
数据与隐私
- 所有解析都在本地完成,没有遥测、没有网络上传。
- 插件默认只读。只有你主动点击「还原到 Codex 对话」时,才会调用
codex unarchive 修改归档状态。
- 本文档中的截图全部使用虚构会话:
demo-app、~/projects/demo-app、src/pages/login.tsx 等均为示例,不包含任何真实账号、路径或聊天内容。
- 截图由
node scripts/render-demo.js 生成,该脚本使用内置的演示数据,不会读取 sessions 目录。
- 如果你要分享自己的截图,请注意会话里可能包含真实路径、代码、密钥或个人信息;插件本身不做自动脱敏。
数据来源
默认读取 ~/.codex(Windows 为 C:\Users\<你>\.codex):
sessions/**/rollout-*.jsonl:完整会话记录
session_index.jsonl:会话标题与更新时间
archived_sessions/**:可选的已归档会话
如果设置了环境变量 CODEX_HOME,或 Codex 数据在别处,请在设置里修改:
{
"codexHistory.codexHome": "D:\\path\\to\\.codex"
}
设置
| 设置 |
默认值 |
说明 |
codexHistory.codexHome |
空 |
Codex 数据目录,留空时用 CODEX_HOME 或 ~/.codex |
codexHistory.codexPath |
空 |
codex 可执行文件路径,留空时自动查找 PATH 与 Codex 扩展自带版本 |
codexHistory.maxSessions |
300 |
侧栏最多显示的会话数 |
codexHistory.showArchived |
false |
是否显示已归档会话 |
codexHistory.groupByDate |
true |
是否按天分组 |
codexHistory.showToolCalls |
true |
是否显示工具调用 |
codexHistory.showReasoning |
true |
是否显示思考过程 |
codexHistory.expandToolCalls |
false |
是否默认展开工具调用 |
命令
Codex: 打开聊天记录
Codex: 刷新会话列表
Codex: 筛选会话列表 / Codex: 清除会话筛选
Codex: 只看当前工作区的会话
Codex: 在全部会话内容中搜索
Codex: 打开 Codex 数据目录
Codex: 在 Codex 中继续对话(会话右键)
Codex: 还原到 Codex 对话(已归档会话右键)
会话条目的右键菜单还可以导出 Markdown、打开原始记录、在文件资源管理器中显示。
已知限制
- 只解析 Codex rollout 的
response_item / event_msg 结构;如果未来 Codex 改了记录格式,插件需要同步适配。
- 思考过程只有在记录里存在明文摘要时才会显示。Codex 常见的加密 reasoning 内容无法解密,因此不会显示。
- 用户消息中内嵌的图片只在有
input_image 数据时显示;历史版本可能只记录文本。
- 全文搜索会流式读取全部会话文件,会话很多时第一次搜索会有几秒耗时。
- 「还原」依赖 Codex VS Code 扩展的
/local/<会话ID> 深链。该路由是扩展内部的未公开接口,Codex 升级后格式可能变化;变化时插件会回退到 codex resume 终端方式。
- Codex 扩展默认只加载
~/.codex 下的会话。若插件配置了其他 CODEX_HOME,那些会话只能在终端里 resume,不会出现在扩展侧栏。
开发与打包
cd codex-chat-history
npm test
npm run build:vsix
npm test 会用真实的本机会话做冒烟校验;打包脚本零依赖,直接生成 VSIX。
生成 README 效果图(需要 Edge 或 Chrome):
node scripts/render-demo.js
想在开发时快速看真实会话的渲染效果,可执行 node scripts/preview.js;它会读取本机会话,生成的预览页包含真实内容,请勿直接公开。
打包结果默认写入项目内的 dist\,也可以通过 node scripts/build-vsix.js <输出目录> 指定其他位置。
项目结构
extension.js 激活入口、命令、文件监听
src/parser.js rollout JSONL 解析
src/store.js 会话索引、缓存、全文搜索
src/tree.js 侧栏树
src/panel.js Webview 聊天面板
src/exporter.js Markdown 导出与本地链接跳转
src/codexCli.js 定位 codex、取消归档、深链与终端恢复命令
src/markdownExport.js 导出格式
media/ 面板样式、Markdown 渲染、交互脚本
docs/images/ README 效果图(虚构数据)
test/ 解析、渲染与命令测试
scripts/build-vsix.js 零依赖 VSIX 打包
scripts/render-demo.js 用虚构数据生成效果图
License
MIT