Codex 历史会话删除工具

本工具适用于 Windows、Linux / Ubuntu项目地址leungWHu/codex-history-manager最近在 Windows 上使用 Codex 时我遇到一个挺容易被忽略的问题通过 Desktop、VS Code、cmd 等不同入口开启过 Codex 对话后如果当时只是关闭窗口没有正确归档或删除后面就很容易忘记这些历史会话到底在哪里。更麻烦的是不同入口产生的记录并不总是能在同一个界面里完整显示。例如 Desktop 端不无法看到从 VS Code 或命令行里开启过的全部对话。对熟悉命令行和 Codex 数据结构的程序员来说这可能不是大问题但对 Windows 小白用户或非程序员来说想安全清理历史记录就不太友好。于是我做了一个小工具Codex History Manager。它是一个本地运行的 Codex 历史会话删除工具可以在浏览器里集中查看、搜索、分组和删除本机 Codex 历史会话。适合谁使用先说明一下边界如果你是高级程序员熟悉 Codex CLI建议优先使用 Codex 官方内置的归档或删除方式。例如用/archive或codex archive隐藏会话但保留 transcript确认不再需要时再用/delete或codex delete永久删除会话。这个工具更适合下面这类用户主要在 Windows 上使用 Codex不熟悉.codex目录结构不想手动查找jsonl、SQLite、索引文件曾经通过 Desktop、VS Code、cmd 等多个入口开启过对话想用网页界面确认会话内容后再删除它的目标不是替代官方归档和删除入口而是给普通用户提供一个更直观的本地辅助界面。它能做什么工具启动后会在本机开启一个 Web 页面默认只监听127.0.0.1。页面会读取本机 Codex 历史数据并按项目目录、临时会话、归档会话等方式整理出来。主要功能包括查看本机 Codex 历史会话按项目目录自动分组搜索会话标题、工作目录和首条用户消息查看会话创建时间、更新时间、消息数量和文件路径展示用户消息、处理过程、最终回复等内容删除单个会话或整个分组的会话删除前生成清理计划并要求二次确认对 Windows 小白用户来说最有用的是两点集中查看和安全删除。集中查看可以避免在 Desktop、VS Code、命令行之间来回找记录安全删除则避免了直接手动删除.codex文件时的不确定性。界面预览会话列表和分组视图删除前的二次确认为什么不建议手动删文件Codex 的历史数据不只是一份文本文件。一个会话可能同时出现在会话jsonl、索引文件、SQLite 数据库、全局状态文件和 shell snapshot 等多个位置。如果只删掉其中一部分界面或索引里可能还会残留引用如果手动删错文件又可能影响其他会话。因此这个工具在删除时做了一些保护校验会话 ID确认会话文件位于 Codex 数据目录内拒绝删除当前正在运行的会话删除前展示预计清理内容单个会话删除需要输入短 ID分组删除需要输入固定确认文本删除后再次检查残留引用这些步骤看起来比“直接删文件”麻烦但对于面向普通用户的删除工具来说保守一点更合适。简单使用Windows 用户可以下载项目后双击运行start_windows.bat也可以直接运行python server.py更详细的启动方式、参数说明和项目结构可以查看 GitHub READMEleungWHu/codex-history-manager使用提醒这个工具只在本机读取 Codex 历史数据不会上传到远程服务。不过删除操作会修改.codex里的本地数据文件而且删除后不可撤销。首次使用删除功能前建议先备份.codex目录。另外删除 Codex 历史会话不会删除你的项目目录也不会删除项目里的代码文件。总结Codex History Manager 是一个很小的本地工具主要解决普通 Windows 用户在多个入口使用 Codex 后历史会话不好集中查看和删除的问题。如果你熟悉命令行官方内置的归档和删除方式仍然是首选如果你只是想通过一个网页界面看清楚本机 Codex 历史并谨慎清理不需要的会话这个工具会更直观一些。