---
name: infographic-poster
description: 把知识点、数据或分析结论做成中文信息图海报（横屏 16:9 给电脑、竖屏 9:16 给手机两版），并可一键发布成带图片下载的静态网站。当用户要求「把这份数据做成图」「做个信息图/数据海报」「把知识点画出来」「生成图表」「要手机版/竖屏版」「做成图并上线网站」时使用。核心做法是用 HTML 精确排版 + 无头 chromium 渲染，而不是 AI 生图（生图会写错中文和数字）。
---

# 知识点信息图（HTML 精确排版）

把一段知识、一组数据或一个结论做成图片：**横屏 1920×1080（电脑、文档、PPT）与竖屏 1080×1920（手机、微信、小红书、短视频封面）两版**，需要时再配报告页和图片下载站。

**核心判断：不要用 AI 生图做含中文和数字的图。** 生图模型的文字控制力不足，中文会缺笔画、数字会多一横、标签会串行，反复重试也修不准。正确做法是用 HTML 写版式、无头浏览器渲染成 PNG——文字一字不差、可以精确到像素、改一行数据就重出一版。

## 两种画布（默认两版都给）

| | 横屏 | 竖屏 |
|---|---|---|
| 画布 | 1920×1080（16:9） | 1080×1920（9:16） |
| 场景 | 电脑屏幕、文档、PPT、网页 | 手机聊天、朋友圈、小红书、抖音封面 |
| 骨架 | `assets/template.html` | `assets/template-portrait.html` |
| 排版方向 | 左右分区，可并排对照、可留 25% 侧栏 | 单列自上而下，一律上下堆叠 |
| 信息量 | 一张图讲完整论证 | 一张图只讲主线 + 结论，放不下的删掉 |
| 输出 | `X-4k.png` / `X-1080.png` | `X-portrait-4k.png` / `X-portrait-1080.png` |

**竖屏不是横屏压扁。** 横屏的左右对照在竖屏必须改成上下堆叠；横屏能塞下的三列、侧栏、图例，竖屏一律砍掉。同一份内容两版时，文案可以复用，版式必须重排。

## 何时用哪套版式

| 内容形态 | 版式 | 关键点 |
|---|---|---|
| 多品类对比数值 | 分组柱状图 | 同一层级的品类必须聚成一组，否则序列会「中间最高」 |
| 阶层/漏斗/金字塔 | 分层 + 组间留白 | 层名单独成行，别把层级塞进 X 轴标签 |
| 归因/机制拆解 | 多列推力（竖屏改多段步骤） | 每列：序号 + 标题 + 2-3 行说明 + 一个大数字 |
| 认知转变 | 横屏左右对照 / 竖屏上下对照 | 旧状态用灰、新状态用黑加粗 |
| 时间与阶段 | 里程碑/折线 | 节点少时用点线，节点多时用阶梯 |
| 单一结论 | 大数字 + 一句解释 | 数字 120px 以上，其余留白 |
| 案例拆解 | 一个结论 + N 个生活切片 | 切片用 2 列小格排开，每格一句话，不写长段 |

## 视觉规范（冷眼商业风）

| 项 | 横屏 | 竖屏 |
|---|---|---|
| 外边距 | 64px | 56px（底部留 56-72px 安全区，避开手机界面遮挡） |
| 主标题 | 48-58px | 58-64px，可两行，一行不超过 11 字 |
| 副标题/导语 | 22-27px | 21-23px，一行不超过 28 字 |
| 小节标签 | 15px，字距 2.5px | 15px，字距 2.5px |
| 正文/步骤 | 17-23px | 19-24px |
| 大数字 | 44-48px | 56-72px |
| 结论 | 29-30px | 29-32px，最多两行 |
| 注脚 | 15-16px | 16-17px |
| 字重 | 标题 700，正文 400-500，数字 700 | 同左 |

共用色板：

| 项 | 值 |
|---|---|
| 字体 | `"Noto Sans CJK SC","Noto Sans SC",sans-serif` |
| 墨色 | `#15181C` 正文 / `#74797F` 辅助 / `#9298A0` 注脚 |
| 分割线 | `#E2E5E8`，一律 1px |
| 强调色 | `#C0462A`（橙红，只用于主角与结论） |
| 分类色 | 灰 `#B3B7BB` / 蓝 `#2B5C82` / 橙红 `#C0462A` |
| 浅底 | `#F8F9FA`，只给侧栏与卡片，不加圆角或加 0-2px |

**禁止**：背景网格线、Y/X 轴刻度数字（需要标数值就标在柱顶）、大圆角卡片、阴影、渐变、emoji、装饰性插图。

## 工作流

