Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

feat(docs): 在 AGENTS.md 中集成为 Nano Banana 工具并更新配置说明

hugohe30503d9bbcb4f
diff --git a/AGENTS.md b/AGENTS.md
index ad24ecdf..a4409ab0 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -186,23 +186,33 @@ cp templates/layouts/<模板名>/*.jpeg <项目路径>/images/ 2>/dev/null || tr
- 保存到 `<项目路径>/images/image_prompts.md`
- 格式:主体描述 + 风格指令 + 色彩指令 + 构图指令 + 负面提示词 + Alt Text
-4. **生成图片**(三种方式):
+4. **生成图片**(四种方式):
- **方式一:直接生成**(如支持 generate_image 工具)
- - 使用 `generate_image` 工具生成图片
+ **方式一:命令行工具** ⭐ 推荐
+ - 使用 `nano_banana_gen.py` 调用 Gemini API 生成图片
+ - 支持 4K 分辨率、自定义宽高比、负面提示词
+ - 需先配置环境变量 `GEMINI_API_KEY`
+ // turbo
+ ```bash
+ python3 tools/nano_banana_gen.py "现代科技感背景" --aspect_ratio 16:9 --image_size 4K -o <项目路径>/images
+ ```
+ - 详细用法参见 `tools/README.md` 和 `roles/Image_Generator.md`
- **方式二:用户自行生成**
- - 告知用户提示词文件位置
- - 推荐平台:Gemini、Midjourney、DALL-E 3、Stable Diffusion
+ **方式二:直接生成**(如支持 generate_image 工具)
+ - 使用 `generate_image` 工具生成图片
- **方式三:Gemini 生成**(推荐高分辨率)
- - 下载 Full Size 版本
+ **方式三:Gemini 网页版**
+ - 在 [Gemini](https://gemini.google.com/) 中生成后选择 **Download full size** 下载
- 去除水印:
// turbo
```bash
python3 tools/gemini_watermark_remover.py <图片路径>
```
+ **方式四:手动生成**
+ - 告知用户提示词文件位置 `images/image_prompts.md`
+ - 推荐平台:Midjourney、DALL-E 3、Stable Diffusion
+
5. **验证图片就绪**:确认所有图片已保存到 `images/` 目录
6. **阶段检查点**:
diff --git a/tools/README.md b/tools/README.md
index d4911760..889d1665 100644
--- a/tools/README.md
+++ b/tools/README.md
@@ -1208,18 +1208,19 @@ python3 tools/nano_banana_gen.py "Beautiful landscape" -n "low quality, blurry,
| `--image_size` | - | `4K` | `1K`, `2K`, `4K` |
| `--output` | `-o` | 当前工作目录 | 图片保存目录 |
-**配置**:
+**环境变量配置**:
-首次使用建议配置 `tools/nano_banana_config.json`:
+使用前需设置环境变量:
-```json
-{
- "api_key": "YOUR_GEMINI_API_KEY",
- "base_url": "YOUR_API_BASE_URL"
-}
+```bash
+# 必需:Gemini API Key
+export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"
+
+# 可选:自定义 API 端点(用于代理服务)
+export GEMINI_BASE_URL="YOUR_API_BASE_URL"
```
-或者设置环境变量 `GEMINI_API_KEY`。
+> 💡 **提示**: 可将环境变量添加到 `~/.zshrc` 或 `~/.bashrc` 中永久生效。
**依赖**: