用途:生成透明背景的位图素材,例如 PNG 贴纸、图标、吉祥物、网页装饰、App 引导插画、电商社媒贴纸、游戏单帧 sprite 等。核心思路是先让 Codex 生图得到“容易抠干净”的图,再用脚本做确定性清理;不要让模型直接画棋盘格透明背景,因为棋盘格会成为图像内容。适合输出透明 PNG、网页素材、单帧 sprite、角色物体素材;不适合多帧动画、spritesheet 和视频。
生图要点:使用简短强约束的提示词,让主体居中,用纯色背景(如 #FF00FF 或 #00FF00)便于后续色键去除,并明确主体不能使用接近背景的颜色;不加阴影、地面、场景、文字、标签、棋盘格、光晕、模糊或漂浮装饰粒子,主体需完整留在画布内。若主体本身含粉色或品红,换用 #00FF00、#00FFFF 等不出现在主体中的纯色。更多提示词与 QA 细节见 references/prompt-and-cleanup.md。
清理脚本: python "${CODEX_HOME:-$HOME/.codex}/skills/transparent-visual-assets/scripts/prepare_transparent_asset.py" --input /absolute/path/source.png --output /absolute/path/asset.png --background "#FF00FF" --threshold 24 --feather-threshold 48 --trim --padding 8 --report /absolute/path/report.json 参数:--background 指定要移除的纯色,不传时用四角颜色估算;--threshold 为颜色容差,残留调大,主体被吃掉则调小或换背景色重生图;--feather-threshold 可选,用于淡化抗锯齿边缘的背景色毛边;--trim 与 --padding 裁掉透明边缘并保留安全留白。脚本只做背景清理,不会补画、重绘、扩图或创造新素材。
验收:输出必须是带 alpha 通道的 .png,四角透明,主体边缘不缺块,主体外无阴影、地面、光晕、漂浮符号、文字或背景色残留,在深浅与棋盘格背景上都能读清。若清理后主体明显破损,应重新生图或换背景色,而非靠脚本硬修。