| 能力 | 传统 PPT 工具 | 在线 AI PPT | PPTskill |
|---|---|---|---|
| 原生可编辑 | ✅ | ❌ 图片/SVG | ✅ 真实形状 |
| AI 驱动 | ❌ | ✅ | ✅ |
| 本地运行 | ✅ | ❌ | ✅ 隐私安全 |
| 工作流集成 | ❌ | ❌ | ✅ OpenClaw/Cursor |
| 开源免费 | ❌ | ❌ | ✅ MIT License |
| 多种风格 | ✅ 10+ 模板 |
核心差异：输出的是真正的 PowerPoint 对象（DrawingML），不是图片或 SVG 嵌入。点击任何元素都可以直接编辑。
# 1. 克隆仓库
git clone https://github.com/AIPMAndy/PPTskill.git
cd PPTskill
# 2. 安装依赖
pip install -r requirements.txt
# 3. 导出示例 PPT
python3 skills/ppt-master/scripts/svg_to_pptx.py examples/ppt169_顶级咨询风_构建有效AI代理_Anthropic -s final
# ✅ 完成！在 examples/ 目录下找到生成的 .pptx 文件输出：
项目名_时间戳.pptx— 原生可编辑版本（推荐）项目名_时间戳_svg.pptx— SVG 参考版本
- 📄 PDF — 研究论文、报告
- 📝 DOCX — Word 文档
- 🌐 URL — 网页、博客文章
- 📋 Markdown — 技术文档
- 🏢 顶级咨询风 — McKinsey/BCG 风格
- 🎓 学术风 — 论文答辩、研究汇报
- 🌙 禅意风 — 极简东方美学
- 🎨 杂志风 — 图文并茂
- 💻 科技风 — SaaS/产品发布
- 🌿 自然风 — 纪录片风格
| 工具 | 评分 | 说明 |
|---|---|---|
| Claude Code | ⭐⭐⭐ | 最佳效果 — 原生 Opus，最大上下文 |
| Cursor | ⭐⭐ | 不错的替代方案 |
| VS Code + Copilot | ⭐⭐ | 主流选择 |
| OpenClaw | ⭐⭐⭐ | 推荐 — 工作流自动化 |
你：从这个季度报告生成一个 PPT
AI：好的，让我确认设计规格：
[模板] 顶级咨询风
[格式] PPT 16:9
[页数] 8-10 页
...
✅ 已生成：Q3_Report_20260407.pptx
- 🎯 商业汇报 — 季度总结、战略规划
- 🎓 学术答辩 — 论文答辩、研究汇报
- 📊 数据分析 — 可视化报告
- 🚀 产品发布 — 新品介绍、路演
- 📚 培训课件 — 企业培训、教学
- 📝 内容营销 — 白皮书、案例研究
查看 examples/ — 15 个项目，229 页已验证示例：
- 顶级咨询风 × 5（Anthropic AI、心理治疗、财政分析等）
- 学术风 × 2（论文格式、医学研究）
- 禅意风 × 1（金刚经研究）
- 科技风 × 3（Git 介绍、AI 编程工具对比）
- 自然风 × 1（野生动物纪录片）
- 杂志风 × 1（园艺指南）
《普通人必装的10个AI Skill》 — 13页完整PPT
- 模板：smart_red（现代活力风）
- 内容：10个AI工具介绍 + 使用场景
- 功能验证：✅ SVG生成、图标嵌入、演讲者备注、PPTX导出
- 文件大小：88KB（Native DrawingML版本）
- 位置：
projects/普通人必装10个AI_Skill_ppt169_20260709/
- Python 3.9+（必需，推荐 3.9/3.10 以确保类型注解兼容性）
- Node.js 18+（可选 — 用于微信文章转换）
- Pandoc（可选 — 用于 DOCX/EPUB 转换）
brew install python
brew install node # 可选
brew install pandoc # 可选sudo apt install python3 python3-pip
sudo apt install nodejs npm # 可选
sudo apt install pandoc # 可选从官网下载安装：
如果你已经有一个包含 svg_final/ 目录的项目：
python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s finalpython3 skills/ppt-master/scripts/project_manager.py init my_project --format ppt169# 1. 创建项目目录结构
cd projects/your_project_ppt169_20260710
# 2. 生成 SVG 页面（放入 svg_output/）
# 手动创建或通过脚本生成
# 3. 准备演讲者备注
# 创建 notes/total.md，标题格式必须匹配 SVG 文件名（不带.svg）
# 4. 分割演讲者备注
python3 skills/ppt-master/scripts/total_md_split.py projects/your_project_ppt169_20260710
# 5. SVG 后处理（嵌入图标、转换圆角矩形）
python3 skills/ppt-master/scripts/finalize_svg.py projects/your_project_ppt169_20260710
# 6. 导出为 PPTX
python3 skills/ppt-master/scripts/svg_to_pptx.py projects/your_project_ppt169_20260710 -s final问题：演讲者备注无法匹配
# 确保 notes/total.md 中的二级标题与 SVG 文件名完全一致
# 正确：## 01_封面
# 错误：## 页面01：封面问题：图标未显示
# 检查 finalize_svg.py 输出的警告信息
# 如果提示 "Icon not found: xxx"，说明图标名称不存在
# 可用图标列表见 skills/ppt-master/icon_library/问题：Python 类型注解错误
# 确保使用 Python 3.9 或 3.10
python3 --version
# 如果遇到 "unsupported operand type(s) for |"
# 说明代码中还有 PEP 604 语法，请提交 issue将本仓库添加为 Claude Code Skill：
# 1. 复制 skill 到 Claude Code 技能目录
cp -r skills/ppt-master ~/.claude/skills/
# 2. 在对话中直接调用
# 你：用 PPT Master 生成一个关于 AI 的演示文稿- 将本仓库克隆到 OpenClaw 工作区
- Skill 会被自动检测（
skills/PPTskill/SKILL.md） - 直接对话：
"从这个文档生成一个 PPT"
- 核心 PPT 生成能力
- 10+ 专业模板
- OpenClaw 集成
- 中英双语文档
- Python 3.9 兼容性验证（2026-07-10）
- Claude Code Skill 集成
- 一键安装脚本
- GitHub Actions CI/CD
- 视频教程
- 更多模板（产品发布、融资路演）
- Web UI（可选）
欢迎贡献！请：
- Fork 本仓库
- 创建特性分支（
git checkout -b feature/AmazingFeature） - 提交改动（
git commit -m 'Add some AmazingFeature'） - 推送到分支（
git push origin feature/AmazingFeature） - 提交 Pull Request
贡献方向：
- 新增模板风格
- 优化工作流集成
- 补充文档和示例
- Bug 修复
- Python 版本要求：推荐使用 Python 3.9 或 3.10
⚠️ 代码已从 PEP 604 语法（X | Y）转换为兼容语法（Union[X, Y]）- 已在 Python 3.9 环境验证所有核心功能正常
- 完整依赖安装可能因
pycairo/cairo要求而失败⚠️ 这不会阻塞核心 PPT 导出功能
- DOCX/EPUB 转换需要
pandoc（可选） - 需要 Office 2016+ 或 WPS 打开生成的 PPTX
- 图像生成功能需要配置
GEMINI_API_KEY或OPENAI_API_KEY环境变量
遵循实用工程原则：
- 首先验证最短工作路径
- 删除不必要的复杂性
- 稳定工作流
- 只在证明有价值后才自动化
所有核心 PPT 生成能力来自优秀的上游项目：
- hugohe3/ppt-master — 感谢原作者的杰出工作
本分支专注于：
- 工作流集成优化
- OpenClaw 兼容性
- 实用文档和示例
AI酋长Andy | AI 产品专家，前腾讯/百度 AI PM，OpenClaw 深度用户
兼容性改进
- ✅ 修复 Python 3.9 类型注解兼容性问题（73处修改，覆盖12个核心文件）
- ✅ 所有 PEP 604 语法（
X | Y）已转换为Union[X, Y] - ✅ 在 Python 3.9 环境完整验证核心功能
新增验证案例
- 📊 《普通人必装的10个AI Skill》13页完整PPT
- 🎨 验证 smart_red 模板在真实场景的表现
- 📝 完整演讲者备注生成和分割流程
文档改进
- 📖 添加完整工作流示例
- 🔧 新增故障排除章节
- 💡 补充 Claude Code Skill 集成说明
- 🎨 10+ 专业模板
- 🤖 OpenClaw 集成
- 📦 核心 PPT 生成能力
- 📚 15个示例项目（229页）
MIT License（与上游相同）
本仓库包含工作流文档和集成改进。 请尊重上游仓库的许可证和署名要求。
- 上游项目：https://github.com/hugohe3/ppt-master
- 本分支：https://github.com/AIPMAndy/PPTskill
- OpenClaw：https://openclaw.ai/
- 在线示例：https://hugohe3.github.io/ppt-master/
如果这个项目对你有帮助，请给个 ⭐ Star！
让更多人发现这个工具 🚀