PPT Master - AI 驱动的多格式 SVG 内容生成系统

English | 中文

一个基于 AI 的智能视觉内容生成系统，通过多角色协作，将源文档转化为高质量的 SVG 内容，支持演示文稿、社交媒体、营销海报等多种格式。

🎴 在线示例：GitHub Pages 在线预览 - 查看实际生成效果

🎬 快速示例：YouTube | Bilibili - 观看视频演示

🚀 快速开始

1. 配置环境

Python 环境（必需）

本项目需要 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

Node.js 环境（可选）

如需使用 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

2. 克隆仓库并安装依赖


git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt

如遇权限问题，可使用 pip install --user -r requirements.txt 或在虚拟环境中安装。

3. 打开 AI 编辑器

推荐使用以下 AI 编辑器：

工具	推荐度	说明
VS Code + Copilot	⭐⭐⭐	强烈推荐！性价比高，运行稳定，微软官方方案
Cursor	⭐⭐	主流 AI 编辑器，体验好但价格较高
Claude Code	⭐⭐	Anthropic 官方 CLI 工具
Antigravity	⭐	免费使用 Opus 4.6 接口，但目前模型极不稳定，仅作备选

4. 开始创作

在 AI 编辑器中打开聊天面板，直接描述你想创作的内容：


用户：我有一份关于 Q3 季度业绩的报告，需要制作成 PPT

AI（Strategist 角色）：好的，在开始之前我需要完成八项确认...
   1. 画布格式：[建议] PPT 16:9
   2. 页数范围：[建议] 8-10 页
   ...

💡 模型推荐：Opus 4.6 效果最佳，但因目前某些 IDE (如 Antigravity) 的 Opus 极不稳定，请优先使用其他稳定的 AI 客户端。

💡 生图能力集成：建议配置 Google AI 的环境变量（GEMINI_API_KEY，如需代理可添加 GEMINI_BASE_URL），以便借助本项目的 tools/nano_banana_gen.py 在 AI 客户端中集成 nano banana 2 的强大生图能力。若使用 Antigravity 代理，调用时请注意需传入模型参数（-m gemini-3.1-flash-image）。

💡 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/       # 用户项目工作区