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.mdindex 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.pyindex 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---