我做了一个 VS Code 扩展：CodexChat，本地管理和恢复 Codex 历史会话

本文适合发布到 CSDN。发布前可以把文中的本地图片上传到 CSDN 图床，或直接使用 CSDN 编辑器的图片上传功能替换相对路径。

摘要

最近在使用 OpenAI Codex 做项目开发时，我遇到一个很实际的问题：本地历史会话越来越多，但想按项目快速找到某一次对话、查看上下文、继续之前的工作并不方便。

于是我做了一个 VS Code 扩展：CodexChat。它会读取本机 .codex 数据目录，把 Codex 历史会话按项目工作目录归类，在 VS Code 侧边栏中展示，并支持打开项目、查看会话内容、跳转回 Codex 继续工作。

目前版本是 0.1.2，已经完成 VSIX 打包，并上传到 Visual Studio Marketplace，Github地址：https://github.com/MathsionYang/CodexChat-

项目背景

Codex 很适合处理代码仓库里的连续任务，比如：

• 修复 bug
• 重构模块
• 编写测试
• 根据上下文继续开发
• 回看某次工具调用或回答内容

但当会话多起来以后，历史记录会散落在本机 .codex 目录下。单纯从文件系统里找 JSONL 文件，体验并不好。

我希望有一个更贴近日常开发流程的入口：

1. 打开 VS Code。
2. 在 Activity Bar 里进入 CodexChat。
3. 按项目查看历史会话。
4. 需要时直接回到对应项目和 Codex 会话。

这就是 CodexChat 的出发点。

CodexChat 能做什么

CodexChat 主要功能包括：

• 自动扫描本机 Codex 的 sessions 和 archived_sessions。
• 根据会话里的 cwd 字段，把历史会话归类到项目目录。
• 在 VS Code Activity Bar 中提供独立入口。
• 在侧边栏中浏览项目和会话列表。
• 查看用户消息、Codex 回复和工具调用摘要。
• 监听本地会话文件变化并刷新。
• 打开对应项目工作区。
• 在兼容版本中尝试恢复指定本地会话。
• 对 Codex 原始会话文件保持只读，不修改历史数据。

界面预览

项目会话列表

会话详情

安装方式

如果你本地有 VSIX 包，可以直接在 VS Code 中安装：

code --install-extension .\codexchat-0.1.2.vsix

也可以在 VS Code 里选择：

Extensions -> ... -> Install from VSIX...

然后选择打包好的文件：

codexchat-0.1.2.vsix

在线搜索

使用方式

安装完成后：

1. 打开 VS Code。
2. 在左侧 Activity Bar 中点击 CodexChat 图标。
3. 插件会自动读取默认 Codex 数据目录。
4. 在项目列表中选择一个项目。
5. 点击会话即可查看历史内容。
6. 需要继续工作时，可以打开对应项目并进入 Codex。

默认情况下，CodexChat 会读取当前用户目录下的 .codex。如果你的 Codex 数据目录不在默认位置，可以通过 VS Code 设置项调整：

总结

CodexChat 是一个围绕 Codex 本地历史会话管理的小工具。它不改变 Codex 的原始数据，只做读取、归类、展示和跳转，让我在多项目、多会话的开发场景里更容易回到之前的上下文。

这次开发和发布过程中，也顺手踩了一遍 VS Code 扩展从开发、打包到 Marketplace 上传的流程，尤其是 Publisher ID、VSIX 包、图标格式这些细节。

后续我计划继续优化：

• 更好的会话搜索。
• 更清晰的工具调用摘要。
• 更稳妥的会话恢复兼容策略。
• 更完整的 Marketplace 页面说明。

如果你也经常用 Codex 做项目开发，类似的本地会话管理能力应该会很有帮助。