站点视觉语言（信息图）
给「基础篇 / / DevOps」一类文章用的插图约定。媒体上传与 CDN 仍遵守 文档媒体规范；本文只管画什么、什么颜色、什么时候画。
何时用图
| 场景 | 优先 | 说明 |
|---|---|---|
| 角色 / 环境 / 节奏对照（本地 ×N、生产 ×1） | 静态信息图 | 一眼能读；Mermaid 盒子叠色往往不够 |
| 线性步骤、决策分支（≤ 6 节点） | Mermaid | 改文时同步改图成本低 |
| 命令输出、配置片段 | 代码块 | 不要做成截图式信息图 |
| 动效演示 | 暂不做 | 系列文以静态为主 |
同一段不要「表 + Mermaid + 信息图」三件套全上：表交代事实，图强化记忆；二选一即可。
语义配色
| 语义 | 色相 | 用途 |
|---|---|---|
| 开发 / 本地闭环 | 蓝 #1890ff 系 | 可重复、可失败、可回滚的一侧 |
| 发布 / 生产路径 | 橙 #fa8c16 系 | 验收后通常一次、跨机器的一侧 |
| 中性环境 / 说明 | 灰 #8c8c8c | 标签、箭头辅助、次要标注 |
| 强调 / 次数标记 | 黑字 + 色块角标 | 如 ×N、×1 |
底色浅、线稿清晰；避免紫渐变、大面积阴影、3D。中文标注短词优先（「改代码」「本地预览」「上传」「公网验证」）。
角色与环境图标（约定 ID）
插图与文案里尽量用同一套称呼，方便跨文复用：
| ID | 画法要点 | 文案称呼 |
|---|---|---|
actor.dev | 简笔开发者（笔记本前 / 持键盘） | 开发者 |
env.local | 笔记本 / 本机窗口 | 本地 |
env.server | 云 / 机架小图标 | |
env.public | 地球或浏览器窗 | 公网 / 浏览器 |
后续若加 actor.ops、env.ci，仍走「角色 / 环境」两分，不要混成无角色。
构图建议
- 左右或上下分区：左/上蓝区 = 开发闭环；右/下橙区 = 生产发布。
- 次数角标：蓝区标
×N，橙区标×1（或「通常 1 次」）。 - 一条主路径：满意后从蓝区接到橙区；不要画成两边对等循环。
- 留白：信息图不是海报，少装饰、少口号。
文件与引用
- 本地源：
docs/public/images/img-{slug}/diagram-*.png（大图不进 Git） - 文内引用 CDN：
https://media.xiaolin.fun/docs/img-{slug}/... - 命名：
diagram-{topic}.png或infographic-0N.png（见媒体规范）
样例
第 02 篇 · 生产环境 中「多次 dev，一次 prod」使用 diagram-dev-prod-loop.png，作为本规范的首张样图。