前言¶
在對話裏讓模型「畫一張圖」或「改這張圖」，常見做法是再開一套 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。
