把一段知识、一组数据或一个结论做成图片:横屏 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 数组,用循环生成柱体与标签:
const data = [{ pct: 70, color: '#2B5C82', val: '+70%以上', name: '户外休闲衣', tier: '第二层:泛户外' }];
不要手写每个 div 的位置再手填文字,那样改一处就要改两处,必然对不上。竖屏用 flex 纵向堆叠 + margin-top 控制间距,加删内容不会错位。
3. 渲染
# 横屏(默认 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. 需要站点时
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 哈希

