Codex Session Image Scrubber

用途

通过将嵌入式图像/base64 负载替换为小型占位符，清理体积过大的 Codex 会话日志，同时保留周围的对话、工具调用及纯文本内容不变。

当用户反馈某次 Codex 聊天/会话加载缓慢、体积臃肿，或其中包含已粘贴的截图/图像/base64 数据、希望从历史记录中移除时，请使用本工具。

工作流程

1. 确认目标会话线程（thread/session）。

   • 若用户提供 thread id，优先采用该 ID。
   • 若用户提供记忆中的关键词短语，则使用以下命令定位对应会话：rg -l "" ~/.codex/sessions ~/.codex/session_index.jsonl。
   • 在明确目标 JSONL 文件前，切勿编辑当前活跃文件。

2. 执行 scrubber 的试运行（dry-run）。

   node ~/.codex/skills/codex-session-image-scrubber/scripts/scrub-codex-session-images.mjs --thread-id

   或指定具体文件路径：

   node ~/.codex/skills/codex-session-image-scrubber/scripts/scrub-codex-session-images.mjs --file /path/to/rollout.jsonl

3. 若试运行结果符合预期，则写入清洗后的文件。

   node ~/.codex/skills/codex-session-image-scrubber/scripts/scrub-codex-session-images.mjs --thread-id--write

4. 写入完成后进行验证。

   • 使用 ls -lh 确认文件体积是否显著减小。
   • 确认 JSONL 仍可正常解析；脚本输出中应显示 parseErrors: 0。
   • 检查常见图像负载是否已被清除：

     rg -n "data:image|iVBORw0KGgo|/9j/4AAQ|UklGR"

     期望结果为退出码 1 且无任何输出。

5. 向用户说明清洗前后的文件大小、备份路径以及验证是否通过，并建议重新打开该会话线程，使 app-server 重新加载轻量化的文件。

安全准则

• 仅移除图像负载内容，不得删除提及图像的文本内容。
• 若存在 或 类文本标记，应予以保留；此类标记体积很小，有助于维持对话结构完整性。
• 备份文件必须存放在 ~/.codex/sessions 目录之外；脚本默认备份路径为 ~/.codex/session_backups。
• 若多个会话文件匹配同一 thread id，应立即中止并要求用户显式选择，禁止自动猜测。
• 若用户后续希望删除备份文件，须在执行删除操作前获得其明确确认。

脚本

确定性清洗脚本位于 scripts/scrub-codex-session-images.mjs。

常用参数选项：

• --thread-id：在 ~/.codex/sessions 下查找对应 rollout JSONL 文件。
• --file：清洗指定路径下的 JSONL 文件。
• --write：执行实际重写操作；不加此参数时脚本仅做试运行。
• --backup-dir：覆盖默认备份目录路径。
• --sessions-dir：覆盖 Codex 会话根目录路径。
• --min-bytes：可疑图像字段的最小字节数阈值，默认为 100000。