English | 中文
一个基于 AI 的智能视觉内容生成系统，通过多角色协作，将源文档转化为高质量的 SVG 内容，支持演示文稿、社交媒体、营销海报等多种格式。
🎴 在线示例：GitHub Pages 在线预览 - 查看实际生成效果
本项目需要 Python 3.8+，用于运行 PDF 转换、SVG 后处理、PPTX 导出等工具。
安装 Python：
| 平台 | 推荐安装方式 |
|---|---|
| macOS | 使用 Homebrew：brew install python |
| Windows | 从 Python 官网 下载安装包 |
| Linux | 使用系统包管理器：sudo apt install python3 python3-pip（Ubuntu/Debian） |
💡 验证安装：运行
python3 --version确认版本 ≥ 3.8
如需使用 web_to_md.cjs 工具（用于微信公众号等高防站点的网页转换），需安装 Node.js。
安装 Node.js：
| 平台 | 推荐安装方式 |
|---|---|
| macOS | 使用 Homebrew：brew install node |
| Windows | 从 Node.js 官网 下载 LTS 版本安装包 |
| Linux | 使用 NodeSource：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs |
💡 验证安装：运行
node --version确认版本 ≥ 18
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt如遇权限问题，可使用
pip install --user -r requirements.txt或在虚拟环境中安装。
推荐使用以下 AI 编辑器：
| 工具 | 推荐度 | 说明 |
|---|---|---|
| Antigravity | ⭐⭐⭐ | 强烈推荐！免费使用 Opus 4.6，集成 Banana 生图功能，可直接在仓库里生成配图 |
| Cursor | ⭐⭐ | 主流 AI 编辑器，支持多种模型 |
| VS Code + Copilot | ⭐⭐ | 微软官方方案 |
| Claude Code | ⭐⭐ | Anthropic 官方 CLI 工具 |
在 AI 编辑器中打开聊天面板，直接描述你想创作的内容：
用户：我有一份关于 Q3 季度业绩的报告，需要制作成 PPT
AI（Strategist 角色）：好的，在开始之前我需要完成八项确认...
1. 画布格式：[建议] PPT 16:9
2. 页数范围：[建议] 8-10 页
...
💡 模型推荐：Opus 4.6 效果最佳，Antigravity 目前可免费使用
💡 AI 迷失上下文？ 可提示 AI 参考
AGENTS.md文件，它会自动按照仓库中的角色定义工作
💡 AI 生成图片建议：如需 AI 生成配图，建议在 Gemini 中生成后选择 Download full size 下载，分辨率比 Antigravity 直接生成的更高。Gemini 生成的图片右下角会有星星水印，可使用 gemini-watermark-remover 或本项目的
tools/gemini_watermark_remover.py去除。
| 文档 | 说明 |
|---|---|
| 📖 工作流教程 | 详细的工作流程和案例演示 |
| 🎨 设计指南 | 配色、排版、布局规范详解 |
| 📐 画布格式 | PPT、小红书、朋友圈等 10+ 种格式 |
| 🖼️ 图片嵌入指南 | SVG 图片嵌入最佳实践 |
| 📊 图表模板库 | 13 种标准化图表模板 · 在线预览 |
| ⚡ 快速参考 | 常用命令和参数速查 |
| 🔧 角色定义 | 6 个 AI 角色的完整定义 |
| 🛠️ 工具集 | 所有工具的使用说明 |
| 💼 示例索引 | 15 个项目、229 页 SVG 示例 |
📁 示例库:
examples/· 15 个项目 · 229 页 SVG
| 类别 | 项目 | 页数 | 特色 |
|---|---|---|---|
| 🏢 咨询风格 | 心理治疗中的依恋 | 32 | 顶级咨询风格，最大规模示例 |
| 构建有效AI代理 | 15 | Anthropic 工程博客，AI Agent 架构 | |
| 重庆市区域报告 | 20 | 区域财政分析，企业预警通数据 🆕 | |
| 甘孜州经济财政分析 | 17 | 政务财政分析，藏区文化元素 | |
| 🎨 通用灵活 | Debug 六步法 | 10 | 深色科技风格 |
| 重庆大学论文格式 | 11 | 学术规范指南 | |
| ✨ 创意风格 | 地山谦卦深度研究 | 20 | 易经本体美学，阴阳爻变设计 |
| 金刚经第一品研究 | 15 | 禅意学术，水墨留白 | |
| Git 入门指南 | 10 | 像素复古游戏风 |
📖 查看完整示例文档
用户输入 (PDF/URL/Markdown)
↓
[源内容转换] → pdf_to_md.py / web_to_md.py
↓
[创建项目] → project_manager.py init <项目名> --format <格式>
↓
[模板选项] A) 使用已有模板 B) 不使用模板
↓
[需要新模板？] → 使用 /create-template 工作流单独创建
↓
[Strategist] 策略师 - 八项确认与设计规范
↓
[Image_Generator] 图片生成师（当选择 AI 生成时）
↓
[Executor] 执行师 - 分阶段生成
├── 视觉构建阶段：连续生成所有 SVG 页面 → svg_output/
└── 逻辑构建阶段：生成完整讲稿 → notes/total.md
↓
[后处理] → total_md_split.py（拆分讲稿）→ finalize_svg.py → svg_to_pptx.py
↓
输出: SVG + PPTX（自动嵌入讲稿）
↓
[Optimizer_CRAP] 优化师（可选，初版后不满意再用）
↓
如有优化：重新运行后处理与导出
💡 PPT 编辑提示：导出的 PPTX 页面为 SVG 格式。若需编辑内容，请在 PowerPoint 中选中页面，右键选择 "转换为形状" (Convert to Shape)。此功能需要 Office 2016 或更高版本。
# 初始化项目
python3 tools/project_manager.py init <项目名> --format ppt169
# PDF 转 Markdown
python3 tools/pdf_to_md.py <PDF文件>
# 后处理 SVG
python3 tools/finalize_svg.py <项目路径>
# 导出 PPTX
python3 tools/svg_to_pptx.py <项目路径> -s final📖 完整工具说明请参阅 工具使用指南
ppt-master/
├── roles/ # AI 角色定义（6 个专业角色）
├── docs/ # 文档中心（教程、设计指南、格式规范等）
├── templates/ # 模板库（图表模板 + 640+ 图标）
├── tools/ # 工具集（项目管理、转换、处理）
├── examples/ # 示例项目（15 个完整案例）
└── projects/ # 用户项目工作区
Q: 生成的 SVG 文件如何使用？
- 直接在浏览器中打开查看
- 使用
svg_to_pptx.py导出为 PowerPoint（需在 PPT 中"转换为形状"以编辑，要求 Office 2016+） - 嵌入到 HTML 页面或使用设计工具编辑
Q: 三种执行师有什么区别？
- Executor_General: 通用场景，灵活布局
- Executor_Consultant: 一般咨询，数据可视化
- Executor_Consultant_Top: 顶级咨询（MBB 级），5 大核心技巧
Q: 必须使用 Optimizer_CRAP 吗？
不是必须的。仅在需要优化关键页面视觉效果时使用。
📖 更多问题请查看 工作流教程
欢迎贡献！
- Fork 本仓库
- 创建分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add AmazingFeature') - 推送分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
贡献方向：🎨 设计模板 · 📊 图表组件 · 📝 文档完善 · 🐛 Bug 报告 · 💡 功能建议
本项目采用 MIT License 开源协议。
- SVG Repo - 开源图标库
- Robin Williams - CRAP 设计原则
- 麦肯锡、波士顿咨询、贝恩 - 设计灵感来源
- Issue: GitHub Issues
- GitHub: @hugohe3
如果这个项目对你有帮助，请给一个 ⭐ Star 支持一下！
Made with ❤️ by Hugo He