Skip to content

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.md
index 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 TD
subgraph Preparation [准备阶段 Resources Prep]
PDFConvert -- 原生 PDF --> PyMuPDF[pdf_to_md.py 本地转换]:::tool
PDFConvert -- 扫描版/复杂排版 --> Mineru[MinerU 云端 AI 转换]:::tool
-
+
PyMuPDF -- 提取文本与结构 --> MD([基础 Markdown 文档]):::artifact
Mineru -- 提取文本与结构 --> MD
-
+
%% 图片处理流程
subgraph ImageFlow [图片资源]
LocalImgs(必须包含的图片文件) --> ImgFolder[存入 images/ 文件夹]:::userAction
@@ -235,14 +247,14 @@ graph TD
%% 规划阶段
subgraph Planning [规划阶段 Content & Design]
Strategist[Role 1 策略师: 内容与规范]:::role
-
+
%% 交互确认
Strategist -.-> Confirm1[交互确认: 七项关键要素]:::userAction
Confirm1 -- 确认范围 --> Strategist
-
+
%% 提示
note1>确认: 图片路径/图标需求/风格] -.-> Confirm1
-
+
Strategist --> SpecDoc([设计规范与内容大纲]):::artifact
end
@@ -262,11 +274,11 @@ graph TD
SelectStyle -- 通用灵活 --> ExecGen[Role 3 通用执行师]:::role
SelectStyle -- 一般咨询 --> ExecCon[Role 4 咨询执行师]:::role
SelectStyle -- 顶级咨询 --> ExecTop[Role 4+ 顶级咨询执行师]:::role
-
+
ExecGen --> GenerateLoop
ExecCon --> GenerateLoop
ExecTop --> GenerateLoop
-
+
GenerateLoop[逐页生成 SVG]:::userAction
end
@@ -277,9 +289,9 @@ graph TD
CheckQA -- 是 --> Optimizer[Role 5 CRAP 优化师]:::role
Optimizer --> OptimizedSVG([优化后的 SVG]):::artifact
OptimizedSVG --> CheckQA
-
+
CheckQA -- 否 --> RawOutput[SVG 文件 svg_output/]:::artifact
-
+
RawOutput --> ToolFinal[finalize_svg.py 最终化处理]:::tool
ToolFinal -- 嵌入 images 和 icons --> FinalSVG[最终 SVG svg_final/]:::artifact
FinalSVG --> 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. **后处理**(推荐)
+
```bash
python3 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.md
index 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 TD
6. 🔣 **Icon Method**: A) Emoji B) AI Generated C) Built-in Icon Library D) Custom Path
7. 🖼️ **Image Usage**: A) No images B) User provided C) AI Generated D) Placeholder reserved
8. 📝 **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.md
index 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.md
index 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.md
index 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}}` | 版权信息 | 结束页 |
## 使用方式