用途：在 Codex 长期使用后（大量聊天、终端、日志、worktree 与项目历史）变慢时，安全地检查并减少本地状态负担，同时保留上下文与可恢复性。核心原则是“先做交接、归档而非删除、准备好再应用”，所有操作默认只读，只有显式使用 --apply 才会改动本地状态。
安装：将仓库克隆或复制到 Codex 技能目录，例如 cd ~/.codex/skills 后 git clone https://github.com/vibeforge1111/keep-codex-fast.git；也可让 Codex 直接安装该技能。
三种模式：Inspect（默认，仅报告、不写入、隐私安全）；Maintain（备份、归档旧会话、移动陈旧 worktree、轮转日志、清理失效配置）；Repair（可选，仅在 --repair-thread-metadata-bloat 标志下，备份后裁剪过大的 SQLite 标题/预览元数据）。
常用命令：python scripts/keep_codex_fast.py 生成基础检查报告；加 --details 查看线程 ID、标题与路径；--backup-only 仅创建备份；--apply 执行核心维护；可配合 --archive-older-than-days 与 --worktree-older-than-days 自定义保留期；--wait-for-codex-exit 等待 Codex 退出后再应用。备份文件夹含私有本地元数据，应留在本机、不要公开分享。
维护内容：非置顶且超过阈值（默认 7 天）的会话被归档，置顶会话不归档；陈旧 worktree 移入归档并更新配置引用；过大的 logs_2.sqlite* 轮转、旧日志压缩归档；清理失效/临时项目条目并规范化 Windows 扩展路径。线程元数据修复仅裁剪 state_5.sqlite 中过大的标题/预览字段，对话记录保持完整，并生成修复清单以便恢复。
使用建议：归档重要活跃聊天前，先让 Codex 生成交接文档（含仓库/分支、目标、已完成项、涉及文件、已运行命令与测试、已知错误、待决事项、约束与下一步），并附可粘贴到新会话的重新激活提示。若 Codex 正在运行，不要改动本地状态，先关闭或使用等待退出参数。脚本会报告重型 Node/开发进程但不会结束它们。
限制：仅面向本地 Codex 状态维护，不改变 Codex 本身功能；修复线程元数据属高级操作，仅在报告显示异常大的标题/预览元数据时使用；备份会占用磁盘，需自行清理旧备份；恢复需按备份内 restore-instructions.txt 或 restore-thread-metadata.py 操作。