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
docs(image-generation): document host-native image generation
hugohe3ba797b9d4029
diff --git a/README.md b/README.mdindex c843ec2a..b031d7ab 100644--- a/README.md+++ b/README.md@@ -338,7 +338,7 @@ Whatever you state explicitly is followed; whatever you leave unspecified the agTwo paths for non-user images, mixable per image in the same deck:-**A) AI generation** — `image_gen.py`. Set `IMAGE_BACKEND` plus the provider's `*_API_KEY` (`OPENAI_API_KEY`, `GEMINI_API_KEY`, etc.), and the pipeline calls it automatically. Run `python3 skills/ppt-master/scripts/image_gen.py --list-backends` for the full backend list. `gpt-image-2` is currently the best default.+**A) AI generation** — use the agent host's native image tool when available, or `image_gen.py` with `IMAGE_BACKEND` plus the provider's `*_API_KEY`. Host-native generation needs no separate provider image API key; ask the agent to use its own image tool. Run `python3 skills/ppt-master/scripts/image_gen.py --list-backends` for the configured-provider path. `gpt-image-2` is currently the best default.**B) Web image search** — `image_search.py`. **Zero-config works**; configure `PEXELS_API_KEY` / `PIXABAY_API_KEY` (both free) for consistently higher-quality results:diff --git a/README_CN.md b/README_CN.mdindex 9935d461..36382c5c 100644--- a/README_CN.md+++ b/README_CN.md@@ -347,7 +347,7 @@ AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。非用户自带图片有两条路径,可在同一份 deck 里按图混用:-**A) AI 生图** — `image_gen.py`。设置 `IMAGE_BACKEND` 和对应 `*_API_KEY`(`OPENAI_API_KEY`、`GEMINI_API_KEY` 等),流程会自动调用。`python3 skills/ppt-master/scripts/image_gen.py --list-backends` 查看完整后端清单。`gpt-image-2` 目前综合质量最佳。+**A) AI 生图** — Agent host 提供原生生图工具时可直接使用;也可通过 `image_gen.py` 配置 `IMAGE_BACKEND` 和供应商 `*_API_KEY`。host-native 生图不需要另配供应商生图 API Key,直接要求 Agent 使用自身生图工具即可。`python3 skills/ppt-master/scripts/image_gen.py --list-backends` 查看供应商后端清单。`gpt-image-2` 目前综合质量最佳。**B) 网络图片搜索** — `image_search.py`。**零配置**可用;建议配置 `PEXELS_API_KEY` / `PIXABAY_API_KEY`(都免费申请)以获得稳定的高质量结果:diff --git a/docs/faq.md b/docs/faq.mdindex 6f45af63..86fdd0a3 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -65,11 +65,11 @@ Neither path carries a `.git` directory, so `git describe` cannot report the ver## Q: Can I use AI-generated images in my presentation?-Yes. PPT Master includes a built-in image generation script that supports multiple providers (Gemini, OpenAI, FLUX, Qwen, Zhipu, etc.). During the Strategist phase, if you choose "AI generation" for the image approach, the pipeline will automatically generate images based on your content. You can also provide your own images — just place them in the project's `images/` folder.+Yes. When the agent host exposes a native image tool, PPT Master can use it without a separate provider image-generation API key. It can also use the built-in `image_gen.py` through a configured provider. Choose "AI generation" for the image approach; you can explicitly ask the agent to use its own image tool. You can also place your own images in the project's `images/` folder.## Q: I don't have an image-generation API key — can I still get images?-Yes — pick "Web-sourced" in the Strategist's Image Usage step. PPT Master ships a zero-config `image_search.py` that searches openly-licensed images across Openverse and Wikimedia Commons (no API key needed). Zero-config search is a fallback: it works immediately, but quality can be uneven because many results are ordinary user uploads.+Yes. If the agent host exposes native image generation, choose "AI generation" and ask it to use its own image tool; this needs no provider image API key. Otherwise, pick "Web-sourced" in the Strategist's Image Usage step. PPT Master ships a zero-config `image_search.py` that searches openly-licensed images across Openverse and Wikimedia Commons. Zero-config search is a fallback: it works immediately, but quality can be uneven because many results are ordinary user uploads.For better contemporary stock photography, set `PEXELS_API_KEY` and/or `PIXABAY_API_KEY` in `.env` (both are free). The search will include Pexels / Pixabay automatically, which usually improves people, workplace, lifestyle, product, and illustration images. You can mix paths in one deck (e.g. AI for hero illustrations, web for team photos). If a selected image requires attribution, Executor adds a small inline credit on the affected slide.diff --git a/docs/getting-started.md b/docs/getting-started.mdindex b4895590..87e27ceb 100644--- a/docs/getting-started.md+++ b/docs/getting-started.md@@ -159,7 +159,7 @@ The [FAQ](./faq.md) is the living troubleshooting reference — continuously upd| The AI drifts or forgets a step | Ask it to re-read `skills/ppt-master/SKILL.md`, `skills/ppt-master/workflows/routing.md`, and the selected route authority. || Visual quality disappoints | Switch to a large-context Claude model + `gpt-image-2` — the harness sets the floor, the model sets the ceiling. || Text overflows or elements overlap | Re-run that page, or fix it in live preview; see the [FAQ](./faq.md). |-| No image-generation API key | Zero-config web search still works as a fallback; see the [FAQ](./faq.md). |+| No image-generation API key | Use the host's native image tool when available; otherwise zero-config web search still works. See the [FAQ](./faq.md). || Animations or some effects look off in another app | Microsoft PowerPoint is the primary motion-validation target. Keynote / WPS / LibreOffice can open the `.pptx`, but may remap or omit individual effects or Start semantics; validate motion-critical delivery in PowerPoint. || A long deck might blow the context window | Generation can run in split mode; details in the [FAQ](./faq.md). |diff --git a/docs/zh/faq.md b/docs/zh/faq.mdindex 706dc80d..a05a274d 100644--- a/docs/zh/faq.md+++ b/docs/zh/faq.md@@ -67,11 +67,11 @@ python3 skills/ppt-master/scripts/update_repo.py## Q: 能用 AI 生成配图吗?-可以。PPT Master 内置了图片生成脚本,支持多个供应商(Gemini、OpenAI、FLUX、通义千问、智谱等)。在策略师阶段选择"AI 生图"方案后,流程会根据内容自动生成配图。你也可以使用自己的图片——只需放到项目的 `images/` 目录下即可。+可以。Agent host 提供原生生图工具时,PPT Master 可直接使用,不需要另配供应商生图 API Key;也可以通过内置 `image_gen.py` 使用已配置的供应商后端。图片方案选择"AI 生图"即可,也可明确要求 Agent 使用自身生图工具。你还可以把自己的图片放到项目的 `images/` 目录下。## Q: 没有生图 API Key,还能配图吗?-可以——在策略师的"图片方案"步骤选择"网络图片"。PPT Master 内置了零配置的 `image_search.py`,在 Openverse 和 Wikimedia Commons 中搜索可商用的开放许可图片(无需 API Key)。零配置搜索适合作为兜底:能直接用,但图片质量不稳定,容易出现普通用户上传、构图随意、清晰度一般的素材。+可以。Agent host 提供原生生图能力时,选择"AI 生图"并要求它使用自身生图工具,不需要供应商生图 API Key。否则可在策略师的"图片方案"步骤选择"网络图片";PPT Master 内置零配置的 `image_search.py`,在 Openverse 和 Wikimedia Commons 中搜索可商用的开放许可图片。零配置搜索适合作为兜底:能直接用,但图片质量不稳定,容易出现普通用户上传、构图随意、清晰度一般的素材。如果想要更现代的商业风照片,建议在 `.env` 里设置 `PEXELS_API_KEY` 和/或 `PIXABAY_API_KEY`(都是免费申请)。搜索会自动纳入 Pexels / Pixabay,人物、办公、生活方式、产品和插画类图片质量通常会明显更稳定。两种路径可以在同一份 deck 里混用(比如 hero 图用 AI 生成、团队照片用网络搜索);如果选中的图片需要署名,Executor 会在该幻灯片自动添加就地小字署名。diff --git a/docs/zh/getting-started.md b/docs/zh/getting-started.mdindex 4529abdd..24c16b5e 100644--- a/docs/zh/getting-started.md+++ b/docs/zh/getting-started.md@@ -158,7 +158,7 @@ PPT Master 最初是纯对话设计;可视化编辑是在很多用户提出后| AI 跑偏或漏了步骤 | 让它重新读 `skills/ppt-master/SKILL.md`、`skills/ppt-master/workflows/routing.md` 和已选路线的权威文档。 || 视觉质量不理想 | 换成大上下文 Claude 模型 + `gpt-image-2`——harness 决定下限,模型决定上限。 || 文字溢出或元素重叠 | 重跑那一页,或用实时预览修;详见 [FAQ](./faq.md)。 |-| 没有生图 API key | 零配置的网络图片搜索仍可作为兜底;见 [FAQ](./faq.md)。 |+| 没有生图 API key | Agent host 提供原生生图时直接使用,否则零配置网络图片搜索仍可用;见 [FAQ](./faq.md)。 || 动画或部分效果在别的软件里不对 | Microsoft PowerPoint 是动效行为的主要验证目标。Keynote / WPS / LibreOffice 可以打开 `.pptx`,但可能重新映射或省略个别效果或 Start 语义;动效关键交付应在 PowerPoint 中验证。 || 担心长 deck 撑爆上下文 | 生成可走分段模式;详见 [FAQ](./faq.md)。 |