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.mdindex 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 final5. **配色方案** - 给出主导色、辅助色、强调色的 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.mdindex 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 供参考。+**策略师职责**: 在模板基础上,结合**用户需求**、**内容特征**、**受众特点**进行专业判断和调整,而非机械套用。---\ndiff --git a/tools/project_manager.py b/tools/project_manager.pyindex 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)")# 检查 viewBoxself._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)")