Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

refactor: 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.yml
deleted file mode 100644
index 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@v4
diff --git a/.windsurf/rules/ppt-master.md b/.windsurf/rules/ppt-master.md
deleted file mode 100644
index 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.md
index 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.md
index 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.md
deleted file mode 100644
index 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.md
index 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.md
index 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
-```
+```text
ppt-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.py
deleted file mode 100644
index 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.md
index 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 文件、用户提供的文本、或对话中的需求描述均可)。
+
```bash
python3 ${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.md
Read 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 <项目路径>/images
python3 ${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):
+```bash
python3 ${SKILL_DIR}/scripts/finalize_svg.py <项目路径>
+```
-# 3. 导出 PPTX(默认嵌入演讲备注)
+**Step 7.3** — 导出 PPTX(默认嵌入演讲备注):
+```bash
python3 ${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.md
index 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.md
index 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.py
index 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.parent
TOOLS_DIR = Path(__file__).resolve().parent
+SKILL_DIR = TOOLS_DIR.parent
+REPO_ROOT = SKILL_DIR.parent.parent
SOURCE_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.md
similarity index 71%
rename from .agent/workflows/create-template.md
rename to skills/ppt-master/workflows/create-template.md
index 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
```bash
ls -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)