项目简介
将 PDF、DOCX、URL、Markdown 等转换为原生可编辑的 PPTX，包含真实形状、图表、动画及配音。本地运行，数据不上传，支持多种 AI 模型与 IDE 集成。
README 预览
# PPT Master — AI generates natively editable PPTX from any document\n\n[](https://github.com/hugohe3/ppt-master/releases)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/hugohe3/ppt-master/stargazers)\n[](https://atomgit.com/hugohe3/ppt-master)\n\nEnglish | [中文](./README_CN.md)\n\n\n This project is kept free and open source with the support of PackyCode and other sponsors.\n\n\n\n \n \n Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our project users: register using this link and enter the promo code ppt-master during recharge to get 10% off.\n \n\n\n\n Live Demo ·\n About Hugo He ·\n Examples ·\n FAQ ·\n Contact\n\n\n\n \n\n\n\n ↑ A 12-page natively editable deck, generated end-to-end from a single WeChat article URL using Claude Opus 4.7. No manual design. No image export. Every shape, text box, and chart is clickable and editable in PowerPoint.\n\n\n---\n\nDrop in a PDF, DOCX, URL, or Markdown — get back a **natively editable PowerPoint** with real shapes, real text boxes, and real charts. Not images. Click anything and edit it.\n\n> **Template Replication** — hand the AI any `.pptx` you like and say "replicate it as a template via `/create-template`" — you get a layout set PPT Master can invoke directly. Theme colors, fonts, master/layout structure, reusable images, even sprite-sheet crop relationships are extracted straight from OOXML, so covers, chapter dividers and decoration-heavy pages all reproduce reliably. You're no longer limited to the built-in templates: a company brand deck, a client's winning template, or any high-quality reference can become a private template in your own library. See [Templates Guide →](./docs/templates-guide.md).\n\n> **Animations** — exported decks support **page transitions** and **per-element entrance animations** as real
常见问题 (4)
故障排除当我在ppt-master中使用Python虚拟环境时，为什么更新脚本会失败并显示'Tracked local changes detected'？
手动创建虚拟环境会修改 CLAUDE.md 文件，导致未提交的更改阻塞更新脚本。要解决此问题，请按照推荐的设置使用 uv：运行 cd ./ppt-master，然后 uv venv .venv、source .venv/bin/activate 和 uv pip install -r requirements.txt。项目的 CLAUDE.md 已指示 LLM 使用 .venv/bin/python，因此无需手动编辑。之后，更新脚本将正常运行，不会产生冲突。
故障排除为什么在将PowerPoint转换为SVG时文本渐变填充会消失？
SVG转换管道先前省略了文本渐变定义。修复方法：修改txbody_to_svg.py，从文本运行（通过_build_run()）收集<linearGradient> / <radialGradient>，并在TextResult.defs中返回它们。然后更新slide_to_svg.py，每张幻灯片重置累加器，并将文本渐变定义合并到SVG <defs>部分。修复后，文本元素正确地引用了类似url(#gradient-id)的填充。确保你已获取包含这些更改的最新提交。
故障排除如何修复通过npx skills安装的ppt-master创建的项目目录位置错误的问题？
使用 project_manager.py init 时，通过 --dir 标志显式设置输出目录。示例：python .agents/skills/ppt-master/scripts/project_manager.py init myproject --dir $(git rev-parse --show-toplevel)/projects。这确保了项目创建在仓库根目录下，而不是在 .agents/skills/ppt-master/ 内部。
故障排除如何加速当前需要20分钟以上的AI驱动的PPT生成？
速度、质量和成本之间存在权衡关系。要减少生成时间，要么接受较低质量（例如更简单的页面），要么增加投入（使用更快、更昂贵的AI模型如Claude或GPT-4，或部署专用资源）。降低质量可以快速生成基础套件，而升级模型可保持质量但会提高API成本。在不增加额外支出的情况下，不存在既能高质量生成又仅需2-3分钟的方案。