AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
refactor: 流程与规则分离,generate-ppt.md为主入口
hugohe3df2efb2fcebe
diff --git a/.agent/workflows/generate-ppt.md b/.agent/workflows/generate-ppt.mdindex ace7d15e..77691b40 100644--- a/.agent/workflows/generate-ppt.md+++ b/.agent/workflows/generate-ppt.md@@ -1,11 +1,27 @@----description: 从 Markdown 源文档生成 PPT 的完整流程+description: 从 Markdown 源文档生成 PPT 的完整流程(主入口)---# PPT 生成工作流+> 📌 **这是 PPT Master 系统的主执行流程**。所有 PPT 生成任务都应从此工作流开始。+本工作流用于从 Markdown 源文档生成 PowerPoint 演示文稿。+**相关文档**:+- [AGENTS.md](../../AGENTS.md) — 规则手册(角色切换协议、技术约束、AI 提示)+- [roles/](../../roles/) — 各角色详细定义和知识库++---++## 工作流概览++```+源文档 → 创建项目 → 模板选项 → Strategist → [Template_Designer] → [Image_Generator] → Executor → 后处理 → 导出+```++---+## 前置条件- 用户已提供源文档(Markdown、PDF 或 URL)diff --git a/AGENTS.md b/AGENTS.mdindex db7b9154..39f37e3f 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -18,110 +18,19 @@ PPT Master 是一个 AI 驱动的多格式 SVG 内容生成系统,通过多角| **Executor_Consultant_Top** | `roles/Executor_Consultant_Top.md` | 顶级咨询风格 SVG 生成(MBB 级) || **Optimizer_CRAP** | `roles/Optimizer_CRAP.md` | CRAP 原则视觉优化(可选) |-### 工作流程+### 主工作流程++> 📖 **详细执行步骤**:请参阅 [generate-ppt.md](.agent/workflows/generate-ppt.md)```-用户提供源文档(PDF/URL/Markdown)- │- ▼-源内容转换工具(如需要)- │- ▼-【创建项目文件夹】← ← ← ← ← 获取原始材料后立即执行- python3 tools/project_manager.py init <名称> --format <格式>- │- ▼-┌─────────────────────────────────────────┐-│ 询问模板选项(三选一) │-└─────────────────────────────────────────┘- │- ├─────────────────────────────────────────┐- │ │- A) 使用已有模板 │- │ │- ├→ 用户提供模板或从示例库选择 │- │ 图片 → images/,其他 → templates/ │- │ (来源:用户自备/其他项目/示例库等) │- │ │- │ B) 不使用模板- │ │- │ │- │ │- C) 生成新模板 │- │ │- │ │- │ │- ├─────────────────────────────────────────┘- │- ▼-┌─────────────────────────────────────────┐-│ Strategist(策略规划)← 必须,不可跳过 │-│ • 八项确认 │-│ • 生成《设计规范与内容大纲》 │-│ • 保存设计规范到项目文件夹 │-└─────────────────────────────────────────┘- │- ├─ 模板选项 = C(生成新模板)?- │ │- │ YES ────────────────────────────┐- │ │- │ ┌──────────────────────────────────┐- │ │ Template_Designer(选项 C) │- │ │ • 生成页面模板到 templates/ │- │ │ • 用户确认后继续 │- │ └──────────────────────────────────┘- │ │- │ ┌──────────────────────────────────┘- │ │- ├───────┘- │- ├─ 图片方式包含「C) AI 生成」?- │ │- │ YES → Image_Generator → 保存到 images/- │ │- │ NO ──────────────────────────────┐- │ │- ▼ ▼-┌──────────────────────────────────────────────────┐-│ Executor (General/Consultant/Consultant_Top) │-│ │-│ 【视觉构建阶段】 │-│ • 逐页生成 SVG(可基于模板)→ svg_output/ │-│ │-│ 【逻辑构建阶段】← ← ← ← 必须 │-│ • 生成完整讲稿 → notes/total.md │-│ │-└──────────────────────────────────────────────────┘- │- ▼-【后处理】← ← ← ← ← 默认由 AI 自动执行- python3 tools/total_md_split.py # 拆分讲稿- python3 tools/finalize_svg.py- │- ▼-SVG 文件保存到 svg_final/- │- ▼-【导出 PPTX】← ← ← ← ← 默认由 AI 自动执行- python3 tools/svg_to_pptx.py- │- ▼-Optimizer_CRAP (可选优化,**在完整初版后**不满意时才考虑)- │- ▼-如执行优化:重新运行【后处理】与【导出 PPTX】+源文档 → 创建项目 → 模板选项 → Strategist → [Template_Designer] → [Image_Generator] → Executor → 后处理 → 导出```-> **注意**:->-> - **项目文件夹必须在源材料转换完成后立即创建**-> - **模板选项必须在策略师开始之前确认**,策略师需要根据模板选项调整设计方案-> - 如选择 A(使用已有模板),策略师需参考模板的配色、布局、风格进行设计-> - 如选择 C(生成新模板),策略师完成大纲后再调用模板设计师-> - **策略师的「八项确认」是强制要求,无论模板选项如何都不可跳过**-> - Image_Generator 是串行环节,图片归集完成后才进入 Executor 阶段-> - 后处理和导出步骤以 **AI 自动执行为主**(需要时可手动运行命令)-> - Optimizer_CRAP 仅在质量不足时使用;**须在完整初版产出后再考虑,优化后需重新运行后处理与导出**+**关键节点**:+1. **源内容处理**:PDF/URL 立即转换,不等待确认+2. **模板选项**:必须在策略师之前确认(A 使用已有 / B 不使用 / C 生成新模板)+3. **八项确认**:策略师必须完成,不可跳过+4. **后处理与导出**:AI 自动执行---