---
url: /sre/planning/visual-language.md
description: 角色图标、语义配色、何时用静态图 / Mermaid 的短规范，保证系列文插图风格一致。
---

# 站点视觉语言（信息图）

给「基础篇 / 流水线 / DevOps」一类文章用的插图约定。媒体上传与 CDN 仍遵守 [文档媒体规范](./media-standards.md)；本文只管**画什么、什么颜色、什么时候画**。

## 何时用图

| 场景 | 优先 | 说明 |
| --- | --- | --- |
| 角色 / 环境 / 节奏对照（本地 ×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 篇 · 生产环境](../devops/foundation/production-env.md) 中「多次 dev，一次 prod」使用 `diagram-dev-prod-loop.png`，作为本规范的首张样图。