Nano Banana Pro 图像生成与编辑
使用 Google 的 Nano Banana Pro API（Gemini 3 Pro Image）生成新图像或编辑现有图像。
用法
使用绝对路径运行脚本（不要先进入技能目录）：
生成新图像：
uv run ~/.codex/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 ~/.codex/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]
**重要提示：**务必从用户的当前工作目录运行，以便将图像保存在用户工作的位置，而不是技能目录中。
默认工作流程（草稿 → 迭代 → 最终稿）
目标：快速迭代，无需在 4K 分辨率下浪费时间，直到提示正确为止。
-
草稿（1K）：快速反馈循环
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<draft prompt>" --filename "yyyy-mm-dd-hh-mm-ss-draft.png" --resolution 1K
-
迭代：在小差异中调整提示；每次运行都使用新的文件名
- 如果需要编辑：每次迭代都保持不变，
--input-image直到满意为止。
- 如果需要编辑：每次迭代都保持不变，
-
最终版（4K）：仅当提示符锁定时
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<final prompt>" --filename "yyyy-mm-dd-hh-mm-ss-final.png" --resolution 4K
解决方案选项
Gemini 3 Pro 图像 API 支持三种分辨率（K 必须大写）：
-
1K（默认）- 约 1024 像素分辨率
-
2K - 约2048像素分辨率
-
4K - 约 4096 像素分辨率
将用户请求映射到 API 参数：
-
没有提及决议 →
1K -
“低分辨率”、“1080”、“1080p”、“1K” →
1K -
“2K”、“2048”、“正常”、“中等分辨率” →
2K -
“高分辨率”、“高分辨率”、“高分辨率”、“4K”、“超高分辨率” →
4K
API密钥
脚本按以下顺序检查 API 密钥：
-
--api-key参数（如果用户在聊天中提供了密钥，则使用此参数） -
GEMINI_API_KEY环境变量
如果两者都不可用，脚本将退出并显示错误消息。
飞行前检查 + 常见故障（快速修复）
-
飞行前准备：
-
command -v uv（必须存在） -
test -n \"$GEMINI_API_KEY\"（或通过--api-key） -
如果要编辑：
test -f \"path/to/input.png\"
-
-
常见故障：
-
Error: No API key provided.→ 设置GEMINI_API_KEY或传递--api-key -
Error loading input image:→ 路径错误/文件无法读取；请验证--input-image是否指向真实图像 -
“quota/permission/403”类型的API错误→密钥错误、无访问权限或超出配额；请尝试其他密钥/帐户
-
文件名生成
使用以下模式生成文件名：yyyy-mm-dd-hh-mm-ss-name.png
格式： {timestamp}-{descriptive-name}.png
-
时间戳：当前日期/时间
yyyy-mm-dd-hh-mm-ss（24 小时制格式） -
名称：描述性小写文本，带连字符
-
描述部分要简洁（通常为 1-5 个词）。
-
根据用户的提示或对话内容获取上下文信息
-
如果不清楚，请使用随机标识符（例如
x9k2，a7b3）。
例如：
-
提示“宁静的日式花园”→
2025-11-23-14-23-05-japanese-garden.png -
提示“群山日落”→
2025-11-23-15-30-12-sunset-mountains.png -
提示“创建一个机器人图像”→
2025-11-23-16-45-33-robot.png -
上下文不清晰 →
2025-11-23-17-12-48-x9k2.png
图像编辑
当用户想要修改现有图像时：
-
检查它们是否提供了图像路径或引用了当前目录中的图像。
-
使用
--input-image包含图像路径的参数 -
提示应包含编辑说明（例如，“让天空更具戏剧性”、“移除人物”、“改为卡通风格”）。
-
常见编辑任务：添加/删除元素、更改样式、调整颜色、模糊背景等。
及时处理
**生成图像时：**直接将用户提供的图像描述传递给生成器--prompt。只有在明显不足以生成图像时才进行修改。
**编辑说明：**请提供编辑指令--prompt（例如，“在天空中添加彩虹”、“使其看起来像水彩画”）。
无论哪种情况，都要保留用户的创作意图。
提示模板（高命中率）
当用户描述模糊不清或需要进行精确编辑时，请使用模板。
-
生成模板：
- “创建以下图像：<主题> 。风格：<风格> 。构图：<相机/拍摄>。光线：<光线> 。背景：<背景> 。调色板：<调色板> 。避免：<列表> 。”
-
编辑模板（保留其他所有内容）：
- “仅更改：<一项更改> 。保持以下元素不变：主体、构图/裁剪、姿势、光线、调色板、背景、文字和整体风格。请勿添加新对象。如果文字已存在，请保持不变。”
输出
-
将 PNG 文件保存到当前目录（如果文件名包含目录，则保存到指定路径）。
-
脚本输出生成图像的完整路径
-
不要读取图像内容，只需告知用户已保存的路径即可。
示例
生成新图像：
uv run ~/.codex/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 ~/.codex/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
下载zip，直接发送文件并与龙虾对话请帮我下载zip并unzip解压，帮我安装这个skills
链接：夸克网盘分享
提取码：XCvA