前言¶
在对话里让模型「画一张图」或「改这张图」，常见做法是再开一套 Web UI 或单独写脚本调图像 API。流程割裂，分辨率、迭代和保存路径也容易和当前工作目录对不上。下面介绍 SkillHub 上的 banana（坐标 @user_68c7e960/banana）：把 Nano Banana Pro（Gemini 3 Pro Image） 的生成与编辑能力封装成 Agent 可读的 SKILL.md，由 Agent 按文档调用附带脚本完成出图。
这是什么¶
banana 是社区来源（community）的 design-media 类 Skill，当前 SkillHub 展示版本为 1.0.0，发布者为 user_68c7e960。官方简介概括为：用 Nano Banana Pro 生成或编辑图像，覆盖创建与修改类请求；支持 文生图 与 图生图/编辑，输出分辨率 1K / 2K / 4K，编辑场景通过 --input-image 传入原图。页面标签标明 requires_api_key=true，使用前需准备 Gemini API 密钥。
SkillHub 页面：https://www.skillhub.cn/skills/user_68c7e960/banana
API 资源地址：https://api.skillhub.cn/user_68c7e960/banana
（截至资料抓取时，SkillHub 显示评分约 100000，下载 2855，安装 28。）
核心功能¶
已核实能力如下，均来自官方包内 SKILL.md 与 scripts/generate_image.py：
- 文生图：
--prompt描述画面，--filename指定输出 PNG 路径。 - 图像编辑：在生成参数基础上增加
--input-image，用自然语言写编辑指令（改天空、去人物、换风格等）。 - 分辨率：
--resolution取1K（默认）、2K、4K；文档要求使用大写K。 - 密钥：优先
--api-key，否则读取环境变量GEMINI_API_KEY；二者都没有时脚本会报错退出。 - 运行方式：通过
uv run执行 Python 脚本（脚本声明依赖google-genai、pillow，Python ≥ 3.10）。 - 工作目录：文档强调在用户当前工作目录下执行命令，不要把工作目录切到 Skill 安装目录，以便图片落在用户正在处理的项目路径下。
Skill 内还建议 草稿 1K 迭代 → 定稿 4K 的流程，以及按时间戳命名输出文件（yyyy-mm-dd-hh-mm-ss-描述.png），减少无效的高分辨率调用。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行（完整安装示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 banana¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别：
skillhub install @user_68c7e960/banana --dir <你的 Agent skills 目录>
常见路径（来自 SkillHub 安装说明）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
经 skillhub install 安装后，技能会落在类似 @user_68c7e960/banana 的子目录下（与坐标一致）。下文以 Cursor 为例，脚本绝对路径为：
~/.cursor/skills/@user_68c7e960/banana/scripts/generate_image.py
其他 Agent 请将前缀换成上表对应目录。安装或更新 Skill 后，按你所用客户端说明重启或刷新 Agent，使其加载新 Skill。
API 密钥¶
export GEMINI_API_KEY="你的密钥"
也可在单次调用中传入 --api-key（适合在对话里临时提供密钥的场景）。
前置检查¶
文档建议执行前确认：
command -v uv
test -n "$GEMINI_API_KEY"
编辑模式时还需确认 --input-image 指向的文件存在且可读。
典型用法¶
以下命令均应在用户当前工作目录执行，路径按你的实际 skills 安装位置替换。
文生图（默认 1K）：
uv run ~/.cursor/skills/@user_68c7e960/banana/scripts/generate_image.py \
--prompt "A serene Japanese garden with cherry blossoms" \
--filename "2025-11-23-14-23-05-japanese-garden.png"
指定 4K 分辨率：
uv run ~/.cursor/skills/@user_68c7e960/banana/scripts/generate_image.py \
--prompt "sunset over mountains" \
--filename "2025-11-23-15-30-12-sunset-mountains.png" \
--resolution 4K
编辑已有图片：
uv run ~/.cursor/skills/@user_68c7e960/banana/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
脚本成功后会输出保存路径；Skill 文档说明 Agent 不必再把图片读回对话，向用户告知路径即可。
在 Cursor 等环境中，也可直接让 Agent「根据 SkillHub 安装说明安装 @user_68c7e960/banana」，由 Agent 读取 SKILL.md 后按上述方式调用脚本。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的客户端，希望在同一对话里完成「描述 → 出图 → 改图」的开发者或设计师。
- 需要可控分辨率（1K 试稿、4K 定稿）且希望输出落在当前项目目录的场景。
限制与注意
- 必须自备 API Key，并承担 Gemini / Nano Banana Pro 的配额与费用；403、配额类错误需自行核对密钥与账户权限。
- 依赖本机
uv与网络访问 Google GenAI API；沙箱或离线环境需提前放行。 SKILL.md内示例路径写为~/.codex/skills/nano-banana-pro/...，与 SkillHub 安装后的@user_68c7e960/banana目录名不一致；实际使用时应改为本机skillhub install产生的路径，避免找不到脚本。- 输出为 PNG；编辑时应用英文或中文清晰的「只改什么、保留什么」指令，文档提供了生成与编辑的提示词模板，可减少跑偏。
结尾¶
banana 把 Gemini 3 Pro Image（Nano Banana Pro）的生成与编辑收敛成一条可复现的 CLI 工作流，并写进标准 Skill 格式，方便 Agent 在 design-media 类任务里直接执行。若你要在本地 Agent 中启用，可从 SkillHub 页面查看说明并安装：https://www.skillhub.cn/skills/user_68c7e960/banana。
