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

更新文档,新增SVG图片嵌入指南,调整工作流教程中的确认步骤为七项,更新README和其他文档以反映新内容和结构变化,增加图表模板数量至13种,修正链接和格式。

hugohe3f4c312a10235
diff --git a/AGENTS.md b/AGENTS.md
index e1367cda..a8fbf8b7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -113,6 +113,7 @@ project/
| **图标库** | `templates/icons/` (640+ 图标) |
| 设计指南 | `docs/design_guidelines.md` |
| 画布格式 | `docs/canvas_formats.md` |
+| 图片嵌入 | `docs/svg_image_embedding.md` |
| 工作流教程 | `docs/workflow_tutorial.md` |
| 快速参考 | `docs/quick_reference.md` |
| 示例项目 | `examples/` |
diff --git a/README.md b/README.md
index b08d1854..1e988bef 100644
--- a/README.md
+++ b/README.md
@@ -19,8 +19,9 @@
- [最佳实践](#最佳实践)
- [常见问题](#常见问题)
- [贡献指南](#贡献指南)
- - [许可证](#许可证)
- - [后处理工具](#后处理工具)
+- [路线图](#路线图)
+- [许可证](#许可证)
+- [工具集](#🛠️-工具集)
## 📚 文档导航
@@ -28,7 +29,8 @@
- 📖 **详细教程**: [工作流教程](./docs/workflow_tutorial.md)
- 🎨 **设计指南**: [设计规范详解](./docs/design_guidelines.md)
- 📐 **画布格式**: [支持的所有格式](./docs/canvas_formats.md)
-- 📊 **图表模板**: [标准化图表模板库](./templates/charts/) - 8种常用图表 · [在线预览](./templates/charts/preview.html)
+- 🖼️ **图片嵌入**: [SVG 图片嵌入指南](./docs/svg_image_embedding.md)
+- 📊 **图表模板**: [标准化图表模板库](./templates/charts/) - 13种常用图表 · [在线预览](./templates/charts/preview.html)
- ⚡ **快速查阅**: [快速参考指南](./docs/quick_reference.md)
- 🔧 **角色定义**: [查看所有角色](./roles/README.md)
- 🛠️ **工具集**: [工具使用指南](./tools/README.md)
@@ -73,13 +75,14 @@ PPT Master 是一个创新的 AI 辅助视觉内容创作系统,通过四个
**核心能力**:
-- **初始沟通**: 确认页数范围、目标受众、使用场合、设计风格、输出格式、配色方案
- - ⚡ **主动建议**: 不仅提出问题,还会基于源文档分析提供专业建议
- - 📊 **页数建议**: 根据内容量和复杂度建议合理的页数范围
- - 🎯 **受众判断**: 基于文档特征预判目标受众和使用场景
- - 🎨 **风格推荐**: 根据内容性质推荐最适合的设计风格并说明理由
- - 📐 **格式推荐**: 根据使用场景推荐最适合的画布格式(PPT/小红书/朋友圈等)
- - 🎨 **配色建议**: 给出主导色、辅助色、强调色的具体 HEX 色值并说明选色理由
+- **初始沟通(七项确认)**: 在分析内容前必须完成以下确认,并主动提供专业建议:
+ 1. 📐 **画布格式**: 根据使用场景推荐最适合的格式(PPT/小红书/朋友圈等)
+ 2. 📊 **页数范围**: 根据内容量和复杂度建议合理的页数范围
+ 3. 🎯 **目标受众与场景**: 基于文档特征预判目标受众和使用场景
+ 4. 🎨 **设计风格**: A) 通用灵活 B) 一般咨询 C) 顶级咨询(MBB级),给出推荐理由
+ 5. 🎨 **配色方案**: 给出主导色、辅助色、强调色的具体 HEX 色值
+ 6. 🔣 **图标方式**: A) Emoji B) AI生成 C) 内置图标库 D) 自定义路径
+ 7. 🖼️ **图片使用**: A) 不使用 B) 用户提供 C) AI生成 D) 占位符预留
- **智能解构**: 将源文档拆解并重组为清晰的页面序列
- **色彩方案**: 提出完整的配色方案(主导色、辅助色、基础色调)
- **布局规划**: 规划页面序列和推荐布局方案
@@ -183,14 +186,16 @@ PPT Master 是一个创新的 AI 辅助视觉内容创作系统,通过四个
1. **准备源文档**
准备好你的内容文档(文本、数据、要点等)
-2. **初始沟通(重要!)**
- 与 Strategist 进行范围确认,Strategist 会:
+2. **初始沟通(七项确认)**
+ 与 Strategist 进行范围确认,Strategist 会对以下七项给出专业建议:
- - 提问并**建议**期望的页面数量(基于内容量分析)
- - 提问并**判断**目标受众和使用场合(基于文档特征)
- - 提问并**推荐**设计风格:A) 通用灵活 B) 一般咨询 C) 顶级咨询(MBB 级)(基于内容性质和场景)
- - 提问并**推荐**画布格式:PPT/小红书/朋友圈/Story 等(基于使用场景)
- - 提问并**建议**配色方案:主导色、辅助色、强调色(提供具体 HEX 色值)
+ 1. **画布格式**: PPT/小红书/朋友圈/Story 等(基于使用场景推荐)
+ 2. **页数范围**: 基于内容量分析建议合理页数
+ 3. **目标受众与场景**: 基于文档特征预判
+ 4. **设计风格**: A) 通用灵活 B) 一般咨询 C) 顶级咨询(MBB 级)
+ 5. **配色方案**: 主导色、辅助色、强调色(提供具体 HEX 色值)
+ 6. **图标方式**: A) Emoji B) AI生成 C) 内置图标库 D) 自定义路径
+ 7. **图片使用**: A) 不使用 B) 用户提供 C) AI生成 D) 占位符预留
💡 Strategist 不仅会提出问题,还会主动提供专业建议供你参考或确认
@@ -208,37 +213,38 @@ PPT Master 是一个创新的 AI 辅助视觉内容创作系统,通过四个
```
用户: 我有一份市场分析报告需要制作成演示文稿
-Strategist: 在开始分析您的内容之前,我需要先确认几个关键信息:
+Strategist: 在开始分析您的内容之前,我需要先完成七项确认:
-a. 页数范围确认:您期望生成的演示文稿大约在多少页左右?
- [建议]: 根据您的报告内容量和数据密度,我建议生成 8-10 页,
- 这样可以确保每个核心议题都有充分的展示空间。
+1. 画布格式:[建议] PPT 16:9 (1280×720),适合商业演示场景
-b. 关键信息确认:目标受众是谁?将在什么场合使用?
- [建议]: 从报告的数据深度来看,这似乎是面向企业中高层管理者的
- 战略分析材料,适用于季度/年度战略会议。是否准确?
+2. 页数范围:[建议] 8-10 页,确保每个核心议题有充分展示空间
-c. 风格目标确认:采用 A) 通用灵活风格 还是 B) 高端咨询风格?
- [建议]: 考虑到目标受众和内容的专业性,我强烈建议选择
- B) 高端咨询风格,以体现数据驱动和专业权威感。
+3. 目标受众与场景:[建议] 面向企业中高层管理者的战略分析材料,
+ 适用于季度/年度战略会议
-d. 配色方案建议:
- [建议]: 基于高端咨询风格和市场分析主题,我建议采用:
+4. 设计风格:[建议] C) 顶级咨询风格(MBB 级),
+ 体现数据驱动和专业权威感
+
+5. 配色方案:[建议]
- 主导色: #005587 (麦肯锡蓝) - 专业、可信
- 辅助色: #E8E8E8 (浅灰) - 背景、留白
- 强调色: #FF6B35 (活力橙) - 数据高亮、重点标注
-用户: 同意你的建议,选择 B) 高端咨询风格,配色也采用你的建议
+6. 图标方式:[建议] C) 内置图标库,专业简洁
+
+7. 图片使用:[建议] A) 不使用图片,数据报告以图表为主
+
+用户: 同意你的建议
Strategist: [分析内容,生成完整的设计规范与内容大纲...]
用户: 规划很好!请生成第1页:封面
-Executor_Consultant: [生成第1页SVG代码...]
+Executor_Consultant_Top: [生成第1页SVG代码...]
用户: 请继续生成第2页
-Executor_Consultant: [生成第2页SVG代码...]
+Executor_Consultant_Top: [生成第2页SVG代码...]
用户: 第2页很重要,请使用CRAP原则优化视觉效果
@@ -344,32 +350,29 @@ ppt-master/
│ └── svg_output/
│
├── docs/ # 文档中心
+│ ├── canvas_formats.md # 画布格式规范
│ ├── design_guidelines.md # 详细设计指南(颜色、排版、布局)
+│ ├── svg_image_embedding.md # SVG 图片嵌入指南
│ ├── workflow_tutorial.md # 工作流教程(实际案例演示)
│ └── quick_reference.md # 快速参考指南(速查手册)
│
├── templates/ # 标准化模板库
-│ └── charts/ # 图表模板(KPI、柱状图、折线图、漏斗图等)
-│ ├── README.md # 图表模板使用说明
-│ ├── preview.html # 在线预览所有模板
-│ ├── kpi_cards.svg # KPI 卡片模板
-│ ├── bar_chart.svg # 柱状图模板
-│ ├── line_chart.svg # 折线图模板
-│ ├── donut_chart.svg # 环形图模板
-│ ├── funnel_chart.svg # 漏斗图模板
-│ ├── matrix_2x2.svg # 矩阵图模板
-│ ├── timeline.svg # 时间轴模板
-│ └── process_flow.svg # 流程图模板
+│ ├── charts/ # 图表模板(13种:KPI、柱状图、折线图等)
+│ │ ├── README.md # 图表模板使用说明
+│ │ ├── preview.html # 在线预览所有模板
+│ │ └── *.svg # 13个图表模板文件
+│ └── icons/ # 图标库(640+ 矢量图标)
+│ └── README.md # 图标库使用说明
│
├── tools/ # 实用工具
│ ├── README.md # 工具说明
│ ├── project_manager.py # 项目管理工具
-│ ├── project_utils.py # 项目工具公共模块
│ ├── svg_quality_checker.py # SVG 质量检查
│ ├── batch_validate.py # 批量验证工具
-│ ├── generate_examples_index.py # 索引生成
-│ ├── flatten_tspan.py # tspan扁平化工具
-│ └── error_helper.py # 错误消息助手
+│ ├── finalize_svg.py # 最终化处理(嵌入图标/图片)
+│ ├── embed_icons.py # 图标嵌入工具
+│ ├── embed_images.py # 图片嵌入工具
+│ └── flatten_tspan.py # tspan扁平化工具
│
└── projects/ # 用户项目工作区(进行中的项目)
└── <your_project_name>_<YYYYMMDD>/
@@ -541,7 +544,7 @@ A: 可以!在与 Strategist 沟通时,明确提出你的品牌色或偏好
- [x] 实现通用和咨询两种设计风格
- [x] 多格式画布支持(PPT 16:9/4:3、小红书、朋友圈、Story 等 10+ 格式)
- [x] 项目管理工具集(初始化、验证、质量检查、批量处理)
-- [x] 标准化图表模板库(8 种常用图表类型)
+- [x] 标准化图表模板库(13 种常用图表类型)
- [x] 640+ 矢量图标库(基于 Lucide Icons)
- [x] Strategist 主动建议功能(从被动提问升级为主动顾问)
diff --git a/docs/README.md b/docs/README.md
index f63d0feb..0a411571 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -6,9 +6,11 @@
- [design_guidelines.md](./design_guidelines.md) - 设计规范详解
- [workflow_tutorial.md](./workflow_tutorial.md) - 工作流教程
- [quick_reference.md](./quick_reference.md) - 快速参考指南
+- [svg_image_embedding.md](./svg_image_embedding.md) - SVG 图片嵌入指南
## 🔗 其他资源
- [角色定义](../roles/README.md)
- [图表模板](../templates/charts/README.md)
+- [图标库](../templates/icons/README.md)
- [工具说明](../tools/README.md)
diff --git a/docs/quick_reference.md b/docs/quick_reference.md
index ee9106a4..6dd51237 100644
--- a/docs/quick_reference.md
+++ b/docs/quick_reference.md
@@ -356,11 +356,11 @@ yh_slide_02_kpi_dashboard.svg
## 🔗 快速链接
- [完整文档](../README.md)
-- [工作流教程](../docs/workflow_tutorial.md)
-- [设计指南](../docs/design_guidelines.md)
+- [工作流教程](./workflow_tutorial.md)
+- [设计指南](./design_guidelines.md)
+- [画布格式](./canvas_formats.md)
- [角色定义](../roles/)
- [示例项目](../examples/)
-- [贡献指南](../CONTRIBUTING.md)
## 💡 专业提示
diff --git a/docs/svg_image_embedding.md b/docs/svg_image_embedding.md
new file mode 100644
index 00000000..fc85d3a0
--- /dev/null
+++ b/docs/svg_image_embedding.md
@@ -0,0 +1,337 @@
+# SVG 图片嵌入指南
+
+本文档介绍如何在 SVG 文件中添加图片。
+
+---
+
+## 完整工作流
+
+### 图片资源清单格式
+
+在《设计规范与内容大纲》中定义,每张图片标注**状态**:
+
+```markdown
+## 图片资源清单
+
+| 文件名 | 尺寸 | 用途 | 状态 | 生成描述 |
+|--------|------|------|------|----------|
+| cover_bg.png | 1280×720 | 封面背景 | 待生成 | 现代科技感抽象背景,深蓝渐变 |
+| product.png | 600×400 | 第3页 | 已有 | - |
+| team.png | 600×400 | 第5页 | 占位符 | 团队协作场景(后期补充) |
+```
+
+### 三种状态的处理
+
+| 状态 | 含义 | Executor 处理方式 |
+|------|------|-------------------|
+| **待生成** | 需 AI 生成,有描述 | 先生成图片放入 `images/`,再用 `<image>` 引用 |
+| **已有** | 用户已有图片 | 放入 `images/`,用 `<image>` 引用 |
+| **占位符** | 暂不处理 | 用虚线框占位,后期替换 |
+
+### 工作流程
+
+```
+1. Strategist 定义图片需求
+ └── 添加「图片资源清单」,标注每张图片状态
+
+2. 图片准备(状态:待生成/已有)
+ ├── 待生成:AI 工具生成 或 手动去平台生成
+ └── 已有:用户直接提供
+ └── 放入 项目/images/ 目录
+
+3. Executor 生成 SVG
+ ├── 已有/待生成 → <image href="images/xxx.png" .../>
+ └── 占位符 → 虚线框 + 描述文本
+
+4. 预览
+ └── python3 -m http.server 8000
+
+5. 导出(可选)
+ └── python3 tools/embed_images.py *.svg
+```
+
+---
+
+## 技术参考
+
+### 外部引用 vs Base64 内嵌
+
+| 方式 | 优点 | 缺点 | 适用场景 |
+|------|------|------|----------|
+| **外部引用** | 文件小、图片可单独更新 | 需要HTTP服务器 | 开发调试阶段 |
+| **Base64 内嵌** | 完全独立、可离线查看 | 文件体积大 | 分享导出阶段 |
+
+---
+
+## 方式一:外部引用(开发阶段推荐)
+
+### 语法
+
+```xml
+<image href="image.png" x="0" y="0" width="1280" height="720"
+ preserveAspectRatio="xMidYMid slice"/>
+```
+
+### 关键属性
+
+| 属性 | 说明 | 示例 |
+|------|------|------|
+| `href` | 图片路径(相对或绝对) | `"cover.png"` 或 `"./images/cover.png"` |
+| `x`, `y` | 图片左上角位置 | `x="0" y="0"` |
+| `width`, `height` | 图片显示尺寸 | `width="1280" height="720"` |
+| `preserveAspectRatio` | 缩放方式 | `"xMidYMid slice"` 居中裁剪 |
+
+### preserveAspectRatio 常用值
+
+| 值 | 效果 |
+|----|------|
+| `xMidYMid slice` | 居中显示,裁剪溢出部分(类似 CSS `cover`) |
+| `xMidYMid meet` | 居中显示,完整显示(类似 CSS `contain`) |
+| `none` | 拉伸填满,不保持比例 |
+
+### 预览方式
+
+由于浏览器安全限制,直接双击打开 SVG 无法加载外部图片。需要通过 HTTP 服务器访问:
+
+```bash
+# 启动本地服务器
+python3 -m http.server --directory <svg目录> 8000
+
+# 访问
+http://localhost:8000/your_file.svg
+```
+
+---
+
+## 方式二:Base64 内嵌(分享导出推荐)
+
+### 语法
+
+```xml
+<image href="data:image/png;base64,iVBORw0KGgo..." x="0" y="0" width="1280" height="720"/>
+```
+
+### 格式说明
+
+```
+data:<MIME类型>;base64,<Base64编码数据>
+```
+
+| MIME 类型 | 文件格式 |
+|-----------|----------|
+| `image/png` | PNG |
+| `image/jpeg` | JPG/JPEG |
+| `image/gif` | GIF |
+| `image/webp` | WebP |
+| `image/svg+xml` | SVG |
+
+---
+
+## 转换流程
+
+### 步骤 1:生成 Base64 编码
+
+**macOS / Linux:**
+
+```bash
+# 将图片转换为 Base64 并保存到文件
+base64 -i image.png -o image.b64
+
+# 或直接输出到终端
+base64 -i image.png
+```
+
+**Windows (PowerShell):**
+
+```powershell
+[Convert]::ToBase64String([IO.File]::ReadAllBytes("image.png")) > image.b64
+```
+
+### 步骤 2:嵌入 SVG
+
+**手动方式:**
+
+1. 打开 `.b64` 文件,复制全部内容
+2. 在 SVG 中替换 `href="image.png"` 为 `href="data:image/png;base64,<粘贴内容>"`
+
+**自动化脚本(推荐):**
+
+```python
+#!/usr/bin/env python3
+"""
+SVG 图片嵌入工具
+将 SVG 中引用的外部图片转换为 Base64 内嵌格式
+"""
+
+import os
+import base64
+import re
+import sys
+
+def get_mime_type(filename):
+ """根据文件扩展名返回 MIME 类型"""
+ ext = filename.lower().split('.')[-1]
+ mime_map = {
+ 'png': 'image/png',
+ 'jpg': 'image/jpeg',
+ 'jpeg': 'image/jpeg',
+ 'gif': 'image/gif',
+ 'webp': 'image/webp',
+ 'svg': 'image/svg+xml',
+ }
+ return mime_map.get(ext, 'application/octet-stream')
+
+def embed_images_in_svg(svg_path):
+ """将 SVG 文件中的外部图片转换为 Base64 内嵌"""
+ svg_dir = os.path.dirname(svg_path)
+
+ with open(svg_path, 'r', encoding='utf-8') as f:
+ content = f.read()
+
+ # 匹配 href="xxx.png" 或 href="xxx.jpg" 等
+ pattern = r'href="([^"]+\.(png|jpg|jpeg|gif|webp))"'
+
+ def replace_with_base64(match):
+ img_path = match.group(1)
+ full_path = os.path.join(svg_dir, img_path)
+
+ if not os.path.exists(full_path):
+ print(f"Warning: Image not found: {full_path}")
+ return match.group(0)
+
+ with open(full_path, 'rb') as img_file:
+ b64_data = base64.b64encode(img_file.read()).decode('utf-8')
+
+ mime_type = get_mime_type(img_path)
+ print(f"Embedded: {img_path} ({len(b64_data)} chars)")
+
+ return f'href="data:{mime_type};base64,{b64_data}"'
+
+ new_content = re.sub(pattern, replace_with_base64, content)
+
+ with open(svg_path, 'w', encoding='utf-8') as f:
+ f.write(new_content)
+
+ print(f"Updated: {svg_path}")
+
+if __name__ == '__main__':
+ if len(sys.argv) < 2:
+ print("Usage: python embed_images.py <svg_file> [svg_file2] ...")
+ sys.exit(1)
+
+ for svg_file in sys.argv[1:]:
+ if os.path.exists(svg_file):
+ embed_images_in_svg(svg_file)
+ else:
+ print(f"File not found: {svg_file}")
+```
+
+### 步骤 3:使用脚本
+
+```bash
+# 保存上述脚本为 embed_images.py,然后运行:
+python3 embed_images.py path/to/your_file.svg
+
+# 批量处理多个文件
+python3 embed_images.py *.svg
+```
+
+---
+
+## 完整工作流示例
+
+### 场景:制作包含图片的 PPT
+
+```
+1. 开发阶段
+ ├── 创建 SVG 文件,使用外部引用
+ │ <image href="cover.png" .../>
+ │
+ ├── 启动本地服务器预览
+ │ python3 -m http.server 8000
+ │
+ └── 调试修改,快速迭代
+
+2. 导出阶段
+ ├── 运行嵌入脚本
+ │ python3 embed_images.py *.svg
+ │
+ └── 得到独立的 SVG 文件,可直接分享
+```
+
+---
+
+## 最佳实践
+
+### 1. 图片优化
+
+在嵌入前优化图片大小,减少 SVG 文件体积:
+
+```bash
+# 使用 ImageMagick 压缩 PNG
+convert input.png -quality 85 -resize 1920x1080\> output.png
+
+# 使用 pngquant 压缩(推荐)
+pngquant --quality=65-80 input.png -o output.png
+```
+
+### 2. 文件组织
+
+```
+project/
+├── svg_output/
+│ ├── 01_cover.svg # 开发版(外部引用)
+│ ├── cover_bg.png # 图片资源
+│ └── ...
+└── svg_export/
+ └── 01_cover_embedded.svg # 导出版(Base64 内嵌)
+```
+
+### 3. clipPath 裁剪圆角
+
+如果需要给图片添加圆角:
+
+```xml
+<defs>
+ <clipPath id="roundedClip">
+ <rect x="60" y="110" width="540" height="380" rx="10" ry="10"/>
+ </clipPath>
+</defs>
+
+<image href="image.png" x="60" y="110" width="540" height="380"
+ clip-path="url(#roundedClip)"
+ preserveAspectRatio="xMidYMid slice"/>
+```
+
+---
+
+## 常见问题
+
+### Q: 直接打开 SVG 看不到图片?
+
+A: 浏览器安全策略阻止了本地文件的跨域请求。解决方案:
+- 使用 HTTP 服务器访问
+- 或将图片转换为 Base64 内嵌
+
+### Q: Base64 文件太大怎么办?
+
+A:
+1. 压缩原始图片
+2. 使用 JPEG 格式(比 PNG 更小)
+3. 降低图片分辨率(匹配实际显示尺寸即可)
+
+### Q: 如何反向提取 Base64 图片?
+
+A:
+```bash
+# 从 Base64 还原图片
+base64 -d image.b64 > image.png
+```
+
+---
+
+## 相关资源
+
+- [MDN: SVG image 元素](https://developer.mozilla.org/en-US/docs/Web/SVG/Element/image)
+- [MDN: Data URLs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs)
+- [SVG preserveAspectRatio 详解](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/preserveAspectRatio)
diff --git a/docs/workflow_tutorial.md b/docs/workflow_tutorial.md
index 07fab5ad..98abfdbb 100644
--- a/docs/workflow_tutorial.md
+++ b/docs/workflow_tutorial.md
@@ -198,49 +198,42 @@
⚠️ **重要**: 在开始内容分析之前,Strategist 必须首先完成初始沟通与范围确认。
-**Strategist 的首要问题:**
+**Strategist 的七项确认:**
```
-在开始分析您的内容之前,我需要先确认几个关键信息:
+在开始分析您的内容之前,我需要先完成七项确认:
-a. 画布格式确认:
- 请问您计划在什么场景下使用这些内容?
+1. 画布格式:
+ [建议] PPT 标准格式 (1280×720, 16:9),适合季度战略会议的投影展示。
- [Strategist 建议]: 根据您描述的季度战略会议场景,我建议使用
- **PPT 标准格式 (1280×720, 16:9)**,这是现代商业演示的主流格式,
- 适合大多数投影设备和显示器。
+2. 页数范围:
+ [建议] 8-10 页,确保每个核心议题有充分展示空间,同时保持演示紧凑。
-b. 页数范围确认:
- 根据您选择的格式和源文档,您期望生成多少页内容?
- (例如:5-7 页,10-15 页)这有助于我更好地把握内容的详略程度。
+3. 目标受众与场景:
+ [建议] 面向董事会和高管团队,季度战略会议汇报场景。
+ 核心信息聚焦:"Q3业绩稳健增长,Q4战略方向明确"。
- [Strategist 建议]: 根据您提供的内容结构,我建议生成 8-10 页左右,
- 这样可以确保每个核心议题都有充分的展示空间,同时保持演示的紧凑性。
+4. 设计风格:
+ [建议] C) 顶级咨询风格(MBB 级),体现专业性和权威感,
+ 适合高管层的战略分析演示。
-c. 关键信息确认:
- 除了文档本身,是否有任何我需要特别了解的背景信息?
- 例如,这次内容的目标受众是谁?将在什么场合使用?
- 您最希望受众记住的核心信息是什么?
+5. 配色方案:
+ [建议]
+ - 主导色: #0076A8 (德勤蓝) - 专业、可信
+ - 辅助色: #F5F5F5 (浅灰) - 背景、留白
+ - 强调色: #4CAF50 (成功绿) / #FF9800 (警示橙) - 数据标注
- [Strategist 建议]: 根据文档中包含的业绩数据和战略分析,我初步判断
- 这份演示可能面向企业中高层管理者,适用于季度/年度战略会议或董事会
- 汇报场景。是否准确?核心信息建议聚焦于"Q3业绩稳健增长,Q4战略方向明确"。
+6. 图标方式:
+ [建议] C) 内置图标库,专业简洁,与咨询风格匹配。
-d. 风格目标确认:
- 请问本次设计我们采用 A) 通用灵活风格 还是 B) 高端咨询风格?
-
- [Strategist 建议]: 考虑到本次演示面向高管层且包含大量战略分析数据,
- 我强烈建议选择 B) 高端咨询风格,以体现专业性和权威感。
+7. 图片使用:
+ [建议] A) 不使用图片,数据报告以图表和数据可视化为主。
```
**你的回应:**
```
-a. 同意使用 PPT 标准格式 (1280×720, 16:9)
-b. 期望 8-10 页左右
-c. 目标受众是公司董事会和高管团队,将在季度战略会议上使用。
- 核心信息是:Q3业绩稳健增长,Q4需要重点关注的战略方向。
-d. 选择 B) 高端咨询风格
+同意你的所有建议,开始生成设计规范。
```
**你的源文档内容:**
@@ -506,29 +499,35 @@ Optimizer_CRAP:
- 常见问题解答
- 推荐理由
-2. 与Strategist对话
+2. 与Strategist对话(七项确认)
你: 我需要为小红书创建一份产品使用技巧分享
- Strategist: 在开始之前,我需要确认几个关键信息:
+ Strategist: 在开始之前,我需要完成七项确认:
+
+ 1. 画布格式:[建议] 小红书帖子格式 (1242×1660, 3:4),
+ 竖屏比例最适合手机端浏览,符合小红书用户阅读习惯。
+
+ 2. 页数范围:[建议] 6-8 张,包括封面、逐个技巧展示、
+ 总结页,形成完整的图文轮播。
+
+ 3. 目标受众与场景:[建议] 小红书年轻用户的知识分享,
+ 采用轻松、易懂的表达方式,突出实用性。
- a. 画布格式确认:请问您计划在什么场景下使用这些内容?
- [建议]: 根据您描述的小红书知识分享场景,我建议使用
- **小红书帖子格式 (1242×1660, 3:4)**,这种竖屏比例最适合
- 手机端浏览,且符合小红书用户的阅读习惯。
+ 4. 设计风格:[建议] A) 通用灵活风格,
+ 更好地适应社交媒体的视觉需求。
- b. 页数范围确认:您期望生成多少张图片内容?
- [建议]: 根据5个使用技巧的内容量,我建议生成 6-8 张,
- 包括封面、逐个技巧展示、总结页,形成完整的图文轮播。
+ 5. 配色方案:[建议]
+ - 主导色: #FF6B6B (珊瑚红) - 活力、年轻
+ - 辅助色: #FFF5F5 (浅粉) - 温暖背景
+ - 强调色: #4ECDC4 (薄荷绿) - 点缀对比
- c. 关键信息确认:目标受众和使用场合?
- [建议]: 从内容来看,这是面向小红书年轻用户的知识分享,
- 建议采用轻松、易懂的表达方式,突出实用性。
+ 6. 图标方式:[建议] A) Emoji 表情,
+ 轻松活泼,符合小红书风格。
- d. 风格目标确认:A) 通用灵活 还是 B) 高端咨询?
- [建议]: 考虑到小红书平台的特性和用户偏好,建议选择
- A) 通用灵活风格,可以更好地适应社交媒体的视觉需求。
+ 7. 图片使用:[建议] D) 占位符预留,
+ 后期可添加产品实拍图。
- 你: 同意你的建议,小红书格式 + 通用灵活风格
+ 你: 同意你的建议,开始生成设计规范
3. 确认设计规范
Strategist: [输出规范,包含:
diff --git a/roles/README.md b/roles/README.md
index 2ae088b6..b250a575 100644
--- a/roles/README.md
+++ b/roles/README.md
@@ -43,18 +43,21 @@
**何时使用**: 项目开始时
**⚠️ 重要提醒**:
-在使用 Strategist 角色时,**务必首先进行初始沟通与范围确认**。这是工作流程的首要步骤,必须在内容分析之前完成:
+在使用 Strategist 角色时,**务必首先完成七项确认**。这是工作流程的首要步骤,必须在内容分析之前完成:
-- 📐 **画布格式确认**: Strategist 会根据使用场景推荐最适合的画布格式(PPT/小红书/朋友圈等)
-- 📋 **页数范围确认**: Strategist 会根据内容量建议合理的页数范围
-- 🎯 **关键信息确认**: Strategist 会基于文档特征判断目标受众和使用场景
-- 🎨 **风格目标确认**: Strategist 会推荐最适合的设计风格并说明理由
+1. 📐 **画布格式**: 根据使用场景推荐最适合的画布格式(PPT/小红书/朋友圈等)
+2. 📊 **页数范围**: 根据内容量建议合理的页数范围
+3. 🎯 **目标受众与场景**: 基于文档特征判断目标受众和使用场景
+4. 🎨 **设计风格**: 推荐最适合的设计风格(A 通用灵活 / B 一般咨询 / C 顶级咨询)
+5. 🎨 **配色方案**: 给出主导色、辅助色、强调色的 HEX 色值
+6. 🔣 **图标方式**: A) Emoji B) AI生成 C) 内置图标库 D) 自定义路径
+7. 🖼️ **图片使用**: A) 不使用 B) 用户提供 C) AI生成 D) 占位符预留
💡 **主动建议**: Strategist 不仅提出问题,还会提供专业建议供用户参考或确认
**核心能力**:
-- **初始沟通**: 确认并建议页数范围、目标受众、使用场合、设计风格
+- **初始沟通**: 完成七项确认(画布格式、页数、受众场景、风格、配色、图标、图片)
- 智能解构源文档内容
- 确定设计风格(通用灵活 / 一般咨询 / 顶级咨询)
- 制定完整的色彩方案
@@ -160,8 +163,9 @@
### 基本流程
-1. 从 **Strategist** 开始,**首先完成初始沟通与范围确认**
- - Strategist 会主动提供页数建议、受众判断、风格推荐与画布格式推荐
+1. 从 **Strategist** 开始,**首先完成七项确认**
+ - 画布格式、页数范围、目标受众与场景、设计风格、配色方案、图标方式、图片使用
+ - Strategist 会为每项主动提供专业建议
- 用户可以接受建议或提出调整
2. 让 Strategist 生成完整的设计规范与内容大纲
3. 根据确认的风格选择 **Executor_General** / **Executor_Consultant** / **Executor_Consultant_Top**
@@ -170,7 +174,7 @@
### 最佳实践
-- ⭐ **首要步骤**: 使用 Strategist 时,必须先完成初始沟通与范围确认
+- ⭐ **首要步骤**: 使用 Strategist 时,必须先完成七项确认
- 💡 **接受建议**: Strategist 会基于内容分析提供专业建议,认真考虑这些建议
- ✅ 充分与 Strategist 沟通,确保规范完整
- ✅ 每生成一页都验证效果
@@ -207,7 +211,7 @@
- [主 README](../README.md) - 项目整体介绍
- [设计指南](../docs/design_guidelines.md) - 详细设计规范
- [工作流教程](../docs/workflow_tutorial.md) - 实战案例教程
-- [贡献指南](../CONTRIBUTING.md) - 如何参与项目
+- [快速参考](../docs/quick_reference.md) - 速查手册
## 反馈与改进
diff --git a/roles/Strategist.md b/roles/Strategist.md
index 042622a1..f9280fb0 100644
--- a/roles/Strategist.md
+++ b/roles/Strategist.md
@@ -72,9 +72,11 @@
| 选项 | 方式 | 适用场景 |
|------|------|----------|
| **A** | 不使用图片 | 数据报告、流程说明 |
-| **B** | 需要配图 | 需要插图、背景、产品图等 |
+| **B** | 用户提供 | 有现成图片素材 |
+| **C** | AI 生成 | 需要定制插图、背景 |
+| **D** | 占位符预留 | 后期补充图片 |
-**选择 B 时**,在规范中添加「图片资源清单」,每张图片标注状态:
+**选择 B/C/D 时**,在规范中添加「图片资源清单」,每张图片标注状态:
```markdown
## 图片资源清单
diff --git a/templates/README.md b/templates/README.md
index 174126a2..21b429ca 100644
--- a/templates/README.md
+++ b/templates/README.md
@@ -2,16 +2,19 @@
## 📊 图表模板
-`charts/` 目录包含 8 种常用图表模板:
+`charts/` 目录包含 13 种常用图表模板:
- KPI 卡片
-- 柱状图
-- 折线图
+- 柱状图 / 堆叠柱状图
+- 折线图 / 双Y轴折线图
- 环形图
+- 雷达图
- 漏斗图
-- 矩阵图
+- 矩阵图 (2×2)
- 时间轴
+- 甘特图
- 流程图
+- 组织结构图
[查看图表模板说明](./charts/README.md)