Nano Banana Pro 图像生成与编辑

要解决什么问题

在对话里描述画面或改图需求时，你往往还需要自己找 API 文档、拼参数、处理密钥，还要在「先出大图」和「反复改 prompt」之间做取舍。本技能把 Google Nano Banana Pro（Gemini 3 Pro Image） 封装成可在当前工作目录直接调用的生图/改图流程，输出固定为 PNG，并把分辨率与迭代习惯写进约定里。

技能如何工作

• 生图：把用户的画面描述传给 --prompt，用 generate_image.py 生成新图；默认不写分辨率时走 1K（约 1024px），也可映射到 2K / 4K。
• 改图：对已有文件使用 --input-image，--prompt 写编辑指令（加删元素、换风格、调色等）；迭代阶段应保持同一张输入图，直到满意再出终稿。
• 推荐工作流：先用 1K 草稿快速试错（每次换文件名、小步改 prompt），定稿后再用 4K 出最终图，避免在错误 prompt 上烧高分辨率配额。
• 密钥：脚本依次读取 --api-key 或环境变量 GEMINI_API_KEY；缺密钥会直接报错退出。
• 文件名：建议 yyyy-mm-dd-hh-mm-ss-描述.png，便于按时间线对照多次迭代。
• 完成方式：脚本打印保存路径即可；不要再把图片读回对话里。

用户表述模糊时，可按 SKILL 中的生成/编辑模板补全风格、构图、光照等字段；编辑场景强调「只改指定部分、其余保持不变」。

适用边界与注意点

• 必须在用户当前工作目录执行脚本（用绝对路径调用），图片才会落在用户正在工作的位置，而不是技能目录里。
• 依赖本机已安装 uv；改图前需确认 --input-image 路径真实可读。
• 出现 quota、403 等 API 错误时，多半是密钥、权限或配额问题，需换密钥或账号排查。