threejs-image-generator

用途：为 Three.js 游戏准备 2D 图像层，包括概念图、纹理、贴花、UI 美术，以及供 threejs-3d-generator 做图像到 3D 的源图。适用场景：图像到 3D 参考（角色、生物、建筑、载具、武器、道具、地形模块）；纹理与材质参考；环境背景板（天空、远景、菜单背景、视差层）；UI 美术（Logo、阵营标记、图标、面板）；对已有图像做风格变体、清理与调色。\n\n用法：脚本读取 --api-key 或 GEMINI_API_KEY，密钥不得写入技能文件、游戏代码或报告。可用 uv run <this-skill-dir>/scripts/generate_image.py probe 检查密钥是否设置（输出 GEMINI_API_KEY=SET|MISSING）；若 shell profile 中定义而进程环境缺失，可改用 threejs-game-director/scripts/probe_asset_credentials.sh。生成时在游戏项目中运行，例如 uv run <this-skill-dir>/scripts/generate_image.py --prompt "描述" --filename assets/concepts/output.png --resolution 2K；编辑已有图可加 --input-image。分辨率：1K 用于快速概念与图标，2K 为默认用于生产参考与纹理，4K 用于主视觉与大型天空板。\n\n限制与建议：该 API 仅作工具步骤，不应从游戏代码调用；输出建议概念与图像到 3D 源放 assets/concepts/，纹理与 UI 放对应目录；转换格式需有意为之（含 alpha 用 PNG，大型不透明纹理可用 JPG/WebP/KTX2）。生成后应先检查图像再投入后续步骤；遇到凭据缺失或额度耗尽可用诚实的本地替代方案，但瞬时错误不可；不要盲目重试不确定的付费生成，本命令无 Tripo 式任务恢复接口。资料未提供价格与具体收费信息。