AgriciDaniel/banana-claude

Banana Claude – 用於 Google Gemini 圖像生成的 Claude 側外掛

是什麼 – 一個 Claude Code 外掛，讓您輸入自然語言請求，系統會規劃、審查，並在明確批准後，呼叫 Google 的 Gemini 圖像模型（Nano Banana 2 Lite / 2 / Pro）來產生圖片。在發送任何付費請求前，外掛會向您顯示完整的提示、模型選擇、資料設定與成本估算。

如何運作

1. 請求 – 您輸入簡單描述，例如 /banana-claude:banana generate an urban 16:9 GitHub hero with clean left‑side copy space。
2. 規劃 – 外掛建立「視覺簡報」，選擇 Gemini 模型，並準備成本估算。
3. 審查 – 您將看到確切的提示、參考圖像、隱私標記與預計費用。
4. 批准 – 一次性的批准權杖授權對 Gemini API 的單一請求。
5. 產生 – 圖像被產生；一個注重隱私的元資料側車檔案被保存下來。
6. 檢查 – 您可檢查結果，可選地進行編輯、重新產生或發布。

核心功能

• 產生 任何視覺資產（行銷圖形、產品場景、圖表、社群媒體圖像等）。
• 編輯 對產生的圖像進行單次變更，同時保留身份、幾何結構與品牌細節。
• 繼續 使用儲存的「Flash」或「Pro」會話，或將上一張圖像用作新參考。
• 比較 在單一有限組合中，對最多三個提示在三個模型路徑上進行比較。
• 審查 在批准前審查文案、裁切、構圖、偽影、權利與來源。
• 排版 當精確的文本位置至關重要時，可對本地新增的文案、字型與標誌進行排版。

內建安全與控制

• 由於圖像產生需付費，外掛預設處於 停用 狀態。
• API 金鑰永遠不會出現在指令、URL 或 CI 日誌中；它們保留在 Claude 的私人設定中。
• 每次付費呼叫都會顯示完整計畫，並需要使用者明確批准。
• 一次批准 = 一次提供者嘗試；更改計畫將強制要求新的批准。
• 成本記錄為私密，且預設不包含原始提示。
• 產生的圖像不會自動標記為生產就緒；使用者必須審查。

安裝（Claude Code）

/plugin marketplace add AgriciDaniel/banana-claude
/plugin install banana-claude@banana-claude-marketplace
/plugin enable banana-claude@banana-claude-marketplace
/reload-plugins

先決條件：Claude Code 2.1.199+，Python 3.11+，啟用計費的 Google AI 專案及 Gemini API 金鑰。

典型使用情境

• 需要快速為著陸頁或社群貼文產生英雄圖像的行銷團隊。
• 希望獲得 AI 產生的初稿並可編輯迭代的設計師。
• 在投入預算前希望並排比較不同視覺概念的內容創作者。
• 希望以可控、成本透明方式產生客製圖形的小型企業。

限制／注意事項

• 基底 Gemini 模型具有機率性；結果在拼字、幾何或政策合規性方面可能有所不同。
• 無法保證著作權清關或最終發票準確性——這些仍由使用者負責。
• 需要付費的 Google Gemini API 金鑰；外掛本身不提供免費額度。
• 外掛僅在 Claude Code 內部運作；不是獨立的 CLI 或 Web 應用程式。

文件與支援

• 使用者指南、提示撰寫技巧、MCP 工具參考、安全注意事項、變更日誌與升級指南均在倉儲中（docs/, skills/banana/）。
• 貢獻可透過常規的拉取請求流程進行；提交問題時請勿暴露金鑰或私人媒體。

授權 – MIT（見 LICENSE）。

---

由 Agrici Daniel 開發，AI 工作流程架構師 – 請參閱他的部落格、AI 营銷中心與 YouTube 頻道以取得更多背景資訊。