你是否发现，用 Codex 写代码越久，启动变慢、响应延迟、聊天记录杂乱、工作区堆积如山？这不是你的错——而是 Codex 的本地状态在默默膨胀。Keep Codex Fast 是一款专为 Codex 设计的「备份优先」式维护技能，它不粗暴清理，也不强制重置，而是像一位沉稳的系统管家，帮你看清状态、安全归档、按需瘦身，让每一次编码都保持清爽与可控。
核心功能
- 智能状态体检：自动扫描聊天历史、终端会话、日志文件、工作树（worktrees）和项目引用，清晰标出哪些目录/文件已显著增长，一目了然“拖慢元凶”
- 手交式归档（Handoff-First）：删除前先生成结构化归档文档（如聊天摘要、关键上下文快照），确保重要信息不丢失，告别“删完才想起要留痕”
- 零风险预演模式：默认仅报告、不执行任何写操作——所有清理、移动、旋转动作都需你明确确认，真正实现“所见即所得，所点即所信”
- 分层归档策略：对旧聊天按时间/活跃度分级归档；将长期闲置的工作树移出主工作路径但保留完整可恢复性；对大体积日志自动轮转压缩，而非直接清空
- 进程友好型诊断：识别高内存/CPU 占用的 Node.js 或开发服务器进程，仅提示告警并建议优化方案，绝不擅自 kill，保障开发流不中断
- 一键备份锚点：在执行任何状态变更前，自动创建轻量级快照备份（含 Git 状态、配置哈希、关键元数据），回滚只需一步还原
适合哪些人用
如果你符合以下任意一条，Keep Codex Fast 就是为你而生：
✅ 长期保留数十个跨月聊天线程，却常因加载缓慢放弃回顾；
✅ 经常在多个 Git 仓库间切换，本地 worktree 堆积到难以管理；
✅ 同时运行 Webpack/Vite/Next.js 等多套 dev server，终端窗口常年满屏滚动；
✅ 担心手动清理误删关键上下文，又不愿忍受越来越卡的 Codex；
✅ 渴望一种“运维感低、安全感高、掌控感强”的日常维护体验——不是修电脑，而是养环境。
快速上手
安装极简：直接向 Codex 发送指令：Install the keep-codex-fast skill from https://github.com/vibeforge1111/keep-codex-fast
或手动将仓库克隆后，把 keep-codex-fast 文件夹复制到你的 Codex 技能目录（通常为 ~/.codex/skills/）。安装完成后，只需一句：Use $keep-codex-fast
即可启动交互式状态分析。首次运行会生成可视化报告，后续可随时调用 $keep-codex-fast archive --dry-run 预览归档效果，确认无误后再加 --apply 执行。
项目信息
A backup-first Codex skill for keeping local Codex state fast, clean, and recoverable.
编程语言：Python｜GitHub Star 数：528｜开源协议：MIT｜GitHub 项目地址
这是一款真正理解开发者心理的工具——它不鼓吹“一键清理”，而是尊重你每一段对话、每一个调试痕迹的价值；它把“维护”从焦虑任务，变成一次有节奏、可追溯、带反馈的协作过程。
