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

refactor: 模板框架化与八项确认流程优化

hugohe3f8a837917d21
diff --git a/AGENTS.md b/AGENTS.md
index e0ca3fab..816f2250 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -125,7 +125,7 @@ Optimizer_CRAP (可选优化)
```markdown
## ✅ Strategist 阶段完成
-- [x] 已完成八项确认(画布/页数/受众/风格/配色/图标/图片/字体)
+- [x] 已完成八项确认(画布/页数/受众/风格/配色/图标/图片/排版)
- [x] 已生成《设计规范与内容大纲》
- [x] 已创建项目文件夹:projects/<项目名>_<格式>_<日期>/
- [x] 设计规范已保存到项目文件夹
@@ -225,7 +225,7 @@ python3 tools/svg_to_pptx.py <项目路径> -s final
5. **配色方案** - 给出主导色、辅助色、强调色的 HEX 色值
6. **图标方式** - 四选一:A) Emoji B) AI 生成 C) 内置图标库 D) 自定义路径
7. **图片使用** - 四选一:A) 不使用 B) 用户提供 C) AI 生成 D) 占位符预留
-8. **字体方案** - 根据内容特征推荐字体组合(标题/正文/强调)
+8. **排版方案** - 字体组合(P1-P5 预设或自定义)+ 正文字号基准(14-20pt)
**策略师必须主动给出专业建议,而非仅提问。**
diff --git a/roles/Strategist.md b/roles/Strategist.md
index 827ad843..393b9211 100644
--- a/roles/Strategist.md
+++ b/roles/Strategist.md
@@ -36,6 +36,7 @@
- **一般咨询**:适合商务报告、项目汇报,基础咨询风格
- **顶级咨询**:适合战略报告、董事会演示、客户提案,采用 MBB 级专业技巧
+
### e. 配色方案建议
基于内容特征和行业属性,主动提供配色方案(HEX 色值)。
@@ -118,9 +119,11 @@
- **方图/竖图 (<1.2)**:应规划为 **"左右均分 (5:5)"** 或 **"侧边栏布局"**,利用垂直空间。
- **复杂图表特例**:对于架构图等细节丰富的图片,在匹配比例的前提下,**优先最大化绝对面积**(推荐 3:7 或 2:8 比例)。
-### h. 字体方案确认
+### h. 排版方案(字体 + 字号)
+
+**策略师根据内容特征推荐字体组合和字号基准**:
-**策略师根据内容特征主动推荐字体组合**:
+#### 字体预设
| 场景 | 推荐预设 | 标题 | 正文 | 强调 |
| -------------- | -------- | -------------- | ---------------- | ----------- |
@@ -130,38 +133,37 @@
| 传统稳重风格 | P4 | 宋体 | 微软雅黑/Arial | 宋体 |
| 英文为主 | P5 | Arial/Impact | Calibri/Georgia | Arial Black |
-**推荐格式**:
+#### 字号基准
-> 根据本文档的[行业/风格特征],建议采用 **P1 方案**(雅黑正文 + Arial 英文),
-> 现代简洁同时保持专业感。如需自定义,可分别指定各角色字体。
+以正文字号为基准 (1×),通过比例推导其他层级:
-**字体大类参考**(详见 `docs/design_guidelines.md`):
+- **14pt 基准**: 内容密集(咨询报告、数据分析)
+- **18-20pt 基准**: 内容宽松(演讲、培训、展示)
-- 中文:A=黑体系, B=宋体系, C=楷体系, D=标题黑, E=手写
-- 英文:F=无衬线, G=衬线, H=标题, I=手写, J=等宽
+| 用途 | 比例 | 14pt基准 | 18pt基准 |
+|------|------|----------|----------|
+| 封面标题 | 2.5-3× | 35-42pt | 45-54pt |
+| 内容标题 | 1.5-2× | 21-28pt | 27-36pt |
+| **正文** | **1×** | **14pt** | **18pt** |
+| 注释 | 0.75× | 11pt | 14pt |
-### i. 字号层级规范
+> 💡 **px ↔ pt 转换**: 1 pt = 1.333 px(96 DPI)。SVG 用 px,PPTX 用 pt。
+
+---
-**px ↔ pt 转换公式**(96 DPI 标准):
+## 🎯 模板灵活性原则
-| 换算 | 公式 |
-|------|------|
-| px → pt | `px × 0.75 = pt` |
-| pt → px | `pt × 1.333 = px` |
+> **核心理念**: 模板是起点,不是终点。
-**推荐字号层级**:
+`project_manager.py` 生成的《设计规范与内容大纲》模板提供的是**指导原则和参考框架**,Strategist 应根据具体项目需求进行调整:
-| 层级 | SVG (px) | PPT (pt) | 字重 | 用途 |
-|------|----------|----------|------|------|
-| H1 | 48px | 36pt | Bold | 封面标题 |
-| H2 | 36px | 27pt | Bold | 页面主标题 |
-| H3 | 28px | 21pt | SemiBold | 章节标题 |
-| H4 | 22px | 16.5pt | Medium | 卡片标题 |
-| Body | 18px | 13.5pt | Regular | 正文内容 |
-| Caption | 14px | 10.5pt | Regular | 说明、标注 |
-| Code | 16px | 12pt | Regular | 代码片段 |
+1. **比例系统可调**: 字号比例是参考值,可根据受众和场景微调
+2. **配色方案可定制**: 模板提供行业参考色,实际配色应结合品牌和内容特征
+3. **布局模式可组合**: 6 种基础布局可自由组合变化
+4. **内容结构可扩展**: 12 章节框架可增减,适应不同复杂度
+5. **间距/圆角等细节**: 由 Executor 根据内容密度自然调整
-> ⚠️ **重要**: SVG 中使用 px,导出 PPTX 时会自动按此比例转换为 pt。设计规范中应同时标注 px 和 pt 供参考。
+**策略师职责**: 在模板基础上,结合**用户需求**、**内容特征**、**受众特点**进行专业判断和调整,而非机械套用。
---\n
diff --git a/tools/project_manager.py b/tools/project_manager.py
index 70f12161..f68d0616 100644
--- a/tools/project_manager.py
+++ b/tools/project_manager.py
@@ -137,26 +137,38 @@ class ProjectManager:
### 配色方案
+> 请策略师根据项目内容、行业属性、品牌色彩确定具体色值
+
| 角色 | 色值 | 用途 |
|------|------|------|
-| **背景色** | `#FFFFFF` | 页面背景 |
-| **次背景** | `#F8FAFC` | 卡片背景、区块背景 |
+| **背景色** | `#[待定]` | 页面背景(亮色主题通常为白色系,深色主题为深灰/深蓝系) |
+| **次背景** | `#[待定]` | 卡片背景、区块背景 |
| **主导色** | `#[待定]` | 标题装饰、重点区块、图标 |
| **强调色** | `#[待定]` | 数据高亮、关键信息、链接 |
| **辅助强调** | `#[待定]` | 次要强调、渐变过渡 |
-| **正文文字** | `#1F2937` | 主要正文 |
-| **次要文字** | `#6B7280` | 说明文字、标注 |
-| **弱文字** | `#9CA3AF` | 辅助信息、页脚 |
-| **边框/分割** | `#E5E7EB` | 卡片边框、分割线 |
-| **成功色** | `#10B981` | 正向指标 |
-| **警示色** | `#EF4444` | 问题标注 |
-
-### 渐变方案(如需要)
-
-```
-主标题渐变: linear-gradient(135deg, #[主导色], #[辅助强调])
-强调渐变: linear-gradient(90deg, #[强调色], #[主导色])
-背景装饰: radial-gradient(circle at 80% 20%, rgba(主导色, 0.15), transparent 50%)
+| **正文文字** | `#[待定]` | 主要正文(深色主题用浅色文字) |
+| **次要文字** | `#[待定]` | 说明文字、标注 |
+| **弱文字** | `#[待定]` | 辅助信息、页脚 |
+| **边框/分割** | `#[待定]` | 卡片边框、分割线 |
+| **成功色** | `#[待定]` | 正向指标(绿色系) |
+| **警示色** | `#[待定]` | 问题标注(红色系) |
+
+> 💡 **参考**: 行业配色见 `roles/Strategist.md` 或 `tools/config.py` 中的 `INDUSTRY_COLORS`
+
+### 渐变方案(如需要,使用 SVG 语法)
+
+```xml
+<!-- 主标题渐变 -->
+<linearGradient id="titleGradient" x1="0%" y1="0%" x2="100%" y2="100%">
+ <stop offset="0%" stop-color="#[主导色]"/>
+ <stop offset="100%" stop-color="#[辅助强调]"/>
+</linearGradient>
+
+<!-- 背景装饰渐变(注意:禁止使用 rgba,用 stop-opacity) -->
+<radialGradient id="bgDecor" cx="80%" cy="20%" r="50%">
+ <stop offset="0%" stop-color="#[主导色]" stop-opacity="0.15"/>
+ <stop offset="100%" stop-color="#[主导色]" stop-opacity="0"/>
+</radialGradient>
```
---
@@ -165,30 +177,40 @@ class ProjectManager:
### 字体方案
-> 推荐预设说明:P1=现代商务科技 | P2=政务公文 | P3=文化艺术 | P4=传统稳重 | P5=英文为主
+> 请策略师根据内容特征选择字体预设,或自定义字体组合
+> 预设说明:P1=现代商务科技 | P2=政务公文 | P3=文化艺术 | P4=传统稳重 | P5=英文为主
+
+**推荐预设**: [待定,如 P1]
| 角色 | 中文 | 英文 | 备选 |
|------|------|------|------|
-| **标题** | 微软雅黑 | Arial | Helvetica |
-| **正文** | 微软雅黑 | Calibri | Arial |
+| **标题** | [待定] | [待定] | [待定] |
+| **正文** | [待定] | [待定] | [待定] |
| **代码** | - | Consolas | Monaco |
-| **强调** | 黑体 | Arial Black | Impact |
+| **强调** | [待定] | [待定] | [待定] |
-**字体栈**: `"PingFang SC", "Microsoft YaHei", system-ui, -apple-system, sans-serif`
+**字体栈**: `[待定,如 "PingFang SC", "Microsoft YaHei", system-ui, sans-serif]`
+
+> 💡 **参考**: 字体分类详见 `docs/design_guidelines.md`
### 字号层级
+> **设计原则**: 以正文字号为基准 (1×),通过比例关系推导其他层级
> **px ↔ pt 转换**: 1 pt = 1.333 px | 1 px = 0.75 pt(96 DPI 标准)
-| 层级 | px | pt | 字重 | 用途 |
-|------|-----|-----|------|------|
-| H1 | 48px | 36pt | Bold | 封面标题 |
-| H2 | 36px | 27pt | Bold | 页面主标题 |
-| H3 | 28px | 21pt | SemiBold | 章节标题 |
-| H4 | 22px | 16.5pt | Medium | 卡片标题 |
-| Body | 18px | 13.5pt | Regular | 正文内容 |
-| Caption | 14px | 10.5pt | Regular | 说明、标注 |
-| Code | 16px | 12pt | Regular | 代码片段 |
+**基准**: 正文字号 = [待定]pt(推荐 14-20pt,根据内容密度选择)
+
+| 用途 | 比例 | 示例 (18pt基准) | 示例 (14pt基准) | 字重 |
+|------|------|-----------------|-----------------|------|
+| 标题页(封面) | 2.5-3× | 45-54pt | 35-42pt | Bold |
+| 章节标题 | 2-2.5× | 36-45pt | 28-35pt | Bold |
+| 内容标题 | 1.5-2× | 27-36pt | 21-28pt | Bold |
+| 副标题/小标题 | 1.2-1.5× | 22-27pt | 17-21pt | SemiBold |
+| **正文内容** | **1×** | **18pt** | **14pt** | Regular |
+| 注释/备注 | 0.75-0.85× | 14-15pt | 11-12pt | Regular |
+| 页码/日期 | 0.55-0.65× | 10-12pt | 8-9pt | Regular |
+
+> 💡 **建议**: 内容密集(咨询报告)用 14pt 基准;内容宽松(演讲)用 18-20pt 基准
---
@@ -212,13 +234,15 @@ class ProjectManager:
### 间距规范
-| 元素 | 间距 |
-|------|------|
-| 卡片间距 | 24px |
-| 内容块间距 | 32px |
-| 卡片内边距 | 24px |
-| 卡片圆角 | 12px |
-| 图标与文字 | 12px |
+> 以下为参考值,策略师可根据项目需求调整
+
+| 元素 | 推荐范围 | 当前项目 |
+|------|----------|----------|
+| 卡片间距 | 20-32px | [待定] |
+| 内容块间距 | 24-40px | [待定] |
+| 卡片内边距 | 20-32px | [待定] |
+| 卡片圆角 | 8-16px | [待定] |
+| 图标与文字 | 8-16px | [待定] |
---
@@ -286,14 +310,16 @@ class ProjectManager:
### SVG 生成必须遵守:
1. viewBox: `{canvas_info['viewbox']}`
2. 背景使用 `<rect>` 元素
-3. 文本换行使用 `<tspan>`
-4. 透明度使用 `fill-opacity` / `stroke-opacity`,禁止 rgba()
-5. 禁止使用:clipPath、mask、filter、style、class、foreignObject
+3. 文本换行使用 `<tspan>`(禁止 `<foreignObject>`)
+4. 透明度使用 `fill-opacity` / `stroke-opacity`,禁止 `rgba()`
+5. 禁止使用:`clipPath`、`mask`、`filter`、`<style>`、`class`、`foreignObject`
+6. 禁止使用:`textPath`、`animate*`、`script`、`marker`/`marker-end`
+7. 箭头使用 `<polygon>` 三角形替代 `<marker>`
### PPT 兼容性规则:
-- 禁止组透明度 `<g opacity="...">`
-- 图片透明度使用遮罩层替代
-- 仅使用内联样式
+- 禁止 `<g opacity="...">`(组透明度),每个子元素单独设置
+- 图片透明度使用遮罩层替代(`<rect fill="背景色" opacity="0.x"/>`)
+- 仅使用内联样式,禁止外部 CSS 和 `@font-face`
---
@@ -371,18 +397,22 @@ class ProjectManager:
if len(svg_files) == 0:
warnings.append("svg_output 目录为空")
else:
- # 验证 SVG 文件命名
+ # 验证 SVG 文件命名(支持两种格式)
+ # 格式1: slide_01_name.svg(英文项目)
+ # 格式2: 01_封面.svg 或 P01_封面.svg(中文项目)
for svg_file in svg_files:
- if not re.match(r'^slide_\d+_\w+\.svg$', svg_file.name):
+ if not re.match(r'^(slide_\d+_\w+|P?\d+_.+)\.svg$', svg_file.name):
warnings.append(
- f"SVG 文件命名不规范: {svg_file.name} (建议: slide_XX_name.svg)")
+ f"SVG 文件命名不规范: {svg_file.name} (建议: 01_名称.svg 或 slide_01_name.svg)")
# 检查 viewBox
self._validate_svg_viewbox(svg_files, warnings)
- # 检查项目命名格式
+ # 检查项目命名格式(支持所有画布格式)
dir_name = project_path.name
- if not re.match(r'^.+_(ppt169|ppt43|wechat|xiaohongshu|story|moments|banner|a4)_\d{8}$', dir_name, re.IGNORECASE):
+ canvas_formats = '|'.join(self.CANVAS_FORMATS.keys())
+ pattern = rf'^.+_({canvas_formats})_\d{{8}}$'
+ if not re.match(pattern, dir_name, re.IGNORECASE):
warnings.append(
f"项目目录命名不规范: {dir_name} (建议: name_format_YYYYMMDD)")