### 1. 先把数据表格化
把要上图的每个数值写成一行：`颜色 | 所属分组 | 柱子数值 | X 轴标签`。这一步是防止串行的根本——后面每个元素都从同一行数据生成。

### 2. 写 HTML
以 `assets/template.html`（横屏）或 `assets/template-portrait.html`（竖屏）为起点。数值类图表把所有数值放进一个 JS 数组，用循环生成柱体与标签：

```js
const data = [{ pct: 70, color: '#2B5C82', val: '+70%以上', name: '户外休闲衣', tier: '第二层：泛户外' }];
```

**不要手写每个 div 的位置再手填文字**，那样改一处就要改两处，必然对不上。竖屏用 flex 纵向堆叠 + `margin-top` 控制间距，加删内容不会错位。

### 3. 渲染
```bash
# 横屏（默认 1920×1080）
python3 ~/.aicode/skills/infographic-poster/scripts/render.py work/chart.html work/chart
# → work/chart-4k.png (3840×2160) + work/chart-1080.png

# 竖屏（必须显式传 --size）
python3 ~/.aicode/skills/infographic-poster/scripts/render.py work/chart-portrait.html work/chart-portrait --size 1080x1920
# → work/chart-portrait-4k.png (2160×3840) + work/chart-portrait-1080.png
```

两份都要时，横屏前缀用 `X`、竖屏前缀用 `X-portrait`，站点会自动把两版并进同一张卡片。

### 4. 目检（必做）
用 `viewImage` 看图，逐项确认：文字无乱码、数值与标签对应、比例与数据一致、无重叠/裁切（竖屏重点看底部是否被裁、长段是否顶出浅底框）、留白均衡。有问题改 HTML 重渲染，不要"大概没问题"就交付。

### 5. 需要站点时
```bash
python3 ~/.aicode/skills/infographic-poster/scripts/build_site.py --work work --out work/dist \
  --title "站点标题" --kicker "小标签" --lead "一句话导语" [--report work/report.md]
python3 ~/.aicode/skills/infographic-poster/scripts/publish.py --project 项目名 --dist work/dist
```

`build_site.py` 扫描 `work/`：`X-4k.png` + `X-1080.png` 为横版，`X-portrait-4k.png` + `X-portrait-1080.png` 为竖版，同一 `X` 的两版并进一张卡片，各自带 4K / 1080p 下载按钮；图注在 `work/figures.json` 里按 `X` 给 `name` 与 `desc`。有 `report.md` 就同时渲染报告正文和 Markdown 下载。

## 已知坑

- **`/dev/shm` 缺失**：chromium 必须加 `--disable-dev-shm-usage`，否则 FATAL 退出（render.py 已内置）。
- **窗口高度不等于视口高度**：headless 的视口比 `--window-size` 少约 100px，所以窗口高度一律取「画布高 + 120」，再裁切顶部（render.py 已内置）。竖屏即 `1080,2040`。
- **高分屏**：`--force-device-scale-factor=2` 得到 2 倍图，文字边缘才干净。
- **copy 横屏 HTML 改竖屏必踩**：`left/width` 绝对定位全部作废，别微调坐标，直接换 `template-portrait.html` 的纵向骨架重排。
- **竖屏浅底块高度写死会截断**：文字行数一变就溢出框外，用 `padding` 撑高度，别写 `height`。
- **极矮柱子**：个位数百分比（如大盘 +3%）在 150% 量程里只有 10px 高，这是数据真实，不要为了好看抬高，改为在注脚说明「贴近地面」。
- **中文引号**：直引号 `"` 在中文里显得生硬，成对替换为 `“”`。
- **口径混排**：区间值（+3%～+4%）与下限值（+90% 以上）同轴时，柱顶用虚线标出「这是下限」，并在注脚写明。
- **结论里做除法要穷举配对**：用 A 的下限除以 B 的下限时，把全部配对都算一遍，取真实的区间，别只取最好看的那一对。
- **Cloudflare Pages API 直传**：`_redirects` / `_headers` / `_worker.js` 不生效，只有 `404.html` 和「目录/文件名」两种路由可用。

## 文件

- `assets/template.html` — 通用 16:9 横屏骨架（含分组柱状图示例与数据驱动写法）
- `assets/template-portrait.html` — 通用 9:16 竖屏骨架（单列堆叠、步骤卡、结论条）
- `scripts/render.py` — HTML → 2 倍图/1 倍图 PNG，`--size WxH` 切换画布
- `scripts/build_site.py` — 图片画廊（横竖两版同卡）+ 报告页 → 静态站
- `scripts/publish.py` — 发布到 Cloudflare Pages（自动建项目）
- `scripts/hash.mjs` — 发布用的 blake3 哈希
