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: update README and project descriptions for v2.3.0 native editable PPTX
hugohe3612321632cae
diff --git a/AGENTS.md b/AGENTS.mdindex b827967b..4ff8f2ea 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -4,7 +4,7 @@ This file serves as the project entry point for general AI agents. Before execut## Project Overview-PPT Master is an AI-driven multi-format SVG content generation system. Through multi-role collaboration (Strategist → Image_Generator → Executor → Optimizer), it converts source documents (PDF/DOCX/URL/Markdown) into high-quality SVG pages and exports them as PPTX.+PPT Master is an AI-driven presentation generation system. Through multi-role collaboration (Strategist → Image_Generator → Executor → Optimizer), it converts source documents (PDF/DOCX/URL/Markdown) into natively editable PPTX with real PowerPoint shapes (DrawingML).**Core Pipeline**: `Source Document → Create Project → Template Option → Strategist Eight Confirmations → [Image_Generator] → Executor → Post-processing → Export PPTX`diff --git a/CLAUDE.md b/CLAUDE.mdindex 8a513a1b..64d589cf 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -4,7 +4,7 @@ This file provides a project overview for Claude Code. Before executing PPT gene## Project Overview-PPT Master is an AI-driven multi-format SVG content generation system. Through multi-role collaboration (Strategist → Image_Generator → Executor → Optimizer), it converts source documents (PDF/DOCX/URL/Markdown) into high-quality SVG pages and exports them as PPTX.+PPT Master is an AI-driven presentation generation system. Through multi-role collaboration (Strategist → Image_Generator → Executor → Optimizer), it converts source documents (PDF/DOCX/URL/Markdown) into natively editable PPTX with real PowerPoint shapes (DrawingML).**Core Pipeline**: `Source Document → Create Project → Template Option → Strategist Eight Confirmations → [Image_Generator] → Executor → Post-processing → Export PPTX`diff --git a/README.md b/README.mdindex 467e3905..b68baf77 100644--- a/README.md+++ b/README.md@@ -1,14 +1,16 @@-# PPT Master — AI generates editable, beautifully designed presentations from any document+# PPT Master — AI generates natively editable PPTX from any document-[](https://github.com/hugohe3/ppt-master/releases)+[](https://github.com/hugohe3/ppt-master/releases)[](https://opensource.org/licenses/MIT)[](https://github.com/hugohe3/ppt-master/stargazers)English | [中文](./README_CN.md)-Drop in a PDF, DOCX, URL, or Markdown file — AI generates **beautifully designed presentations that you can edit directly in PowerPoint**. Supports PPT 16:9, social media cards, marketing posters, and 10+ other formats.+Drop in a PDF, DOCX, URL, or Markdown file — AI generates **natively editable PowerPoint presentations with real shapes**, not images. Every text box, chart, and graphic is a real PowerPoint object you can click and edit. Supports PPT 16:9, social media cards, marketing posters, and 10+ other formats.-> 💡 **Major Update**: The project architecture has undergone a massive upgrade (Skill-based architecture):+> 🔥 **NEW: Native Editable PPTX** — Generated presentations now contain **real PowerPoint shapes** (DrawingML) by default — text, charts, and graphics are directly editable in PowerPoint without any extra steps. No more "Convert to Shape"!+>+> 💡 **Architecture Update**: The project uses a Skill-based architecture:> 1. **Lower Token Consumption & Model Dependency**: Significantly reduced token consumption. Now, even non-Opus models can generate decent results.> 2. **High Extensibility**: The `skills` folder is organized according to the Agent Skills standard, with each subdirectory being a fully self-contained Skill. It can be natively invoked by dropping it into the skills directory of compatible AI clients (e.g., `.claude/skills/` or `~/.claude/skills/` for Claude Code; global skills directory referenced via `.agent/workflows/` for Antigravity; `.github/skills/` or `~/.copilot/skills/` for GitHub Copilot).> 3. **Stable Fallback**:Although the previous multi-platform architecture consumes more tokens, it has been more extensively tested. If you experience instability with the current version, you can always fall back to the last release of the old architecture: [v1.3.0](https://github.com/hugohe3/ppt-master/tree/v1.3.0).@@ -60,7 +62,7 @@ User Input (PDF/DOCX/URL/Markdown)↓[Post-processing] → total_md_split.py (split notes) → finalize_svg.py → svg_to_pptx.py↓-Output: Editable PPTX (auto-embeds speaker notes)+Output: Native editable PPTX with real shapes + SVG reference PPTX (auto-embeds speaker notes)↓[Optimizer_CRAP] (Optional, only if the first draft is unsatisfactory)↓@@ -162,7 +164,7 @@ AI: Sure. First we'll confirm whether to use a template; after that Strategist w> 💡 **Model Recommendation**: Claude Opus works best, but most mainstream models today (like Kimi 2.5 and MiniMax 2.7, tested via Codebuddy IDE) can also generate decent results with only minor gaps in layout details. Due to the instability of Opus on some IDEs (like Antigravity), trying other stable AI clients is recommended.-> 📝 **Post-Export Editing**: Each page in the exported PPTX is in SVG format. Select the page content in PowerPoint, right-click and choose **"Convert to Shape"** to freely edit all text, shapes, and colors. Requires **Office 2016** or later.+> 📝 **Post-Export Editing**: The default exported PPTX (`.pptx`) contains **native PowerPoint shapes** — text, graphics, and colors are directly editable, no extra steps needed. A second SVG reference file (`_svg.pptx`) is also generated; for that version, select the content in PowerPoint and use **"Convert to Shape"** to edit. Requires **Office 2016** or later.> 💡 **AI Lost Context?** Ask the AI to read `skills/ppt-master/SKILL.md` first; use `AGENTS.md` as the repository-level entry overview.@@ -240,7 +242,7 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final<details><summary><b>Q: Can I edit the generated presentations?</b></summary>-Yes! Each page in the exported PPTX is in SVG format. In PowerPoint, select the content, right-click and choose **"Convert to Shape"** — then all text, shapes, and colors become fully editable. Requires **Office 2016** or later.+Yes! The default export (`.pptx`) produces **native PowerPoint shapes** — all text, graphics, and colors are directly editable in PowerPoint without any conversion. An SVG reference version (`_svg.pptx`) is also generated; for that file, select the content and use **"Convert to Shape"** to unlock editing. Requires **Office 2016** or later.</details>@@ -311,4 +313,4 @@ If this project helps you, please give it a ⭐ Star!Made with ❤️ by Hugo He-[⬆ Back to Top](#ppt-master--ai-generates-editable-beautifully-designed-presentations-from-any-document)+[⬆ Back to Top](#ppt-master--ai-generates-natively-editable-pptx-from-any-document)diff --git a/README_CN.md b/README_CN.mdindex dee1a4a5..3a97d5e2 100644--- a/README_CN.md+++ b/README_CN.md@@ -1,14 +1,16 @@-# PPT Master — AI 生成可编辑的精美演示文稿,支持任意文档输入+# PPT Master — AI 生成原生可编辑 PPTX,支持任意文档输入-[](https://github.com/hugohe3/ppt-master/releases)+[](https://github.com/hugohe3/ppt-master/releases)[](https://opensource.org/licenses/MIT)[](https://github.com/hugohe3/ppt-master/stargazers)[English](./README.md) | 中文-丢进一份 PDF、DOCX、网址或 Markdown,AI 自动生成**可在 PowerPoint 中直接编辑**的精美演示文稿。支持 PPT 16:9、小红书、朋友圈等 10+ 种格式。+丢进一份 PDF、DOCX、网址或 Markdown,AI 自动生成**原生可编辑的 PowerPoint 演示文稿**——不是图片,每个文本框、图表、图形都是真正的 PowerPoint 对象,点击即可编辑。支持 PPT 16:9、小红书、朋友圈等 10+ 种格式。-> 💡 **架构大更新**:目前项目架构已进行重大升级(Skill-based architecture):+> 🔥 **重磅更新:原生可编辑 PPTX** — 生成的演示文稿现在默认包含**真正的 PowerPoint 原生形状**(DrawingML),文字、图表、图形均可在 PowerPoint 中直接编辑,无需任何额外操作。告别"转换为形状"!+>+> 💡 **架构更新**:目前项目使用 Skill-based 架构:> 1. **大幅减少 Token 消耗与模型依赖**:现在即使不使用 Opus 模型,其他模型也能生成质量尚可的结果。> 2. **更强的系统扩展性**:整个 `skills` 文件夹按 Agent Skills 标准组织,每个子目录都是一个完全自包含的 Skill。您可以将其直接放入支持该标准的 AI 客户端的 skills 目录中作为本地技能原生调用(例如:Claude Code 的 `.claude/skills/` 或 `~/.claude/skills/`;Antigravity 置于全局 skills 目录后经由 `.agent/workflows/` 引用;GitHub Copilot 的 `.github/skills/` 或 `~/.copilot/skills/`)。> 3. **稳定版降级选择**:旧版多平台适配架构虽然 Token 消耗较多,但经受了更长时间的检验。如果您在使用当前新版本时遇到不稳定情况,可以随时尝试退回至老架构的最终版本:[v1.3.0](https://github.com/hugohe3/ppt-master/tree/v1.3.0)。@@ -60,7 +62,7 @@↓[后处理] → total_md_split.py(拆分讲稿)→ finalize_svg.py → svg_to_pptx.py↓-输出: 可编辑的 PPTX(自动嵌入讲稿)+输出: 原生可编辑 PPTX(真实形状)+ SVG 参考版 PPTX(自动嵌入讲稿)↓[Optimizer_CRAP] 优化师(可选,初版后不满意再用)↓@@ -160,7 +162,7 @@ AI:好的,先确认是否使用模板;确认后我会继续八项确认并> 💡 **模型推荐**:Claude Opus 效果最佳,但大部分主流模型(如 Kimi 2.5、MiniMax 2.7 等,可通过 Codebuddy IDE 使用)目前均能生成不错的内容,仅在细节排版效果上可能存在差距。因目前某些 IDE (如 Antigravity) 的 Opus 极不稳定,请优先使用其他稳定的 AI 客户端进行创作。-> 📝 **导出后编辑**:导出的 PPTX 中每页为 SVG 格式。在 PowerPoint 中选中页面内容,右键选择 **"转换为形状"** (Convert to Shape) 后即可自由编辑所有文字、图形和颜色。需要 **Office 2016** 或更高版本。+> 📝 **导出后编辑**:默认导出的 PPTX(`.pptx`)包含**原生 PowerPoint 形状**,文字、图形和颜色可直接编辑,无需额外操作。同时还会生成一份 SVG 参考版(`_svg.pptx`),该版本需在 PowerPoint 中选中内容后右键选择 **"转换为形状"** (Convert to Shape) 方可编辑。需要 **Office 2016** 或更高版本。> 💡 **AI 迷失上下文?** 可提示 AI 优先阅读 `skills/ppt-master/SKILL.md`;如需一个仓库级入口概览,再参考 `AGENTS.md`@@ -236,7 +238,7 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s final<details><summary><b>Q: 生成的 PPT 可以编辑吗?</b></summary>-可以。导出的 PPTX 中每页为 SVG 格式,在 PowerPoint 中选中内容,右键选择 **"转换为形状"** (Convert to Shape) 后,所有文字、图形、颜色都可以自由编辑。需要 **Office 2016** 或更高版本。+可以!默认导出的 PPTX(`.pptx`)包含**原生 PowerPoint 形状**,所有文字、图形、颜色均可在 PowerPoint 中直接编辑,无需任何转换操作。同时还会生成一份 SVG 参考版(`_svg.pptx`),该版本需选中内容后右键 **"转换为形状"** (Convert to Shape) 方可编辑。需要 **Office 2016** 或更高版本。</details>@@ -307,4 +309,4 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s finalMade with ❤️ by Hugo He-[⬆ 回到顶部](#ppt-master--ai-生成可编辑的精美演示文稿支持任意文档输入)+[⬆ 回到顶部](#ppt-master--ai-生成原生可编辑-pptx支持任意文档输入)