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: streamline skill architecture and remove redundant IDE adapters
hugohe3b24089617c59
diff --git a/.agent/skills/ocr_image_to_markdown/SKILL.md b/.agent/skills/ocr_image_to_markdown/SKILL.mddeleted file mode 100644index e650b1f6..00000000--- a/.agent/skills/ocr_image_to_markdown/SKILL.md+++ /dev/null@@ -1,47 +0,0 @@-----name: OCR Image to Markdown-description: 鉴于本地 OCR 工具的缺失,本技能利用 Agent 的多模态能力来查看图像(PNG, JPG 等)并将内容(文本、表格、逻辑图)转录为格式化的 Markdown。------# OCR 图像识别转 Markdown--本技能允许你“阅读”图片并将内容转换为可编辑的 Markdown 文本。这在提取数据表格、幻灯片内容或文档截图时特别有用,尤其是当无法使用外部 OCR 库时。--## 使用指南--1. **确认目标图片**:- * 定位你需要处理的图片文件。- * 如有需要,使用 `list_dir` 浏览目录。--2. **查看图片**:- * 使用 `view_file` 工具来“看”图片内容。系统允许你直接处理图像数据。- * **关键**: 你必须对图片路径使用 `view_file`,这样你的视觉模型才能消化它。--3. **转录内容**:- * 基于你所看到的,将文本转录为 Markdown。- * **表格**: 将视觉看到的表格转换为标准 Markdown 表格 (`| 表头 | ... |`)。- * **标题**: 使用 `#`, `##` 等来标记图片中的标题,保持层级结构。- * **文本**: 将段落转录为普通文本。- * **数字**: 仔细核对所有数字,特别是财务报表中的数据。--4. **保存输出**:- * 使用 `write_to_file` 将转录的内容写入 `.md` 文件(例如 `ocr_results.md`)。- * 如果处理多张图片,考虑将其追加到同一个文件中,或按逻辑组织。--## 最佳实践技巧--* **表格**: 仔细对齐行和列。标准 Markdown 表格不支持单元格合并(rowspan/colspan)。你需要根据逻辑流将合并的单元格展开,或者留空。-* **复杂布局**: 如果图片布局复杂(例如左右分栏),请按照逻辑阅读顺序(从上到下,从左到右)将其序列化。-* **图表/图形**: 如果图片包含图表,请描述趋势,或者将可见的数据点提取为列表或表格。-* **无需代码执行**: **不要** 试图编写或使用 Python 库(如 `pytesseract`, `easyocr`, `PIL`)来进行文本提取。请直接利用你自身的视觉能力。--## 示例场景--**请求**: "把这 3 张财务报告的截图转为 markdown。"--**执行**:-1. `list_dir` 查看文件: `img1.png`, `img2.png`, `img3.png`。-2. `view_file` 读取 `img1.png`。-3. (内部处理): 识别表头 "Q1 Revenue" 和表格行数据。-4. `view_file` 读取 `img2.png` 和 `img3.png`。-5. `write_to_file` 创建 `financial_report.md` 并写入汇总的内容。diff --git a/.agent/workflows/generate-ppt.md b/.agent/workflows/generate-ppt.mddeleted file mode 100644index c1d05f42..00000000--- a/.agent/workflows/generate-ppt.md+++ /dev/null@@ -1,16 +0,0 @@-<!-- AUTO-GENERATED by build_adapters.py — DO NOT EDIT MANUALLY -->-<!-- Source: skills/ppt-master/ | Generated: 2026-03-20 -->------description: 从 Markdown 源文档生成 PPT 的完整流程(主入口)------# PPT 生成工作流--> 本文件由 `build_adapters.py` 自动生成。--**完整流程**请参阅 [AGENTS.md](../../AGENTS.md),该文件包含完整的工作流程和规则手册。--**快速跳转**:-- [工作流程](../../AGENTS.md#工作流) — 从源文档到 PPT 的完整执行步骤-- [详细参考](../../AGENTS.md#详细参考) — 各角色定义和技术规范diff --git a/.cursor/rules/ppt-master.md b/.cursor/rules/ppt-master.mddeleted file mode 100644index d68bf474..00000000--- a/.cursor/rules/ppt-master.md+++ /dev/null@@ -1,2914 +0,0 @@-<!-- AUTO-GENERATED by build_adapters.py — DO NOT EDIT MANUALLY -->-<!-- Source: skills/ppt-master/ | Generated: 2026-03-20 -->--# PPT Master — AI 驱动的 SVG 内容生成系统--> 本文件由 `build_adapters.py` 从 `skills/ppt-master/` 自动生成。--# PPT Master Skill--> AI 驱动的多格式 SVG 内容生成系统。通过多角色协作将源文档转化为高质量 SVG 页面并导出 PPTX。--**核心流程**:`源文档 → 创建项目 → 模板选项 → Strategist → [Image_Generator] → Executor → 后处理 → 导出`--## 脚本目录--| 脚本 | 用途 |-|------|------|-| `skills/ppt-master/scripts/pdf_to_md.py` | PDF 转 Markdown |-| `skills/ppt-master/scripts/web_to_md.py` | 网页转 Markdown |-| `skills/ppt-master/scripts/web_to_md.cjs` | 微信/高防站点转 Markdown |-| `skills/ppt-master/scripts/project_manager.py` | 项目初始化/验证/管理 |-| `skills/ppt-master/scripts/analyze_images.py` | 图片分析 |-| `skills/ppt-master/scripts/nano_banana_gen.py` | AI 图片生成(Gemini API) |-| `skills/ppt-master/scripts/svg_quality_checker.py` | SVG 质量检查 |-| `skills/ppt-master/scripts/total_md_split.py` | 演讲备注拆分 |-| `skills/ppt-master/scripts/finalize_svg.py` | SVG 后处理(统一入口) |-| `skills/ppt-master/scripts/svg_to_pptx.py` | 导出 PPTX |--## 模板与资源--| 资源 | 路径 |-|------|------|-| 页面布局模板 | `skills/ppt-master/templates/layouts/` |-| 图表 SVG 模板 | `skills/ppt-master/templates/charts/` |-| 矢量图标库 (640+) | `skills/ppt-master/templates/icons/` |-| 模板索引 | `skills/ppt-master/templates/layouts/layouts_index.json` |-| 设计规范参考 | `skills/ppt-master/templates/design_spec_reference.md` |-------## 工作流--### Step 0: 偏好加载 ⛔ BLOCKING--检查用户偏好配置:-1. 项目级: `.ppt-master/EXTEND.md`-2. 用户级: `$HOME/.ppt-master/EXTEND.md`--如果存在,读取并应用偏好(默认风格、默认格式等)。-------### Step 1: 源内容处理--当用户提供非 Markdown 内容时,必须立即转换:--| 用户提供 | 命令 |-|----------|------|-| PDF 文件 | `python3 skills/ppt-master/scripts/pdf_to_md.py <文件>` |-| 网页链接 | `python3 skills/ppt-master/scripts/web_to_md.py <URL>` |-| 微信/高防站 | `node skills/ppt-master/scripts/web_to_md.cjs <URL>` |-| Markdown | 直接读取 |-------### Step 2: 项目初始化--```bash-python3 skills/ppt-master/scripts/project_manager.py init <项目名> --format <格式>-```--格式选项:`ppt169`(默认)、`ppt43`、`xhs`、`story` 等。完整格式列表见 `skills/ppt-master/references/canvas-formats.md`。--如需导入源文件:-```bash-python3 skills/ppt-master/scripts/project_manager.py import-sources <项目路径> <源文件...>-```-------### Step 3: 模板选择--向用户确认(二选一):--**A) 使用已有模板**-1. 查询 `skills/ppt-master/templates/layouts/layouts_index.json` 确认可用模板-2. 复制模板文件到项目目录:- ```bash- cp skills/ppt-master/templates/layouts/<模板名>/*.svg <项目路径>/templates/- cp skills/ppt-master/templates/layouts/<模板名>/design_spec.md <项目路径>/templates/- cp skills/ppt-master/templates/layouts/<模板名>/*.png <项目路径>/images/ 2>/dev/null || true- cp skills/ppt-master/templates/layouts/<模板名>/*.jpg <项目路径>/images/ 2>/dev/null || true- ```--**B) 不使用模板** → 自由设计--> 如需创建新模板,Read `skills/ppt-master/references/template-designer.md`-------### Step 4: Strategist 阶段(必须,不可跳过)--⛔ **BLOCKING**: 先读取角色定义:-```-Read skills/ppt-master/references/strategist.md-Read skills/ppt-master/references/shared-standards.md-```--**必须完成八项确认**:-1. 画布格式-2. 页数范围-3. 目标受众-4. 风格目标-5. 配色方案-6. 图标使用方式-7. 图片使用方式-8. 排版方案--如用户提供了图片:-```bash-python3 skills/ppt-master/scripts/analyze_images.py <项目路径>/images-```--**输出**:`<项目路径>/设计规范与内容大纲.md`--**检查点**:-```markdown-## ✅ Strategist 阶段完成-- [x] 已完成八项确认-- [x] 已生成《设计规范与内容大纲》-- [ ] **下一步**: [Image_Generator / Executor]-```-------### Step 5: Image_Generator 阶段(条件触发)--> **触发条件**:图片方式包含「AI 生成」--⛔ **BLOCKING**: Read `skills/ppt-master/references/image-generator.md`--1. 从设计规范中提取所有「状态=待生成」的图片-2. 生成提示词文档 → `<项目路径>/images/image_prompts.md`-3. 生成图片(推荐命令行工具):- ```bash- python3 skills/ppt-master/scripts/nano_banana_gen.py "提示词" --aspect_ratio 16:9 --image_size 1K -o <项目路径>/images- ```--**检查点**:-```markdown-## ✅ Image_Generator 阶段完成-- [x] 提示词文档已创建-- [x] 所有图片已保存到 images/-```-------### Step 6: Executor 阶段--⛔ **BLOCKING**: 根据风格选择读取角色定义:-```-Read skills/ppt-master/references/executor-base.md # 必读:公共准则-Read skills/ppt-master/references/executor-general.md # 通用灵活风格-Read skills/ppt-master/references/executor-consultant.md # 咨询风格-Read skills/ppt-master/references/executor-consultant-top.md # 顶级咨询风格(MBB级)-```--> 只需读 executor-base + 一个风格文件即可。--**视觉构建阶段**:-- 批量生成 SVG 页面 → `<项目路径>/svg_output/`--**逻辑构建阶段**:-- 生成演讲备注 → `<项目路径>/notes/total.md`--**检查点**:-```markdown-## ✅ Executor 阶段完成-- [x] 所有 SVG 已生成到 svg_output/-- [x] 演讲备注已生成 notes/total.md-```-------### Step 7: 后处理与导出--> ⚠️ 必须按顺序执行,不可省略或替换!--```bash-# 1. 拆分演讲备注-python3 skills/ppt-master/scripts/total_md_split.py <项目路径>--# 2. SVG 后处理(图标嵌入/图片裁剪嵌入/文本扁平化/圆角转Path)-python3 skills/ppt-master/scripts/finalize_svg.py <项目路径>--# 3. 导出 PPTX(默认嵌入演讲备注)-python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s final-```--> ❌ **禁止**用 `cp` 替代 `finalize_svg.py`,该工具执行多项关键处理-> ❌ **禁止**从 `svg_output/` 直接导出,必须用 `-s final` 从 `svg_final/` 导出-------### Step 8: Optimizer 阶段(可选)--> **触发条件**:用户要求优化,或设计质量需要提升--Read `skills/ppt-master/references/optimizer-crap.md`--优化后需重新执行 Step 7(后处理与导出)。-------## 角色切换协议--切换角色前**必须先读取**对应的 reference 文件,禁止跳过。输出标记:--```markdown-## 【角色切换:[角色名称]】-📖 阅读角色定义: skills/ppt-master/references/[文件名].md-📋 当前任务: [简述]-```-------## 参考资源--| 资源 | 路径 |-|------|------|-| 公共技术约束 | `skills/ppt-master/references/shared-standards.md` |-| 画布格式规范 | `skills/ppt-master/references/canvas-formats.md` |-| 设计指南 | `skills/ppt-master/references/design-guidelines.md` |-| 图片布局规范 | `skills/ppt-master/references/image-layout-spec.md` |-| SVG 图片嵌入 | `skills/ppt-master/references/svg-image-embedding.md` |-------## 注意事项--- 后处理三步不要添加 `--only` 等额外参数,直接运行即可-- 如果执行了 Optimizer 优化,需重新运行后处理与导出-- 本地预览:`python3 -m http.server -d <项目路径>/svg_final 8000`-------------# Shared Technical Standards--PPT Master 公共技术约束,消除跨角色文件重复。-------## 1. SVG 禁用功能黑名单--以下功能在生成 SVG 时**绝对禁止**使用,否则 PPT 导出将出错:--| 禁止功能 | 说明 |-|----------|------|-| `clipPath` | 裁剪路径 |-| `mask` | 遮罩 |-| `<style>` | 内嵌样式表 |-| `class` / `id` | CSS 选择器属性 |-| 外部 CSS | 外部样式表链接 |-| `<foreignObject>` | 嵌入外部内容 |-| `<symbol>` + `<use>` | 符号引用复用 |-| `textPath` | 沿路径排列文本 |-| `@font-face` | 自定义字体声明 |-| `<animate*>` / `<set>` | SVG 动画 |-| `<script>` / 事件属性 | 脚本与交互 |-| `marker` / `marker-end` | 线段端点标记 |-| `<iframe>` | 内嵌框架 |-------## 2. PPT 兼容性替代方案--| 禁止写法 | 正确替代 |-|----------|---------|-| `fill="rgba(255,255,255,0.1)"` | `fill="#FFFFFF" fill-opacity="0.1"` |-| `<g opacity="0.2">...</g>` | 每个子元素单独设置 `fill-opacity` / `stroke-opacity` |-| `<image opacity="0.3"/>` | 图片后叠加 `<rect fill="背景色" opacity="0.7"/>` 遮罩层 |-| `marker-end` 箭头 | 用 `<polygon>` 绘制三角形箭头 |--**记忆口诀**:PPT 不认 rgba、不认组透明、不认图片透明、不认 marker。-------## 3. 画布格式速查--### 演示文稿--| 格式 | viewBox | 尺寸 | 比例 |-|------|---------|------|------|-| PPT 16:9 | `0 0 1280 720` | 1280x720 | 16:9 |-| PPT 4:3 | `0 0 1024 768` | 1024x768 | 4:3 |--### 社交媒体--| 格式 | viewBox | 尺寸 | 比例 |-|------|---------|------|------|-| 小红书 | `0 0 1242 1660` | 1242x1660 | 3:4 |-| 朋友圈 / Instagram Post | `0 0 1080 1080` | 1080x1080 | 1:1 |-| Story / 抖音竖屏 | `0 0 1080 1920` | 1080x1920 | 9:16 |--### 营销物料--| 格式 | viewBox | 尺寸 | 比例 |-|------|---------|------|------|-| 微信公众号头图 | `0 0 900 383` | 900x383 | 2.35:1 |-| 横版 Banner | `0 0 1920 1080` | 1920x1080 | 16:9 |-| 竖版海报 | `0 0 1080 1920` | 1080x1920 | 9:16 |-| A4 打印 (150dpi) | `0 0 1240 1754` | 1240x1754 | 1:1.414 |-------## 4. 基础 SVG 规则--- **viewBox** 必须与画布尺寸一致(`width`/`height` 与 `viewBox` 匹配)-- **背景**:用 `<rect>` 定义页面背景色-- **换行**:用 `<tspan>` 手动换行,禁止 `<foreignObject>`-- **字体**:仅使用系统字体(微软雅黑、Arial、Calibri 等),禁止 `@font-face`-- **样式**:仅使用内联样式(`fill="..."` `font-size="..."`),禁止 `<style>` / `class` / `id`-- **颜色**:使用 HEX 值,透明度用 `fill-opacity` / `stroke-opacity`-- **图片引用**:`<image href="../images/xxx.png" preserveAspectRatio="xMidYMid slice"/>`-- **图标占位**:`<use data-icon="icon-name" x="" y="" width="48" height="48" fill="#HEX"/>`(后处理自动嵌入)-------## 5. 后处理三步命令--必须按顺序执行,不可跳过或添加额外参数:--```bash-# 1. 拆分讲稿到各页备注文件-python3 scripts/total_md_split.py <项目路径>--# 2. SVG 后处理(图标嵌入、图片裁剪/嵌入、文本扁平化、圆角矩形转 Path)-python3 scripts/finalize_svg.py <项目路径>--# 3. 导出 PPTX(从 svg_final/ 导出,默认嵌入演讲备注)-python3 scripts/svg_to_pptx.py <项目路径> -s final-```--**禁止事项**:-- 禁止用 `cp` 替代 `finalize_svg.py`-- 禁止从 `svg_output/` 直接导出,必须从 `svg_final/`(`-s final`)导出-- 禁止添加 `--only` 等额外参数-- Optimizer 优化后需重新执行全部三步-------## 6. 项目目录结构--```-project/-├── svg_output/ # 原始 SVG(Executor 输出,含占位符)-├── svg_final/ # 后处理完成的最终 SVG(finalize_svg.py 输出)-├── images/ # 图片资源(用户提供 + AI 生成)-├── notes/ # 演讲备注(与 SVG 同名的 .md 文件)-│ └── total.md # 完整演讲备注文稿(拆分前)-├── templates/ # 项目使用的模板(如有)-└── *.pptx # 导出的 PPT 文件-```-------# 画布格式规范---## 格式速查表--| 格式 | viewBox | 比例 | 适用场景 |-|------|---------|------|---------|-| PPT 16:9 | `0 0 1280 720` | 16:9 | 商业演示、会议汇报 |-| PPT 4:3 | `0 0 1024 768` | 4:3 | 传统投影、学术演讲 |-| 小红书 | `0 0 1242 1660` | 3:4 | 图文分享、知识帖 |-| 朋友圈/IG | `0 0 1080 1080` | 1:1 | 方形海报、品牌展示 |-| Story/抖音 | `0 0 1080 1920` | 9:16 | 竖屏快拍、短视频封面 |-| 公众号头图 | `0 0 900 383` | 2.35:1 | 微信公众号文章配图 |-| 横版Banner | `0 0 1920 1080` | 16:9 | 网页Banner、电子屏 |-| 竖版海报 | `0 0 1080 1920` | 9:16 | 手机屏幕、电梯广告 |-| A4 打印 | `0 0 1240 1754` | 1:√2 | 打印海报、宣传单页 |--## 格式选择决策树--```-内容用途?-├─ 演示汇报-│ ├─ 现代设备 → PPT 16:9 (1280×720)-│ └─ 传统设备 → PPT 4:3 (1024×768)-├─ 社交分享-│ ├─ 小红书 → 1242×1660-│ ├─ 朋友圈/IG → 1080×1080-│ └─ Story/抖音 → 1080×1920-└─ 营销物料- ├─ 公众号头图 → 900×383- ├─ Banner → 1920×1080- └─ 打印 → 1240×1754-```--## 布局原则--### 横屏 (16:9, 4:3, 2.35:1)-- 视觉动线:Z字型,从左到右-- 边距:40-80px-- 布局:多栏、左右分割、网格-- 卡片尺寸(16:9):单行 530-600px,双行 265-295px--### 竖屏 (3:4, 9:16)-- 视觉动线:从上到下-- 边距:60-120px-- 布局:单栏、上下分割、卡片堆叠-- 卡片尺寸(3:4):高度 400-600px,间距 40-60px--### 正方形 (1:1)-- 视觉动线:中心辐射-- 边距:60-100px-- 核心区域:约 800×800px--## 格式特定设计--| 格式 | 标题区 | 内容区 | 特殊注意 |-|------|--------|--------|---------|-| PPT | 80-100px | 充分利用宽度 | 页码右下角 |-| 小红书 | 180-240px(加粗) | 上下留白充足 | 底部品牌区 120-160px |-| 朋友圈 | 200-280px | 中心 500-600px | 底部二维码区 150-200px |-| Story | — | 中部 1500px | 顶部安全区 120px,底部 180px |-| 公众号头图 | 居中/左对齐 48-72px | — | 配图右侧或背景 |--## ViewBox 示例--```xml-<svg width="1280" height="720" viewBox="0 0 1280 720"> <!-- PPT 16:9 -->-<svg width="1242" height="1660" viewBox="0 0 1242 1660"> <!-- 小红书 -->-<svg width="1080" height="1080" viewBox="0 0 1080 1080"> <!-- 朋友圈 -->-<svg width="1080" height="1920" viewBox="0 0 1080 1920"> <!-- Story -->-<svg width="900" height="383" viewBox="0 0 900 383"> <!-- 公众号头图 -->-```--------# 设计指南--PPT Master 系统的详细设计指南和最佳实践。-------## 颜色系统--### 主色调选择--#### 咨询风格--```-德勤蓝: #0076A8 - 专业、可靠-麦肯锡蓝: #005587 - 权威、深度-BCG深蓝: #003F6C - 稳重、信任-普华永道橙: #D04A02 - 活力、创新-安永黄: #FFE600 - 乐观、清晰-```--#### 通用灵活风格--```-科技蓝: #2196F3 - 现代、创新-活力橙: #FF9800 - 热情、积极-成长绿: #4CAF50 - 健康、增长-专业紫: #9C27B0 - 创意、高端-警示红: #F44336 - 紧急、重要-```--### 辅助色系--#### 数据可视化配色--```-积极趋势(绿色系):- 深绿: #2E7D32 | 中绿: #4CAF50 | 浅绿: #81C784--警示趋势(黄色系):- 深黄: #F57C00 | 中黄: #FFA726 | 浅黄: #FFD54F--负面趋势(红色系):- 深红: #C62828 | 中红: #EF5350 | 浅红: #E57373-```--#### 中性色系--```-文本层级:- 主文本: #212121 (黑色, 87% opacity)- 副文本: #757575 (灰色, 60% opacity)- 辅助文本: #9E9E9E (浅灰, 38% opacity)--背景层级:- 主背景: #FFFFFF- 次背景: #F5F5F5- 卡片背景: #FAFAFA- 边框: #E0E0E0-```--### 对比度要求--遵循 WCAG 2.1 AA 级标准:-- 正文文本:至少 4.5:1-- 大号文本(24px+):至少 3:1-- 重要数据:至少 7:1(AAA 级)-------## 排版规范--### 字体层级--> 以正文字号为 1x 基准,其他层级按比例推导。字号选择取决于内容密度,而非设计风格。--#### 内容宽松(正文基准 24px)--适用:演讲型 PPT、培训课件、每页要点少(3-5 条)--```-H1 - 封面标题: 60-72px, Bold (2.5-3x)-H2 - 页面标题: 42-48px, Bold (1.75-2x)-H3 - 章节标题: 32-36px, SemiBold (1.3-1.5x)-正文 - 主要内容: 24px, Regular (1x 基准)-小字 - 注释说明: 18-20px, Regular (0.75-0.85x)-```--#### 内容密集(正文基准 18px)--适用:数据报告、咨询分析、每页要点多(6+ 条)--```-H1 - 封面标题: 45-54px, Bold (2.5-3x)-H2 - 页面标题: 27-36px, Bold (1.5-2x)-H3 - 章节标题: 22-27px, SemiBold (1.2-1.5x)-正文 - 主要内容: 18px, Regular (1x 基准)-小字 - 注释说明: 14-15px, Regular (0.75-0.85x)-```--### 字体选择--#### 中文字体--| 类别 | 代号 | 可选字体 | 适用场景 |-|------|:----:|---------|----------|-| 无衬线黑体 | A | 微软雅黑、黑体、幼圆、华文细黑 | 现代商务、正文(默认) |-| 衬线宋体 | B | 宋体、新宋体、仿宋、华文宋体 | 政务公文、正式报告 |-| 书法楷体 | C | 楷体、华文楷体、华文行楷 | 文化艺术、人文类 |-| 标题黑体 | D | 黑体、华文中宋、思源黑体 Bold | 大标题、强调 |-| 手写艺术 | E | 华文行楷、华文新魏、隶书 | 创意、个性化 |--#### 英文字体--| 类别 | 代号 | 可选字体 | 适用场景 |-|------|:----:|---------|----------|-| 无衬线现代 | F | Arial, Calibri, Segoe UI, Helvetica | 现代商务(默认) |-| 衬线经典 | G | Times New Roman, Georgia, Cambria | 正式文档、学术 |-| 标题展示 | H | Impact, Arial Black, Bebas Neue | 大标题、海报 |-| 手写风格 | I | Comic Sans MS, Segoe Script, Ink Free | 轻松活泼 |-| 等宽代码 | J | Consolas, Cascadia Code, Courier New | 数据、代码 |--#### 推荐 font-family--```css-/* 中文字体 */-"Microsoft YaHei", "微软雅黑", sans-serif /* A: 微软雅黑 */-"SimHei", "黑体", sans-serif /* A/D: 黑体 */-"SimSun", "宋体", serif /* B: 宋体 */-"FangSong", "仿宋", serif /* B: 仿宋 */-"KaiTi", "楷体", serif /* C: 楷体 */-"STXingkai", "华文行楷", cursive /* C/E: 华文行楷 */--/* 英文字体 */-"Arial", sans-serif /* F: Arial */-"Calibri", sans-serif /* F: Calibri */-"Times New Roman", serif /* G: Times */-"Georgia", serif /* G: Georgia */-"Impact", sans-serif /* H: Impact */-"Consolas", monospace /* J: 等宽 */-```--#### 中英文混排推荐--| 场景 | 中文字体 | 英文字体 |-|------|---------|---------|-| 现代商务 | 微软雅黑 (A) | Calibri / Arial (F) |-| 政务公文 | 宋体 (B) | Times New Roman (G) |-| 文化艺术 | 楷体 (C) | Georgia (G) |-| 科技互联网 | 黑体 (D) | Segoe UI (F) |--#### 字体角色--| 角色 | 用途 | 中文推荐 | 英文推荐 |-|------|------|----------|----------|-| 标题字体 | H1/H2 大标题 | A/C/D/E | F/G/H |-| 正文字体 | 段落、要点 | A/B | F/G |-| 强调字体 | KPI、关键词 | D | H/J |-| 注释字体 | 脚注、说明 | A/B | F/G |--### 行高和间距--```-标题行高: 1.2-1.3-正文行高: 1.5-1.6-段落间距: 1.5-2em-列表间距: 0.5-1em-```--### 文本换行与扁平化--- 生成阶段:采用 `<tspan>` 手动换行,通过 `x`/`dy` 控制行起点与行距-- 后处理:使用 `python3 scripts/finalize_svg.py <项目路径>`,包含文本扁平化功能-- 校验:对比 `svg_output` 与 `svg_final`,核对行序、样式与定位一致;目标文件中不应残留 `<tspan>`-------## 布局原则--### 16:9 画布规范--```-画布尺寸: 1280x720px-安全区域: 1200x640px (留40px边距)-标题区: 1200x100px-内容区: 1200x500px-页脚区: 1200x40px-```--### 网格系统--#### 单栏布局-```-适用: 封面、结束页、单一主题-内容宽度: 800-1000px,水平居中-```--#### 双栏布局-```-适用: 对比分析、左图右文-栏宽比例: 1:1 或 3:2,栏间距: 40-60px-```--#### 三栏布局-```-适用: 并列要点、流程步骤-栏宽比例: 1:1:1,栏间距: 30-40px-```--#### 四象限布局-```-适用: 矩阵分析、分类展示-象限尺寸: 560x250px (含间距),间距: 20-30px-```--### 卡片设计--#### 尺寸规范(强制)--```-单行卡片: 高度 530-600px-双行卡片: 每行 265-295px-三栏卡片: 每栏宽度 360-380px-```--#### 内边距--```-标题区: 20-30px-内容区: 30-40px-图表区: 20-30px-```--#### 圆角半径--```-小卡片: 8-12px-大卡片: 12-16px-图表: 8px-按钮: 6-8px-```-------## 图片布局规范--含图片页面的布局需根据图片比例动态计算。详细规范见 image-layout-spec.md。--**快速规则**:-- 比例 > 2.0 (超宽) → 上下布局-- 比例 1.5-2.0 (宽幅) → 优先上下,文字区不足则改左右-- 比例 1.2-1.5 (标准横图) → 左右布局-- 比例 0.8-1.2 (方形) → 左右布局-- 比例 < 0.8 (竖图) → 左右布局-------## 图表设计--### 常用图表类型--#### KPI 卡片-```-布局: 2x2 或 1x4-元素: 大号数字 (48-56px) + 指标名称 (18-20px) + 趋势图标/百分比 + 同比/环比说明-```--#### 柱状图-```-柱子数量: 3-8个,柱宽: 40-60px,间距: 柱宽的50-80%,显示数值标签-```--#### 折线图-```-线条: 2-3px,数据点: 圆形 半径 4-6px,网格线: 1px 浅灰色,图例: 右上角或底部-```--#### 饼图/环形图-```-分块: 3-6个,起始角度: -90度 (12点方向),环形宽度: 40-60px,显示百分比标签-```--#### 矩阵图-```-2x2布局,轴线: 2px实线,象限标签清晰,数据点大小统一-```--### 图表配色--| 方案 | 适用场景 | 示例 |-|------|---------|------|-| 单色渐变 | 同类数据比较 | #1976D2 → #42A5F5 → #90CAF9 |-| 对比色组 | 不同类别数据 | #2196F3 / #FF9800 / #4CAF50 |-| 顺序色 | 等级/强度展示 | #4CAF50 → #FFC107 → #F44336 |-------## 图标使用--### 项目内置图标库(推荐)--位于 `templates/icons/`,包含 640+ 个 SVG 图标。--```-完整索引: templates/icons/FULL_INDEX.md-程序化查询: templates/icons/icons_index.json-使用方式: templates/icons/README.md-```--**分类概览**:-- 通用:home, settings, search, user, calendar, mail...-- 数据:trending-up, chart-bar, database, file-text...-- 业务:rocket, target, lightbulb, trophy, star...-- 箭头:arrow-right/left/up/down, chevron-right...-- 状态:check, check-circle, x-circle, alert-circle...-- 工具:edit, trash, download, upload, share...--### 图标规范--```-尺寸: 小 16-20px | 常规 24-32px | 大 40-48px-线宽: 2px (统一)-颜色: 与主色调协调-间距: 图标大小的 50%-```-------## 常见模式--### 封面页-- 顶部:公司Logo(可选),中部:演示标题 (H1),副标题,底部:日期、演讲人-- 简洁大气,主色调背景或图片,文字居中或偏左--### 内容页-- 标准结构:页面标题 (H2) → 主要内容 → 页码/注释-- 变体:左标题右内容、上下分割、多栏布局--### 数据页-- 数据可视化为主,关键数字突出,提供数据来源,添加趋势说明-- 布局:大图表+要点、多小图表组合、KPI仪表盘--### 总结页-- 3-5个核心要点 + 行动号召 (CTA) + 下一步计划-- 列表或编号,图标辅助,简洁明了-------## 常见问题--| 问题 | 解决方案 |-|------|---------|-| 内容太多放不下 | 分多页、用更小字号(>=16px)、精简文字、用图表代替 |-| 颜色搭配不协调 | 限制主色<=3种、增加中性色占比、参考成功案例 |-| 布局不平衡 | 检查对齐、调整间距、使用网格系统、平衡视觉重量 |-------# Role: Strategist--## 核心使命--作为顶尖 AI 演示文稿策略师,接收源文档,进行内容分析与设计规划,输出 **《演示文稿设计规范与内容大纲》**。--## 流程上下文--| 上一步 | 当前 | 下一步 |-|--------|------|--------|-| 项目创建 + 模板选项确认 | **策略师**:八项确认 + 设计规范 | Image_Generator 或 Executor |--------## 1. 八项确认流程--在开始分析前,依次确认以下问题并提供专业建议。--### a. 画布格式确认--根据场景推荐格式(详见 shared-standards.md 画布格式速查表)。--### b. 页数范围确认--根据源文档内容量提供具体页数建议。--### c. 关键信息确认--确认目标受众、使用场合、核心信息,根据文档性质提供初步判断。--### d. 风格目标确认--| 风格 | 核心定位 | 适合受众 | 一句话特点 |-|------|----------|----------|------------|-| **A) 通用灵活** | 视觉冲击优先 | 公众/客户/学员 | 「让人一眼被吸引」 |-| **B) 一般咨询** | 数据清晰优先 | 团队/管理层 | 「让数据说话」 |-| **C) 顶级咨询** | 逻辑说服优先 | 高管/董事会 | 「让结论先行」 |--**风格选择决策树**:--```-内容特征?- ├─ 大量图片/宣传性强 ──→ A) 通用灵活- ├─ 数据分析/进展汇报 ──→ B) 一般咨询- └─ 战略决策/说服高管 ──→ C) 顶级咨询--受众?- ├─ 公众/客户/学员 ────→ A) 通用灵活- ├─ 团队/管理层 ───────→ B) 一般咨询- └─ 高管/董事会/投资人 → C) 顶级咨询-```--### e. 配色方案建议--基于内容特征和行业属性主动提供配色方案(HEX 色值)。--**行业配色速查**(完整 14 行业见 `scripts/config.py` 的 `INDUSTRY_COLORS`):--| 行业 | 主导色 | 特点 |-|------|--------|------|-| 金融/商务 | `#003366` 深蓝 | 稳重信赖 |-| 科技/互联网 | `#1565C0` 明蓝 | 创新活力 |-| 医疗/健康 | `#00796B` 青绿 | 专业安心 |-| 政务/政府 | `#C41E3A` 中国红 | 庄重权威 |--**配色规则**:60-30-10 法则(主导色 60%、辅助色 30%、强调色 10%);文本对比度 >= 4.5:1;单页不超 4 色。--### f. 图标使用方式确认--| 选项 | 方式 | 适用场景 |-|------|------|----------|-| **A** | Emoji 表情 | 轻松活泼、社交媒体 |-| **B** | AI 生成 | 需要定制风格 |-| **C** | 内置图标库 | 专业场景(推荐) |-| **D** | 自定义图标 | 有品牌素材 |--内置库含 640+ 图标,详见 `templates/icons/README.md`。--> **选择 C 时的强制规则**:-> 1. 查阅 `templates/icons/icons_index.json` 验证图标存在-> 2. 图标名称为单一名称(如 `factory`),不含路径前缀-> 3. 禁止使用索引中不存在的名称-> 4. 在《设计规范》中列出最终图标清单,Executor 只能使用清单内图标->-> **快速查找**:按分类 → `icons_index.json` 的 `categories`;按语义 → `quickLookup`;完整列表 → `templates/icons/FULL_INDEX.md`--### g. 图片使用确认--| 选项 | 方式 | 适用场景 |-|------|------|----------|-| **A** | 不使用图片 | 数据报告、流程说明 |-| **B** | 用户提供 | 有现成图片素材 |-| **C** | AI 生成 | 需要定制插图、背景 |-| **D** | 占位符预留 | 后期补充图片 |--**选择包含 B 时**,必须在输出规范前运行 `python3 scripts/analyze_images.py <项目路径>/images`,将扫描结果整合进图片资源清单。--**选择 B/C/D 时**,在规范中添加图片资源清单:--| 列 | 说明 |-|----|------|-| 文件名 | 如 `cover_bg.png` |-| 尺寸 | 如 `1280x720` |-| 比例 | 如 `1.78` |-| 布局建议 | 如 `宽幅横图 (适合全屏/插图)` |-| 用途 | 如 `封面背景` |-| 类型 | 背景图 / 实景照片 / 插画配图 / 图表架构 / 装饰图案 |-| 状态 | 待生成 / 已有 / 占位符 |-| 生成描述 | AI 生成时填写详细描述 |--**图片类型说明**:--| 类型 | 适用场景 |-|------|----------|-| 背景图 | 封面/章节页全页背景,需预留文字区域 |-| 实景照片 | 真实场景、人物、产品、建筑 |-| 插画配图 | 扁平设计、矢量风格、概念图解 |-| 图表架构 | 流程图、架构图、概念关系图 |-| 装饰图案 | 局部装饰、纹理、边框、分隔元素 |--**图片与布局适配原则**(详细计算规则参考 `docs/image_layout_spec.md`):--| 图片比例 | 推荐布局 |-|----------|----------|-| > 2.0 (超宽) | 上下分栏,上方通栏 |-| 1.5-2.0 (宽幅) | 上下分栏 |-| 1.2-1.5 (标准横图) | 左右分栏 |-| 0.8-1.2 (方图) | 左右分栏 |-| < 0.8 (竖图) | 左右分栏,图片在左 |--核心逻辑:布局容器宽高比必须与图片原始比例相近,禁止宽图塞方形容器或竖图放横向窄条。--> **流程衔接**:选择 C) AI 生成时,输出设计规范后提示用户调用 Image_Generator,图片归集到 `images/` 后再进入 Executor。--### h. 排版方案(字体 + 字号)--#### 字体预设--| 场景 | 预设 | 标题 | 正文 | 强调 |-|------|------|------|------|------|-| 现代商务、科技 | P1 | 微软雅黑/Arial | 微软雅黑/Calibri | 黑体 |-| 政务公文、报告 | P2 | 黑体 | 宋体/Times | 宋体 |-| 文化艺术、人文 | P3 | 楷体/Georgia | 微软雅黑 | 黑体 |-| 传统稳重风格 | P4 | 宋体 | 微软雅黑/Arial | 宋体 |-| 英文为主 | P5 | Arial/Impact | Calibri/Georgia | Arial Black |--#### 字号基准(所有字号使用 px)--选择原则:字号根据**内容密度**选择,而非设计风格。--| 内容密度 | 每页要点 | 正文基准 | 适用场景 |-|----------|----------|----------|----------|-| 宽松 | 3-5 条 | 24px | 演讲型、培训课件 |-| 密集 | 6+ 条 | 18px | 数据报告、咨询分析 |--| 层级 | 比例 | 24px 基准 | 18px 基准 |-|------|------|-----------|-----------|-| 封面标题 | 2.5-3x | 60-72px | 45-54px |-| 页面标题 | 1.5-2x | 36-48px | 27-36px |-| **正文** | **1x** | **24px** | **18px** |-| 注释 | 0.75x | 18px | 14px |--### i. 演讲备注要求(默认,无需沟通)--- 文件命名:推荐与 SVG 同名(`01_封面.svg` → `notes/01_封面.md`),兼容 `notes/slide01.md`-- 在《设计规范》中填写:演讲总时长、备注风格(正式/口语化/互动式)、讲演目的(告知/说服/激励/指导/汇报)-- 拆分后的备注文件中不允许出现 `#` 标题行(`notes/total.md` 汇总讲稿必须使用 `#` 标题行)-------## 2. 执行师风格详解(第四项确认依据)--### A) 通用灵活 — Executor_General--**独有能力**:-- 全幅大图 + 渐变蒙版(宣传/推介必备)-- 自由创意布局(不受网格约束)-- 三种风格变体:图文结合、极简演讲(Keynote 风)、创意设计--**典型场景**:招商/文旅推介、产品发布、培训课件、品牌宣传--**禁忌**:过于严肃刻板、密集数据表格--### B) 一般咨询 — Executor_Consultant--**独有能力**:-- KPI 仪表盘(4 卡片布局,大数字 + 趋势箭头)-- 专业图表组合(柱状图、折线图、饼图、漏斗图)-- 数据颜色分级(红/黄/绿三色达标状态)--**典型场景**:工作进展汇报、财务分析、政府工作报告、招投标/提案--**禁忌**:花哨装饰、图片为主角--### C) 顶级咨询 — Executor_Consultant_Top--**独有能力**:--| 能力 | 说明 |-|------|------|-| 数据情境化 | 每个数据必须有对比参照("增长 63%,行业均值仅 12%") |-| SCQA 框架 | 情境 → 冲突 → 问题 → 答案 |-| 金字塔原则 | 结论先行,核心观点放标题位置 |-| 战略性配色 | 颜色服务于信息,不做装饰 |-| 图表 vs 表格 | 趋势用图表,精确值用表格 |--**独有页面元素**:渐变顶条 + 深色核心观点区、机密标识 + 严谨页脚、MECE 分解图 / 驱动因素树 / 瀑布图--**典型场景**:战略决策报告、深度分析报告、咨询交付物(MBB 级)--**禁忌**:孤立数据、主观表述、装饰性元素-------## 3. 配色知识库--### 咨询风格配色(专业权威)--| 品牌/风格 | 色值 | 心理感受 |-|-----------|------|----------|-| 德勤蓝 | `#0076A8` | 专业、可靠 |-| 麦肯锡蓝 | `#005587` | 权威、深度 |-| BCG 深蓝 | `#003F6C` | 稳重、信任 |-| 普华永道橙 | `#D04A02` | 活力、创新 |-| 安永黄 | `#FFE600` | 乐观、清晰 |--### 通用灵活配色(现代活力)--| 风格 | 色值 | 适用场景 |-|------|------|----------|-| 科技蓝 | `#2196F3` | 科技、互联网 |-| 活力橙 | `#FF9800` | 营销、推广 |-| 成长绿 | `#4CAF50` | 健康、环保、增长 |-| 专业紫 | `#9C27B0` | 创意、高端 |-| 警示红 | `#F44336` | 紧急、重要 |--### 数据可视化配色--- 积极趋势(绿色系):`#2E7D32` → `#4CAF50` → `#81C784`-- 警示趋势(黄色系):`#F57C00` → `#FFA726` → `#FFD54F`-- 负面趋势(红色系):`#C62828` → `#EF5350` → `#E57373`-------## 4. 布局模式速查--| 布局 | 适用场景 | PPT 16:9 参考尺寸 |-|------|----------|-------------------|-| 单栏居中 | 封面、结语、重要观点 | 内容宽 800-1000px,水平居中 |-| 双栏布局 | 对比分析、左图右文 | 栏宽比 1:1 或 3:2,间距 40-60px |-| 三栏布局 | 并列要点、流程步骤 | 栏宽比 1:1:1,间距 30-40px |-| 四象限 | 矩阵分析、分类展示 | 象限 560x250px,间距 20-30px |-| 上下分栏 | 超宽图片+文字 | 图片通栏,文字区 >= 150px 高 |-| 左右分栏 | 标准/竖图+文字 | 图片侧放,文字区 >= 280px 宽 |--**PPT 16:9 (1280x720) 关键尺寸**:安全区域 1200x640(留 40px 边距);标题区 1200x100;内容区 1200x500;页脚区 1200x40。-------## 5. 模板灵活性原则--> 模板是起点,不是终点。--策略师应在 `scripts/project_manager.py` 生成的模板基础上,结合用户需求、内容特征、受众特点进行专业判断:--1. 比例系统可调(字号比例是参考值)-2. 配色方案可定制(结合品牌和内容特征)-3. 布局模式可组合(6 种基础布局自由变化)-4. 内容结构可扩展(12 章节框架可增减)-5. 间距/圆角等细节由 Executor 根据内容密度调整-------## 6. 工作流程与交付物--### 6.1 内容规划策略--| 风格 | 内容大纲 | 设计规范 | 演讲备注 |-|------|----------|----------|----------|-| A) 通用灵活 | 智能解构源文档,每页定义核心主题 | 视觉主题、色彩方案、布局原则 | 简洁演讲稿 |-| B) 一般咨询 | 结构化逻辑板块,数据驱动洞察 | 咨询风格配色、内容结构化布局 | 专业术语、数据解读、结论先行 |-| C) 顶级咨询 | SCQA 框架,金字塔原则结论先行 | 数据情境化、颜色战略性使用 | 高度凝练、逻辑严密、结论驱动 |--### 6.2 大纲输出规范(必须包含 12 章节)--| 章节 | 内容要求 |-|------|----------|-| 一、项目信息 | 项目名称、画布格式、页数、风格、受众、场景、日期 |-| 二、画布规范 | 格式、尺寸、viewBox、边距、内容区域 |-| 三、视觉主题 | 风格说明、亮/深主题、调性、配色方案(含色值表)、渐变方案 |-| 四、排版体系 | 字体方案(P1-P5)、字号层级(H1-Code 7级) |-| 五、布局原则 | 页面结构(页眉/内容/页脚区)、6种布局模式、间距规范 |-| 六、图标使用规范 | 来源说明、占位符语法、推荐图标清单 |-| 七、图片资源清单 | 文件名、尺寸、比例、用途、状态、生成描述 |-| 八、内容大纲 | 按章节分组,每页含布局、标题、内容要点 |-| 九、演讲备注要求 | 文件命名规则、内容结构说明 |-| 十、技术约束提醒 | SVG 生成规则、PPT 兼容性规则 |-| 十一、设计检查清单 | 生成前/生成后检查项 |-| 十二、下一步 | 明确后续流程(Image_Generator 或 Executor) |--**生成步骤**:-1. 读取参考模板:`templates/design_spec_reference.md`-2. 结合分析内容从头生成完整规范-3. 保存至:`projects/<项目名>.../设计规范与内容大纲.md`-------## 7. 项目文件夹--项目文件夹应在进入策略师角色之前已创建。如未创建,先执行:--```bash-python3 scripts/project_manager.py init <项目名称> --format <画布格式>-```--策略师将《设计规范与内容大纲》保存至 `projects/<项目名>_<格式>_<YYYYMMDD>/设计规范与内容大纲.md`。-------## 8. 完成设计规范并提示下一步--根据已确认的模板选项和图片使用选择提示下一步。--### 模板选项 A(使用已有模板)--```-✅ 设计规范已完成。模板已就绪。-下一步:-- 图片包含 AI 生成 → 调用 Image_Generator-- 图片不包含 AI 生成 → 调用 Executor-```--### 模板选项 B(不使用模板)--```-✅ 设计规范已完成。-下一步:-- 图片包含 AI 生成 → 调用 Image_Generator-- 图片不包含 AI 生成 → 调用 Executor(自由生成每一页)-```-------# Image_Generator 参考手册--> 本文件为 Image_Generator 角色的精简参考。通用标准(SVG 技术约束、画布格式、后处理流程等)见 [shared-standards.md](./shared-standards.md)。--## 核心使命--接收 Strategist 输出的《设计规范与内容大纲》中的「图片资源清单」,为每张待生成的图片创建优化提示词,并通过 AI 工具生成图片,保存到项目 `images/` 目录。--**触发条件**: 需要生成 AI 图片时(独立使用或流程中调用)--| 模式 | 触发方式 | 说明 |-|------|----------|------|-| **独立使用** | 直接说明图片需求 | 生成单张或多张 AI 图片 |-| **流程中使用** | `generate-ppt` 选择 AI 生成图片 | 为项目批量生成图片资源 |--> 流程中下一步:Executor 生成 SVG-------## 1. 输入与输出--### 输入--- **设计规范与内容大纲**(来自 Strategist):项目主题、目标受众、设计风格、配色方案、画布格式-- **图片资源清单**(关键输入):-- | 文件名 | 尺寸 | 用途 | 类型 | 状态 | 生成描述 |- |--------|------|------|------|------|----------|- | cover_bg.png | 1920x1080 | 封面背景 | 背景图 | 待生成 | 现代科技感抽象背景,深蓝渐变 |--### 输出--| 产出物 | 路径/说明 | 要求 |-|--------|-----------|------|-| 提示词文档 | `项目/images/image_prompts.md` | **必须**用文件写入工具保存,不能仅在对话中输出 |-| 优化提示词 | 每张图片独立提示词 | 可直接用于 AI 图像生成工具,兼做 alt 文本 |-| 图片文件 | `项目/images/` 目录 | 按清单文件名命名 |-| 更新后的清单 | 状态变更 | 「待生成」→「已生成」 |-------## 2. 统一提示词结构--### 2.1 标准输出格式--每张图片必须按以下格式输出:--```markdown-### 图片 N: {文件名}--| 属性 | 值 |-| -------- | ------------------------------------ |-| 用途 | {在哪页/承担什么功能} |-| 类型 | {背景图/插画/实景照片/图表/装饰图案} |-| 尺寸 | {宽}x{高} ({宽高比}) |-| 原始描述 | {用户在清单中提供的描述} |--**提示词 (Prompt)**:-{主体描述}, {风格指令}, {色彩指令}, {构图指令}, {质量指令}--**负面提示词 (Negative Prompt)**:-{需要排除的元素}--**图片描述 (Alt Text)**:-> {中文描述,用于无障碍访问和图片说明}-```--### 2.2 提示词组成要素--| 要素 | 说明 | 示例 |-|------|------|------|-| 主体描述 | 核心内容 | `Abstract geometric shapes`, `Team collaboration scene` |-| 风格指令 | 视觉风格 | `flat design`, `3D isometric`, `watercolor style` |-| 色彩指令 | 配色方案 | `color palette: navy blue (#1E3A5F), gold (#D4AF37)` |-| 构图指令 | 布局比例 | `16:9 aspect ratio`, `centered composition` |-| 质量指令 | 分辨率质量 | `high quality`, `4K resolution`, `sharp details` |-| 负面提示词 | 排除元素 | `text, watermark, blurry, low quality` |--### 2.3 风格关键词速查--| 设计风格 | 推荐图片风格 | 核心关键词 |-|----------|-------------|------------|-| 通用灵活 | 现代插画、扁平设计 | `modern`, `flat design`, `gradient`, `vibrant colors` |-| 一般咨询 | 简洁专业、商务风 | `professional`, `clean`, `corporate`, `minimalist` |-| 顶级咨询 | 高端简约、抽象几何 | `premium`, `sophisticated`, `geometric`, `abstract`, `elegant` |--### 2.4 色彩整合方法--从设计规范提取配色,转换为提示词:--```-主导色: #1E3A5F (深海蓝) → "deep navy blue (#1E3A5F)"-辅助色: #F8F9FA (浅灰) → "light gray (#F8F9FA)"-强调色: #D4AF37 (金) → "gold accent (#D4AF37)"--完整指令: "color palette: deep navy blue (#1E3A5F), light gray (#F8F9FA), gold accent (#D4AF37)"-```--### 2.5 画布格式与宽高比--| 画布格式 | 背景图宽高比 | 建议分辨率 |-|----------|-------------|------------|-| PPT 16:9 | 16:9 | 1920x1080 或 2560x1440 |-| PPT 4:3 | 4:3 | 1600x1200 |-| 小红书 | 3:4 | 1242x1660 |-| 朋友圈 | 1:1 | 1080x1080 |-| Story | 9:16 | 1080x1920 |--> Nano Banana 支持的宽高比:`1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`-------## 3. 图片类型分类与处理--### 类型判断流程--1. 全页/大面积铺底 → **背景图** (3.1)-2. 真实场景/人物/产品 → **实景照片** (3.2)-3. 扁平/插画/卡通风格 → **插画配图** (3.3)-4. 流程/架构/关系 → **图表/架构图** (3.4)-5. 局部装饰/纹理 → **装饰图案** (3.5)--### 3.1 背景图 (Background)--**识别特征**: 封面、章节页的全页背景,需承载文字叠加--| 要点 | 说明 |-|------|------|-| 强调背景属性 | 添加 `background`, `backdrop` |-| 预留文字区域 | `negative space in center for text overlay` |-| 避免强主体 | 使用抽象、渐变、几何元素 |-| 低对比细节 | `subtle`, `soft`, `muted` |--**模板**: `Abstract {主题元素} background, {风格} style, {主色} to {辅色} gradient, subtle {装饰元素}, clean negative space in center for text overlay, {宽高比} aspect ratio, high resolution, professional presentation background`--**负面提示词**: `text, letters, watermark, faces, busy patterns, high contrast details`--### 3.2 实景照片 (Photography)--**识别特征**: 真实场景、人物、产品、建筑等照片质感--| 要点 | 说明 |-|------|------|-| 强调真实感 | `photography`, `photorealistic`, `real photo` |-| 光影效果 | `natural lighting`, `soft shadows`, `studio lighting` |-| 背景处理 | `white background` / `blurred background` / `contextual setting` |-| 人物多样性 | `diverse`, `professional attire` |--**模板**: `{主体描述}, professional photography, {光影类型} lighting, {背景类型} background, color grading matching {配色方案}, high quality, sharp focus, 8K resolution`--**负面提示词**: `watermark, text overlay, artificial, CGI, illustration, cartoon, distorted faces`--### 3.3 插画配图 (Illustration)--**识别特征**: 扁平设计、矢量风格、卡通、概念图解--| 要点 | 说明 |-|------|------|-| 明确风格 | `flat design`, `isometric`, `vector style`, `hand-drawn` |-| 简化细节 | `simplified`, `clean lines`, `minimal details` |-| 统一色板 | 严格使用设计规范配色 |-| 背景选择 | `white background` 或 `transparent background` |--**模板**: `{主体描述}, {插画风格} illustration style, {细节程度} with clean lines, color palette: {配色列表}, {背景类型} background, professional {用途} illustration`--**负面提示词**: `realistic, photography, 3D render, complex textures, watermark`--### 3.4 图表/架构图 (Diagram)--**识别特征**: 流程图、架构图、概念关系图、数据可视化--| 要点 | 说明 |-|------|------|-| 清晰结构 | `clear structure`, `organized layout`, `logical flow` |-| 连接表示 | `arrows indicating flow`, `connecting lines` |-| 学术/专业感 | `suitable for academic publication`, `professional diagram` |-| 浅色背景 | `white background` 或 `light gray background` |--**模板**: `{图表类型} diagram showing {内容描述}, {组件描述} connected by {连接方式}, {风格} style with {配色方案}, white background, clear labels, professional technical diagram`--**负面提示词**: `cluttered, messy, overlapping elements, dark background, realistic, photography`--### 3.5 装饰图案 (Decorative Pattern)--**识别特征**: 局部装饰、纹理、边框、分隔元素--| 要点 | 说明 |-|------|------|-| 可重复性 | `seamless`, `tileable`, `repeatable`(如需要) |-| 低调辅助 | `subtle`, `understated`, `supporting element` |-| 透明友好 | `transparent background` 或 `isolated element` |-| 小尺寸适用 | 考虑在小尺寸下的可识别性 |--**模板**: `{图案类型} decorative pattern, {风格} style, {配色方案}, {背景类型} background, subtle and elegant, suitable for {用途}`--**负面提示词**: `busy, cluttered, high contrast, distracting, photorealistic`-------## 4. 图片生成工作流--### 4.1 分析阶段--1. 阅读设计规范,理解项目整体风格-2. 提取配色方案、画布格式、目标受众-3. 逐一分析图片资源清单中的每张图片-4. 判断每张图片的类型(参考第 3 节)--### 4.2 提示词生成阶段--对每张「待生成」状态的图片:--1. **判断类型** → 背景图/实景照片/插画/图表/装饰-2. **理解用途** → 在哪页?承担什么功能?-3. **分析原始描述** → 用户「生成描述」中的信息-4. **应用类型要点** → 参考对应类型的表格-5. **生成优化提示词** → 使用 2.1 统一输出格式-6. **保存提示词文档** → **必须**写入 `项目/images/image_prompts.md`--### 4.3 图片生成阶段--> 前置条件:必须先完成 4.2,确保 `images/image_prompts.md` 已创建--#### 方式一:Nano Banana 命令行工具(推荐)--```bash-python3 scripts/nano_banana_gen.py "你的提示词" \- --aspect_ratio 16:9 --image_size 1K \- --output 项目/images --filename cover_bg-```--**参数列表**:--| 参数 | 简写 | 说明 | 默认值 |-|------|------|------|--------|-| `prompt` | - | 正向提示词(位置参数) | `Nano Banana` |-| `--negative_prompt` | `-n` | 负面提示词 | 无 |-| `--aspect_ratio` | - | 图片宽高比 | `1:1` |-| `--image_size` | - | 尺寸 (`1K`/`2K`/`4K`) | `1K` |-| `--output` | `-o` | 输出目录 | 当前目录 |-| `--filename` | `-f` | 输出文件名(不含扩展名) | 自动命名 |--**环境变量**: 必需 `GEMINI_API_KEY`,可选 `GEMINI_BASE_URL`--**生成节奏控制(强制)**:-- 每次只执行一个生成命令,等待确认文件落盘后再执行下一条-- 建议每张间隔 2-5 秒,避免并发导致失败-- 如出现失败/无输出,先停止队列,检查环境变量与输出目录,再继续--#### 方式二:自动生成--直接调用图像生成 API,下载并保存到 `项目/images/` 目录。--#### 方式三:Gemini 网页版--1. 在 [Gemini](https://gemini.google.com/) 中生成图片-2. 选择 **Download full size** 下载高分辨率版本-3. 去水印:`python3 scripts/gemini_watermark_remover.py <图片路径>`-4. 将处理后的图片放入 `项目/images/` 目录--#### 方式四:手动生成(其他 AI 平台)--提示词已保存在 `images/image_prompts.md`,告知用户文件位置。用户自行到 Midjourney、DALL-E、Stable Diffusion、文心一格、通义万相等平台生成,将图片放入 `项目/images/` 目录。--### 4.4 验证阶段--- 确认所有图片已保存到 `images/` 目录-- 检查文件名与清单一致-- 更新图片资源清单状态为「已生成」-------## 5. 提示词文档模板--创建 `项目/images/image_prompts.md` 时使用以下结构:--```markdown-# 图片生成提示词--> 项目: {项目名称}-> 生成时间: {日期}-> 配色方案: 主导色 {#HEX} | 辅助色 {#HEX} | 强调色 {#HEX}-------## 图片清单总览--| # | 文件名 | 类型 | 尺寸 | 状态 |-|---|--------|------|------|------|-| 1 | cover_bg.png | 背景图 | 1920x1080 | 待生成 |-------## 详细提示词--### 图片 1: cover_bg.png--| 属性 | 值 |-|------|----|-| 用途 | 封面背景 |-| 类型 | 背景图 |-| 尺寸 | 1920x1080 (16:9) |-| 原始描述 | 现代科技感抽象背景,深蓝渐变 |--**提示词 (Prompt)**:-Abstract futuristic background with flowing digital waves...--**图片描述 (Alt Text)**:-> 现代科技感抽象背景,深蓝色渐变配合数字波浪和粒子效果-------## 使用说明--1. 复制上方「提示词」到 AI 图像生成工具-2. 推荐平台: Midjourney / DALL-E 3 / Gemini / Stable Diffusion-3. 生成后将图片重命名为对应文件名-4. 放入 `images/` 目录-```-------## 6. 负面提示词速查--### 按图片类型--| 类型 | 推荐负面提示词 |-|------|---------------|-| 背景图 | `text, letters, watermark, faces, busy patterns, high contrast details` |-| 实景照片 | `watermark, text overlay, artificial, CGI, illustration, cartoon, distorted faces` |-| 插画配图 | `realistic, photography, 3D render, complex textures, watermark` |-| 图表/架构图 | `cluttered, messy, overlapping elements, dark background, realistic` |-| 装饰图案 | `busy, cluttered, high contrast, distracting, photorealistic` |--### 通用负面提示词--- **标准版**: `text, watermark, signature, blurry, distorted, low quality`-- **扩展版**(人物场景): `text, watermark, signature, blurry, low quality, distorted, extra fingers, mutated hands, poorly drawn face, bad anatomy, extra limbs, disfigured, deformed`-------## 7. 常见问题--### 无「生成描述」时的默认推断--| 用途 | 默认推断 |-|------|----------|-| 封面背景 | 抽象渐变背景,预留中央文字区域 |-| 章节页背景 | 简洁几何图案,侧重单色调 |-| 团队介绍页 | 团队协作场景插图(扁平风格) |-| 数据展示页 | 简洁几何图案或纯色背景 |-| 产品展示 | 产品实拍风格,白底或渐变背景 |--### 图片不满意时--提供提示词变体供用户选择:变体 A(更抽象)、变体 B(更具象)、变体 C(不同色调)。-------## 8. 角色协作--### 与 Strategist 的衔接--| 方向 | 内容 |-|------|------|-| 接收 | 设计规范与内容大纲(含图片资源清单) |-| 触发条件 | 用户在「图片使用」中选择包含「C) AI 生成」 |-| 关键信息 | 配色方案、设计风格、画布格式 |--### 与 Executor 的衔接--| 方向 | 内容 |-|------|------|-| 交付 | 所有图片已放入 `项目/images/` 目录 |-| Executor 引用 | `<image href="../images/xxx.png" .../>` |-| 路径说明 | SVG 在 `svg_output/`,图片在 `images/`,使用相对路径 `../images/` |-------## 9. 任务完成检查点--### 必须完成项--- [ ] 已创建提示词文档 `项目/images/image_prompts.md`-- [ ] 每张图片都有:类型判断 + 优化提示词 + 负面提示词 + Alt Text-- [ ] 使用统一输出格式(2.1 标准格式)-- [ ] 已输出阶段完成确认--### 图片就绪项(至少满足一项)--- [ ] 所有图片已保存到 `项目/images/` 目录-- [ ] 或:已明确告知用户使用 `image_prompts.md` 自行生成--### 流程流转--- [ ] 已提示用户进入下一步(切换到 Executor 角色)--> **关键检查**: 如果 `images/image_prompts.md` 未创建,或输出格式不符合 2.1 标准,任务未完成。--### 完成确认输出格式--```markdown-## Image_Generator 阶段完成--- [x] 已创建提示词文档 `项目/images/image_prompts.md`-- [x] 已为 X 张图片生成优化提示词-- [x] 所有图片已保存到 `images/` 目录-- [x] 已更新图片资源清单状态--**图片状态汇总**:--| 文件名 | 类型 | 尺寸 | 状态 |-|--------|------|------|------|-| cover_bg.png | 背景图 | 1920x1080 | 已生成 |--**下一步**: 切换到 Executor 角色开始生成 SVG-```-------# Executor 公共规范--> 各风格差异化内容见对应 `executor-{style}.md`。-------## 1. 模板遵循规则--如果项目 `templates/` 目录中存在模板文件,必须遵循模板结构:--| 页面类型 | 对应模板 | 遵循规则 |-|---|---|---|-| 封面 | `01_cover.svg` | 继承背景、装饰元素、布局结构,替换占位符内容 |-| 章节页 | `02_chapter.svg` | 继承编号样式、标题位置、装饰元素 |-| 内容页 | `03_content.svg` | 继承页眉页脚样式,**内容区可自由布局** |-| 结束页 | `04_ending.svg` | 继承背景、感谢语位置、联系信息布局 |-| 目录页 | `02_toc.svg` | **可选**:继承目录标题、列表样式 |--### 页面-模板对应声明(必须输出)--开始生成每一页之前,必须明确输出该页使用的模板或"自由生成":--```-📝 **模板对应**: `templates/01_cover.svg`(或"无(自由生成)")-🎯 **遵循规则/布局策略**: [具体说明]-```--- **内容页**:模板只定义页眉和页脚,内容区域由 Executor 自由布局-- **无模板时**:完全按照《设计规范与内容大纲》自由生成-------## 2. 设计参数确认(强制步骤)--> 在生成第一页 SVG 之前,**必须先回顾《设计规范与内容大纲》中的关键设计参数**,确保后续生成严格遵循规范。--必须输出确认,包含:画布尺寸、正文字号、配色方案(主导/辅助/强调色 HEX)、字体方案。--**为什么必须做这一步?** 防止"规范是规范,执行是执行"的脱节问题。-------## 3. 执行准则--- **绝对遵循规范**:严格按照规范中的色彩、布局、画布格式、排版参数设计-- **遵循模板结构**:如有模板,继承模板的视觉框架-- **分阶段批量生成**(推荐):- 1. **视觉构建阶段**:连续生成所有 SVG 页面,确保设计风格和布局坐标的高度一致性(Visual Consistency)- 2. **逻辑构建阶段**:SVG 全部定稿后,再批量生成演讲备注,确保叙事逻辑连贯(Narrative Continuity)-- **技术规范**:详见 [shared-standards.md](shared-standards.md) 中的 SVG 技术约束与 PPT 兼容性规则--### SVG 文件命名规范--文件命名格式:`<序号>_<页面名称>.svg`--- **中文内容** → 中文命名:`01_封面.svg`、`02_目录.svg`、`03_核心优势.svg`-- **英文内容** → 英文命名:`01_cover.svg`、`02_agenda.svg`、`03_key_benefits.svg`-- **序号规则**:两位数字,从 01 开始递增-- **页面名称**:简洁描述性,与《设计规范与内容大纲》中的页面标题一致-------## 4. 图标使用--四种方式:**A: Emoji**(`<text>🚀</text>`)| **B: AI 生成**(SVG 基本元素)| **C: 内置库**(`templates/icons/` 640+ 图标,推荐)| **D: 自定义**(用户指定)--**内置图标 - 占位符方式(推荐)**:--```xml-<use data-icon="chart-bar" x="100" y="200" width="48" height="48" fill="#005587"/>-```--> 无需手动运行 `embed_icons.py`,`finalize_svg.py` 后处理工具会自动嵌入图标。--**常用图标**:`chart-bar` `arrow-trend-up` `users` `cog` `circle-checkmark` `target` `clock` `file` `dollar` `lightbulb`--完整索引:`templates/icons/README.md`-------## 5. 图片处理--根据设计规范「图片资源清单」中的状态处理:--| 状态 | 来源 | 处理方式 |-|---|---|---|-| **已有** | 用户提供 | 直接引用 `../images/` 目录中的图片 |-| **AI 生成** | Image_Generator 生成 | 图片已在 `../images/`,直接引用 |-| **占位符** | 暂未准备 | 使用虚线框占位 |--**引用**:`<image href="../images/xxx.png" ... preserveAspectRatio="xMidYMid slice"/>`--**占位符**:虚线框 `<rect stroke-dasharray="8,4" .../>` + 描述文本-------## 6. 字体使用--根据《设计规范与内容大纲》中的字体方案,为不同文本角色应用对应字体:--| 角色 | 中文推荐 | 英文推荐 |-|---|---|---|-| 标题字体 | 微软雅黑/楷体/黑体 | Arial/Georgia |-| 正文字体 | 微软雅黑/宋体 | Calibri/Times |-| 强调字体 | 黑体 | Arial Black/Consolas |-| 注释字体 | 微软雅黑/宋体 | Arial/Times |--详细参见 `docs/design_guidelines.md`。-------## 7. 演讲备注生成框架--### 任务 1. 生成完整演讲备注文稿--在**所有 SVG 页面生成完成并定稿后**,进入"逻辑构建阶段",在 `notes/total.md` 中生成完整的演讲备注文稿。--**为什么不一页一页生成?** 批量写备注能像写剧本一样规划转场语(Transition),确保演讲逻辑通顺。--**格式**:每页以 `# <序号>_<页面标题>` 开头,页间用 `---` 分隔。每页包含:讲稿正文(2-5 句)、`要点:①② ③`、`时长:X 分钟`。首页除外,每页正文以 `[过渡]` 转场语开头。--**基础控场标记**(所有风格通用):--| 标记 | 用途 |-|---|---|-| `[停顿]` | 关键内容后留白,让观众消化 |-| `[过渡]` | 段首单独成段,放在每页正文开头,承上启下 |--> 各风格可扩展额外标记(`[互动]`/`[数据]`/`[环视]`/`[对标]` 等),见 `executor-{style}.md`。--**要求**:--- 讲稿应口语化、自然流畅-- 突出页面核心信息和演讲要点-- 用户可在 `notes/` 目录手动编辑覆盖--### 任务 2. 拆分写入各页备注文件--将 `notes/total.md` 自动拆分,写入 `notes/` 目录下的演讲备注文件中。--**文件命名规范**:--- **推荐**:与 SVG 同名(如 `01_封面.svg` → `notes/01_封面.md`)-- **兼容**:也支持 `slide01.md` 格式(向后兼容)-------## 8. 完成后下一步--> **强制检查点**:进入后处理前必须输出确认——视觉构建阶段(SVG 页数)和逻辑构建阶段(备注页数)均已完成。未输出检查点禁止进入后处理。--**后处理与导出**(详见 [shared-standards.md](shared-standards.md)):--```bash-# 1. 拆分讲稿-python3 scripts/total_md_split.py <项目路径>--# 2. SVG 后处理(自动嵌入图标、图片等)-python3 scripts/finalize_svg.py <项目路径>--# 3. 导出 PPTX-python3 scripts/svg_to_pptx.py <项目路径> -s final-```-------# Executor General -- 创意通用风格--> 基础准则见 executor-base.md,技术约束见 shared-standards.md-------## 角色定位--创意型、通用风格的 SVG 设计执行师。适用于产品介绍、培训讲义、方案汇报、营销宣传等**非咨询类**场景。强调视觉表现力与信息趣味性,在专业与亲和之间取得平衡。-------## General 特有布局技巧--### 1. 灵活多变的版式--General 风格不拘泥于固定模板,可根据内容自由选择版式:--| 版式 | 适用场景 | 布局要点(1280x720) |-|------|----------|---------------------|-| 全图背景+文字叠加 | 封面、情感渲染页 | `<image>` 铺满画布 + 半透明遮罩 + 居中标题 |-| 左右分栏(图文混排) | 功能介绍、对比说明 | 左 x=40,w=580 / 右 x=660,w=580 |-| 三栏卡片 | 特性罗列、团队介绍 | x=40,450,860 各 w=380,等高卡片 |-| 上下分区 | 时间线、流程展示 | 上区标题+说明 h=250 / 下区图表+内容 h=420 |-| 中心辐射 | 核心概念、生态图 | 中心元素 + 4-6 个周围节点,连线指向中心 |-| 瀑布流/Z 字型 | 故事叙述、案例展示 | 内容块交替左右排列,引导视线 Z 字移动 |--### 2. 视觉节奏控制--- **信息密度交替**:高密度数据页之后接一页"呼吸页"(大图/金句/过渡),避免观众疲劳-- **视觉重量平衡**:深色/大面积元素为"重",浅色/小元素为"轻",左右/上下应均衡-- **重复与变化**:同一章节内保持版式一致性,不同章节间适当变化以维持新鲜感--### 3. 装饰元素运用--| 元素 | 用法 | 注意事项 |-|------|------|---------|-| 渐变色块 | 背景分区、标题底色 | 使用 `<linearGradient>` / `<radialGradient>`,限 2-3 色 |-| 圆角矩形卡片 | 内容容器、功能模块 | `rx="12"` 配合轻投影(用浅色 rect 模拟) |-| 图标点缀 | 列表项前缀、功能标识 | 使用 `data-icon` 占位符,大小 32-48px |-| 编号圆圈 | 步骤流程、排名列表 | `<circle>` + 居中 `<text>`,主题色填充 |-| 分隔线 | 内容分区 | `<line>` 或 `<rect height="2">`,opacity 0.2-0.3 |-------## 视觉策略--### 色彩运用--- **主题色大胆使用**:封面、章节页可大面积使用主题色背景-- **渐变增强层次**:标题栏、卡片背景可使用同色系渐变-- **对比创造焦点**:关键数字/词汇使用强调色,与周围内容形成反差-- **配色情绪匹配**:科技感用冷色调,活力感用暖色调,稳重感用深色调--### 图片处理策略--| 场景 | 策略 | SVG 实现 |-|------|------|---------|-| 全屏背景图 | 图片铺满 + 暗色渐变遮罩 | `preserveAspectRatio="xMidYMid slice"` + 渐变 rect |-| 竖图展示 | 左侧/右侧放置,保持原比例 | 控制宽度,高度自适应 |-| 多图拼接 | 网格排列,统一尺寸 | 等宽等高的 `<image>` 矩阵 |-| 人物照片 | 圆形裁切效果 | `<circle>` 背景 + 方形图片叠加(后处理裁剪) |--### 排版层次--```-标题层 → 28-36px,粗体,主题色或白色-副标题层 → 20-24px,中等粗细,次要色-正文层 → 16-18px,常规,深灰色-注释层 → 12-14px,浅灰色,底部对齐-```-------## 演讲备注风格--### 叙事基调--General 风格的演讲备注采用**口语化叙述**,像在和观众对话,而非宣读报告。语气自然、有节奏感,适当加入修辞手法。--### 控场标记--| 标记 | 用途 | 示例 |-|------|------|------|-| `[停顿]` | 关键展示后留白,让观众消化信息 | "这个数字意味着什么?[停顿] 意味着每 3 个用户中就有 1 个..." |-| `[互动]` | 提问或引导观众参与,激活注意力 | "[互动] 在座各位有多少人体验过这个功能?" |-| `[过渡]` | 段首承上启下,必须放在每页正文开头 | "[过渡] 了解了背景之后,我们来看看具体怎么做。" |--### 备注写作要点--- **讲故事**:用"场景-冲突-解决"结构组织每页叙事-- **用比喻**:将抽象概念具象化("这就像给系统装了一个涡轮增压器")-- **设悬念**:适时抛出问题,下一页给出答案-- **口语化数据**:30% -> "将近三分之一",2.5 倍 -> "翻了一番还多"-- **要点结构**:`要点:(1)核心信息 (2)支撑论据 (3)行动呼吁`--### 备注示例--```markdown-# 03_核心优势--[过渡] 说完了市场的现状,大家可能会问:那我们的机会在哪里?--我们的核心优势可以用三个词概括:快、准、省。-快——部署时间从 3 个月缩短到 2 周;[停顿]-准——识别准确率达到 97.3%,远超行业平均的 82%;-省——综合成本降低将近三分之一。--[互动] 如果你是决策者,这三个数字中哪个最打动你?--要点:(1)三大差异化优势 (2)量化数据支撑 (3)引导思考-时长:2 分钟-```-------## 自检补充(General 特有)--- [ ] 视觉节奏合理:信息密集页与呼吸页交替-- [ ] 装饰元素适度:服务于内容而非喧宾夺主-- [ ] 图文比例恰当:非纯文字堆砌,有视觉亮点-- [ ] 备注口语化:读出来像说话,而非念稿-------# Executor Consultant -- 咨询风格--> 基础准则见 executor-base.md,技术约束见 shared-standards.md-------## 角色定位--数据驱动的咨询风格 SVG 设计执行师。适用于商业分析报告、市场调研、运营复盘、战略建议等**一般咨询**场景。强调信息的结构化呈现与数据可视化,风格简洁、清晰、专业。-------## Consultant 特有的数据可视化技巧--### 1. KPI 仪表盘设计--KPI 卡片是咨询报告最常用的元素,标准布局(1280x720):--```-4 卡片布局:每卡 280x180,间距 30- 卡片 1: x=45, y=160- 卡片 2: x=355, y=160- 卡片 3: x=665, y=160- 卡片 4: x=975, y=160-```--**卡片内部结构**(自上而下):--| 区域 | 内容 | 字号 | 样式 |-|------|------|------|------|-| 图标行 | data-icon 图标 | 32x32 | 主题色 |-| 指标名 | "月活跃用户" | 14px | 灰色 #64748B |-| 核心数字 | "1.2M" | 36-42px | 粗体,深色 |-| 趋势标注 | "+12.3% vs 上月" | 12px | 绿色=增/红色=降 |--**趋势箭头规范**:-- 上升:`arrow-trend-up` 图标 + 绿色文字-- 下降:`arrow-trend-down` 图标 + 红色文字-- 持平:横线图标 + 灰色文字--### 2. 图表配色规范--咨询风格图表使用**同色系深浅渐变**,而非彩虹色:--```-主系列: 主题色 100% opacity-对比系列: 主题色 60% opacity-基准线: #94A3B8(灰色虚线)-高亮: 强调色(仅用于关键数据点)-```--### 3. 数据标注原则--- **数据标签直接标注**:柱状图顶部放数值,无需图例-- **趋势线加注释**:关键拐点处添加文字说明("政策调整"、"产品上线")-- **对比基准线**:行业均值/目标值用灰色虚线标注-- **单位统一**:同一图表中保持一致的数值单位和精度--### 4. 表格设计--咨询报告经常使用表格呈现精确数据:--| 设计要素 | 规范 |-|----------|------|-| 表头 | 深色背景 + 白色文字,font-weight="bold" |-| 斑马纹 | 奇偶行交替使用 `fill-opacity="0.05"` 的浅色底 |-| 数值对齐 | 数字右对齐,文本左对齐 |-| 高亮行 | 用强调色 `fill-opacity="0.1"` 标记重点行 |-| 边框 | 仅用水平线分隔行,避免完整网格线 |-------## 咨询专用布局模式--### MECE 分解图--主干居左,分支向右展开,互斥穷尽:--```-主指标 ──┬── 分支 A(占比 45%)- ├── 分支 B(占比 30%)- ├── 分支 C(占比 20%)- └── 分支 D(占比 5%)-```--- 使用 `<line>` 连接主干与分支-- 每个分支配 `<rect>` 容器 + 百分比标注-- 总和必须 = 100%(或明确标注"其他")--### 驱动因素树--顶层指标 -> 分解因素 -> 措施,适合业绩归因分析:--```-收入增长 15%- ├── 客单价 +8% → 高端产品线扩展- ├── 客户数 +5% → 新渠道获客- └── 复购率 +2% → 会员体系优化-```--### 左图右文(图表解读)--咨询报告核心版式:左侧放图表,右侧放关键解读:--```-图表区: x=40, y=120, w=700, h=480-解读区: x=780, y=120, w=460, h=480- - 核心结论(粗体,16px)- - 3-5 条 bullet points(14px)- - 数据来源(12px,灰色)-```-------## 专业表达规范--### 页面标题--咨询风格的页面标题应是**观点性标题**(Assertion Headline),而非描述性标题:--| 类型 | 描述性(避免) | 观点性(推荐) |-|------|---------------|---------------|-| 市场 | "市场概况" | "国内市场年增速 23%,显著领先全球均值" |-| 竞品 | "竞品分析" | "三大竞品在渠道覆盖上存在明显短板" |-| 财务 | "财务数据" | "毛利率连续四季度提升,突破行业天花板" |--### 数据源标注--每个含数据的页面底部必须标注来源:--```xml-<text x="40" y="700" font-size="10" fill="#94A3B8">- 来源:国家统计局 2025 年年报;团队内部分析-</text>-```--### 核心观点区--咨询风格内容页应在标题下方设置**核心观点区**(Takeaway Box):--```-位置: x=40, y=80, w=1200, h=50-背景: 浅色主题色底(fill-opacity="0.08")-文本: 14-16px,一句话总结本页核心观点-```-------## 演讲备注风格--### 叙事基调--Consultant 风格的演讲备注采用**结论驱动**的表达,先说结论再展开论据。语气专业、精炼、有说服力。--### 控场标记--| 标记 | 用途 | 示例 |-|------|------|------|-| `[停顿]` | 关键结论后留白,让听众消化 | "这意味着我们的市场份额正在被蚕食。[停顿]" |-| `[数据]` | 提示将数字口语化表达 | "[数据] 85% -> 超过八成客户反馈了这个问题" |-| `[过渡]` | 段首承上启下,必须放在每页正文开头 | "[过渡] 基于刚才的分析,我们来看具体建议。" |--### 备注写作要点--- **结论先行**:每页备注第一句即为核心观点-- **数据口语化**:30% -> "约三成",85% -> "超过八成",2.5x -> "两倍半"-- **论据紧跟**:结论后立即给出 2-3 个支撑数据/事实-- **专业措辞**:使用"洞察"、"驱动因素"、"核心抓手"等咨询术语-- **要点结构**:`要点:(1)核心结论 (2)支撑数据 (3)下一步建议`--### 备注示例--```markdown-# 03_关键发现--[过渡] 基于前面的市场扫描,我们提炼出三个关键发现。--第一,用户增长的主要驱动力正在从获客转向留存。-[数据] 新客获取成本同比上涨了将近四成,但复购率提升贡献了超过六成的收入增量。[停顿]--第二,下沉市场的增速显著高于一二线城市。-第三,25-35 岁女性用户群的 ARPU 值是整体均值的 1.8 倍。--要点:(1)增长引擎从获客转向留存 (2)下沉市场机会窗口 (3)高价值人群画像-时长:2 分钟-```-------## 自检补充(Consultant 特有)--- [ ] 数据与源数据一致,无编造-- [ ] 每个数据页底部有来源标注-- [ ] 页面标题是观点性而非描述性-- [ ] KPI 卡片有趋势箭头和对比标注-- [ ] 图表配色统一,使用同色系而非彩虹色-- [ ] 备注结论先行,数据口语化-------# Executor Consultant Top -- 顶级咨询风格 (MBB 级)--> 基础准则见 executor-base.md,技术约束见 shared-standards.md-------## 角色定位--MBB 级(McKinsey / Bain / BCG)顶级咨询风格的 SVG 设计执行师。适用于战略规划、董事会汇报、投融资路演、高管决策支持等**高端咨询**场景。核心特征:数据驱动洞察、金字塔结构叙事、极致简洁,输出面向 C-level 决策者。-------## SCQA 框架(叙事结构)--每份 MBB 级演示都遵循 SCQA 叙事结构:--| 元素 | 作用 | 典型页面 |-|------|------|---------|-| **S - Situation** | 设定共识背景 | 封面 / 第 1-2 页 |-| **C - Complication** | 引入问题/张力 | 第 2-3 页 |-| **Q - Question** | 隐含或明确的待解决问题 | 过渡页 |-| **A - Answer** | 核心解决方案 | 正文所有页 |--**页面编排**:封面体现 S+C -> Executive Summary 回答 Q -> 章节展开 A -> 结尾回扣 S--**标题写法**:--| SCQA 元素 | 弱标题 | MBB 级标题 |-|-----------|--------|-----------|-| S | "行业背景" | "数字化渗透率突破 60%,行业进入深水区" |-| C | "面临挑战" | "然而三大结构性矛盾制约了规模化落地" |-| Q | "战略问题" | "如何在 18 个月内实现从试点到全面部署?" |-| A | "解决方案" | "三步走路径:聚焦、扩展、规模化" |-------## 数据情境化(永不孤立呈现数据)--> **黄金法则**:永远不会孤立展示单一数据点。每个数字都需要上下文。--| 方法 | 模式 | 视觉实现 |-|------|------|---------|-| **时间对比** | "从 X 到 Y" | 折线图 + 箭头标注变化幅度 |-| **基准对标** | "X vs 行业均值 Y" | 柱状图中加灰色虚线基准线 |-| **竞品对比** | "我方 X vs 竞品 Y" | 并列柱状图,高亮自身数据 |-| **目标差距** | "实际 X / 目标 Y" | 进度条 + 差距标注 |-| **排名定位** | "位列第 N / 共 M" | 横向柱状图 + 高亮标记 |--**数据标注三要素**:每个数据可视化必须包含 (1)数值本身(大字号粗体) (2)对比参照(基准线/同期/竞品) (3)含义解读("So what?")--```xml-<text x="160" y="280" text-anchor="middle" font-size="42" font-weight="bold" fill="#1E293B">97.3%</text>-<text x="160" y="310" text-anchor="middle" font-size="13" fill="#64748B">行业均值 82% | 竞品 A 89%</text>-<text x="160" y="335" text-anchor="middle" font-size="12" fill="#059669">领先行业 15.3 个百分点</text>-```-------## 金字塔原则(结论先行)--> 高管不关心你的*过程*,只关心*结果*。--```- ┌─────────────┐- │ 核心结论 │ ← 页面标题 / Takeaway- └──────┬──────┘- ┌─────────┼─────────┐- ┌───┴───┐ ┌───┴───┐ ┌───┴───┐- │论据 1 │ │论据 2 │ │论据 3 │ ← 主要支撑点- └───────┘ └───────┘ └───────┘-```--| 层级 | 位置 | 字号 |-|------|------|------|-| 核心结论 | Takeaway Box | 16-18px 粗体 |-| 论据 | 内容区主体 | 14-16px |-| 支撑数据 | 图表/卡片 | 12-14px |--**对比**:标题"市场调研结果"(错) -> "元宇宙需要 5-10 年才能规模化"(对);正文"我们调研了...发现了..."(错) -> "三个论据:(1)... (2)... (3)..."(对)-------## MBB 级布局模式--### 内容页标准结构(1280x720)--```-┌──────────────────────────────────┐-│ 渐变顶条 (0,0 → 1280,6) │-├──────────────────────────────────┤-│ 观点性标题 (x=40, y=50, 24px) │-├──────────────────────────────────┤-│ Takeaway Box (x=40, y=75, │ ← 深色背景+白字,一句话结论-│ w=1200, h=45) │-├──────────────────────────────────┤-│ 内容区 (x=40, y=140, │ ← 图表/数据/分析-│ w=1200, h=520) │-├──────────────────────────────────┤-│ 来源 | CONFIDENTIAL | 页码 │ ← y=700, 10px-└──────────────────────────────────┘-```--### 战略路径图--三阶段横排,`<rect rx="8">` + 标题 + 举措列表,`<polygon>` 箭头连接:--```-聚焦核心(0-6月) ──> 扩展能力(6-12月) ──> 规模化(12-18月)-x=40,w=380 x=450,w=380 x=860,w=380-```--### 对标分析矩阵--横向表格,我方行主题色高亮,其他灰色。领先指标绿色标记,落后红色标记。用 `<circle>` 或 `<rect>` 构建评分点。--### 瀑布图(变化归因)--起点 -> 增减因素 -> 终点。正向因素绿色柱,负向红色柱,起止点深色柱,累计线虚线连接。-------## 颜色的战略性使用--MBB 级配色极度克制,颜色为信息服务:--| 用途 | 方法 |-|------|------|-| **聚焦** | 目标数据主题色,其他全灰 |-| **降低认知负荷** | 同系列同色深浅区分(`fill-opacity` 1.0/0.6/0.3) |-| **语义** | 绿=正向,红=负向,灰=基准 |-| **品牌** | 渐变顶条/装饰线用品牌色 |--**戒律**:主色调不超过 3 种;强调色全文仅 2-3 处;数据系列同色系深浅而非不同颜色;背景白色或极浅灰。-------## 图表 vs 表格选择矩阵--| 场景 | 推荐形式 | 原因 |-|------|---------|------|-| 比较 2-7 个类别 | **柱状图** | 视觉对比直观 |-| 时间趋势 | **折线图** | 时间序列清晰 |-| 精确数值/大量排名 | **表格** | 50 个点用柱状图会乱 |-| 占比构成 | **环形图** | 比饼图更现代 |-| 双维度定位 | **2x2 矩阵** | 战略象限分析 |-| 变化归因 | **瀑布图** | 因素拆解 |-------## 演讲备注风格--### 叙事基调--面向**高管/决策者**,金字塔结构,每句话都有信息量。语气沉稳、权威、有洞察力。--### 控场标记--| 标记 | 用途 | 示例 |-|------|------|------|-| `[停顿]` | 关键洞察后留白,让高管消化 | "这意味着我们正在错失千亿级市场。[停顿]" |-| `[环视]` | 观察决策者反应,判断是否展开 | "[环视] 各位如有疑问,我可以展开。" |-| `[数据]` | 数字口语化表达 | "[数据] 63% -> 将近三分之二" |-| `[对标]` | 强调对比基准 | "[对标] 相比行业均值 12%,我们 23% 几乎翻倍" |-| `[过渡]` | 段首承上启下,放在每页正文开头 | "[过渡] 承接战略框架,深入看实施路径。" |--### 备注写作要点--- **金字塔结构**:结论 -> 论据 -> 细节-- **数据情境化**:每个数字有对比参照-- **高管语言**:"战略意义在于..."、"核心洞察是..."-- **备选机制**:标注"时间紧张可略过的内容",支持弹性时长-- **要点结构**:`要点:(1)核心洞察 (2)数据支撑 (3)战略意义`--### 备注示例--```markdown-# 03_战略路径--[过渡] 明确了问题和机会之后,接下来是最关键的——我们的应对路径。--我们建议三步走策略。[停顿]--第一步,聚焦。未来六个月集中资源攻克华东市场。-[数据] 华东贡献了将近三分之二的行业增量,[对标] 但我们渗透率仅为竞品 A 的一半。[停顿]--第二步,扩展。以华东为样板,复制到华南和华北。-第三步,规模化。借助数字化平台实现全国覆盖。--[环视] 第一步的资源配置详见附录,需要现在展开吗?--要点:(1)聚焦-扩展-规模化三步走 (2)华东优先的数据支撑 (3)18 个月全面部署-时长:3 分钟-备选:[时间紧张可跳过二三步细节,直接到财务影响]-```-------## MBB 级质量检查补充--### 内容层面--- [ ] **SCQA 完整**:整体遵循情境-复杂性-问题-答案结构-- [ ] **数据情境化**:每个数据点有对比参照-- [ ] **结论先行**:每页 Takeaway Box 有一句话结论-- [ ] **MECE 原则**:分类分析互斥穷尽--### 视觉层面--- [ ] **颜色有意图**:配色服务于信息传达-- [ ] **留白充足**:不拥挤,让信息"呼吸"-- [ ] **视觉层次**:结论 > 论据 > 细节,字号/粗细区分-- [ ] **品牌一致**:渐变顶条、页脚全文统一--### 备注层面--- [ ] **金字塔结构**:每页结论先行-- [ ] **控场标记完整**:关键位置有 [停顿][环视]-- [ ] **备选内容标注**:支持弹性时长--------# Optimizer CRAP — 视觉优化角色--## 核心使命--严格遵循 CRAP 设计原则,分析并重构单页 SVG 代码,输出视觉更专业、结构更清晰的新版本。支持所有画布格式,根据原始 SVG 画布尺寸进行优化。--## 使用模式--| 模式 | 触发方式 | 说明 |-|------|----------|------|-| 独立使用 | 提供 SVG 文件/代码 | 对任意 SVG 进行视觉优化 |-| 流程中使用 | `generate-ppt` 后可选优化 | 优化 Executor 生成的 SVG |--> 流程中下一步:后处理 + 导出 PPTX--## 工作流程--1. 接收原始 SVG 代码-2. 识别画布格式(`width`、`height`、`viewBox`)-3. (可选)分析参考 SVG 了解总体风格-4. 按四大核心原则诊断和重构-5. 保持画布尺寸不变-6. 输出优化后 SVG,文件名前加 `yh_`-7. 输出优化报告-------## 四大核心设计原则--### 1. 对齐 (Alignment)--- **诊断**:检查是否存在随意放置的元素-- **优化**:严格对齐所有元素,创建强大的视觉连接线(左对齐、居中或右对齐),任何元素的位置都必须与其他元素存在明确的对齐关系-- **参考**:元素坐标偏差控制在 5px 以内--**常见技巧**:-- 将分散元素统一到同一条垂直或水平线上-- 使用一致的左/右边距-- 标题、正文、注释起始位置保持对齐--### 2. 对比 (Contrast)--- **诊断**:检查元素间是否有足够的视觉层次,重点信息是否突出-- **优化**:让不同元素**截然不同**,通过显著加大尺寸、字重或颜色差异突出最重要的信息-- **参考**:标题字号比正文大 1.3-2 倍--**常见技巧**:-- 放大关键数字或标题字号-- 用粗体突出重点词汇-- 用强调色标注核心信息-- 通过明暗对比区分前景与背景--### 3. 重复 (Repetition)--- **诊断**:检查同类元素的视觉风格是否统一-- **优化**:有意识地重复使用视觉元素(颜色、字体样式、圆角大小、线条粗细),创造组织性和统一性-- **参考**:同类元素保持风格一致--**常见技巧**:-- 统一所有卡片的圆角半径-- 统一同级标题的字号和颜色-- 重复使用相同的图标风格-- 保持一致的间距系统--### 4. 亲密性 (Proximity)--- **诊断**:检查逻辑相关的内容在空间上是否足够靠近-- **优化**:将关联项目在空间上靠近,组织成视觉单元;加大不同组块间的距离-- **参考**:相关元素靠近,不相关元素分开--**常见技巧**:-- 缩小标题与其下方内容的间距-- 加大不同章节之间的间距-- 将图表与标签组合成视觉单元-- 用分组线或背景色强化关联性-------## 可选补充原则--仅在用户明确要求时应用:--### 5. 留白 (White Space)--触发词:"增加留白"、"提升高级感"。增加元素间距,给设计留出呼吸空间。--### 6. 降噪 (Noise Reduction)--触发词:"简化设计"、"减少干扰"。移除冗余元素,简化复杂效果,聚焦核心信息。-------## 优化报告格式--```-## 优化报告--### 主要优化点-1. [对齐] 具体修改说明-2. [对比] 具体修改说明-3. [重复] 具体修改说明-4. [亲密性] 具体修改说明--### 优化效果-简要说明整体优化效果和视觉改进。-```--## 技术约束--- **保持画布尺寸**:优化后 SVG 的 `width`、`height`、`viewBox` 与原始一致-- **文本处理**:保持 `<tspan>` 换行-- **文件命名**:`yh_原文件名.svg`-- SVG 禁用功能与 PPT 兼容性规则见 shared-standards.md--------# Template Designer — 模板设计角色--## 核心使命--基于《设计规范与内容大纲》生成项目专属的页面模板,供用户确认后用于批量内容生成。--> 这是一个独立角色:仅通过 `/create-template` 工作流触发,不在 PPT 生成流程中使用。--## 使用方式--- **触发方式**:`/create-template` 工作流-- **输出位置**:`templates/layouts/<模板名称>/`-------## 核心模板清单--| 序号 | 文件名 | 用途 | 说明 |-|------|--------|------|------|-| 01 | `01_cover.svg` | 封面 | 固定结构:标题、副标题、日期、机构 |-| 02 | `02_chapter.svg` | 章节页 | 固定结构:章节编号、章节标题 |-| 03 | `03_content.svg` | 内容页 | 灵活结构:只定义页眉页脚,内容区由 AI 自由布局 |-| 04 | `04_ending.svg` | 结束页 | 固定结构:感谢语、联系方式 |-| -- | `02_toc.svg` | 目录页 | 可选:目录标题、章节列表(编号+标题) |--**设计理念**:模板定义视觉一致性和结构性页面,内容页保持最大灵活性。--**命名说明**:目录页保持 `02_toc.svg` 命名以兼容模板库与排序规则。--### 可选扩展页(按需)--- 过渡页 / 小节页(如 `05_section_break.svg`)-- 附录页(如 `06_appendix.svg`)-- 免责声明 / 保密页(如 `07_disclaimer.svg`)-------## 模板设计规范--### 1. 必须生成 design_spec.md--创建全局模板时,必须生成 `design_spec.md`,包含:--```markdown-# [模板名称] - 设计规范--## 一、模板概述(名称、适用场景、设计调性)-## 二、画布规范(16:9, 1280x720, viewBox)-## 三、配色方案(主色、辅助色、强调色 HEX 值)-## 四、排版体系(字体栈、字号层级)-## 五、页面结构(通用布局、装饰设计)-## 六、页面类型(4 种核心页面)-## 七、布局模式(推荐)-## 八、间距规范-## 九、SVG 技术约束-## 十、占位符规范-```--### 2. 继承设计规范--模板必须严格遵循《设计规范与内容大纲》中的:-- **画布尺寸**:viewBox 与设计规范一致-- **配色方案**:使用规范中的主导色、辅助色、强调色-- **字体方案**:使用规范中的字体预设-- **布局原则**:边距、间距符合规范--### 3. 占位符标记--使用明确的占位符标记可替换内容:--```xml-<!-- 文本占位符 -->-<text x="80" y="320" fill="#FFFFFF" font-size="48" font-weight="bold">- {{TITLE}}-</text>--<!-- 内容区占位符(内容页专用) -->-<rect x="40" y="90" width="1200" height="550" fill="#FFFFFF" rx="8"/>-<text x="640" y="365" text-anchor="middle" fill="#CBD5E1" font-size="16">- {{CONTENT_AREA}}-</text>-```--### 4. 占位符规范--| 占位符 | 用途 | 适用模板 |-|--------|------|----------|-| `{{TITLE}}` | 主标题 | 封面 |-| `{{SUBTITLE}}` | 副标题 | 封面 |-| `{{DATE}}` | 日期 | 封面 |-| `{{AUTHOR}}` | 作者/机构 | 封面 |-| `{{TOC_TITLE}}` | 目录标题 | 目录页 |-| `{{TOC_ITEMS}}` | 目录项列表 | 目录页 |-| `{{CHAPTER_NUM}}` | 章节编号 | 章节页 |-| `{{CHAPTER_TITLE}}` | 章节标题 | 章节页 |-| `{{CHAPTER_DESC}}` | 章节描述 | 章节页 |-| `{{PAGE_TITLE}}` | 页面标题 | 内容页 |-| `{{KEY_MESSAGE}}` | 核心观点 | 内容页(咨询风格) |-| `{{CONTENT_AREA}}` | 内容区域 | 内容页 |-| `{{SECTION_NAME}}` | 章节名称 | 内容页页脚 |-| `{{SOURCE}}` | 数据来源 | 内容页页脚 |-| `{{PAGE_NUM}}` | 页码 | 内容页、结束页 |-| `{{THANK_YOU}}` | 感谢语 | 结束页 |-| `{{TAGLINE}}` | 口号 | 结束页 |-| `{{CONTACT_INFO}}` | 联系信息 | 结束页 |-| `{{COPYRIGHT}}` | 版权 | 结束页 |-------## 输出要求--### 文件保存位置--```-templates/layouts/<模板名称>/-├── design_spec.md # 设计规范(必须)-├── 01_cover.svg-├── 02_chapter.svg-├── 02_toc.svg # 可选-├── 03_content.svg-├── 04_ending.svg-└── *.png / *.jpg # 图片资源(如有)-```--### 模板预览--每个模板生成后,提供简要说明表格,列出各模板状态。-------## 使用预置模板库(可选)--如已有适合的模板资源,可直接使用而非生成新模板:--1. **复制模板**:将模板文件复制到项目 `templates/` 目录-2. **调整配色**:根据项目设计规范修改颜色-3. **自定义修改**:根据项目特点个性化调整--**示例库结构**(查询 `templates/layouts/layouts_index.json`):--```-templates/layouts/-├── general/ # 通用灵活风格-├── consultant/ # 咨询风格-└── consultant_top/ # 顶级咨询风格(MBB级)-```-------## 阶段完成检查点--```markdown-## Template_Designer 阶段完成--- [x] 已阅读 `roles/Template_Designer.md`-- [x] 已生成 4 个核心页面模板-- [ ] 目录页模板(可选)-- [ ] 可选扩展页(如需)-- [x] 所有模板已保存到 `templates/` 目录-- [x] 模板遵循设计规范(配色、字体、布局)-- [x] 占位符标记清晰规范-- [ ] **下一步**: 请用户确认模板-```--------# 图片布局规范(强制执行)--含图片页面的布局规则。Strategist 规划阶段、Executor 生成阶段都必须遵循。--**核心原则:根据图片原始比例计算布局,确保图片完整展示,杜绝留白或裁切。**-------## 布局决策流程--```-1. 获取图片原始尺寸 → 计算比例 (宽/高)-2. 根据比例选择布局类型-3. 计算图片最大展示尺寸-4. 分配剩余空间给文字区域-5. 将结果填入《设计规范与内容大纲》的图片资源清单-```--**执行时机**:若图片方案包含「B) 用户提供」,在 Strategist 阶段完成八项确认后、进入内容分析与大纲编制之前,必须运行扫描并填充图片资源清单。-------## 布局类型选择(强制)--| 图片比例 | 布局类型 | 图片位置 | 说明 |-|----------|----------|----------|------|-| > 2.0 (超宽) | 上下分栏 | 上方通栏 | 图片占画布宽度,高度按比例 |-| 1.5-2.0 (宽幅) | 上下分栏 | 上方 | 图片宽度=内容区宽度,高度按比例 |-| 1.2-1.5 (标准) | 左右分栏 | 左侧 | 图片高度优先适配,宽度按比例 |-| 0.8-1.2 (方形) | 左右分栏 | 左侧 | 图片取内容区高度,宽度按比例 |-| < 0.8 (竖图) | 左右分栏 | 左侧 | 图片高度=内容区高度,宽度按比例 |--> 边界情况:比例处于边界值时(如 1.5),根据文字量判断。文字多选左右,文字少选上下。-------## 尺寸计算公式--### PPT 16:9 (1280x720) 画布参数--```-画布: 1280 x 720 px-内容区: 1160 x 640 px (左右边距 60px, 上下边距 40px)-标题区高度: 60 px-内容起点: y = 80 px (标题 + 间距)-```--### 上下布局计算--```-图片宽度 = W = 1160 px-图片高度 = W / R = 1160 / R px-文字区高度 = H - 图片高度 - 间距(20px)--验证:文字区高度 >= 150px (至少 3-4 行文字)-若不满足 → 改用左右布局-```--### 左右布局计算--**方式 1(高度优先,适用于竖图)**:-```-图片高度 = H = 600 px-图片宽度 = H x R = 600 x R px-文字区宽度 = W - 图片宽度 - 间距(20px)-```--**方式 2(宽度受限,适用于宽图转左右)**:-```-图片宽度 = W x 0.7 = 812 px-图片高度 = 图片宽度 / R-文字区宽度 = W - 图片宽度 - 间距(20px)-```--**验证**:文字区宽度 >= 280px,否则需减小图片区宽度。-------## 布局示例--### 超宽图 (比例 2.45)--```-原图: 1960x800, R=2.45 → 上下分栏-图片: 1160x473, 文字区: 1160x147 → 上下 7:3-```--### 标准横图 (比例 1.38)--```-原图: 1614x1171, R=1.38 → 左右分栏-图片: 773x560 (左侧), 文字区: 367x560 (右侧) → 左右 7:3-```--### 宽幅图边界情况 (比例 1.75)--```-原图: 1820x1040, R=1.75-尝试上下: 图片高度=663, 文字区=-43 ❌-改用左右: 图片 780x446 (左侧), 文字区 360x600 (右侧) → 左右 7:3-```-------## 禁止事项--| 禁止 | 正确做法 |-|------|---------|-| 固定使用 50:50 或任意比例 | 根据图片比例动态计算 |-| 将宽图塞入方形容器 | 使用上下布局或加大图片区宽度 |-| 将竖图放入横向窄条 | 使用左右布局,图片在左 |-| 图片留白超过 10% | 重新计算布局或选择其他方案 |-| 裁切图片关键内容 | 使用 `preserveAspectRatio="xMidYMid meet"` |-| 文字区太小无法阅读 | 确保文字区 >= 150px(上下)或 >= 280px(左右) |-------## SVG 图片嵌入代码--### 完整展示(推荐用于数据图表)--```xml-<image href="../images/xxx.png"- x="60" y="80" width="780" height="446"- preserveAspectRatio="xMidYMid meet"/>-```--### 裁切填充(仅用于背景图)--```xml-<image href="../images/bg.png"- x="0" y="0" width="1280" height="720"- preserveAspectRatio="xMidYMid slice"/>-```-------## 图片资源清单模板--在《设计规范与内容大纲》中,图片资源清单必须包含:--| 字段 | 说明 | 示例 |-|------|------|------|-| 文件名 | 图片文件名 | `p12_0.png` |-| 原始尺寸 | 宽x高 | 1524x968 |-| 比例 | 宽/高 | 1.57 |-| 页码 | 使用页码 | 第5页 |-| 类型 | 视觉类型 | 背景图/实景照片/插画配图/图表架构/装饰图案 |-| 布局方案 | 上下/左右 + 分栏比 | 上下 6:4 或 左右 7:3 |-| 图片区域 | 图片展示尺寸 | 1160x420 或 780x446 |-| 文字区域 | 剩余空间尺寸 | 1160x200 或 360x600 |--**类型字段用于 Image_Generator 选择合适的提示词策略。**-------## 自动化工具--```bash-python3 scripts/analyze_images.py <项目路径>/images-```--输出包含尺寸、比例、布局建议(Markdown 表格),可直接用于填写图片资源清单。-------## 角色职责--| 角色 | 职责 |-|------|------|-| **Strategist** | 运行 analyze_images.py,按本规范计算布局,填写图片资源清单 |-| **Executor** | 严格按图片资源清单中的布局方案和尺寸生成 SVG |--------# SVG 图片嵌入指南--在 SVG 文件中添加图片的技术规范和推荐工作流。-------## 图片资源清单格式--在《设计规范与内容大纲》中定义,每张图片标注状态。若图片方案包含「B) 用户提供」,需在 Strategist 阶段完成八项确认后立即运行 `analyze_images.py`,并在输出设计规范前完成清单填充。--```markdown-| 文件名 | 尺寸 | 用途 | 状态 | 生成描述 |-|--------|------|------|------|----------|-| cover_bg.png | 1280x720 | 封面背景 | 待生成 | 现代科技感抽象背景,深蓝渐变 |-| product.png | 600x400 | 第3页 | 已有 | - |-| team.png | 600x400 | 第5页 | 占位符 | 团队协作场景(后期补充) |-```--### 三种状态的处理--| 状态 | 含义 | Executor 处理方式 |-|------|------|-------------------|-| **待生成** | 需 AI 生成,有描述 | 先生成图片放入 `images/`,再用 `<image>` 引用 |-| **已有** | 用户已有图片 | 放入 `images/`,用 `<image>` 引用 |-| **占位符** | 暂不处理 | 用虚线框占位,后期替换 |-------## 工作流程--```-1. Strategist 定义图片需求 → 添加图片资源清单,标注每张状态-2. 图片准备(待生成/已有)→ 放入 项目/images/-3. Executor 生成 SVG(svg_output/)- ├── 已有/待生成 → <image href="../images/xxx.png" .../>- └── 占位符 → 虚线框 + 描述文本-4. 预览:python3 -m http.server -d <项目路径> 8000 → /svg_output/<文件名>.svg-5. 后处理与导出- ├── python3 scripts/finalize_svg.py <项目路径>- └── python3 scripts/svg_to_pptx.py <项目路径> -s final-```--> 推荐:生成阶段在 `svg_output/` 保留外部引用,后处理通过 `finalize_svg.py` 自动嵌入图片到 `svg_final/`,再从 `svg_final/` 导出 PPTX。-------## 外部引用 vs Base64 内嵌--| 方式 | 优点 | 缺点 | 适用场景 |-|------|------|------|----------|-| **外部引用** | 文件小、迭代快、便于替换 | 预览需从项目根起 HTTP 服务 | `svg_output/` 开发阶段 |-| **Base64 内嵌** | 文件独立、导出稳定 | 文件体积大 | `svg_final/` 交付阶段 |-------## 方式一:外部引用(生成阶段推荐)--### 语法--```xml-<image href="../images/image.png" x="0" y="0" width="1280" height="720"- preserveAspectRatio="xMidYMid slice"/>-```--### 关键属性--| 属性 | 说明 | 示例 |-|------|------|------|-| `href` | 图片路径(相对或绝对) | `"../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 -d <项目路径> 8000-# 访问 http://localhost:8000/svg_output/your_file.svg-```-------## 方式二:Base64 内嵌(交付阶段推荐)--### 语法--```xml-<image href="data:image/png;base64,iVBORw0KGgo..." x="0" y="0" width="1280" height="720"/>-```--### MIME 类型--| MIME 类型 | 文件格式 |-|-----------|----------|-| `image/png` | PNG |-| `image/jpeg` | JPG/JPEG |-| `image/gif` | GIF |-| `image/webp` | WebP |-| `image/svg+xml` | SVG |-------## 转换流程--### 推荐:统一走 finalize_svg.py--```bash-python3 scripts/finalize_svg.py <项目路径> # 图标、图片、文本、圆角一次处理-python3 scripts/svg_to_pptx.py <项目路径> -s final # 从最终版本导出 PPTX-```--### 独立使用 embed_images.py(高级用法)--仅处理特定 SVG 而不跑完整后处理时:--```bash-python3 scripts/embed_images.py <svg文件> # 单个-python3 scripts/embed_images.py <项目路径>/svg_output/*.svg # 批量-python3 scripts/embed_images.py --dry-run <项目路径>/svg_output/*.svg # 预览-```-------## 最佳实践--### 图片优化--嵌入前压缩图片以减少文件体积:--```bash-convert input.png -quality 85 -resize 1920x1080\> output.png # ImageMagick-pngquant --quality=65-80 input.png -o output.png # pngquant(推荐)-```--### 文件组织--```-project/-├── images/ # 图片资源-├── sources/ # 源文件及其附带图片-│ └── article_files/-├── svg_output/ # 原始版本(外部引用)-└── svg_final/ # 最终版本(已嵌入图片)-```--### 圆角处理(禁止 clipPath)--由于 `clipPath` 在 PPT 中不兼容,禁止使用裁剪路径为图片加圆角。替代方案:-- 生成图片时直接处理圆角(导出为带圆角的 PNG)-- 或用同尺寸圆角矩形覆盖边缘(视觉模拟)-------## 常见问题--**Q: 直接打开 SVG 看不到图片?**-浏览器安全策略阻止跨目录请求。从项目根目录启动 HTTP 服务器,或先运行 `finalize_svg.py` 再查看 `svg_final/`。--**Q: Base64 文件太大?**-压缩原始图片、使用 JPEG 格式、降低分辨率(匹配实际显示尺寸即可)。--**Q: 如何反向提取 Base64 图片?**-```bash-base64 -d image.b64 > image.png-```diff --git a/.github/workflows/deploy-pages.yml b/.github/workflows/deploy-pages.ymldeleted file mode 100644index a866aa5d..00000000--- a/.github/workflows/deploy-pages.yml+++ /dev/null@@ -1,53 +0,0 @@-# GitHub Pages 部署工作流-# 自动将 PPT Master 示例项目部署到 GitHub Pages--name: Deploy to GitHub Pages--on:- # 推送到 main 分支时触发- push:- branches: ["main"]- # 允许手动触发- workflow_dispatch:--# 设置 GITHUB_TOKEN 权限-permissions:- contents: read- pages: write- id-token: write--# 防止并发部署-concurrency:- group: "pages"- cancel-in-progress: false--jobs:- # 构建任务- build:- runs-on: ubuntu-latest- steps:- - name: Checkout- uses: actions/checkout@v4-- - name: Setup Pages- uses: actions/configure-pages@v4- with:- enablement: true-- - name: Upload artifact- uses: actions/upload-pages-artifact@v3- with:- # 上传整个仓库(包含 examples、templates 等)- path: '.'-- # 部署任务- deploy:- environment:- name: github-pages- url: ${{ steps.deployment.outputs.page_url }}- runs-on: ubuntu-latest- needs: build- steps:- - name: Deploy to GitHub Pages- id: deployment- uses: actions/deploy-pages@v4diff --git a/.windsurf/rules/ppt-master.md b/.windsurf/rules/ppt-master.mddeleted file mode 100644index d68bf474..00000000--- a/.windsurf/rules/ppt-master.md+++ /dev/null@@ -1,2914 +0,0 @@-<!-- AUTO-GENERATED by build_adapters.py — DO NOT EDIT MANUALLY -->-<!-- Source: skills/ppt-master/ | Generated: 2026-03-20 -->--# PPT Master — AI 驱动的 SVG 内容生成系统--> 本文件由 `build_adapters.py` 从 `skills/ppt-master/` 自动生成。--# PPT Master Skill--> AI 驱动的多格式 SVG 内容生成系统。通过多角色协作将源文档转化为高质量 SVG 页面并导出 PPTX。--**核心流程**:`源文档 → 创建项目 → 模板选项 → Strategist → [Image_Generator] → Executor → 后处理 → 导出`--## 脚本目录--| 脚本 | 用途 |-|------|------|-| `skills/ppt-master/scripts/pdf_to_md.py` | PDF 转 Markdown |-| `skills/ppt-master/scripts/web_to_md.py` | 网页转 Markdown |-| `skills/ppt-master/scripts/web_to_md.cjs` | 微信/高防站点转 Markdown |-| `skills/ppt-master/scripts/project_manager.py` | 项目初始化/验证/管理 |-| `skills/ppt-master/scripts/analyze_images.py` | 图片分析 |-| `skills/ppt-master/scripts/nano_banana_gen.py` | AI 图片生成(Gemini API) |-| `skills/ppt-master/scripts/svg_quality_checker.py` | SVG 质量检查 |-| `skills/ppt-master/scripts/total_md_split.py` | 演讲备注拆分 |-| `skills/ppt-master/scripts/finalize_svg.py` | SVG 后处理(统一入口) |-| `skills/ppt-master/scripts/svg_to_pptx.py` | 导出 PPTX |--## 模板与资源--| 资源 | 路径 |-|------|------|-| 页面布局模板 | `skills/ppt-master/templates/layouts/` |-| 图表 SVG 模板 | `skills/ppt-master/templates/charts/` |-| 矢量图标库 (640+) | `skills/ppt-master/templates/icons/` |-| 模板索引 | `skills/ppt-master/templates/layouts/layouts_index.json` |-| 设计规范参考 | `skills/ppt-master/templates/design_spec_reference.md` |-------## 工作流--### Step 0: 偏好加载 ⛔ BLOCKING--检查用户偏好配置:-1. 项目级: `.ppt-master/EXTEND.md`-2. 用户级: `$HOME/.ppt-master/EXTEND.md`--如果存在,读取并应用偏好(默认风格、默认格式等)。-------### Step 1: 源内容处理--当用户提供非 Markdown 内容时,必须立即转换:--| 用户提供 | 命令 |-|----------|------|-| PDF 文件 | `python3 skills/ppt-master/scripts/pdf_to_md.py <文件>` |-| 网页链接 | `python3 skills/ppt-master/scripts/web_to_md.py <URL>` |-| 微信/高防站 | `node skills/ppt-master/scripts/web_to_md.cjs <URL>` |-| Markdown | 直接读取 |-------### Step 2: 项目初始化--```bash-python3 skills/ppt-master/scripts/project_manager.py init <项目名> --format <格式>-```--格式选项:`ppt169`(默认)、`ppt43`、`xhs`、`story` 等。完整格式列表见 `skills/ppt-master/references/canvas-formats.md`。--如需导入源文件:-```bash-python3 skills/ppt-master/scripts/project_manager.py import-sources <项目路径> <源文件...>-```-------### Step 3: 模板选择--向用户确认(二选一):--**A) 使用已有模板**-1. 查询 `skills/ppt-master/templates/layouts/layouts_index.json` 确认可用模板-2. 复制模板文件到项目目录:- ```bash- cp skills/ppt-master/templates/layouts/<模板名>/*.svg <项目路径>/templates/- cp skills/ppt-master/templates/layouts/<模板名>/design_spec.md <项目路径>/templates/- cp skills/ppt-master/templates/layouts/<模板名>/*.png <项目路径>/images/ 2>/dev/null || true- cp skills/ppt-master/templates/layouts/<模板名>/*.jpg <项目路径>/images/ 2>/dev/null || true- ```--**B) 不使用模板** → 自由设计--> 如需创建新模板,Read `skills/ppt-master/references/template-designer.md`-------### Step 4: Strategist 阶段(必须,不可跳过)--⛔ **BLOCKING**: 先读取角色定义:-```-Read skills/ppt-master/references/strategist.md-Read skills/ppt-master/references/shared-standards.md-```--**必须完成八项确认**:-1. 画布格式-2. 页数范围-3. 目标受众-4. 风格目标-5. 配色方案-6. 图标使用方式-7. 图片使用方式-8. 排版方案--如用户提供了图片:-```bash-python3 skills/ppt-master/scripts/analyze_images.py <项目路径>/images-```--**输出**:`<项目路径>/设计规范与内容大纲.md`--**检查点**:-```markdown-## ✅ Strategist 阶段完成-- [x] 已完成八项确认-- [x] 已生成《设计规范与内容大纲》-- [ ] **下一步**: [Image_Generator / Executor]-```-------### Step 5: Image_Generator 阶段(条件触发)--> **触发条件**:图片方式包含「AI 生成」--⛔ **BLOCKING**: Read `skills/ppt-master/references/image-generator.md`--1. 从设计规范中提取所有「状态=待生成」的图片-2. 生成提示词文档 → `<项目路径>/images/image_prompts.md`-3. 生成图片(推荐命令行工具):- ```bash- python3 skills/ppt-master/scripts/nano_banana_gen.py "提示词" --aspect_ratio 16:9 --image_size 1K -o <项目路径>/images- ```--**检查点**:-```markdown-## ✅ Image_Generator 阶段完成-- [x] 提示词文档已创建-- [x] 所有图片已保存到 images/-```-------### Step 6: Executor 阶段--⛔ **BLOCKING**: 根据风格选择读取角色定义:-```-Read skills/ppt-master/references/executor-base.md # 必读:公共准则-Read skills/ppt-master/references/executor-general.md # 通用灵活风格-Read skills/ppt-master/references/executor-consultant.md # 咨询风格-Read skills/ppt-master/references/executor-consultant-top.md # 顶级咨询风格(MBB级)-```--> 只需读 executor-base + 一个风格文件即可。--**视觉构建阶段**:-- 批量生成 SVG 页面 → `<项目路径>/svg_output/`--**逻辑构建阶段**:-- 生成演讲备注 → `<项目路径>/notes/total.md`--**检查点**:-```markdown-## ✅ Executor 阶段完成-- [x] 所有 SVG 已生成到 svg_output/-- [x] 演讲备注已生成 notes/total.md-```-------### Step 7: 后处理与导出--> ⚠️ 必须按顺序执行,不可省略或替换!--```bash-# 1. 拆分演讲备注-python3 skills/ppt-master/scripts/total_md_split.py <项目路径>--# 2. SVG 后处理(图标嵌入/图片裁剪嵌入/文本扁平化/圆角转Path)-python3 skills/ppt-master/scripts/finalize_svg.py <项目路径>--# 3. 导出 PPTX(默认嵌入演讲备注)-python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s final-```--> ❌ **禁止**用 `cp` 替代 `finalize_svg.py`,该工具执行多项关键处理-> ❌ **禁止**从 `svg_output/` 直接导出,必须用 `-s final` 从 `svg_final/` 导出-------### Step 8: Optimizer 阶段(可选)--> **触发条件**:用户要求优化,或设计质量需要提升--Read `skills/ppt-master/references/optimizer-crap.md`--优化后需重新执行 Step 7(后处理与导出)。-------## 角色切换协议--切换角色前**必须先读取**对应的 reference 文件,禁止跳过。输出标记:--```markdown-## 【角色切换:[角色名称]】-📖 阅读角色定义: skills/ppt-master/references/[文件名].md-📋 当前任务: [简述]-```-------## 参考资源--| 资源 | 路径 |-|------|------|-| 公共技术约束 | `skills/ppt-master/references/shared-standards.md` |-| 画布格式规范 | `skills/ppt-master/references/canvas-formats.md` |-| 设计指南 | `skills/ppt-master/references/design-guidelines.md` |-| 图片布局规范 | `skills/ppt-master/references/image-layout-spec.md` |-| SVG 图片嵌入 | `skills/ppt-master/references/svg-image-embedding.md` |-------## 注意事项--- 后处理三步不要添加 `--only` 等额外参数,直接运行即可-- 如果执行了 Optimizer 优化,需重新运行后处理与导出-- 本地预览:`python3 -m http.server -d <项目路径>/svg_final 8000`-------------# Shared Technical Standards--PPT Master 公共技术约束,消除跨角色文件重复。-------## 1. SVG 禁用功能黑名单--以下功能在生成 SVG 时**绝对禁止**使用,否则 PPT 导出将出错:--| 禁止功能 | 说明 |-|----------|------|-| `clipPath` | 裁剪路径 |-| `mask` | 遮罩 |-| `<style>` | 内嵌样式表 |-| `class` / `id` | CSS 选择器属性 |-| 外部 CSS | 外部样式表链接 |-| `<foreignObject>` | 嵌入外部内容 |-| `<symbol>` + `<use>` | 符号引用复用 |-| `textPath` | 沿路径排列文本 |-| `@font-face` | 自定义字体声明 |-| `<animate*>` / `<set>` | SVG 动画 |-| `<script>` / 事件属性 | 脚本与交互 |-| `marker` / `marker-end` | 线段端点标记 |-| `<iframe>` | 内嵌框架 |-------## 2. PPT 兼容性替代方案--| 禁止写法 | 正确替代 |-|----------|---------|-| `fill="rgba(255,255,255,0.1)"` | `fill="#FFFFFF" fill-opacity="0.1"` |-| `<g opacity="0.2">...</g>` | 每个子元素单独设置 `fill-opacity` / `stroke-opacity` |-| `<image opacity="0.3"/>` | 图片后叠加 `<rect fill="背景色" opacity="0.7"/>` 遮罩层 |-| `marker-end` 箭头 | 用 `<polygon>` 绘制三角形箭头 |--**记忆口诀**:PPT 不认 rgba、不认组透明、不认图片透明、不认 marker。-------## 3. 画布格式速查--### 演示文稿--| 格式 | viewBox | 尺寸 | 比例 |-|------|---------|------|------|-| PPT 16:9 | `0 0 1280 720` | 1280x720 | 16:9 |-| PPT 4:3 | `0 0 1024 768` | 1024x768 | 4:3 |--### 社交媒体--| 格式 | viewBox | 尺寸 | 比例 |-|------|---------|------|------|-| 小红书 | `0 0 1242 1660` | 1242x1660 | 3:4 |-| 朋友圈 / Instagram Post | `0 0 1080 1080` | 1080x1080 | 1:1 |-| Story / 抖音竖屏 | `0 0 1080 1920` | 1080x1920 | 9:16 |--### 营销物料--| 格式 | viewBox | 尺寸 | 比例 |-|------|---------|------|------|-| 微信公众号头图 | `0 0 900 383` | 900x383 | 2.35:1 |-| 横版 Banner | `0 0 1920 1080` | 1920x1080 | 16:9 |-| 竖版海报 | `0 0 1080 1920` | 1080x1920 | 9:16 |-| A4 打印 (150dpi) | `0 0 1240 1754` | 1240x1754 | 1:1.414 |-------## 4. 基础 SVG 规则--- **viewBox** 必须与画布尺寸一致(`width`/`height` 与 `viewBox` 匹配)-- **背景**:用 `<rect>` 定义页面背景色-- **换行**:用 `<tspan>` 手动换行,禁止 `<foreignObject>`-- **字体**:仅使用系统字体(微软雅黑、Arial、Calibri 等),禁止 `@font-face`-- **样式**:仅使用内联样式(`fill="..."` `font-size="..."`),禁止 `<style>` / `class` / `id`-- **颜色**:使用 HEX 值,透明度用 `fill-opacity` / `stroke-opacity`-- **图片引用**:`<image href="../images/xxx.png" preserveAspectRatio="xMidYMid slice"/>`-- **图标占位**:`<use data-icon="icon-name" x="" y="" width="48" height="48" fill="#HEX"/>`(后处理自动嵌入)-------## 5. 后处理三步命令--必须按顺序执行,不可跳过或添加额外参数:--```bash-# 1. 拆分讲稿到各页备注文件-python3 scripts/total_md_split.py <项目路径>--# 2. SVG 后处理(图标嵌入、图片裁剪/嵌入、文本扁平化、圆角矩形转 Path)-python3 scripts/finalize_svg.py <项目路径>--# 3. 导出 PPTX(从 svg_final/ 导出,默认嵌入演讲备注)-python3 scripts/svg_to_pptx.py <项目路径> -s final-```--**禁止事项**:-- 禁止用 `cp` 替代 `finalize_svg.py`-- 禁止从 `svg_output/` 直接导出,必须从 `svg_final/`(`-s final`)导出-- 禁止添加 `--only` 等额外参数-- Optimizer 优化后需重新执行全部三步-------## 6. 项目目录结构--```-project/-├── svg_output/ # 原始 SVG(Executor 输出,含占位符)-├── svg_final/ # 后处理完成的最终 SVG(finalize_svg.py 输出)-├── images/ # 图片资源(用户提供 + AI 生成)-├── notes/ # 演讲备注(与 SVG 同名的 .md 文件)-│ └── total.md # 完整演讲备注文稿(拆分前)-├── templates/ # 项目使用的模板(如有)-└── *.pptx # 导出的 PPT 文件-```-------# 画布格式规范---## 格式速查表--| 格式 | viewBox | 比例 | 适用场景 |-|------|---------|------|---------|-| PPT 16:9 | `0 0 1280 720` | 16:9 | 商业演示、会议汇报 |-| PPT 4:3 | `0 0 1024 768` | 4:3 | 传统投影、学术演讲 |-| 小红书 | `0 0 1242 1660` | 3:4 | 图文分享、知识帖 |-| 朋友圈/IG | `0 0 1080 1080` | 1:1 | 方形海报、品牌展示 |-| Story/抖音 | `0 0 1080 1920` | 9:16 | 竖屏快拍、短视频封面 |-| 公众号头图 | `0 0 900 383` | 2.35:1 | 微信公众号文章配图 |-| 横版Banner | `0 0 1920 1080` | 16:9 | 网页Banner、电子屏 |-| 竖版海报 | `0 0 1080 1920` | 9:16 | 手机屏幕、电梯广告 |-| A4 打印 | `0 0 1240 1754` | 1:√2 | 打印海报、宣传单页 |--## 格式选择决策树--```-内容用途?-├─ 演示汇报-│ ├─ 现代设备 → PPT 16:9 (1280×720)-│ └─ 传统设备 → PPT 4:3 (1024×768)-├─ 社交分享-│ ├─ 小红书 → 1242×1660-│ ├─ 朋友圈/IG → 1080×1080-│ └─ Story/抖音 → 1080×1920-└─ 营销物料- ├─ 公众号头图 → 900×383- ├─ Banner → 1920×1080- └─ 打印 → 1240×1754-```--## 布局原则--### 横屏 (16:9, 4:3, 2.35:1)-- 视觉动线:Z字型,从左到右-- 边距:40-80px-- 布局:多栏、左右分割、网格-- 卡片尺寸(16:9):单行 530-600px,双行 265-295px--### 竖屏 (3:4, 9:16)-- 视觉动线:从上到下-- 边距:60-120px-- 布局:单栏、上下分割、卡片堆叠-- 卡片尺寸(3:4):高度 400-600px,间距 40-60px--### 正方形 (1:1)-- 视觉动线:中心辐射-- 边距:60-100px-- 核心区域:约 800×800px--## 格式特定设计--| 格式 | 标题区 | 内容区 | 特殊注意 |-|------|--------|--------|---------|-| PPT | 80-100px | 充分利用宽度 | 页码右下角 |-| 小红书 | 180-240px(加粗) | 上下留白充足 | 底部品牌区 120-160px |-| 朋友圈 | 200-280px | 中心 500-600px | 底部二维码区 150-200px |-| Story | — | 中部 1500px | 顶部安全区 120px,底部 180px |-| 公众号头图 | 居中/左对齐 48-72px | — | 配图右侧或背景 |--## ViewBox 示例--```xml-<svg width="1280" height="720" viewBox="0 0 1280 720"> <!-- PPT 16:9 -->-<svg width="1242" height="1660" viewBox="0 0 1242 1660"> <!-- 小红书 -->-<svg width="1080" height="1080" viewBox="0 0 1080 1080"> <!-- 朋友圈 -->-<svg width="1080" height="1920" viewBox="0 0 1080 1920"> <!-- Story -->-<svg width="900" height="383" viewBox="0 0 900 383"> <!-- 公众号头图 -->-```--------# 设计指南--PPT Master 系统的详细设计指南和最佳实践。-------## 颜色系统--### 主色调选择--#### 咨询风格--```-德勤蓝: #0076A8 - 专业、可靠-麦肯锡蓝: #005587 - 权威、深度-BCG深蓝: #003F6C - 稳重、信任-普华永道橙: #D04A02 - 活力、创新-安永黄: #FFE600 - 乐观、清晰-```--#### 通用灵活风格--```-科技蓝: #2196F3 - 现代、创新-活力橙: #FF9800 - 热情、积极-成长绿: #4CAF50 - 健康、增长-专业紫: #9C27B0 - 创意、高端-警示红: #F44336 - 紧急、重要-```--### 辅助色系--#### 数据可视化配色--```-积极趋势(绿色系):- 深绿: #2E7D32 | 中绿: #4CAF50 | 浅绿: #81C784--警示趋势(黄色系):- 深黄: #F57C00 | 中黄: #FFA726 | 浅黄: #FFD54F--负面趋势(红色系):- 深红: #C62828 | 中红: #EF5350 | 浅红: #E57373-```--#### 中性色系--```-文本层级:- 主文本: #212121 (黑色, 87% opacity)- 副文本: #757575 (灰色, 60% opacity)- 辅助文本: #9E9E9E (浅灰, 38% opacity)--背景层级:- 主背景: #FFFFFF- 次背景: #F5F5F5- 卡片背景: #FAFAFA- 边框: #E0E0E0-```--### 对比度要求--遵循 WCAG 2.1 AA 级标准:-- 正文文本:至少 4.5:1-- 大号文本(24px+):至少 3:1-- 重要数据:至少 7:1(AAA 级)-------## 排版规范--### 字体层级--> 以正文字号为 1x 基准,其他层级按比例推导。字号选择取决于内容密度,而非设计风格。--#### 内容宽松(正文基准 24px)--适用:演讲型 PPT、培训课件、每页要点少(3-5 条)--```-H1 - 封面标题: 60-72px, Bold (2.5-3x)-H2 - 页面标题: 42-48px, Bold (1.75-2x)-H3 - 章节标题: 32-36px, SemiBold (1.3-1.5x)-正文 - 主要内容: 24px, Regular (1x 基准)-小字 - 注释说明: 18-20px, Regular (0.75-0.85x)-```--#### 内容密集(正文基准 18px)--适用:数据报告、咨询分析、每页要点多(6+ 条)--```-H1 - 封面标题: 45-54px, Bold (2.5-3x)-H2 - 页面标题: 27-36px, Bold (1.5-2x)-H3 - 章节标题: 22-27px, SemiBold (1.2-1.5x)-正文 - 主要内容: 18px, Regular (1x 基准)-小字 - 注释说明: 14-15px, Regular (0.75-0.85x)-```--### 字体选择--#### 中文字体--| 类别 | 代号 | 可选字体 | 适用场景 |-|------|:----:|---------|----------|-| 无衬线黑体 | A | 微软雅黑、黑体、幼圆、华文细黑 | 现代商务、正文(默认) |-| 衬线宋体 | B | 宋体、新宋体、仿宋、华文宋体 | 政务公文、正式报告 |-| 书法楷体 | C | 楷体、华文楷体、华文行楷 | 文化艺术、人文类 |-| 标题黑体 | D | 黑体、华文中宋、思源黑体 Bold | 大标题、强调 |-| 手写艺术 | E | 华文行楷、华文新魏、隶书 | 创意、个性化 |--#### 英文字体--| 类别 | 代号 | 可选字体 | 适用场景 |-|------|:----:|---------|----------|-| 无衬线现代 | F | Arial, Calibri, Segoe UI, Helvetica | 现代商务(默认) |-| 衬线经典 | G | Times New Roman, Georgia, Cambria | 正式文档、学术 |-| 标题展示 | H | Impact, Arial Black, Bebas Neue | 大标题、海报 |-| 手写风格 | I | Comic Sans MS, Segoe Script, Ink Free | 轻松活泼 |-| 等宽代码 | J | Consolas, Cascadia Code, Courier New | 数据、代码 |--#### 推荐 font-family--```css-/* 中文字体 */-"Microsoft YaHei", "微软雅黑", sans-serif /* A: 微软雅黑 */-"SimHei", "黑体", sans-serif /* A/D: 黑体 */-"SimSun", "宋体", serif /* B: 宋体 */-"FangSong", "仿宋", serif /* B: 仿宋 */-"KaiTi", "楷体", serif /* C: 楷体 */-"STXingkai", "华文行楷", cursive /* C/E: 华文行楷 */--/* 英文字体 */-"Arial", sans-serif /* F: Arial */-"Calibri", sans-serif /* F: Calibri */-"Times New Roman", serif /* G: Times */-"Georgia", serif /* G: Georgia */-"Impact", sans-serif /* H: Impact */-"Consolas", monospace /* J: 等宽 */-```--#### 中英文混排推荐--| 场景 | 中文字体 | 英文字体 |-|------|---------|---------|-| 现代商务 | 微软雅黑 (A) | Calibri / Arial (F) |-| 政务公文 | 宋体 (B) | Times New Roman (G) |-| 文化艺术 | 楷体 (C) | Georgia (G) |-| 科技互联网 | 黑体 (D) | Segoe UI (F) |--#### 字体角色--| 角色 | 用途 | 中文推荐 | 英文推荐 |-|------|------|----------|----------|-| 标题字体 | H1/H2 大标题 | A/C/D/E | F/G/H |-| 正文字体 | 段落、要点 | A/B | F/G |-| 强调字体 | KPI、关键词 | D | H/J |-| 注释字体 | 脚注、说明 | A/B | F/G |--### 行高和间距--```-标题行高: 1.2-1.3-正文行高: 1.5-1.6-段落间距: 1.5-2em-列表间距: 0.5-1em-```--### 文本换行与扁平化--- 生成阶段:采用 `<tspan>` 手动换行,通过 `x`/`dy` 控制行起点与行距-- 后处理:使用 `python3 scripts/finalize_svg.py <项目路径>`,包含文本扁平化功能-- 校验:对比 `svg_output` 与 `svg_final`,核对行序、样式与定位一致;目标文件中不应残留 `<tspan>`-------## 布局原则--### 16:9 画布规范--```-画布尺寸: 1280x720px-安全区域: 1200x640px (留40px边距)-标题区: 1200x100px-内容区: 1200x500px-页脚区: 1200x40px-```--### 网格系统--#### 单栏布局-```-适用: 封面、结束页、单一主题-内容宽度: 800-1000px,水平居中-```--#### 双栏布局-```-适用: 对比分析、左图右文-栏宽比例: 1:1 或 3:2,栏间距: 40-60px-```--#### 三栏布局-```-适用: 并列要点、流程步骤-栏宽比例: 1:1:1,栏间距: 30-40px-```--#### 四象限布局-```-适用: 矩阵分析、分类展示-象限尺寸: 560x250px (含间距),间距: 20-30px-```--### 卡片设计--#### 尺寸规范(强制)--```-单行卡片: 高度 530-600px-双行卡片: 每行 265-295px-三栏卡片: 每栏宽度 360-380px-```--#### 内边距--```-标题区: 20-30px-内容区: 30-40px-图表区: 20-30px-```--#### 圆角半径--```-小卡片: 8-12px-大卡片: 12-16px-图表: 8px-按钮: 6-8px-```-------## 图片布局规范--含图片页面的布局需根据图片比例动态计算。详细规范见 image-layout-spec.md。--**快速规则**:-- 比例 > 2.0 (超宽) → 上下布局-- 比例 1.5-2.0 (宽幅) → 优先上下,文字区不足则改左右-- 比例 1.2-1.5 (标准横图) → 左右布局-- 比例 0.8-1.2 (方形) → 左右布局-- 比例 < 0.8 (竖图) → 左右布局-------## 图表设计--### 常用图表类型--#### KPI 卡片-```-布局: 2x2 或 1x4-元素: 大号数字 (48-56px) + 指标名称 (18-20px) + 趋势图标/百分比 + 同比/环比说明-```--#### 柱状图-```-柱子数量: 3-8个,柱宽: 40-60px,间距: 柱宽的50-80%,显示数值标签-```--#### 折线图-```-线条: 2-3px,数据点: 圆形 半径 4-6px,网格线: 1px 浅灰色,图例: 右上角或底部-```--#### 饼图/环形图-```-分块: 3-6个,起始角度: -90度 (12点方向),环形宽度: 40-60px,显示百分比标签-```--#### 矩阵图-```-2x2布局,轴线: 2px实线,象限标签清晰,数据点大小统一-```--### 图表配色--| 方案 | 适用场景 | 示例 |-|------|---------|------|-| 单色渐变 | 同类数据比较 | #1976D2 → #42A5F5 → #90CAF9 |-| 对比色组 | 不同类别数据 | #2196F3 / #FF9800 / #4CAF50 |-| 顺序色 | 等级/强度展示 | #4CAF50 → #FFC107 → #F44336 |-------## 图标使用--### 项目内置图标库(推荐)--位于 `templates/icons/`,包含 640+ 个 SVG 图标。--```-完整索引: templates/icons/FULL_INDEX.md-程序化查询: templates/icons/icons_index.json-使用方式: templates/icons/README.md-```--**分类概览**:-- 通用:home, settings, search, user, calendar, mail...-- 数据:trending-up, chart-bar, database, file-text...-- 业务:rocket, target, lightbulb, trophy, star...-- 箭头:arrow-right/left/up/down, chevron-right...-- 状态:check, check-circle, x-circle, alert-circle...-- 工具:edit, trash, download, upload, share...--### 图标规范--```-尺寸: 小 16-20px | 常规 24-32px | 大 40-48px-线宽: 2px (统一)-颜色: 与主色调协调-间距: 图标大小的 50%-```-------## 常见模式--### 封面页-- 顶部:公司Logo(可选),中部:演示标题 (H1),副标题,底部:日期、演讲人-- 简洁大气,主色调背景或图片,文字居中或偏左--### 内容页-- 标准结构:页面标题 (H2) → 主要内容 → 页码/注释-- 变体:左标题右内容、上下分割、多栏布局--### 数据页-- 数据可视化为主,关键数字突出,提供数据来源,添加趋势说明-- 布局:大图表+要点、多小图表组合、KPI仪表盘--### 总结页-- 3-5个核心要点 + 行动号召 (CTA) + 下一步计划-- 列表或编号,图标辅助,简洁明了-------## 常见问题--| 问题 | 解决方案 |-|------|---------|-| 内容太多放不下 | 分多页、用更小字号(>=16px)、精简文字、用图表代替 |-| 颜色搭配不协调 | 限制主色<=3种、增加中性色占比、参考成功案例 |-| 布局不平衡 | 检查对齐、调整间距、使用网格系统、平衡视觉重量 |-------# Role: Strategist--## 核心使命--作为顶尖 AI 演示文稿策略师,接收源文档,进行内容分析与设计规划,输出 **《演示文稿设计规范与内容大纲》**。--## 流程上下文--| 上一步 | 当前 | 下一步 |-|--------|------|--------|-| 项目创建 + 模板选项确认 | **策略师**:八项确认 + 设计规范 | Image_Generator 或 Executor |--------## 1. 八项确认流程--在开始分析前,依次确认以下问题并提供专业建议。--### a. 画布格式确认--根据场景推荐格式(详见 shared-standards.md 画布格式速查表)。--### b. 页数范围确认--根据源文档内容量提供具体页数建议。--### c. 关键信息确认--确认目标受众、使用场合、核心信息,根据文档性质提供初步判断。--### d. 风格目标确认--| 风格 | 核心定位 | 适合受众 | 一句话特点 |-|------|----------|----------|------------|-| **A) 通用灵活** | 视觉冲击优先 | 公众/客户/学员 | 「让人一眼被吸引」 |-| **B) 一般咨询** | 数据清晰优先 | 团队/管理层 | 「让数据说话」 |-| **C) 顶级咨询** | 逻辑说服优先 | 高管/董事会 | 「让结论先行」 |--**风格选择决策树**:--```-内容特征?- ├─ 大量图片/宣传性强 ──→ A) 通用灵活- ├─ 数据分析/进展汇报 ──→ B) 一般咨询- └─ 战略决策/说服高管 ──→ C) 顶级咨询--受众?- ├─ 公众/客户/学员 ────→ A) 通用灵活- ├─ 团队/管理层 ───────→ B) 一般咨询- └─ 高管/董事会/投资人 → C) 顶级咨询-```--### e. 配色方案建议--基于内容特征和行业属性主动提供配色方案(HEX 色值)。--**行业配色速查**(完整 14 行业见 `scripts/config.py` 的 `INDUSTRY_COLORS`):--| 行业 | 主导色 | 特点 |-|------|--------|------|-| 金融/商务 | `#003366` 深蓝 | 稳重信赖 |-| 科技/互联网 | `#1565C0` 明蓝 | 创新活力 |-| 医疗/健康 | `#00796B` 青绿 | 专业安心 |-| 政务/政府 | `#C41E3A` 中国红 | 庄重权威 |--**配色规则**:60-30-10 法则(主导色 60%、辅助色 30%、强调色 10%);文本对比度 >= 4.5:1;单页不超 4 色。--### f. 图标使用方式确认--| 选项 | 方式 | 适用场景 |-|------|------|----------|-| **A** | Emoji 表情 | 轻松活泼、社交媒体 |-| **B** | AI 生成 | 需要定制风格 |-| **C** | 内置图标库 | 专业场景(推荐) |-| **D** | 自定义图标 | 有品牌素材 |--内置库含 640+ 图标,详见 `templates/icons/README.md`。--> **选择 C 时的强制规则**:-> 1. 查阅 `templates/icons/icons_index.json` 验证图标存在-> 2. 图标名称为单一名称(如 `factory`),不含路径前缀-> 3. 禁止使用索引中不存在的名称-> 4. 在《设计规范》中列出最终图标清单,Executor 只能使用清单内图标->-> **快速查找**:按分类 → `icons_index.json` 的 `categories`;按语义 → `quickLookup`;完整列表 → `templates/icons/FULL_INDEX.md`--### g. 图片使用确认--| 选项 | 方式 | 适用场景 |-|------|------|----------|-| **A** | 不使用图片 | 数据报告、流程说明 |-| **B** | 用户提供 | 有现成图片素材 |-| **C** | AI 生成 | 需要定制插图、背景 |-| **D** | 占位符预留 | 后期补充图片 |--**选择包含 B 时**,必须在输出规范前运行 `python3 scripts/analyze_images.py <项目路径>/images`,将扫描结果整合进图片资源清单。--**选择 B/C/D 时**,在规范中添加图片资源清单:--| 列 | 说明 |-|----|------|-| 文件名 | 如 `cover_bg.png` |-| 尺寸 | 如 `1280x720` |-| 比例 | 如 `1.78` |-| 布局建议 | 如 `宽幅横图 (适合全屏/插图)` |-| 用途 | 如 `封面背景` |-| 类型 | 背景图 / 实景照片 / 插画配图 / 图表架构 / 装饰图案 |-| 状态 | 待生成 / 已有 / 占位符 |-| 生成描述 | AI 生成时填写详细描述 |--**图片类型说明**:--| 类型 | 适用场景 |-|------|----------|-| 背景图 | 封面/章节页全页背景,需预留文字区域 |-| 实景照片 | 真实场景、人物、产品、建筑 |-| 插画配图 | 扁平设计、矢量风格、概念图解 |-| 图表架构 | 流程图、架构图、概念关系图 |-| 装饰图案 | 局部装饰、纹理、边框、分隔元素 |--**图片与布局适配原则**(详细计算规则参考 `docs/image_layout_spec.md`):--| 图片比例 | 推荐布局 |-|----------|----------|-| > 2.0 (超宽) | 上下分栏,上方通栏 |-| 1.5-2.0 (宽幅) | 上下分栏 |-| 1.2-1.5 (标准横图) | 左右分栏 |-| 0.8-1.2 (方图) | 左右分栏 |-| < 0.8 (竖图) | 左右分栏,图片在左 |--核心逻辑:布局容器宽高比必须与图片原始比例相近,禁止宽图塞方形容器或竖图放横向窄条。--> **流程衔接**:选择 C) AI 生成时,输出设计规范后提示用户调用 Image_Generator,图片归集到 `images/` 后再进入 Executor。--### h. 排版方案(字体 + 字号)--#### 字体预设--| 场景 | 预设 | 标题 | 正文 | 强调 |-|------|------|------|------|------|-| 现代商务、科技 | P1 | 微软雅黑/Arial | 微软雅黑/Calibri | 黑体 |-| 政务公文、报告 | P2 | 黑体 | 宋体/Times | 宋体 |-| 文化艺术、人文 | P3 | 楷体/Georgia | 微软雅黑 | 黑体 |-| 传统稳重风格 | P4 | 宋体 | 微软雅黑/Arial | 宋体 |-| 英文为主 | P5 | Arial/Impact | Calibri/Georgia | Arial Black |--#### 字号基准(所有字号使用 px)--选择原则:字号根据**内容密度**选择,而非设计风格。--| 内容密度 | 每页要点 | 正文基准 | 适用场景 |-|----------|----------|----------|----------|-| 宽松 | 3-5 条 | 24px | 演讲型、培训课件 |-| 密集 | 6+ 条 | 18px | 数据报告、咨询分析 |--| 层级 | 比例 | 24px 基准 | 18px 基准 |-|------|------|-----------|-----------|-| 封面标题 | 2.5-3x | 60-72px | 45-54px |-| 页面标题 | 1.5-2x | 36-48px | 27-36px |-| **正文** | **1x** | **24px** | **18px** |-| 注释 | 0.75x | 18px | 14px |--### i. 演讲备注要求(默认,无需沟通)--- 文件命名:推荐与 SVG 同名(`01_封面.svg` → `notes/01_封面.md`),兼容 `notes/slide01.md`-- 在《设计规范》中填写:演讲总时长、备注风格(正式/口语化/互动式)、讲演目的(告知/说服/激励/指导/汇报)-- 拆分后的备注文件中不允许出现 `#` 标题行(`notes/total.md` 汇总讲稿必须使用 `#` 标题行)-------## 2. 执行师风格详解(第四项确认依据)--### A) 通用灵活 — Executor_General--**独有能力**:-- 全幅大图 + 渐变蒙版(宣传/推介必备)-- 自由创意布局(不受网格约束)-- 三种风格变体:图文结合、极简演讲(Keynote 风)、创意设计--**典型场景**:招商/文旅推介、产品发布、培训课件、品牌宣传--**禁忌**:过于严肃刻板、密集数据表格--### B) 一般咨询 — Executor_Consultant--**独有能力**:-- KPI 仪表盘(4 卡片布局,大数字 + 趋势箭头)-- 专业图表组合(柱状图、折线图、饼图、漏斗图)-- 数据颜色分级(红/黄/绿三色达标状态)--**典型场景**:工作进展汇报、财务分析、政府工作报告、招投标/提案--**禁忌**:花哨装饰、图片为主角--### C) 顶级咨询 — Executor_Consultant_Top--**独有能力**:--| 能力 | 说明 |-|------|------|-| 数据情境化 | 每个数据必须有对比参照("增长 63%,行业均值仅 12%") |-| SCQA 框架 | 情境 → 冲突 → 问题 → 答案 |-| 金字塔原则 | 结论先行,核心观点放标题位置 |-| 战略性配色 | 颜色服务于信息,不做装饰 |-| 图表 vs 表格 | 趋势用图表,精确值用表格 |--**独有页面元素**:渐变顶条 + 深色核心观点区、机密标识 + 严谨页脚、MECE 分解图 / 驱动因素树 / 瀑布图--**典型场景**:战略决策报告、深度分析报告、咨询交付物(MBB 级)--**禁忌**:孤立数据、主观表述、装饰性元素-------## 3. 配色知识库--### 咨询风格配色(专业权威)--| 品牌/风格 | 色值 | 心理感受 |-|-----------|------|----------|-| 德勤蓝 | `#0076A8` | 专业、可靠 |-| 麦肯锡蓝 | `#005587` | 权威、深度 |-| BCG 深蓝 | `#003F6C` | 稳重、信任 |-| 普华永道橙 | `#D04A02` | 活力、创新 |-| 安永黄 | `#FFE600` | 乐观、清晰 |--### 通用灵活配色(现代活力)--| 风格 | 色值 | 适用场景 |-|------|------|----------|-| 科技蓝 | `#2196F3` | 科技、互联网 |-| 活力橙 | `#FF9800` | 营销、推广 |-| 成长绿 | `#4CAF50` | 健康、环保、增长 |-| 专业紫 | `#9C27B0` | 创意、高端 |-| 警示红 | `#F44336` | 紧急、重要 |--### 数据可视化配色--- 积极趋势(绿色系):`#2E7D32` → `#4CAF50` → `#81C784`-- 警示趋势(黄色系):`#F57C00` → `#FFA726` → `#FFD54F`-- 负面趋势(红色系):`#C62828` → `#EF5350` → `#E57373`-------## 4. 布局模式速查--| 布局 | 适用场景 | PPT 16:9 参考尺寸 |-|------|----------|-------------------|-| 单栏居中 | 封面、结语、重要观点 | 内容宽 800-1000px,水平居中 |-| 双栏布局 | 对比分析、左图右文 | 栏宽比 1:1 或 3:2,间距 40-60px |-| 三栏布局 | 并列要点、流程步骤 | 栏宽比 1:1:1,间距 30-40px |-| 四象限 | 矩阵分析、分类展示 | 象限 560x250px,间距 20-30px |-| 上下分栏 | 超宽图片+文字 | 图片通栏,文字区 >= 150px 高 |-| 左右分栏 | 标准/竖图+文字 | 图片侧放,文字区 >= 280px 宽 |--**PPT 16:9 (1280x720) 关键尺寸**:安全区域 1200x640(留 40px 边距);标题区 1200x100;内容区 1200x500;页脚区 1200x40。-------## 5. 模板灵活性原则--> 模板是起点,不是终点。--策略师应在 `scripts/project_manager.py` 生成的模板基础上,结合用户需求、内容特征、受众特点进行专业判断:--1. 比例系统可调(字号比例是参考值)-2. 配色方案可定制(结合品牌和内容特征)-3. 布局模式可组合(6 种基础布局自由变化)-4. 内容结构可扩展(12 章节框架可增减)-5. 间距/圆角等细节由 Executor 根据内容密度调整-------## 6. 工作流程与交付物--### 6.1 内容规划策略--| 风格 | 内容大纲 | 设计规范 | 演讲备注 |-|------|----------|----------|----------|-| A) 通用灵活 | 智能解构源文档,每页定义核心主题 | 视觉主题、色彩方案、布局原则 | 简洁演讲稿 |-| B) 一般咨询 | 结构化逻辑板块,数据驱动洞察 | 咨询风格配色、内容结构化布局 | 专业术语、数据解读、结论先行 |-| C) 顶级咨询 | SCQA 框架,金字塔原则结论先行 | 数据情境化、颜色战略性使用 | 高度凝练、逻辑严密、结论驱动 |--### 6.2 大纲输出规范(必须包含 12 章节)--| 章节 | 内容要求 |-|------|----------|-| 一、项目信息 | 项目名称、画布格式、页数、风格、受众、场景、日期 |-| 二、画布规范 | 格式、尺寸、viewBox、边距、内容区域 |-| 三、视觉主题 | 风格说明、亮/深主题、调性、配色方案(含色值表)、渐变方案 |-| 四、排版体系 | 字体方案(P1-P5)、字号层级(H1-Code 7级) |-| 五、布局原则 | 页面结构(页眉/内容/页脚区)、6种布局模式、间距规范 |-| 六、图标使用规范 | 来源说明、占位符语法、推荐图标清单 |-| 七、图片资源清单 | 文件名、尺寸、比例、用途、状态、生成描述 |-| 八、内容大纲 | 按章节分组,每页含布局、标题、内容要点 |-| 九、演讲备注要求 | 文件命名规则、内容结构说明 |-| 十、技术约束提醒 | SVG 生成规则、PPT 兼容性规则 |-| 十一、设计检查清单 | 生成前/生成后检查项 |-| 十二、下一步 | 明确后续流程(Image_Generator 或 Executor) |--**生成步骤**:-1. 读取参考模板:`templates/design_spec_reference.md`-2. 结合分析内容从头生成完整规范-3. 保存至:`projects/<项目名>.../设计规范与内容大纲.md`-------## 7. 项目文件夹--项目文件夹应在进入策略师角色之前已创建。如未创建,先执行:--```bash-python3 scripts/project_manager.py init <项目名称> --format <画布格式>-```--策略师将《设计规范与内容大纲》保存至 `projects/<项目名>_<格式>_<YYYYMMDD>/设计规范与内容大纲.md`。-------## 8. 完成设计规范并提示下一步--根据已确认的模板选项和图片使用选择提示下一步。--### 模板选项 A(使用已有模板)--```-✅ 设计规范已完成。模板已就绪。-下一步:-- 图片包含 AI 生成 → 调用 Image_Generator-- 图片不包含 AI 生成 → 调用 Executor-```--### 模板选项 B(不使用模板)--```-✅ 设计规范已完成。-下一步:-- 图片包含 AI 生成 → 调用 Image_Generator-- 图片不包含 AI 生成 → 调用 Executor(自由生成每一页)-```-------# Image_Generator 参考手册--> 本文件为 Image_Generator 角色的精简参考。通用标准(SVG 技术约束、画布格式、后处理流程等)见 [shared-standards.md](./shared-standards.md)。--## 核心使命--接收 Strategist 输出的《设计规范与内容大纲》中的「图片资源清单」,为每张待生成的图片创建优化提示词,并通过 AI 工具生成图片,保存到项目 `images/` 目录。--**触发条件**: 需要生成 AI 图片时(独立使用或流程中调用)--| 模式 | 触发方式 | 说明 |-|------|----------|------|-| **独立使用** | 直接说明图片需求 | 生成单张或多张 AI 图片 |-| **流程中使用** | `generate-ppt` 选择 AI 生成图片 | 为项目批量生成图片资源 |--> 流程中下一步:Executor 生成 SVG-------## 1. 输入与输出--### 输入--- **设计规范与内容大纲**(来自 Strategist):项目主题、目标受众、设计风格、配色方案、画布格式-- **图片资源清单**(关键输入):-- | 文件名 | 尺寸 | 用途 | 类型 | 状态 | 生成描述 |- |--------|------|------|------|------|----------|- | cover_bg.png | 1920x1080 | 封面背景 | 背景图 | 待生成 | 现代科技感抽象背景,深蓝渐变 |--### 输出--| 产出物 | 路径/说明 | 要求 |-|--------|-----------|------|-| 提示词文档 | `项目/images/image_prompts.md` | **必须**用文件写入工具保存,不能仅在对话中输出 |-| 优化提示词 | 每张图片独立提示词 | 可直接用于 AI 图像生成工具,兼做 alt 文本 |-| 图片文件 | `项目/images/` 目录 | 按清单文件名命名 |-| 更新后的清单 | 状态变更 | 「待生成」→「已生成」 |-------## 2. 统一提示词结构--### 2.1 标准输出格式--每张图片必须按以下格式输出:--```markdown-### 图片 N: {文件名}--| 属性 | 值 |-| -------- | ------------------------------------ |-| 用途 | {在哪页/承担什么功能} |-| 类型 | {背景图/插画/实景照片/图表/装饰图案} |-| 尺寸 | {宽}x{高} ({宽高比}) |-| 原始描述 | {用户在清单中提供的描述} |--**提示词 (Prompt)**:-{主体描述}, {风格指令}, {色彩指令}, {构图指令}, {质量指令}--**负面提示词 (Negative Prompt)**:-{需要排除的元素}--**图片描述 (Alt Text)**:-> {中文描述,用于无障碍访问和图片说明}-```--### 2.2 提示词组成要素--| 要素 | 说明 | 示例 |-|------|------|------|-| 主体描述 | 核心内容 | `Abstract geometric shapes`, `Team collaboration scene` |-| 风格指令 | 视觉风格 | `flat design`, `3D isometric`, `watercolor style` |-| 色彩指令 | 配色方案 | `color palette: navy blue (#1E3A5F), gold (#D4AF37)` |-| 构图指令 | 布局比例 | `16:9 aspect ratio`, `centered composition` |-| 质量指令 | 分辨率质量 | `high quality`, `4K resolution`, `sharp details` |-| 负面提示词 | 排除元素 | `text, watermark, blurry, low quality` |--### 2.3 风格关键词速查--| 设计风格 | 推荐图片风格 | 核心关键词 |-|----------|-------------|------------|-| 通用灵活 | 现代插画、扁平设计 | `modern`, `flat design`, `gradient`, `vibrant colors` |-| 一般咨询 | 简洁专业、商务风 | `professional`, `clean`, `corporate`, `minimalist` |-| 顶级咨询 | 高端简约、抽象几何 | `premium`, `sophisticated`, `geometric`, `abstract`, `elegant` |--### 2.4 色彩整合方法--从设计规范提取配色,转换为提示词:--```-主导色: #1E3A5F (深海蓝) → "deep navy blue (#1E3A5F)"-辅助色: #F8F9FA (浅灰) → "light gray (#F8F9FA)"-强调色: #D4AF37 (金) → "gold accent (#D4AF37)"--完整指令: "color palette: deep navy blue (#1E3A5F), light gray (#F8F9FA), gold accent (#D4AF37)"-```--### 2.5 画布格式与宽高比--| 画布格式 | 背景图宽高比 | 建议分辨率 |-|----------|-------------|------------|-| PPT 16:9 | 16:9 | 1920x1080 或 2560x1440 |-| PPT 4:3 | 4:3 | 1600x1200 |-| 小红书 | 3:4 | 1242x1660 |-| 朋友圈 | 1:1 | 1080x1080 |-| Story | 9:16 | 1080x1920 |--> Nano Banana 支持的宽高比:`1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`-------## 3. 图片类型分类与处理--### 类型判断流程--1. 全页/大面积铺底 → **背景图** (3.1)-2. 真实场景/人物/产品 → **实景照片** (3.2)-3. 扁平/插画/卡通风格 → **插画配图** (3.3)-4. 流程/架构/关系 → **图表/架构图** (3.4)-5. 局部装饰/纹理 → **装饰图案** (3.5)--### 3.1 背景图 (Background)--**识别特征**: 封面、章节页的全页背景,需承载文字叠加--| 要点 | 说明 |-|------|------|-| 强调背景属性 | 添加 `background`, `backdrop` |-| 预留文字区域 | `negative space in center for text overlay` |-| 避免强主体 | 使用抽象、渐变、几何元素 |-| 低对比细节 | `subtle`, `soft`, `muted` |--**模板**: `Abstract {主题元素} background, {风格} style, {主色} to {辅色} gradient, subtle {装饰元素}, clean negative space in center for text overlay, {宽高比} aspect ratio, high resolution, professional presentation background`--**负面提示词**: `text, letters, watermark, faces, busy patterns, high contrast details`--### 3.2 实景照片 (Photography)--**识别特征**: 真实场景、人物、产品、建筑等照片质感--| 要点 | 说明 |-|------|------|-| 强调真实感 | `photography`, `photorealistic`, `real photo` |-| 光影效果 | `natural lighting`, `soft shadows`, `studio lighting` |-| 背景处理 | `white background` / `blurred background` / `contextual setting` |-| 人物多样性 | `diverse`, `professional attire` |--**模板**: `{主体描述}, professional photography, {光影类型} lighting, {背景类型} background, color grading matching {配色方案}, high quality, sharp focus, 8K resolution`--**负面提示词**: `watermark, text overlay, artificial, CGI, illustration, cartoon, distorted faces`--### 3.3 插画配图 (Illustration)--**识别特征**: 扁平设计、矢量风格、卡通、概念图解--| 要点 | 说明 |-|------|------|-| 明确风格 | `flat design`, `isometric`, `vector style`, `hand-drawn` |-| 简化细节 | `simplified`, `clean lines`, `minimal details` |-| 统一色板 | 严格使用设计规范配色 |-| 背景选择 | `white background` 或 `transparent background` |--**模板**: `{主体描述}, {插画风格} illustration style, {细节程度} with clean lines, color palette: {配色列表}, {背景类型} background, professional {用途} illustration`--**负面提示词**: `realistic, photography, 3D render, complex textures, watermark`--### 3.4 图表/架构图 (Diagram)--**识别特征**: 流程图、架构图、概念关系图、数据可视化--| 要点 | 说明 |-|------|------|-| 清晰结构 | `clear structure`, `organized layout`, `logical flow` |-| 连接表示 | `arrows indicating flow`, `connecting lines` |-| 学术/专业感 | `suitable for academic publication`, `professional diagram` |-| 浅色背景 | `white background` 或 `light gray background` |--**模板**: `{图表类型} diagram showing {内容描述}, {组件描述} connected by {连接方式}, {风格} style with {配色方案}, white background, clear labels, professional technical diagram`--**负面提示词**: `cluttered, messy, overlapping elements, dark background, realistic, photography`--### 3.5 装饰图案 (Decorative Pattern)--**识别特征**: 局部装饰、纹理、边框、分隔元素--| 要点 | 说明 |-|------|------|-| 可重复性 | `seamless`, `tileable`, `repeatable`(如需要) |-| 低调辅助 | `subtle`, `understated`, `supporting element` |-| 透明友好 | `transparent background` 或 `isolated element` |-| 小尺寸适用 | 考虑在小尺寸下的可识别性 |--**模板**: `{图案类型} decorative pattern, {风格} style, {配色方案}, {背景类型} background, subtle and elegant, suitable for {用途}`--**负面提示词**: `busy, cluttered, high contrast, distracting, photorealistic`-------## 4. 图片生成工作流--### 4.1 分析阶段--1. 阅读设计规范,理解项目整体风格-2. 提取配色方案、画布格式、目标受众-3. 逐一分析图片资源清单中的每张图片-4. 判断每张图片的类型(参考第 3 节)--### 4.2 提示词生成阶段--对每张「待生成」状态的图片:--1. **判断类型** → 背景图/实景照片/插画/图表/装饰-2. **理解用途** → 在哪页?承担什么功能?-3. **分析原始描述** → 用户「生成描述」中的信息-4. **应用类型要点** → 参考对应类型的表格-5. **生成优化提示词** → 使用 2.1 统一输出格式-6. **保存提示词文档** → **必须**写入 `项目/images/image_prompts.md`--### 4.3 图片生成阶段--> 前置条件:必须先完成 4.2,确保 `images/image_prompts.md` 已创建--#### 方式一:Nano Banana 命令行工具(推荐)--```bash-python3 scripts/nano_banana_gen.py "你的提示词" \- --aspect_ratio 16:9 --image_size 1K \- --output 项目/images --filename cover_bg-```--**参数列表**:--| 参数 | 简写 | 说明 | 默认值 |-|------|------|------|--------|-| `prompt` | - | 正向提示词(位置参数) | `Nano Banana` |-| `--negative_prompt` | `-n` | 负面提示词 | 无 |-| `--aspect_ratio` | - | 图片宽高比 | `1:1` |-| `--image_size` | - | 尺寸 (`1K`/`2K`/`4K`) | `1K` |-| `--output` | `-o` | 输出目录 | 当前目录 |-| `--filename` | `-f` | 输出文件名(不含扩展名) | 自动命名 |--**环境变量**: 必需 `GEMINI_API_KEY`,可选 `GEMINI_BASE_URL`--**生成节奏控制(强制)**:-- 每次只执行一个生成命令,等待确认文件落盘后再执行下一条-- 建议每张间隔 2-5 秒,避免并发导致失败-- 如出现失败/无输出,先停止队列,检查环境变量与输出目录,再继续--#### 方式二:自动生成--直接调用图像生成 API,下载并保存到 `项目/images/` 目录。--#### 方式三:Gemini 网页版--1. 在 [Gemini](https://gemini.google.com/) 中生成图片-2. 选择 **Download full size** 下载高分辨率版本-3. 去水印:`python3 scripts/gemini_watermark_remover.py <图片路径>`-4. 将处理后的图片放入 `项目/images/` 目录--#### 方式四:手动生成(其他 AI 平台)--提示词已保存在 `images/image_prompts.md`,告知用户文件位置。用户自行到 Midjourney、DALL-E、Stable Diffusion、文心一格、通义万相等平台生成,将图片放入 `项目/images/` 目录。--### 4.4 验证阶段--- 确认所有图片已保存到 `images/` 目录-- 检查文件名与清单一致-- 更新图片资源清单状态为「已生成」-------## 5. 提示词文档模板--创建 `项目/images/image_prompts.md` 时使用以下结构:--```markdown-# 图片生成提示词--> 项目: {项目名称}-> 生成时间: {日期}-> 配色方案: 主导色 {#HEX} | 辅助色 {#HEX} | 强调色 {#HEX}-------## 图片清单总览--| # | 文件名 | 类型 | 尺寸 | 状态 |-|---|--------|------|------|------|-| 1 | cover_bg.png | 背景图 | 1920x1080 | 待生成 |-------## 详细提示词--### 图片 1: cover_bg.png--| 属性 | 值 |-|------|----|-| 用途 | 封面背景 |-| 类型 | 背景图 |-| 尺寸 | 1920x1080 (16:9) |-| 原始描述 | 现代科技感抽象背景,深蓝渐变 |--**提示词 (Prompt)**:-Abstract futuristic background with flowing digital waves...--**图片描述 (Alt Text)**:-> 现代科技感抽象背景,深蓝色渐变配合数字波浪和粒子效果-------## 使用说明--1. 复制上方「提示词」到 AI 图像生成工具-2. 推荐平台: Midjourney / DALL-E 3 / Gemini / Stable Diffusion-3. 生成后将图片重命名为对应文件名-4. 放入 `images/` 目录-```-------## 6. 负面提示词速查--### 按图片类型--| 类型 | 推荐负面提示词 |-|------|---------------|-| 背景图 | `text, letters, watermark, faces, busy patterns, high contrast details` |-| 实景照片 | `watermark, text overlay, artificial, CGI, illustration, cartoon, distorted faces` |-| 插画配图 | `realistic, photography, 3D render, complex textures, watermark` |-| 图表/架构图 | `cluttered, messy, overlapping elements, dark background, realistic` |-| 装饰图案 | `busy, cluttered, high contrast, distracting, photorealistic` |--### 通用负面提示词--- **标准版**: `text, watermark, signature, blurry, distorted, low quality`-- **扩展版**(人物场景): `text, watermark, signature, blurry, low quality, distorted, extra fingers, mutated hands, poorly drawn face, bad anatomy, extra limbs, disfigured, deformed`-------## 7. 常见问题--### 无「生成描述」时的默认推断--| 用途 | 默认推断 |-|------|----------|-| 封面背景 | 抽象渐变背景,预留中央文字区域 |-| 章节页背景 | 简洁几何图案,侧重单色调 |-| 团队介绍页 | 团队协作场景插图(扁平风格) |-| 数据展示页 | 简洁几何图案或纯色背景 |-| 产品展示 | 产品实拍风格,白底或渐变背景 |--### 图片不满意时--提供提示词变体供用户选择:变体 A(更抽象)、变体 B(更具象)、变体 C(不同色调)。-------## 8. 角色协作--### 与 Strategist 的衔接--| 方向 | 内容 |-|------|------|-| 接收 | 设计规范与内容大纲(含图片资源清单) |-| 触发条件 | 用户在「图片使用」中选择包含「C) AI 生成」 |-| 关键信息 | 配色方案、设计风格、画布格式 |--### 与 Executor 的衔接--| 方向 | 内容 |-|------|------|-| 交付 | 所有图片已放入 `项目/images/` 目录 |-| Executor 引用 | `<image href="../images/xxx.png" .../>` |-| 路径说明 | SVG 在 `svg_output/`,图片在 `images/`,使用相对路径 `../images/` |-------## 9. 任务完成检查点--### 必须完成项--- [ ] 已创建提示词文档 `项目/images/image_prompts.md`-- [ ] 每张图片都有:类型判断 + 优化提示词 + 负面提示词 + Alt Text-- [ ] 使用统一输出格式(2.1 标准格式)-- [ ] 已输出阶段完成确认--### 图片就绪项(至少满足一项)--- [ ] 所有图片已保存到 `项目/images/` 目录-- [ ] 或:已明确告知用户使用 `image_prompts.md` 自行生成--### 流程流转--- [ ] 已提示用户进入下一步(切换到 Executor 角色)--> **关键检查**: 如果 `images/image_prompts.md` 未创建,或输出格式不符合 2.1 标准,任务未完成。--### 完成确认输出格式--```markdown-## Image_Generator 阶段完成--- [x] 已创建提示词文档 `项目/images/image_prompts.md`-- [x] 已为 X 张图片生成优化提示词-- [x] 所有图片已保存到 `images/` 目录-- [x] 已更新图片资源清单状态--**图片状态汇总**:--| 文件名 | 类型 | 尺寸 | 状态 |-|--------|------|------|------|-| cover_bg.png | 背景图 | 1920x1080 | 已生成 |--**下一步**: 切换到 Executor 角色开始生成 SVG-```-------# Executor 公共规范--> 各风格差异化内容见对应 `executor-{style}.md`。-------## 1. 模板遵循规则--如果项目 `templates/` 目录中存在模板文件,必须遵循模板结构:--| 页面类型 | 对应模板 | 遵循规则 |-|---|---|---|-| 封面 | `01_cover.svg` | 继承背景、装饰元素、布局结构,替换占位符内容 |-| 章节页 | `02_chapter.svg` | 继承编号样式、标题位置、装饰元素 |-| 内容页 | `03_content.svg` | 继承页眉页脚样式,**内容区可自由布局** |-| 结束页 | `04_ending.svg` | 继承背景、感谢语位置、联系信息布局 |-| 目录页 | `02_toc.svg` | **可选**:继承目录标题、列表样式 |--### 页面-模板对应声明(必须输出)--开始生成每一页之前,必须明确输出该页使用的模板或"自由生成":--```-📝 **模板对应**: `templates/01_cover.svg`(或"无(自由生成)")-🎯 **遵循规则/布局策略**: [具体说明]-```--- **内容页**:模板只定义页眉和页脚,内容区域由 Executor 自由布局-- **无模板时**:完全按照《设计规范与内容大纲》自由生成-------## 2. 设计参数确认(强制步骤)--> 在生成第一页 SVG 之前,**必须先回顾《设计规范与内容大纲》中的关键设计参数**,确保后续生成严格遵循规范。--必须输出确认,包含:画布尺寸、正文字号、配色方案(主导/辅助/强调色 HEX)、字体方案。--**为什么必须做这一步?** 防止"规范是规范,执行是执行"的脱节问题。-------## 3. 执行准则--- **绝对遵循规范**:严格按照规范中的色彩、布局、画布格式、排版参数设计-- **遵循模板结构**:如有模板,继承模板的视觉框架-- **分阶段批量生成**(推荐):- 1. **视觉构建阶段**:连续生成所有 SVG 页面,确保设计风格和布局坐标的高度一致性(Visual Consistency)- 2. **逻辑构建阶段**:SVG 全部定稿后,再批量生成演讲备注,确保叙事逻辑连贯(Narrative Continuity)-- **技术规范**:详见 [shared-standards.md](shared-standards.md) 中的 SVG 技术约束与 PPT 兼容性规则--### SVG 文件命名规范--文件命名格式:`<序号>_<页面名称>.svg`--- **中文内容** → 中文命名:`01_封面.svg`、`02_目录.svg`、`03_核心优势.svg`-- **英文内容** → 英文命名:`01_cover.svg`、`02_agenda.svg`、`03_key_benefits.svg`-- **序号规则**:两位数字,从 01 开始递增-- **页面名称**:简洁描述性,与《设计规范与内容大纲》中的页面标题一致-------## 4. 图标使用--四种方式:**A: Emoji**(`<text>🚀</text>`)| **B: AI 生成**(SVG 基本元素)| **C: 内置库**(`templates/icons/` 640+ 图标,推荐)| **D: 自定义**(用户指定)--**内置图标 - 占位符方式(推荐)**:--```xml-<use data-icon="chart-bar" x="100" y="200" width="48" height="48" fill="#005587"/>-```--> 无需手动运行 `embed_icons.py`,`finalize_svg.py` 后处理工具会自动嵌入图标。--**常用图标**:`chart-bar` `arrow-trend-up` `users` `cog` `circle-checkmark` `target` `clock` `file` `dollar` `lightbulb`--完整索引:`templates/icons/README.md`-------## 5. 图片处理--根据设计规范「图片资源清单」中的状态处理:--| 状态 | 来源 | 处理方式 |-|---|---|---|-| **已有** | 用户提供 | 直接引用 `../images/` 目录中的图片 |-| **AI 生成** | Image_Generator 生成 | 图片已在 `../images/`,直接引用 |-| **占位符** | 暂未准备 | 使用虚线框占位 |--**引用**:`<image href="../images/xxx.png" ... preserveAspectRatio="xMidYMid slice"/>`--**占位符**:虚线框 `<rect stroke-dasharray="8,4" .../>` + 描述文本-------## 6. 字体使用--根据《设计规范与内容大纲》中的字体方案,为不同文本角色应用对应字体:--| 角色 | 中文推荐 | 英文推荐 |-|---|---|---|-| 标题字体 | 微软雅黑/楷体/黑体 | Arial/Georgia |-| 正文字体 | 微软雅黑/宋体 | Calibri/Times |-| 强调字体 | 黑体 | Arial Black/Consolas |-| 注释字体 | 微软雅黑/宋体 | Arial/Times |--详细参见 `docs/design_guidelines.md`。-------## 7. 演讲备注生成框架--### 任务 1. 生成完整演讲备注文稿--在**所有 SVG 页面生成完成并定稿后**,进入"逻辑构建阶段",在 `notes/total.md` 中生成完整的演讲备注文稿。--**为什么不一页一页生成?** 批量写备注能像写剧本一样规划转场语(Transition),确保演讲逻辑通顺。--**格式**:每页以 `# <序号>_<页面标题>` 开头,页间用 `---` 分隔。每页包含:讲稿正文(2-5 句)、`要点:①② ③`、`时长:X 分钟`。首页除外,每页正文以 `[过渡]` 转场语开头。--**基础控场标记**(所有风格通用):--| 标记 | 用途 |-|---|---|-| `[停顿]` | 关键内容后留白,让观众消化 |-| `[过渡]` | 段首单独成段,放在每页正文开头,承上启下 |--> 各风格可扩展额外标记(`[互动]`/`[数据]`/`[环视]`/`[对标]` 等),见 `executor-{style}.md`。--**要求**:--- 讲稿应口语化、自然流畅-- 突出页面核心信息和演讲要点-- 用户可在 `notes/` 目录手动编辑覆盖--### 任务 2. 拆分写入各页备注文件--将 `notes/total.md` 自动拆分,写入 `notes/` 目录下的演讲备注文件中。--**文件命名规范**:--- **推荐**:与 SVG 同名(如 `01_封面.svg` → `notes/01_封面.md`)-- **兼容**:也支持 `slide01.md` 格式(向后兼容)-------## 8. 完成后下一步--> **强制检查点**:进入后处理前必须输出确认——视觉构建阶段(SVG 页数)和逻辑构建阶段(备注页数)均已完成。未输出检查点禁止进入后处理。--**后处理与导出**(详见 [shared-standards.md](shared-standards.md)):--```bash-# 1. 拆分讲稿-python3 scripts/total_md_split.py <项目路径>--# 2. SVG 后处理(自动嵌入图标、图片等)-python3 scripts/finalize_svg.py <项目路径>--# 3. 导出 PPTX-python3 scripts/svg_to_pptx.py <项目路径> -s final-```-------# Executor General -- 创意通用风格--> 基础准则见 executor-base.md,技术约束见 shared-standards.md-------## 角色定位--创意型、通用风格的 SVG 设计执行师。适用于产品介绍、培训讲义、方案汇报、营销宣传等**非咨询类**场景。强调视觉表现力与信息趣味性,在专业与亲和之间取得平衡。-------## General 特有布局技巧--### 1. 灵活多变的版式--General 风格不拘泥于固定模板,可根据内容自由选择版式:--| 版式 | 适用场景 | 布局要点(1280x720) |-|------|----------|---------------------|-| 全图背景+文字叠加 | 封面、情感渲染页 | `<image>` 铺满画布 + 半透明遮罩 + 居中标题 |-| 左右分栏(图文混排) | 功能介绍、对比说明 | 左 x=40,w=580 / 右 x=660,w=580 |-| 三栏卡片 | 特性罗列、团队介绍 | x=40,450,860 各 w=380,等高卡片 |-| 上下分区 | 时间线、流程展示 | 上区标题+说明 h=250 / 下区图表+内容 h=420 |-| 中心辐射 | 核心概念、生态图 | 中心元素 + 4-6 个周围节点,连线指向中心 |-| 瀑布流/Z 字型 | 故事叙述、案例展示 | 内容块交替左右排列,引导视线 Z 字移动 |--### 2. 视觉节奏控制--- **信息密度交替**:高密度数据页之后接一页"呼吸页"(大图/金句/过渡),避免观众疲劳-- **视觉重量平衡**:深色/大面积元素为"重",浅色/小元素为"轻",左右/上下应均衡-- **重复与变化**:同一章节内保持版式一致性,不同章节间适当变化以维持新鲜感--### 3. 装饰元素运用--| 元素 | 用法 | 注意事项 |-|------|------|---------|-| 渐变色块 | 背景分区、标题底色 | 使用 `<linearGradient>` / `<radialGradient>`,限 2-3 色 |-| 圆角矩形卡片 | 内容容器、功能模块 | `rx="12"` 配合轻投影(用浅色 rect 模拟) |-| 图标点缀 | 列表项前缀、功能标识 | 使用 `data-icon` 占位符,大小 32-48px |-| 编号圆圈 | 步骤流程、排名列表 | `<circle>` + 居中 `<text>`,主题色填充 |-| 分隔线 | 内容分区 | `<line>` 或 `<rect height="2">`,opacity 0.2-0.3 |-------## 视觉策略--### 色彩运用--- **主题色大胆使用**:封面、章节页可大面积使用主题色背景-- **渐变增强层次**:标题栏、卡片背景可使用同色系渐变-- **对比创造焦点**:关键数字/词汇使用强调色,与周围内容形成反差-- **配色情绪匹配**:科技感用冷色调,活力感用暖色调,稳重感用深色调--### 图片处理策略--| 场景 | 策略 | SVG 实现 |-|------|------|---------|-| 全屏背景图 | 图片铺满 + 暗色渐变遮罩 | `preserveAspectRatio="xMidYMid slice"` + 渐变 rect |-| 竖图展示 | 左侧/右侧放置,保持原比例 | 控制宽度,高度自适应 |-| 多图拼接 | 网格排列,统一尺寸 | 等宽等高的 `<image>` 矩阵 |-| 人物照片 | 圆形裁切效果 | `<circle>` 背景 + 方形图片叠加(后处理裁剪) |--### 排版层次--```-标题层 → 28-36px,粗体,主题色或白色-副标题层 → 20-24px,中等粗细,次要色-正文层 → 16-18px,常规,深灰色-注释层 → 12-14px,浅灰色,底部对齐-```-------## 演讲备注风格--### 叙事基调--General 风格的演讲备注采用**口语化叙述**,像在和观众对话,而非宣读报告。语气自然、有节奏感,适当加入修辞手法。--### 控场标记--| 标记 | 用途 | 示例 |-|------|------|------|-| `[停顿]` | 关键展示后留白,让观众消化信息 | "这个数字意味着什么?[停顿] 意味着每 3 个用户中就有 1 个..." |-| `[互动]` | 提问或引导观众参与,激活注意力 | "[互动] 在座各位有多少人体验过这个功能?" |-| `[过渡]` | 段首承上启下,必须放在每页正文开头 | "[过渡] 了解了背景之后,我们来看看具体怎么做。" |--### 备注写作要点--- **讲故事**:用"场景-冲突-解决"结构组织每页叙事-- **用比喻**:将抽象概念具象化("这就像给系统装了一个涡轮增压器")-- **设悬念**:适时抛出问题,下一页给出答案-- **口语化数据**:30% -> "将近三分之一",2.5 倍 -> "翻了一番还多"-- **要点结构**:`要点:(1)核心信息 (2)支撑论据 (3)行动呼吁`--### 备注示例--```markdown-# 03_核心优势--[过渡] 说完了市场的现状,大家可能会问:那我们的机会在哪里?--我们的核心优势可以用三个词概括:快、准、省。-快——部署时间从 3 个月缩短到 2 周;[停顿]-准——识别准确率达到 97.3%,远超行业平均的 82%;-省——综合成本降低将近三分之一。--[互动] 如果你是决策者,这三个数字中哪个最打动你?--要点:(1)三大差异化优势 (2)量化数据支撑 (3)引导思考-时长:2 分钟-```-------## 自检补充(General 特有)--- [ ] 视觉节奏合理:信息密集页与呼吸页交替-- [ ] 装饰元素适度:服务于内容而非喧宾夺主-- [ ] 图文比例恰当:非纯文字堆砌,有视觉亮点-- [ ] 备注口语化:读出来像说话,而非念稿-------# Executor Consultant -- 咨询风格--> 基础准则见 executor-base.md,技术约束见 shared-standards.md-------## 角色定位--数据驱动的咨询风格 SVG 设计执行师。适用于商业分析报告、市场调研、运营复盘、战略建议等**一般咨询**场景。强调信息的结构化呈现与数据可视化,风格简洁、清晰、专业。-------## Consultant 特有的数据可视化技巧--### 1. KPI 仪表盘设计--KPI 卡片是咨询报告最常用的元素,标准布局(1280x720):--```-4 卡片布局:每卡 280x180,间距 30- 卡片 1: x=45, y=160- 卡片 2: x=355, y=160- 卡片 3: x=665, y=160- 卡片 4: x=975, y=160-```--**卡片内部结构**(自上而下):--| 区域 | 内容 | 字号 | 样式 |-|------|------|------|------|-| 图标行 | data-icon 图标 | 32x32 | 主题色 |-| 指标名 | "月活跃用户" | 14px | 灰色 #64748B |-| 核心数字 | "1.2M" | 36-42px | 粗体,深色 |-| 趋势标注 | "+12.3% vs 上月" | 12px | 绿色=增/红色=降 |--**趋势箭头规范**:-- 上升:`arrow-trend-up` 图标 + 绿色文字-- 下降:`arrow-trend-down` 图标 + 红色文字-- 持平:横线图标 + 灰色文字--### 2. 图表配色规范--咨询风格图表使用**同色系深浅渐变**,而非彩虹色:--```-主系列: 主题色 100% opacity-对比系列: 主题色 60% opacity-基准线: #94A3B8(灰色虚线)-高亮: 强调色(仅用于关键数据点)-```--### 3. 数据标注原则--- **数据标签直接标注**:柱状图顶部放数值,无需图例-- **趋势线加注释**:关键拐点处添加文字说明("政策调整"、"产品上线")-- **对比基准线**:行业均值/目标值用灰色虚线标注-- **单位统一**:同一图表中保持一致的数值单位和精度--### 4. 表格设计--咨询报告经常使用表格呈现精确数据:--| 设计要素 | 规范 |-|----------|------|-| 表头 | 深色背景 + 白色文字,font-weight="bold" |-| 斑马纹 | 奇偶行交替使用 `fill-opacity="0.05"` 的浅色底 |-| 数值对齐 | 数字右对齐,文本左对齐 |-| 高亮行 | 用强调色 `fill-opacity="0.1"` 标记重点行 |-| 边框 | 仅用水平线分隔行,避免完整网格线 |-------## 咨询专用布局模式--### MECE 分解图--主干居左,分支向右展开,互斥穷尽:--```-主指标 ──┬── 分支 A(占比 45%)- ├── 分支 B(占比 30%)- ├── 分支 C(占比 20%)- └── 分支 D(占比 5%)-```--- 使用 `<line>` 连接主干与分支-- 每个分支配 `<rect>` 容器 + 百分比标注-- 总和必须 = 100%(或明确标注"其他")--### 驱动因素树--顶层指标 -> 分解因素 -> 措施,适合业绩归因分析:--```-收入增长 15%- ├── 客单价 +8% → 高端产品线扩展- ├── 客户数 +5% → 新渠道获客- └── 复购率 +2% → 会员体系优化-```--### 左图右文(图表解读)--咨询报告核心版式:左侧放图表,右侧放关键解读:--```-图表区: x=40, y=120, w=700, h=480-解读区: x=780, y=120, w=460, h=480- - 核心结论(粗体,16px)- - 3-5 条 bullet points(14px)- - 数据来源(12px,灰色)-```-------## 专业表达规范--### 页面标题--咨询风格的页面标题应是**观点性标题**(Assertion Headline),而非描述性标题:--| 类型 | 描述性(避免) | 观点性(推荐) |-|------|---------------|---------------|-| 市场 | "市场概况" | "国内市场年增速 23%,显著领先全球均值" |-| 竞品 | "竞品分析" | "三大竞品在渠道覆盖上存在明显短板" |-| 财务 | "财务数据" | "毛利率连续四季度提升,突破行业天花板" |--### 数据源标注--每个含数据的页面底部必须标注来源:--```xml-<text x="40" y="700" font-size="10" fill="#94A3B8">- 来源:国家统计局 2025 年年报;团队内部分析-</text>-```--### 核心观点区--咨询风格内容页应在标题下方设置**核心观点区**(Takeaway Box):--```-位置: x=40, y=80, w=1200, h=50-背景: 浅色主题色底(fill-opacity="0.08")-文本: 14-16px,一句话总结本页核心观点-```-------## 演讲备注风格--### 叙事基调--Consultant 风格的演讲备注采用**结论驱动**的表达,先说结论再展开论据。语气专业、精炼、有说服力。--### 控场标记--| 标记 | 用途 | 示例 |-|------|------|------|-| `[停顿]` | 关键结论后留白,让听众消化 | "这意味着我们的市场份额正在被蚕食。[停顿]" |-| `[数据]` | 提示将数字口语化表达 | "[数据] 85% -> 超过八成客户反馈了这个问题" |-| `[过渡]` | 段首承上启下,必须放在每页正文开头 | "[过渡] 基于刚才的分析,我们来看具体建议。" |--### 备注写作要点--- **结论先行**:每页备注第一句即为核心观点-- **数据口语化**:30% -> "约三成",85% -> "超过八成",2.5x -> "两倍半"-- **论据紧跟**:结论后立即给出 2-3 个支撑数据/事实-- **专业措辞**:使用"洞察"、"驱动因素"、"核心抓手"等咨询术语-- **要点结构**:`要点:(1)核心结论 (2)支撑数据 (3)下一步建议`--### 备注示例--```markdown-# 03_关键发现--[过渡] 基于前面的市场扫描,我们提炼出三个关键发现。--第一,用户增长的主要驱动力正在从获客转向留存。-[数据] 新客获取成本同比上涨了将近四成,但复购率提升贡献了超过六成的收入增量。[停顿]--第二,下沉市场的增速显著高于一二线城市。-第三,25-35 岁女性用户群的 ARPU 值是整体均值的 1.8 倍。--要点:(1)增长引擎从获客转向留存 (2)下沉市场机会窗口 (3)高价值人群画像-时长:2 分钟-```-------## 自检补充(Consultant 特有)--- [ ] 数据与源数据一致,无编造-- [ ] 每个数据页底部有来源标注-- [ ] 页面标题是观点性而非描述性-- [ ] KPI 卡片有趋势箭头和对比标注-- [ ] 图表配色统一,使用同色系而非彩虹色-- [ ] 备注结论先行,数据口语化-------# Executor Consultant Top -- 顶级咨询风格 (MBB 级)--> 基础准则见 executor-base.md,技术约束见 shared-standards.md-------## 角色定位--MBB 级(McKinsey / Bain / BCG)顶级咨询风格的 SVG 设计执行师。适用于战略规划、董事会汇报、投融资路演、高管决策支持等**高端咨询**场景。核心特征:数据驱动洞察、金字塔结构叙事、极致简洁,输出面向 C-level 决策者。-------## SCQA 框架(叙事结构)--每份 MBB 级演示都遵循 SCQA 叙事结构:--| 元素 | 作用 | 典型页面 |-|------|------|---------|-| **S - Situation** | 设定共识背景 | 封面 / 第 1-2 页 |-| **C - Complication** | 引入问题/张力 | 第 2-3 页 |-| **Q - Question** | 隐含或明确的待解决问题 | 过渡页 |-| **A - Answer** | 核心解决方案 | 正文所有页 |--**页面编排**:封面体现 S+C -> Executive Summary 回答 Q -> 章节展开 A -> 结尾回扣 S--**标题写法**:--| SCQA 元素 | 弱标题 | MBB 级标题 |-|-----------|--------|-----------|-| S | "行业背景" | "数字化渗透率突破 60%,行业进入深水区" |-| C | "面临挑战" | "然而三大结构性矛盾制约了规模化落地" |-| Q | "战略问题" | "如何在 18 个月内实现从试点到全面部署?" |-| A | "解决方案" | "三步走路径:聚焦、扩展、规模化" |-------## 数据情境化(永不孤立呈现数据)--> **黄金法则**:永远不会孤立展示单一数据点。每个数字都需要上下文。--| 方法 | 模式 | 视觉实现 |-|------|------|---------|-| **时间对比** | "从 X 到 Y" | 折线图 + 箭头标注变化幅度 |-| **基准对标** | "X vs 行业均值 Y" | 柱状图中加灰色虚线基准线 |-| **竞品对比** | "我方 X vs 竞品 Y" | 并列柱状图,高亮自身数据 |-| **目标差距** | "实际 X / 目标 Y" | 进度条 + 差距标注 |-| **排名定位** | "位列第 N / 共 M" | 横向柱状图 + 高亮标记 |--**数据标注三要素**:每个数据可视化必须包含 (1)数值本身(大字号粗体) (2)对比参照(基准线/同期/竞品) (3)含义解读("So what?")--```xml-<text x="160" y="280" text-anchor="middle" font-size="42" font-weight="bold" fill="#1E293B">97.3%</text>-<text x="160" y="310" text-anchor="middle" font-size="13" fill="#64748B">行业均值 82% | 竞品 A 89%</text>-<text x="160" y="335" text-anchor="middle" font-size="12" fill="#059669">领先行业 15.3 个百分点</text>-```-------## 金字塔原则(结论先行)--> 高管不关心你的*过程*,只关心*结果*。--```- ┌─────────────┐- │ 核心结论 │ ← 页面标题 / Takeaway- └──────┬──────┘- ┌─────────┼─────────┐- ┌───┴───┐ ┌───┴───┐ ┌───┴───┐- │论据 1 │ │论据 2 │ │论据 3 │ ← 主要支撑点- └───────┘ └───────┘ └───────┘-```--| 层级 | 位置 | 字号 |-|------|------|------|-| 核心结论 | Takeaway Box | 16-18px 粗体 |-| 论据 | 内容区主体 | 14-16px |-| 支撑数据 | 图表/卡片 | 12-14px |--**对比**:标题"市场调研结果"(错) -> "元宇宙需要 5-10 年才能规模化"(对);正文"我们调研了...发现了..."(错) -> "三个论据:(1)... (2)... (3)..."(对)-------## MBB 级布局模式--### 内容页标准结构(1280x720)--```-┌──────────────────────────────────┐-│ 渐变顶条 (0,0 → 1280,6) │-├──────────────────────────────────┤-│ 观点性标题 (x=40, y=50, 24px) │-├──────────────────────────────────┤-│ Takeaway Box (x=40, y=75, │ ← 深色背景+白字,一句话结论-│ w=1200, h=45) │-├──────────────────────────────────┤-│ 内容区 (x=40, y=140, │ ← 图表/数据/分析-│ w=1200, h=520) │-├──────────────────────────────────┤-│ 来源 | CONFIDENTIAL | 页码 │ ← y=700, 10px-└──────────────────────────────────┘-```--### 战略路径图--三阶段横排,`<rect rx="8">` + 标题 + 举措列表,`<polygon>` 箭头连接:--```-聚焦核心(0-6月) ──> 扩展能力(6-12月) ──> 规模化(12-18月)-x=40,w=380 x=450,w=380 x=860,w=380-```--### 对标分析矩阵--横向表格,我方行主题色高亮,其他灰色。领先指标绿色标记,落后红色标记。用 `<circle>` 或 `<rect>` 构建评分点。--### 瀑布图(变化归因)--起点 -> 增减因素 -> 终点。正向因素绿色柱,负向红色柱,起止点深色柱,累计线虚线连接。-------## 颜色的战略性使用--MBB 级配色极度克制,颜色为信息服务:--| 用途 | 方法 |-|------|------|-| **聚焦** | 目标数据主题色,其他全灰 |-| **降低认知负荷** | 同系列同色深浅区分(`fill-opacity` 1.0/0.6/0.3) |-| **语义** | 绿=正向,红=负向,灰=基准 |-| **品牌** | 渐变顶条/装饰线用品牌色 |--**戒律**:主色调不超过 3 种;强调色全文仅 2-3 处;数据系列同色系深浅而非不同颜色;背景白色或极浅灰。-------## 图表 vs 表格选择矩阵--| 场景 | 推荐形式 | 原因 |-|------|---------|------|-| 比较 2-7 个类别 | **柱状图** | 视觉对比直观 |-| 时间趋势 | **折线图** | 时间序列清晰 |-| 精确数值/大量排名 | **表格** | 50 个点用柱状图会乱 |-| 占比构成 | **环形图** | 比饼图更现代 |-| 双维度定位 | **2x2 矩阵** | 战略象限分析 |-| 变化归因 | **瀑布图** | 因素拆解 |-------## 演讲备注风格--### 叙事基调--面向**高管/决策者**,金字塔结构,每句话都有信息量。语气沉稳、权威、有洞察力。--### 控场标记--| 标记 | 用途 | 示例 |-|------|------|------|-| `[停顿]` | 关键洞察后留白,让高管消化 | "这意味着我们正在错失千亿级市场。[停顿]" |-| `[环视]` | 观察决策者反应,判断是否展开 | "[环视] 各位如有疑问,我可以展开。" |-| `[数据]` | 数字口语化表达 | "[数据] 63% -> 将近三分之二" |-| `[对标]` | 强调对比基准 | "[对标] 相比行业均值 12%,我们 23% 几乎翻倍" |-| `[过渡]` | 段首承上启下,放在每页正文开头 | "[过渡] 承接战略框架,深入看实施路径。" |--### 备注写作要点--- **金字塔结构**:结论 -> 论据 -> 细节-- **数据情境化**:每个数字有对比参照-- **高管语言**:"战略意义在于..."、"核心洞察是..."-- **备选机制**:标注"时间紧张可略过的内容",支持弹性时长-- **要点结构**:`要点:(1)核心洞察 (2)数据支撑 (3)战略意义`--### 备注示例--```markdown-# 03_战略路径--[过渡] 明确了问题和机会之后,接下来是最关键的——我们的应对路径。--我们建议三步走策略。[停顿]--第一步,聚焦。未来六个月集中资源攻克华东市场。-[数据] 华东贡献了将近三分之二的行业增量,[对标] 但我们渗透率仅为竞品 A 的一半。[停顿]--第二步,扩展。以华东为样板,复制到华南和华北。-第三步,规模化。借助数字化平台实现全国覆盖。--[环视] 第一步的资源配置详见附录,需要现在展开吗?--要点:(1)聚焦-扩展-规模化三步走 (2)华东优先的数据支撑 (3)18 个月全面部署-时长:3 分钟-备选:[时间紧张可跳过二三步细节,直接到财务影响]-```-------## MBB 级质量检查补充--### 内容层面--- [ ] **SCQA 完整**:整体遵循情境-复杂性-问题-答案结构-- [ ] **数据情境化**:每个数据点有对比参照-- [ ] **结论先行**:每页 Takeaway Box 有一句话结论-- [ ] **MECE 原则**:分类分析互斥穷尽--### 视觉层面--- [ ] **颜色有意图**:配色服务于信息传达-- [ ] **留白充足**:不拥挤,让信息"呼吸"-- [ ] **视觉层次**:结论 > 论据 > 细节,字号/粗细区分-- [ ] **品牌一致**:渐变顶条、页脚全文统一--### 备注层面--- [ ] **金字塔结构**:每页结论先行-- [ ] **控场标记完整**:关键位置有 [停顿][环视]-- [ ] **备选内容标注**:支持弹性时长--------# Optimizer CRAP — 视觉优化角色--## 核心使命--严格遵循 CRAP 设计原则,分析并重构单页 SVG 代码,输出视觉更专业、结构更清晰的新版本。支持所有画布格式,根据原始 SVG 画布尺寸进行优化。--## 使用模式--| 模式 | 触发方式 | 说明 |-|------|----------|------|-| 独立使用 | 提供 SVG 文件/代码 | 对任意 SVG 进行视觉优化 |-| 流程中使用 | `generate-ppt` 后可选优化 | 优化 Executor 生成的 SVG |--> 流程中下一步:后处理 + 导出 PPTX--## 工作流程--1. 接收原始 SVG 代码-2. 识别画布格式(`width`、`height`、`viewBox`)-3. (可选)分析参考 SVG 了解总体风格-4. 按四大核心原则诊断和重构-5. 保持画布尺寸不变-6. 输出优化后 SVG,文件名前加 `yh_`-7. 输出优化报告-------## 四大核心设计原则--### 1. 对齐 (Alignment)--- **诊断**:检查是否存在随意放置的元素-- **优化**:严格对齐所有元素,创建强大的视觉连接线(左对齐、居中或右对齐),任何元素的位置都必须与其他元素存在明确的对齐关系-- **参考**:元素坐标偏差控制在 5px 以内--**常见技巧**:-- 将分散元素统一到同一条垂直或水平线上-- 使用一致的左/右边距-- 标题、正文、注释起始位置保持对齐--### 2. 对比 (Contrast)--- **诊断**:检查元素间是否有足够的视觉层次,重点信息是否突出-- **优化**:让不同元素**截然不同**,通过显著加大尺寸、字重或颜色差异突出最重要的信息-- **参考**:标题字号比正文大 1.3-2 倍--**常见技巧**:-- 放大关键数字或标题字号-- 用粗体突出重点词汇-- 用强调色标注核心信息-- 通过明暗对比区分前景与背景--### 3. 重复 (Repetition)--- **诊断**:检查同类元素的视觉风格是否统一-- **优化**:有意识地重复使用视觉元素(颜色、字体样式、圆角大小、线条粗细),创造组织性和统一性-- **参考**:同类元素保持风格一致--**常见技巧**:-- 统一所有卡片的圆角半径-- 统一同级标题的字号和颜色-- 重复使用相同的图标风格-- 保持一致的间距系统--### 4. 亲密性 (Proximity)--- **诊断**:检查逻辑相关的内容在空间上是否足够靠近-- **优化**:将关联项目在空间上靠近,组织成视觉单元;加大不同组块间的距离-- **参考**:相关元素靠近,不相关元素分开--**常见技巧**:-- 缩小标题与其下方内容的间距-- 加大不同章节之间的间距-- 将图表与标签组合成视觉单元-- 用分组线或背景色强化关联性-------## 可选补充原则--仅在用户明确要求时应用:--### 5. 留白 (White Space)--触发词:"增加留白"、"提升高级感"。增加元素间距,给设计留出呼吸空间。--### 6. 降噪 (Noise Reduction)--触发词:"简化设计"、"减少干扰"。移除冗余元素,简化复杂效果,聚焦核心信息。-------## 优化报告格式--```-## 优化报告--### 主要优化点-1. [对齐] 具体修改说明-2. [对比] 具体修改说明-3. [重复] 具体修改说明-4. [亲密性] 具体修改说明--### 优化效果-简要说明整体优化效果和视觉改进。-```--## 技术约束--- **保持画布尺寸**:优化后 SVG 的 `width`、`height`、`viewBox` 与原始一致-- **文本处理**:保持 `<tspan>` 换行-- **文件命名**:`yh_原文件名.svg`-- SVG 禁用功能与 PPT 兼容性规则见 shared-standards.md--------# Template Designer — 模板设计角色--## 核心使命--基于《设计规范与内容大纲》生成项目专属的页面模板,供用户确认后用于批量内容生成。--> 这是一个独立角色:仅通过 `/create-template` 工作流触发,不在 PPT 生成流程中使用。--## 使用方式--- **触发方式**:`/create-template` 工作流-- **输出位置**:`templates/layouts/<模板名称>/`-------## 核心模板清单--| 序号 | 文件名 | 用途 | 说明 |-|------|--------|------|------|-| 01 | `01_cover.svg` | 封面 | 固定结构:标题、副标题、日期、机构 |-| 02 | `02_chapter.svg` | 章节页 | 固定结构:章节编号、章节标题 |-| 03 | `03_content.svg` | 内容页 | 灵活结构:只定义页眉页脚,内容区由 AI 自由布局 |-| 04 | `04_ending.svg` | 结束页 | 固定结构:感谢语、联系方式 |-| -- | `02_toc.svg` | 目录页 | 可选:目录标题、章节列表(编号+标题) |--**设计理念**:模板定义视觉一致性和结构性页面,内容页保持最大灵活性。--**命名说明**:目录页保持 `02_toc.svg` 命名以兼容模板库与排序规则。--### 可选扩展页(按需)--- 过渡页 / 小节页(如 `05_section_break.svg`)-- 附录页(如 `06_appendix.svg`)-- 免责声明 / 保密页(如 `07_disclaimer.svg`)-------## 模板设计规范--### 1. 必须生成 design_spec.md--创建全局模板时,必须生成 `design_spec.md`,包含:--```markdown-# [模板名称] - 设计规范--## 一、模板概述(名称、适用场景、设计调性)-## 二、画布规范(16:9, 1280x720, viewBox)-## 三、配色方案(主色、辅助色、强调色 HEX 值)-## 四、排版体系(字体栈、字号层级)-## 五、页面结构(通用布局、装饰设计)-## 六、页面类型(4 种核心页面)-## 七、布局模式(推荐)-## 八、间距规范-## 九、SVG 技术约束-## 十、占位符规范-```--### 2. 继承设计规范--模板必须严格遵循《设计规范与内容大纲》中的:-- **画布尺寸**:viewBox 与设计规范一致-- **配色方案**:使用规范中的主导色、辅助色、强调色-- **字体方案**:使用规范中的字体预设-- **布局原则**:边距、间距符合规范--### 3. 占位符标记--使用明确的占位符标记可替换内容:--```xml-<!-- 文本占位符 -->-<text x="80" y="320" fill="#FFFFFF" font-size="48" font-weight="bold">- {{TITLE}}-</text>--<!-- 内容区占位符(内容页专用) -->-<rect x="40" y="90" width="1200" height="550" fill="#FFFFFF" rx="8"/>-<text x="640" y="365" text-anchor="middle" fill="#CBD5E1" font-size="16">- {{CONTENT_AREA}}-</text>-```--### 4. 占位符规范--| 占位符 | 用途 | 适用模板 |-|--------|------|----------|-| `{{TITLE}}` | 主标题 | 封面 |-| `{{SUBTITLE}}` | 副标题 | 封面 |-| `{{DATE}}` | 日期 | 封面 |-| `{{AUTHOR}}` | 作者/机构 | 封面 |-| `{{TOC_TITLE}}` | 目录标题 | 目录页 |-| `{{TOC_ITEMS}}` | 目录项列表 | 目录页 |-| `{{CHAPTER_NUM}}` | 章节编号 | 章节页 |-| `{{CHAPTER_TITLE}}` | 章节标题 | 章节页 |-| `{{CHAPTER_DESC}}` | 章节描述 | 章节页 |-| `{{PAGE_TITLE}}` | 页面标题 | 内容页 |-| `{{KEY_MESSAGE}}` | 核心观点 | 内容页(咨询风格) |-| `{{CONTENT_AREA}}` | 内容区域 | 内容页 |-| `{{SECTION_NAME}}` | 章节名称 | 内容页页脚 |-| `{{SOURCE}}` | 数据来源 | 内容页页脚 |-| `{{PAGE_NUM}}` | 页码 | 内容页、结束页 |-| `{{THANK_YOU}}` | 感谢语 | 结束页 |-| `{{TAGLINE}}` | 口号 | 结束页 |-| `{{CONTACT_INFO}}` | 联系信息 | 结束页 |-| `{{COPYRIGHT}}` | 版权 | 结束页 |-------## 输出要求--### 文件保存位置--```-templates/layouts/<模板名称>/-├── design_spec.md # 设计规范(必须)-├── 01_cover.svg-├── 02_chapter.svg-├── 02_toc.svg # 可选-├── 03_content.svg-├── 04_ending.svg-└── *.png / *.jpg # 图片资源(如有)-```--### 模板预览--每个模板生成后,提供简要说明表格,列出各模板状态。-------## 使用预置模板库(可选)--如已有适合的模板资源,可直接使用而非生成新模板:--1. **复制模板**:将模板文件复制到项目 `templates/` 目录-2. **调整配色**:根据项目设计规范修改颜色-3. **自定义修改**:根据项目特点个性化调整--**示例库结构**(查询 `templates/layouts/layouts_index.json`):--```-templates/layouts/-├── general/ # 通用灵活风格-├── consultant/ # 咨询风格-└── consultant_top/ # 顶级咨询风格(MBB级)-```-------## 阶段完成检查点--```markdown-## Template_Designer 阶段完成--- [x] 已阅读 `roles/Template_Designer.md`-- [x] 已生成 4 个核心页面模板-- [ ] 目录页模板(可选)-- [ ] 可选扩展页(如需)-- [x] 所有模板已保存到 `templates/` 目录-- [x] 模板遵循设计规范(配色、字体、布局)-- [x] 占位符标记清晰规范-- [ ] **下一步**: 请用户确认模板-```--------# 图片布局规范(强制执行)--含图片页面的布局规则。Strategist 规划阶段、Executor 生成阶段都必须遵循。--**核心原则:根据图片原始比例计算布局,确保图片完整展示,杜绝留白或裁切。**-------## 布局决策流程--```-1. 获取图片原始尺寸 → 计算比例 (宽/高)-2. 根据比例选择布局类型-3. 计算图片最大展示尺寸-4. 分配剩余空间给文字区域-5. 将结果填入《设计规范与内容大纲》的图片资源清单-```--**执行时机**:若图片方案包含「B) 用户提供」,在 Strategist 阶段完成八项确认后、进入内容分析与大纲编制之前,必须运行扫描并填充图片资源清单。-------## 布局类型选择(强制)--| 图片比例 | 布局类型 | 图片位置 | 说明 |-|----------|----------|----------|------|-| > 2.0 (超宽) | 上下分栏 | 上方通栏 | 图片占画布宽度,高度按比例 |-| 1.5-2.0 (宽幅) | 上下分栏 | 上方 | 图片宽度=内容区宽度,高度按比例 |-| 1.2-1.5 (标准) | 左右分栏 | 左侧 | 图片高度优先适配,宽度按比例 |-| 0.8-1.2 (方形) | 左右分栏 | 左侧 | 图片取内容区高度,宽度按比例 |-| < 0.8 (竖图) | 左右分栏 | 左侧 | 图片高度=内容区高度,宽度按比例 |--> 边界情况:比例处于边界值时(如 1.5),根据文字量判断。文字多选左右,文字少选上下。-------## 尺寸计算公式--### PPT 16:9 (1280x720) 画布参数--```-画布: 1280 x 720 px-内容区: 1160 x 640 px (左右边距 60px, 上下边距 40px)-标题区高度: 60 px-内容起点: y = 80 px (标题 + 间距)-```--### 上下布局计算--```-图片宽度 = W = 1160 px-图片高度 = W / R = 1160 / R px-文字区高度 = H - 图片高度 - 间距(20px)--验证:文字区高度 >= 150px (至少 3-4 行文字)-若不满足 → 改用左右布局-```--### 左右布局计算--**方式 1(高度优先,适用于竖图)**:-```-图片高度 = H = 600 px-图片宽度 = H x R = 600 x R px-文字区宽度 = W - 图片宽度 - 间距(20px)-```--**方式 2(宽度受限,适用于宽图转左右)**:-```-图片宽度 = W x 0.7 = 812 px-图片高度 = 图片宽度 / R-文字区宽度 = W - 图片宽度 - 间距(20px)-```--**验证**:文字区宽度 >= 280px,否则需减小图片区宽度。-------## 布局示例--### 超宽图 (比例 2.45)--```-原图: 1960x800, R=2.45 → 上下分栏-图片: 1160x473, 文字区: 1160x147 → 上下 7:3-```--### 标准横图 (比例 1.38)--```-原图: 1614x1171, R=1.38 → 左右分栏-图片: 773x560 (左侧), 文字区: 367x560 (右侧) → 左右 7:3-```--### 宽幅图边界情况 (比例 1.75)--```-原图: 1820x1040, R=1.75-尝试上下: 图片高度=663, 文字区=-43 ❌-改用左右: 图片 780x446 (左侧), 文字区 360x600 (右侧) → 左右 7:3-```-------## 禁止事项--| 禁止 | 正确做法 |-|------|---------|-| 固定使用 50:50 或任意比例 | 根据图片比例动态计算 |-| 将宽图塞入方形容器 | 使用上下布局或加大图片区宽度 |-| 将竖图放入横向窄条 | 使用左右布局,图片在左 |-| 图片留白超过 10% | 重新计算布局或选择其他方案 |-| 裁切图片关键内容 | 使用 `preserveAspectRatio="xMidYMid meet"` |-| 文字区太小无法阅读 | 确保文字区 >= 150px(上下)或 >= 280px(左右) |-------## SVG 图片嵌入代码--### 完整展示(推荐用于数据图表)--```xml-<image href="../images/xxx.png"- x="60" y="80" width="780" height="446"- preserveAspectRatio="xMidYMid meet"/>-```--### 裁切填充(仅用于背景图)--```xml-<image href="../images/bg.png"- x="0" y="0" width="1280" height="720"- preserveAspectRatio="xMidYMid slice"/>-```-------## 图片资源清单模板--在《设计规范与内容大纲》中,图片资源清单必须包含:--| 字段 | 说明 | 示例 |-|------|------|------|-| 文件名 | 图片文件名 | `p12_0.png` |-| 原始尺寸 | 宽x高 | 1524x968 |-| 比例 | 宽/高 | 1.57 |-| 页码 | 使用页码 | 第5页 |-| 类型 | 视觉类型 | 背景图/实景照片/插画配图/图表架构/装饰图案 |-| 布局方案 | 上下/左右 + 分栏比 | 上下 6:4 或 左右 7:3 |-| 图片区域 | 图片展示尺寸 | 1160x420 或 780x446 |-| 文字区域 | 剩余空间尺寸 | 1160x200 或 360x600 |--**类型字段用于 Image_Generator 选择合适的提示词策略。**-------## 自动化工具--```bash-python3 scripts/analyze_images.py <项目路径>/images-```--输出包含尺寸、比例、布局建议(Markdown 表格),可直接用于填写图片资源清单。-------## 角色职责--| 角色 | 职责 |-|------|------|-| **Strategist** | 运行 analyze_images.py,按本规范计算布局,填写图片资源清单 |-| **Executor** | 严格按图片资源清单中的布局方案和尺寸生成 SVG |--------# SVG 图片嵌入指南--在 SVG 文件中添加图片的技术规范和推荐工作流。-------## 图片资源清单格式--在《设计规范与内容大纲》中定义,每张图片标注状态。若图片方案包含「B) 用户提供」,需在 Strategist 阶段完成八项确认后立即运行 `analyze_images.py`,并在输出设计规范前完成清单填充。--```markdown-| 文件名 | 尺寸 | 用途 | 状态 | 生成描述 |-|--------|------|------|------|----------|-| cover_bg.png | 1280x720 | 封面背景 | 待生成 | 现代科技感抽象背景,深蓝渐变 |-| product.png | 600x400 | 第3页 | 已有 | - |-| team.png | 600x400 | 第5页 | 占位符 | 团队协作场景(后期补充) |-```--### 三种状态的处理--| 状态 | 含义 | Executor 处理方式 |-|------|------|-------------------|-| **待生成** | 需 AI 生成,有描述 | 先生成图片放入 `images/`,再用 `<image>` 引用 |-| **已有** | 用户已有图片 | 放入 `images/`,用 `<image>` 引用 |-| **占位符** | 暂不处理 | 用虚线框占位,后期替换 |-------## 工作流程--```-1. Strategist 定义图片需求 → 添加图片资源清单,标注每张状态-2. 图片准备(待生成/已有)→ 放入 项目/images/-3. Executor 生成 SVG(svg_output/)- ├── 已有/待生成 → <image href="../images/xxx.png" .../>- └── 占位符 → 虚线框 + 描述文本-4. 预览:python3 -m http.server -d <项目路径> 8000 → /svg_output/<文件名>.svg-5. 后处理与导出- ├── python3 scripts/finalize_svg.py <项目路径>- └── python3 scripts/svg_to_pptx.py <项目路径> -s final-```--> 推荐:生成阶段在 `svg_output/` 保留外部引用,后处理通过 `finalize_svg.py` 自动嵌入图片到 `svg_final/`,再从 `svg_final/` 导出 PPTX。-------## 外部引用 vs Base64 内嵌--| 方式 | 优点 | 缺点 | 适用场景 |-|------|------|------|----------|-| **外部引用** | 文件小、迭代快、便于替换 | 预览需从项目根起 HTTP 服务 | `svg_output/` 开发阶段 |-| **Base64 内嵌** | 文件独立、导出稳定 | 文件体积大 | `svg_final/` 交付阶段 |-------## 方式一:外部引用(生成阶段推荐)--### 语法--```xml-<image href="../images/image.png" x="0" y="0" width="1280" height="720"- preserveAspectRatio="xMidYMid slice"/>-```--### 关键属性--| 属性 | 说明 | 示例 |-|------|------|------|-| `href` | 图片路径(相对或绝对) | `"../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 -d <项目路径> 8000-# 访问 http://localhost:8000/svg_output/your_file.svg-```-------## 方式二:Base64 内嵌(交付阶段推荐)--### 语法--```xml-<image href="data:image/png;base64,iVBORw0KGgo..." x="0" y="0" width="1280" height="720"/>-```--### MIME 类型--| MIME 类型 | 文件格式 |-|-----------|----------|-| `image/png` | PNG |-| `image/jpeg` | JPG/JPEG |-| `image/gif` | GIF |-| `image/webp` | WebP |-| `image/svg+xml` | SVG |-------## 转换流程--### 推荐:统一走 finalize_svg.py--```bash-python3 scripts/finalize_svg.py <项目路径> # 图标、图片、文本、圆角一次处理-python3 scripts/svg_to_pptx.py <项目路径> -s final # 从最终版本导出 PPTX-```--### 独立使用 embed_images.py(高级用法)--仅处理特定 SVG 而不跑完整后处理时:--```bash-python3 scripts/embed_images.py <svg文件> # 单个-python3 scripts/embed_images.py <项目路径>/svg_output/*.svg # 批量-python3 scripts/embed_images.py --dry-run <项目路径>/svg_output/*.svg # 预览-```-------## 最佳实践--### 图片优化--嵌入前压缩图片以减少文件体积:--```bash-convert input.png -quality 85 -resize 1920x1080\> output.png # ImageMagick-pngquant --quality=65-80 input.png -o output.png # pngquant(推荐)-```--### 文件组织--```-project/-├── images/ # 图片资源-├── sources/ # 源文件及其附带图片-│ └── article_files/-├── svg_output/ # 原始版本(外部引用)-└── svg_final/ # 最终版本(已嵌入图片)-```--### 圆角处理(禁止 clipPath)--由于 `clipPath` 在 PPT 中不兼容,禁止使用裁剪路径为图片加圆角。替代方案:-- 生成图片时直接处理圆角(导出为带圆角的 PNG)-- 或用同尺寸圆角矩形覆盖边缘(视觉模拟)-------## 常见问题--**Q: 直接打开 SVG 看不到图片?**-浏览器安全策略阻止跨目录请求。从项目根目录启动 HTTP 服务器,或先运行 `finalize_svg.py` 再查看 `svg_final/`。--**Q: Base64 文件太大?**-压缩原始图片、使用 JPEG 格式、降低分辨率(匹配实际显示尺寸即可)。--**Q: 如何反向提取 Base64 图片?**-```bash-base64 -d image.b64 > image.png-```diff --git a/AGENTS.md b/AGENTS.mdindex 66f3b7a2..500ca860 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -1,2919 +1,84 @@-<!-- AUTO-GENERATED by build_adapters.py — DO NOT EDIT MANUALLY -->-<!-- Source: skills/ppt-master/ | Generated: 2026-03-20 -->+# AGENTS.md-# AGENTS.md — PPT Master 完整指南+本文件为通用 AI 代理提供项目入口。仓库的核心能力集中在 `skills/ppt-master/SKILL.md`。-> ⚠️ **AI 代理注意**:本文件是 PPT 生成流程的完整指南。-> 本文件由 `build_adapters.py` 从 `skills/ppt-master/` 自动生成,请勿手动编辑。+## 项目概述-# PPT Master Skill+PPT Master 是一个 AI 驱动的多格式 SVG 内容生成系统。通过多角色协作(Strategist → Image_Generator → Executor → Optimizer),将源文档(PDF/URL/Markdown)转化为高质量 SVG 页面,并导出为 PPTX。-> AI 驱动的多格式 SVG 内容生成系统。通过多角色协作将源文档转化为高质量 SVG 页面并导出 PPTX。+**核心流程**:`源文档 → 创建项目 → 模板选项 → Strategist 八项确认 → [Image_Generator] → Executor → 后处理 → 导出 PPTX`-**核心流程**:`源文档 → 创建项目 → 模板选项 → Strategist → [Image_Generator] → Executor → 后处理 → 导出`+**执行要求**:-## 脚本目录+- 开始 PPT 任务前,优先阅读 `skills/ppt-master/SKILL.md`+- 如需独立创建模板,阅读 `skills/ppt-master/workflows/create-template.md`+- 具体角色规则与技术约束都在 `skills/ppt-master/references/`+- ⚠️ **严格串行执行**:流程中的每个 Step 必须逐步执行,禁止合并、打包、并行执行多个 Step-| 脚本 | 用途 |-|------|------|-| `skills/ppt-master/scripts/pdf_to_md.py` | PDF 转 Markdown |-| `skills/ppt-master/scripts/web_to_md.py` | 网页转 Markdown |-| `skills/ppt-master/scripts/web_to_md.cjs` | 微信/高防站点转 Markdown |-| `skills/ppt-master/scripts/project_manager.py` | 项目初始化/验证/管理 |-| `skills/ppt-master/scripts/analyze_images.py` | 图片分析 |-| `skills/ppt-master/scripts/nano_banana_gen.py` | AI 图片生成(Gemini API) |-| `skills/ppt-master/scripts/svg_quality_checker.py` | SVG 质量检查 |-| `skills/ppt-master/scripts/total_md_split.py` | 演讲备注拆分 |-| `skills/ppt-master/scripts/finalize_svg.py` | SVG 后处理(统一入口) |-| `skills/ppt-master/scripts/svg_to_pptx.py` | 导出 PPTX |--## 模板与资源--| 资源 | 路径 |-|------|------|-| 页面布局模板 | `skills/ppt-master/templates/layouts/` |-| 图表 SVG 模板 | `skills/ppt-master/templates/charts/` |-| 矢量图标库 (640+) | `skills/ppt-master/templates/icons/` |-| 模板索引 | `skills/ppt-master/templates/layouts/layouts_index.json` |-| 设计规范参考 | `skills/ppt-master/templates/design_spec_reference.md` |-------## 工作流--### Step 0: 偏好加载 ⛔ BLOCKING--检查用户偏好配置:-1. 项目级: `.ppt-master/EXTEND.md`-2. 用户级: `$HOME/.ppt-master/EXTEND.md`--如果存在,读取并应用偏好(默认风格、默认格式等)。-------### Step 1: 源内容处理--当用户提供非 Markdown 内容时,必须立即转换:--| 用户提供 | 命令 |-|----------|------|-| PDF 文件 | `python3 skills/ppt-master/scripts/pdf_to_md.py <文件>` |-| 网页链接 | `python3 skills/ppt-master/scripts/web_to_md.py <URL>` |-| 微信/高防站 | `node skills/ppt-master/scripts/web_to_md.cjs <URL>` |-| Markdown | 直接读取 |-------### Step 2: 项目初始化--```bash-python3 skills/ppt-master/scripts/project_manager.py init <项目名> --format <格式>-```+## 常用命令-格式选项:`ppt169`(默认)、`ppt43`、`xhs`、`story` 等。完整格式列表见 `skills/ppt-master/references/canvas-formats.md`。--如需导入源文件:```bash-python3 skills/ppt-master/scripts/project_manager.py import-sources <项目路径> <源文件...>-```-------### Step 3: 模板选择--向用户确认(二选一):--**A) 使用已有模板**-1. 查询 `skills/ppt-master/templates/layouts/layouts_index.json` 确认可用模板-2. 复制模板文件到项目目录:- ```bash- cp skills/ppt-master/templates/layouts/<模板名>/*.svg <项目路径>/templates/- cp skills/ppt-master/templates/layouts/<模板名>/design_spec.md <项目路径>/templates/- cp skills/ppt-master/templates/layouts/<模板名>/*.png <项目路径>/images/ 2>/dev/null || true- cp skills/ppt-master/templates/layouts/<模板名>/*.jpg <项目路径>/images/ 2>/dev/null || true- ```+# 源内容转换+python3 skills/ppt-master/scripts/pdf_to_md.py <PDF文件>+python3 skills/ppt-master/scripts/web_to_md.py <URL>+node skills/ppt-master/scripts/web_to_md.cjs <URL>-**B) 不使用模板** → 自由设计+# 项目管理+python3 skills/ppt-master/scripts/project_manager.py init <项目名> --format ppt169+python3 skills/ppt-master/scripts/project_manager.py import-sources <项目路径> <源文件或URL...> --move+python3 skills/ppt-master/scripts/project_manager.py validate <项目路径>-> 如需创建新模板,Read `skills/ppt-master/references/template-designer.md`-------### Step 4: Strategist 阶段(必须,不可跳过)--⛔ **BLOCKING**: 先读取角色定义:-```-Read skills/ppt-master/references/strategist.md-Read skills/ppt-master/references/shared-standards.md-```--**必须完成八项确认**:-1. 画布格式-2. 页数范围-3. 目标受众-4. 风格目标-5. 配色方案-6. 图标使用方式-7. 图片使用方式-8. 排版方案--如用户提供了图片:-```bash+# 图片工具python3 skills/ppt-master/scripts/analyze_images.py <项目路径>/images-```--**输出**:`<项目路径>/设计规范与内容大纲.md`--**检查点**:-```markdown-## ✅ Strategist 阶段完成-- [x] 已完成八项确认-- [x] 已生成《设计规范与内容大纲》-- [ ] **下一步**: [Image_Generator / Executor]-```-------### Step 5: Image_Generator 阶段(条件触发)--> **触发条件**:图片方式包含「AI 生成」--⛔ **BLOCKING**: Read `skills/ppt-master/references/image-generator.md`--1. 从设计规范中提取所有「状态=待生成」的图片-2. 生成提示词文档 → `<项目路径>/images/image_prompts.md`-3. 生成图片(推荐命令行工具):- ```bash- python3 skills/ppt-master/scripts/nano_banana_gen.py "提示词" --aspect_ratio 16:9 --image_size 1K -o <项目路径>/images- ```--**检查点**:-```markdown-## ✅ Image_Generator 阶段完成-- [x] 提示词文档已创建-- [x] 所有图片已保存到 images/-```-------### Step 6: Executor 阶段--⛔ **BLOCKING**: 根据风格选择读取角色定义:-```-Read skills/ppt-master/references/executor-base.md # 必读:公共准则-Read skills/ppt-master/references/executor-general.md # 通用灵活风格-Read skills/ppt-master/references/executor-consultant.md # 咨询风格-Read skills/ppt-master/references/executor-consultant-top.md # 顶级咨询风格(MBB级)-```+python3 skills/ppt-master/scripts/nano_banana_gen.py "提示词" --aspect_ratio 16:9 --image_size 1K -o <项目路径>/images-> 只需读 executor-base + 一个风格文件即可。+# SVG 质量检查+python3 skills/ppt-master/scripts/svg_quality_checker.py <项目路径>-**视觉构建阶段**:-- 批量生成 SVG 页面 → `<项目路径>/svg_output/`--**逻辑构建阶段**:-- 生成演讲备注 → `<项目路径>/notes/total.md`--**检查点**:-```markdown-## ✅ Executor 阶段完成-- [x] 所有 SVG 已生成到 svg_output/-- [x] 演讲备注已生成 notes/total.md-```-------### Step 7: 后处理与导出--> ⚠️ 必须按顺序执行,不可省略或替换!--```bash-# 1. 拆分演讲备注+# 后处理三步(必须按顺序逐条执行,禁止一次性执行)python3 skills/ppt-master/scripts/total_md_split.py <项目路径>--# 2. SVG 后处理(图标嵌入/图片裁剪嵌入/文本扁平化/圆角转Path)+# ✅ 确认无报错后执行下一条python3 skills/ppt-master/scripts/finalize_svg.py <项目路径>--# 3. 导出 PPTX(默认嵌入演讲备注)+# ✅ 确认无报错后执行下一条python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s final```-> ❌ **禁止**用 `cp` 替代 `finalize_svg.py`,该工具执行多项关键处理-> ❌ **禁止**从 `svg_output/` 直接导出,必须用 `-s final` 从 `svg_final/` 导出-------### Step 8: Optimizer 阶段(可选)--> **触发条件**:用户要求优化,或设计质量需要提升--Read `skills/ppt-master/references/optimizer-crap.md`--优化后需重新执行 Step 7(后处理与导出)。-----+## 核心目录-## 角色切换协议+- `skills/ppt-master/SKILL.md` — 主入口与完整流程+- `skills/ppt-master/workflows/create-template.md` — 独立模板工作流+- `skills/ppt-master/references/` — 角色定义与技术规范+- `skills/ppt-master/scripts/` — 工具脚本+- `skills/ppt-master/templates/` — 布局模板、图表模板、图标库+- `examples/` — 示例项目+- `projects/` — 用户项目工作区-切换角色前**必须先读取**对应的 reference 文件,禁止跳过。输出标记:+## SVG 技术约束-```markdown-## 【角色切换:[角色名称]】-📖 阅读角色定义: skills/ppt-master/references/[文件名].md-📋 当前任务: [简述]-```-----+**禁用功能**:`clipPath` | `mask` | `<style>` | `class/id` | 外部 CSS | `<foreignObject>` | `textPath` | `@font-face` | `<animate*>` | `<script>` | `marker-end` | `<iframe>` | `<symbol>+<use>`-## 参考资源+**PPT 兼容性替代**:-| 资源 | 路径 |+| 禁止 | 替代 ||------|------|-| 公共技术约束 | `skills/ppt-master/references/shared-standards.md` |-| 画布格式规范 | `skills/ppt-master/references/canvas-formats.md` |-| 设计指南 | `skills/ppt-master/references/design-guidelines.md` |-| 图片布局规范 | `skills/ppt-master/references/image-layout-spec.md` |-| SVG 图片嵌入 | `skills/ppt-master/references/svg-image-embedding.md` |-------## 注意事项--- 后处理三步不要添加 `--only` 等额外参数,直接运行即可-- 如果执行了 Optimizer 优化,需重新运行后处理与导出-- 本地预览:`python3 -m http.server -d <项目路径>/svg_final 8000`-------# 详细参考--以下内容为各角色和技术规范的详细说明。--------# Shared Technical Standards--PPT Master 公共技术约束,消除跨角色文件重复。-------## 1. SVG 禁用功能黑名单--以下功能在生成 SVG 时**绝对禁止**使用,否则 PPT 导出将出错:--| 禁止功能 | 说明 |-|----------|------|-| `clipPath` | 裁剪路径 |-| `mask` | 遮罩 |-| `<style>` | 内嵌样式表 |-| `class` / `id` | CSS 选择器属性 |-| 外部 CSS | 外部样式表链接 |-| `<foreignObject>` | 嵌入外部内容 |-| `<symbol>` + `<use>` | 符号引用复用 |-| `textPath` | 沿路径排列文本 |-| `@font-face` | 自定义字体声明 |-| `<animate*>` / `<set>` | SVG 动画 |-| `<script>` / 事件属性 | 脚本与交互 |-| `marker` / `marker-end` | 线段端点标记 |-| `<iframe>` | 内嵌框架 |-------## 2. PPT 兼容性替代方案--| 禁止写法 | 正确替代 |-|----------|---------|-| `fill="rgba(255,255,255,0.1)"` | `fill="#FFFFFF" fill-opacity="0.1"` |-| `<g opacity="0.2">...</g>` | 每个子元素单独设置 `fill-opacity` / `stroke-opacity` |-| `<image opacity="0.3"/>` | 图片后叠加 `<rect fill="背景色" opacity="0.7"/>` 遮罩层 |-| `marker-end` 箭头 | 用 `<polygon>` 绘制三角形箭头 |--**记忆口诀**:PPT 不认 rgba、不认组透明、不认图片透明、不认 marker。-------## 3. 画布格式速查--### 演示文稿--| 格式 | viewBox | 尺寸 | 比例 |-|------|---------|------|------|-| PPT 16:9 | `0 0 1280 720` | 1280x720 | 16:9 |-| PPT 4:3 | `0 0 1024 768` | 1024x768 | 4:3 |--### 社交媒体--| 格式 | viewBox | 尺寸 | 比例 |-|------|---------|------|------|-| 小红书 | `0 0 1242 1660` | 1242x1660 | 3:4 |-| 朋友圈 / Instagram Post | `0 0 1080 1080` | 1080x1080 | 1:1 |-| Story / 抖音竖屏 | `0 0 1080 1920` | 1080x1920 | 9:16 |--### 营销物料--| 格式 | viewBox | 尺寸 | 比例 |-|------|---------|------|------|-| 微信公众号头图 | `0 0 900 383` | 900x383 | 2.35:1 |-| 横版 Banner | `0 0 1920 1080` | 1920x1080 | 16:9 |-| 竖版海报 | `0 0 1080 1920` | 1080x1920 | 9:16 |-| A4 打印 (150dpi) | `0 0 1240 1754` | 1240x1754 | 1:1.414 |-------## 4. 基础 SVG 规则--- **viewBox** 必须与画布尺寸一致(`width`/`height` 与 `viewBox` 匹配)-- **背景**:用 `<rect>` 定义页面背景色-- **换行**:用 `<tspan>` 手动换行,禁止 `<foreignObject>`-- **字体**:仅使用系统字体(微软雅黑、Arial、Calibri 等),禁止 `@font-face`-- **样式**:仅使用内联样式(`fill="..."` `font-size="..."`),禁止 `<style>` / `class` / `id`-- **颜色**:使用 HEX 值,透明度用 `fill-opacity` / `stroke-opacity`-- **图片引用**:`<image href="../images/xxx.png" preserveAspectRatio="xMidYMid slice"/>`-- **图标占位**:`<use data-icon="icon-name" x="" y="" width="48" height="48" fill="#HEX"/>`(后处理自动嵌入)-------## 5. 后处理三步命令--必须按顺序执行,不可跳过或添加额外参数:--```bash-# 1. 拆分讲稿到各页备注文件-python3 scripts/total_md_split.py <项目路径>--# 2. SVG 后处理(图标嵌入、图片裁剪/嵌入、文本扁平化、圆角矩形转 Path)-python3 scripts/finalize_svg.py <项目路径>--# 3. 导出 PPTX(从 svg_final/ 导出,默认嵌入演讲备注)-python3 scripts/svg_to_pptx.py <项目路径> -s final-```--**禁止事项**:-- 禁止用 `cp` 替代 `finalize_svg.py`-- 禁止从 `svg_output/` 直接导出,必须从 `svg_final/`(`-s final`)导出-- 禁止添加 `--only` 等额外参数-- Optimizer 优化后需重新执行全部三步-------## 6. 项目目录结构--```-project/-├── svg_output/ # 原始 SVG(Executor 输出,含占位符)-├── svg_final/ # 后处理完成的最终 SVG(finalize_svg.py 输出)-├── images/ # 图片资源(用户提供 + AI 生成)-├── notes/ # 演讲备注(与 SVG 同名的 .md 文件)-│ └── total.md # 完整演讲备注文稿(拆分前)-├── templates/ # 项目使用的模板(如有)-└── *.pptx # 导出的 PPT 文件-```-------# 画布格式规范---## 格式速查表--| 格式 | viewBox | 比例 | 适用场景 |-|------|---------|------|---------|-| PPT 16:9 | `0 0 1280 720` | 16:9 | 商业演示、会议汇报 |-| PPT 4:3 | `0 0 1024 768` | 4:3 | 传统投影、学术演讲 |-| 小红书 | `0 0 1242 1660` | 3:4 | 图文分享、知识帖 |-| 朋友圈/IG | `0 0 1080 1080` | 1:1 | 方形海报、品牌展示 |-| Story/抖音 | `0 0 1080 1920` | 9:16 | 竖屏快拍、短视频封面 |-| 公众号头图 | `0 0 900 383` | 2.35:1 | 微信公众号文章配图 |-| 横版Banner | `0 0 1920 1080` | 16:9 | 网页Banner、电子屏 |-| 竖版海报 | `0 0 1080 1920` | 9:16 | 手机屏幕、电梯广告 |-| A4 打印 | `0 0 1240 1754` | 1:√2 | 打印海报、宣传单页 |--## 格式选择决策树--```-内容用途?-├─ 演示汇报-│ ├─ 现代设备 → PPT 16:9 (1280×720)-│ └─ 传统设备 → PPT 4:3 (1024×768)-├─ 社交分享-│ ├─ 小红书 → 1242×1660-│ ├─ 朋友圈/IG → 1080×1080-│ └─ Story/抖音 → 1080×1920-└─ 营销物料- ├─ 公众号头图 → 900×383- ├─ Banner → 1920×1080- └─ 打印 → 1240×1754-```--## 布局原则--### 横屏 (16:9, 4:3, 2.35:1)-- 视觉动线:Z字型,从左到右-- 边距:40-80px-- 布局:多栏、左右分割、网格-- 卡片尺寸(16:9):单行 530-600px,双行 265-295px--### 竖屏 (3:4, 9:16)-- 视觉动线:从上到下-- 边距:60-120px-- 布局:单栏、上下分割、卡片堆叠-- 卡片尺寸(3:4):高度 400-600px,间距 40-60px--### 正方形 (1:1)-- 视觉动线:中心辐射-- 边距:60-100px-- 核心区域:约 800×800px--## 格式特定设计--| 格式 | 标题区 | 内容区 | 特殊注意 |-|------|--------|--------|---------|-| PPT | 80-100px | 充分利用宽度 | 页码右下角 |-| 小红书 | 180-240px(加粗) | 上下留白充足 | 底部品牌区 120-160px |-| 朋友圈 | 200-280px | 中心 500-600px | 底部二维码区 150-200px |-| Story | — | 中部 1500px | 顶部安全区 120px,底部 180px |-| 公众号头图 | 居中/左对齐 48-72px | — | 配图右侧或背景 |--## ViewBox 示例--```xml-<svg width="1280" height="720" viewBox="0 0 1280 720"> <!-- PPT 16:9 -->-<svg width="1242" height="1660" viewBox="0 0 1242 1660"> <!-- 小红书 -->-<svg width="1080" height="1080" viewBox="0 0 1080 1080"> <!-- 朋友圈 -->-<svg width="1080" height="1920" viewBox="0 0 1080 1920"> <!-- Story -->-<svg width="900" height="383" viewBox="0 0 900 383"> <!-- 公众号头图 -->-```-----+| `rgba()` | `fill-opacity` / `stroke-opacity` |+| `<g opacity>` | 每个子元素单独设置 opacity |+| `<image opacity>` | 遮罩层叠加 |+| `marker-end` 箭头 | `<polygon>` 三角形 |+## 画布格式速查-# 设计指南--PPT Master 系统的详细设计指南和最佳实践。-------## 颜色系统--### 主色调选择--#### 咨询风格--```-德勤蓝: #0076A8 - 专业、可靠-麦肯锡蓝: #005587 - 权威、深度-BCG深蓝: #003F6C - 稳重、信任-普华永道橙: #D04A02 - 活力、创新-安永黄: #FFE600 - 乐观、清晰-```--#### 通用灵活风格--```-科技蓝: #2196F3 - 现代、创新-活力橙: #FF9800 - 热情、积极-成长绿: #4CAF50 - 健康、增长-专业紫: #9C27B0 - 创意、高端-警示红: #F44336 - 紧急、重要-```--### 辅助色系--#### 数据可视化配色--```-积极趋势(绿色系):- 深绿: #2E7D32 | 中绿: #4CAF50 | 浅绿: #81C784--警示趋势(黄色系):- 深黄: #F57C00 | 中黄: #FFA726 | 浅黄: #FFD54F--负面趋势(红色系):- 深红: #C62828 | 中红: #EF5350 | 浅红: #E57373-```--#### 中性色系--```-文本层级:- 主文本: #212121 (黑色, 87% opacity)- 副文本: #757575 (灰色, 60% opacity)- 辅助文本: #9E9E9E (浅灰, 38% opacity)--背景层级:- 主背景: #FFFFFF- 次背景: #F5F5F5- 卡片背景: #FAFAFA- 边框: #E0E0E0-```--### 对比度要求--遵循 WCAG 2.1 AA 级标准:-- 正文文本:至少 4.5:1-- 大号文本(24px+):至少 3:1-- 重要数据:至少 7:1(AAA 级)-------## 排版规范--### 字体层级--> 以正文字号为 1x 基准,其他层级按比例推导。字号选择取决于内容密度,而非设计风格。--#### 内容宽松(正文基准 24px)--适用:演讲型 PPT、培训课件、每页要点少(3-5 条)--```-H1 - 封面标题: 60-72px, Bold (2.5-3x)-H2 - 页面标题: 42-48px, Bold (1.75-2x)-H3 - 章节标题: 32-36px, SemiBold (1.3-1.5x)-正文 - 主要内容: 24px, Regular (1x 基准)-小字 - 注释说明: 18-20px, Regular (0.75-0.85x)-```--#### 内容密集(正文基准 18px)--适用:数据报告、咨询分析、每页要点多(6+ 条)--```-H1 - 封面标题: 45-54px, Bold (2.5-3x)-H2 - 页面标题: 27-36px, Bold (1.5-2x)-H3 - 章节标题: 22-27px, SemiBold (1.2-1.5x)-正文 - 主要内容: 18px, Regular (1x 基准)-小字 - 注释说明: 14-15px, Regular (0.75-0.85x)-```--### 字体选择--#### 中文字体--| 类别 | 代号 | 可选字体 | 适用场景 |-|------|:----:|---------|----------|-| 无衬线黑体 | A | 微软雅黑、黑体、幼圆、华文细黑 | 现代商务、正文(默认) |-| 衬线宋体 | B | 宋体、新宋体、仿宋、华文宋体 | 政务公文、正式报告 |-| 书法楷体 | C | 楷体、华文楷体、华文行楷 | 文化艺术、人文类 |-| 标题黑体 | D | 黑体、华文中宋、思源黑体 Bold | 大标题、强调 |-| 手写艺术 | E | 华文行楷、华文新魏、隶书 | 创意、个性化 |--#### 英文字体--| 类别 | 代号 | 可选字体 | 适用场景 |-|------|:----:|---------|----------|-| 无衬线现代 | F | Arial, Calibri, Segoe UI, Helvetica | 现代商务(默认) |-| 衬线经典 | G | Times New Roman, Georgia, Cambria | 正式文档、学术 |-| 标题展示 | H | Impact, Arial Black, Bebas Neue | 大标题、海报 |-| 手写风格 | I | Comic Sans MS, Segoe Script, Ink Free | 轻松活泼 |-| 等宽代码 | J | Consolas, Cascadia Code, Courier New | 数据、代码 |--#### 推荐 font-family--```css-/* 中文字体 */-"Microsoft YaHei", "微软雅黑", sans-serif /* A: 微软雅黑 */-"SimHei", "黑体", sans-serif /* A/D: 黑体 */-"SimSun", "宋体", serif /* B: 宋体 */-"FangSong", "仿宋", serif /* B: 仿宋 */-"KaiTi", "楷体", serif /* C: 楷体 */-"STXingkai", "华文行楷", cursive /* C/E: 华文行楷 */--/* 英文字体 */-"Arial", sans-serif /* F: Arial */-"Calibri", sans-serif /* F: Calibri */-"Times New Roman", serif /* G: Times */-"Georgia", serif /* G: Georgia */-"Impact", sans-serif /* H: Impact */-"Consolas", monospace /* J: 等宽 */-```--#### 中英文混排推荐--| 场景 | 中文字体 | 英文字体 |-|------|---------|---------|-| 现代商务 | 微软雅黑 (A) | Calibri / Arial (F) |-| 政务公文 | 宋体 (B) | Times New Roman (G) |-| 文化艺术 | 楷体 (C) | Georgia (G) |-| 科技互联网 | 黑体 (D) | Segoe UI (F) |--#### 字体角色--| 角色 | 用途 | 中文推荐 | 英文推荐 |-|------|------|----------|----------|-| 标题字体 | H1/H2 大标题 | A/C/D/E | F/G/H |-| 正文字体 | 段落、要点 | A/B | F/G |-| 强调字体 | KPI、关键词 | D | H/J |-| 注释字体 | 脚注、说明 | A/B | F/G |--### 行高和间距--```-标题行高: 1.2-1.3-正文行高: 1.5-1.6-段落间距: 1.5-2em-列表间距: 0.5-1em-```--### 文本换行与扁平化--- 生成阶段:采用 `<tspan>` 手动换行,通过 `x`/`dy` 控制行起点与行距-- 后处理:使用 `python3 scripts/finalize_svg.py <项目路径>`,包含文本扁平化功能-- 校验:对比 `svg_output` 与 `svg_final`,核对行序、样式与定位一致;目标文件中不应残留 `<tspan>`-------## 布局原则--### 16:9 画布规范--```-画布尺寸: 1280x720px-安全区域: 1200x640px (留40px边距)-标题区: 1200x100px-内容区: 1200x500px-页脚区: 1200x40px-```--### 网格系统--#### 单栏布局-```-适用: 封面、结束页、单一主题-内容宽度: 800-1000px,水平居中-```--#### 双栏布局-```-适用: 对比分析、左图右文-栏宽比例: 1:1 或 3:2,栏间距: 40-60px-```--#### 三栏布局-```-适用: 并列要点、流程步骤-栏宽比例: 1:1:1,栏间距: 30-40px-```--#### 四象限布局-```-适用: 矩阵分析、分类展示-象限尺寸: 560x250px (含间距),间距: 20-30px-```--### 卡片设计--#### 尺寸规范(强制)--```-单行卡片: 高度 530-600px-双行卡片: 每行 265-295px-三栏卡片: 每栏宽度 360-380px-```--#### 内边距--```-标题区: 20-30px-内容区: 30-40px-图表区: 20-30px-```--#### 圆角半径--```-小卡片: 8-12px-大卡片: 12-16px-图表: 8px-按钮: 6-8px-```-------## 图片布局规范--含图片页面的布局需根据图片比例动态计算。详细规范见 image-layout-spec.md。--**快速规则**:-- 比例 > 2.0 (超宽) → 上下布局-- 比例 1.5-2.0 (宽幅) → 优先上下,文字区不足则改左右-- 比例 1.2-1.5 (标准横图) → 左右布局-- 比例 0.8-1.2 (方形) → 左右布局-- 比例 < 0.8 (竖图) → 左右布局-------## 图表设计--### 常用图表类型--#### KPI 卡片-```-布局: 2x2 或 1x4-元素: 大号数字 (48-56px) + 指标名称 (18-20px) + 趋势图标/百分比 + 同比/环比说明-```--#### 柱状图-```-柱子数量: 3-8个,柱宽: 40-60px,间距: 柱宽的50-80%,显示数值标签-```--#### 折线图-```-线条: 2-3px,数据点: 圆形 半径 4-6px,网格线: 1px 浅灰色,图例: 右上角或底部-```--#### 饼图/环形图-```-分块: 3-6个,起始角度: -90度 (12点方向),环形宽度: 40-60px,显示百分比标签-```--#### 矩阵图-```-2x2布局,轴线: 2px实线,象限标签清晰,数据点大小统一-```--### 图表配色--| 方案 | 适用场景 | 示例 |-|------|---------|------|-| 单色渐变 | 同类数据比较 | #1976D2 → #42A5F5 → #90CAF9 |-| 对比色组 | 不同类别数据 | #2196F3 / #FF9800 / #4CAF50 |-| 顺序色 | 等级/强度展示 | #4CAF50 → #FFC107 → #F44336 |-------## 图标使用--### 项目内置图标库(推荐)--位于 `templates/icons/`,包含 640+ 个 SVG 图标。--```-完整索引: templates/icons/FULL_INDEX.md-程序化查询: templates/icons/icons_index.json-使用方式: templates/icons/README.md-```--**分类概览**:-- 通用:home, settings, search, user, calendar, mail...-- 数据:trending-up, chart-bar, database, file-text...-- 业务:rocket, target, lightbulb, trophy, star...-- 箭头:arrow-right/left/up/down, chevron-right...-- 状态:check, check-circle, x-circle, alert-circle...-- 工具:edit, trash, download, upload, share...--### 图标规范--```-尺寸: 小 16-20px | 常规 24-32px | 大 40-48px-线宽: 2px (统一)-颜色: 与主色调协调-间距: 图标大小的 50%-```-------## 常见模式--### 封面页-- 顶部:公司Logo(可选),中部:演示标题 (H1),副标题,底部:日期、演讲人-- 简洁大气,主色调背景或图片,文字居中或偏左--### 内容页-- 标准结构:页面标题 (H2) → 主要内容 → 页码/注释-- 变体:左标题右内容、上下分割、多栏布局--### 数据页-- 数据可视化为主,关键数字突出,提供数据来源,添加趋势说明-- 布局:大图表+要点、多小图表组合、KPI仪表盘--### 总结页-- 3-5个核心要点 + 行动号召 (CTA) + 下一步计划-- 列表或编号,图标辅助,简洁明了-------## 常见问题--| 问题 | 解决方案 |-|------|---------|-| 内容太多放不下 | 分多页、用更小字号(>=16px)、精简文字、用图表代替 |-| 颜色搭配不协调 | 限制主色<=3种、增加中性色占比、参考成功案例 |-| 布局不平衡 | 检查对齐、调整间距、使用网格系统、平衡视觉重量 |-------# Role: Strategist--## 核心使命--作为顶尖 AI 演示文稿策略师,接收源文档,进行内容分析与设计规划,输出 **《演示文稿设计规范与内容大纲》**。--## 流程上下文--| 上一步 | 当前 | 下一步 |-|--------|------|--------|-| 项目创建 + 模板选项确认 | **策略师**:八项确认 + 设计规范 | Image_Generator 或 Executor |--------## 1. 八项确认流程--在开始分析前,依次确认以下问题并提供专业建议。--### a. 画布格式确认--根据场景推荐格式(详见 shared-standards.md 画布格式速查表)。--### b. 页数范围确认--根据源文档内容量提供具体页数建议。--### c. 关键信息确认--确认目标受众、使用场合、核心信息,根据文档性质提供初步判断。--### d. 风格目标确认--| 风格 | 核心定位 | 适合受众 | 一句话特点 |-|------|----------|----------|------------|-| **A) 通用灵活** | 视觉冲击优先 | 公众/客户/学员 | 「让人一眼被吸引」 |-| **B) 一般咨询** | 数据清晰优先 | 团队/管理层 | 「让数据说话」 |-| **C) 顶级咨询** | 逻辑说服优先 | 高管/董事会 | 「让结论先行」 |--**风格选择决策树**:--```-内容特征?- ├─ 大量图片/宣传性强 ──→ A) 通用灵活- ├─ 数据分析/进展汇报 ──→ B) 一般咨询- └─ 战略决策/说服高管 ──→ C) 顶级咨询--受众?- ├─ 公众/客户/学员 ────→ A) 通用灵活- ├─ 团队/管理层 ───────→ B) 一般咨询- └─ 高管/董事会/投资人 → C) 顶级咨询-```--### e. 配色方案建议--基于内容特征和行业属性主动提供配色方案(HEX 色值)。--**行业配色速查**(完整 14 行业见 `scripts/config.py` 的 `INDUSTRY_COLORS`):--| 行业 | 主导色 | 特点 |-|------|--------|------|-| 金融/商务 | `#003366` 深蓝 | 稳重信赖 |-| 科技/互联网 | `#1565C0` 明蓝 | 创新活力 |-| 医疗/健康 | `#00796B` 青绿 | 专业安心 |-| 政务/政府 | `#C41E3A` 中国红 | 庄重权威 |--**配色规则**:60-30-10 法则(主导色 60%、辅助色 30%、强调色 10%);文本对比度 >= 4.5:1;单页不超 4 色。--### f. 图标使用方式确认--| 选项 | 方式 | 适用场景 |-|------|------|----------|-| **A** | Emoji 表情 | 轻松活泼、社交媒体 |-| **B** | AI 生成 | 需要定制风格 |-| **C** | 内置图标库 | 专业场景(推荐) |-| **D** | 自定义图标 | 有品牌素材 |--内置库含 640+ 图标,详见 `templates/icons/README.md`。--> **选择 C 时的强制规则**:-> 1. 查阅 `templates/icons/icons_index.json` 验证图标存在-> 2. 图标名称为单一名称(如 `factory`),不含路径前缀-> 3. 禁止使用索引中不存在的名称-> 4. 在《设计规范》中列出最终图标清单,Executor 只能使用清单内图标->-> **快速查找**:按分类 → `icons_index.json` 的 `categories`;按语义 → `quickLookup`;完整列表 → `templates/icons/FULL_INDEX.md`--### g. 图片使用确认--| 选项 | 方式 | 适用场景 |-|------|------|----------|-| **A** | 不使用图片 | 数据报告、流程说明 |-| **B** | 用户提供 | 有现成图片素材 |-| **C** | AI 生成 | 需要定制插图、背景 |-| **D** | 占位符预留 | 后期补充图片 |--**选择包含 B 时**,必须在输出规范前运行 `python3 scripts/analyze_images.py <项目路径>/images`,将扫描结果整合进图片资源清单。--**选择 B/C/D 时**,在规范中添加图片资源清单:--| 列 | 说明 |-|----|------|-| 文件名 | 如 `cover_bg.png` |-| 尺寸 | 如 `1280x720` |-| 比例 | 如 `1.78` |-| 布局建议 | 如 `宽幅横图 (适合全屏/插图)` |-| 用途 | 如 `封面背景` |-| 类型 | 背景图 / 实景照片 / 插画配图 / 图表架构 / 装饰图案 |-| 状态 | 待生成 / 已有 / 占位符 |-| 生成描述 | AI 生成时填写详细描述 |--**图片类型说明**:--| 类型 | 适用场景 |-|------|----------|-| 背景图 | 封面/章节页全页背景,需预留文字区域 |-| 实景照片 | 真实场景、人物、产品、建筑 |-| 插画配图 | 扁平设计、矢量风格、概念图解 |-| 图表架构 | 流程图、架构图、概念关系图 |-| 装饰图案 | 局部装饰、纹理、边框、分隔元素 |--**图片与布局适配原则**(详细计算规则参考 `docs/image_layout_spec.md`):--| 图片比例 | 推荐布局 |-|----------|----------|-| > 2.0 (超宽) | 上下分栏,上方通栏 |-| 1.5-2.0 (宽幅) | 上下分栏 |-| 1.2-1.5 (标准横图) | 左右分栏 |-| 0.8-1.2 (方图) | 左右分栏 |-| < 0.8 (竖图) | 左右分栏,图片在左 |--核心逻辑:布局容器宽高比必须与图片原始比例相近,禁止宽图塞方形容器或竖图放横向窄条。--> **流程衔接**:选择 C) AI 生成时,输出设计规范后提示用户调用 Image_Generator,图片归集到 `images/` 后再进入 Executor。--### h. 排版方案(字体 + 字号)--#### 字体预设--| 场景 | 预设 | 标题 | 正文 | 强调 |-|------|------|------|------|------|-| 现代商务、科技 | P1 | 微软雅黑/Arial | 微软雅黑/Calibri | 黑体 |-| 政务公文、报告 | P2 | 黑体 | 宋体/Times | 宋体 |-| 文化艺术、人文 | P3 | 楷体/Georgia | 微软雅黑 | 黑体 |-| 传统稳重风格 | P4 | 宋体 | 微软雅黑/Arial | 宋体 |-| 英文为主 | P5 | Arial/Impact | Calibri/Georgia | Arial Black |--#### 字号基准(所有字号使用 px)--选择原则:字号根据**内容密度**选择,而非设计风格。--| 内容密度 | 每页要点 | 正文基准 | 适用场景 |-|----------|----------|----------|----------|-| 宽松 | 3-5 条 | 24px | 演讲型、培训课件 |-| 密集 | 6+ 条 | 18px | 数据报告、咨询分析 |--| 层级 | 比例 | 24px 基准 | 18px 基准 |-|------|------|-----------|-----------|-| 封面标题 | 2.5-3x | 60-72px | 45-54px |-| 页面标题 | 1.5-2x | 36-48px | 27-36px |-| **正文** | **1x** | **24px** | **18px** |-| 注释 | 0.75x | 18px | 14px |--### i. 演讲备注要求(默认,无需沟通)--- 文件命名:推荐与 SVG 同名(`01_封面.svg` → `notes/01_封面.md`),兼容 `notes/slide01.md`-- 在《设计规范》中填写:演讲总时长、备注风格(正式/口语化/互动式)、讲演目的(告知/说服/激励/指导/汇报)-- 拆分后的备注文件中不允许出现 `#` 标题行(`notes/total.md` 汇总讲稿必须使用 `#` 标题行)-------## 2. 执行师风格详解(第四项确认依据)--### A) 通用灵活 — Executor_General--**独有能力**:-- 全幅大图 + 渐变蒙版(宣传/推介必备)-- 自由创意布局(不受网格约束)-- 三种风格变体:图文结合、极简演讲(Keynote 风)、创意设计--**典型场景**:招商/文旅推介、产品发布、培训课件、品牌宣传--**禁忌**:过于严肃刻板、密集数据表格--### B) 一般咨询 — Executor_Consultant--**独有能力**:-- KPI 仪表盘(4 卡片布局,大数字 + 趋势箭头)-- 专业图表组合(柱状图、折线图、饼图、漏斗图)-- 数据颜色分级(红/黄/绿三色达标状态)--**典型场景**:工作进展汇报、财务分析、政府工作报告、招投标/提案--**禁忌**:花哨装饰、图片为主角--### C) 顶级咨询 — Executor_Consultant_Top--**独有能力**:--| 能力 | 说明 |-|------|------|-| 数据情境化 | 每个数据必须有对比参照("增长 63%,行业均值仅 12%") |-| SCQA 框架 | 情境 → 冲突 → 问题 → 答案 |-| 金字塔原则 | 结论先行,核心观点放标题位置 |-| 战略性配色 | 颜色服务于信息,不做装饰 |-| 图表 vs 表格 | 趋势用图表,精确值用表格 |--**独有页面元素**:渐变顶条 + 深色核心观点区、机密标识 + 严谨页脚、MECE 分解图 / 驱动因素树 / 瀑布图--**典型场景**:战略决策报告、深度分析报告、咨询交付物(MBB 级)--**禁忌**:孤立数据、主观表述、装饰性元素-------## 3. 配色知识库--### 咨询风格配色(专业权威)--| 品牌/风格 | 色值 | 心理感受 |-|-----------|------|----------|-| 德勤蓝 | `#0076A8` | 专业、可靠 |-| 麦肯锡蓝 | `#005587` | 权威、深度 |-| BCG 深蓝 | `#003F6C` | 稳重、信任 |-| 普华永道橙 | `#D04A02` | 活力、创新 |-| 安永黄 | `#FFE600` | 乐观、清晰 |--### 通用灵活配色(现代活力)--| 风格 | 色值 | 适用场景 |-|------|------|----------|-| 科技蓝 | `#2196F3` | 科技、互联网 |-| 活力橙 | `#FF9800` | 营销、推广 |-| 成长绿 | `#4CAF50` | 健康、环保、增长 |-| 专业紫 | `#9C27B0` | 创意、高端 |-| 警示红 | `#F44336` | 紧急、重要 |--### 数据可视化配色--- 积极趋势(绿色系):`#2E7D32` → `#4CAF50` → `#81C784`-- 警示趋势(黄色系):`#F57C00` → `#FFA726` → `#FFD54F`-- 负面趋势(红色系):`#C62828` → `#EF5350` → `#E57373`-------## 4. 布局模式速查--| 布局 | 适用场景 | PPT 16:9 参考尺寸 |-|------|----------|-------------------|-| 单栏居中 | 封面、结语、重要观点 | 内容宽 800-1000px,水平居中 |-| 双栏布局 | 对比分析、左图右文 | 栏宽比 1:1 或 3:2,间距 40-60px |-| 三栏布局 | 并列要点、流程步骤 | 栏宽比 1:1:1,间距 30-40px |-| 四象限 | 矩阵分析、分类展示 | 象限 560x250px,间距 20-30px |-| 上下分栏 | 超宽图片+文字 | 图片通栏,文字区 >= 150px 高 |-| 左右分栏 | 标准/竖图+文字 | 图片侧放,文字区 >= 280px 宽 |--**PPT 16:9 (1280x720) 关键尺寸**:安全区域 1200x640(留 40px 边距);标题区 1200x100;内容区 1200x500;页脚区 1200x40。-------## 5. 模板灵活性原则--> 模板是起点,不是终点。--策略师应在 `scripts/project_manager.py` 生成的模板基础上,结合用户需求、内容特征、受众特点进行专业判断:--1. 比例系统可调(字号比例是参考值)-2. 配色方案可定制(结合品牌和内容特征)-3. 布局模式可组合(6 种基础布局自由变化)-4. 内容结构可扩展(12 章节框架可增减)-5. 间距/圆角等细节由 Executor 根据内容密度调整-------## 6. 工作流程与交付物--### 6.1 内容规划策略--| 风格 | 内容大纲 | 设计规范 | 演讲备注 |-|------|----------|----------|----------|-| A) 通用灵活 | 智能解构源文档,每页定义核心主题 | 视觉主题、色彩方案、布局原则 | 简洁演讲稿 |-| B) 一般咨询 | 结构化逻辑板块,数据驱动洞察 | 咨询风格配色、内容结构化布局 | 专业术语、数据解读、结论先行 |-| C) 顶级咨询 | SCQA 框架,金字塔原则结论先行 | 数据情境化、颜色战略性使用 | 高度凝练、逻辑严密、结论驱动 |--### 6.2 大纲输出规范(必须包含 12 章节)--| 章节 | 内容要求 |-|------|----------|-| 一、项目信息 | 项目名称、画布格式、页数、风格、受众、场景、日期 |-| 二、画布规范 | 格式、尺寸、viewBox、边距、内容区域 |-| 三、视觉主题 | 风格说明、亮/深主题、调性、配色方案(含色值表)、渐变方案 |-| 四、排版体系 | 字体方案(P1-P5)、字号层级(H1-Code 7级) |-| 五、布局原则 | 页面结构(页眉/内容/页脚区)、6种布局模式、间距规范 |-| 六、图标使用规范 | 来源说明、占位符语法、推荐图标清单 |-| 七、图片资源清单 | 文件名、尺寸、比例、用途、状态、生成描述 |-| 八、内容大纲 | 按章节分组,每页含布局、标题、内容要点 |-| 九、演讲备注要求 | 文件命名规则、内容结构说明 |-| 十、技术约束提醒 | SVG 生成规则、PPT 兼容性规则 |-| 十一、设计检查清单 | 生成前/生成后检查项 |-| 十二、下一步 | 明确后续流程(Image_Generator 或 Executor) |--**生成步骤**:-1. 读取参考模板:`templates/design_spec_reference.md`-2. 结合分析内容从头生成完整规范-3. 保存至:`projects/<项目名>.../设计规范与内容大纲.md`-------## 7. 项目文件夹--项目文件夹应在进入策略师角色之前已创建。如未创建,先执行:--```bash-python3 scripts/project_manager.py init <项目名称> --format <画布格式>-```--策略师将《设计规范与内容大纲》保存至 `projects/<项目名>_<格式>_<YYYYMMDD>/设计规范与内容大纲.md`。-------## 8. 完成设计规范并提示下一步--根据已确认的模板选项和图片使用选择提示下一步。--### 模板选项 A(使用已有模板)--```-✅ 设计规范已完成。模板已就绪。-下一步:-- 图片包含 AI 生成 → 调用 Image_Generator-- 图片不包含 AI 生成 → 调用 Executor-```--### 模板选项 B(不使用模板)--```-✅ 设计规范已完成。-下一步:-- 图片包含 AI 生成 → 调用 Image_Generator-- 图片不包含 AI 生成 → 调用 Executor(自由生成每一页)-```-------# Image_Generator 参考手册--> 本文件为 Image_Generator 角色的精简参考。通用标准(SVG 技术约束、画布格式、后处理流程等)见 [shared-standards.md](./shared-standards.md)。--## 核心使命--接收 Strategist 输出的《设计规范与内容大纲》中的「图片资源清单」,为每张待生成的图片创建优化提示词,并通过 AI 工具生成图片,保存到项目 `images/` 目录。--**触发条件**: 需要生成 AI 图片时(独立使用或流程中调用)--| 模式 | 触发方式 | 说明 |-|------|----------|------|-| **独立使用** | 直接说明图片需求 | 生成单张或多张 AI 图片 |-| **流程中使用** | `generate-ppt` 选择 AI 生成图片 | 为项目批量生成图片资源 |--> 流程中下一步:Executor 生成 SVG-------## 1. 输入与输出--### 输入--- **设计规范与内容大纲**(来自 Strategist):项目主题、目标受众、设计风格、配色方案、画布格式-- **图片资源清单**(关键输入):-- | 文件名 | 尺寸 | 用途 | 类型 | 状态 | 生成描述 |- |--------|------|------|------|------|----------|- | cover_bg.png | 1920x1080 | 封面背景 | 背景图 | 待生成 | 现代科技感抽象背景,深蓝渐变 |--### 输出--| 产出物 | 路径/说明 | 要求 |-|--------|-----------|------|-| 提示词文档 | `项目/images/image_prompts.md` | **必须**用文件写入工具保存,不能仅在对话中输出 |-| 优化提示词 | 每张图片独立提示词 | 可直接用于 AI 图像生成工具,兼做 alt 文本 |-| 图片文件 | `项目/images/` 目录 | 按清单文件名命名 |-| 更新后的清单 | 状态变更 | 「待生成」→「已生成」 |-------## 2. 统一提示词结构--### 2.1 标准输出格式--每张图片必须按以下格式输出:--```markdown-### 图片 N: {文件名}--| 属性 | 值 |-| -------- | ------------------------------------ |-| 用途 | {在哪页/承担什么功能} |-| 类型 | {背景图/插画/实景照片/图表/装饰图案} |-| 尺寸 | {宽}x{高} ({宽高比}) |-| 原始描述 | {用户在清单中提供的描述} |--**提示词 (Prompt)**:-{主体描述}, {风格指令}, {色彩指令}, {构图指令}, {质量指令}--**负面提示词 (Negative Prompt)**:-{需要排除的元素}--**图片描述 (Alt Text)**:-> {中文描述,用于无障碍访问和图片说明}-```--### 2.2 提示词组成要素--| 要素 | 说明 | 示例 |-|------|------|------|-| 主体描述 | 核心内容 | `Abstract geometric shapes`, `Team collaboration scene` |-| 风格指令 | 视觉风格 | `flat design`, `3D isometric`, `watercolor style` |-| 色彩指令 | 配色方案 | `color palette: navy blue (#1E3A5F), gold (#D4AF37)` |-| 构图指令 | 布局比例 | `16:9 aspect ratio`, `centered composition` |-| 质量指令 | 分辨率质量 | `high quality`, `4K resolution`, `sharp details` |-| 负面提示词 | 排除元素 | `text, watermark, blurry, low quality` |--### 2.3 风格关键词速查--| 设计风格 | 推荐图片风格 | 核心关键词 |-|----------|-------------|------------|-| 通用灵活 | 现代插画、扁平设计 | `modern`, `flat design`, `gradient`, `vibrant colors` |-| 一般咨询 | 简洁专业、商务风 | `professional`, `clean`, `corporate`, `minimalist` |-| 顶级咨询 | 高端简约、抽象几何 | `premium`, `sophisticated`, `geometric`, `abstract`, `elegant` |--### 2.4 色彩整合方法--从设计规范提取配色,转换为提示词:--```-主导色: #1E3A5F (深海蓝) → "deep navy blue (#1E3A5F)"-辅助色: #F8F9FA (浅灰) → "light gray (#F8F9FA)"-强调色: #D4AF37 (金) → "gold accent (#D4AF37)"--完整指令: "color palette: deep navy blue (#1E3A5F), light gray (#F8F9FA), gold accent (#D4AF37)"-```--### 2.5 画布格式与宽高比--| 画布格式 | 背景图宽高比 | 建议分辨率 |-|----------|-------------|------------|-| PPT 16:9 | 16:9 | 1920x1080 或 2560x1440 |-| PPT 4:3 | 4:3 | 1600x1200 |-| 小红书 | 3:4 | 1242x1660 |-| 朋友圈 | 1:1 | 1080x1080 |-| Story | 9:16 | 1080x1920 |--> Nano Banana 支持的宽高比:`1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`-------## 3. 图片类型分类与处理--### 类型判断流程--1. 全页/大面积铺底 → **背景图** (3.1)-2. 真实场景/人物/产品 → **实景照片** (3.2)-3. 扁平/插画/卡通风格 → **插画配图** (3.3)-4. 流程/架构/关系 → **图表/架构图** (3.4)-5. 局部装饰/纹理 → **装饰图案** (3.5)--### 3.1 背景图 (Background)--**识别特征**: 封面、章节页的全页背景,需承载文字叠加--| 要点 | 说明 |-|------|------|-| 强调背景属性 | 添加 `background`, `backdrop` |-| 预留文字区域 | `negative space in center for text overlay` |-| 避免强主体 | 使用抽象、渐变、几何元素 |-| 低对比细节 | `subtle`, `soft`, `muted` |--**模板**: `Abstract {主题元素} background, {风格} style, {主色} to {辅色} gradient, subtle {装饰元素}, clean negative space in center for text overlay, {宽高比} aspect ratio, high resolution, professional presentation background`--**负面提示词**: `text, letters, watermark, faces, busy patterns, high contrast details`--### 3.2 实景照片 (Photography)--**识别特征**: 真实场景、人物、产品、建筑等照片质感--| 要点 | 说明 |-|------|------|-| 强调真实感 | `photography`, `photorealistic`, `real photo` |-| 光影效果 | `natural lighting`, `soft shadows`, `studio lighting` |-| 背景处理 | `white background` / `blurred background` / `contextual setting` |-| 人物多样性 | `diverse`, `professional attire` |--**模板**: `{主体描述}, professional photography, {光影类型} lighting, {背景类型} background, color grading matching {配色方案}, high quality, sharp focus, 8K resolution`--**负面提示词**: `watermark, text overlay, artificial, CGI, illustration, cartoon, distorted faces`--### 3.3 插画配图 (Illustration)--**识别特征**: 扁平设计、矢量风格、卡通、概念图解--| 要点 | 说明 |-|------|------|-| 明确风格 | `flat design`, `isometric`, `vector style`, `hand-drawn` |-| 简化细节 | `simplified`, `clean lines`, `minimal details` |-| 统一色板 | 严格使用设计规范配色 |-| 背景选择 | `white background` 或 `transparent background` |--**模板**: `{主体描述}, {插画风格} illustration style, {细节程度} with clean lines, color palette: {配色列表}, {背景类型} background, professional {用途} illustration`--**负面提示词**: `realistic, photography, 3D render, complex textures, watermark`--### 3.4 图表/架构图 (Diagram)--**识别特征**: 流程图、架构图、概念关系图、数据可视化--| 要点 | 说明 |-|------|------|-| 清晰结构 | `clear structure`, `organized layout`, `logical flow` |-| 连接表示 | `arrows indicating flow`, `connecting lines` |-| 学术/专业感 | `suitable for academic publication`, `professional diagram` |-| 浅色背景 | `white background` 或 `light gray background` |--**模板**: `{图表类型} diagram showing {内容描述}, {组件描述} connected by {连接方式}, {风格} style with {配色方案}, white background, clear labels, professional technical diagram`--**负面提示词**: `cluttered, messy, overlapping elements, dark background, realistic, photography`--### 3.5 装饰图案 (Decorative Pattern)--**识别特征**: 局部装饰、纹理、边框、分隔元素--| 要点 | 说明 |-|------|------|-| 可重复性 | `seamless`, `tileable`, `repeatable`(如需要) |-| 低调辅助 | `subtle`, `understated`, `supporting element` |-| 透明友好 | `transparent background` 或 `isolated element` |-| 小尺寸适用 | 考虑在小尺寸下的可识别性 |--**模板**: `{图案类型} decorative pattern, {风格} style, {配色方案}, {背景类型} background, subtle and elegant, suitable for {用途}`--**负面提示词**: `busy, cluttered, high contrast, distracting, photorealistic`-------## 4. 图片生成工作流--### 4.1 分析阶段--1. 阅读设计规范,理解项目整体风格-2. 提取配色方案、画布格式、目标受众-3. 逐一分析图片资源清单中的每张图片-4. 判断每张图片的类型(参考第 3 节)--### 4.2 提示词生成阶段--对每张「待生成」状态的图片:--1. **判断类型** → 背景图/实景照片/插画/图表/装饰-2. **理解用途** → 在哪页?承担什么功能?-3. **分析原始描述** → 用户「生成描述」中的信息-4. **应用类型要点** → 参考对应类型的表格-5. **生成优化提示词** → 使用 2.1 统一输出格式-6. **保存提示词文档** → **必须**写入 `项目/images/image_prompts.md`--### 4.3 图片生成阶段--> 前置条件:必须先完成 4.2,确保 `images/image_prompts.md` 已创建--#### 方式一:Nano Banana 命令行工具(推荐)--```bash-python3 scripts/nano_banana_gen.py "你的提示词" \- --aspect_ratio 16:9 --image_size 1K \- --output 项目/images --filename cover_bg-```--**参数列表**:--| 参数 | 简写 | 说明 | 默认值 |-|------|------|------|--------|-| `prompt` | - | 正向提示词(位置参数) | `Nano Banana` |-| `--negative_prompt` | `-n` | 负面提示词 | 无 |-| `--aspect_ratio` | - | 图片宽高比 | `1:1` |-| `--image_size` | - | 尺寸 (`1K`/`2K`/`4K`) | `1K` |-| `--output` | `-o` | 输出目录 | 当前目录 |-| `--filename` | `-f` | 输出文件名(不含扩展名) | 自动命名 |--**环境变量**: 必需 `GEMINI_API_KEY`,可选 `GEMINI_BASE_URL`--**生成节奏控制(强制)**:-- 每次只执行一个生成命令,等待确认文件落盘后再执行下一条-- 建议每张间隔 2-5 秒,避免并发导致失败-- 如出现失败/无输出,先停止队列,检查环境变量与输出目录,再继续--#### 方式二:自动生成--直接调用图像生成 API,下载并保存到 `项目/images/` 目录。--#### 方式三:Gemini 网页版--1. 在 [Gemini](https://gemini.google.com/) 中生成图片-2. 选择 **Download full size** 下载高分辨率版本-3. 去水印:`python3 scripts/gemini_watermark_remover.py <图片路径>`-4. 将处理后的图片放入 `项目/images/` 目录--#### 方式四:手动生成(其他 AI 平台)--提示词已保存在 `images/image_prompts.md`,告知用户文件位置。用户自行到 Midjourney、DALL-E、Stable Diffusion、文心一格、通义万相等平台生成,将图片放入 `项目/images/` 目录。--### 4.4 验证阶段--- 确认所有图片已保存到 `images/` 目录-- 检查文件名与清单一致-- 更新图片资源清单状态为「已生成」-------## 5. 提示词文档模板--创建 `项目/images/image_prompts.md` 时使用以下结构:--```markdown-# 图片生成提示词--> 项目: {项目名称}-> 生成时间: {日期}-> 配色方案: 主导色 {#HEX} | 辅助色 {#HEX} | 强调色 {#HEX}-------## 图片清单总览--| # | 文件名 | 类型 | 尺寸 | 状态 |-|---|--------|------|------|------|-| 1 | cover_bg.png | 背景图 | 1920x1080 | 待生成 |-------## 详细提示词--### 图片 1: cover_bg.png--| 属性 | 值 |-|------|----|-| 用途 | 封面背景 |-| 类型 | 背景图 |-| 尺寸 | 1920x1080 (16:9) |-| 原始描述 | 现代科技感抽象背景,深蓝渐变 |--**提示词 (Prompt)**:-Abstract futuristic background with flowing digital waves...--**图片描述 (Alt Text)**:-> 现代科技感抽象背景,深蓝色渐变配合数字波浪和粒子效果-------## 使用说明--1. 复制上方「提示词」到 AI 图像生成工具-2. 推荐平台: Midjourney / DALL-E 3 / Gemini / Stable Diffusion-3. 生成后将图片重命名为对应文件名-4. 放入 `images/` 目录-```-------## 6. 负面提示词速查--### 按图片类型--| 类型 | 推荐负面提示词 |-|------|---------------|-| 背景图 | `text, letters, watermark, faces, busy patterns, high contrast details` |-| 实景照片 | `watermark, text overlay, artificial, CGI, illustration, cartoon, distorted faces` |-| 插画配图 | `realistic, photography, 3D render, complex textures, watermark` |-| 图表/架构图 | `cluttered, messy, overlapping elements, dark background, realistic` |-| 装饰图案 | `busy, cluttered, high contrast, distracting, photorealistic` |--### 通用负面提示词--- **标准版**: `text, watermark, signature, blurry, distorted, low quality`-- **扩展版**(人物场景): `text, watermark, signature, blurry, low quality, distorted, extra fingers, mutated hands, poorly drawn face, bad anatomy, extra limbs, disfigured, deformed`-------## 7. 常见问题--### 无「生成描述」时的默认推断--| 用途 | 默认推断 |-|------|----------|-| 封面背景 | 抽象渐变背景,预留中央文字区域 |-| 章节页背景 | 简洁几何图案,侧重单色调 |-| 团队介绍页 | 团队协作场景插图(扁平风格) |-| 数据展示页 | 简洁几何图案或纯色背景 |-| 产品展示 | 产品实拍风格,白底或渐变背景 |--### 图片不满意时--提供提示词变体供用户选择:变体 A(更抽象)、变体 B(更具象)、变体 C(不同色调)。-------## 8. 角色协作--### 与 Strategist 的衔接--| 方向 | 内容 |-|------|------|-| 接收 | 设计规范与内容大纲(含图片资源清单) |-| 触发条件 | 用户在「图片使用」中选择包含「C) AI 生成」 |-| 关键信息 | 配色方案、设计风格、画布格式 |--### 与 Executor 的衔接--| 方向 | 内容 |-|------|------|-| 交付 | 所有图片已放入 `项目/images/` 目录 |-| Executor 引用 | `<image href="../images/xxx.png" .../>` |-| 路径说明 | SVG 在 `svg_output/`,图片在 `images/`,使用相对路径 `../images/` |-------## 9. 任务完成检查点--### 必须完成项--- [ ] 已创建提示词文档 `项目/images/image_prompts.md`-- [ ] 每张图片都有:类型判断 + 优化提示词 + 负面提示词 + Alt Text-- [ ] 使用统一输出格式(2.1 标准格式)-- [ ] 已输出阶段完成确认--### 图片就绪项(至少满足一项)--- [ ] 所有图片已保存到 `项目/images/` 目录-- [ ] 或:已明确告知用户使用 `image_prompts.md` 自行生成--### 流程流转--- [ ] 已提示用户进入下一步(切换到 Executor 角色)--> **关键检查**: 如果 `images/image_prompts.md` 未创建,或输出格式不符合 2.1 标准,任务未完成。--### 完成确认输出格式--```markdown-## Image_Generator 阶段完成--- [x] 已创建提示词文档 `项目/images/image_prompts.md`-- [x] 已为 X 张图片生成优化提示词-- [x] 所有图片已保存到 `images/` 目录-- [x] 已更新图片资源清单状态--**图片状态汇总**:--| 文件名 | 类型 | 尺寸 | 状态 |-|--------|------|------|------|-| cover_bg.png | 背景图 | 1920x1080 | 已生成 |--**下一步**: 切换到 Executor 角色开始生成 SVG-```-------# Executor 公共规范--> 各风格差异化内容见对应 `executor-{style}.md`。-------## 1. 模板遵循规则--如果项目 `templates/` 目录中存在模板文件,必须遵循模板结构:--| 页面类型 | 对应模板 | 遵循规则 |-|---|---|---|-| 封面 | `01_cover.svg` | 继承背景、装饰元素、布局结构,替换占位符内容 |-| 章节页 | `02_chapter.svg` | 继承编号样式、标题位置、装饰元素 |-| 内容页 | `03_content.svg` | 继承页眉页脚样式,**内容区可自由布局** |-| 结束页 | `04_ending.svg` | 继承背景、感谢语位置、联系信息布局 |-| 目录页 | `02_toc.svg` | **可选**:继承目录标题、列表样式 |--### 页面-模板对应声明(必须输出)--开始生成每一页之前,必须明确输出该页使用的模板或"自由生成":--```-📝 **模板对应**: `templates/01_cover.svg`(或"无(自由生成)")-🎯 **遵循规则/布局策略**: [具体说明]-```--- **内容页**:模板只定义页眉和页脚,内容区域由 Executor 自由布局-- **无模板时**:完全按照《设计规范与内容大纲》自由生成-------## 2. 设计参数确认(强制步骤)--> 在生成第一页 SVG 之前,**必须先回顾《设计规范与内容大纲》中的关键设计参数**,确保后续生成严格遵循规范。--必须输出确认,包含:画布尺寸、正文字号、配色方案(主导/辅助/强调色 HEX)、字体方案。--**为什么必须做这一步?** 防止"规范是规范,执行是执行"的脱节问题。-------## 3. 执行准则--- **绝对遵循规范**:严格按照规范中的色彩、布局、画布格式、排版参数设计-- **遵循模板结构**:如有模板,继承模板的视觉框架-- **分阶段批量生成**(推荐):- 1. **视觉构建阶段**:连续生成所有 SVG 页面,确保设计风格和布局坐标的高度一致性(Visual Consistency)- 2. **逻辑构建阶段**:SVG 全部定稿后,再批量生成演讲备注,确保叙事逻辑连贯(Narrative Continuity)-- **技术规范**:详见 [shared-standards.md](shared-standards.md) 中的 SVG 技术约束与 PPT 兼容性规则--### SVG 文件命名规范--文件命名格式:`<序号>_<页面名称>.svg`--- **中文内容** → 中文命名:`01_封面.svg`、`02_目录.svg`、`03_核心优势.svg`-- **英文内容** → 英文命名:`01_cover.svg`、`02_agenda.svg`、`03_key_benefits.svg`-- **序号规则**:两位数字,从 01 开始递增-- **页面名称**:简洁描述性,与《设计规范与内容大纲》中的页面标题一致-------## 4. 图标使用--四种方式:**A: Emoji**(`<text>🚀</text>`)| **B: AI 生成**(SVG 基本元素)| **C: 内置库**(`templates/icons/` 640+ 图标,推荐)| **D: 自定义**(用户指定)--**内置图标 - 占位符方式(推荐)**:--```xml-<use data-icon="chart-bar" x="100" y="200" width="48" height="48" fill="#005587"/>-```--> 无需手动运行 `embed_icons.py`,`finalize_svg.py` 后处理工具会自动嵌入图标。--**常用图标**:`chart-bar` `arrow-trend-up` `users` `cog` `circle-checkmark` `target` `clock` `file` `dollar` `lightbulb`--完整索引:`templates/icons/README.md`-------## 5. 图片处理--根据设计规范「图片资源清单」中的状态处理:--| 状态 | 来源 | 处理方式 |-|---|---|---|-| **已有** | 用户提供 | 直接引用 `../images/` 目录中的图片 |-| **AI 生成** | Image_Generator 生成 | 图片已在 `../images/`,直接引用 |-| **占位符** | 暂未准备 | 使用虚线框占位 |--**引用**:`<image href="../images/xxx.png" ... preserveAspectRatio="xMidYMid slice"/>`--**占位符**:虚线框 `<rect stroke-dasharray="8,4" .../>` + 描述文本-------## 6. 字体使用--根据《设计规范与内容大纲》中的字体方案,为不同文本角色应用对应字体:--| 角色 | 中文推荐 | 英文推荐 |-|---|---|---|-| 标题字体 | 微软雅黑/楷体/黑体 | Arial/Georgia |-| 正文字体 | 微软雅黑/宋体 | Calibri/Times |-| 强调字体 | 黑体 | Arial Black/Consolas |-| 注释字体 | 微软雅黑/宋体 | Arial/Times |--详细参见 `docs/design_guidelines.md`。-------## 7. 演讲备注生成框架--### 任务 1. 生成完整演讲备注文稿--在**所有 SVG 页面生成完成并定稿后**,进入"逻辑构建阶段",在 `notes/total.md` 中生成完整的演讲备注文稿。--**为什么不一页一页生成?** 批量写备注能像写剧本一样规划转场语(Transition),确保演讲逻辑通顺。--**格式**:每页以 `# <序号>_<页面标题>` 开头,页间用 `---` 分隔。每页包含:讲稿正文(2-5 句)、`要点:①② ③`、`时长:X 分钟`。首页除外,每页正文以 `[过渡]` 转场语开头。--**基础控场标记**(所有风格通用):--| 标记 | 用途 |-|---|---|-| `[停顿]` | 关键内容后留白,让观众消化 |-| `[过渡]` | 段首单独成段,放在每页正文开头,承上启下 |--> 各风格可扩展额外标记(`[互动]`/`[数据]`/`[环视]`/`[对标]` 等),见 `executor-{style}.md`。--**要求**:--- 讲稿应口语化、自然流畅-- 突出页面核心信息和演讲要点-- 用户可在 `notes/` 目录手动编辑覆盖--### 任务 2. 拆分写入各页备注文件--将 `notes/total.md` 自动拆分,写入 `notes/` 目录下的演讲备注文件中。--**文件命名规范**:--- **推荐**:与 SVG 同名(如 `01_封面.svg` → `notes/01_封面.md`)-- **兼容**:也支持 `slide01.md` 格式(向后兼容)-------## 8. 完成后下一步--> **强制检查点**:进入后处理前必须输出确认——视觉构建阶段(SVG 页数)和逻辑构建阶段(备注页数)均已完成。未输出检查点禁止进入后处理。--**后处理与导出**(详见 [shared-standards.md](shared-standards.md)):--```bash-# 1. 拆分讲稿-python3 scripts/total_md_split.py <项目路径>--# 2. SVG 后处理(自动嵌入图标、图片等)-python3 scripts/finalize_svg.py <项目路径>--# 3. 导出 PPTX-python3 scripts/svg_to_pptx.py <项目路径> -s final-```-------# Executor General -- 创意通用风格--> 基础准则见 executor-base.md,技术约束见 shared-standards.md-------## 角色定位--创意型、通用风格的 SVG 设计执行师。适用于产品介绍、培训讲义、方案汇报、营销宣传等**非咨询类**场景。强调视觉表现力与信息趣味性,在专业与亲和之间取得平衡。-------## General 特有布局技巧--### 1. 灵活多变的版式--General 风格不拘泥于固定模板,可根据内容自由选择版式:--| 版式 | 适用场景 | 布局要点(1280x720) |-|------|----------|---------------------|-| 全图背景+文字叠加 | 封面、情感渲染页 | `<image>` 铺满画布 + 半透明遮罩 + 居中标题 |-| 左右分栏(图文混排) | 功能介绍、对比说明 | 左 x=40,w=580 / 右 x=660,w=580 |-| 三栏卡片 | 特性罗列、团队介绍 | x=40,450,860 各 w=380,等高卡片 |-| 上下分区 | 时间线、流程展示 | 上区标题+说明 h=250 / 下区图表+内容 h=420 |-| 中心辐射 | 核心概念、生态图 | 中心元素 + 4-6 个周围节点,连线指向中心 |-| 瀑布流/Z 字型 | 故事叙述、案例展示 | 内容块交替左右排列,引导视线 Z 字移动 |--### 2. 视觉节奏控制--- **信息密度交替**:高密度数据页之后接一页"呼吸页"(大图/金句/过渡),避免观众疲劳-- **视觉重量平衡**:深色/大面积元素为"重",浅色/小元素为"轻",左右/上下应均衡-- **重复与变化**:同一章节内保持版式一致性,不同章节间适当变化以维持新鲜感--### 3. 装饰元素运用--| 元素 | 用法 | 注意事项 |-|------|------|---------|-| 渐变色块 | 背景分区、标题底色 | 使用 `<linearGradient>` / `<radialGradient>`,限 2-3 色 |-| 圆角矩形卡片 | 内容容器、功能模块 | `rx="12"` 配合轻投影(用浅色 rect 模拟) |-| 图标点缀 | 列表项前缀、功能标识 | 使用 `data-icon` 占位符,大小 32-48px |-| 编号圆圈 | 步骤流程、排名列表 | `<circle>` + 居中 `<text>`,主题色填充 |-| 分隔线 | 内容分区 | `<line>` 或 `<rect height="2">`,opacity 0.2-0.3 |-------## 视觉策略--### 色彩运用--- **主题色大胆使用**:封面、章节页可大面积使用主题色背景-- **渐变增强层次**:标题栏、卡片背景可使用同色系渐变-- **对比创造焦点**:关键数字/词汇使用强调色,与周围内容形成反差-- **配色情绪匹配**:科技感用冷色调,活力感用暖色调,稳重感用深色调--### 图片处理策略--| 场景 | 策略 | SVG 实现 |-|------|------|---------|-| 全屏背景图 | 图片铺满 + 暗色渐变遮罩 | `preserveAspectRatio="xMidYMid slice"` + 渐变 rect |-| 竖图展示 | 左侧/右侧放置,保持原比例 | 控制宽度,高度自适应 |-| 多图拼接 | 网格排列,统一尺寸 | 等宽等高的 `<image>` 矩阵 |-| 人物照片 | 圆形裁切效果 | `<circle>` 背景 + 方形图片叠加(后处理裁剪) |--### 排版层次--```-标题层 → 28-36px,粗体,主题色或白色-副标题层 → 20-24px,中等粗细,次要色-正文层 → 16-18px,常规,深灰色-注释层 → 12-14px,浅灰色,底部对齐-```-------## 演讲备注风格--### 叙事基调--General 风格的演讲备注采用**口语化叙述**,像在和观众对话,而非宣读报告。语气自然、有节奏感,适当加入修辞手法。--### 控场标记--| 标记 | 用途 | 示例 |-|------|------|------|-| `[停顿]` | 关键展示后留白,让观众消化信息 | "这个数字意味着什么?[停顿] 意味着每 3 个用户中就有 1 个..." |-| `[互动]` | 提问或引导观众参与,激活注意力 | "[互动] 在座各位有多少人体验过这个功能?" |-| `[过渡]` | 段首承上启下,必须放在每页正文开头 | "[过渡] 了解了背景之后,我们来看看具体怎么做。" |--### 备注写作要点--- **讲故事**:用"场景-冲突-解决"结构组织每页叙事-- **用比喻**:将抽象概念具象化("这就像给系统装了一个涡轮增压器")-- **设悬念**:适时抛出问题,下一页给出答案-- **口语化数据**:30% -> "将近三分之一",2.5 倍 -> "翻了一番还多"-- **要点结构**:`要点:(1)核心信息 (2)支撑论据 (3)行动呼吁`--### 备注示例--```markdown-# 03_核心优势--[过渡] 说完了市场的现状,大家可能会问:那我们的机会在哪里?--我们的核心优势可以用三个词概括:快、准、省。-快——部署时间从 3 个月缩短到 2 周;[停顿]-准——识别准确率达到 97.3%,远超行业平均的 82%;-省——综合成本降低将近三分之一。--[互动] 如果你是决策者,这三个数字中哪个最打动你?--要点:(1)三大差异化优势 (2)量化数据支撑 (3)引导思考-时长:2 分钟-```-------## 自检补充(General 特有)--- [ ] 视觉节奏合理:信息密集页与呼吸页交替-- [ ] 装饰元素适度:服务于内容而非喧宾夺主-- [ ] 图文比例恰当:非纯文字堆砌,有视觉亮点-- [ ] 备注口语化:读出来像说话,而非念稿-------# Executor Consultant -- 咨询风格--> 基础准则见 executor-base.md,技术约束见 shared-standards.md-------## 角色定位--数据驱动的咨询风格 SVG 设计执行师。适用于商业分析报告、市场调研、运营复盘、战略建议等**一般咨询**场景。强调信息的结构化呈现与数据可视化,风格简洁、清晰、专业。-------## Consultant 特有的数据可视化技巧--### 1. KPI 仪表盘设计--KPI 卡片是咨询报告最常用的元素,标准布局(1280x720):--```-4 卡片布局:每卡 280x180,间距 30- 卡片 1: x=45, y=160- 卡片 2: x=355, y=160- 卡片 3: x=665, y=160- 卡片 4: x=975, y=160-```--**卡片内部结构**(自上而下):--| 区域 | 内容 | 字号 | 样式 |-|------|------|------|------|-| 图标行 | data-icon 图标 | 32x32 | 主题色 |-| 指标名 | "月活跃用户" | 14px | 灰色 #64748B |-| 核心数字 | "1.2M" | 36-42px | 粗体,深色 |-| 趋势标注 | "+12.3% vs 上月" | 12px | 绿色=增/红色=降 |--**趋势箭头规范**:-- 上升:`arrow-trend-up` 图标 + 绿色文字-- 下降:`arrow-trend-down` 图标 + 红色文字-- 持平:横线图标 + 灰色文字--### 2. 图表配色规范--咨询风格图表使用**同色系深浅渐变**,而非彩虹色:--```-主系列: 主题色 100% opacity-对比系列: 主题色 60% opacity-基准线: #94A3B8(灰色虚线)-高亮: 强调色(仅用于关键数据点)-```--### 3. 数据标注原则--- **数据标签直接标注**:柱状图顶部放数值,无需图例-- **趋势线加注释**:关键拐点处添加文字说明("政策调整"、"产品上线")-- **对比基准线**:行业均值/目标值用灰色虚线标注-- **单位统一**:同一图表中保持一致的数值单位和精度--### 4. 表格设计--咨询报告经常使用表格呈现精确数据:--| 设计要素 | 规范 |-|----------|------|-| 表头 | 深色背景 + 白色文字,font-weight="bold" |-| 斑马纹 | 奇偶行交替使用 `fill-opacity="0.05"` 的浅色底 |-| 数值对齐 | 数字右对齐,文本左对齐 |-| 高亮行 | 用强调色 `fill-opacity="0.1"` 标记重点行 |-| 边框 | 仅用水平线分隔行,避免完整网格线 |-------## 咨询专用布局模式--### MECE 分解图--主干居左,分支向右展开,互斥穷尽:--```-主指标 ──┬── 分支 A(占比 45%)- ├── 分支 B(占比 30%)- ├── 分支 C(占比 20%)- └── 分支 D(占比 5%)-```--- 使用 `<line>` 连接主干与分支-- 每个分支配 `<rect>` 容器 + 百分比标注-- 总和必须 = 100%(或明确标注"其他")--### 驱动因素树--顶层指标 -> 分解因素 -> 措施,适合业绩归因分析:--```-收入增长 15%- ├── 客单价 +8% → 高端产品线扩展- ├── 客户数 +5% → 新渠道获客- └── 复购率 +2% → 会员体系优化-```--### 左图右文(图表解读)--咨询报告核心版式:左侧放图表,右侧放关键解读:--```-图表区: x=40, y=120, w=700, h=480-解读区: x=780, y=120, w=460, h=480- - 核心结论(粗体,16px)- - 3-5 条 bullet points(14px)- - 数据来源(12px,灰色)-```-------## 专业表达规范--### 页面标题--咨询风格的页面标题应是**观点性标题**(Assertion Headline),而非描述性标题:--| 类型 | 描述性(避免) | 观点性(推荐) |-|------|---------------|---------------|-| 市场 | "市场概况" | "国内市场年增速 23%,显著领先全球均值" |-| 竞品 | "竞品分析" | "三大竞品在渠道覆盖上存在明显短板" |-| 财务 | "财务数据" | "毛利率连续四季度提升,突破行业天花板" |--### 数据源标注--每个含数据的页面底部必须标注来源:--```xml-<text x="40" y="700" font-size="10" fill="#94A3B8">- 来源:国家统计局 2025 年年报;团队内部分析-</text>-```--### 核心观点区--咨询风格内容页应在标题下方设置**核心观点区**(Takeaway Box):--```-位置: x=40, y=80, w=1200, h=50-背景: 浅色主题色底(fill-opacity="0.08")-文本: 14-16px,一句话总结本页核心观点-```-------## 演讲备注风格--### 叙事基调--Consultant 风格的演讲备注采用**结论驱动**的表达,先说结论再展开论据。语气专业、精炼、有说服力。--### 控场标记--| 标记 | 用途 | 示例 |-|------|------|------|-| `[停顿]` | 关键结论后留白,让听众消化 | "这意味着我们的市场份额正在被蚕食。[停顿]" |-| `[数据]` | 提示将数字口语化表达 | "[数据] 85% -> 超过八成客户反馈了这个问题" |-| `[过渡]` | 段首承上启下,必须放在每页正文开头 | "[过渡] 基于刚才的分析,我们来看具体建议。" |--### 备注写作要点--- **结论先行**:每页备注第一句即为核心观点-- **数据口语化**:30% -> "约三成",85% -> "超过八成",2.5x -> "两倍半"-- **论据紧跟**:结论后立即给出 2-3 个支撑数据/事实-- **专业措辞**:使用"洞察"、"驱动因素"、"核心抓手"等咨询术语-- **要点结构**:`要点:(1)核心结论 (2)支撑数据 (3)下一步建议`--### 备注示例--```markdown-# 03_关键发现--[过渡] 基于前面的市场扫描,我们提炼出三个关键发现。--第一,用户增长的主要驱动力正在从获客转向留存。-[数据] 新客获取成本同比上涨了将近四成,但复购率提升贡献了超过六成的收入增量。[停顿]--第二,下沉市场的增速显著高于一二线城市。-第三,25-35 岁女性用户群的 ARPU 值是整体均值的 1.8 倍。--要点:(1)增长引擎从获客转向留存 (2)下沉市场机会窗口 (3)高价值人群画像-时长:2 分钟-```-------## 自检补充(Consultant 特有)--- [ ] 数据与源数据一致,无编造-- [ ] 每个数据页底部有来源标注-- [ ] 页面标题是观点性而非描述性-- [ ] KPI 卡片有趋势箭头和对比标注-- [ ] 图表配色统一,使用同色系而非彩虹色-- [ ] 备注结论先行,数据口语化-------# Executor Consultant Top -- 顶级咨询风格 (MBB 级)--> 基础准则见 executor-base.md,技术约束见 shared-standards.md-------## 角色定位--MBB 级(McKinsey / Bain / BCG)顶级咨询风格的 SVG 设计执行师。适用于战略规划、董事会汇报、投融资路演、高管决策支持等**高端咨询**场景。核心特征:数据驱动洞察、金字塔结构叙事、极致简洁,输出面向 C-level 决策者。-------## SCQA 框架(叙事结构)--每份 MBB 级演示都遵循 SCQA 叙事结构:--| 元素 | 作用 | 典型页面 |-|------|------|---------|-| **S - Situation** | 设定共识背景 | 封面 / 第 1-2 页 |-| **C - Complication** | 引入问题/张力 | 第 2-3 页 |-| **Q - Question** | 隐含或明确的待解决问题 | 过渡页 |-| **A - Answer** | 核心解决方案 | 正文所有页 |--**页面编排**:封面体现 S+C -> Executive Summary 回答 Q -> 章节展开 A -> 结尾回扣 S--**标题写法**:--| SCQA 元素 | 弱标题 | MBB 级标题 |-|-----------|--------|-----------|-| S | "行业背景" | "数字化渗透率突破 60%,行业进入深水区" |-| C | "面临挑战" | "然而三大结构性矛盾制约了规模化落地" |-| Q | "战略问题" | "如何在 18 个月内实现从试点到全面部署?" |-| A | "解决方案" | "三步走路径:聚焦、扩展、规模化" |-------## 数据情境化(永不孤立呈现数据)--> **黄金法则**:永远不会孤立展示单一数据点。每个数字都需要上下文。--| 方法 | 模式 | 视觉实现 |-|------|------|---------|-| **时间对比** | "从 X 到 Y" | 折线图 + 箭头标注变化幅度 |-| **基准对标** | "X vs 行业均值 Y" | 柱状图中加灰色虚线基准线 |-| **竞品对比** | "我方 X vs 竞品 Y" | 并列柱状图,高亮自身数据 |-| **目标差距** | "实际 X / 目标 Y" | 进度条 + 差距标注 |-| **排名定位** | "位列第 N / 共 M" | 横向柱状图 + 高亮标记 |--**数据标注三要素**:每个数据可视化必须包含 (1)数值本身(大字号粗体) (2)对比参照(基准线/同期/竞品) (3)含义解读("So what?")--```xml-<text x="160" y="280" text-anchor="middle" font-size="42" font-weight="bold" fill="#1E293B">97.3%</text>-<text x="160" y="310" text-anchor="middle" font-size="13" fill="#64748B">行业均值 82% | 竞品 A 89%</text>-<text x="160" y="335" text-anchor="middle" font-size="12" fill="#059669">领先行业 15.3 个百分点</text>-```-------## 金字塔原则(结论先行)--> 高管不关心你的*过程*,只关心*结果*。--```- ┌─────────────┐- │ 核心结论 │ ← 页面标题 / Takeaway- └──────┬──────┘- ┌─────────┼─────────┐- ┌───┴───┐ ┌───┴───┐ ┌───┴───┐- │论据 1 │ │论据 2 │ │论据 3 │ ← 主要支撑点- └───────┘ └───────┘ └───────┘-```--| 层级 | 位置 | 字号 |-|------|------|------|-| 核心结论 | Takeaway Box | 16-18px 粗体 |-| 论据 | 内容区主体 | 14-16px |-| 支撑数据 | 图表/卡片 | 12-14px |--**对比**:标题"市场调研结果"(错) -> "元宇宙需要 5-10 年才能规模化"(对);正文"我们调研了...发现了..."(错) -> "三个论据:(1)... (2)... (3)..."(对)-------## MBB 级布局模式--### 内容页标准结构(1280x720)--```-┌──────────────────────────────────┐-│ 渐变顶条 (0,0 → 1280,6) │-├──────────────────────────────────┤-│ 观点性标题 (x=40, y=50, 24px) │-├──────────────────────────────────┤-│ Takeaway Box (x=40, y=75, │ ← 深色背景+白字,一句话结论-│ w=1200, h=45) │-├──────────────────────────────────┤-│ 内容区 (x=40, y=140, │ ← 图表/数据/分析-│ w=1200, h=520) │-├──────────────────────────────────┤-│ 来源 | CONFIDENTIAL | 页码 │ ← y=700, 10px-└──────────────────────────────────┘-```--### 战略路径图--三阶段横排,`<rect rx="8">` + 标题 + 举措列表,`<polygon>` 箭头连接:--```-聚焦核心(0-6月) ──> 扩展能力(6-12月) ──> 规模化(12-18月)-x=40,w=380 x=450,w=380 x=860,w=380-```--### 对标分析矩阵--横向表格,我方行主题色高亮,其他灰色。领先指标绿色标记,落后红色标记。用 `<circle>` 或 `<rect>` 构建评分点。--### 瀑布图(变化归因)--起点 -> 增减因素 -> 终点。正向因素绿色柱,负向红色柱,起止点深色柱,累计线虚线连接。-------## 颜色的战略性使用--MBB 级配色极度克制,颜色为信息服务:--| 用途 | 方法 |-|------|------|-| **聚焦** | 目标数据主题色,其他全灰 |-| **降低认知负荷** | 同系列同色深浅区分(`fill-opacity` 1.0/0.6/0.3) |-| **语义** | 绿=正向,红=负向,灰=基准 |-| **品牌** | 渐变顶条/装饰线用品牌色 |--**戒律**:主色调不超过 3 种;强调色全文仅 2-3 处;数据系列同色系深浅而非不同颜色;背景白色或极浅灰。-------## 图表 vs 表格选择矩阵--| 场景 | 推荐形式 | 原因 |-|------|---------|------|-| 比较 2-7 个类别 | **柱状图** | 视觉对比直观 |-| 时间趋势 | **折线图** | 时间序列清晰 |-| 精确数值/大量排名 | **表格** | 50 个点用柱状图会乱 |-| 占比构成 | **环形图** | 比饼图更现代 |-| 双维度定位 | **2x2 矩阵** | 战略象限分析 |-| 变化归因 | **瀑布图** | 因素拆解 |-------## 演讲备注风格--### 叙事基调--面向**高管/决策者**,金字塔结构,每句话都有信息量。语气沉稳、权威、有洞察力。--### 控场标记--| 标记 | 用途 | 示例 |-|------|------|------|-| `[停顿]` | 关键洞察后留白,让高管消化 | "这意味着我们正在错失千亿级市场。[停顿]" |-| `[环视]` | 观察决策者反应,判断是否展开 | "[环视] 各位如有疑问,我可以展开。" |-| `[数据]` | 数字口语化表达 | "[数据] 63% -> 将近三分之二" |-| `[对标]` | 强调对比基准 | "[对标] 相比行业均值 12%,我们 23% 几乎翻倍" |-| `[过渡]` | 段首承上启下,放在每页正文开头 | "[过渡] 承接战略框架,深入看实施路径。" |--### 备注写作要点--- **金字塔结构**:结论 -> 论据 -> 细节-- **数据情境化**:每个数字有对比参照-- **高管语言**:"战略意义在于..."、"核心洞察是..."-- **备选机制**:标注"时间紧张可略过的内容",支持弹性时长-- **要点结构**:`要点:(1)核心洞察 (2)数据支撑 (3)战略意义`--### 备注示例--```markdown-# 03_战略路径--[过渡] 明确了问题和机会之后,接下来是最关键的——我们的应对路径。--我们建议三步走策略。[停顿]--第一步,聚焦。未来六个月集中资源攻克华东市场。-[数据] 华东贡献了将近三分之二的行业增量,[对标] 但我们渗透率仅为竞品 A 的一半。[停顿]--第二步,扩展。以华东为样板,复制到华南和华北。-第三步,规模化。借助数字化平台实现全国覆盖。--[环视] 第一步的资源配置详见附录,需要现在展开吗?--要点:(1)聚焦-扩展-规模化三步走 (2)华东优先的数据支撑 (3)18 个月全面部署-时长:3 分钟-备选:[时间紧张可跳过二三步细节,直接到财务影响]-```-------## MBB 级质量检查补充--### 内容层面--- [ ] **SCQA 完整**:整体遵循情境-复杂性-问题-答案结构-- [ ] **数据情境化**:每个数据点有对比参照-- [ ] **结论先行**:每页 Takeaway Box 有一句话结论-- [ ] **MECE 原则**:分类分析互斥穷尽--### 视觉层面--- [ ] **颜色有意图**:配色服务于信息传达-- [ ] **留白充足**:不拥挤,让信息"呼吸"-- [ ] **视觉层次**:结论 > 论据 > 细节,字号/粗细区分-- [ ] **品牌一致**:渐变顶条、页脚全文统一--### 备注层面--- [ ] **金字塔结构**:每页结论先行-- [ ] **控场标记完整**:关键位置有 [停顿][环视]-- [ ] **备选内容标注**:支持弹性时长--------# Optimizer CRAP — 视觉优化角色--## 核心使命--严格遵循 CRAP 设计原则,分析并重构单页 SVG 代码,输出视觉更专业、结构更清晰的新版本。支持所有画布格式,根据原始 SVG 画布尺寸进行优化。--## 使用模式--| 模式 | 触发方式 | 说明 |-|------|----------|------|-| 独立使用 | 提供 SVG 文件/代码 | 对任意 SVG 进行视觉优化 |-| 流程中使用 | `generate-ppt` 后可选优化 | 优化 Executor 生成的 SVG |--> 流程中下一步:后处理 + 导出 PPTX--## 工作流程--1. 接收原始 SVG 代码-2. 识别画布格式(`width`、`height`、`viewBox`)-3. (可选)分析参考 SVG 了解总体风格-4. 按四大核心原则诊断和重构-5. 保持画布尺寸不变-6. 输出优化后 SVG,文件名前加 `yh_`-7. 输出优化报告-------## 四大核心设计原则--### 1. 对齐 (Alignment)--- **诊断**:检查是否存在随意放置的元素-- **优化**:严格对齐所有元素,创建强大的视觉连接线(左对齐、居中或右对齐),任何元素的位置都必须与其他元素存在明确的对齐关系-- **参考**:元素坐标偏差控制在 5px 以内--**常见技巧**:-- 将分散元素统一到同一条垂直或水平线上-- 使用一致的左/右边距-- 标题、正文、注释起始位置保持对齐--### 2. 对比 (Contrast)--- **诊断**:检查元素间是否有足够的视觉层次,重点信息是否突出-- **优化**:让不同元素**截然不同**,通过显著加大尺寸、字重或颜色差异突出最重要的信息-- **参考**:标题字号比正文大 1.3-2 倍--**常见技巧**:-- 放大关键数字或标题字号-- 用粗体突出重点词汇-- 用强调色标注核心信息-- 通过明暗对比区分前景与背景--### 3. 重复 (Repetition)--- **诊断**:检查同类元素的视觉风格是否统一-- **优化**:有意识地重复使用视觉元素(颜色、字体样式、圆角大小、线条粗细),创造组织性和统一性-- **参考**:同类元素保持风格一致--**常见技巧**:-- 统一所有卡片的圆角半径-- 统一同级标题的字号和颜色-- 重复使用相同的图标风格-- 保持一致的间距系统--### 4. 亲密性 (Proximity)--- **诊断**:检查逻辑相关的内容在空间上是否足够靠近-- **优化**:将关联项目在空间上靠近,组织成视觉单元;加大不同组块间的距离-- **参考**:相关元素靠近,不相关元素分开--**常见技巧**:-- 缩小标题与其下方内容的间距-- 加大不同章节之间的间距-- 将图表与标签组合成视觉单元-- 用分组线或背景色强化关联性-------## 可选补充原则--仅在用户明确要求时应用:--### 5. 留白 (White Space)--触发词:"增加留白"、"提升高级感"。增加元素间距,给设计留出呼吸空间。--### 6. 降噪 (Noise Reduction)--触发词:"简化设计"、"减少干扰"。移除冗余元素,简化复杂效果,聚焦核心信息。-------## 优化报告格式--```-## 优化报告--### 主要优化点-1. [对齐] 具体修改说明-2. [对比] 具体修改说明-3. [重复] 具体修改说明-4. [亲密性] 具体修改说明--### 优化效果-简要说明整体优化效果和视觉改进。-```--## 技术约束--- **保持画布尺寸**:优化后 SVG 的 `width`、`height`、`viewBox` 与原始一致-- **文本处理**:保持 `<tspan>` 换行-- **文件命名**:`yh_原文件名.svg`-- SVG 禁用功能与 PPT 兼容性规则见 shared-standards.md--------# Template Designer — 模板设计角色--## 核心使命--基于《设计规范与内容大纲》生成项目专属的页面模板,供用户确认后用于批量内容生成。--> 这是一个独立角色:仅通过 `/create-template` 工作流触发,不在 PPT 生成流程中使用。--## 使用方式--- **触发方式**:`/create-template` 工作流-- **输出位置**:`templates/layouts/<模板名称>/`-------## 核心模板清单--| 序号 | 文件名 | 用途 | 说明 |-|------|--------|------|------|-| 01 | `01_cover.svg` | 封面 | 固定结构:标题、副标题、日期、机构 |-| 02 | `02_chapter.svg` | 章节页 | 固定结构:章节编号、章节标题 |-| 03 | `03_content.svg` | 内容页 | 灵活结构:只定义页眉页脚,内容区由 AI 自由布局 |-| 04 | `04_ending.svg` | 结束页 | 固定结构:感谢语、联系方式 |-| -- | `02_toc.svg` | 目录页 | 可选:目录标题、章节列表(编号+标题) |--**设计理念**:模板定义视觉一致性和结构性页面,内容页保持最大灵活性。--**命名说明**:目录页保持 `02_toc.svg` 命名以兼容模板库与排序规则。--### 可选扩展页(按需)--- 过渡页 / 小节页(如 `05_section_break.svg`)-- 附录页(如 `06_appendix.svg`)-- 免责声明 / 保密页(如 `07_disclaimer.svg`)-------## 模板设计规范--### 1. 必须生成 design_spec.md--创建全局模板时,必须生成 `design_spec.md`,包含:--```markdown-# [模板名称] - 设计规范--## 一、模板概述(名称、适用场景、设计调性)-## 二、画布规范(16:9, 1280x720, viewBox)-## 三、配色方案(主色、辅助色、强调色 HEX 值)-## 四、排版体系(字体栈、字号层级)-## 五、页面结构(通用布局、装饰设计)-## 六、页面类型(4 种核心页面)-## 七、布局模式(推荐)-## 八、间距规范-## 九、SVG 技术约束-## 十、占位符规范-```--### 2. 继承设计规范--模板必须严格遵循《设计规范与内容大纲》中的:-- **画布尺寸**:viewBox 与设计规范一致-- **配色方案**:使用规范中的主导色、辅助色、强调色-- **字体方案**:使用规范中的字体预设-- **布局原则**:边距、间距符合规范--### 3. 占位符标记--使用明确的占位符标记可替换内容:--```xml-<!-- 文本占位符 -->-<text x="80" y="320" fill="#FFFFFF" font-size="48" font-weight="bold">- {{TITLE}}-</text>--<!-- 内容区占位符(内容页专用) -->-<rect x="40" y="90" width="1200" height="550" fill="#FFFFFF" rx="8"/>-<text x="640" y="365" text-anchor="middle" fill="#CBD5E1" font-size="16">- {{CONTENT_AREA}}-</text>-```--### 4. 占位符规范--| 占位符 | 用途 | 适用模板 |-|--------|------|----------|-| `{{TITLE}}` | 主标题 | 封面 |-| `{{SUBTITLE}}` | 副标题 | 封面 |-| `{{DATE}}` | 日期 | 封面 |-| `{{AUTHOR}}` | 作者/机构 | 封面 |-| `{{TOC_TITLE}}` | 目录标题 | 目录页 |-| `{{TOC_ITEMS}}` | 目录项列表 | 目录页 |-| `{{CHAPTER_NUM}}` | 章节编号 | 章节页 |-| `{{CHAPTER_TITLE}}` | 章节标题 | 章节页 |-| `{{CHAPTER_DESC}}` | 章节描述 | 章节页 |-| `{{PAGE_TITLE}}` | 页面标题 | 内容页 |-| `{{KEY_MESSAGE}}` | 核心观点 | 内容页(咨询风格) |-| `{{CONTENT_AREA}}` | 内容区域 | 内容页 |-| `{{SECTION_NAME}}` | 章节名称 | 内容页页脚 |-| `{{SOURCE}}` | 数据来源 | 内容页页脚 |-| `{{PAGE_NUM}}` | 页码 | 内容页、结束页 |-| `{{THANK_YOU}}` | 感谢语 | 结束页 |-| `{{TAGLINE}}` | 口号 | 结束页 |-| `{{CONTACT_INFO}}` | 联系信息 | 结束页 |-| `{{COPYRIGHT}}` | 版权 | 结束页 |-------## 输出要求--### 文件保存位置--```-templates/layouts/<模板名称>/-├── design_spec.md # 设计规范(必须)-├── 01_cover.svg-├── 02_chapter.svg-├── 02_toc.svg # 可选-├── 03_content.svg-├── 04_ending.svg-└── *.png / *.jpg # 图片资源(如有)-```--### 模板预览--每个模板生成后,提供简要说明表格,列出各模板状态。-------## 使用预置模板库(可选)--如已有适合的模板资源,可直接使用而非生成新模板:--1. **复制模板**:将模板文件复制到项目 `templates/` 目录-2. **调整配色**:根据项目设计规范修改颜色-3. **自定义修改**:根据项目特点个性化调整--**示例库结构**(查询 `templates/layouts/layouts_index.json`):--```-templates/layouts/-├── general/ # 通用灵活风格-├── consultant/ # 咨询风格-└── consultant_top/ # 顶级咨询风格(MBB级)-```-------## 阶段完成检查点--```markdown-## Template_Designer 阶段完成--- [x] 已阅读 `roles/Template_Designer.md`-- [x] 已生成 4 个核心页面模板-- [ ] 目录页模板(可选)-- [ ] 可选扩展页(如需)-- [x] 所有模板已保存到 `templates/` 目录-- [x] 模板遵循设计规范(配色、字体、布局)-- [x] 占位符标记清晰规范-- [ ] **下一步**: 请用户确认模板-```--------# 图片布局规范(强制执行)--含图片页面的布局规则。Strategist 规划阶段、Executor 生成阶段都必须遵循。--**核心原则:根据图片原始比例计算布局,确保图片完整展示,杜绝留白或裁切。**-------## 布局决策流程--```-1. 获取图片原始尺寸 → 计算比例 (宽/高)-2. 根据比例选择布局类型-3. 计算图片最大展示尺寸-4. 分配剩余空间给文字区域-5. 将结果填入《设计规范与内容大纲》的图片资源清单-```--**执行时机**:若图片方案包含「B) 用户提供」,在 Strategist 阶段完成八项确认后、进入内容分析与大纲编制之前,必须运行扫描并填充图片资源清单。-------## 布局类型选择(强制)--| 图片比例 | 布局类型 | 图片位置 | 说明 |-|----------|----------|----------|------|-| > 2.0 (超宽) | 上下分栏 | 上方通栏 | 图片占画布宽度,高度按比例 |-| 1.5-2.0 (宽幅) | 上下分栏 | 上方 | 图片宽度=内容区宽度,高度按比例 |-| 1.2-1.5 (标准) | 左右分栏 | 左侧 | 图片高度优先适配,宽度按比例 |-| 0.8-1.2 (方形) | 左右分栏 | 左侧 | 图片取内容区高度,宽度按比例 |-| < 0.8 (竖图) | 左右分栏 | 左侧 | 图片高度=内容区高度,宽度按比例 |--> 边界情况:比例处于边界值时(如 1.5),根据文字量判断。文字多选左右,文字少选上下。-------## 尺寸计算公式--### PPT 16:9 (1280x720) 画布参数--```-画布: 1280 x 720 px-内容区: 1160 x 640 px (左右边距 60px, 上下边距 40px)-标题区高度: 60 px-内容起点: y = 80 px (标题 + 间距)-```--### 上下布局计算--```-图片宽度 = W = 1160 px-图片高度 = W / R = 1160 / R px-文字区高度 = H - 图片高度 - 间距(20px)--验证:文字区高度 >= 150px (至少 3-4 行文字)-若不满足 → 改用左右布局-```--### 左右布局计算--**方式 1(高度优先,适用于竖图)**:-```-图片高度 = H = 600 px-图片宽度 = H x R = 600 x R px-文字区宽度 = W - 图片宽度 - 间距(20px)-```--**方式 2(宽度受限,适用于宽图转左右)**:-```-图片宽度 = W x 0.7 = 812 px-图片高度 = 图片宽度 / R-文字区宽度 = W - 图片宽度 - 间距(20px)-```--**验证**:文字区宽度 >= 280px,否则需减小图片区宽度。-------## 布局示例--### 超宽图 (比例 2.45)--```-原图: 1960x800, R=2.45 → 上下分栏-图片: 1160x473, 文字区: 1160x147 → 上下 7:3-```--### 标准横图 (比例 1.38)--```-原图: 1614x1171, R=1.38 → 左右分栏-图片: 773x560 (左侧), 文字区: 367x560 (右侧) → 左右 7:3-```--### 宽幅图边界情况 (比例 1.75)--```-原图: 1820x1040, R=1.75-尝试上下: 图片高度=663, 文字区=-43 ❌-改用左右: 图片 780x446 (左侧), 文字区 360x600 (右侧) → 左右 7:3-```-------## 禁止事项--| 禁止 | 正确做法 |+| 格式 | viewBox ||------|---------|-| 固定使用 50:50 或任意比例 | 根据图片比例动态计算 |-| 将宽图塞入方形容器 | 使用上下布局或加大图片区宽度 |-| 将竖图放入横向窄条 | 使用左右布局,图片在左 |-| 图片留白超过 10% | 重新计算布局或选择其他方案 |-| 裁切图片关键内容 | 使用 `preserveAspectRatio="xMidYMid meet"` |-| 文字区太小无法阅读 | 确保文字区 >= 150px(上下)或 >= 280px(左右) |-------## SVG 图片嵌入代码--### 完整展示(推荐用于数据图表)--```xml-<image href="../images/xxx.png"- x="60" y="80" width="780" height="446"- preserveAspectRatio="xMidYMid meet"/>-```--### 裁切填充(仅用于背景图)--```xml-<image href="../images/bg.png"- x="0" y="0" width="1280" height="720"- preserveAspectRatio="xMidYMid slice"/>-```-------## 图片资源清单模板--在《设计规范与内容大纲》中,图片资源清单必须包含:--| 字段 | 说明 | 示例 |-|------|------|------|-| 文件名 | 图片文件名 | `p12_0.png` |-| 原始尺寸 | 宽x高 | 1524x968 |-| 比例 | 宽/高 | 1.57 |-| 页码 | 使用页码 | 第5页 |-| 类型 | 视觉类型 | 背景图/实景照片/插画配图/图表架构/装饰图案 |-| 布局方案 | 上下/左右 + 分栏比 | 上下 6:4 或 左右 7:3 |-| 图片区域 | 图片展示尺寸 | 1160x420 或 780x446 |-| 文字区域 | 剩余空间尺寸 | 1160x200 或 360x600 |--**类型字段用于 Image_Generator 选择合适的提示词策略。**-------## 自动化工具--```bash-python3 scripts/analyze_images.py <项目路径>/images-```--输出包含尺寸、比例、布局建议(Markdown 表格),可直接用于填写图片资源清单。-------## 角色职责--| 角色 | 职责 |-|------|------|-| **Strategist** | 运行 analyze_images.py,按本规范计算布局,填写图片资源清单 |-| **Executor** | 严格按图片资源清单中的布局方案和尺寸生成 SVG |--------# SVG 图片嵌入指南--在 SVG 文件中添加图片的技术规范和推荐工作流。-------## 图片资源清单格式--在《设计规范与内容大纲》中定义,每张图片标注状态。若图片方案包含「B) 用户提供」,需在 Strategist 阶段完成八项确认后立即运行 `analyze_images.py`,并在输出设计规范前完成清单填充。--```markdown-| 文件名 | 尺寸 | 用途 | 状态 | 生成描述 |-|--------|------|------|------|----------|-| cover_bg.png | 1280x720 | 封面背景 | 待生成 | 现代科技感抽象背景,深蓝渐变 |-| product.png | 600x400 | 第3页 | 已有 | - |-| team.png | 600x400 | 第5页 | 占位符 | 团队协作场景(后期补充) |-```--### 三种状态的处理--| 状态 | 含义 | Executor 处理方式 |-|------|------|-------------------|-| **待生成** | 需 AI 生成,有描述 | 先生成图片放入 `images/`,再用 `<image>` 引用 |-| **已有** | 用户已有图片 | 放入 `images/`,用 `<image>` 引用 |-| **占位符** | 暂不处理 | 用虚线框占位,后期替换 |-------## 工作流程--```-1. Strategist 定义图片需求 → 添加图片资源清单,标注每张状态-2. 图片准备(待生成/已有)→ 放入 项目/images/-3. Executor 生成 SVG(svg_output/)- ├── 已有/待生成 → <image href="../images/xxx.png" .../>- └── 占位符 → 虚线框 + 描述文本-4. 预览:python3 -m http.server -d <项目路径> 8000 → /svg_output/<文件名>.svg-5. 后处理与导出- ├── python3 scripts/finalize_svg.py <项目路径>- └── python3 scripts/svg_to_pptx.py <项目路径> -s final-```--> 推荐:生成阶段在 `svg_output/` 保留外部引用,后处理通过 `finalize_svg.py` 自动嵌入图片到 `svg_final/`,再从 `svg_final/` 导出 PPTX。-------## 外部引用 vs Base64 内嵌--| 方式 | 优点 | 缺点 | 适用场景 |-|------|------|------|----------|-| **外部引用** | 文件小、迭代快、便于替换 | 预览需从项目根起 HTTP 服务 | `svg_output/` 开发阶段 |-| **Base64 内嵌** | 文件独立、导出稳定 | 文件体积大 | `svg_final/` 交付阶段 |-------## 方式一:外部引用(生成阶段推荐)--### 语法--```xml-<image href="../images/image.png" x="0" y="0" width="1280" height="720"- preserveAspectRatio="xMidYMid slice"/>-```--### 关键属性--| 属性 | 说明 | 示例 |-|------|------|------|-| `href` | 图片路径(相对或绝对) | `"../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 -d <项目路径> 8000-# 访问 http://localhost:8000/svg_output/your_file.svg-```-------## 方式二:Base64 内嵌(交付阶段推荐)--### 语法--```xml-<image href="data:image/png;base64,iVBORw0KGgo..." x="0" y="0" width="1280" height="720"/>-```--### MIME 类型--| MIME 类型 | 文件格式 |-|-----------|----------|-| `image/png` | PNG |-| `image/jpeg` | JPG/JPEG |-| `image/gif` | GIF |-| `image/webp` | WebP |-| `image/svg+xml` | SVG |-------## 转换流程--### 推荐:统一走 finalize_svg.py--```bash-python3 scripts/finalize_svg.py <项目路径> # 图标、图片、文本、圆角一次处理-python3 scripts/svg_to_pptx.py <项目路径> -s final # 从最终版本导出 PPTX-```--### 独立使用 embed_images.py(高级用法)--仅处理特定 SVG 而不跑完整后处理时:--```bash-python3 scripts/embed_images.py <svg文件> # 单个-python3 scripts/embed_images.py <项目路径>/svg_output/*.svg # 批量-python3 scripts/embed_images.py --dry-run <项目路径>/svg_output/*.svg # 预览-```-------## 最佳实践--### 图片优化--嵌入前压缩图片以减少文件体积:--```bash-convert input.png -quality 85 -resize 1920x1080\> output.png # ImageMagick-pngquant --quality=65-80 input.png -o output.png # pngquant(推荐)-```--### 文件组织--```-project/-├── images/ # 图片资源-├── sources/ # 源文件及其附带图片-│ └── article_files/-├── svg_output/ # 原始版本(外部引用)-└── svg_final/ # 最终版本(已嵌入图片)-```--### 圆角处理(禁止 clipPath)--由于 `clipPath` 在 PPT 中不兼容,禁止使用裁剪路径为图片加圆角。替代方案:-- 生成图片时直接处理圆角(导出为带圆角的 PNG)-- 或用同尺寸圆角矩形覆盖边缘(视觉模拟)-------## 常见问题--**Q: 直接打开 SVG 看不到图片?**-浏览器安全策略阻止跨目录请求。从项目根目录启动 HTTP 服务器,或先运行 `finalize_svg.py` 再查看 `svg_final/`。--**Q: Base64 文件太大?**-压缩原始图片、使用 JPEG 格式、降低分辨率(匹配实际显示尺寸即可)。--**Q: 如何反向提取 Base64 图片?**-```bash-base64 -d image.b64 > image.png-```+| PPT 16:9 | `0 0 1280 720` |+| PPT 4:3 | `0 0 1024 768` |+| 小红书 | `0 0 1242 1660` |+| 朋友圈 | `0 0 1080 1080` |+| Story | `0 0 1080 1920` |++## 后处理注意事项++- **禁止**用 `cp` 命令替代 `finalize_svg.py`+- **禁止**从 `svg_output/` 直接导出,必须从 `svg_final/`(`-s final`)导出+- 后处理三步命令不要添加 `--only` 等额外参数+- **禁止**将后处理三步写在同一个代码块或同一次 shell 调用中执行diff --git a/CLAUDE.md b/CLAUDE.mdindex b7cf1265..f24b8ec5 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -1,9 +1,6 @@-<!-- AUTO-GENERATED by build_adapters.py — DO NOT EDIT MANUALLY -->-<!-- Source: skills/ppt-master/ | Generated: 2026-03-20 -->-# CLAUDE.md-本文件为 Claude Code 提供项目概览。完整规则见 `skills/ppt-master/` 或 `AGENTS.md`。+本文件为 Claude Code 提供项目概览。仓库的核心能力集中在 `skills/ppt-master/`。## 项目概述@@ -13,7 +10,7 @@ PPT Master 是一个 AI 驱动的多格式 SVG 内容生成系统。通过多角**Skill 模式**:如已安装 skill,使用 `/ppt` 命令进入交互式流程。-**完整工作流和规则手册**:执行 PPT 生成任务前,必须阅读 [AGENTS.md](./AGENTS.md)。+**完整工作流和规则手册**:执行 PPT 生成任务前,优先阅读 [AGENTS.md](./AGENTS.md) 与 `skills/ppt-master/SKILL.md`。## 常用命令@@ -46,7 +43,6 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s final- `skills/ppt-master/scripts/` — 28个工具脚本- `skills/ppt-master/templates/` — 布局模板、图表模板、640+ 矢量图标- `examples/` — 示例项目-- `build_adapters.py` — 多平台适配文件生成器## SVG 技术约束(不可协商)diff --git a/GEMINI.md b/GEMINI.mddeleted file mode 100644index 0cf7549e..00000000--- a/GEMINI.md+++ /dev/null@@ -1,8 +0,0 @@-<!-- AUTO-GENERATED by build_adapters.py — DO NOT EDIT MANUALLY -->-<!-- Source: skills/ppt-master/ | Generated: 2026-03-20 -->--# GEMINI.md--> **本文件内容与 [AGENTS.md](./AGENTS.md) 保持同步,请以 AGENTS.md 为准。**--请阅读 [AGENTS.md](./AGENTS.md) 获取完整的 AI 代理协作指引。diff --git a/README.md b/README.mdindex 298bde46..d30b5481 100644--- a/README.md+++ b/README.md@@ -101,7 +101,7 @@ AI:好的,先确认是否使用模板;确认后我会继续八项确认并> 💡 **生图能力集成**:建议配置 Google AI 的环境变量(`GEMINI_API_KEY`,如需代理可添加 `GEMINI_BASE_URL`),以便借助本项目的 `skills/ppt-master/scripts/nano_banana_gen.py` 在 AI 客户端中集成 nano banana 2 的强大生图能力。若使用 Antigravity 代理,调用时请注意需传入模型参数(`-m gemini-3.1-flash-image`)。-> 💡 **AI 迷失上下文?** 可提示 AI 参考 `AGENTS.md` 文件,它会自动按照仓库中的角色定义工作+> 💡 **AI 迷失上下文?** 可提示 AI 优先阅读 `skills/ppt-master/SKILL.md`;如需一个仓库级入口概览,再参考 `AGENTS.md`> 💡 **AI 生成图片建议**:如需 AI 生成配图,建议在 [Gemini](https://gemini.google.com/) 中生成后选择 **Download full size** 下载,分辨率比 Antigravity 直接生成的更高。Gemini 生成的图片右下角会有星星水印,可使用 [gemini-watermark-remover](https://github.com/journey-ad/gemini-watermark-remover) 或本项目的 `skills/ppt-master/scripts/gemini_watermark_remover.py` 去除。@@ -137,7 +137,7 @@ AI:好的,先确认是否使用模板;确认后我会继续八项确认并如有优化:重新运行后处理与导出```-> 📖 详细工作流程请参阅 [AGENTS.md](./AGENTS.md)(完整工作流指南)+> 📖 详细工作流程请优先参阅 [skills/ppt-master/SKILL.md](./skills/ppt-master/SKILL.md),仓库级入口概览见 [AGENTS.md](./AGENTS.md)> 💡 **PPT 编辑提示**:导出的 PPTX 中每页为 SVG 格式。选中页面内容,右键选择 **"转换为形状"** (Convert to Shape) 即可自由编辑所有元素。需要 **Office 2016** 或更高版本。@@ -147,7 +147,8 @@ AI:好的,先确认是否使用模板;确认后我会继续八项确认并| 文档 | 说明 ||------|------|-| 📖 [AGENTS.md](./AGENTS.md) | 完整工作流指南(适用于所有 AI 工具) |+| 🧭 [AGENTS.md](./AGENTS.md) | 仓库级入口概览(适用于通用 AI 代理) |+| 📖 [SKILL.md](./skills/ppt-master/SKILL.md) | `ppt-master` 核心流程与规则源 || 🎨 [设计指南](./skills/ppt-master/references/design-guidelines.md) | 配色、排版、布局规范详解 || 📐 [画布格式](./skills/ppt-master/references/canvas-formats.md) | PPT、小红书、朋友圈等 10+ 种格式 || 🖼️ [图片嵌入指南](./skills/ppt-master/references/svg-image-embedding.md) | SVG 图片嵌入最佳实践 |@@ -174,8 +175,6 @@ python3 skills/ppt-master/scripts/total_md_split.py <项目路径>python3 skills/ppt-master/scripts/finalize_svg.py <项目路径>python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s final-# 重新生成平台适配文件-python3 build_adapters.py```> 📖 完整工具说明请参阅 [脚本使用指南](./skills/ppt-master/scripts/README.md)@@ -191,21 +190,15 @@ ppt-master/│ ├── references/ # AI 角色定义 + 技术文档(13 个文件)│ ├── scripts/ # 工具脚本(24 个)│ └── templates/ # 模板库(布局 + 图表 + 640+ 图标)-├── build_adapters.py # 一键生成各 AI 工具的适配文件├── examples/ # 示例项目(15 个完整案例)├── projects/ # 用户项目工作区-│-│ ── 以下由 build_adapters.py 自动生成 ──-├── AGENTS.md # 通用完整指南(适用于任何 AI 工具)-├── CLAUDE.md # Claude Code 项目指南-├── GEMINI.md # Gemini 指南+├── AGENTS.md # 通用 AI 代理入口概览+├── CLAUDE.md # Claude Code 入口概览├── .claude/skills/ppt-master/ # Claude Code Skill 适配├── .cursor/rules/ # Cursor 适配└── .windsurf/rules/ # Windsurf 适配```-> 💡 **单一源多平台**:所有 AI 指令的规范源在 `skills/ppt-master/`,修改后运行 `python3 build_adapters.py` 即可同步到所有平台适配文件。----## ❓ 常见问题@@ -233,7 +226,7 @@ ppt-master/</details>-> 📖 更多问题请查看 [AGENTS.md](./AGENTS.md)+> 📖 更多问题可先查看 [skills/ppt-master/SKILL.md](./skills/ppt-master/SKILL.md) 与 [AGENTS.md](./AGENTS.md)---diff --git a/README_EN.md b/README_EN.mdindex daa157d9..278650f4 100644--- a/README_EN.md+++ b/README_EN.md@@ -100,11 +100,11 @@ AI: Sure. First we'll confirm whether to use a template; after that Strategist w> 💡 **Model Recommendation**: Opus 4.6 works best. However, due to the current instability of Opus on some IDEs (like Antigravity), using other stable AI clients is recommended.-> 💡 **Image Generation Integration**: Configure Google AI environment variables (`GEMINI_API_KEY`, optionally `GEMINI_BASE_URL` for proxy) to integrate nano banana 2 image generation via `tools/nano_banana_gen.py`. If using the Antigravity proxy, pass the model parameter (`-m gemini-3.1-flash-image`).+> 💡 **Image Generation Integration**: Configure Google AI environment variables (`GEMINI_API_KEY`, optionally `GEMINI_BASE_URL` for proxy) to integrate nano banana 2 image generation via `skills/ppt-master/scripts/nano_banana_gen.py`. If using the Antigravity proxy, pass the model parameter (`-m gemini-3.1-flash-image`).-> 💡 **AI Lost Context?** Prompt the AI to refer to `AGENTS.md` — it will automatically follow the role definitions in the repository.+> 💡 **AI Lost Context?** Ask the AI to read `skills/ppt-master/SKILL.md` first; use `AGENTS.md` as the repository-level entry overview.-> 💡 **AI Image Generation Tip**: For AI-generated images, we recommend generating them in [Gemini](https://gemini.google.com/) and selecting **Download full size** for higher resolution. Gemini images have a star watermark in the bottom right corner, which can be removed using [gemini-watermark-remover](https://github.com/journey-ad/gemini-watermark-remover) or this project's `tools/gemini_watermark_remover.py`.+> 💡 **AI Image Generation Tip**: For AI-generated images, we recommend generating them in [Gemini](https://gemini.google.com/) and selecting **Download full size** for higher resolution. Gemini images have a star watermark in the bottom right corner, which can be removed using [gemini-watermark-remover](https://github.com/journey-ad/gemini-watermark-remover) or this project's `skills/ppt-master/scripts/gemini_watermark_remover.py`.---@@ -138,7 +138,7 @@ Output: Editable PPTX (auto-embeds speaker notes)If optimized: re-run post-processing and export```-> 📖 For detailed workflow, see [Workflow Tutorial](./docs/workflow_tutorial.md) and [Role Definitions](./roles/README.md)+> 📖 For the full workflow, start with [SKILL.md](./skills/ppt-master/SKILL.md). For a repository-level overview, see [AGENTS.md](./AGENTS.md).> 💡 **PPT Editing Tip**: Each page in the exported PPTX is in SVG format. Select the page content in PowerPoint, right-click and choose **"Convert to Shape"** to freely edit all elements. Requires **Office 2016** or later.@@ -148,14 +148,14 @@ If optimized: re-run post-processing and export| Document | Description ||----------|-------------|-| 📖 [Workflow Tutorial](./docs/workflow_tutorial.md) | Detailed workflow and case demonstrations |-| 🎨 [Design Guidelines](./docs/design_guidelines.md) | Colors, typography, layout specifications |-| 📐 [Canvas Formats](./docs/canvas_formats.md) | PPT, Xiaohongshu (RED), WeChat Moments, and 10+ formats |-| 🖼️ [Image Embedding Guide](./docs/svg_image_embedding.md) | SVG image embedding best practices |-| 📊 [Chart Template Library](./templates/charts/) | 33 standardized chart templates · [Index Guide](./templates/charts/README.md) |-| ⚡ [Quick Reference](./docs/quick_reference.md) | Common commands and parameters cheat sheet |-| 🔧 [Role Definitions](./roles/README.md) | Complete definitions of 7 AI roles |-| 🛠️ [Toolset](./tools/README.md) | Usage instructions for all tools |+| 🧭 [AGENTS.md](./AGENTS.md) | Repository-level entry overview for general AI agents |+| 📖 [SKILL.md](./skills/ppt-master/SKILL.md) | Canonical `ppt-master` workflow and rules |+| 🎨 [Design Guidelines](./skills/ppt-master/references/design-guidelines.md) | Colors, typography, and layout specifications |+| 📐 [Canvas Formats](./skills/ppt-master/references/canvas-formats.md) | PPT, Xiaohongshu (RED), WeChat Moments, and 10+ formats |+| 🖼️ [Image Embedding Guide](./skills/ppt-master/references/svg-image-embedding.md) | SVG image embedding best practices |+| 📊 [Chart Template Library](./skills/ppt-master/templates/charts/) | Standardized chart templates |+| 🔧 [Role Definitions](./skills/ppt-master/references/) | Role definitions and technical references |+| 🛠️ [Toolset](./skills/ppt-master/scripts/README.md) | Usage instructions for all tools || 💼 [Examples Index](./examples/README.md) | 15 projects, 229 SVG pages of examples |---@@ -164,39 +164,39 @@ If optimized: re-run post-processing and export```bash# Initialize project-python3 tools/project_manager.py init <project_name> --format ppt169+python3 skills/ppt-master/scripts/project_manager.py init <project_name> --format ppt169# Archive source materials into the project folder-python3 tools/project_manager.py import-sources <project_path> <source_file_or_url...>+python3 skills/ppt-master/scripts/project_manager.py import-sources <project_path> <source_file_or_url...># Note: files outside the workspace are copied by default; files already in the workspace are moved into sources/# PDF to Markdown-python3 tools/pdf_to_md.py <PDF_file>+python3 skills/ppt-master/scripts/pdf_to_md.py <PDF_file>-# Post-process SVG-python3 tools/finalize_svg.py <project_path>--# Export PPTX-python3 tools/svg_to_pptx.py <project_path> -s final+# Post-processing (run in order)+python3 skills/ppt-master/scripts/total_md_split.py <project_path>+python3 skills/ppt-master/scripts/finalize_svg.py <project_path>+python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final```-> 📖 For complete tool documentation, see [Tools Usage Guide](./tools/README.md)+> 📖 For complete tool documentation, see [Tools Usage Guide](./skills/ppt-master/scripts/README.md)---## 📁 Project Structure-```+```textppt-master/-├── .agent/ # AI workflows and helper configs-├── .github/ # CI / GitHub Actions-├── roles/ # AI role definitions (7 roles including Template_Designer)-├── docs/ # Documentation center (tutorials, design guides, format specs)-├── templates/ # Template library (33 chart templates + 640+ icons + layouts)-├── tools/ # Toolset (project management, conversion, processing)-├── examples/ # Example projects (15 complete cases)-└── projects/ # User project workspace+├── skills/+│ └── ppt-master/ # Main skill source+│ ├── SKILL.md+│ ├── workflows/ # Workflow entry files+│ ├── references/ # Role definitions and specs+│ ├── scripts/ # Tool scripts+│ └── templates/ # Layouts, charts, icons+├── examples/ # Example projects+└── projects/ # User project workspace```---@@ -226,7 +226,7 @@ No. Only use it when you need to optimize the visual effects of key pages.</details>-> 📖 For more questions, see [Workflow Tutorial](./docs/workflow_tutorial.md#faq)+> 📖 For more questions, see [SKILL.md](./skills/ppt-master/SKILL.md) and [AGENTS.md](./AGENTS.md)---diff --git a/build_adapters.py b/build_adapters.pydeleted file mode 100644index 04ba8a94..00000000--- a/build_adapters.py+++ /dev/null@@ -1,453 +0,0 @@-#!/usr/bin/env python3-"""-PPT Master — 多平台适配文件生成器--从规范源 skills/ppt-master/ 生成各 AI 工具的适配文件。--用法:- python3 build_adapters.py # 生成所有适配- python3 build_adapters.py claude # 只生成 Claude Code- python3 build_adapters.py cursor # 只生成 Cursor- python3 build_adapters.py windsurf # 只生成 Windsurf- python3 build_adapters.py agents # 只生成 AGENTS.md- python3 build_adapters.py gemini # 只生成 GEMINI.md- python3 build_adapters.py agent-sdk # 只生成 .agent/ 工作流-"""--import os-import sys-import shutil-from pathlib import Path-from datetime import datetime--# 项目根目录-ROOT = Path(__file__).parent-SKILL_DIR = ROOT / "skills" / "ppt-master"-REFS_DIR = SKILL_DIR / "references"--GENERATED_HEADER = (- "<!-- AUTO-GENERATED by build_adapters.py — DO NOT EDIT MANUALLY -->\n"- f"<!-- Source: skills/ppt-master/ | Generated: {datetime.now().strftime('%Y-%m-%d')} -->\n\n"-)---def read_file(path: Path) -> str:- """读取文件内容"""- return path.read_text(encoding="utf-8")---def write_file(path: Path, content: str):- """写入文件,自动创建目录"""- path.parent.mkdir(parents=True, exist_ok=True)- path.write_text(content, encoding="utf-8")- print(f" [OK] {path.relative_to(ROOT)}")---def read_skill_md() -> str:- """读取 SKILL.md"""- return read_file(SKILL_DIR / "SKILL.md")---def read_all_references() -> dict[str, str]:- """读取所有 reference 文件,返回 {文件名: 内容}"""- refs = {}- for f in sorted(REFS_DIR.glob("*.md")):- refs[f.name] = read_file(f)- return refs---def adapt_paths_for_root(content: str) -> str:- """将 skill 内部路径适配为仓库根目录视角"""- replacements = {- "${SKILL_DIR}/scripts/": "skills/ppt-master/scripts/",- "${SKILL_DIR}/templates/": "skills/ppt-master/templates/",- "${SKILL_DIR}/": "skills/ppt-master/",- "references/": "skills/ppt-master/references/",- }- for old, new in replacements.items():- content = content.replace(old, new)- return content---def adapt_paths_for_claude(content: str) -> str:- """将 skill 内部路径适配为 .claude/skills/ 视角"""- # Claude Code 的 skill 路径是相对于 .claude/skills/ppt-master/- # 脚本和模板在 skills/ppt-master/ 下,需要用 ../../../skills/ppt-master/- replacements = {- "${SKILL_DIR}/scripts/": "../../../skills/ppt-master/scripts/",- "${SKILL_DIR}/templates/": "../../../skills/ppt-master/templates/",- "${SKILL_DIR}/": "../../../skills/ppt-master/",- }- for old, new in replacements.items():- content = content.replace(old, new)- return content---# ============================================================-# 适配器:Claude Code-# ============================================================-def build_claude():- """生成 .claude/skills/ppt-master/"""- print("\n[Claude Code] 生成 .claude/skills/ppt-master/")- out_dir = ROOT / ".claude" / "skills" / "ppt-master"-- # 复制 SKILL.md(路径适配)- skill_content = read_skill_md()- skill_content = adapt_paths_for_claude(skill_content)- write_file(out_dir / "SKILL.md", GENERATED_HEADER + skill_content)-- # 复制 references/- refs_out = out_dir / "references"- for f in sorted(REFS_DIR.glob("*.md")):- content = read_file(f)- write_file(refs_out / f.name, content)---# ============================================================-# 适配器:Cursor-# ============================================================-def build_cursor():- """生成 .cursor/rules/ppt-master.md — 合并为单文件"""- print("\n[Cursor] 生成 .cursor/rules/ppt-master.md")- refs = read_all_references()-- parts = [GENERATED_HEADER]- parts.append("# PPT Master — AI 驱动的 SVG 内容生成系统\n\n")- parts.append("> 本文件由 `build_adapters.py` 从 `skills/ppt-master/` 自动生成。\n\n")-- # SKILL.md 的核心流程部分- skill = read_skill_md()- skill = adapt_paths_for_root(skill)- # 去掉 YAML frontmatter- if skill.startswith("---"):- end = skill.find("---", 3)- if end != -1:- skill = skill[end + 3:].strip()- parts.append(skill)- parts.append("\n\n---\n\n")-- # 按顺序合并 references- ref_order = [- "shared-standards.md",- "canvas-formats.md",- "design-guidelines.md",- "strategist.md",- "image-generator.md",- "executor-base.md",- "executor-general.md",- "executor-consultant.md",- "executor-consultant-top.md",- "optimizer-crap.md",- "template-designer.md",- "image-layout-spec.md",- "svg-image-embedding.md",- ]-- for name in ref_order:- if name in refs:- content = refs[name]- content = adapt_paths_for_root(content)- # 去掉引用其他 reference 的行(在合并文件中不需要)- lines = content.split("\n")- lines = [l for l in lines if not l.startswith("> 📎")]- content = "\n".join(lines)- parts.append(f"\n---\n\n")- parts.append(content)-- write_file(ROOT / ".cursor" / "rules" / "ppt-master.md", "".join(parts))---# ============================================================-# 适配器:Windsurf-# ============================================================-def build_windsurf():- """生成 .windsurf/rules/ppt-master.md — 与 Cursor 格式类似"""- print("\n[Windsurf] 生成 .windsurf/rules/ppt-master.md")- # Windsurf 格式与 Cursor 基本相同- refs = read_all_references()-- parts = [GENERATED_HEADER]- parts.append("# PPT Master — AI 驱动的 SVG 内容生成系统\n\n")- parts.append("> 本文件由 `build_adapters.py` 从 `skills/ppt-master/` 自动生成。\n\n")-- skill = read_skill_md()- skill = adapt_paths_for_root(skill)- if skill.startswith("---"):- end = skill.find("---", 3)- if end != -1:- skill = skill[end + 3:].strip()- parts.append(skill)- parts.append("\n\n---\n\n")-- ref_order = [- "shared-standards.md",- "canvas-formats.md",- "design-guidelines.md",- "strategist.md",- "image-generator.md",- "executor-base.md",- "executor-general.md",- "executor-consultant.md",- "executor-consultant-top.md",- "optimizer-crap.md",- "template-designer.md",- "image-layout-spec.md",- "svg-image-embedding.md",- ]-- for name in ref_order:- if name in refs:- content = refs[name]- content = adapt_paths_for_root(content)- lines = content.split("\n")- lines = [l for l in lines if not l.startswith("> 📎")]- content = "\n".join(lines)- parts.append(f"\n---\n\n")- parts.append(content)-- write_file(ROOT / ".windsurf" / "rules" / "ppt-master.md", "".join(parts))---# ============================================================-# 适配器:AGENTS.md(通用单文件)-# ============================================================-def build_agents():- """生成 AGENTS.md — 通用单文件完整指南"""- print("\n[AGENTS.md] 生成通用单文件指南")- refs = read_all_references()-- parts = [GENERATED_HEADER]- parts.append("# AGENTS.md — PPT Master 完整指南\n\n")- parts.append("> ⚠️ **AI 代理注意**:本文件是 PPT 生成流程的完整指南。\n")- parts.append("> 本文件由 `build_adapters.py` 从 `skills/ppt-master/` 自动生成,请勿手动编辑。\n\n")-- # 工作流部分(从 SKILL.md 提取,路径适配)- skill = read_skill_md()- skill = adapt_paths_for_root(skill)- # 去掉 frontmatter- if skill.startswith("---"):- end = skill.find("---", 3)- if end != -1:- skill = skill[end + 3:].strip()- parts.append(skill)- parts.append("\n\n---\n\n")- parts.append("# 详细参考\n\n")- parts.append("以下内容为各角色和技术规范的详细说明。\n\n")-- # 合并 references- ref_order = [- ("shared-standards.md", "公共技术约束"),- ("canvas-formats.md", "画布格式规范"),- ("design-guidelines.md", "设计指南"),- ("strategist.md", "Strategist 角色定义"),- ("image-generator.md", "Image_Generator 角色定义"),- ("executor-base.md", "Executor 公共准则"),- ("executor-general.md", "Executor — General 风格"),- ("executor-consultant.md", "Executor — Consultant 风格"),- ("executor-consultant-top.md", "Executor — Consultant_Top 风格"),- ("optimizer-crap.md", "Optimizer_CRAP 角色定义"),- ("template-designer.md", "Template_Designer 角色定义"),- ("image-layout-spec.md", "图片布局规范"),- ("svg-image-embedding.md", "SVG 图片嵌入技术"),- ]-- for name, title in ref_order:- if name in refs:- content = refs[name]- content = adapt_paths_for_root(content)- # 去掉引用行- lines = content.split("\n")- lines = [l for l in lines if not l.startswith("> 📎")]- content = "\n".join(lines)- parts.append(f"\n---\n\n")- parts.append(content)-- write_file(ROOT / "AGENTS.md", "".join(parts))---# ============================================================-# 适配器:CLAUDE.md-# ============================================================-def build_claude_md():- """生成 CLAUDE.md — Claude Code 项目指南(精简版)"""- print("\n[CLAUDE.md] 生成 Claude Code 项目指南")-- content = GENERATED_HEADER + """# CLAUDE.md--本文件为 Claude Code 提供项目概览。完整规则见 `skills/ppt-master/` 或 `AGENTS.md`。--## 项目概述--PPT Master 是一个 AI 驱动的多格式 SVG 内容生成系统。通过多角色协作(Strategist → Image_Generator → Executor → Optimizer),将源文档(PDF/URL/Markdown)转化为高质量 SVG 页面,并导出为 PPTX。--**核心流程**:`源文档 → 创建项目 → 模板选项 → Strategist八项确认 → [Image_Generator] → Executor → 后处理 → 导出PPTX`--**Skill 模式**:如已安装 skill,使用 `/ppt` 命令进入交互式流程。--**完整工作流和规则手册**:执行 PPT 生成任务前,必须阅读 [AGENTS.md](./AGENTS.md)。--## 常用命令--```bash-# 源内容转换-python3 skills/ppt-master/scripts/pdf_to_md.py <PDF文件>-python3 skills/ppt-master/scripts/web_to_md.py <URL>-node skills/ppt-master/scripts/web_to_md.cjs <URL>--# 项目管理-python3 skills/ppt-master/scripts/project_manager.py init <项目名> --format ppt169-python3 skills/ppt-master/scripts/project_manager.py validate <项目路径>--# 图片工具-python3 skills/ppt-master/scripts/analyze_images.py <项目路径>/images-python3 skills/ppt-master/scripts/nano_banana_gen.py "提示词" --aspect_ratio 16:9 --image_size 4K -o <项目路径>/images--# SVG 质量检查-python3 skills/ppt-master/scripts/svg_quality_checker.py <项目路径>--# 后处理三步(必须按顺序执行)-python3 skills/ppt-master/scripts/total_md_split.py <项目路径>-python3 skills/ppt-master/scripts/finalize_svg.py <项目路径>-python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s final-```--## 架构--- `skills/ppt-master/references/` — AI 角色定义和技术规范-- `skills/ppt-master/scripts/` — 28个工具脚本-- `skills/ppt-master/templates/` — 布局模板、图表模板、640+ 矢量图标-- `examples/` — 示例项目-- `build_adapters.py` — 多平台适配文件生成器--## SVG 技术约束(不可协商)--**禁用功能**:`clipPath` | `mask` | `<style>` | `class/id` | 外部 CSS | `<foreignObject>` | `textPath` | `@font-face` | `<animate*>` | `<script>` | `marker-end` | `<iframe>` | `<symbol>+<use>`--**PPT 兼容性替代**:--| 禁止 | 替代 |-|------|------|-| `rgba()` | `fill-opacity` / `stroke-opacity` |-| `<g opacity>` | 每个子元素单独设置 opacity |-| `<image opacity>` | 遮罩层叠加 |-| `marker-end` 箭头 | `<polygon>` 三角形 |--## 画布格式速查--| 格式 | viewBox |-|------|---------|-| PPT 16:9 | `0 0 1280 720` |-| PPT 4:3 | `0 0 1024 768` |-| 小红书 | `0 0 1242 1660` |-| 朋友圈 | `0 0 1080 1080` |-| Story | `0 0 1080 1920` |--## 后处理注意事项--- **禁止**用 `cp` 命令替代 `finalize_svg.py`-- **禁止**从 `svg_output/` 直接导出,必须从 `svg_final/`(`-s final`)导出-- 后处理三步命令不要添加 `--only` 等额外参数-"""-- write_file(ROOT / "CLAUDE.md", content)---# ============================================================-# 适配器:GEMINI.md-# ============================================================-def build_gemini():- """生成 GEMINI.md"""- print("\n[GEMINI.md] 生成 Gemini 指南")- content = GENERATED_HEADER + """# GEMINI.md--> **本文件内容与 [AGENTS.md](./AGENTS.md) 保持同步,请以 AGENTS.md 为准。**--请阅读 [AGENTS.md](./AGENTS.md) 获取完整的 AI 代理协作指引。-"""- write_file(ROOT / "GEMINI.md", content)---# ============================================================-# 适配器:Agent SDK-# ============================================================-def build_agent_sdk():- """生成 .agent/workflows/"""- print("\n[Agent SDK] 生成 .agent/workflows/")-- # generate-ppt.md- content = GENERATED_HEADER + """----description: 从 Markdown 源文档生成 PPT 的完整流程(主入口)------# PPT 生成工作流--> 本文件由 `build_adapters.py` 自动生成。--**完整流程**请参阅 [AGENTS.md](../../AGENTS.md),该文件包含完整的工作流程和规则手册。--**快速跳转**:-- [工作流程](../../AGENTS.md#工作流) — 从源文档到 PPT 的完整执行步骤-- [详细参考](../../AGENTS.md#详细参考) — 各角色定义和技术规范-"""- write_file(ROOT / ".agent" / "workflows" / "generate-ppt.md", content)-- # create-template.md — 保留已有内容但更新路径- template_workflow = ROOT / ".agent" / "workflows" / "create-template.md"- if template_workflow.exists():- content = read_file(template_workflow)- # 更新角色引用路径- content = content.replace(- "../roles/Template_Designer.md",- "../../skills/ppt-master/references/template-designer.md"- )- content = content.replace(- 'templates/layouts/',- 'skills/ppt-master/templates/layouts/'- )- write_file(template_workflow, content)---# ============================================================-# 主入口-# ============================================================-ADAPTERS = {- "claude": build_claude,- "cursor": build_cursor,- "windsurf": build_windsurf,- "agents": build_agents,- "claude-md": build_claude_md,- "gemini": build_gemini,- "agent-sdk": build_agent_sdk,-}---def build_all():- """生成所有适配文件"""- print(f"PPT Master — 多平台适配文件生成器")- print(f"规范源: {SKILL_DIR.relative_to(ROOT)}/")- print(f"生成时间: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")-- for name, builder in ADAPTERS.items():- builder()-- print(f"\n[DONE] 全部完成!共生成 {len(ADAPTERS)} 个适配。")---def main():- if len(sys.argv) < 2:- build_all()- else:- target = sys.argv[1].lower()- if target == "all":- build_all()- elif target in ADAPTERS:- ADAPTERS[target]()- print(f"\n[DONE] {target} 适配生成完成。")- else:- print(f"未知目标: {target}")- print(f"可用目标: {', '.join(ADAPTERS.keys())}, all")- sys.exit(1)---if __name__ == "__main__":- main()diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.mdindex 5744df65..4b9419e3 100644--- a/skills/ppt-master/SKILL.md+++ b/skills/ppt-master/SKILL.md@@ -13,7 +13,18 @@ description: >**核心流程**:`源文档 → 创建项目 → 模板选项 → Strategist → [Image_Generator] → Executor → 后处理 → 导出`-## 脚本目录+> [!CAUTION]+> ## 🚨 全局执行纪律(MANDATORY)+>+> **本工作流为严格串行流程。以下规则具有最高优先级,违反任何一条即为执行失败:**+>+> 1. **SERIAL EXECUTION** — 步骤必须按顺序执行,前一步的产出是后一步的输入。非 BLOCKING 的相邻步骤在前置条件满足时可以连续执行,无需等待用户说"继续"+> 2. **BLOCKING = HARD STOP** — 标记为 ⛔ BLOCKING 的步骤,必须停下来等待用户明确回复后才能继续,AI 不得代替用户做出任何决定+> 3. **NO CROSS-PHASE BUNDLING** — 禁止跨阶段打包执行。(注:但当用户确认八项原则后,可连续自动生成设计规范、生成大纲、生成 SVG、生成备注以及进入后处理流程,只要前置条件就绪即可无缝衔接,无需等待用户确认即可推进)+> 4. **GATE BEFORE ENTRY** — 每个 Step 开头标注了前置条件(🚧 GATE),必须先验证前置条件满足后才能开始该 Step+> 5. **NO SPECULATIVE EXECUTION** — 禁止"预先准备"后续 Step 的内容(如在 Strategist 阶段就开始写 SVG 代码)++## 主流程脚本| 脚本 | 用途 ||------|------|@@ -28,32 +39,30 @@ description: >| `${SKILL_DIR}/scripts/finalize_svg.py` | SVG 后处理(统一入口) || `${SKILL_DIR}/scripts/svg_to_pptx.py` | 导出 PPTX |-## 模板与资源+完整工具说明见 `${SKILL_DIR}/scripts/README.md`。-| 资源 | 路径 |-|------|------|-| 页面布局模板 | `${SKILL_DIR}/templates/layouts/` |-| 图表 SVG 模板 | `${SKILL_DIR}/templates/charts/` |-| 矢量图标库 (640+) | `${SKILL_DIR}/templates/icons/` |-| 模板索引 | `${SKILL_DIR}/templates/layouts/layouts_index.json` |-| 设计规范参考 | `${SKILL_DIR}/templates/design_spec_reference.md` |+## 模板索引------## 工作流+| 索引 | 路径 | 用途 |+|------|------|------|+| 布局模板索引 | `${SKILL_DIR}/templates/layouts/layouts_index.json` | 查询可用页面布局模板 |+| 图表模板索引 | `${SKILL_DIR}/templates/charts/charts_index.json` | 查询可用图表 SVG 模板 |+| 图标库索引 | `${SKILL_DIR}/templates/icons/icons_index.json` | 查询可用图标名称与分类 |-### Step 0: 偏好加载 ⛔ BLOCKING+## 独立工作流-检查用户偏好配置:-1. 项目级: `.ppt-master/EXTEND.md`-2. 用户级: `$HOME/.ppt-master/EXTEND.md`--如果存在,读取并应用偏好(默认风格、默认格式等)。+| 工作流 | 路径 | 用途 |+|--------|------|------|+| `create-template` | `workflows/create-template.md` | 独立模板创建流程 |---+## 工作流+### Step 1: 源内容处理+🚧 **GATE**:用户已提供源材料(PDF / URL / Markdown 文件 / 文本描述 / 对话内容等任意形式均可)。+当用户提供非 Markdown 内容时,必须立即转换:| 用户提供 | 命令 |@@ -63,52 +72,81 @@ description: >| 微信/高防站 | `node ${SKILL_DIR}/scripts/web_to_md.cjs <URL>` || Markdown | 直接读取 |+**✅ 检查点 — 确认源内容已就绪,继续 Step 2。**+---### Step 2: 项目初始化+🚧 **GATE**:Step 1 已完成,源内容已就绪(Markdown 文件、用户提供的文本、或对话中的需求描述均可)。+```bashpython3 ${SKILL_DIR}/scripts/project_manager.py init <项目名> --format <格式>```格式选项:`ppt169`(默认)、`ppt43`、`xhs`、`story` 等。完整格式列表见 `references/canvas-formats.md`。-如需导入源文件:-```bash-python3 ${SKILL_DIR}/scripts/project_manager.py import-sources <项目路径> <源文件...>-```+导入源内容(根据实际情况选择):++| 情况 | 操作 |+|------|------|+| 有源文件(PDF/MD等) | `python3 ${SKILL_DIR}/scripts/project_manager.py import-sources <项目路径> <源文件...> --move` |+| 用户在对话中直接提供文本 | 无需导入,内容已在对话上下文中,后续步骤直接引用即可 |++> ⚠️ **必须使用 `--move`**:所有源文件(原始 PDF / MD / 图片等)必须**移动**(而非复制)到 `sources/` 中归档。+> - Step 1 转换生成的 Markdown 文件、原始 PDF、原始 MD,**全部**通过 `import-sources --move` 移入项目+> - 转换中间产物(如 `_files/` 目录)由 `import-sources` 自动处理+> - 执行后,源文件在原始位置不再存在++**✅ 检查点 — 确认项目结构已创建成功、`sources/` 中包含所有源文件、源转换物已就绪,继续 Step 3。**---### Step 3: 模板选择-向用户确认(二选一):+🚧 **GATE**:Step 2 已完成,项目目录结构已就绪。-**A) 使用已有模板**-1. 查询 `${SKILL_DIR}/templates/layouts/layouts_index.json` 确认可用模板-2. 复制模板文件到项目目录:- ```bash- cp ${SKILL_DIR}/templates/layouts/<模板名>/*.svg <项目路径>/templates/- cp ${SKILL_DIR}/templates/layouts/<模板名>/design_spec.md <项目路径>/templates/- cp ${SKILL_DIR}/templates/layouts/<模板名>/*.png <项目路径>/images/ 2>/dev/null || true- cp ${SKILL_DIR}/templates/layouts/<模板名>/*.jpg <项目路径>/images/ 2>/dev/null || true- ```+⛔ **BLOCKING**:如果用户尚未明确表达是否使用模板,则必须向用户展示选项并**等待用户明确回复**后才能继续。若用户在此前已经明确表示过“不使用模板”或指定了具体模板,则可跳过此询问直接执行结论。++查询 `${SKILL_DIR}/templates/layouts/layouts_index.json`,列出可用模板及其风格描述。+**向用户展示选项时,必须结合当前的 PPT 主题和内容,给出你的专业建议(建议使用某个具体模板,或建议不使用模板而是自由设计,并说明原因)**,然后再询问用户:++> 💡 **AI 建议**:根据您的内容主题(简述),我建议您选择 **[某一具体模板 / 自由设计]**,因为...+>+> 请问您希望使用哪种方式?+> **A) 使用已有模板**(请告知模板名称或风格偏好)+> **B) 不使用模板**,自由设计-**B) 不使用模板** → 自由设计+用户确认选 A 后,复制模板文件到项目目录:+```bash+cp ${SKILL_DIR}/templates/layouts/<模板名>/*.svg <项目路径>/templates/+cp ${SKILL_DIR}/templates/layouts/<模板名>/design_spec.md <项目路径>/templates/+cp ${SKILL_DIR}/templates/layouts/<模板名>/*.png <项目路径>/images/ 2>/dev/null || true+cp ${SKILL_DIR}/templates/layouts/<模板名>/*.jpg <项目路径>/images/ 2>/dev/null || true+```++用户确认选 B 后,直接进入 Step 4。> 如需创建新模板,Read `references/template-designer.md`+**✅ 检查点 — 用户已回复模板选择,模板文件已复制(若选 A),继续 Step 4。**+---### Step 4: Strategist 阶段(必须,不可跳过)-⛔ **BLOCKING**: 先读取角色定义:+🚧 **GATE**:Step 3 已完成,用户已确认模板选择。++先读取角色定义:```Read references/strategist.mdRead references/shared-standards.md```-**必须完成八项确认**:+**必须完成八项确认**(参考 `templates/design_spec_reference.md` 模板内容):++⛔ **BLOCKING**:八项确认必须以**打包问题的方式向用户呈现建议,等待用户回复确认或修改**后,才能输出《设计规范与内容大纲》。这是流程中仅有的两个核心确认点之一(另一个是模板选择)。一旦确认,后续所有脚本执行与幻灯片生成均应全自动连贯执行。+1. 画布格式2. 页数范围3. 目标受众@@ -125,21 +163,23 @@ python3 ${SKILL_DIR}/scripts/analyze_images.py <项目路径>/images**输出**:`<项目路径>/设计规范与内容大纲.md`-**检查点**:+**✅ 检查点 — 本阶段产出完毕,自动进入下一步**:```markdown## ✅ Strategist 阶段完成-- [x] 已完成八项确认+- [x] 已完成八项确认(用户已回复确认)- [x] 已生成《设计规范与内容大纲》-- [ ] **下一步**: [Image_Generator / Executor]+- [ ] **下一步**: 自动进入 [Image_Generator / Executor] 环节```---### Step 5: Image_Generator 阶段(条件触发)-> **触发条件**:图片方式包含「AI 生成」+🚧 **GATE**:Step 4 已完成,《设计规范与内容大纲》已生成且用户已确认。++> **触发条件**:图片方式包含「AI 生成」。若不触发,直接跳到 Step 6(但仍需满足 Step 6 的 GATE)。-⛔ **BLOCKING**: Read `references/image-generator.md`+Read `references/image-generator.md`1. 从设计规范中提取所有「状态=待生成」的图片2. 生成提示词文档 → `<项目路径>/images/image_prompts.md`@@ -148,7 +188,7 @@ python3 ${SKILL_DIR}/scripts/analyze_images.py <项目路径>/imagespython3 ${SKILL_DIR}/scripts/nano_banana_gen.py "提示词" --aspect_ratio 16:9 --image_size 1K -o <项目路径>/images```-**检查点**:+**✅ 检查点 — 确认所有图片已就绪,继续 Step 6**:```markdown## ✅ Image_Generator 阶段完成- [x] 提示词文档已创建@@ -159,7 +199,9 @@ python3 ${SKILL_DIR}/scripts/analyze_images.py <项目路径>/images### Step 6: Executor 阶段-⛔ **BLOCKING**: 根据风格选择读取角色定义:+🚧 **GATE**:Step 4(及 Step 5,如触发)已完成,所有前置产出已就绪。++根据风格选择读取角色定义:```Read references/executor-base.md # 必读:公共准则Read references/executor-general.md # 通用灵活风格@@ -175,7 +217,7 @@ Read references/executor-consultant-top.md # 顶级咨询风格(MBB级)**逻辑构建阶段**:- 生成演讲备注 → `<项目路径>/notes/total.md`-**检查点**:+**✅ 检查点 — 确认所有 SVG 和 notes 已完整生成。直接进入 Step 7 后处理命令**:```markdown## ✅ Executor 阶段完成- [x] 所有 SVG 已生成到 svg_output/@@ -186,31 +228,41 @@ Read references/executor-consultant-top.md # 顶级咨询风格(MBB级)### Step 7: 后处理与导出-> ⚠️ 必须按顺序执行,不可省略或替换!+🚧 **GATE**:Step 6 已完成,所有 SVG 已生成到 `svg_output/`,演讲备注 `notes/total.md` 已生成。+> ⚠️ 以下三个子步骤必须**逐条单独执行**,每条命令执行完毕并确认成功后,才能执行下一条。+> ❌ **禁止**将三条命令写在同一个代码块或同一次 shell 调用中一次性执行。++**Step 7.1** — 拆分演讲备注:```bash-# 1. 拆分演讲备注python3 ${SKILL_DIR}/scripts/total_md_split.py <项目路径>+```-# 2. SVG 后处理(图标嵌入/图片裁剪嵌入/文本扁平化/圆角转Path)+**Step 7.2** — SVG 后处理(图标嵌入/图片裁剪嵌入/文本扁平化/圆角转 Path):+```bashpython3 ${SKILL_DIR}/scripts/finalize_svg.py <项目路径>+```-# 3. 导出 PPTX(默认嵌入演讲备注)+**Step 7.3** — 导出 PPTX(默认嵌入演讲备注):+```bashpython3 ${SKILL_DIR}/scripts/svg_to_pptx.py <项目路径> -s final```> ❌ **禁止**用 `cp` 替代 `finalize_svg.py`,该工具执行多项关键处理> ❌ **禁止**从 `svg_output/` 直接导出,必须用 `-s final` 从 `svg_final/` 导出+> ❌ **禁止**添加 `--only` 等额外参数---### Step 8: Optimizer 阶段(可选)+🚧 **GATE**:Step 7 已完成。+> **触发条件**:用户要求优化,或设计质量需要提升Read `references/optimizer-crap.md`-优化后需重新执行 Step 7(后处理与导出)。+优化后需**从 Step 7.1 开始重新执行**全部后处理子步骤(7.1 → 7.2 → 7.3),不可跳过。---diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex faaa5a71..38272284 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -147,7 +147,7 @@## 8. 完成后下一步-> **强制检查点**:进入后处理前必须输出确认——视觉构建阶段(SVG 页数)和逻辑构建阶段(备注页数)均已完成。未输出检查点禁止进入后处理。+> **自动衔接**:视觉构建阶段(SVG 页数)和逻辑构建阶段(备注页数)完成后,Executor 会直接开始执行后处理流程。**后处理与导出**(详见 [shared-standards.md](shared-standards.md)):diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex 2065ac63..f62b8fe2 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -16,7 +16,9 @@## 1. 八项确认流程-在开始分析前,依次确认以下问题并提供专业建议。+⛔ **BLOCKING**:在开始分析前,参考 `templates/design_spec_reference.md` 并对以下八项给出专业建议,然后**打包呈现给用户,等待用户明确回复**(确认或修改)。++> 💡 **执行纪律**:这是本流程中除了模板选择外的最后一个 BLOCKING 环节。一旦用户回复确认,AI 必须自动完成《设计规范与内容大纲》的撰写,并无缝进入后续图片生成(若有)、SVG 生成及后处理流程,禁止在中间产生额外的询问或停顿。### a. 画布格式确认diff --git a/skills/ppt-master/scripts/project_manager.py b/skills/ppt-master/scripts/project_manager.pyindex 0746f465..bba98b17 100644--- a/skills/ppt-master/scripts/project_manager.py+++ b/skills/ppt-master/scripts/project_manager.py@@ -39,9 +39,9 @@ except ImportError:validate_svg_viewbox,)--REPO_ROOT = Path(__file__).resolve().parent.parentTOOLS_DIR = Path(__file__).resolve().parent+SKILL_DIR = TOOLS_DIR.parent+REPO_ROOT = SKILL_DIR.parent.parentSOURCE_DIRNAME = "sources"TEXT_SOURCE_SUFFIXES = {".md", ".markdown", ".txt"}PDF_SUFFIXES = {".pdf"}diff --git a/.agent/workflows/create-template.md b/skills/ppt-master/workflows/create-template.mdsimilarity index 71%rename from .agent/workflows/create-template.mdrename to skills/ppt-master/workflows/create-template.mdindex f4de392a..edb3a9b8 100644--- a/.agent/workflows/create-template.md+++ b/skills/ppt-master/workflows/create-template.md@@ -4,7 +4,7 @@ description: 根据已有项目文件或参考模板生成一份新的 PPT 布# 创建新模板 Workflow-> 📖 **调用角色**:[Template_Designer](../../skills/ppt-master/references/template-designer.md)+> 📖 **调用角色**:[Template_Designer](../references/template-designer.md)为**全局模板库**生成一套完整的 PPT 布局模板。@@ -30,7 +30,6 @@ description: 根据已有项目文件或参考模板生成一份新的 PPT 布**如有参考来源**,先分析其结构:-// turbo```bashls -la "<参考来源路径>"```@@ -39,12 +38,11 @@ ls -la "<参考来源路径>"## 步骤 2:创建模板目录-// turbo```bash-mkdir -p "skills/ppt-master/skills/ppt-master/templates/layouts/<新模板名称>"+mkdir -p "skills/ppt-master/templates/layouts/<新模板名称>"```-> ⚠️ **输出位置**:全局模板输出到 `skills/ppt-master/skills/ppt-master/templates/layouts/`,项目模板输出到 `projects/<项目>/templates/`+> ⚠️ **输出位置**:全局模板输出到 `skills/ppt-master/templates/layouts/`,项目模板输出到 `projects/<项目>/templates/`---@@ -54,17 +52,16 @@ mkdir -p "skills/ppt-master/skills/ppt-master/templates/layouts/<新模板名称1. **design_spec.md** — 设计规范文档2. **4 个核心模板** — 封面、章节、内容、结束页-3. **目录页(可选)** — 02_toc.svg+3. **目录页(可选)** — `02_toc.svg`-> 📖 **角色详情**:参见 [Template_Designer.md](../../skills/ppt-master/references/template-designer.md)+> 📖 **角色详情**:参见 [template-designer.md](../references/template-designer.md)---## 步骤 4:验证模板完整性-// turbo```bash-ls -la "skills/ppt-master/skills/ppt-master/templates/layouts/<新模板名称>"+ls -la "skills/ppt-master/templates/layouts/<新模板名称>"```**检查清单**:@@ -82,7 +79,7 @@ ls -la "skills/ppt-master/skills/ppt-master/templates/layouts/<新模板名称>"## ✅ 模板创建完成**模板名称**: <新模板名称>(<中文名称>)-**模板路径**: `skills/ppt-master/skills/ppt-master/templates/layouts/<新模板名称>/`+**模板路径**: `skills/ppt-master/templates/layouts/<新模板名称>/`### 包含文件@@ -111,8 +108,8 @@ ls -la "skills/ppt-master/skills/ppt-master/templates/layouts/<新模板名称>"## 注意事项-1. **SVG 技术约束**:参见 [Template_Designer.md](../../skills/ppt-master/references/template-designer.md) 技术约束章节+1. **SVG 技术约束**:参见 [template-designer.md](../references/template-designer.md) 技术约束章节2. **配色一致性**:所有 SVG 文件使用相同配色3. **占位符规范**:使用 `{{}}` 格式-> 📖 **详细规范**:参见 [Template_Designer.md](../../skills/ppt-master/references/template-designer.md)+> 📖 **详细规范**:参见 [template-designer.md](../references/template-designer.md)