# MAOMOMO 配图与视觉资产规则

需要生成、准备、插入或更新配图时，先读本文件。

## 配图交付原则

- 完整文章默认配独立 PNG：短文章 4-6 张，普通攻略 6-8 张，长教程 / 多活动整理 8-12 张。
- 不为凑数量硬加图；每张图必须服务正文。
- 每张图独立生成或准备，不要用一张拼图、长图或总图代替全部。
- 出图前先把全部图片 prompt 写入 `prompts/` 或 manifest 文件；不要在聊天里输出超长 prompt 代替文件。
- 先只生成一张样张，优先封面图；用户确认样张前不得生成剩余图片。
- 样张确认后，后续图片使用同一生图后端、同一视觉系统和同一质量配置。
- 图片生成按“一张图一个 job / 一次请求 / 一次 QA”推进；运行环境支持子 agent 时，可以一图一个子 agent 并发，但不要一次请求多张图。
- 最终原始图保存到 `origin_image/`，通过 QA 后同步到 Markdown 引用的 `assets/`。
- 生成图必须是“示意图 / 信息图 / 教程视觉”，不得伪造真实 App 截图、账单或官方页面。
- 用户提供真实截图时，优先用真实截图，并隐去姓名、账号、余额、地址、手机号、二维码、交易号等个人信息。
- 每张图必须包含清晰可见的 `MAOMOMO` 标识。
- 每张图的可见文字必须受控：只允许出现该图指定的业务文案和 `MAOMOMO`，不得添加副标题、风格标签、prompt 描述、说明文字、额外 slogan 或无关文字。
- 不要用 Playwright、HTML/CSS、SVG、Pillow、canvas、本地拼贴或手工覆盖文字替代图片生成后端。

## 可见文字与 prompt 边界

- 视觉风格只作为后台画面描述，不得成为画面文字。
- 生成用 prompt 不要写容易被模型照抄到画面里的中文风格标签，例如“暖橙金融教程风”“数据仪表盘风”“手绘便签风”“清爽编辑部风”。
- 把风格名改写成可观察的视觉描述：白底、暖橙强调、信息卡片、猫咪向导、清晰标题、留白充足、表格感、时间线、轻纸感等。
- prompt 必须写明：画面只允许出现指定业务文案和 `MAOMOMO`；不要添加副标题、风格标签、prompt 描述、说明文字、额外 slogan 或无关文字。
- `style` 字段可保留内部风格 ID，例如 `warm-fintech-guide`，但完整 `prompt` 字段里不要把中文风格名当成可见文案写入。

推荐写法：

```text
明亮白底，暖橙强调色，干净信息卡片，友好的白橘猫作为向导，中文标题清楚，画面包含 MAOMOMO 标识。可见文字只允许出现：「先报名，再看门槛和封顶」和「MAOMOMO」。
```

不推荐写法：

```text
MAOMOMO 暖橙金融教程风，画出一张手绘便签风仪表盘图。
```

## 金融卡面与支付网络核对

- 金融活动配图中只要出现信用卡、支付卡、卡组织、支付网络或银行卡样式，必须先根据官方材料、用户截图或用户提供的卡面参考图核对。
- 用户提供卡面参考图时，把原始素材保存到 `sources/`，例如 `sources/gba-unionpay-card-reference.png`；不要只留在聊天上下文里。
- 在 `prompt`、manifest 和 `deck_spec.json` 中记录参考素材路径、卡组织 / 支付网络、是否允许出现卡组织标识，以及核对依据。
- 不得把银联 / UnionPay 卡画成 Mastercard、Visa、American Express 或其他卡组织；不确定时画“无卡组织标识的通用支付卡”。
- 未经用户提供或官方材料确认，不要使用真实银行、卡组织、酒店、OTA 或支付机构 Logo；必要时使用通用卡片、通用 POS、通用酒店图标。
- 如果官方活动限定某卡组织或指定卡面，图片 QA 必须把卡组织 / 支付网络列为必检项。

推荐记录字段：

```json
{
  "reference_assets": ["sources/gba-unionpay-card-reference.png"],
  "payment_network": "UnionPay / 银联",
  "card_art_rule": "根据用户卡面参考图画银联 GBA 双币信用卡；不得出现 Mastercard 或 Visa 标识"
}
```

## 封面信息层级

- 封面只放最高优先级结论和少量核心数字，服务“读者一眼知道这篇讲什么、值不值得点开”。
- 不把复杂计算结论、全年理论上限、长公式、多重限制、详细规则或小字说明塞进封面。
- 计算过程、月度 / 年度理论上限、封顶拆解、资格分支和详细条款，应放到计算图、总览图或正文。
- 封面核心文案建议 1 句主标题 + 1-3 个短数字 / 短标签；如果超过手机端一眼可读的密度，拆到下一张图。

## 金额与币种写法

- 发布稿、图片文案、prompt、manifest、`deck_spec.json`、alt text 和 `speech.md` 中，港币金额统一写 `HKD 1,000`。
- 不使用港币符号写法，例如 `HK$1,000`、`港币 1,000`、`1,000 港币`。
- 来源原文抽取文件、官方截图 OCR 或原文摘录可以保留来源写法；它们不作为发布内容检查对象。
- 如果来源使用港币符号，改写到发布内容时同步转换为 `HKD`。

## 风格选择

如果用户没有指定视觉方向，生成图片前先读 `references/recommended-styles.md`，给 2-3 个可选风格，并推荐一个。确认后，整篇文章的配图保持同一套视觉身份：稳定的配色、猫咪造型、标题区、图标语言和信息密度；不同图片可以根据用途变化构图。

默认推荐逻辑：

- 活动 / 返现 / 港卡攻略：优先 `warm-fintech-guide`。
- 规则、门槛、费用、返现计算和产品对比：优先 `data-card-dashboard`。
- SEO 长文、经验整理、品牌感更强的文章：优先 `clean-editorial`。
- 保姆式教程、避坑经验和轻量操作步骤：优先 `handdrawn-note`。
- 小红书 / 4 图看完：必须用 `xiaohongshu-vertical`，并生成 9:16 竖图。

可选风格：

| 风格名 | 适合场景 | 视觉方向 |
|---|---|---|
| `warm-fintech-guide` | 默认 MAOMOMO 金融攻略、港卡、银行活动 | 白底、暖橙强调色、干净卡片、白橘猫向导 |
| `clean-professional` | 正式规则整理、开户 / 保号教程 | 浅色背景、蓝绿和暖橙强调、可信结构化卡片 |
| `clean-editorial` | SEO 长文、解释型文章、站内封面 | 大标题、留白、轻杂志感、猫咪作为角落品牌元素 |
| `creative-magazine` | 传播型封面、活动盘点 | 大标题、编辑部排版、强留白、原创金融视觉 |
| `data-card-dashboard` | 返现计算、活动对比、费用路径、时间线 | 指标卡、表格感、仪表盘、清晰数字层级 |
| `handdrawn-note` | 避坑、步骤教程、保号经验 | 手绘箭头、便签、圈注、猫咪提示牌 |
| `retro-flat-illustration` | 轻松羊毛攻略、用卡姿势 | 低饱和复古扁平插画、金融小物件 |
| `e-ink-editorial` | 深度解释、观点长文 | 纸感、黑白灰、少量强调色、元信息条 |
| `scientific-defense` | 条款核对、规则证据链 | 严谨浅色版式、来源卡片、条件树 |
| `mckinsey-brief` | 多方案对比、路径选择 | 结论先行、矩阵、取舍图、商业简报感 |
| `xiaohongshu-vertical` | 小红书发布版、4 图看完 | 9:16 竖版、大字少字、强钩子、系列化版式 |

示例确认话术：

```text
我建议用 A，因为这篇是活动攻略，读者最需要快速看懂门槛、封顶和翻车点。

A. warm-fintech-guide（推荐）：白底暖橙、猫咪向导、金融教程感，适合 MAOMOMO 常规文章。
B. data-card-dashboard：更强调数字卡片和计算表，适合门槛 / 返现 / 费用信息密集的文章。
C. handdrawn-note：便签和手绘箭头更明显，适合避坑经验和保姆式步骤。

你选哪个？也可以指定颜色、猫咪比例或是否更像小红书图。
```

## 常见配图类型

| 类型 | 用途 |
|---|---|
| 封面图 | 文章主题、核心利益点 / 核心问题、猫咪识别和产品场景 |
| 总览图 | 活动、产品、规则或教程的核心信息总览 |
| 流程图 | 开户、注册、转账、入金、申请、报名、设置路径 |
| 表格图 / 对比图 | 多产品、多方案、多活动、支持 / 不支持渠道对比 |
| 计算图 | 返现、收益、费用、年化、门槛和封顶测算 |
| 时间线图 | 活动日期、到账时间、任务周期、持有期、截止日 |
| 避坑图 | 常见翻车点、不能补救的点、费用 / 规则 / 时效风险 |
| FAQ 图 | 3-5 个高频问题和简短答案 |

## 图片清单格式

生成图片前先规划清单，并同步写入 `prompts/{article_slug}_XX.json` 或图片 manifest。每个 prompt 文件至少包含：文件名、类型、放置位置、核心文案、可见文字白名单、alt text、风格、依赖素材、输出路径和完整 prompt。涉及信用卡、支付卡或支付网络时，还要包含参考素材、卡组织 / 支付网络和核对依据。

```markdown
| 文件名 | 类型 | 放置位置 | 核心文案 | alt text | 风格 | 依赖素材 |
|---|---|---|---|---|---|---|
| hong-kong-bank-account-01-cover.png | 封面 | 标题下方 | 港卡保号关键点 | MAOMOMO 港卡保号教程封面图 | warm-fintech-guide | 无 |
| hong-kong-bank-account-02-flow.png | 流程图 | 操作步骤前 | 三步完成账户活跃 | 港卡保号操作流程图 | handdrawn-note | 用户截图 1 |
```

确认用户不需要先看清单时，可以不在聊天里展开清单，但仍必须写入 prompt 文件，并遵守“先样张、后逐张生成”的门禁。最终必须让文件名、alt text 和插图位置与正文一致。

推荐单图 prompt JSON：

```json
{
  "id": "hsbc-mastercard-alipay-campaign_01",
  "file_name": "hsbc-mastercard-alipay-campaign-01-cover.png",
  "origin_out": "origin_image/hsbc-mastercard-alipay-campaign-01-cover.png",
  "asset_out": "assets/hsbc-mastercard-alipay-campaign-01-cover.png",
  "type": "封面图",
  "placement": "标题下方",
  "core_text": "先报名，再看门槛和封顶",
  "visible_text_allowed": ["先报名，再看门槛和封顶", "MAOMOMO"],
  "alt_text": "MAOMOMO 汇丰 Mastercard 支付宝返现活动封面图",
  "style": "warm-fintech-guide",
  "required_assets": [],
  "reference_assets": [],
  "payment_network": "",
  "card_art_rule": "如无官方或用户参考素材确认，画无卡组织标识的通用支付卡",
  "forbidden_visible_text": ["风格标签", "prompt 描述", "额外 slogan", "无关说明文字"],
  "prompt": "完整图片生成 prompt，包含视觉描述、指定业务文案、可见文字限制和禁止项"
}
```

## 文件命名

图片文件名必须 SEO 友好，并包含主题前缀：

```text
origin_image/
  hsbc-mastercard-alipay-campaign-01-cover.png
  hsbc-mastercard-alipay-campaign-02-overview.png

assets/
  hsbc-mastercard-alipay-campaign-01-cover.png
  hsbc-mastercard-alipay-campaign-02-overview.png
  hsbc-mastercard-alipay-campaign-03-step-guide.png
  hsbc-mastercard-alipay-campaign-04-comparison.png
  hsbc-mastercard-alipay-campaign-05-calculation.png
  hsbc-mastercard-alipay-campaign-06-timeline.png
  hsbc-mastercard-alipay-campaign-07-common-pitfalls.png
  hsbc-mastercard-alipay-campaign-08-faq.png
```

规则：

- 使用英文小写、数字和连字符。
- 不使用中文文件名。
- 不使用 `01-cover.png`、`02-overview.png` 这类缺少主题前缀的通用文件名。
- 后续改稿删除某个活动分支时，相关文件名、alt text、正文引用和 ZIP 中旧图都要同步清理。

## Markdown 插图

