用途：从文本提示词生成视觉素材，调用 Openrouter API 的图像生成模型，并把结果图片保存到本地。使用前应确认是否已有合适素材、能否通过搜索找到免费图片，以及图片是否真的必要，因为生成既花钱又耗时；按需生成，不要批量生成“测试变体”，验证概念一张即可。
模式：test 模式使用 sourceful/riverflow-v2-fast，适合迭代、测试布局、检查构图与审阅概念，质量足以验证布局但不适合最终交付；production 模式使用 google/gemini-3.1-flash-image-preview，适合发布或交付的最终图片。默认模式为 test，仅在用户确认布局与构图后生成最终交付图时切换到 production。
使用方式：单图生成执行 python3 skills/image-generator/scripts/generate.py --prompt "..." --output "..." --mode test。带参考图（如 logo、吉祥物、品牌素材）时加 --reference 指向本地图片，支持 PNG、JPEG、WEBP、GIF。批量生成使用 --batch 指向 JSON 文件，--mode production；JSON 为数组，每项含 prompt 与 output，可选的 reference 字段。
提示词建议：明确构图、光线、风格与氛围；必要时指定宽高比或方向；摄影风格可加“hyper realistic, 4K quality”；加“clean composition”避免画面杂乱；避免要求图片中出现文字。
成本提示：production 约 R$0.07-0.10/张，test 约 R$0.01-0.02/张，8 张轮播图 production 模式约 R$0.60-0.80；先用 test 模式，仅对确认的概念用 production 重生成。
错误处理：未设置 OPENROUTER_API_KEY 时脚本报错退出，需在 .env 或环境变量中配置；API 返回错误时打印错误码与响应体并以代码 1 退出；响应中无图片时报告所用模型并以代码 1 退出；批量模式下部分失败会给出成功数量汇总。