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 频道以获取更多背景信息。