Nano Banana Pro 图像生成与编辑
本技能使用 Google 的 Nano Banana Pro API（Gemini 3 Pro Image）生成新图像或编辑已有图像。
用途
当用户要求生成、创建、编辑、修改、更改或调整图像时使用本技能。它既可以生成全新的图像，也可以对已有图像进行编辑。
主要能力
- 生成新图像：根据提示词描述生成图像。
- 编辑已有图像：通过 --input-image 参数传入输入图像，并在提示词中给出编辑指令，例如添加或移除元素、更改风格、调整颜色、模糊背景等。
- 分辨率选项：Gemini 3 Pro Image API 支持三种分辨率（必须使用大写 K）：1K（默认，约 1024px）、2K（约 2048px）、4K（约 4096px）。
- 文件名生成：按 yyyy-mm-dd-hh-mm-ss-name.png 模式生成文件名，时间戳为当前日期时间（24 小时制），名称为描述性小写文本并用连字符连接，通常保持 1-5 个词；若上下文不明确，则使用随机标识符（如 x9k2、a7b3）。
使用方式
使用绝对路径运行脚本（不要先 cd 到技能目录）：
生成新图像： uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "your image description" --filename "output-name.png" [--resolution 1K|2K|4K] [--api-key KEY]
编辑已有图像： uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "editing instructions" --filename "output-name.png" --input-image "path/to/input.png" [--resolution 1K|2K|4K] [--api-key KEY]
重要：始终从用户当前工作目录运行，以便图像保存在用户工作位置，而不是技能目录中。
分辨率映射
将用户请求映射到 API 参数：
- 未提及分辨率 → 1K
- “low resolution”、“1080”、“1080p”、“1K” → 1K
- “2K”、“2048”、“normal”、“medium resolution” → 2K
- “high resolution”、“high-res”、“hi-res”、“4K”、“ultra” → 4K
API 密钥
脚本按以下顺序检查 API 密钥：
- --api-key 参数（如果用户在聊天中提供了密钥则使用）
- GEMINI_API_KEY 环境变量 如果两者都不可用，脚本会以错误消息退出。
提示词处理
- 生成时：将用户的图像描述原样传给 --prompt，仅在明显不充分时才改写。
- 编辑时：在 --prompt 中传入编辑指令（例如“在天空中加一道彩虹”、“让它看起来像水彩画”）。
- 两种情况都保留用户的创作意图。
输出
- 将 PNG 保存到当前目录（如果文件名包含目录则保存到指定路径）。
- 脚本输出生成图像的完整路径。
- 不要读回图像，只需告知用户保存路径。
示例
生成新图像： uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "A serene Japanese garden with cherry blossoms" --filename "2025-11-23-14-23-05-japanese-garden.png" --resolution 4K
编辑已有图像： uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "make the sky more dramatic with storm clouds" --filename "2025-11-23-14-25-30-dramatic-sky.png" --input-image "original-photo.jpg" --resolution 2K
适用场景
适用于需要根据文字描述生成图像，或对已有图像进行风格、内容、颜色等方面编辑的场景。
限制
- 需要有效的 API 密钥（通过 --api-key 参数或 GEMINI_API_KEY 环境变量提供），否则脚本会报错退出。
- 分辨率仅支持 1K、2K、4K 三种，且必须使用大写 K。
- 关于收费、价格、平台支持范围等更多信息，资料中暂未提供。