让 AI 编程助手永远保持初速:Keep Codex Fast 让你的 Codex 永不失速

让 AI 编程助手永远保持初速：Keep Codex Fast 让你的 Codex 永不失速

当 Codex 工作了几周之后，聊天记录、终端日志、工作树和项目历史堆积，它开始变慢了——每次回复要等几秒，曾经行云流水的代码补全开始卡顿。这种”AI 助手变迟钝”的困扰，正在成为越来越多开发者的痛点。

Keep Codex Fast（vibeforge1111/keep-codex-fast）来了——一个”先交接再归档”的状态管理技能，让你的 Codex 从归档旧聊天开始，每次都像刚装好一样快。

👉 GitHub 开源地址：vibeforge1111/keep-codex-fast

核心定位：不是清理工具，是一个状态管理框架

大多数人一听到”AI 助手变慢”，想到的是”清缓存、删日志”。Keep Codex Fast 做了不同的选择：先做交接文档，再归档而非删除，只在明确要求时才应用变更。

核心理念只有一句话：

> Make handoffs first. Archive, don’t delete. Apply changes only when you are ready.

翻译过来：先做交接文档，再归档而非删除，只在你明确要求时才应用变更。

这背后的逻辑很清晰——Codex 的聊天记录里藏着你在这个项目里的所有决策上下文、调试路径和未完成的想法。直接删掉意味着你在哪个项目、做什么功能、卡在哪里，全丢了。下次打开 Codex，得从头解释一遍。

所以 Keep Codex Fast 的设计哲学是：聊天用于执行，交接文档用于记忆，归档用于历史，新线程用于速度。

!Keep Codex Fast cover

快速上手：3 行代码体验

安装方式极为简单，让 Codex 执行一条指令即可：

Install the keep-codex-fast skill from https://github.com/vibeforge1111/keep-codex-fast

安装完成后，让 Codex 执行报告模式（默认只读，不写任何文件）：

Use $keep-codex-fast to inspect my Codex local state and recommend a safe maintenance plan.

Codex 会展示本地状态的增长情况，以及归档建议。然后你决定哪些要交接、哪些要保留活跃、哪些可以归档。

如果需要手动运行脚本，也有完整命令行支持：

python scripts/keep_codex_fast.py              # 只读报告python scripts/keep_codex_fast.py --details      # 显示原始 thread ID、聊天标题、路径python scripts/keep_codex_fast.py --backup-only # 仅创建备份，不移动本地状态python scripts/keep_codex_fast.py --apply --archive-older-than-days 10  # 备份后归档/清理python scripts/keep_codex_fast.py --apply --wait-for-codex-exit          # 等待 Codex 退出后再应用

三种运行模式：按需选择，不强迫

模式1：报告模式（默认）

只读，不写任何文件。查看本地状态哪些在增长，在归档旧聊天前创建交接文档，在应用变更前备份重要状态。适合”先看看情况再说”的日常检查。

模式2：Backup-Only

仅创建备份，不移动或更改本地状态。适合交接前的安全网。

模式3：Apply（主动清理）

备份后执行归档/清理操作，支持 `–archive-older-than-days` 和 `–worktree-older-than-days` 参数。适合定期维护，比如每周一次。

交接文档：从”删掉”到”存档+备注”

这是 Keep Codex Fast 最独到的设计。在归档任何一个有价值的聊天之前，先让 Codex 生成一份交接文档（Handoff Doc），包含：

当前在哪个 repo、什么分支

当前目标是什么

已完成了哪些部分

涉及或调查过的文件

已运行的命令和测试

已知的错误、警告或失败的检查

悬而未决的决策

约束、用户偏好和”禁止触碰”区域

接下来 3-7 个具体步骤

交接文档保存在 repo 本地（如 `docs/codex-handoffs/YYYY-MM-DD-topic.md`），下次回到这个项目时，直接打开文档粘贴到新的 Codex 聊天，就能从上次中断的地方继续，不需要翻找旧聊天记录。

能处理什么：完整的状态清单

Keep Codex Fast 能安全处理以下内容：

旧的非固定活跃会话

停滞的工作树（stale worktrees）

过大的 `logs_2.sqlite*` 文件

`config.toml` 中的死亡/临时项目引用

Windows `\\?\C:\…` 路径不匹配问题（在 SQLite 文本字段中规范化）

它不会永久删除聊天、日志或工作树。 所有操作都是”移动到 archive 文件夹 + 写入备份/恢复清单”，有据可查，随时可恢复。

隐私设计：报告模式默认不暴露敏感信息

值得注意的是，项目的 Issue #1 来自社区深度测试：有人指出默认报告输出会暴露聊天标题和 Thread ID，可能泄露项目名或业务信息。Owner 在同一天关闭了这个问题并加固了隐私保护——默认输出现在支持伪匿名化（`session_001` 而非原始标题），报告模式现在也是真正只读的（无备份、无 SQLite 写入）。

适合谁用

Codex 使用数周后开始感觉变慢的开发者

长期保留大量聊天记录、经常恢复旧线程的用户

跨多个代码仓库工作、同时运行多个终端或开发服务器的人

希望维护过程安全、不令人恐惧的 AI 辅助编程使用者

对隐私敏感、不想在报告中暴露项目细节的专业开发者

局限与待改进

目前的脚本运行在 Codex 之外，需要手动执行（或通过定期提醒）

Windows 扩展路径规范化（`\\?\` 前缀）还在处理中（见 Issue #2）

Codex TUI 日志（`.codex/log/codex-tui.log`）的归档支持也即将推出

为什么这个项目值得关注

爆发力极强：5月2日创建，5月4日已获 661 stars，3天内 38 个 forks，增速说明大量开发者有这个痛点。

用户共创驱动：Issue #1 来自社区深度测试，Owner 当天响应并修复，体现了活跃维护。

隐私优先设计：从Issue 反馈到快速修复，把”只读”和”隐私安全”做实了，不是宣传语。

非破坏性理念：所有操作先备份再变更，不删除只归档——这个设计让维护变得不再可怕。

当你下一次发现 Codex 开始变慢时，不要急着删掉那些聊天记录。用 Keep Codex Fast 先做交接文档，让知识和上下文得以保留，再开始新的轻量级工作线程。

👉 GitHub 开源地址：vibeforge1111/keep-codex-fast