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(roles): 集成高级提示词模板至 Image_Generator,并优化相关文档格式

hugohe37ffcf9687bd0
diff --git a/AGENTS.md b/AGENTS.md
index 546963f8..7c89c92f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -180,8 +180,9 @@ Optimizer_CRAP (可选优化)
## ✅ Image_Generator 阶段完成
- [x] 已阅读 `roles/Image_Generator.md`
-- [x] 已为每张图片生成优化提示词
-- [x] 所有图片已保存到 `images/` 目录
+- [x] 已创建提示词文档 `images/image_prompts.md`
+- [x] 每张图片都有:类型判断 + 优化提示词 + 负面提示词 + Alt Text
+- [x] 所有图片已保存到 `images/` 目录(或已告知用户自行生成)
- [x] 已更新图片资源清单状态
- [ ] **下一步**: Executor_xxx
```
@@ -284,22 +285,22 @@ python3 tools/svg_to_pptx.py <项目路径> -s final
#### 必须禁用的功能(黑名单)
-| 分类 | 禁用项 | 说明 |
-| --------------- | -------------------------------- | ----------------------- |
-| **裁剪 / 遮罩** | ❌ `clipPath` | PPT 不支持 SVG 裁剪路径 |
-| | ❌ `mask` | PPT 不支持 SVG 遮罩 |
-| **样式系统** | ❌ `<style>` | 内部样式表不兼容 |
-| | ❌ `class` / `id` 选择器 | 使用内联属性替代 |
-| | ❌ 外部 CSS | 禁止引用外部样式 |
-| **结构 / 嵌套** | ❌ `<foreignObject>` | 使用 `<tspan>` 手动换行 |
-| | ❌ `<symbol>` + `<use>` 复杂用法 | 简单 `<use>` 引用可用 |
-| **文本 / 字体** | ❌ `textPath` | 路径文本不兼容 |
-| | ❌ Web 字体(`@font-face`) | 使用系统字体栈 |
-| **动画 / 交互** | ❌ SMIL 动画(`<animate*>` / `<set>`) | SVG 动画不导出 |
-| | ❌ `<script>` / 事件属性 | 禁止脚本和事件处理 |
-| **标记 / 箭头** | ❌ `marker` / `marker-end` | PPT 不支持 SVG 标记 |
-| | ❌ `<marker>` + `<defs>` | 使用 `<polygon>` 替代 |
-| **其他** | ❌ `<iframe>` | 不应出现在 SVG 中 |
+| 分类 | 禁用项 | 说明 |
+| --------------- | -------------------------------------- | ----------------------- |
+| **裁剪 / 遮罩** | ❌ `clipPath` | PPT 不支持 SVG 裁剪路径 |
+| | ❌ `mask` | PPT 不支持 SVG 遮罩 |
+| **样式系统** | ❌ `<style>` | 内部样式表不兼容 |
+| | ❌ `class` / `id` 选择器 | 使用内联属性替代 |
+| | ❌ 外部 CSS | 禁止引用外部样式 |
+| **结构 / 嵌套** | ❌ `<foreignObject>` | 使用 `<tspan>` 手动换行 |
+| | ❌ `<symbol>` + `<use>` 复杂用法 | 简单 `<use>` 引用可用 |
+| **文本 / 字体** | ❌ `textPath` | 路径文本不兼容 |
+| | ❌ Web 字体(`@font-face`) | 使用系统字体栈 |
+| **动画 / 交互** | ❌ SMIL 动画(`<animate*>` / `<set>`) | SVG 动画不导出 |
+| | ❌ `<script>` / 事件属性 | 禁止脚本和事件处理 |
+| **标记 / 箭头** | ❌ `marker` / `marker-end` | PPT 不支持 SVG 标记 |
+| | ❌ `<marker>` + `<defs>` | 使用 `<polygon>` 替代 |
+| **其他** | ❌ `<iframe>` | 不应出现在 SVG 中 |
> 📌 **记忆口诀**:PPT 只认基础形状 + 内联样式 + 系统字体
diff --git a/docs/image_layout_spec.md b/docs/image_layout_spec.md
index 542461d9..fc7c17db 100644
--- a/docs/image_layout_spec.md
+++ b/docs/image_layout_spec.md
@@ -20,13 +20,13 @@
## 布局类型选择(强制)
-| 图片比例 | 布局类型 | 图片位置 | 说明 |
-|----------|----------|----------|------|
-| **> 2.0** (超宽) | 上下分栏 | 上方通栏 | 图片占画布宽度,高度按比例计算 |
-| **1.5 - 2.0** (宽幅) | 上下分栏 | 上方 | 图片宽度=内容区宽度,高度按比例 |
-| **1.2 - 1.5** (标准) | 左右分栏 | 左侧 | 图片高度优先适配,宽度按比例 |
-| **0.8 - 1.2** (方形) | 左右分栏 | 左侧 | 图片取内容区高度,宽度按比例 |
-| **< 0.8** (竖图) | 左右分栏 | 左侧 | 图片高度=内容区高度,宽度按比例 |
+| 图片比例 | 布局类型 | 图片位置 | 说明 |
+| -------------------- | -------- | -------- | ------------------------------- |
+| **> 2.0** (超宽) | 上下分栏 | 上方通栏 | 图片占画布宽度,高度按比例计算 |
+| **1.5 - 2.0** (宽幅) | 上下分栏 | 上方 | 图片宽度=内容区宽度,高度按比例 |
+| **1.2 - 1.5** (标准) | 左右分栏 | 左侧 | 图片高度优先适配,宽度按比例 |
+| **0.8 - 1.2** (方形) | 左右分栏 | 左侧 | 图片取内容区高度,宽度按比例 |
+| **< 0.8** (竖图) | 左右分栏 | 左侧 | 图片高度=内容区高度,宽度按比例 |
> ⚠️ **边界情况**:当比例处于边界值时(如 1.5),需根据文字量判断。文字多选左右布局,文字少选上下布局。
@@ -153,14 +153,14 @@
## 禁止事项
-| ❌ 禁止 | ✅ 正确做法 |
-|--------|------------|
-| 固定使用 50:50 或任意比例 | 根据图片比例动态计算 |
-| 将宽图塞入方形容器 | 使用上下布局或加大图片区宽度 |
-| 将竖图放入横向窄条 | 使用左右布局,图片在左 |
-| 图片留白超过 10% | 重新计算布局或选择其他方案 |
-| 裁切图片关键内容 | 使用 `preserveAspectRatio="xMidYMid meet"` |
-| 文字区太小无法阅读 | 确保文字区 >= 150px (上下) 或 >= 280px (左右) |
+| ❌ 禁止 | ✅ 正确做法 |
+| ------------------------- | --------------------------------------------- |
+| 固定使用 50:50 或任意比例 | 根据图片比例动态计算 |
+| 将宽图塞入方形容器 | 使用上下布局或加大图片区宽度 |
+| 将竖图放入横向窄条 | 使用左右布局,图片在左 |
+| 图片留白超过 10% | 重新计算布局或选择其他方案 |
+| 裁切图片关键内容 | 使用 `preserveAspectRatio="xMidYMid meet"` |
+| 文字区太小无法阅读 | 确保文字区 >= 150px (上下) 或 >= 280px (左右) |
---
@@ -169,16 +169,16 @@
### 完整展示(推荐用于数据图表)
```xml
-<image href="../images/xxx.png"
- x="60" y="80" width="780" height="446"
+<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"
+<image href="../images/bg.png"
+ x="0" y="0" width="1280" height="720"
preserveAspectRatio="xMidYMid slice"/>
```
@@ -188,15 +188,18 @@
在《设计规范与内容大纲》中,图片资源清单**必须**包含以下字段:
-| 字段 | 说明 | 示例 |
-|------|------|------|
-| 文件名 | 图片文件名 | `p12_0.png` |
-| 原始尺寸 | 宽×高 | 1524×968 |
-| 比例 | 宽/高 | 1.57 |
-| 页码 | 使用页码 | 第5页 |
-| **布局方案** | 上下/左右 + 分栏比 | **上下 6:4** 或 **左右 7:3** |
-| **图片区域** | 图片展示尺寸 | 1160×420 或 780×446 |
-| **文字区域** | 剩余空间尺寸 | 1160×200 或 360×600 |
+| 字段 | 说明 | 示例 |
+| ------------ | ------------------ | ---------------------------------------------- |
+| 文件名 | 图片文件名 | `p12_0.png` |
+| 原始尺寸 | 宽×高 | 1524×968 |
+| 比例 | 宽/高 | 1.57 |
+| 页码 | 使用页码 | 第5页 |
+| **类型** | 图片视觉类型 | **背景图/实景照片/插画配图/图表架构/装饰图案** |
+| **布局方案** | 上下/左右 + 分栏比 | **上下 6:4** 或 **左右 7:3** |
+| **图片区域** | 图片展示尺寸 | 1160×420 或 780×446 |
+| **文字区域** | 剩余空间尺寸 | 1160×200 或 360×600 |
+
+**类型字段用于 Image_Generator 选择合适的提示词策略**。
---
@@ -214,10 +217,10 @@ python3 tools/analyze_images.py <项目路径>/images
## 角色职责
-| 角色 | 职责 |
-|------|------|
+| 角色 | 职责 |
+| -------------- | -------------------------------------------------------------------- |
| **Strategist** | 规划阶段:运行 analyze_images.py,按本规范计算布局,填写图片资源清单 |
-| **Executor** | 执行阶段:严格按图片资源清单中的布局方案和尺寸生成 SVG |
+| **Executor** | 执行阶段:严格按图片资源清单中的布局方案和尺寸生成 SVG |
---
diff --git a/docs/quick_reference.md b/docs/quick_reference.md
index 316ddd44..89eb0f5b 100644
--- a/docs/quick_reference.md
+++ b/docs/quick_reference.md
@@ -46,8 +46,9 @@
⚠️ **触发条件**:图片方式包含「C) AI 生成」时必须执行此步骤
- [ ] 阅读设计规范中的图片资源清单
-- [ ] 为每张待生成图片创建优化提示词
-- [ ] 保存提示词文档到 `images/image_prompts.md`
+- [ ] 为每张图片判断类型(背景图/实景照片/插画/图表/装饰)
+- [ ] 创建提示词文档 `images/image_prompts.md`
+- [ ] 为每张待生成图片生成:类型 + 优化提示词 + 负面提示词 + Alt Text
- [ ] 调用 AI 图像生成工具生成图片
- [ ] 保存所有图片到 `images/` 目录
- [ ] 确认所有图片已归集完成,状态从「待生成」变更为「已生成」
diff --git a/roles/Image_Generator.md b/roles/Image_Generator.md
index 653fcb1a..17eaa96b 100644
--- a/roles/Image_Generator.md
+++ b/roles/Image_Generator.md
@@ -25,11 +25,11 @@ Strategist → Image_Generator → Executor → Optimizer_CRAP → finalize_svg.
- 配色方案
- 画布格式(决定图片宽高比)
- **图片资源清单**(关键输入)
-
- | 文件名 | 尺寸 | 用途 | 状态 | 生成描述 |
- |--------|------|------|------|----------|
- | cover_bg.png | 1920×1080 | 封面背景 | 待生成 | 现代科技感抽象背景,深蓝渐变 |
- | product.png | 600×400 | 第3页配图 | 待生成 | 产品展示,简洁白底 |
+
+ | 文件名 | 尺寸 | 用途 | 类型 | 状态 | 生成描述 |
+ | ------------ | --------- | --------- | -------- | ------ | ---------------------------- |
+ | cover_bg.png | 1920×1080 | 封面背景 | 背景图 | 待生成 | 现代科技感抽象背景,深蓝渐变 |
+ | product.png | 600×400 | 第3页配图 | 实景照片 | 待生成 | 产品展示,简洁白底 |
### 输出
@@ -37,7 +37,7 @@ Strategist → Image_Generator → Executor → Optimizer_CRAP → finalize_svg.
- **文件路径**: `项目/images/image_prompts.md`
- 包含所有待生成图片的优化提示词
- 包含配色参考、使用说明
- - ⚠️ **强制要求**: 必须使用 Write 工具将提示词保存为 md 文件,不能仅在对话中输出
+ - ⚠️ **强制要求**: 必须使用文件写入工具将提示词保存为 md 文件,不能仅在对话中输出
2. **优化后的图片提示词**(每张图片)
- 可直接用于 AI 图像生成工具
- 同时作为图片描述/alt 文本
@@ -49,108 +49,289 @@ Strategist → Image_Generator → Executor → Optimizer_CRAP → finalize_svg.
---
-## 2. 提示词生成策略
+## 2. 统一提示词结构
+
+### 2.1 标准提示词格式
+
+**所有图片类型统一使用以下结构输出**:
+
+```markdown
+### 图片 N: {文件名}
-### 2.1 提示词结构模板
+| 属性 | 值 |
+| -------- | ------------------------------------ |
+| 用途 | {在哪页/承担什么功能} |
+| 类型 | {背景图/插画/实景照片/图表/装饰图案} |
+| 尺寸 | {宽}×{高} ({宽高比}) |
+| 原始描述 | {用户在清单中提供的描述} |
+**提示词 (Prompt)**:
```
-[主体描述], [风格指令], [色彩指令], [构图指令], [质量指令], [负面提示]
+
+{主体描述}, {风格指令}, {色彩指令}, {构图指令}, {质量指令}
+
```
-**示例**:
+**负面提示词 (Negative Prompt)**:
+```
+
+{需要排除的元素}
+
```
-A modern abstract background with flowing gradient waves,
-digital art style, deep blue (#1E3A5F) to cyan (#22D3EE) gradient,
-wide composition 16:9 aspect ratio,
-high quality, 4K resolution, clean and professional,
---no text, watermark, signature, blurry, distorted
+
+**图片描述 (Alt Text)**:
+> {中文描述,用于无障碍访问和图片说明}
```
-### 2.2 风格适配
+### 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`, `negative space on left` |
+| **质量指令** | 分辨率和质量 | `high quality`, `4K resolution`, `sharp details` |
+| **负面提示词** | 排除元素 | `text, watermark, blurry, low quality` |
-| 设计风格 | 图片风格建议 | 关键词 |
-|----------|--------------|--------|
-| **通用灵活** | 现代插画、扁平设计、渐变背景 | modern, flat design, gradient, vibrant |
-| **一般咨询** | 简洁专业、商务风格、数据可视化 | professional, clean, corporate, minimalist |
-| **顶级咨询** | 高端简约、抽象几何、深色调 | premium, sophisticated, geometric, abstract |
+### 2.3 风格关键词速查表
-### 2.3 色彩整合
+根据设计规范中的风格选择:
-从设计规范中提取配色方案,整合到提示词中:
+| 设计风格 | 推荐图片风格 | 核心关键词 |
+| ------------ | ------------------ | -------------------------------------------------------------- |
+| **通用灵活** | 现代插画、扁平设计 | `modern`, `flat design`, `gradient`, `vibrant colors` |
+| **一般咨询** | 简洁专业、商务风 | `professional`, `clean`, `corporate`, `minimalist` |
+| **顶级咨询** | 高端简约、抽象几何 | `premium`, `sophisticated`, `geometric`, `abstract`, `elegant` |
-```
-设计规范配色:
-- 主导色: #1E3A5F (深海蓝)
-- 辅助色: #F8F9FA (浅灰)
-- 强调色: #D4AF37 (金)
+### 2.4 色彩整合方法
+
+从设计规范提取配色,转换为提示词:
-→ 提示词色彩指令:
-"color palette: deep navy blue (#1E3A5F), light gray (#F8F9FA), gold accent (#D4AF37)"
```
+设计规范配色 → 提示词色彩指令
-### 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 | 1920×1080 或 2560×1440 |
-| PPT 4:3 | 4:3 | 1600×1200 |
-| 小红书 | 3:4 | 1242×1660 |
-| 朋友圈 | 1:1 | 1080×1080 |
-| Story | 9:16 | 1080×1920 |
+| 画布格式 | 背景图宽高比 | 建议分辨率 |
+| -------- | ------------ | ---------------------- |
+| PPT 16:9 | 16:9 | 1920×1080 或 2560×1440 |
+| PPT 4:3 | 4:3 | 1600×1200 |
+| 小红书 | 3:4 | 1242×1660 |
+| 朋友圈 | 1:1 | 1080×1080 |
+| Story | 9:16 | 1080×1920 |
---
-## 3. 图片类型处理指南
+## 3. 图片类型分类与处理
-### 3.1 背景图
+### 3.0 类型判断流程
-**用途**: 封面背景、章节页背景
+```
+用户提供的「生成描述」
+ │
+ ▼
+ ┌────────────────────────────────────────┐
+ │ 步骤 1: 判断图片类型 │
+ │ 问:这张图片的视觉呈现形式是什么? │
+ └────────────────────────────────────────┘
+ │
+ ├─ 全页/大面积铺底 → 背景图 (3.1)
+ ├─ 真实场景/人物/产品 → 实景照片 (3.2)
+ ├─ 扁平/插画/卡通风格 → 插画配图 (3.3)
+ ├─ 流程/架构/关系 → 图表/架构图 (3.4)
+ └─ 局部装饰/纹理 → 装饰图案 (3.5)
+ │
+ ▼
+ ┌────────────────────────────────────────┐
+ │ 步骤 2: 应用类型专属要点 │
+ │ 参考对应小节的「提示词要点」 │
+ └────────────────────────────────────────┘
+ │
+ ▼
+ ┌────────────────────────────────────────┐
+ │ 步骤 3: 套用统一输出格式 (2.1) │
+ │ 生成标准化的提示词输出 │
+ └────────────────────────────────────────┘
+```
+
+---
+
+### 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
+```
**示例**:
+
```
-Abstract geometric background with soft gradient,
-minimalist style, deep blue to purple gradient,
-subtle patterns, clean negative space in center for text overlay,
+Abstract geometric background with flowing waves, minimalist style,
+deep navy blue (#1E3A5F) to cyan (#22D3EE) gradient, subtle particle effects,
+clean negative space in center for text overlay,
16:9 aspect ratio, high resolution, professional presentation background
---no text, watermark, busy patterns, faces
```
-### 3.2 配图/插图
+**负面提示词**: `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
+```
**示例**:
+
```
-Modern isometric illustration of team collaboration,
-people working together in an office setting,
-flat design style with soft shadows,
-color palette: blue (#4A90D9), white, light gray,
-clean white background, professional business illustration
---no text, watermark, realistic photos
+Modern office team collaboration meeting, professional photography,
+natural soft lighting, slightly blurred office background,
+color grading with cool blue tones (#1E3A5F),
+high quality, sharp focus, 8K resolution, diverse professional team
```
-### 3.3 图标/符号图
+**负面提示词**: `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
+```
+
+**示例**:
+
+```
+Team collaboration concept with people working together,
+flat design isometric illustration style,
+simplified shapes with clean lines and soft shadows,
+color palette: blue (#4A90D9), coral (#FF6B6B), white,
+white background, professional business illustration
+```
+
+**负面提示词**: `realistic, photography, 3D render, complex textures, gradients, 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
+```
+
+**示例**:
+
+```
+Neural network architecture diagram showing transformer model,
+encoder and decoder blocks connected by attention arrows,
+clean minimalist style with subtle 3D depth effects,
+blue (#4A90D9) and gray (#6B7280) color scheme,
+white background, clear labels, suitable for academic publication
+```
+
+**负面提示词**: `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 {用途}
+```
+
+**示例**:
+
+```
+Abstract geometric corner decoration with flowing lines,
+minimalist style, gold (#D4AF37) on transparent background,
+subtle and elegant, suitable for presentation slide corners
+```
+
+**负面提示词**: `busy, cluttered, high contrast, distracting, photorealistic`
---
@@ -161,31 +342,36 @@ clean white background, professional business illustration
1. 阅读设计规范,理解项目整体风格
2. 提取配色方案、画布格式、目标受众
3. 逐一分析图片资源清单中的每张图片
+4. **判断每张图片的类型**(参考 3.0 类型判断流程)
### 4.2 提示词生成阶段
对每张「待生成」状态的图片:
-1. **理解用途**: 这张图片在哪页?承担什么功能?
-2. **分析原始描述**: 用户在「生成描述」中提供了什么信息?
-3. **生成优化提示词**: 使用模板结构,整合风格、色彩、构图要求
-4. **添加负面提示**: 排除不需要的元素(文字、水印等)
-5. **保存提示词文档**: ⚠️ **必须**使用 Write 工具将所有提示词保存到 `项目/images/image_prompts.md`
+1. **判断类型**: 这张图片属于哪种类型?(背景图/实景照片/插画/图表/装饰)
+2. **理解用途**: 这张图片在哪页?承担什么功能?
+3. **分析原始描述**: 用户在「生成描述」中提供了什么信息?
+4. **应用类型要点**: 参考对应类型的「提示词要点」表格
+5. **生成优化提示词**: 使用 2.1 统一输出格式
+6. **保存提示词文档**: ⚠️ **必须**使用文件写入工具将所有提示词保存到 `项目/images/image_prompts.md`
### 4.3 图片生成阶段
> ⚠️ **前置条件**: 必须先完成 4.2,确保 `images/image_prompts.md` 已创建
**方式一:自动生成**(如果 AI 工具支持)
+
- 直接调用图像生成 API
- 下载并保存到 `项目/images/` 目录
**方式二:手动生成**(常用方式)
+
- 提示词已保存在 `images/image_prompts.md`,告知用户文件位置
- 用户自行到 AI 平台(Midjourney、DALL-E、Stable Diffusion、文心一格、通义万相)生成
- 用户将生成的图片放入 `项目/images/` 目录
**方式三:使用 Gemini 生成**(推荐高分辨率)
+
- 在 [Gemini](https://gemini.google.com/) 中生成图片
- 选择 **Download full size** 下载高分辨率版本
- ⚠️ **水印处理**: Gemini 生成的图片右下角有星星水印,使用以下工具去除:
@@ -201,99 +387,183 @@ clean white background, professional business illustration
---
-## 5. 输出格式
+## 5. 提示词文档模板
-### 5.1 提示词输出格式
+### 5.1 image_prompts.md 文件结构
-为每张图片输出以下信息:
+创建 `项目/images/image_prompts.md` 时使用以下模板:
```markdown
+# 图片生成提示词
+
+> 项目: {项目名称}
+> 生成时间: {日期}
+> 配色方案: 主导色 {#HEX} | 辅助色 {#HEX} | 强调色 {#HEX}
+
+---
+
+## 图片清单总览
+
+| # | 文件名 | 类型 | 尺寸 | 状态 |
+| --- | ------------ | -------- | --------- | --------- |
+| 1 | cover_bg.png | 背景图 | 1920×1080 | ⏳ 待生成 |
+| 2 | product.png | 实景照片 | 600×400 | ⏳ 待生成 |
+
+---
+
+## 详细提示词
+
### 图片 1: cover_bg.png
-**用途**: 封面背景
-**尺寸**: 1920×1080 (16:9)
-**原始描述**: 现代科技感抽象背景,深蓝渐变
+| 属性 | 值 |
+| -------- | ---------------------------- |
+| 用途 | 封面背景 |
+| 类型 | 背景图 |
+| 尺寸 | 1920×1080 (16:9) |
+| 原始描述 | 现代科技感抽象背景,深蓝渐变 |
-**优化提示词**:
+**提示词 (Prompt)**:
```
+
Abstract futuristic background with flowing digital waves and particles,
modern tech aesthetic, deep navy blue (#1E3A5F) to bright cyan (#22D3EE) gradient,
soft glowing light effects, geometric patterns,
-wide 16:9 composition with clear center area for text,
-high quality 4K, professional presentation background,
-clean and sophisticated
---no text, watermark, faces, realistic photos, busy details
+16:9 aspect ratio, clean negative space in center for text overlay,
+high quality 4K, professional presentation background
+
```
-**图片描述** (alt 文本):
+**负面提示词 (Negative Prompt)**:
+```
+
+text, letters, watermark, faces, busy patterns, high contrast details, low quality
+
+```
+
+**图片描述 (Alt Text)**:
> 现代科技感抽象背景,深蓝色渐变配合数字波浪和粒子效果
+
+---
+
+### 图片 2: product.png
+
+...(同样格式)
+
+---
+
+## 使用说明
+
+1. 复制上方「提示词」到 AI 图像生成工具
+2. 推荐平台: Midjourney / DALL-E 3 / Gemini / Stable Diffusion
+3. 生成后将图片重命名为对应文件名
+4. 放入 `images/` 目录
```
-### 5.2 完成确认
+### 5.2 完成确认输出
所有图片生成完成后,输出确认信息:
```markdown
-## ✅ 图片生成完成
+## ✅ Image_Generator 阶段完成
+
+- [x] 已创建提示词文档 `项目/images/image_prompts.md`
+- [x] 已为 X 张图片生成优化提示词
+- [x] 所有图片已保存到 `images/` 目录
+- [x] 已更新图片资源清单状态
-已生成 X 张图片,保存到 `项目/images/` 目录:
+**图片状态汇总**:
-| 文件名 | 尺寸 | 状态 |
-|--------|------|------|
-| cover_bg.png | 1920×1080 | ✅ 已生成 |
-| product.png | 600×400 | ✅ 已生成 |
+| 文件名 | 类型 | 尺寸 | 状态 |
+| ------------ | -------- | --------- | --------- |
+| cover_bg.png | 背景图 | 1920×1080 | ✅ 已生成 |
+| product.png | 实景照片 | 600×400 | ✅ 已生成 |
-**下一步**: 请调用 Executor 角色开始生成 SVG。
+**下一步**: 切换到 Executor 角色开始生成 SVG
```
---
-## 6. 负面提示词参考
+## 6. 负面提示词速查
-通用负面提示(根据需要选用):
+### 6.1 按图片类型
+
+| 类型 | 推荐负面提示词 |
+| --------------- | ---------------------------------------------------------------------------------- |
+| **背景图** | `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` |
+
+### 6.2 通用负面提示词
+
+**标准版**(适合大多数场景):
```
---no text, letters, words, watermark, signature, logo,
-blurry, low quality, pixelated, distorted, deformed,
-ugly, duplicate, morbid, mutilated,
-out of frame, extra fingers, mutated hands,
-poorly drawn hands, poorly drawn face,
-mutation, deformed, bad anatomy, bad proportions,
-extra limbs, cloned face, disfigured,
-gross proportions, malformed limbs, missing arms,
-missing legs, extra arms, extra legs, fused fingers,
-too many fingers, long neck
+text, watermark, signature, blurry, distorted, low quality
```
-**简化版**(适合大多数场景):
+**扩展版**(人物相关场景):
+
```
---no 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. 常见问题
-### Q: 用户没有提供「生成描述」怎么办?
+### Q1: 用户没有提供「生成描述」怎么办?
+
+根据图片用途和页面内容推断,主动生成合理的提示词:
+
+| 用途 | 默认推断 |
+| ---------- | ------------------------------ |
+| 封面背景 | 抽象渐变背景,预留中央文字区域 |
+| 章节页背景 | 简洁几何图案,侧重单色调 |
+| 团队介绍页 | 团队协作场景插图(扁平风格) |
+| 数据展示页 | 简洁几何图案或纯色背景 |
+| 产品展示 | 产品实拍风格,白底或渐变背景 |
+
+### Q2: 生成的图片不满意怎么办?
+
+提供提示词变体,让用户选择或调整:
+
+```markdown
+**变体 A - 更抽象**:
+```
+
+Abstract minimalist background, geometric shapes...
-A: 根据图片用途和页面内容推断,主动生成合理的提示词。例如:
-- 封面背景 → 抽象渐变背景
-- 团队介绍页 → 团队协作场景插图
-- 数据页 → 简洁几何图案或留白
+```
-### Q: 生成的图片不满意怎么办?
+**变体 B - 更具象**:
+```
-A: 提供多个提示词变体,让用户选择或调整:
-- 变体 A: 更抽象
-- 变体 B: 更具象
-- 变体 C: 不同色调
+Detailed illustration of specific scene...
-### Q: 如何处理需要真实照片的场景?
+```
+
+**变体 C - 不同色调**:
+```
-A:
-- 提示词中加入 `photography, realistic, photo` 等关键词
-- 注意版权问题,建议使用 AI 生成而非网络图片
-- 或建议用户使用自己的照片素材
+Same composition with warm color palette...
+
+```
+
+```
+
+### Q3: 如何确定「类型」?
+
+参考 3.0 类型判断流程,关键问题:
+
+1. 这张图片是否铺满整页作为背景?→ 背景图
+2. 这张图片需要真实感/照片质感吗?→ 实景照片
+3. 这张图片是扁平/卡通/矢量风格吗?→ 插画配图
+4. 这张图片展示流程/结构/关系吗?→ 图表/架构图
+5. 这张图片是小尺寸装饰元素吗?→ 装饰图案
---
@@ -301,24 +571,38 @@ A:
### 与 Strategist 的衔接
-- **接收**: 设计规范与内容大纲(含图片资源清单)
-- **触发条件**: 用户在第 g 项「图片使用」中选择的方案**包含**「C) AI 生成」
+| 方向 | 内容 |
+| ------------ | ---------------------------------------------------- |
+| **接收** | 设计规范与内容大纲(含图片资源清单) |
+| **触发条件** | 用户在「图片使用」中选择的方案**包含**「C) AI 生成」 |
+| **关键信息** | 配色方案、设计风格、画布格式 |
### 与 Executor 的衔接
-- **交付**: 所有图片已放入 `项目/images/` 目录
-- **Executor 使用**: `<image href="../images/xxx.png" .../>` 引用图片(SVG 在 `svg_output/` 目录中)
+| 方向 | 内容 |
+| ----------------- | --------------------------------------------------------------------------- |
+| **交付** | 所有图片已放入 `项目/images/` 目录 |
+| **Executor 引用** | `<image href="../images/xxx.png" .../>` |
+| **路径说明** | SVG 在 `svg_output/` 目录,图片在 `images/` 目录,使用相对路径 `../images/` |
---
## 9. 任务完成标准
-- [ ] **已创建提示词文档** `项目/images/image_prompts.md`(必须首先完成)
-- [ ] 所有「待生成」状态的图片都已生成优化提示词
-- [ ] 所有图片已保存到 `项目/images/` 目录(或等待用户手动生成)
-- [ ] 文件名与图片资源清单一致
-- [ ] 图片尺寸符合要求
-- [ ] 已输出完成确认信息
-- [ ] 已提示用户进入下一步(调用 Executor)
+**必须完成项**:
+
+- [ ] **已创建提示词文档** `项目/images/image_prompts.md`
+- [ ] 每张图片都有:类型判断 + 优化提示词 + 负面提示词 + Alt Text
+- [ ] 使用统一输出格式(2.1 标准格式)
+- [ ] 已输出阶段完成确认(5.2 格式)
+
+**图片就绪项**(以下至少满足一项):
+
+- [ ] 所有图片已保存到 `项目/images/` 目录
+- [ ] 或:已明确告知用户使用 `image_prompts.md` 自行生成
+
+**流程流转**:
+
+- [ ] 已提示用户进入下一步(切换到 Executor 角色)
-> ⚠️ **关键检查**: 如果 `images/image_prompts.md` 未创建,任务未完成。
+> ⚠️ **关键检查**: 如果 `images/image_prompts.md` 未创建,或输出格式不符合 2.1 标准,任务未完成。
diff --git a/roles/Strategist.md b/roles/Strategist.md
index f89a7f13..7063a57f 100644
--- a/roles/Strategist.md
+++ b/roles/Strategist.md
@@ -59,12 +59,12 @@
> 💡 以下为示例,完整配色方案(14 个行业)请参考 [tools/config.py](../tools/config.py) 中的 `INDUSTRY_COLORS`
-| 行业 | 主导色 | 特点 |
-|------|--------|------|
-| **金融/商务** | `#003366` 深蓝 | 稳重信赖 |
-| **科技/互联网** | `#1565C0` 明蓝 | 创新活力 |
-| **医疗/健康** | `#00796B` 青绿 | 专业安心 |
-| **政务/政府** | `#C41E3A` 中国红 | 庄重权威 |
+| 行业 | 主导色 | 特点 |
+| --------------- | ---------------- | -------- |
+| **金融/商务** | `#003366` 深蓝 | 稳重信赖 |
+| **科技/互联网** | `#1565C0` 明蓝 | 创新活力 |
+| **医疗/健康** | `#00796B` 青绿 | 专业安心 |
+| **政务/政府** | `#C41E3A` 中国红 | 庄重权威 |
**配色规则**:
@@ -97,11 +97,11 @@
```markdown
## 图片资源清单
-| 文件名 | 尺寸 | 比例 | 布局建议 | 用途 | 状态 | 生成描述 |
-| ------------ | -------- | ---- | ------------------------ | -------- | ------ | ---------------------------- |
-| cover_bg.png | 1280×720 | 1.78 | 宽幅横图 (适合全屏/插图) | 封面背景 | 待生成 | 现代科技感抽象背景,深蓝渐变 |
-| product.png | 600×400 | 1.50 | 标准横图 (适合全屏/插图) | 第3页 | 已有 | - |
-| team.png | 400×600 | 0.67 | 标准竖图 (适合左右分栏) | 第5页 | 占位符 | 团队协作场景(后期补充) |
+| 文件名 | 尺寸 | 比例 | 布局建议 | 用途 | 类型 | 状态 | 生成描述 |
+| ------------ | -------- | ---- | ------------------------ | -------- | -------- | ------ | ---------------------------- |
+| cover_bg.png | 1280×720 | 1.78 | 宽幅横图 (适合全屏/插图) | 封面背景 | 背景图 | 待生成 | 现代科技感抽象背景,深蓝渐变 |
+| product.png | 600×400 | 1.50 | 标准横图 (适合全屏/插图) | 第3页 | 实景照片 | 已有 | - |
+| team.png | 400×600 | 0.67 | 标准竖图 (适合左右分栏) | 第5页 | 插画配图 | 占位符 | 团队协作场景(后期补充) |
```
**状态说明**:
@@ -110,6 +110,16 @@
- **已有** - 用户已有图片,直接放入 `images/`(比例/布局建议由 `analyze_images.py` 自动扫描填充)
- **占位符** - 暂不处理,SVG 中用虚线框占位
+**类型说明**(Image_Generator 用于选择提示词策略):
+
+| 类型 | 适用场景 |
+| ------------ | ----------------------------------- |
+| **背景图** | 封面/章节页全页背景,需预留文字区域 |
+| **实景照片** | 真实场景、人物、产品、建筑等 |
+| **插画配图** | 扁平设计、矢量风格、卡通、概念图解 |
+| **图表架构** | 流程图、架构图、概念关系图 |
+| **装饰图案** | 局部装饰、纹理、边框、分隔元素 |
+
图片嵌入详情参见 [SVG 图片嵌入指南](../docs/svg_image_embedding.md)
> ⚠️ **流程衔接**: 如果用户选择 **C) AI 生成**,在输出设计规范后,需提示用户调用 **Image_Generator** 角色完成图片生成,图片归集到 `images/` 目录后,再进入 Executor 阶段。
@@ -239,6 +249,7 @@
> ⚠️ **注意**:项目文件夹应在进入策略师角色**之前**已创建完成。
>
> 如果文件夹尚未创建,请先返回主流程执行:
+>
> ```bash
> python3 tools/project_manager.py init <项目名称> --format <画布格式>
> ```
diff --git a/templates/design_spec_reference.md b/templates/design_spec_reference.md
index e6d3d9bc..a15a3477 100644
--- a/templates/design_spec_reference.md
+++ b/templates/design_spec_reference.md
@@ -2,33 +2,34 @@
## 一、项目信息
-| 项目 | 内容 |
-|------|------|
-| **项目名称** | {project_name} |
+| 项目 | 内容 |
+| ------------ | --------------------------------------------------- |
+| **项目名称** | {project_name} |
| **画布格式** | {canvas_info['name']} ({canvas_info['dimensions']}) |
-| **页数** | [由 Strategist 填写] |
-| **设计风格** | {design_style} |
-| **目标受众** | [由 Strategist 填写] |
-| **使用场景** | [由 Strategist 填写] |
-| **创建日期** | {date_str} |
+| **页数** | [由 Strategist 填写] |
+| **设计风格** | {design_style} |
+| **目标受众** | [由 Strategist 填写] |
+| **使用场景** | [由 Strategist 填写] |
+| **创建日期** | {date_str} |
---
## 二、画布规范
-| 属性 | 值 |
-|------|-----|
-| **格式** | {canvas_info['name']} |
-| **尺寸** | {canvas_info['dimensions']} |
-| **viewBox** | `{canvas_info['viewbox']}` |
-| **边距** | [由 Strategist 推荐,如:左右 60px,上下 50px] |
-| **内容区域** | [根据画布计算] |
+| 属性 | 值 |
+| ------------ | ---------------------------------------------- |
+| **格式** | {canvas_info['name']} |
+| **尺寸** | {canvas_info['dimensions']} |
+| **viewBox** | `{canvas_info['viewbox']}` |
+| **边距** | [由 Strategist 推荐,如:左右 60px,上下 50px] |
+| **内容区域** | [根据画布计算] |
---
## 三、视觉主题
### 主题风格
+
- **风格**: {design_style}
- **主题**: [亮色主题 / 深色主题]
- **调性**: [由 Strategist 填写,如:科技、专业、现代、创新]
@@ -37,19 +38,19 @@
> Strategist 应根据项目内容、行业属性、品牌色彩确定具体色值
-| 角色 | 色值 | 用途 |
-|------|------|------|
-| **背景色** | `#......` | 页面背景(亮色主题通常为白色系,深色主题为深灰/深蓝系) |
-| **次背景** | `#......` | 卡片背景、区块背景 |
-| **主导色** | `#......` | 标题装饰、重点区块、图标 |
-| **强调色** | `#......` | 数据高亮、关键信息、链接 |
-| **辅助强调** | `#......` | 次要强调、渐变过渡 |
-| **正文文字** | `#......` | 主要正文(深色主题用浅色文字) |
-| **次要文字** | `#......` | 说明文字、标注 |
-| **弱文字** | `#......` | 辅助信息、页脚 |
-| **边框/分割** | `#......` | 卡片边框、分割线 |
-| **成功色** | `#......` | 正向指标(绿色系) |
-| **警示色** | `#......` | 问题标注(红色系) |
+| 角色 | 色值 | 用途 |
+| ------------- | --------- | ------------------------------------------------------- |
+| **背景色** | `#......` | 页面背景(亮色主题通常为白色系,深色主题为深灰/深蓝系) |
+| **次背景** | `#......` | 卡片背景、区块背景 |
+| **主导色** | `#......` | 标题装饰、重点区块、图标 |
+| **强调色** | `#......` | 数据高亮、关键信息、链接 |
+| **辅助强调** | `#......` | 次要强调、渐变过渡 |
+| **正文文字** | `#......` | 主要正文(深色主题用浅色文字) |
+| **次要文字** | `#......` | 说明文字、标注 |
+| **弱文字** | `#......` | 辅助信息、页脚 |
+| **边框/分割** | `#......` | 卡片边框、分割线 |
+| **成功色** | `#......` | 正向指标(绿色系) |
+| **警示色** | `#......` | 问题标注(红色系) |
> 💡 **参考**: 行业配色见 `roles/Strategist.md` 或 `tools/config.py` 中的 `INDUSTRY_COLORS`
@@ -80,11 +81,11 @@
**推荐预设**: [填写预设编号]
-| 角色 | 中文 | 英文 | 备选 |
-|------|------|------|------|
+| 角色 | 中文 | 英文 | 备选 |
+| -------- | -------- | -------- | -------- |
| **标题** | [字体名] | [字体名] | [字体名] |
| **正文** | [字体名] | [字体名] | [字体名] |
-| **代码** | - | Consolas | Monaco |
+| **代码** | - | Consolas | Monaco |
| **强调** | [字体名] | [字体名] | [字体名] |
**字体栈**: `[填写 CSS font-family 字符串]`
@@ -98,15 +99,15 @@
**基准**: 正文字号 = [填写]pt(推荐 14-20pt,根据内容密度选择)
-| 用途 | 比例 | 示例 (18pt基准) | 示例 (14pt基准) | 字重 |
-|------|------|-----------------|-----------------|------|
-| 标题页(封面) | 2.5-3× | 45-54pt | 35-42pt | Bold |
-| 章节标题 | 2-2.5× | 36-45pt | 28-35pt | Bold |
-| 内容标题 | 1.5-2× | 27-36pt | 21-28pt | Bold |
-| 副标题/小标题 | 1.2-1.5× | 22-27pt | 17-21pt | SemiBold |
-| **正文内容** | **1×** | **18pt** | **14pt** | Regular |
-| 注释/备注 | 0.75-0.85× | 14-15pt | 11-12pt | Regular |
-| 页码/日期 | 0.55-0.65× | 10-12pt | 8-9pt | Regular |
+| 用途 | 比例 | 示例 (18pt基准) | 示例 (14pt基准) | 字重 |
+| -------------- | ---------- | --------------- | --------------- | -------- |
+| 标题页(封面) | 2.5-3× | 45-54pt | 35-42pt | Bold |
+| 章节标题 | 2-2.5× | 36-45pt | 28-35pt | Bold |
+| 内容标题 | 1.5-2× | 27-36pt | 21-28pt | Bold |
+| 副标题/小标题 | 1.2-1.5× | 22-27pt | 17-21pt | SemiBold |
+| **正文内容** | **1×** | **18pt** | **14pt** | Regular |
+| 注释/备注 | 0.75-0.85× | 14-15pt | 11-12pt | Regular |
+| 页码/日期 | 0.55-0.65× | 10-12pt | 8-9pt | Regular |
> 💡 **建议**: 内容密集(咨询报告)用 14pt 基准;内容宽松(演讲)用 18-20pt 基准
@@ -115,60 +116,71 @@
## 五、布局原则
### 页面结构
+
- **页眉区**: [高度及内容说明]
- **内容区**: [高度及内容说明]
- **页脚区**: [高度及内容说明]
### 常用布局模式
-| 模式 | 适用场景 |
-|------|----------|
-| **单栏居中** | 封面、结语、重要观点 |
-| **左右分栏 (5:5)** | 对比、双概念 |
-| **左右分栏 (4:6)** | 图文混排 |
-| **上下分栏** | 流程、时间线 |
-| **三栏/四栏卡片** | 特性列表、角色介绍 |
-| **矩阵网格** | 对比分析、分类展示 |
+| 模式 | 适用场景 |
+| ------------------ | -------------------- |
+| **单栏居中** | 封面、结语、重要观点 |
+| **左右分栏 (5:5)** | 对比、双概念 |
+| **左右分栏 (4:6)** | 图文混排 |
+| **上下分栏** | 流程、时间线 |
+| **三栏/四栏卡片** | 特性列表、角色介绍 |
+| **矩阵网格** | 对比分析、分类展示 |
### 间距规范
> Strategist 可根据项目需求调整
-| 元素 | 推荐范围 | 当前项目 |
-|------|----------|----------|
-| 卡片间距 | 20-32px | [填写] |
-| 内容块间距 | 24-40px | [填写] |
-| 卡片内边距 | 20-32px | [填写] |
-| 卡片圆角 | 8-16px | [填写] |
-| 图标与文字 | 8-16px | [填写] |
+| 元素 | 推荐范围 | 当前项目 |
+| ---------- | -------- | -------- |
+| 卡片间距 | 20-32px | [填写] |
+| 内容块间距 | 24-40px | [填写] |
+| 卡片内边距 | 20-32px | [填写] |
+| 卡片圆角 | 8-16px | [填写] |
+| 图标与文字 | 8-16px | [填写] |
---
## 六、图标使用规范
### 来源
+
- **内置图标库**: `templates/icons/` (640+ 图标)
- **使用方式**: 占位符格式 `{{{{icon:类别/图标名}}}}`
### 推荐图标清单(按需填写)
-| 用途 | 图标路径 | 页面 |
-|------|----------|------|
+| 用途 | 图标路径 | 页面 |
+| ------ | ------------------------------------- | -------- |
| [示例] | `{{{{icon:interface/check-circle}}}}` | Slide XX |
---
## 七、图片资源清单(如需要)
-| 文件名 | 尺寸 | 比例 | 用途 | 状态 | 生成描述 |
-|--------|------|------|------|------|----------|
-| cover_bg.png | {canvas_info['dimensions']} | [比例] | 封面背景 | [待生成/已有/占位符] | [AI生成提示词] |
+| 文件名 | 尺寸 | 比例 | 用途 | 类型 | 状态 | 生成描述 |
+| ------------ | --------------------------- | ------ | -------- | -------------------------------------------- | -------------------- | -------------- |
+| cover_bg.png | {canvas_info['dimensions']} | [比例] | 封面背景 | [背景图/实景照片/插画配图/图表架构/装饰图案] | [待生成/已有/占位符] | [AI生成提示词] |
**状态说明**:
+
- **待生成** - 需要 AI 生成,提供详细描述
- **已有** - 用户已有图片,直接放入 `images/`
- **占位符** - 暂不处理,SVG 中用虚线框占位
+**类型说明**(Image_Generator 用于选择提示词策略):
+
+- **背景图** - 封面/章节页全页背景,需预留文字区域
+- **实景照片** - 真实场景、人物、产品、建筑等
+- **插画配图** - 扁平设计、矢量风格、卡通、概念图解
+- **图表架构** - 流程图、架构图、概念关系图
+- **装饰图案** - 局部装饰、纹理、边框、分隔元素
+
---
## 八、内容大纲
@@ -176,12 +188,14 @@
### 第一部分:[章节名称]
#### Slide 01 - 封面
+
- **布局**: 全屏背景图 + 居中标题
- **标题**: [主标题]
- **副标题**: [副标题]
- **信息**: [作者/日期/单位]
#### Slide 02 - [页面名称]
+
- **布局**: [选择布局模式]
- **标题**: [页面标题]
- **内容**:
@@ -198,6 +212,7 @@
## 九、演讲备注要求
每页生成对应的演讲备注文件,保存到 `notes/` 目录:
+
- **文件命名**: 与 SVG 同名,如 `01_封面.md`
- **内容包含**: 讲稿要点、时间提示、过渡语
@@ -206,6 +221,7 @@
## 十、技术约束提醒
### SVG 生成必须遵守:
+
1. viewBox: `{canvas_info['viewbox']}`
2. 背景使用 `<rect>` 元素
3. 文本换行使用 `<tspan>`(禁止 `<foreignObject>`)
@@ -215,6 +231,7 @@
7. 箭头使用 `<polygon>` 三角形替代 `<marker>`
### PPT 兼容性规则:
+
- 禁止 `<g opacity="...">`(组透明度),每个子元素单独设置
- 图片透明度使用遮罩层替代(`<rect fill="背景色" opacity="0.x"/>`)
- 仅使用内联样式,禁止外部 CSS 和 `@font-face`
@@ -224,11 +241,13 @@
## 十一、设计检查清单
### 生成前
+
- [ ] 内容符合页面容量
- [ ] 布局模式选择正确
- [ ] 颜色使用符合语义
### 生成后
+
- [ ] viewBox = `{canvas_info['viewbox']}`
- [ ] 无 `<foreignObject>` 元素
- [ ] 所有文本可读(≥14px)