🆚 为什么选 PPTskill？

| 能力 | 传统 PPT 工具 | 在线 AI PPT | PPTskill | |------|:-------------:|:-----------:|:------------:| | 原生可编辑 | ✅ | ❌ 图片/SVG | ✅ 真实形状 | | AI 驱动 | ❌ | ✅ | ✅ | | 本地运行 | ✅ | ❌ | ✅ 隐私安全 | | 工作流集成 | ❌ | ❌ | ✅ OpenClaw/Cursor | | 开源免费 | ❌ | ❌ | ✅ MIT License | | 多种风格 | ⚠️ 需手动 | ⚠️ 有限 | ✅ 10+ 模板 |

核心差异：输出的是真正的 PowerPoint 对象（DrawingML），不是图片或 SVG 嵌入。点击任何元素都可以直接编辑。

🚀 30 秒快速开始

# 1. 克隆仓库
git clone https://github.com/AIPMAndy/PPTskill.git
cd PPTskill
2. 安装依赖
pip install -r requirements.txt
3. 导出示例 PPT
python3 skills/ppt-master/scripts/svgtopptx.py examples/ppt169顶级咨询风构建有效AI代理_Anthropic -s final
✅ 完成！在 examples/ 目录下找到生成的 .pptx 文件

输出：

• 项目名_时间戳.pptx — 原生可编辑版本（推荐）
• 项目名时间戳svg.pptx — SVG 参考版本

💡 核心功能

1️⃣ 多种输入格式

• 📄 PDF — 研究论文、报告
• 📝 DOCX — Word 文档
• 🌐 URL — 网页、博客文章
• 📋 Markdown — 技术文档

2️⃣ 10+ 专业模板

• 🏢 顶级咨询风 — McKinsey/BCG 风格
• 🎓 学术风 — 论文答辩、研究汇报
• 🌙 禅意风 — 极简东方美学
• 🎨 杂志风 — 图文并茂
• 💻 科技风 — SaaS/产品发布
• 🌿 自然风 — 纪录片风格

3️⃣ AI 编辑器集成

| 工具 | 评分 | 说明 | |------|:----:|------| | Claude Code | ⭐⭐⭐ | 最佳效果 — 原生 Opus，最大上下文 | | Cursor | ⭐⭐ | 不错的替代方案 | | VS Code + Copilot | ⭐⭐ | 主流选择 | | OpenClaw | ⭐⭐⭐ | 推荐 — 工作流自动化 |

4️⃣ OpenClaw 工作流集成

你：从这个季度报告生成一个 PPT
AI：好的，让我确认设计规格：     [模板] 顶级咨询风     [格式] PPT 16:9     [页数] 8-10 页     ...          ✅ 已生成：Q3Report20260407.pptx

📖 使用场景

• 🎯 商业汇报 — 季度总结、战略规划
• 🎓 学术答辩 — 论文答辩、研究汇报
• 📊 数据分析 — 可视化报告
• 🚀 产品发布 — 新品介绍、路演
• 📚 培训课件 — 企业培训、教学
• 📝 内容营销 — 白皮书、案例研究

🎨 示例库

查看 examples/ — 15 个项目，229 页已验证示例：

• 顶级咨询风 × 5（Anthropic AI、心理治疗、财政分析等）
• 学术风 × 2（论文格式、医学研究）
• 禅意风 × 1（金刚经研究）
• 科技风 × 3（Git 介绍、AI 编程工具对比）
• 自然风 × 1（野生动物纪录片）
• 杂志风 × 1（园艺指南）

最新验证案例（2026-07-10）

《普通人必装的10个AI Skill》 — 13页完整PPT

• 模板：smart_red（现代活力风）
• 内容：10个AI工具介绍 + 使用场景
• 功能验证：✅ SVG生成、图标嵌入、演讲者备注、PPTX导出
• 文件大小：88KB（Native DrawingML版本）
• 位置：projects/普通人必装10个AISkillppt169_20260709/

🛠️ 安装指南

系统要求

• Python 3.9+（必需，推荐 3.9/3.10 以确保类型注解兼容性）
• Node.js 18+（可选 — 用于微信文章转换）
• Pandoc（可选 — 用于 DOCX/EPUB 转换）

macOS

brew install python
brew install node      # 可选
brew install pandoc    # 可选

Ubuntu/Debian

sudo apt install python3 python3-pip
sudo apt install nodejs npm    # 可选
sudo apt install pandoc        # 可选

Windows

从官网下载安装：

• Python
• Node.js（可选）
• Pandoc（可选）

🔧 高级用法

从现有项目导出

如果你已经有一个包含 svg_final/ 目录的项目：

python3 skills/ppt-master/scripts/svgtopptx.py <项目路径> -s final

初始化新项目

python3 skills/ppt-master/scripts/projectmanager.py init myproject --format ppt169

完整工作流示例

# 1. 创建项目目录结构
cd projects/yourprojectppt169_20260710
2. 生成 SVG 页面（放入 svg_output/）
手动创建或通过脚本生成
3. 准备演讲者备注
创建 notes/total.md，标题格式必须匹配 SVG 文件名（不带.svg）
4. 分割演讲者备注
python3 skills/ppt-master/scripts/totalmdsplit.py projects/yourprojectppt169_20260710
5. SVG 后处理（嵌入图标、转换圆角矩形）
python3 skills/ppt-master/scripts/finalizesvg.py projects/yourprojectppt16920260710
6. 导出为 PPTX
python3 skills/ppt-master/scripts/svgtopptx.py projects/yourprojectppt169_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 集成

将本仓库添加为 Claude Code Skill：

# 1. 复制 skill 到 Claude Code 技能目录
cp -r skills/ppt-master ~/.claude/skills/
2. 在对话中直接调用
你：用 PPT Master 生成一个关于 AI 的演示文稿

OpenClaw Skill 集成

• 将本仓库克隆到 OpenClaw 工作区
• Skill 会被自动检测（skills/PPTskill/SKILL.md）
• 直接对话："从这个文档生成一个 PPT"

🗺️ Roadmap

• [x] 核心 PPT 生成能力
• [x] 10+ 专业模板
• [x] OpenClaw 集成
• [x] 中英双语文档
• [x] Python 3.9 兼容性验证（2026-07-10）
• [x] 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

• 完整依赖安装可能因 pycairo / cairo 要求而失败

• DOCX/EPUB 转换需要 pandoc（可选）
• 需要 Office 2016+ 或 WPS 打开生成的 PPTX
• 图像生成功能需要配置 GEMINIAPIKEY 或 OPENAIAPIKEY 环境变量

🎯 设计哲学

遵循实用工程原则：

• 首先验证最短工作路径
• 删除不必要的复杂性
• 稳定工作流
• 只在证明有价值后才自动化

🙏 致谢

所有核心 PPT 生成能力来自优秀的上游项目：

• hugohe3/ppt-master — 感谢原作者的杰出工作

• 工作流集成优化
• OpenClaw 兼容性
• 实用文档和示例

👨‍💻 作者

AI酋长Andy | AI 产品专家，前腾讯/百度 AI PM，OpenClaw 深度用户

📅 更新日志

v1.1.0 (2026-07-10)

兼容性改进

• ✅ 修复 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 集成说明

v1.0.0 (Initial Release)

• 🎨 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/