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

feat(template): 重构项目初始化模板,新增字号层级、布局模式、技术约束等章节

hugohe3ab07114d4500
diff --git a/roles/Strategist.md b/roles/Strategist.md
index af77c226..827ad843 100644
--- a/roles/Strategist.md
+++ b/roles/Strategist.md
@@ -140,6 +140,29 @@
- 中文:A=黑体系, B=宋体系, C=楷体系, D=标题黑, E=手写
- 英文:F=无衬线, G=衬线, H=标题, I=手写, J=等宽
+### i. 字号层级规范
+
+**px ↔ pt 转换公式**(96 DPI 标准):
+
+| 换算 | 公式 |
+|------|------|
+| px → pt | `px × 0.75 = pt` |
+| pt → px | `pt × 1.333 = px` |
+
+**推荐字号层级**:
+
+| 层级 | 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 | 代码片段 |
+
+> ⚠️ **重要**: SVG 中使用 px,导出 PPTX 时会自动按此比例转换为 pt。设计规范中应同时标注 px 和 pt 供参考。
+
---\n
## 2. 工作流程与交付物
@@ -168,6 +191,27 @@
**任务结束**: 输出与选定风格匹配的完整《设计规范与内容大纲》后完成。
+### 2.3 大纲输出规范
+
+输出的《设计规范与内容大纲》**必须包含以下 12 个章节**:
+
+| 章节 | 内容要求 |
+|------|----------|
+| **一、项目信息** | 项目名称、画布格式、页数、风格、受众、场景、日期 |
+| **二、画布规范** | 格式、尺寸、viewBox、边距、内容区域 |
+| **三、视觉主题** | 风格说明、亮/深主题、调性、配色方案(含色值表)、渐变方案 |
+| **四、排版体系** | 字体方案(推荐预设 P1-P5)、字号层级(H1-Code 7级) |
+| **五、布局原则** | 页面结构(页眉/内容/页脚区)、6种常用布局模式、间距规范 |
+| **六、图标使用规范** | 来源说明、占位符语法、推荐图标清单 |
+| **七、图片资源清单** | 文件名、尺寸、比例、用途、状态、生成描述(按需) |
+| **八、内容大纲** | 按章节分组,每页含布局、标题、内容要点 |
+| **九、演讲备注要求** | 文件命名规则、内容结构说明 |
+| **十、技术约束提醒** | SVG 生成规则、PPT 兼容性规则 |
+| **十一、设计检查清单** | 生成前/生成后检查项 |
+| **十二、下一步** | 明确后续流程(Image_Generator 或 Executor) |
+
+> 💡 **提示**: 项目初始化命令 `python3 tools/project_manager.py init` 会生成符合此规范的模板文件,策略师需在模板基础上填充具体内容。
+
---
## 3. 创建项目文件夹(必须执行)
diff --git a/tools/project_manager.py b/tools/project_manager.py
index c218b4df..70f12161 100644
--- a/tools/project_manager.py
+++ b/tools/project_manager.py
@@ -102,7 +102,7 @@ class ProjectManager:
# 创建设计规范与内容大纲
spec_content = f"""# {project_name} - 设计规范与内容大纲
-## [INFO] 项目信息
+## 一、项目信息
| 项目 | 内容 |
|------|------|
@@ -116,75 +116,156 @@ class ProjectManager:
---
-## [DESIGN] 设计规范
+## 二、画布规范
-### 1. 画布设置
+| 属性 | 值 |
+|------|-----|
+| **格式** | {canvas_info['name']} |
+| **尺寸** | {canvas_info['dimensions']} |
+| **viewBox** | `{canvas_info['viewbox']}` |
+| **边距** | 左右 60px,上下 50px |
+| **内容区域** | [根据画布计算] |
-- **尺寸**: {canvas_info['dimensions']}
-- **viewBox**: `{canvas_info['viewbox']}`
-- **安全边距**: 60px(四边)
-- **内容区域**: [根据画布计算]
+---
+
+## 三、视觉主题
+
+### 主题风格
+- **风格**: {design_style}
+- **主题**: [亮色主题 / 深色主题]
+- **调性**: [待填写,如:科技、专业、现代、创新]
-### 2. 配色方案
+### 配色方案
-| 用途 | 色值 | 说明 |
+| 角色 | 色值 | 用途 |
|------|------|------|
-| 背景色 | `#FFFFFF` | 页面主背景 |
-| 卡片背景 | `#F8FAFC` | 次级容器 |
-| 边框色 | `#E5E7EB` | 分隔线、边框 |
-| 主强调色 | `#[待定]` | 标题、重点强调 |
-| 次强调色 | `#[待定]` | 次要强调、图标 |
-| 成功色 | `#10B981` | 正向指标 |
-| 警示色 | `#EF4444` | 问题标注 |
-| 主文字 | `#1F2937` | 标题、重要文字 |
-| 次文字 | `#6B7280` | 正文、说明 |
-| 弱文字 | `#9CA3AF` | 辅助信息、页脚 |
-
-### 3. 字体规范
-
-| 层级 | 字号 | 字重 | 颜色 | 用途 |
-|------|------|------|------|------|
-| H1 | 36px | Bold | `#1F2937` | 页面主标题 |
-| H2 | 24px | SemiBold | `#1F2937` | 章节标题 |
-| H3 | 20px | SemiBold | `#1F2937` | 卡片标题 |
-| Body | 16px | Regular | `#6B7280` | 正文内容 |
-| Small | 14px | Regular | `#9CA3AF` | 说明文字、页脚 |
+| **背景色** | `#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%)
+```
+
+---
+
+## 四、排版体系
+
+### 字体方案
+
+> 推荐预设说明:P1=现代商务科技 | P2=政务公文 | P3=文化艺术 | P4=传统稳重 | P5=英文为主
+
+| 角色 | 中文 | 英文 | 备选 |
+|------|------|------|------|
+| **标题** | 微软雅黑 | Arial | Helvetica |
+| **正文** | 微软雅黑 | Calibri | Arial |
+| **代码** | - | Consolas | Monaco |
+| **强调** | 黑体 | Arial Black | Impact |
**字体栈**: `"PingFang SC", "Microsoft YaHei", system-ui, -apple-system, sans-serif`
-### 4. 布局规范
+### 字号层级
+
+> **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 | 代码片段 |
+
+---
+
+## 五、布局原则
+
+### 页面结构
+- **页眉区**: 顶部 50px,放置页码和章节标识
+- **内容区**: 中部主要内容区域
+- **页脚区**: 底部 50px,放置项目名称或装饰
+
+### 常用布局模式
+
+| 模式 | 适用场景 |
+|------|----------|
+| **单栏居中** | 封面、结语、重要观点 |
+| **左右分栏 (5:5)** | 对比、双概念 |
+| **左右分栏 (4:6)** | 图文混排 |
+| **上下分栏** | 流程、时间线 |
+| **三栏/四栏卡片** | 特性列表、角色介绍 |
+| **矩阵网格** | 对比分析、分类展示 |
-- **卡片间距**: 24px
-- **卡片圆角**: 12px
-- **卡片内边距**: 24px
-- **元素间距**: 16px(同组)、32px(跨组)
+### 间距规范
-### 5. 技术约束
+| 元素 | 间距 |
+|------|------|
+| 卡片间距 | 24px |
+| 内容块间距 | 32px |
+| 卡片内边距 | 24px |
+| 卡片圆角 | 12px |
+| 图标与文字 | 12px |
+
+---
+
+## 六、图标使用规范
+
+### 来源
+- **内置图标库**: `templates/icons/` (640+ 图标)
+- **使用方式**: 占位符格式 `{{{{icon:类别/图标名}}}}`
-- [OK] 使用 `<tspan>` 进行手动换行
-- [NO] 禁止使用 `<foreignObject>`
-- [OK] 背景使用 `<rect>` 元素
-- [OK] 遵循 CRAP 设计原则(对齐、对比、重复、亲密性)
+### 推荐图标清单(按需填写)
+
+| 用途 | 图标路径 | 页面 |
+|------|----------|------|
+| [示例] | `{{{{icon:interface/check-circle}}}}` | Slide XX |
---
-## [CONTENT] 内容大纲
+## 七、图片资源清单(如需要)
-### Slide 01 - 封面
-**核心信息**: [主题]
+| 文件名 | 尺寸 | 比例 | 用途 | 状态 | 生成描述 |
+|--------|------|------|------|------|----------|
+| cover_bg.png | {canvas_info['dimensions']} | [比例] | 封面背景 | [待生成/已有/占位符] | [AI生成提示词] |
-- 主标题
-- 副标题
-- 日期/作者信息
+**状态说明**:
+- **待生成** - 需要 AI 生成,提供详细描述
+- **已有** - 用户已有图片,直接放入 `images/`
+- **占位符** - 暂不处理,SVG 中用虚线框占位
---
-### Slide 02 - [页面名称]
-**核心信息**: [一句话概括]
+## 八、内容大纲
+
+### 第一部分:[章节名称]
-- [内容要点1]
-- [内容要点2]
-- [内容要点3]
+#### Slide 01 - 封面
+- **布局**: 全屏背景图 + 居中标题
+- **标题**: [主标题]
+- **副标题**: [副标题]
+- **信息**: [作者/日期/单位]
+
+#### Slide 02 - [页面名称]
+- **布局**: [选择布局模式]
+- **标题**: [页面标题]
+- **内容**:
+ - [要点1]
+ - [要点2]
+ - [要点3]
---
@@ -192,15 +273,31 @@ class ProjectManager:
---
-## [RESOURCE] 图片资源清单(如需要)
+## 九、演讲备注要求
-| 文件名 | 尺寸 | 用途 | 使用页面 | 状态 |
-|--------|------|------|----------|------|
-| cover_bg.png | {canvas_info['dimensions']} | 封面背景 | Slide 01 | [待生成] |
+每页生成对应的演讲备注文件,保存到 `notes/` 目录:
+- **文件命名**: 与 SVG 同名,如 `01_封面.md`
+- **内容包含**: 讲稿要点、时间提示、过渡语
---
-## [CHECK] 设计检查清单
+## 十、技术约束提醒
+
+### SVG 生成必须遵守:
+1. viewBox: `{canvas_info['viewbox']}`
+2. 背景使用 `<rect>` 元素
+3. 文本换行使用 `<tspan>`
+4. 透明度使用 `fill-opacity` / `stroke-opacity`,禁止 rgba()
+5. 禁止使用:clipPath、mask、filter、style、class、foreignObject
+
+### PPT 兼容性规则:
+- 禁止组透明度 `<g opacity="...">`
+- 图片透明度使用遮罩层替代
+- 仅使用内联样式
+
+---
+
+## 十一、设计检查清单
### 生成前
- [ ] 内容符合页面容量
@@ -215,6 +312,16 @@ class ProjectManager:
- [ ] 所有元素对齐到网格
- [ ] 相同元素保持一致样式
- [ ] 颜色符合规范
+- [ ] CRAP 四原则检查通过
+
+---
+
+## 十二、下一步
+
+1. ✅ 设计规范已完成
+2. **下一步**: [根据图片方式选择]
+ - 无 AI 图片 → 调用 **Executor** 角色生成 SVG
+ - 有 AI 图片 → 调用 **Image_Generator** 角色,完成后再调用 Executor
---