Codex 越用越占空间？我写了个先盘点、再清理的 Skill

想清理 Codex，打开目录却只看到一堆文件夹和长文件名。哪段聊天占得最多？它对应哪个项目？备份和缓存能不能动？

这些问题没弄清楚，删除按钮很难按下去。

我写了一个 codex-storage-cleanup，把盘点目录、查聊天占用、确认清理范围这几步整理成了 Skill，并配了一个 Python 扫描器。

项目地址（评论一层），MIT 开源。

它的使用顺序很明确。先看报告，选出要处理的对象，核对影响后再确认。扫描脚本本身没有删除模式。

打开报告，你先能看到 Codex 目录的总文件大小和主要目录占用，再往下看占用最大的聊天。能找到的信息会一起列出，包括标题、项目或工作目录、完整会话 ID 和关联文件路径。

完整 ID 得保留。同名聊天、相近标题都可能让人选错对象，只看一个截断的名字，不够稳妥。脚本会尽量读取会话元数据，并把同一会话的多个日志文件归在一起；读不到的信息会标明，不硬猜。

临时文件、插件暂存和备份也会出现在候选清单里。候选意味着还需要检查用途，不能直接当成“全部可删”。

如果你已经按确认范围完成清理，还可以再扫一次，和先前保存的 JSON 报告比较，看看哪些目录变小了。这里统计的是文件逻辑大小，不能直接拿来承诺磁盘实际释放了多少空间。

安装可以交给 Codex。把下面这段发给它，让它先检查仓库，再安装 Skill。

请阅读并检查这个仓库中的 SKILL.md 和脚本
https://github.com/haojunsun/codex-storage-cleanup

将它安装到当前环境支持的用户级 Skills 目录。
保留 scripts、references 和 agents 的目录结构。
安装完成后告诉我如何调用，不要自动执行清理。

安装后，新开一个会话确认 Skill 已被识别。第一次使用，只做盘点就够了。

使用 $codex-storage-cleanup，只读扫描 Codex 目录。

列出总占用、主要目录、最大的 20 个聊天及清理候选。
保留完整会话 ID 和文件路径。
说明哪些信息已经核实，哪些还不能确定。

先不要删除、压缩或修改配置。

等报告出来，挑一个你确实不再需要的对象继续追问。把下面的占位文字替换成报告里的完整 ID。

只检查会话 ID 为「填入完整 ID」的这一项。

核对它的标题、项目和全部关联文件。
说明处理它会影响什么、哪些内容会保留。
暂不删除，等我确认具体范围。

习惯命令行的人也可以直接运行扫描器。需要 Python 3.10 或更新版本，在仓库根目录执行下面的命令即可生成 Markdown 报告。

macOS 通常把 python 换成 python3。如果 Codex 数据放在自定义位置，可以通过 --codex-home 指定。压缩日志需要环境中有可用的解码能力，读取失败时会保留未核实状态，不会为了扫描偷偷安装依赖。

有几件事值得在使用前分清。归档聊天后，底层文件可能仍然存在；压缩记录也不等于限制历史数量。项目源码、独立保存的图片和备份，需要分别确认范围，不能因为清理了聊天，就默认它们也处理完了。

这次发布前跑了隔离测试，7 项中 6 项通过。符号链接测试因为 Windows 权限限制跳过，macOS 还没有实机验证。仓库保留了测试脚本，方便继续验证和改进。

报告里可能带有聊天标题和本机路径。遇到问题提 Issue 时，先隐去这些信息，别把整份个人报告直接上传。

如果你也想整理 Codex 的占用，可以先装上跑一份只读报告。看清最大的几项之后，再决定哪些值得处理。