技能介绍

问题

ChatGPT 桌面版中的 Codex 视图会在 ~/.codex、Windows %LOCALAPPDATA% 或 macOS ~/Library 等位置留下 runtime、日志、缓存、临时文件和旧日报线程。直接递归删除容易碰到 SQLite、会话、认证、skills/plugins、automations 等不应触碰的文件；手工审计又缺少统一边界。Codex Cleaner 面向这个 IT 运维场景，把“能看”和“能删”分开，先做只读审计与 dry-run，再让用户确认低风险写入。

核心能力

健康检查与环境检测：先确认宿主系统、安装路径、PowerShell 环境和 Codex runtime 区域，避免在不明确的路径上执行清理。
存储与边界审计：检查 .codex 总大小、已知大目录、Chat/Work/浏览器/应用包状态边界，以及用户 TEMP 中的 Codex 残留；这些新增边界只做只读审计，不进入文件删除候选。
Runtime 清理规划：默认使用 dry-run，针对 .codex/.tmp 等白名单候选生成计划；只有用户在 dry-run 后明确确认，才执行已验证的清理。
日报保留策略：只精确匹配 AI 应用端日报 与 GitHub 工具日报，读取最小 metadata，不读取正文、preview 或 rollout JSON；按超过 14 天归档、超过 30 天删除的规则规划，并跳过置顶、运行中、非日报或标题不明确线程。
自动更新检查：工作流结束后从官方 GitHub Release 检查更高版本；网络或校验失败只报告，不影响本次清理结果。

适用边界

它适合在 ChatGPT 桌面版关闭、由人工或外部 agent 运行目录时使用，默认输出“现在可做、需要确认、不要触碰”三组建议。不要把 V5 覆盖范围图或 runtime-integrity 结果理解为删除授权；App package state、SQLite/state、认证配置、完整 bin/runtimes 和第三方应用目录应保持只读或避免处理。路径不确定、脚本报错、候选项超出白名单、或目标路径属于 CC Switch / CodeX++ 等第三方应用时，应停止并先人工确认。

截图预览

使用场景

ChatGPT 桌面版中 Codex 的 .codex 目录持续增长，需要审计大小和大目录，找出可 dry-run 的临时残留。
Codex 视图积累了多份日报线程，需要只按标题白名单列出 metadata，规划 14 天归档和 30 天删除。
Windows 或 macOS 上怀疑 Codex runtime 留下临时文件，需要先健康检查，再生成 .tmp 清理计划。
外部 agent 执行前需要确认路径与边界，避免把 Chat、Work、浏览器或应用包状态纳入删除候选。

适合人员

维护 ChatGPT 桌面版工作流的 IT 运维，需要把 Codex 本地目录清理限制在可审计、需确认的 dry-run 范围内。
依赖 Codex 日报沉淀流程的知识工作者，需要按 14/30 天规则归档或删除白名单日报，同时跳过置顶线程。
运行 OpenCode、Hermes 或 Claude Code 的工程师，需要直接执行目录脚本做只读检查与低风险清理。
负责应用边界的 SRE，需要识别 Codex runtime、TEMP 残留和 Windows app package 状态，避免误删 SQLite 或认证文件。