Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>Codex History LensNew to Visual Studio Code? Get it now.
Codex History Lens

Codex History Lens

hkle

|
1 install
| (0) | Free
在 VS Code 中浏览本机 Codex 会话的完整聊天记录:消息、工具调用、思考过程与截图。
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

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

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft