# Prompt 构建指南

## 图片内文字语言（必守）

**公众号配图画面中出现的所有文字必须为中文。**

- 在 prompt 里**直接写出要显示的中文文案**（例如：左侧「传统对话AI」、右侧「OpenClaw」、步骤「立项」「开发」「上线」）。
- **禁止**只写 "labels in Chinese" 或 "Chinese or English OK" 等元描述——多数模型会默认生成英文。
- Prompt 本身可中英混排（描述构图用英文亦可），但「会出现在图上的字」必须用中文写出。

## 通用规则

所有 prompt 必须包含：

1. **布局结构**：描述构图、区域划分、视觉流向
2. **具体内容**：使用文章中的实际数据、术语、关键词（不要泛泛而谈）
3. **视觉关系**：元素之间如何连接、对比、层次
4. **语义颜色**：基于含义选色（红=警告、绿=增长、蓝=科技）
5. **风格特征**：线条处理、纹理、氛围
6. **比例**：封面按 config `cover_aspect`，正文配图 16:9 或 4:3

## 通用构图要求

所有 prompt 默认附加：

```
构图要求：
- 干净简洁，不堆砌元素
- 充足留白，主体元素呼吸感
- 纯色或轻微渐变背景，不要复杂纹理
- 主视觉居中或按内容需要布局
- 突出核心信息
```

## 人物表现

如需画人物：

```
人物表现：简化风格的人物剪影或符号化表达，不要写实人脸。
通过姿态和简单手势传达情绪。
```

## 文字处理

如画面中需要文字：

```
文字要求：大而醒目，手写风字体优先，仅保留核心关键词。所有图中文字必须为中文；在 prompt 中写出要显示的中文原文（如「传统对话AI」「OpenClaw」），不要写 "label in Chinese"。
```

---

## Type 专用模板

### concept 概念讲解

```
[标题] - 概念可视化

核心概念：[要解释的抽象概念]
视觉隐喻：[映射为什么具体事物，如"技术债"→堆积的砖块]

布局：[居中/对称/层级]
主体：[隐喻场景的核心画面]
辅助元素：[标注、箭头、小图标]

配色：[语义配色说明]
风格：[选定的风格特征]
比例：[比例]
```

### process 流程步骤

```
[标题] - 流程可视化

流向：[从左到右/从上到下]
步骤数：[N]

步骤：
1. [步骤名] → [简要说明]
2. [步骤名] → [简要说明]
3. [步骤名] → [简要说明]

连接方式：[箭头/线条/渐变过渡]
高亮：[哪个步骤需要突出]

风格：[选定的风格特征]
比例：[比例]
```

### whiteboard 板书白板

```
[标题] - 板书白板风

背景：白色或浅米色白板
笔触：手写体 + 马克笔风格

知识要点：
- [要点1]：[简要说明]
- [要点2]：[简要说明]
- [要点3]：[简要说明]

辅助：[箭头、圈注、下划线、简笔画]
配色：[马克笔配色，2-3 种主色]
比例：[比例]
```

### data-viz 数据可视化

```
[标题] - 数据可视化

图表类型：[柱状图/折线图/饼图/面积图]

数据标签：
- [具体数据点1：实际数字和术语]
- [具体数据点2：实际数字和术语]
- [具体数据点3：实际数字和术语]

布局：[网格/放射/层级]
区域：
- 顶部：标题区
- 中部主区域：[核心数据/图表]
- 底部：总结/来源

配色：[语义配色说明]
风格：[选定的风格特征]
比例：[比例]
```

### comparison 对比说明

```
[标题] - 对比可视化

布局：[左右分栏/上下分栏]

左侧/A项：
- 名称：[A]
- 特点：[关键差异点]

右侧/B项：
- 名称：[B]
- 特点：[关键差异点]

对比维度：[列出 3-5 个对比维度]
倾向：[中立/偏向某一方]

风格：[选定的风格特征]
比例：[比例]
```

### architecture 架构图

```
[标题] - 架构/模型可视化

结构：[层级/环形/矩阵/树状]

层级/模块：
- [顶层/核心]：[名称和说明]
- [第二层]：[名称和说明]
- [第三层]：[名称和说明]

连接关系：[包含/依赖/双向/单向]

风格：[选定的风格特征]
比例：[比例]
```

### mindmap 思维导图

```
[标题] - 思维导图

中心主题：[核心主题词]

一级分支：
- [分支1]：[关键词]
- [分支2]：[关键词]
- [分支3]：[关键词]

二级分支（可选）：
- [分支1] → [子项1]、[子项2]
- [分支2] → [子项1]、[子项2]

布局：[放射状/右侧展开/上下对称]
配色：每条主分支一个色系
风格：[选定的风格特征]
比例：[比例]
```

### timeline 时间线

```
[标题] - 时间线

方向：[横向/纵向]
节点数：[N]

节点：
1. [时间点]：[事件/里程碑]
2. [时间点]：[事件/里程碑]
3. [时间点]：[事件/里程碑]

高亮：[哪个节点需要突出]
连接线：[实线/虚线/渐变]
配色：[时间推进用渐变色]
风格：[选定的风格特征]
比例：[比例，通常 16:9 或 4:3]
```

### checklist 清单图

```
[标题] - 清单图

条目数：[N]

清单项：
- [✓/✗] [要点1]：[一句话说明]
- [✓/✗] [要点2]：[一句话说明]
- [✓/✗] [要点3]：[一句话说明]

每项配：[图标/编号/勾选框]
布局：[单列/双列/卡片网格]
配色：[语义配色说明]
风格：[选定的风格特征]
比例：[比例]
```

### quote-card 金句卡片

```
[标题] - 金句卡片

金句：「[完整中文金句]」
出处：[作者/来源]（可选）

布局：文字居中，大字号
装饰：[引号装饰/底纹/边框]
背景：[纯色/轻渐变/纹理]
配色：[与金句情绪匹配]
风格：[选定的风格特征]
比例：[比例，通常 1:1 或 4:3]
```

### scene 场景还原

```
[标题] - 场景还原

场景：[描述具体使用/生活场景]
主体：[人物动作或产品使用画面]
环境：[场景环境细节]
视角：[第一人称/俯视/平视]

情绪：[代入感/真实感/日常感]
色调：[暖色/冷色/自然色]
风格：[选定的风格特征]
比例：[比例]
```

### atmosphere 氛围烘托

```
[标题] - 场景氛围

场景：[描述画面场景]
情绪：[要传达的情感]
主体：[画面中心元素]
色调：[暖色/冷色/具体色彩倾向]
光线：[光源方向和质感]

风格：[选定的风格特征]
比例：[比例]
```

### 封面

封面 prompt 的「风格」关键词直接来自封面预设 `.md` 文件的「Prompt 要点」部分（见 [cover-styles/](../cover-styles/)），无须引用 Style 维度。

**YAML frontmatter 必须包含 `aspect`**：从 `config.yaml` 的 `cover_aspect` 读取（如 `2.35:1`），写入 frontmatter，`image_create.py` 据此转换为实际尺寸。缺少 frontmatter 的 aspect 会导致 fallback 到 1:1。

```yaml
---
aspect: "2.35:1"   # ← 必须：取自 config cover_aspect
quality: standard
---
```

```
[文章标题] - 封面图

核心意象：[从标题提取的抽象视觉概念]
情绪：[文章整体调性]
色调：[主色和辅色]

要求：
- 不包含文字（标题会单独叠加）
- 画面简洁有焦点
- 适合作为公众号封面缩略图（小尺寸也清晰）

风格：[从封面预设 .md 的 Prompt 要点加载]
```

---

## 高级布局（适用于复杂信息可视化）

在标记描述中指定布局类型：`![data-viz-漏斗：...]`、`![data-viz-冰山：...]`。

**布局类型一览**：

| 布局 | 适用场景 | Prompt 要点 |
|------|---------|-------------|
| `九宫格/bento` | 多主题概览 | 3×3 网格，每格一个主题，统一色调 |
| `漏斗/funnel` | 转化、筛选 | 上宽下窄，每层标注数据和标签 |
| `冰山/iceberg` | 表象 vs 本质 | 水面上下分区，上方简单下方复杂 |
| `金字塔/pyramid` | 层级、优先级 | 从底到顶，每层标注 |
| `环形/circular` | 循环流程 | 顺时针箭头连接的环形节点 |
| `矩阵/matrix` | 多维度对比 | 2×2 或 N×N 象限，轴标签 |
| `树状/tree` | 分类、层级 | 根节点→分支→叶节点 |
| `仪表盘/dashboard` | 关键指标 | 数字卡片 + 趋势图 + 状态灯 |
| `路线图/roadmap` | 规划、里程碑 | 蜿蜒路径 + 节点标注 |

**九宫格模板**：

```
[标题] - 九宫格信息图

布局：3×3 网格（或 2×3、2×4）

格子内容：
| [主题1] | [主题2] | [主题3] |
| [主题4] | [主题5] | [主题6] |
| [主题7] | [主题8] | [主题9] |

每格包含：图标 + 标题 + 一句话说明
统一风格：[圆角卡片/方格/无边框]
配色：[语义配色说明]
风格：[选定的风格特征]
比例：[比例，通常 1:1 或 4:3]
```

**漏斗模板**：

```
[标题] - 漏斗图

层数：[N]
方向：从上到下

各层（从宽到窄）：
1. [层名]：[数据/标签]（100%）
2. [层名]：[数据/标签]（60%）
3. [层名]：[数据/标签]（30%）
4. [层名]：[数据/标签]（10%）

配色：渐变色，从顶到底逐渐加深
风格：[选定的风格特征]
比例：[比例，通常 3:4 或 9:16]
```

**冰山模板**：

```
[标题] - 冰山图

水面以上（表象/可见）：
- [可见现象1]
- [可见现象2]

水面以下（本质/隐藏）：
- [隐藏原因1]
- [隐藏原因2]
- [深层逻辑]

水面线：明确标注
配色：水面上明亮，水面下深色
风格：[选定的风格特征]
比例：[比例，通常 3:4]
```

---

## 关键原则

- **补充而非重复**：文字讲道理，图给感觉；文字列数据，图给直觉
- **抽象优于具象**：「AI 赋能」→ 光线连接感 ✅，不要画机器人 ❌
- **情感对齐**：严肃段落配冷色调，轻松段落配暖色明快风
- **一图一个焦点**：不要塞太多元素
- **用文章中的真实数据**：信息图里要放实际数字和术语，不要 placeholder