Codex WebSocket 图片会话清理

场景分类

适用对象

经常在 Codex 中处理截图、图片生成、视觉 QA，且遇到旧线程反复重连的用户

解决什么问题

这个 skill 用于处理一种容易被误判成网络故障的问题：Codex 本地 session 的 rollout JSONL 文件因为内嵌 base64 图片、input_image 或 image_url 字段变得过大，导致线程加载慢、Reconnecting、stream disconnected、compact 失败或提示 Invalid image。它会先做只读报告，再在用户明确要求时备份原始 rollout，并用脚本清理图片 payload，保留文字历史和回滚路径。

完整使用场景

• 某个旧 Codex 线程反复显示 Reconnecting、stream disconnected 或 failed to send websocket request，但新线程基本正常时，用它先判断是不是单个 session 过大。
• 线程里做过大量截图、图片生成、图片编辑、视觉 QA 或反复 view_image，怀疑 rollout 文件被图片 payload 撑到几十 MB 甚至上百 MB 时，用它统计图片标记并生成清理报告。
• 需要修复旧线程但不能直接删历史时，用它按备份优先流程执行清理：定位 rollout、复制备份、写入 restore 脚本、改写图片 payload、校验 JSONL 和残留标记。
• 排查 Codex 重连问题时，用它把网络代理问题和本地会话膨胀问题分开：小新线程也重连再查网络，只有图片重的旧线程异常则优先处理 rollout。
• 清理后需要给非技术用户交代结果时，用它输出原始大小、新大小、节省空间、清理项目、备份目录和恢复方式。