统一使用相对路径：

```markdown
![图片说明](assets/文件名.png)
```

插图位置：

- 封面图放在标题下方。
- 总览图放在活动 / 产品介绍之后。
- 流程图放在步骤段落前后。
- 计算图放在公式或测算表格后。
- 时间线图放在日期说明后。
- 避坑图放在翻车点段落后。
- FAQ 图放在常见问题段落前后。

图片说明必须根据图片内容写，不要都写成“配图”。

`origin_image/` 不直接写进 Markdown，除非用户明确要求引用原始图目录。发布用 Markdown 默认引用 `assets/`。

## 猫咪视觉识别

基础方向：

```text
中文金融实操信息图，干净明亮白色背景，暖橙色点缀，友好的白橘猫吉祥物，圆脸、小爪子，现代 App 信息卡片质感，清晰中文标题和卡片信息层级，实用而非奢华，包含 MAOMOMO 标识，不使用未经提供的真实银行标志，不伪造真实截图。可见文字只允许出现指定业务文案和 MAOMOMO。
```

猫咪可以：

- 指向关键数字。
- 拿着通用卡片。
- 坐在手机、账本、路线图或计算器旁。
- 举“实测”“注意”“先登记”提示牌。

猫咪不能：

- 穿戴或承载第三方银行、卡组织、券商、支付机构 Logo。
- 盖住关键数字、日期、步骤和风险提示。
- 变成幼稚主角，压过金融教程信息。

## 主题追加元素

- 信用卡 / 返现：通用信用卡、小票、购物篮、返现计算器、通用支付符号；只有在官方材料或用户素材确认后，才画具体卡组织 / 支付网络。
- 银行账户 / 保号：账户余额仪表、保险库、日历、警示标、活跃度卡片。
- 转账 / 入金：路线箭头、HKD / EUR / USD 标签、手机转账示意界面、勾选标记。
- 券商活动：股票礼品卡、K 线图、欢迎信封、香港天际线线稿。
- 数字货币：硬件钱包、钱包 App、欧元通道、区块链节点路线；画面克制，避免暴富感。

## 小红书图

用户说“小红书”“4 图看完”“发小红书”时：

- 生成 4 张 9:16 竖版 PNG，不复用文章横版图。
- 每张图有 MAOMOMO 标识或猫咪水印。
- 手机端可读，大字少字。
- 默认结构：封面、核心拆解、操作流程、避坑总结。
- 风格固定为 `xiaohongshu-vertical`，不直接复用横版文章图。

## 图片 QA

每张图通过前检查：

- 样张已被用户确认，后续图片没有切换生图后端或视觉风格。
- 文件真实存在，格式为 PNG。
- `origin_image/` 原始最终图和 `assets/` 发布图对应。
- Markdown 路径能打开对应文件。
- 图片文字清楚，无乱码、错字、截断和多余文案。
- 可见文字只包含指定业务文案和 `MAOMOMO`，没有副标题、风格说明文字、prompt 描述、额外 slogan 或无关说明。
- 标题、金额、币种、日期、公式、规则与最终文章口径一致；港币金额发布写法统一为 `HKD`。
- 卡组织 / 支付网络与官方材料或用户参考素材一致；银联 / UnionPay 不得被画成 Mastercard、Visa 或其他卡组织。
- 没有出现用户已删除、已排除或禁止使用的活动分支、旧版规则、旧金额或旧标题。
- 没有真实个人信息。
- 没有伪造官方 App 页面或未经授权的品牌 Logo 场景。
- 没有把示意图伪装成真实截图、账单、订单、App 页面或官方页面。
- 每张图独立主题明确，不是同一画面的机械变体。
- 单张 QA 通过后，才用 `scripts/maomomo_job_state.py result` 记录结果并同步到 `assets/`；不得只生成到 `origin_image/` 后声称完成。
- `article.md` 已插入对应章节，且用脚本检查 Markdown 中所有图片路径真实存在。
- `slide_jobs.json` / `slide_run_state.json` 中没有未处理的 `pending`、`dispatched` 或 `blocked` job；如有，不能声称完整交付完成。

路径检查命令：

```bash
uv run python scripts/maomomo_check_markdown_assets.py article/article.md
```