#数据流图（Mermaid 围栏）

#这是什么

和数据流图画的是同一种图，区别只在怎么写：这一页用 ```mermaid 围栏，直接写 Mermaid 自己的图源。

#什么时候用

• 源文档要发到 GitHub，并且希望在 GitHub 上也能看到图——自有写法在那边显示成一段普通文字
• 已经会 Mermaid，不想再学一套
• 需要自有写法表达不了的细节（下面「坑」那一节写明是哪些）

其余情况用自有写法：字段名固定，写错了当场报错并指到具体那一行。

#怎么写

```mermaid
flowchart LR
  作者[作者] -->|方案.md| P1(解析)
  P1 -->|AST| P2(画图)
  P2 -->|SVG| P3(组装)
  D1[(图表缓存)] --- P2
  P3 -->|方案.html| 读者[读者]
```

#出来是什么样

编译时就画成 SVG 内联进产物，读者那边不下载任何绘图库、也不联网。颜色跟着主题走，可以滚轮缩放、按住拖动、双击复位。

#坑

• 数据流图没有专门的语法，用流程图画，靠形状区分角色
• 老规矩：方框是外部的人或系统、圆角是处理步骤、圆柱是存起来的东西
• 箭头上的字是流过去的数据（方案.md、AST），不是动作