PPT Master

PPT Master 是一个开源的 AI 辅助视觉内容生成系统。它通过模拟多个专业角色的协作流程，将一份原始文档（如 Word、PDF）自动转化为结构清晰、设计专业的 SVG 格式内容，支持演示文稿、小红书图文、朋友圈海报、Instagram Story 等十余种输出格式。

与市面上多数“一键生成 PPT”的工具不同，PPT Master 并非简单套用模板，而是构建了一套完整的视觉内容创作工作流，强调设计原则、内容逻辑与输出质量的统一。

一、多角色协作：一个接近真实团队的工作流

系统内置六个角色，各司其职，依次推进内容生成：

• 策略师（Strategist）：首先与用户确认八项关键参数，包括画布格式、页数、受众、设计风格、配色、图标方式、图片策略和字体方案。它会主动给出专业建议，例如“建议采用麦肯锡蓝（#005587）作为主导色”或“目标受众为高管，页数控制在 8–10 页更佳”。
• 图片生成师（Image_Generator）：仅在用户选择“AI 生成图片”时激活。它会为每张图生成优化提示词，调用 Gemini 或 Banana 等工具生成高分辨率图片，并统一归集到 images/ 目录。注意：此步骤为串行流程，必须完成才进入下阶段。
• 执行师（Executor）：分为三种风格变体：
  • 通用执行师：适用于日常汇报、培训等场景，布局灵活，视觉丰富；
  • 一般咨询执行师：面向商务报告，强调数据图表、KPI 仪表盘与 MECE 结构；
  • 顶级咨询执行师：对标麦肯锡、BCG 等顶级咨询公司标准，采用 SCQA 叙事框架、金字塔原则、数据情境化等方法。
• 优化师（Optimizer_CRAP）：可选环节，对关键页面应用 CRAP 设计四原则（对齐、对比、重复、亲密性），进一步提升视觉一致性与专业感。

这种角色分工模拟了真实的内容创作团队，确保从策略到执行的每个环节都有明确规范。

二、支持多格式输出，专注矢量质量

PPT Master 的输出基于纯 SVG 格式，具有以下优势：

• 高保真矢量图形：放大不失真，适配不同屏幕与打印需求；
• 自动适配画布：支持 10+ 种常见比例，包括：
  • PPT 16:9（1280×720）
  • PPT 4:3（1024×768）
  • 小红书（1242×1660）
  • 朋友圈（1080×1080）
  • Instagram Story（1080×1920）
• 无需第三方依赖：所有设计元素（图标、图表、文字）均内嵌于 SVG，不依赖外部字体或图片链接。

最终可通过内置工具将 SVG 批量转换为 .pptx 文件，保留矢量可编辑性（需 PowerPoint 2016 及以上版本）。

三、从文档到成品：完整工作流示例

1. 准备源文档
   使用开源工具 MinerU 将 PDF 或 Word 转为结构化 Markdown，保留标题、表格、公式等信息。
2. 与策略师确认设计参数
   例如：

   用户：“我有一份市场分析报告需要制作成演示文稿。”
   策略师建议：采用“顶级咨询风格”，画布为 PPT 16:9，配色使用麦肯锡蓝 + 活力橙，不使用图片，以数据图表为主。

3. 逐页生成 SVG
   执行师根据规范生成每页内容，用户可逐页审核、要求修改或触发优化。
4. 后处理与导出
   运行：

   python3 tools/finalize_svg.py projects/my_project_ppt169_20251201
   python3 tools/svg_to_pptx.py projects/my_project_ppt169_20251201 -s final
   

   完成图标嵌入、图片 Base64 化、文本扁平化等处理，并输出最终 PPTX。

四、实用工具与最佳实践

• 图表模板库：内置 13 种标准化图表（KPI、瀑布图、时间轴等），可直接调用；
• 640+ 矢量图标：来自 SVG Repo，风格统一，免版权风险；
• 质量检查工具：自动验证 SVG 是否符合技术规范（如禁用 <foreignObject>、正确使用 <tspan> 换行）；
• 水印去除工具：针对 Gemini 生成图的右下角水印，提供专用脚本清理。

提示：为获得最佳效果，推荐使用 Antigravity 编辑器，可免费调用 Opus 4.5 模型，并集成 Banana 生图功能。

五、适合谁用？

• 商业分析师、战略顾问：快速将报告转化为 MBB 级演示文稿；
• 内容创作者、运营人员：批量生成小红书、朋友圈等社交媒体素材；
• 开发者、技术布道者：希望用代码化方式管理视觉内容，支持版本控制与自动化；
• 教育工作者、研究者：将论文或课程材料结构化为教学 PPT。