用途：借助 Codex（OpenAI 编码代理）内置图像工具，在终端为视频生成缩略图、短视频封面、方形贴文图以及 B-roll 或标注用静帧。每张图对应一次 codex exec，可同时跑多个，消耗 ChatGPT Plus/Pro 套餐额度，不需要 API key。
准备：先确认 codex --version 与 codex login status。未安装可 npm i -g @openai/codex（需 Node 20+），macOS 也可 brew install codex；未登录则由用户自行运行 codex login，通过浏览器“Sign in with ChatGPT”，不要在对话中索要 OpenAI 密钥或密码。
用法：一张图一个提示词，不要合并多个想法。先补齐缺失信息：用途与尺寸（缩略图 1280x720 16:9、竖版封面 1080x1920 9:16、方形 1:1、或视频格式的静帧）、数量（默认 1，缩略图可 3 个不同方案）、人物照片（1 至 3 张清晰照片，可用 ffmpeg 从视频抽帧，传绝对路径）。提示词用英文写具体：主体、构图、背景、光线、颜色、图上文字（最多 3 个词，用引号原样写出，与视频语言一致）和格式。缩略图要求单一主体、大字可读、强对比、清晰情绪的脸，右下角留空。列出编号提示词并等用户确认后再生成。
生成：每个提示词一个任务，最多同时 3 个，后台运行，命令末尾必须加 < /dev/null，否则 codex exec 会一直等待输入；用 --output-last-message 保存最后消息。任务约 1 至 3 分钟，结束后读取 .txt 中的 IMAGE_PATH 并复制图片。若没有 IMAGE_PATH，可查看 ~/.codex/generated_images/ 下任务开始后新建的文件；仍无则任务失败，查看 .log 末尾（常见为额度限制或需登录）后重跑一次。
检查与交付：每提示词一张图且互不相同（可用 shasum 比对）；用 sips 或 ffprobe 检查尺寸，缩略图需 16:9，可用 ffmpeg 裁剪缩放为 1280x720，JPG 小于 2 MB；逐张检查文字拼写、人脸相似度和异常细节，有问题改提示词重跑。写 manifest.json 记录文件、提示词、参考图和日期。缩略图或封面可交给 /publish 使用，视频静帧可交给 /short-editing 作为标注图。完成后删除 logs 目录。
限制：图像工具属于 OpenAI 且会变化，结果依赖它；图上文字可能拼错，必须检查；参考照片生成的人脸接近但很少完美，真实照片最稳妥；每张图计入 ChatGPT 套餐的 Codex 额度，达到上限需等待或升级套餐；只能使用已同意者的照片，不得使用不拥有的标志或角色。