Agent Skills
返回列表
Codex 会话图片清理器

Codex 会话图片清理器

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_15292d5a/yjkj-codex-session-image-scrubber。

技能介绍

问题

Codex 会话日志常因粘贴截图、图片附件或大段 Base64 而膨胀，导致线程变重、检索和加载更慢。该技能面向这类 JSONL 会话文件，把过大的图片负载替换成小占位内容，同时保留对话、工具调用和文本结构。

工作方式

它会先确认目标线程，优先使用 thread id；如果只有关键词，就搜索 ~/.codex/sessions 和 ~/.codex/session_index.jsonl。随后对 scripts/scrub-codex-session-images.mjs 做干跑，检查替换范围；确认无误后再用 --write 重写文件。脚本会生成备份，默认位于 ~/.codex/session_backups，也可用 --backup-dir 指定。写入后会核对文件体积、JSONL 可解析性和图片负载是否已移除。

适用边界

它只处理图片负载，不应删除文本中提到图片的普通内容；若会话里已有小的结构标记，会尽量保留。遇到多个文件匹配同一 thread id 时应停止并人工选择，避免误改。该技能适合清理 Codex 会话历史，不替代会话管理、权限控制或通用日志分析。

使用场景

  • 排查粘贴截图导致变重的 Codex 线程，定位目标 JSONL 并干跑清理大图片负载。
  • 在共享 Codex 会话前，把会话 JSONL 中的 Base64 图片替换为占位符，保留工具调用和文本。
  • 清理 ~/.codex/sessions 下某线程历史，写入前先备份，并验证 JSONL 可解析、图片负载已消失。
  • 当多个文件匹配同一 thread id 时，避免误改，只选择明确目标并执行图片 payload 替换。

适合人员

  • 维护 Codex 会话历史的工程师，需要安全清理线程 JSONL 中的 Base64 截图。
  • 排查 Agent 运行日志的 SRE，需要定位并重写指定 session 文件，保留工具调用上下文。
  • 使用 Codex 粘贴大量截图的开发者，需要降低历史线程体积并保持对话可加载。
  • 编写会话工具链的 DevTools 维护者，需要把图片 payload 替换为占位符并生成备份校验。