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
docs: 更新模板使用的占位符列表,补充版权信息字段
hugohe30db8f7f74428
diff --git a/README.md b/README.mdindex 46dae3e1..f67fa023 100644--- a/README.md+++ b/README.md@@ -18,12 +18,12 @@### 推荐工具-| 工具 | 推荐度 | 说明 |-|------|:------:|------|-| **[Antigravity](https://antigravity.dev/)** | ⭐⭐⭐ | **强烈推荐**!免费使用 Opus 4.5,集成 Banana 生图功能,可直接在仓库里生成配图 |-| [Cursor](https://cursor.sh/) | ⭐⭐ | 主流 AI 编辑器,支持多种模型 |-| [VS Code + Copilot](https://code.visualstudio.com/) | ⭐⭐ | 微软官方方案 |-| [Claude Code](https://claude.ai/) | ⭐⭐ | Anthropic 官方 CLI 工具 |+| 工具 | 推荐度 | 说明 |+| --------------------------------------------------- | :----: | ----------------------------------------------------------------------------- |+| **[Antigravity](https://antigravity.dev/)** | ⭐⭐⭐ | **强烈推荐**!免费使用 Opus 4.5,集成 Banana 生图功能,可直接在仓库里生成配图 |+| [Cursor](https://cursor.sh/) | ⭐⭐ | 主流 AI 编辑器,支持多种模型 |+| [VS Code + Copilot](https://code.visualstudio.com/) | ⭐⭐ | 微软官方方案 |+| [Claude Code](https://claude.ai/) | ⭐⭐ | Anthropic 官方 CLI 工具 |> 💡 **AI 生成图片建议**:如需 AI 生成配图,建议在 [Gemini](https://gemini.google.com/) 中生成后选择 **Download full size** 下载,分辨率比 Antigravity 直接生成的更高。Gemini 生成的图片右下角会有星星水印,可使用 [gemini-watermark-remover](https://github.com/journey-ad/gemini-watermark-remover) 或本项目的 `tools/gemini_watermark_remover.py` 去除。@@ -62,23 +62,23 @@ AI(Strategist 角色):好的,在开始之前我需要完成八项确认.### 示例项目总览-| 类别 | 项目 | 页数 | 特色 |-|------|------|:----:|------|-| 🏢 **咨询风格** | [心理治疗中的依恋](./examples/ppt169_顶级咨询风_心理治疗中的依恋/) | 32 | 顶级咨询风格,最大规模示例 |-| | [构建有效AI代理](./examples/ppt169_顶级咨询风_构建有效AI代理_Anthropic/) | 15 | Anthropic 工程博客,AI Agent 架构 |-| | [重庆市区域报告](./examples/ppt169_顶级咨询风_重庆市区域报告_ppt169_20251213/) | 20 | 区域财政分析,企业预警通数据 🆕 |-| | [甘孜州经济财政分析](./examples/ppt169_顶级咨询风_甘孜州经济财政分析/) | 17 | 政务财政分析,藏区文化元素 |-| | [南欧江水电站战略评估](./examples/ppt169_高端咨询风_南欧江水电站战略评估/) | 20 | "流域危机"设计语言 |-| | [汽车认证五年战略规划](./examples/ppt169_高端咨询风_汽车认证五年战略规划/) | 20 | McKinsey/BCG 风格 |-| | [麦肯锡风客户忠诚度](./examples/ppt169_麦肯锡风_kimsoong_customer_loyalty/) | 8 | 麦肯锡经典 MECE 原则 |-| | [Google 年度工作汇报](./examples/ppt169_谷歌风_google_annual_report/) | 10 | Google 品牌设计语言 |-| 🎨 **通用灵活** | [Debug 六步法](./examples/ppt169_通用灵活+代码_debug六步法/) | 10 | 深色科技风格 |-| | [重庆大学论文格式](./examples/ppt169_通用灵活+学术_重庆大学论文格式标准/) | 11 | 学术规范指南 |-| | [AI 编程工具对比](./examples/ppt169_通过灵活+代码_三大AI编程神器横向对比/) | 11 | 技术评测风格 |-| ✨ **创意风格** | [地山谦卦深度研究](./examples/ppt169_易理风_地山谦卦深度研究/) | 20 | 易经本体美学,阴阳爻变设计 |-| | [金刚经第一品研究](./examples/ppt169_禅意风_金刚经第一品研究/) | 15 | 禅意学术,水墨留白 |-| | [Git 入门指南](./examples/ppt169_像素风_git_introduction/) | 10 | 像素复古游戏风 |-| | [PPT Master 介绍](./examples/demo_project_intro_ppt169_20251211/) | 10 | 清新科技风格 |+| 类别 | 项目 | 页数 | 特色 |+| --------------- | ------------------------------------------------------------------------------ | :--: | --------------------------------- |+| 🏢 **咨询风格** | [心理治疗中的依恋](./examples/ppt169_顶级咨询风_心理治疗中的依恋/) | 32 | 顶级咨询风格,最大规模示例 |+| | [构建有效AI代理](./examples/ppt169_顶级咨询风_构建有效AI代理_Anthropic/) | 15 | Anthropic 工程博客,AI Agent 架构 |+| | [重庆市区域报告](./examples/ppt169_顶级咨询风_重庆市区域报告_ppt169_20251213/) | 20 | 区域财政分析,企业预警通数据 🆕 |+| | [甘孜州经济财政分析](./examples/ppt169_顶级咨询风_甘孜州经济财政分析/) | 17 | 政务财政分析,藏区文化元素 |+| | [南欧江水电站战略评估](./examples/ppt169_高端咨询风_南欧江水电站战略评估/) | 20 | "流域危机"设计语言 |+| | [汽车认证五年战略规划](./examples/ppt169_高端咨询风_汽车认证五年战略规划/) | 20 | McKinsey/BCG 风格 |+| | [麦肯锡风客户忠诚度](./examples/ppt169_麦肯锡风_kimsoong_customer_loyalty/) | 8 | 麦肯锡经典 MECE 原则 |+| | [Google 年度工作汇报](./examples/ppt169_谷歌风_google_annual_report/) | 10 | Google 品牌设计语言 |+| 🎨 **通用灵活** | [Debug 六步法](./examples/ppt169_通用灵活+代码_debug六步法/) | 10 | 深色科技风格 |+| | [重庆大学论文格式](./examples/ppt169_通用灵活+学术_重庆大学论文格式标准/) | 11 | 学术规范指南 |+| | [AI 编程工具对比](./examples/ppt169_通过灵活+代码_三大AI编程神器横向对比/) | 11 | 技术评测风格 |+| ✨ **创意风格** | [地山谦卦深度研究](./examples/ppt169_易理风_地山谦卦深度研究/) | 20 | 易经本体美学,阴阳爻变设计 |+| | [金刚经第一品研究](./examples/ppt169_禅意风_金刚经第一品研究/) | 15 | 禅意学术,水墨留白 |+| | [Git 入门指南](./examples/ppt169_像素风_git_introduction/) | 10 | 像素复古游戏风 |+| | [PPT Master 介绍](./examples/demo_project_intro_ppt169_20251211/) | 10 | 清新科技风格 |📖 [查看完整示例文档](./examples/README.md)@@ -107,27 +107,27 @@ AI(Strategist 角色):好的,在开始之前我需要完成八项确认.<details><summary><b>📋 目录(点击展开)</b></summary>-| 章节 | 链接 |-|------|------|+| 章节 | 链接 |+| --------------- | ---------------------- || 🚀 快速使用指南 | [跳转](#-快速使用指南) |-| 🎴 精选示例 | [跳转](#-精选示例) |-| 项目简介 | [跳转](#项目简介) |-| 核心特性 | [跳转](#核心特性) |-| 系统架构 | [跳转](#系统架构) |-| 核心角色 | [跳转](#核心角色) |-| 快速开始 | [跳转](#快速开始) |-| 更多示例 | [跳转](#更多示例) |-| 设计风格 | [跳转](#设计风格) |-| 技术规范 | [跳转](#技术规范) |-| 项目结构 | [跳转](#项目结构) |-| 最佳实践 | [跳转](#最佳实践) |-| 常见问题 | [跳转](#常见问题) |-| 贡献指南 | [跳转](#贡献指南) |-| 路线图 | [跳转](#路线图) |-| 🛠️ 工具集 | [跳转](#️-工具集) |-| 📄 开源协议 | [跳转](#-开源协议) |-| 🙏 致谢 | [跳转](#-致谢) |-| 📮 联系方式 | [跳转](#-联系方式) |+| 🎴 精选示例 | [跳转](#-精选示例) |+| 项目简介 | [跳转](#项目简介) |+| 核心特性 | [跳转](#核心特性) |+| 系统架构 | [跳转](#系统架构) |+| 核心角色 | [跳转](#核心角色) |+| 快速开始 | [跳转](#快速开始) |+| 更多示例 | [跳转](#更多示例) |+| 设计风格 | [跳转](#设计风格) |+| 技术规范 | [跳转](#技术规范) |+| 项目结构 | [跳转](#项目结构) |+| 最佳实践 | [跳转](#最佳实践) |+| 常见问题 | [跳转](#常见问题) |+| 贡献指南 | [跳转](#贡献指南) |+| 路线图 | [跳转](#路线图) |+| 🛠️ 工具集 | [跳转](#️-工具集) |+| 📄 开源协议 | [跳转](#-开源协议) |+| 🙏 致谢 | [跳转](#-致谢) |+| 📮 联系方式 | [跳转](#-联系方式) |</details>@@ -173,14 +173,22 @@ PPT Master 是一个创新的 AI 辅助视觉内容创作系统,通过多角↓[Strategist] 策略师 - 八项确认与设计规范│- ├─ 图片方式包含「AI 生成」?+ ├─ 模板选项(三选一)│ │- │ YES → [Image_Generator] 图片生成师 - AI 图片生成 → 图片归集到 images/- │ │- │ NO ───────────────────────────────────────────────────┐+ │ A) 使用已有模板 → 复制到项目 templates/+ │ B) 生成新模板 → [Template_Designer] 模板设计师+ │ C) 不使用模板 → 直接进入下一阶段+ │ │+ ├─────────────────────────────────────────────────────────────┤+ │ │+ ├─ 图片方式包含「AI 生成」? │+ │ │ │+ │ YES → [Image_Generator] 图片生成师 → 图片归集到 images/│+ │ │ │+ │ NO ───────────────────────────────────────────────────┤│ │▼ ▼-[Executor_General / Executor_Consultant / Executor_Consultant_Top] 执行师 - SVG代码生成+[Executor] 执行师(根据模板选项决定是否遵循模板)- SVG代码生成↓[Optimizer_CRAP] 优化师 - 视觉优化(可选)↓@@ -191,7 +199,11 @@ SVG 文件 (svg_output/)└── svg_to_pptx.py → output.pptx(导出 PowerPoint + 嵌入演讲者备注)```-> **注意**: 源内容转换是强制触发的,识别到 PDF/URL 后必须立即调用工具。Image_Generator 是串行环节,图片归集完成后才进入 Executor 阶段。+> **注意**:+>+> - 源内容转换是强制触发的,识别到 PDF/URL 后必须立即调用工具+> - 模板阶段是可选的,用户可选择使用已有模板、生成新模板或不使用模板+> - Image_Generator 是串行环节,图片归集完成后才进入 Executor 阶段### 完整工作流程图@@ -211,10 +223,10 @@ graph TDsubgraph Preparation [准备阶段 Resources Prep]PDFConvert -- 原生 PDF --> PyMuPDF[pdf_to_md.py 本地转换]:::toolPDFConvert -- 扫描版/复杂排版 --> Mineru[MinerU 云端 AI 转换]:::tool-+PyMuPDF -- 提取文本与结构 --> MD([基础 Markdown 文档]):::artifactMineru -- 提取文本与结构 --> MD-+%% 图片处理流程subgraph ImageFlow [图片资源]LocalImgs(必须包含的图片文件) --> ImgFolder[存入 images/ 文件夹]:::userAction@@ -235,14 +247,14 @@ graph TD%% 规划阶段subgraph Planning [规划阶段 Content & Design]Strategist[Role 1 策略师: 内容与规范]:::role-+%% 交互确认Strategist -.-> Confirm1[交互确认: 七项关键要素]:::userActionConfirm1 -- 确认范围 --> Strategist-+%% 提示note1>确认: 图片路径/图标需求/风格] -.-> Confirm1-+Strategist --> SpecDoc([设计规范与内容大纲]):::artifactend@@ -262,11 +274,11 @@ graph TDSelectStyle -- 通用灵活 --> ExecGen[Role 3 通用执行师]:::roleSelectStyle -- 一般咨询 --> ExecCon[Role 4 咨询执行师]:::roleSelectStyle -- 顶级咨询 --> ExecTop[Role 4+ 顶级咨询执行师]:::role-+ExecGen --> GenerateLoopExecCon --> GenerateLoopExecTop --> GenerateLoop-+GenerateLoop[逐页生成 SVG]:::userActionend@@ -277,9 +289,9 @@ graph TDCheckQA -- 是 --> Optimizer[Role 5 CRAP 优化师]:::roleOptimizer --> OptimizedSVG([优化后的 SVG]):::artifactOptimizedSVG --> CheckQA-+CheckQA -- 否 --> RawOutput[SVG 文件 svg_output/]:::artifact-+RawOutput --> ToolFinal[finalize_svg.py 最终化处理]:::toolToolFinal -- 嵌入 images 和 icons --> FinalSVG[最终 SVG svg_final/]:::artifactFinalSVG --> ToolPPT[svg_to_pptx.py PPTX 转换]:::tool@@ -400,19 +412,16 @@ graph TD**四大核心原则**:1. **对齐 (Alignment)**:-- 检查并修正元素对齐关系- 创建强大的无形视觉连接线- 确保每个元素都与其他元素有明确对齐关系2. **对比 (Contrast)**:-- 增强视觉层次,突出重点信息- 加大尺寸、字重或颜色差异- 创造清晰的视觉焦点3. **重复 (Repetition)**:-- 统一同类元素的视觉风格- 重复使用颜色、字体、圆角等视觉元素- 创造组织性和统一性@@ -428,21 +437,20 @@ graph TD### 基本工作流-1. **准备源文档**-+1. **准备源文档**+将原始参考资料转换为 AI 可读格式:-- | 步骤 | 说明 |- |------|------|++ | 步骤 | 说明 |+ | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- || 📄 **文档转换** | **优先使用** `python3 tools/pdf_to_md.py <PDF文件>` 进行本地转换(快速、免费、隐私安全)。如遇扫描版 PDF、复杂多栏排版或数学公式,改用 [MinerU](https://github.com/opendatalab/MinerU) 云端 AI 转换 |- | 🖼️ **图片资源** | 将必须包含的图片存入项目的 `images/` 文件夹,并在 Markdown 中添加图片描述说明 |- | 🔣 **图标资源** | 如需自定义图标,可从 [SVG Repo](https://www.svgrepo.com/) 下载,或使用项目内置的 640+ 图标库(`templates/icons/`) |-+ | 🖼️ **图片资源** | 将必须包含的图片存入项目的 `images/` 文件夹,并在 Markdown 中添加图片描述说明 |+ | 🔣 **图标资源** | 如需自定义图标,可从 [SVG Repo](https://www.svgrepo.com/) 下载,或使用项目内置的 640+ 图标库(`templates/icons/`) |+> 💡 **PDF 转换策略**: PyMuPDF 优先(本地秒级),MinerU 兜底(云端 AI)。详见 [工具使用指南](./tools/README.md)2. **初始沟通(八项确认)**与 Strategist 进行范围确认,Strategist 会对以下八项给出专业建议:-1. **画布格式**: PPT/小红书/朋友圈/Story 等(基于使用场景推荐)2. **页数范围**: 基于内容量分析建议合理页数3. **目标受众与场景**: 基于文档特征预判@@ -467,6 +475,7 @@ graph TD使用 Optimizer_CRAP 进行 CRAP 原则优化6. **后处理**(推荐)+```bashpython3 tools/finalize_svg.py <项目路径> # 执行全部后处理```@@ -574,11 +583,11 @@ Optimizer_CRAP:为确保导出 PPT 后效果一致,透明度必须使用标准写法:-| ❌ 禁止 | ✅ 正确 |-|--------|--------|-| `fill="rgba(255,255,255,0.1)"` | `fill="#FFFFFF" fill-opacity="0.1"` |-| `<g opacity="0.2">...</g>` | 每个子元素单独设置透明度 |-| `<image opacity="0.3"/>` | 图片后加遮罩层 `<rect fill="背景色" opacity="0.7"/>` |+| ❌ 禁止 | ✅ 正确 |+| ------------------------------ | ---------------------------------------------------- |+| `fill="rgba(255,255,255,0.1)"` | `fill="#FFFFFF" fill-opacity="0.1"` |+| `<g opacity="0.2">...</g>` | 每个子元素单独设置透明度 |+| `<image opacity="0.3"/>` | 图片后加遮罩层 `<rect fill="背景色" opacity="0.7"/>` |> 📌 **记忆口诀**:PPT 不认 rgba、不认组透明、不认图片透明@@ -753,6 +762,7 @@ projects/```**重要命名规则**:+- 项目文件夹名称格式: `{项目名称}_{format}_{YYYYMMDD}`- format: `ppt169`, `ppt43`, `wechat`, `xiaohongshu`, `story` 等- 日期使用8位数字格式,例如 `20251116` 代表 2025年11月16日@@ -921,6 +931,7 @@ python3 tools/finalize_svg.py <项目路径>```**处理步骤**:+1. 嵌入图标 - 替换 `<use data-icon="..."/>` 为实际图标2. 修复图片宽高比 - 防止 PPT 转形状时图片拉伸变形 ✨3. 嵌入图片 - 将外部图片转为 Base64@@ -983,7 +994,7 @@ python3 tools/error_helper.py missing_readme感谢以下开源项目:- [SVG Repo](https://www.svgrepo.com/) - 精美的开源图标库(本项目内置 640+ 图标)-- [Robin Williams](https://en.wikipedia.org/wiki/Robin_Williams_(author)) - CRAP 设计原则的提出者+- [Robin Williams](<https://en.wikipedia.org/wiki/Robin_Williams_(author)>) - CRAP 设计原则的提出者- 麦肯锡、波士顿咨询、贝恩等顶尖咨询公司 - 设计灵感来源## 📮 联系方式diff --git a/README_EN.md b/README_EN.mdindex 4d88ebc0..7b2d089d 100644--- a/README_EN.md+++ b/README_EN.md@@ -290,7 +290,7 @@ graph TD## Roles-> The system includes 6 professional roles: 1 Strategist + 1 Image Generator (conditionally triggered) + 3 Executor variants + 1 Optimizer+> The system includes 7 professional roles: 1 Strategist + 1 Template Designer (optional) + 1 Image Generator (conditionally triggered) + 3 Executor variants + 1 Optimizer### 1️⃣ Strategist@@ -310,6 +310,7 @@ graph TD6. 🔣 **Icon Method**: A) Emoji B) AI Generated C) Built-in Icon Library D) Custom Path7. 🖼️ **Image Usage**: A) No images B) User provided C) AI Generated D) Placeholder reserved8. 📝 **Typography**: Font combination (P1-P5 preset or custom) + body font size baseline (14-20pt)+- **Template Options**: Provide three template strategies (use existing template / generate new template / no template)- **Intelligent Deconstruction**: Break down and reorganize source documents into clear page sequences- **Color Scheme**: Propose complete color scheme (primary, secondary, base tones)- **Layout Planning**: Plan page sequences and recommend layout solutions@@ -321,7 +322,31 @@ graph TD📄 [View Complete Role Definition](./roles/Strategist.md)-### 2️⃣ Image_Generator (Image Generator) - Conditionally Triggered+### 2️⃣ Template_Designer (Template Designer) - Optional++**Responsibility**: Page template generation+**Output**: Page template SVG files++**Trigger Condition**: Only called when user selects "B) Generate New Template" in Strategist's template options++**Core Capabilities**:++- Generate 4 core templates based on design specifications (cover, chapter, content, ending)+- Optional: Generate table of contents template+- Use placeholder markers for replaceable content+- Ensure templates follow design specification's colors, fonts, and layout+- Templates define visual consistency and structural pages, content area maintains maximum flexibility++**Input**: Design Specification and Content Outline++**Output**:+- 4 core template SVG files+- Optional: Table of contents template+- Saved to project `templates/` directory++📄 [View Complete Role Definition](./roles/Template_Designer.md)++### 3️⃣ Image_Generator (Image Generator) - Conditionally Triggered**Responsibility**: AI image generation (conditionally triggered)**Output**: Image files + optimized prompts@@ -346,7 +371,7 @@ graph TD📄 [View Complete Role Definition](./roles/Image_Generator.md)-### 3️⃣ Executor_General (General Executor)+### 4️⃣ Executor_General (General Executor)**Responsibility**: Generate SVG code in general flexible style**Output**: Single page SVG code@@ -366,7 +391,7 @@ graph TD📄 [View Complete Role Definition](./roles/Executor_General.md)-### 4️⃣ Executor_Consultant (General Consulting Executor)+### 5️⃣ Executor_Consultant (General Consulting Executor)**Responsibility**: Generate SVG code in general consulting style**Output**: Business-level presentation pages@@ -381,7 +406,7 @@ graph TD📄 [View Complete Role Definition](./roles/Executor_Consultant.md)-### 5️⃣ Executor_Consultant_Top (Top Consulting Executor)+### 6️⃣ Executor_Consultant_Top (Top Consulting Executor)**Responsibility**: Generate SVG code in top consulting style (MBB Level)**Output**: Strategic-level presentation pages@@ -400,7 +425,7 @@ graph TD📄 [View Complete Role Definition](./roles/Executor_Consultant_Top.md)-### 6️⃣ Optimizer_CRAP (CRAP Optimizer)+### 7️⃣ Optimizer_CRAP (CRAP Optimizer)**Responsibility**: Optimize design based on CRAP principles**Output**: Optimized SVG code (yh\_ prefix)diff --git a/docs/workflow_tutorial.md b/docs/workflow_tutorial.mdindex 037d5072..b3c8a030 100644--- a/docs/workflow_tutorial.md+++ b/docs/workflow_tutorial.md@@ -16,14 +16,15 @@在开始之前,确保你理解每个角色的职责:-| 角色 | 输入 | 输出 | 何时使用 | 支持格式 |-| --------------------------- | ------------ | ----------------- | -------------------------- | -------- |-| **Strategist** | 源文档 | 设计规范与大纲 | 项目开始时 | 所有格式 |-| **Image_Generator** | 图片资源清单 | 图片文件 + 提示词 | 选择 AI 生成图片时 | 所有格式 |-| **Executor_General** | 设计规范 | SVG 代码 | 通用风格项目 | 所有格式 |-| **Executor_Consultant** | 设计规范 | SVG 代码 | 一般咨询风格项目 | 所有格式 |-| **Executor_Consultant_Top** | 设计规范 | SVG 代码 | 顶级咨询风格项目(MBB 级) | 所有格式 |-| **Optimizer_CRAP** | SVG 代码 | 优化后的 SVG | 需要优化时 | 所有格式 |+| 角色 | 输入 | 输出 | 何时使用 | 支持格式 |+| --------------------------- | ------------ | ----------------- | ---------------------------- | -------- |+| **Strategist** | 源文档 | 设计规范与大纲 | 项目开始时 | 所有格式 |+| **Template_Designer** | 设计规范 | 页面模板 SVG | 选择「生成新模板」时(可选) | 所有格式 |+| **Image_Generator** | 图片资源清单 | 图片文件 + 提示词 | 选择 AI 生成图片时 | 所有格式 |+| **Executor_General** | 设计规范 | SVG 代码 | 通用风格项目 | 所有格式 |+| **Executor_Consultant** | 设计规范 | SVG 代码 | 一般咨询风格项目 | 所有格式 |+| **Executor_Consultant_Top** | 设计规范 | SVG 代码 | 顶级咨询风格项目(MBB 级) | 所有格式 |+| **Optimizer_CRAP** | SVG 代码 | 优化后的 SVG | 需要优化时 | 所有格式 |### 角色协作流程图@@ -83,6 +84,16 @@│ 保存设计规范到项目文件夹 │└────────────┬───────────┘│+ ▼+┌─────────────────────────────────────────────────────────────────────────────┐+│ 阶段 1.5: 模板选项 (三选一) │+│ ┌──────────────────────────────────────────────────────────────────────┐ │+│ │ A) 使用已有模板 → 复制到项目 templates/ 目录 │ │+│ │ B) 生成新模板 → Template_Designer 生成模板 → 用户确认 │ │+│ │ C) 不使用模板 → 直接进入下一阶段 │ │+│ └──────────────────────────────────────────────────────────────────────┘ │+└─────────────────────────────────────────────────────────────────────────────┘+ │┌────────────────┴────────────────┐│ 图片使用 = "C) AI 生成"? │▼ ▼@@ -92,7 +103,7 @@│ ││ ▼│ ┌─────────────────────────────────────────┐- │ │ 阶段 1.5: 图片生成 (条件触发) │+ │ │ 阶段 1.6: 图片生成 (条件触发) ││ │ ┌─────────────────────────────────┐ ││ │ │ Image_Generator │ ││ │ │ (图片生成师) │ │diff --git a/roles/README.md b/roles/README.mdindex e9f2e7af..cdf47a3c 100644--- a/roles/README.md+++ b/roles/README.md@@ -4,14 +4,15 @@## 角色概览-| 角色 | 文件 | 主要职责 | 输入 | 输出 | 支持格式 |-| --------------- | -------------------------------------------------- | -------------------- | -------- | ------------------ | -------- |-| **策略师** | [Strategist.md](./Strategist.md) | 内容分析与设计规划 | 源文档 | 设计规范与内容大纲 | 所有格式 |-| **图片生成师** | [Image_Generator.md](./Image_Generator.md) | AI 图片生成(条件触发) | 图片资源清单 | 图片文件 + 提示词 | 所有格式 |-| **通用执行师** | [Executor_General.md](./Executor_General.md) | 生成通用灵活风格 SVG | 设计规范 | SVG 代码 | 所有格式 |-| **咨询执行师** | [Executor_Consultant.md](./Executor_Consultant.md) | 生成一般咨询风格 SVG | 设计规范 | SVG 代码 | 所有格式 |-| **顶级咨询执行师** | [Executor_Consultant_Top.md](./Executor_Consultant_Top.md) | 生成顶级咨询风格 SVG(MBB 级) | 设计规范 | SVG 代码 | 所有格式 |-| **CRAP 优化师** | [Optimizer_CRAP.md](./Optimizer_CRAP.md) | 基于 CRAP 原则优化 | SVG 代码 | 优化后的 SVG | 所有格式 |+| 角色 | 文件 | 主要职责 | 输入 | 输出 | 支持格式 |+| ------------------ | ---------------------------------------------------------- | ------------------------------ | ------------ | ------------------ | -------- |+| **策略师** | [Strategist.md](./Strategist.md) | 内容分析与设计规划 | 源文档 | 设计规范与内容大纲 | 所有格式 |+| **模板设计师** | [Template_Designer.md](./Template_Designer.md) | 页面模板生成(可选) | 设计规范 | 页面模板 SVG | 所有格式 |+| **图片生成师** | [Image_Generator.md](./Image_Generator.md) | AI 图片生成(条件触发) | 图片资源清单 | 图片文件 + 提示词 | 所有格式 |+| **通用执行师** | [Executor_General.md](./Executor_General.md) | 生成通用灵活风格 SVG | 设计规范 | SVG 代码 | 所有格式 |+| **咨询执行师** | [Executor_Consultant.md](./Executor_Consultant.md) | 生成一般咨询风格 SVG | 设计规范 | SVG 代码 | 所有格式 |+| **顶级咨询执行师** | [Executor_Consultant_Top.md](./Executor_Consultant_Top.md) | 生成顶级咨询风格 SVG(MBB 级) | 设计规范 | SVG 代码 | 所有格式 |+| **CRAP 优化师** | [Optimizer_CRAP.md](./Optimizer_CRAP.md) | 基于 CRAP 原则优化 | SVG 代码 | 优化后的 SVG | 所有格式 |### 支持的画布格式@@ -25,18 +26,26 @@```用户输入文档↓-[Strategist] 策略师+[策略师 Strategist]↓ 生成《设计规范与内容大纲》↓- ├─ 图片方式包含「C) AI 生成」?+ ├─ 模板选项(三选一)│ │- │ YES → [Image_Generator] 图片生成师- │ ↓ 生成图片到 images/- │ │- │ NO ─────────────────────────────────┐+ │ A) 使用已有模板 → 复制到项目 templates/+ │ B) 生成新模板 → [Template_Designer] 模板设计师+ │ C) 不使用模板 → 直接进入下一阶段+ │ │+ ├───────────────────────────────────────────┤+ │ │+ ├─ 图片方式包含「C) AI 生成」? │+ │ │ │+ │ YES → [Image_Generator] 图片生成师 │+ │ ↓ 生成图片到 images/ │+ │ │ │+ │ NO ─────────────────────────────────┤│ │▼ ▼-[Executor_General / Executor_Consultant / Executor_Consultant_Top] 执行师+[Executor] 执行师(根据模板选项决定是否遵循模板)↓ 逐页生成SVG代码↓[Optimizer_CRAP] 优化师 (可选)@@ -49,7 +58,10 @@ SVG 文件 (svg_output/)└── svg_to_pptx.py → output.pptx (导出 PowerPoint)```-> **注意**: Image_Generator 是串行环节,仅当图片方式**包含**「AI 生成」时触发,图片归集完成后才进入 Executor 阶段。+> **注意**:+>+> - 模板阶段是可选的,用户可选择使用已有模板、生成新模板或不使用模板+> - Image_Generator 是串行环节,仅当图片方式**包含**「AI 生成」时触发,图片归集完成后才进入 Executor 阶段## 角色详解@@ -74,6 +86,7 @@ SVG 文件 (svg_output/)**核心能力**:- **初始沟通**: 完成八项确认(画布格式、页数、受众场景、风格、配色、图标、图片、排版)+- **模板选项**: 提供三种模板策略(使用已有模板 / 生成新模板 / 不使用模板)- 智能解构源文档内容- 确定设计风格(通用灵活 / 一般咨询 / 顶级咨询)- 制定完整的色彩方案@@ -86,7 +99,32 @@ SVG 文件 (svg_output/)----### 1️⃣+ Image_Generator (图片生成师)+### 1️⃣+ Template_Designer (模板设计师)++**何时使用**: 用户选择「B) 生成新模板」时++**触发条件**: 可选角色,仅当用户需要生成新模板时调用++**核心能力**:++- 根据设计规范生成 4 个核心模板(封面、章节页、内容页、结束页)+- 可选生成目录页模板+- 使用占位符标记可替换内容+- 确保模板遵循设计规范的配色、字体、布局++**输入**: 《设计规范与内容大纲》++**输出**:++- 4 个核心模板 SVG 文件+- 可选:目录页模板+- 保存到项目 `templates/` 目录++📄 [查看完整定义](./Template_Designer.md)++---++### 1️⃣++ Image_Generator (图片生成师)**何时使用**: Strategist 初次沟通中用户选择的图片方式**包含**「C) AI 生成」时(如 C、B+C、C+D)@@ -103,11 +141,13 @@ SVG 文件 (svg_output/)**输入**: 设计规范(含图片资源清单)**输出**:+- 优化后的图片提示词- 生成的图片文件- 更新后的图片资源清单**工作流位置**:+```Strategist → Image_Generator → Executor↑ ↑@@ -213,27 +253,27 @@ Strategist → Image_Generator → Executor### 按 PPT 类型选择-| PPT 类型 | 推荐角色 | 说明 |-|----------|----------|------|-| **商业咨询报告** | Executor_Consultant_Top | MBB 级风格,数据情境化,金字塔原则 |-| **财务分析/数据报告** | Executor_Consultant_Top | 专业图表,严谨配色,结论先行 |-| **工作进展汇报** | Executor_Consultant | 简洁清晰,数据可视化为主 |-| **政府工作报告** | Executor_Consultant | 数据导向,逻辑层次分明 |-| **招商/文旅推介** | Executor_General(图文风格) | 全幅大图 + 渐变蒙版 + 文字叠加 |-| **企业品牌宣传** | Executor_General(图文风格) | 视觉冲击力强,图片为主角 |-| **产品发布/发布会** | Executor_General | 灵活布局,支持多种视觉风格 |-| **培训课件/教程** | Executor_General | 结构清晰,可搭配图表和图片 |-| **内部团队分享** | Executor_General | 快速生成,风格灵活 |+| PPT 类型 | 推荐角色 | 说明 |+| --------------------- | ---------------------------- | ---------------------------------- |+| **商业咨询报告** | Executor_Consultant_Top | MBB 级风格,数据情境化,金字塔原则 |+| **财务分析/数据报告** | Executor_Consultant_Top | 专业图表,严谨配色,结论先行 |+| **工作进展汇报** | Executor_Consultant | 简洁清晰,数据可视化为主 |+| **政府工作报告** | Executor_Consultant | 数据导向,逻辑层次分明 |+| **招商/文旅推介** | Executor_General(图文风格) | 全幅大图 + 渐变蒙版 + 文字叠加 |+| **企业品牌宣传** | Executor_General(图文风格) | 视觉冲击力强,图片为主角 |+| **产品发布/发布会** | Executor_General | 灵活布局,支持多种视觉风格 |+| **培训课件/教程** | Executor_General | 结构清晰,可搭配图表和图片 |+| **内部团队分享** | Executor_General | 快速生成,风格灵活 |### 三个执行师核心特点对比-| 特点 | Executor_General | Executor_Consultant | Executor_Consultant_Top |-|------|------------------|---------------------|-------------------------|-| **定位** | 通用灵活 | 一般咨询 | 顶级咨询(MBB 级) |-| **视觉风格** | 视觉驱动,图文并重 | 数据驱动,简洁专业 | 数据驱动,高端克制 |-| **图片使用** | 可大量使用 | 以图表为主 | 以图表为主 |-| **典型布局** | 全幅大图/自由布局 | KPI 仪表盘/双栏对比 | 金字塔结构/MECE 分解 |-| **适合场景** | 宣传、展示、培训 | 汇报、分析、提案 | 战略、董事会、高管汇报 |+| 特点 | Executor_General | Executor_Consultant | Executor_Consultant_Top |+| ------------ | ------------------ | ------------------- | ----------------------- |+| **定位** | 通用灵活 | 一般咨询 | 顶级咨询(MBB 级) |+| **视觉风格** | 视觉驱动,图文并重 | 数据驱动,简洁专业 | 数据驱动,高端克制 |+| **图片使用** | 可大量使用 | 以图表为主 | 以图表为主 |+| **典型布局** | 全幅大图/自由布局 | KPI 仪表盘/双栏对比 | 金字塔结构/MECE 分解 |+| **适合场景** | 宣传、展示、培训 | 汇报、分析、提案 | 战略、董事会、高管汇报 |### Executor_General 风格变体@@ -243,12 +283,12 @@ Executor_General 支持多种风格变体,通过 **Strategist 生成的《设适用于视觉冲击力为主的宣传展示类 PPT。-| 设计要素 | 说明 |-|----------|------|-| **全幅背景图** | 铺满画布,作为视觉主体 |-| **渐变蒙版** | 左侧/底部/整体暗化,确保文字可读 |-| **文字叠加** | 在蒙版保护区域内布局标题和正文 |-| **高对比度** | 文字与背景对比度 ≥ 4.5:1 |+| 设计要素 | 说明 |+| -------------- | -------------------------------- |+| **全幅背景图** | 铺满画布,作为视觉主体 |+| **渐变蒙版** | 左侧/底部/整体暗化,确保文字可读 |+| **文字叠加** | 在蒙版保护区域内布局标题和正文 |+| **高对比度** | 文字与背景对比度 ≥ 4.5:1 |**典型应用**:文旅推介、招商宣传、企业形象、活动海报@@ -256,11 +296,11 @@ Executor_General 支持多种风格变体,通过 **Strategist 生成的《设适用于演讲型、产品发布类 PPT,借鉴 Apple / TED 风格。-| 设计要素 | 说明 |-|----------|------|-| **大留白** | 页面留白 ≥ 50%,让内容"呼吸" |-| **单点聚焦** | 每页只传达一个核心信息 |-| **极简配色** | 黑/白/灰 + 1 个强调色 |+| 设计要素 | 说明 |+| ------------ | ---------------------------- |+| **大留白** | 页面留白 ≥ 50%,让内容"呼吸" |+| **单点聚焦** | 每页只传达一个核心信息 |+| **极简配色** | 黑/白/灰 + 1 个强调色 || **超大标题** | 标题字号 72px+,正文精简或无 |**典型应用**:产品发布、演讲型 PPT、TED 风格分享@@ -269,12 +309,12 @@ Executor_General 支持多种风格变体,通过 **Strategist 生成的《设适用于需要打破常规、展现设计感的场景。-| 设计要素 | 说明 |-|----------|------|+| 设计要素 | 说明 |+| -------------- | ------------------------------ || **非对称布局** | 打破网格,使用斜线、不规则形状 |-| **大胆配色** | 高饱和度、渐变色、撞色组合 |-| **装饰元素** | 几何图形、线条、动态感元素 |-| **艺术字体** | 手写体、展示型字体 |+| **大胆配色** | 高饱和度、渐变色、撞色组合 |+| **装饰元素** | 几何图形、线条、动态感元素 |+| **艺术字体** | 手写体、展示型字体 |**典型应用**:广告提案、设计作品集、创意展示diff --git a/templates/layouts/README.md b/templates/layouts/README.mdindex d2f7dcf6..0f75edfe 100644--- a/templates/layouts/README.md+++ b/templates/layouts/README.md@@ -11,50 +11,51 @@ templates/layouts/└── consultant_top/ # 顶级咨询风格(MBB级)```-## 4 个核心模板+## 4 个核心模板 + 1 个可选模板每种风格包含 4 个核心模板,保持精简同时覆盖必要的结构性页面:-| 序号 | 文件名 | 用途 | 说明 |-|-----|--------|------|------|-| 01 | `01_cover.svg` | 封面 | 固定结构:标题、副标题、日期、机构 |-| 02 | `02_chapter.svg` | 章节页 | 固定结构:章节编号、章节标题 |-| 03 | `03_content.svg` | 内容页 | **灵活结构**:只定义页眉页脚,内容区由 AI 自由布局 |-| 04 | `04_ending.svg` | 结束页 | 固定结构:感谢语、联系方式 |+| 序号 | 文件名 | 用途 | 说明 |+| ---- | ---------------- | ------ | -------------------------------------------------- |+| 01 | `01_cover.svg` | 封面 | 固定结构:标题、副标题、日期、机构 |+| 02 | `02_chapter.svg` | 章节页 | 固定结构:章节编号、章节标题 |+| 03 | `03_content.svg` | 内容页 | **灵活结构**:只定义页眉页脚,内容区由 AI 自由布局 |+| 04 | `04_ending.svg` | 结束页 | 固定结构:感谢语、联系方式 |+| -- | `02_toc.svg` | 目录页 | **可选**:目录标题、章节列表 |> **设计理念**:模板定义视觉一致性和结构性页面,内容页保持最大灵活性,让 AI 根据实际内容决定布局。## 风格特点-| 风格 | 配色 | 特点 |-|------|------|------|-| **general** | 深蓝渐变 + 靛蓝紫 | 现代简洁,适合商业演示 |-| **consultant** | 深蓝 + 金色线 + 左侧装饰条 | 专业严谨,咨询报告风格 |+| 风格 | 配色 | 特点 |+| ------------------ | -------------------------- | ---------------------------- |+| **general** | 深蓝渐变 + 靛蓝紫 | 现代简洁,适合商业演示 |+| **consultant** | 深蓝 + 金色线 + 左侧装饰条 | 专业严谨,咨询报告风格 || **consultant_top** | 渐变顶条 + 网格 + 金色点缀 | MBB级,核心观点区 + 机密标识 |## 占位符规范模板中使用以下占位符标记可替换内容:-| 占位符 | 用途 | 适用模板 |-|-------|------|---------|-| `{{TITLE}}` | 主标题 | 封面 |-| `{{SUBTITLE}}` | 副标题 | 封面 |-| `{{DATE}}` | 日期 | 封面 |-| `{{AUTHOR}}` | 作者/机构 | 封面 |-| `{{CHAPTER_NUM}}` | 章节编号 | 章节页 |-| `{{CHAPTER_TITLE}}` | 章节标题 | 章节页 |-| `{{CHAPTER_DESC}}` | 章节描述 | 章节页 |-| `{{PAGE_TITLE}}` | 页面标题 | 内容页 |-| `{{KEY_MESSAGE}}` | 核心观点 | 内容页(咨询风格) |-| `{{CONTENT_AREA}}` | 内容区域 | 内容页 |-| `{{SECTION_NAME}}` | 章节名称 | 内容页页脚 |-| `{{SOURCE}}` | 数据来源 | 内容页页脚 |-| `{{PAGE_NUM}}` | 页码 | 内容页、结束页 |-| `{{THANK_YOU}}` | 感谢语 | 结束页 |-| `{{TAGLINE}}` | 口号/副标题 | 结束页 |-| `{{CONTACT_INFO}}` | 联系信息 | 结束页 |-| `{{COPYRIGHT}}` | 版权信息 | 结束页 |+| 占位符 | 用途 | 适用模板 |+| ------------------- | ----------- | ------------------ |+| `{{TITLE}}` | 主标题 | 封面 |+| `{{SUBTITLE}}` | 副标题 | 封面 |+| `{{DATE}}` | 日期 | 封面 |+| `{{AUTHOR}}` | 作者/机构 | 封面 |+| `{{CHAPTER_NUM}}` | 章节编号 | 章节页 |+| `{{CHAPTER_TITLE}}` | 章节标题 | 章节页 |+| `{{CHAPTER_DESC}}` | 章节描述 | 章节页 |+| `{{PAGE_TITLE}}` | 页面标题 | 内容页 |+| `{{KEY_MESSAGE}}` | 核心观点 | 内容页(咨询风格) |+| `{{CONTENT_AREA}}` | 内容区域 | 内容页 |+| `{{SECTION_NAME}}` | 章节名称 | 内容页页脚 |+| `{{SOURCE}}` | 数据来源 | 内容页页脚 |+| `{{PAGE_NUM}}` | 页码 | 内容页、结束页 |+| `{{THANK_YOU}}` | 感谢语 | 结束页 |+| `{{TAGLINE}}` | 口号/副标题 | 结束页 |+| `{{CONTACT_INFO}}` | 联系信息 | 结束页 |+| `{{COPYRIGHT}}` | 版权信息 | 结束页 |## 使用方式