jww-codex-maintenance

维护 Codex 本地状态

Xcode 可用性

此技能在 Xcode 中不可用。其操作流程依赖 Codex Desktop 或 CLI 本地状态，以及受支持的 Codex 任务管理操作，而 Xcode 不提供这些功能。仅在 Codex 运行环境中使用此技能。

将诊断与清理分开。大量本地状态可能与应用运行缓慢有关，但不要将文件大小视为原因的证据，也不要承诺能提升速度。

切勿

• 通过移动会话 JSONL 文件或编辑本地状态数据库来模拟归档。
• 除非用户明确请求修复，且有官方操作流程支持，否则不要清理、重建、编辑或替换 Codex 数据库。
• 不要终止后台进程、语言服务器或开发服务器。报告这些进程，由用户决定如何处理。
• 未经明确批准，不要将对话记录、日志、记忆、配置、数据库或凭据复制到代码仓库、共享文件夹或云同步位置。
• 不要定时修改正在使用的 Codex 文件。

选择模式

默认使用审计。仅在用户明确请求时切换模式：用户说“清理”“轮换”“归档”或“删除”时，使用执行；用户说“安排”或“定期报告”时，使用自动化。将“让 Codex 更快”视为审计请求，而非修改状态的许可。

• 审计：检查并报告，不更改任务、文件、配置、进程或计划任务。
• 执行：阅读 references/apply.md，确认具体目标，并且只执行用户请求授权的清理。如果用户授权了某一类别，却未明确该类别中具体要处理的目标，则先列出这些目标并征求批准，再进行更改。
• 自动化：创建定期运行的只读审计并生成报告。 安排任务前，请阅读 references/automation.md。

如果请求含糊不清，完成审计后停止，并提出建议的清理范围。

清点当前状态

1. 如果环境中设置了 CODEX_HOME，则使用该值；否则使用 ~/.codex。不要在 Shell 命令中重新定义 HOME、CODEX_HOME 或其他常用系统变量。
2. 确定桌面应用、Codex CLI、计划运行或其他 Codex 进程是否处于活动状态。报告这些进程；不要自动停止它们。
3. 记录以下项目的大小、文件数、最早和最新修改时间，以及最大文件：
   • 活动会话和已归档会话的对话记录
   • Codex 和桌面应用日志
   • 应用管理的工作树和 Git 工作树
   • 配置和配置档文件
   • 本地数据库及其 -wal 和 -shm 辅助文件
   • 记忆、技能、插件和计划任务元数据（如存在）
4. 如果主机支持任务操作，则使用这些操作列出任务状态、置顶状态、时长和项目关联信息。不要通过改写索引或查询未公开的数据库架构来推断置顶状态或任务状态。
5. 检查占用资源较多的开发进程，尤其是长时间运行的语言服务器和开发服务器；报告其命令、工作目录、运行时长和内存使用量，不要终止它们。

在 macOS 上，将 ~/Library/Logs/com.openai.codex/YYYY/MM/DD 纳入检查范围。Codex 会话对话记录通常位于 $CODEX_HOME/sessions，已归档的对话记录位于 $CODEX_HOME/archived_sessions，CLI 日志位于 $CODEX_HOME/log。应从正在运行的安装中查找其他位置，不要假定其使用未公开的目录结构。

对候选项进行分类

对每项进行分类并说明依据：

• **任务归档：**较旧、未固定且不活跃的任务，没有正在运行的工作。将 7–10 天之类的时间阈值视为用户偏好，而非通用规则。
• **大型活跃任务：**记录异常庞大的任务，可能适合交接并新建任务。仅凭规模不足以判定其可安全归档。
• **计划运行工作树：**较旧、未固定的运行记录，其任务可通过应用归档。频繁运行的计划任务可能会有意创建许多工作树。
• **仓库工作树：**干净、未使用且关联已完成的工作。在建议移除前，先确认其分支和仓库归属。
• **可轮换日志：**较旧或过大的日志，且当前没有写入。
• **失效的配置路径：**已配置但不存在的项目路径。区分暂时不可用的卷与确实已废弃的路径。
• **路径别名：**两种写法解析到同一位置。在 Windows 上，以规范化方式比较常规路径和扩展长度路径，但不要仅为统一显示文本而改写应用状态。

清理时排除已固定的任务、正在运行或以其他方式处于活跃状态的工作、存在未提交更改的工作树、当前日志以及不确定的路径。如果宿主无法提供其中某项状态的信息，应将目标归类为不确定，而不是推断其可安全处理。

验证并报告

重新执行清点并与基线进行比较。根据情况验证：

• 配置仍可解析
• 数据库可只读打开，且通过非变更性完整性检查
• 预期的任务或计划运行已归档，且已固定的任务未发生变化
• 活跃会话占用的字节数仅减少了预期的归档量
• 已归档会话的字节数和数量变化一致
• 仍由 Git 注册的工作树依然存在，且没有移除任何存在未提交更改的工作树
• 仍在使用的日志目录依然存在，且重新启动后可以创建新日志
• 路径别名和失效路径问题已解决，且未对配置进行无关更改

请用户重新启动桌面应用，并确认侧边栏、活跃任务、计划任务以及正常启动均无异常。将测得的磁盘空间变化与主观感受到的性能变化分开报告；切勿将传闻中的“快 10 倍”说法重复为预期结果。

最终报告必须包含模式、基线、候选项集合、排除项、确切更改、验证结果以及剩余风险。在 Apply 模式下，还必须说明备份位置、恢复说明，以及用户选择的备份保留或审核决定；不得擅自删除备份。