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

docs(readme): fold Windows setup block and polish remaining wording

hugohe307d7ff51e6eb
diff --git a/README.md b/README.md
index fa9326bd..3cbd655d 100644
--- a/README.md
+++ b/README.md
@@ -85,7 +85,7 @@ English | [中文](./README_CN.md)
</table>
<p align="center">
- <sub>All examples above were generated in a single pass, with no manual polish (Claude Opus 4.7 + <code>gpt-image-2</code>). Downloading any .pptx and opening it in PowerPoint is the fastest way to feel the capability ceiling.<br/><a href="https://hugohe3.github.io/ppt-master/">Flip through all examples online →</a> · <a href="./examples/"><code>examples/</code> directory</a> · <a href="./docs/why-ppt-master.md">Why PPT Master?</a></sub>
+ <sub>All examples above were generated in a single pass, with no manual polish (Claude Opus 4.7 + <code>gpt-image-2</code>). Downloading any .pptx and opening it in PowerPoint is the fastest way to see what it can really do.<br/><a href="https://hugohe3.github.io/ppt-master/">Flip through all examples online →</a> · <a href="./examples/"><code>examples/</code> directory</a> · <a href="./docs/why-ppt-master.md">Why PPT Master?</a></sub>
</p>
---
@@ -133,8 +133,8 @@ Knowing how to use Python and AI agents will matter more and more, and this proj
**All you need to install is [Python](https://www.python.org/downloads/) 3.10+.** Everything else comes with one line — `pip install -r requirements.txt` — after you download the project in Step 3.
-<details open>
-<summary><strong>Windows</strong> — see the dedicated step-by-step guide ⚠️</summary>
+<details>
+<summary><strong>Windows</strong> — see the dedicated <a href="./docs/windows-installation.md">step-by-step guide</a> ⚠️</summary>
Windows requires a few extra steps (PATH setup, execution policy, etc.). We wrote a **step-by-step guide** specifically for Windows users:
@@ -253,13 +253,11 @@ The AI handles everything — content analysis, visual design, SVG generation, a
> **Already have a `.pptx` you want to reuse?** Hand the AI that deck plus your material and ask it to "fill this deck with the new content" — it fills text, table, and chart data into your existing design and exports only the pages you pick, staying natively editable. See the [FAQ](./docs/faq.md) and [template-fill workflow](./skills/ppt-master/workflows/template-fill-pptx.md).
-> **AI lost context?** Ask it to read `skills/ppt-master/SKILL.md`.
-
-> **Something went wrong?** Check the **[FAQ](./docs/faq.md)** — it covers model selection, layout issues, export problems, and more. Continuously updated from real user reports.
+> **Something went wrong?** If the AI loses context, ask it to read `skills/ppt-master/SKILL.md`; for everything else, check the **[FAQ](./docs/faq.md)** — it covers model selection, layout issues, export problems, and more. Continuously updated from real user reports.
### 5. Image Acquisition (Optional)
-Two paths for non-user images, mixable per row in the same deck:
+Two 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.
diff --git a/README_CN.md b/README_CN.md
index ba2de022..7008ebe7 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -85,7 +85,7 @@
</table>
<p align="center">
- <sub>以上示例均为一次性生成、未经精修(生成模型:Claude Opus 4.7 + <code>gpt-image-2</code>)。下载任意一份 .pptx 在 PowerPoint 里打开,是感受能力边界最快的方式。<br/><a href="https://hugohe3.github.io/ppt-master/">在线翻看全部示例 →</a> · <a href="./examples/"><code>examples/</code> 目录</a> · <a href="./docs/zh/why-ppt-master.md">为什么选 PPT Master?</a></sub>
+ <sub>以上示例均为一次性生成、未经精修(生成模型:Claude Opus 4.7 + <code>gpt-image-2</code>)。下载任意一份 .pptx 在 PowerPoint 里打开,是感受真实产出水平最快的方式。<br/><a href="https://hugohe3.github.io/ppt-master/">在线翻看全部示例 →</a> · <a href="./examples/"><code>examples/</code> 目录</a> · <a href="./docs/zh/why-ppt-master.md">为什么选 PPT Master?</a></sub>
</p>
<p align="center">
@@ -137,8 +137,8 @@
**只需安装 [Python](https://www.python.org/downloads/) 3.10+。** 其余依赖在第 3 步下载好项目后,用一行 `pip install -r requirements.txt` 装齐。
-<details open>
-<summary><strong>Windows</strong> — 请看专门的手把手安装指南 ⚠️</summary>
+<details>
+<summary><strong>Windows</strong> — 请看专门的<a href="./docs/zh/windows-installation.md">手把手安装指南</a> ⚠️</summary>
Windows 需要一些额外步骤(PATH 设置、执行策略等)。我们为 Windows 用户写了一份**手把手安装指南**:
@@ -261,13 +261,11 @@ AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。
> **已有一份想复用的 `.pptx`?** 把那份 deck 连同素材给 AI,说「套模板」即可——它会把新内容(文字、表格、图表数据)填进你现有的设计,只导出你挑选的页面,且保持原生可编辑。详见 [常见问题](./docs/zh/faq.md) 与 [套模板工作流](./skills/ppt-master/workflows/template-fill-pptx.md)。
-> **AI 迷失上下文?** 让它先读 `skills/ppt-master/SKILL.md`。
-
-> **遇到问题?** 查看 **[常见问题](./docs/zh/faq.md)** — 涵盖模型选择、排版问题、导出异常等,基于真实用户反馈持续更新。
+> **遇到问题?** AI 迷失上下文时,让它先读 `skills/ppt-master/SKILL.md`;其他问题查看 **[常见问题](./docs/zh/faq.md)** — 涵盖模型选择、排版问题、导出异常等,基于真实用户反馈持续更新。
### 5. 图片获取(可选)
-非用户自带图片有两条路径,可在同一份 deck 里按行混用:
+非用户自带图片有两条路径,可在同一份 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` 目前综合质量最佳。