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

docs:明确用户提供图片时需在策略师阶段运行 analyze_images

hugohe3e6daed1a0e32
diff --git a/AGENTS.md b/AGENTS.md
index 5f5c60d0..39717a21 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -289,6 +289,8 @@ python3 tools/svg_to_pptx.py <项目路径> -s final
**策略师必须主动给出专业建议,而非仅提问。**
+**若图片方案包含「B) 用户提供」**:八项确认完成后、进入内容分析与大纲编制之前,必须运行 `python3 tools/analyze_images.py <项目路径>/images`,并在输出《设计规范与内容大纲》前填充图片资源清单。
+
### 2. SVG 技术约束(不可协商)
- **viewBox**: 必须与画布尺寸一致
@@ -546,6 +548,7 @@ project/
- 通用风格与咨询风格在规范格式上有本质区别
- 图标使用方式需在八项确认中确认(Emoji / AI 生成 / 内置库 / 自定义)
- 图片使用方式需在八项确认中确认(不使用 / 用户提供 / AI 生成 / 占位符)
+- 若图片方案包含「B) 用户提供」,策略师在八项确认后、内容分析前必须运行 `python3 tools/analyze_images.py <项目路径>/images` 并填充图片资源清单
- **图片生成流程**:如果图片方式**包含**「C) AI 生成」(如 C、B+C、C+D),**必须**先切换到 Image_Generator 角色,阅读角色定义,完成图片生成后再进入 Executor 阶段
- **Executor 两阶段**:SVG 页面生成(视觉构建)完成后,**必须**进入逻辑构建阶段生成演讲备注 `notes/total.md`,**禁止**跳过此步骤直接进入后处理
diff --git a/docs/image_layout_spec.md b/docs/image_layout_spec.md
index fc7c17db..43a41410 100644
--- a/docs/image_layout_spec.md
+++ b/docs/image_layout_spec.md
@@ -16,6 +16,8 @@
5. 将结果填入《设计规范》的图片资源清单
```
+**执行时机**:若图片方案包含「B) 用户提供」,在 Strategist 阶段完成八项确认后、进入内容分析与大纲编制之前,必须运行扫描并填充图片资源清单。
+
---
## 布局类型选择(强制)
diff --git a/docs/quick_reference.md b/docs/quick_reference.md
index 95080e09..4de1cf65 100644
--- a/docs/quick_reference.md
+++ b/docs/quick_reference.md
@@ -33,6 +33,8 @@
- [ ] 配色方案(主导色、辅助色、强调色的 HEX 色值)
- [ ] **图标方式**(A Emoji / B AI生成 / C 内置图标库 / D 自定义路径)
- [ ] **图片使用**(A 不使用 / B 用户提供 / C AI生成 / D 占位符预留)
+ - [ ] 若图片包含「B) 用户提供」,八项确认后立即运行 `python3 tools/analyze_images.py <项目路径>/images`,
+ 在输出设计规范前填充图片资源清单
- [ ] **排版方案**(字体组合 P1-P5 + 正文字号基准 18-24px)
- [ ] 等待 Strategist 生成设计规范
- [ ] 仔细检查并确认设计规范
diff --git a/docs/svg_image_embedding.md b/docs/svg_image_embedding.md
index 056b08a0..3263001b 100644
--- a/docs/svg_image_embedding.md
+++ b/docs/svg_image_embedding.md
@@ -8,7 +8,7 @@
### 图片资源清单格式
-在《设计规范与内容大纲》中定义,每张图片标注**状态**:
+在《设计规范与内容大纲》中定义,每张图片标注**状态**。若图片方案包含「B) 用户提供」,需在 Strategist 阶段完成八项确认后立即运行 `analyze_images.py`,并在输出设计规范前完成清单填充。
```markdown
## 图片资源清单
diff --git a/docs/workflow_tutorial.md b/docs/workflow_tutorial.md
index 37e878b7..5b80f429 100644
--- a/docs/workflow_tutorial.md
+++ b/docs/workflow_tutorial.md
@@ -82,6 +82,8 @@
│ │ │ ├── 7. 图片使用 (不使用/用户提供/AI生成/占位符) │ │ │
│ │ │ └── 8. 排版方案 (字体组合 + 字号基准 18-24px) │ │ │
│ │ └─────────────────────────────────────────────────────────────┘ │ │
+│ │ ⚠️ 若图片方案包含「B) 用户提供」,八项确认后需运行 │ │ │
+│ │ analyze_images.py,并在输出设计规范前填充图片资源清单 │ │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
@@ -357,6 +359,8 @@
7. 图片使用:
[建议] A) 不使用图片,数据报告以图表和数据可视化为主。
+ ⚠️ 若选择包含「B) 用户提供」,八项确认后需运行 `python3 tools/analyze_images.py <项目路径>/images`,
+ 并在输出《设计规范与内容大纲》前完成图片资源清单填充。
8. 排版方案:
[建议] P1 方案(微软雅黑 + Arial),正文 24px 基准,现代简洁同时保持专业感。
diff --git a/roles/Strategist.md b/roles/Strategist.md
index ea3b0844..12e895d7 100644
--- a/roles/Strategist.md
+++ b/roles/Strategist.md
@@ -92,6 +92,8 @@
| **C** | AI 生成 | 需要定制插图、背景 |
| **D** | 占位符预留 | 后期补充图片 |
+**如果选择方案包含「B) 用户提供」**,则 **必须在策略师分析阶段立即运行** `analyze_images.py` 扫描图片尺寸与比例,**在输出《设计规范与内容大纲》之前**完成图片资源清单的填充。
+
**选择 B/C/D 时**,在规范中添加「图片资源清单」,每张图片标注状态:
```markdown
@@ -128,6 +130,8 @@
如果用户选择的方案**包含「B) 用户提供」**(如 B、B+C、B+D 等组合),你**必须**执行以下操作:
+**执行时机**:完成八项确认后、进入内容分析与大纲编制之前。
+
1. **运行扫描工具**:使用 bash 运行 `python3 tools/analyze_images.py <项目路径>/images`。
2. **读取图片数据**:获取工具输出的图片尺寸、比例和布局建议(Markdown 表格形式)。
3. **整合进规范**:将扫描结果直接填入《设计规范》的「图片资源清单」章节。