架构图与流程图绘制方法

核心理念

任何图表的本质是信息结构的视觉化表达。图表中的每个节点承载一个信息实体，每条连线承载一种实体关系，每个容器承载一层逻辑边界。绘制图表不是"用工具画图"，而是先理解信息结构，再选择合适的视觉编码将其映射为可渲染的SVG或Mermaid。

图表类型由信息结构决定——有层次用架构图，有顺序用流程图，有交互用时序图，有状态转换用状态机图。选错类型会让信息表达失真。

适用范围广泛。 任何有实体和关系的信息结构（系统架构、业务流程、数据模型、网络拓扑、状态转换、时序交互）都可以用本方法可视化。

绘制三步法

第一步：分析信息结构

从用户描述中提取核心信息：

1. 识别实体：找出所有独立的信息单元（组件、状态、角色、表、节点）
2. 识别关系：找出实体间的连接（调用、依赖、包含、时序、数据流）
3. 识别层次：找出实体的归属关系（哪个属于哪个模块/层/泳道）

实体判定准则：如果去掉某个元素后信息不完整，它就是实体；如果去掉后信息仍然完整，它就是装饰。

数量控制：单张图实体≤20个。超出时拆分为多张子图，用概览图+细节图的方式表达。

第二步：选择图表类型与编码方案

根据信息结构特征选择最匹配的图表类型：

确定类型后，选定编码方案：

• 颜色编码：不同类型实体用不同颜色
• 形状编码：矩形=组件、菱形=决策、圆柱=数据库、椭圆=状态
• 线型编码：实线=调用、虚线=依赖、粗线=主要路径、细线=次要路径

第三步：布局计算与渲染输出

1. 布局计算：根据层次关系确定节点位置，确保同层对齐、跨层连线不交叉
2. SVG/Mermaid生成：按编码方案生成可渲染代码
3. 可读性优化：调整间距、减少交叉、确保文字清晰

验证清单

绘制完成后逐项验证，七项全部通过才算完成：

领域要求清单

D0-01 系统架构图

• 必选组件: 系统名称、组件列表（名称+职责）、层次划分（前端/后端/数据层/基础设施）、组件间接口关系、外部系统边界
• 可选组件: 技术栈标注、部署环境标注、数据流向标注、安全边界标注
• 组装顺序: 系统边界确认→层次划分→组件识别→接口关系标注→技术栈标注→布局计算→渲染
• 约束: 同层组件水平对齐；跨层关系垂直连线；单张图≤20个节点
• 格式: SVG（show_widget渲染）或Mermaid代码块

D0-02 业务流程图

• 必选组件: 流程名称、步骤列表（名称+角色+输入+输出）、步骤顺序、决策分支、开始/结束节点
• 可选组件: 泳道划分、异常处理路径、并行分支、超时/重试逻辑
• 组装顺序: 流程边界确认→步骤识别→顺序排列→决策分支标注→泳道划分→布局计算→渲染
• 约束: 决策节点用菱形；是/否分支必须标注；循环必须有终止条件
• 格式: SVG或Mermaid flowchart

D0-03 时序图

• 必选组件: 参与者列表、消息序列（发送方→接收方+消息名）、时序顺序、返回消息
• 可选组件: 生命线激活区间、条件分支（alt/opt/loop）、自调用、创建/销毁标记
• 组装顺序: 参与者识别→消息序列排列→返回消息标注→条件分支标注→布局计算→渲染
• 约束: 时间轴从上到下；同步消息用实线箭头；异步消息用开放箭头
• 格式: SVG或Mermaid sequenceDiagram

D0-04 状态机图

• 必选组件: 状态列表（名称+是否终态）、转换关系（源状态+事件+目标状态）、初始状态标记
• 可选组件: 守卫条件、进入/退出动作、历史状态、嵌套子状态
• 组装顺序: 状态识别→转换关系排列→初始/终态标注→守卫条件标注→布局计算→渲染
• 约束: 初始状态用实心圆；终态用双圆；转换箭头标注事件名
• 格式: SVG或Mermaid stateDiagram-v2

D0-05 ER图

• 必选组件: 实体列表（名称+属性）、主键标注、关系类型（1:1/1:N/M:N）、关系连线
• 可选组件: 外键标注、属性类型、弱实体、复合属性
• 组装顺序: 实体识别→属性列举→主键标注→关系识别→基数标注→布局计算→渲染
• 约束: 实体用矩形；属性用椭圆；关系用菱形；基数必须标注
• 格式: SVG或Mermaid erDiagram

D0-06 网络拓扑图

• 必选组件: 节点列表（设备类型+名称+IP）、链路关系、网络层级（核心/汇聚/接入）
• 可选组件: 带宽标注、VLAN划分、安全区域、冗余链路
• 组装顺序: 网络层级确认→节点识别→链路关系标注→IP/带宽标注→布局计算→渲染
• 约束: 同层节点水平排列；层级间垂直连接；冗余链路用虚线
• 格式: SVG

D0-07 数据流图

• 必选组件: 数据源、处理节点、数据存储、数据流（方向+内容）、输出
• 可选组件: 转换规则、过滤条件、分支/合并、监控点
• 组装顺序: 数据源识别→处理步骤排列→存储节点标注→数据流方向标注→布局计算→渲染
• 约束: 数据源用矩形；处理用圆角矩形；存储用圆柱形；流向用箭头
• 格式: SVG或Mermaid flowchart

D0-08 类图

• 必选组件: 类列表（名称+属性+方法）、继承关系、关联关系
• 可选组件: 接口、抽象类、多重性标注、依赖关系、组合/聚合关系
• 组装顺序: 类识别→属性/方法列举→继承关系标注→关联关系标注→布局计算→渲染
• 约束: 类名用粗体；抽象类用斜体；接口用\x3C\x3Cinterface>>标注
• 格式: SVG或Mermaid classDiagram

领域范本

DF-01 图表绘制范本

对应任务: D0-01 ~ D0-08

适用场景: 任何需要将信息结构可视化为图表的场景

绘制范本:

## 图表绘制记录

### Step 1：分析信息结构（D0-0X）

**图表类型**：________（如：系统架构图/业务流程图/时序图/________）

**实体列表**：

| # | 实体名称 | 类型 | 属性/说明 | 所属层次 |
|---|----------|------|----------|---------|
| 1 | ________ | ________ | ________ | ________ |
| 2 | ________ | ________ | ________ | ________ |
| ... | ... | ... | ... | ... |

**关系列表**：

| # | 源实体 | 目标实体 | 关系类型 | 说明 |
|---|--------|---------|---------|------|
| 1 | ________ | ________ | ________ | ________ |
| 2 | ________ | ________ | ________ | ________ |
| ... | ... | ... | ... | ... |

**汇总**：___个实体 / ___个关系 / ___个层次

### Step 2：选择编码方案（D0-0X）

**颜色编码**：

| 实体类型 | 颜色 |
|---------|------|
| ________ | #______ |
| ________ | #______ |

**形状编码**：

| 元素类型 | 形状 |
|---------|------|
| 组件 | 矩形 |
| 决策 | 菱形 |
| 数据库 | 圆柱 |
| ... | ... |

**线型编码**：

| 关系类型 | 线型 | 箭头 |
|---------|------|------|
| 调用 | 实线 | 实心三角 |
| 依赖 | 虚线 | 开放三角 |
| ... | ... | ... |

### Step 3：布局与渲染（D0-0X）

**布局方案**：________（层次布局/网格布局/泳道布局）

| 实体 | X | Y | 宽 | 高 |
|------|---|---|----|----|
| ________ | ___ | ___ | ___ | ___ |
| ... | ... | ... | ... | ... |

### Step 4：验证（D0-0X）

| # | 验证项 | 通过？ |
|---|--------|-------|
| 1 | 信息完整性 | ⬜是/⬜否 |
| 2 | 类型匹配 | ⬜是/⬜否 |
| 3 | 层次清晰 | ⬜是/⬜否 |
| 4 | 关系准确 | ⬜是/⬜否 |
| 5 | 可读性 | ⬜是/⬜否 |
| 6 | 编码一致 | ⬜是/⬜否 |
| 7 | 可渲染 | ⬜是/⬜否 |

范本要点:

• 实体必须来自信息结构本身，不可凭空添加
• 编码方案必须全图一致，不可中途变换
• 验证七项必须全部通过
• 范本中 ________ 为待用户提供的内容，不可AI编造

图表类型SVG骨架

通用设计参数

1. 系统架构图（分层架构）

\x3Csvg viewBox="0 0 680 420" xmlns="http://www.w3.org/2000/svg" font-family="sans-serif">
  \x3Cdefs>
    \x3Cmarker id="arrow" markerWidth="10" markerHeight="7" refX="10" refY="3.5" orient="auto">
      \x3Cpolygon points="0 0, 10 3.5, 0 7" fill="#555"/>
    \x3C/marker>
  \x3C/defs>
  \x3Ctext x="340" y="28" text-anchor="middle" font-size="16" font-weight="bold" fill="#1a1a2e">系统架构图\x3C/text>
  \x3C!-- 前端层 -->
  \x3Crect x="40" y="50" width="600" height="70" rx="8" fill="#e8f4f8" stroke="#4a90d9" stroke-width="1.5"/>
  \x3Ctext x="60" y="75" font-size="12" fill="#555">前端层\x3C/text>
  \x3Crect x="80" y="80" width="120" height="30" rx="5" fill="#4a90d9"/>
  \x3Ctext x="140" y="100" text-anchor="middle" font-size="12" fill="white">Web App\x3C/text>
  \x3Crect x="230" y="80" width="120" height="30" rx="5" fill="#4a90d9"/>
  \x3Ctext x="290" y="100" text-anchor="middle" font-size="12" fill="white">Mobile App\x3C/text>
  \x3Cline x1="340" y1="120" x2="340" y2="150" stroke="#555" stroke-width="1.5" marker-end="url(#arrow)"/>
  \x3C!-- 后端层 -->
  \x3Crect x="40" y="150" width="600" height="70" rx="8" fill="#f0f7ee" stroke="#5ba55b" stroke-width="1.5"/>
  \x3Ctext x="60" y="175" font-size="12" fill="#555">后端层\x3C/text>
  \x3Crect x="80" y="180" width="120" height="30" rx="5" fill="#5ba55b"/>
  \x3Ctext x="140" y="200" text-anchor="middle" font-size="12" fill="white">API Gateway\x3C/text>
  \x3Crect x="230" y="180" width="120" height="30" rx="5" fill="#5ba55b"/>
  \x3Ctext x="290" y="200" text-anchor="middle" font-size="12" fill="white">业务服务\x3C/text>
  \x3Crect x="380" y="180" width="120" height="30" rx="5" fill="#5ba55b"/>
  \x3Ctext x="440" y="200" text-anchor="middle" font-size="12" fill="white">认证服务\x3C/text>
  \x3Cline x1="340" y1="220" x2="340" y2="250" stroke="#555" stroke-width="1.5" marker-end="url(#arrow)"/>
  \x3C!-- 数据层 -->
  \x3Crect x="40" y="250" width="600" height="70" rx="8" fill="#fff3e0" stroke="#e67e22" stroke-width="1.5"/>
  \x3Ctext x="60" y="275" font-size="12" fill="#555">数据层\x3C/text>
  \x3Crect x="80" y="280" width="120" height="30" rx="5" fill="#e67e22"/>
  \x3Ctext x="140" y="300" text-anchor="middle" font-size="12" fill="white">MySQL\x3C/text>
  \x3Crect x="230" y="280" width="120" height="30" rx="5" fill="#e67e22"/>
  \x3Ctext x="290" y="300" text-anchor="middle" font-size="12" fill="white">Redis\x3C/text>
  \x3Crect x="380" y="280" width="120" height="30" rx="5" fill="#e67e22"/>
  \x3Ctext x="440" y="300" text-anchor="middle" font-size="12" fill="white">Elasticsearch\x3C/text>
  \x3Cline x1="340" y1="320" x2="340" y2="350" stroke="#555" stroke-width="1.5" marker-end="url(#arrow)"/>
  \x3C!-- 基础设施层 -->
  \x3Crect x="40" y="350" width="600" height="50" rx="8" fill="#f3e5f5" stroke="#9b59b6" stroke-width="1.5"/>
  \x3Ctext x="60" y="370" font-size="12" fill="#555">基础设施\x3C/text>
  \x3Ctext x="340" y="382" text-anchor="middle" font-size="12" fill="#7d3c98">Kubernetes / Docker / 云平台\x3C/text>
\x3C/svg>

设计要点：

• 每层用不同背景色区分（蓝/绿/橙/紫）
• 层间用竖向箭头连接
• 同层组件横向排列，间距均匀

2. 微服务架构图

设计要点：

• 以 API Gateway 为中心
• 各微服务使用圆角矩形，颜色统一
• 消息队列（MQ）用平行四边形或圆柱体表示
• 数据库用圆柱体表示（ellipse + 矩形组合）
• 服务间通信用不同颜色箭头区分（同步=实线，异步=虚线）

SVG 骨架关键元素：

\x3C!-- 圆柱形数据库 -->
\x3Cellipse cx="200" cy="360" rx="50" ry="12" fill="#e67e22"/>
\x3Crect x="150" y="360" width="100" height="40" fill="#e67e22"/>
\x3Cellipse cx="200" cy="400" rx="50" ry="12" fill="#d35400"/>
\x3Ctext x="200" y="385" text-anchor="middle" font-size="11" fill="white">数据库名\x3C/text>
\x3C!-- 虚线箭头（异步） -->
\x3Cline x1="x1" y1="y1" x2="x2" y2="y2" stroke="#999" stroke-width="1.5"
      stroke-dasharray="6,3" marker-end="url(#arrow)"/>

3. 网络拓扑图

设计要点：

• 节点用圆形（\x3Ccircle>）表示网络设备
• 在圆内/圆下放图标或文字
• 连线用灰色实线，标注带宽/协议
• 按网络层次布局（互联网 → DMZ → 内网 → 核心）

SVG 骨架关键元素：

\x3C!-- 网络节点 -->
\x3Ccircle cx="340" cy="80" r="30" fill="#3498db" stroke="white" stroke-width="2"/>
\x3Ctext x="340" y="85" text-anchor="middle" font-size="11" fill="white">互联网\x3C/text>
\x3C!-- 防火墙（菱形） -->
\x3Cpolygon points="340,130 370,155 340,180 310,155" fill="#e74c3c"/>
\x3Ctext x="340" y="160" text-anchor="middle" font-size="10" fill="white">防火墙\x3C/text>
\x3C!-- 连线带标注 -->
\x3Cline x1="340" y1="110" x2="340" y2="130" stroke="#555" stroke-width="2"/>
\x3Ctext x="355" y="122" font-size="10" fill="#777">1Gbps\x3C/text>

4. 业务流程图（泳道图）

设计要点：

• 垂直或水平泳道划分角色
• 开始/结束：圆形（\x3Ccircle>）
• 流程步骤：矩形（\x3Crect>）
• 决策：菱形（\x3Cpolygon>）
• 箭头连接，分支标注"是/否"

SVG 骨架关键元素：

\x3C!-- 泳道背景 -->
\x3Crect x="40" y="40" width="190" height="500" fill="#f8f9fa" stroke="#dee2e6"/>
\x3Ctext x="135" y="65" text-anchor="middle" font-size="13" font-weight="bold" fill="#495057">用户\x3C/text>
\x3C!-- 开始节点 -->
\x3Ccircle cx="135" cy="100" r="20" fill="#2ecc71"/>
\x3Ctext x="135" y="105" text-anchor="middle" font-size="12" fill="white">开始\x3C/text>
\x3C!-- 决策菱形 -->
\x3Cpolygon points="135,200 175,230 135,260 95,230" fill="#f39c12"/>
\x3Ctext x="135" y="234" text-anchor="middle" font-size="11" fill="white">审核通过?\x3C/text>
\x3Ctext x="180" y="225" font-size="10" fill="#555">是\x3C/text>
\x3Ctext x="95" y="255" font-size="10" fill="#555">否\x3C/text>

5. 数据流图（DFD）

设计要点：

• 外部实体：矩形（方形角）
• 处理过程：圆角矩形或圆形
• 数据存储：两条平行横线加矩形（或圆柱）
• 数据流：带标注的有向箭头

\x3C!-- 数据存储（两横线样式） -->
\x3Cline x1="260" y1="240" x2="420" y2="240" stroke="#555" stroke-width="1.5"/>
\x3Cline x1="260" y1="270" x2="420" y2="270" stroke="#555" stroke-width="1.5"/>
\x3Ctext x="340" y="260" text-anchor="middle" font-size="12" fill="#333">D1: 用户数据库\x3C/text>

6. 时序图（Sequence Diagram）

设计要点：

• 角色在顶部，用矩形+标签表示
• 生命线为竖向虚线
• 消息为水平箭头，同步用实线，异步用虚线
• 激活框（activation bar）用细高矩形表示

\x3C!-- 角色 -->
\x3Crect x="60" y="30" width="80" height="30" rx="4" fill="#3498db"/>
\x3Ctext x="100" y="50" text-anchor="middle" font-size="12" fill="white">客户端\x3C/text>
\x3C!-- 生命线 -->
\x3Cline x1="100" y1="60" x2="100" y2="450" stroke="#aaa" stroke-width="1" stroke-dasharray="4,3"/>
\x3C!-- 消息箭头 -->
\x3Cline x1="100" y1="100" x2="280" y2="100" stroke="#2c3e50" stroke-width="1.5" marker-end="url(#arrow)"/>
\x3Ctext x="190" y="95" text-anchor="middle" font-size="11" fill="#555">HTTP 请求\x3C/text>

7. 状态机图（State Machine）

设计要点：

• 状态：圆角矩形（rx="20"）
• 初始状态：实心圆（\x3Ccircle fill="black">）
• 终止状态：双圆（内圆 + 外圆）
• 转换：带标注的曲线或直线箭头

\x3C!-- 状态节点 -->
\x3Crect x="120" y="80" width="100" height="40" rx="20" fill="#3498db" stroke="#2980b9" stroke-width="1.5"/>
\x3Ctext x="170" y="105" text-anchor="middle" font-size="13" fill="white">待支付\x3C/text>
\x3C!-- 初始状态 -->
\x3Ccircle cx="170" cy="50" r="10" fill="#2c3e50"/>
\x3Cline x1="170" y1="60" x2="170" y2="80" stroke="#2c3e50" stroke-width="1.5" marker-end="url(#arrow)"/>
\x3C!-- 终止状态 -->
\x3Ccircle cx="170" cy="400" r="14" fill="none" stroke="#2c3e50" stroke-width="2"/>
\x3Ccircle cx="170" cy="400" r="9" fill="#2c3e50"/>

8. ER 图（实体关系图）

设计要点：

• 实体：矩形，标题栏 + 属性列表
• 主键：加粗或下划线
• 关系线：端点用菱形/竖线/叉表示基数（1:1 / 1:N / M:N）
• 属性较多时可折叠展示部分

\x3C!-- 实体 -->
\x3Crect x="60" y="80" width="160" height="140" rx="6" fill="white" stroke="#3498db" stroke-width="2"/>
\x3Crect x="60" y="80" width="160" height="32" rx="6" fill="#3498db"/>
\x3Crect x="60" y="96" width="160" height="16" fill="#3498db"/>
\x3Ctext x="140" y="101" text-anchor="middle" font-size="13" font-weight="bold" fill="white">User\x3C/text>
\x3Cline x1="60" y1="112" x2="220" y2="112" stroke="#3498db" stroke-width="1"/>
\x3Ctext x="75" y="132" font-size="12" fill="#333" font-weight="bold">🔑 id\x3C/text>
\x3Ctext x="75" y="152" font-size="12" fill="#555">name\x3C/text>
\x3Ctext x="75" y="172" font-size="12" fill="#555">email\x3C/text>
\x3Ctext x="75" y="192" font-size="12" fill="#555">created_at\x3C/text>

SVG渲染规范

箭头Marker规范

核心原则：

1. 路径必须朝右（+x 方向）

   • orient="auto" 将 marker 的 x 轴沿线的方向旋转
   • marker 路径的尖端必须指向 +x 方向

   正确：尖端在右侧
     M1 2L8 5L1 8     ←—— 尖端在 x=8，朝右
   
   错误：尖端在下方  
     M1 2L5 8L9 2     ←—— 尖端在 y=8，朝下
   

2. markerWidth/markerHeight ≥ viewBox

   viewBox	错误的 markerWidth/Height	正确的	后果
   0 0 10 10	6	8 或 10	用 6 时 viewBox 被压缩，路径超出视口被裁切
   0 0 10 10	12	正常但偏大	用 12 时留了 margin，也 OK

3. refX/refY 精确对齐

   marker 参数	值	含义
   refX	8	尖端 x 坐标，与线尾对接
   refY	5	箭头垂直中心，保持居中
   orient	"auto"	按线的方向自动旋转

常见错误与修复：

完整向下箭头定义：

\x3Cdefs>
  \x3Cmarker id="arrow-down"
    viewBox="0 0 10 10"
    refX="8"
    refY="5"
    markerWidth="8"
    markerHeight="8"
    orient="auto">
    \x3Cpath d="M1 2L8 5L1 8"
      fill="none"
      stroke="context-stroke"
      stroke-width="1.5"
      stroke-linecap="round"
      stroke-linejoin="round"/>
  \x3C/marker>
\x3C/defs>

\x3C!-- 竖线：箭头自动朝下 -->
\x3Cline x1="340" y1="168" x2="340" y2="206"
  stroke="#888" stroke-width="1.8" marker-end="url(#arrow-down)"/>

\x3C!-- 横线（如图例行内）：orient="auto" 自动适配为朝右 -->
\x3Cline x1="526" y1="11" x2="544" y2="11"
  stroke="#888" stroke-width="1.8" marker-end="url(#arrow-down)"/>

箭头尺寸选择：

分层架构图布局规范

布局参数表：

分层结构模板：

每层由三部分构成：

┌─ 分组框（虚线圆角矩形，stroke-dasharray="6 3"，rx="10"）─┐
│  [层号标签]  ← 左上角小字                                          │
│  ┌────── 标题条（胶囊形 rx="16"）──────────┐                        │
│  │  第N层：层名                              │                       │
│  └──────────────────────────────────────┘                           │
│  ┌────────┐  ┌────────┐  ┌────────┐                                │
│  │ 组件A  │  │ 组件B  │  │ 组件C  │                                │
│  │副标题  │  │副标题  │  │副标题  │                                │
│  └────────┘  └────────┘  └────────┘                                │
└─────────────────────────────────────────────────────┘
         │  ← 箭头 40px 间距
         ▼
┌─ 分组框（下一层）─────────────────────────────────┐
│  ...                                               │

坐标系计算（5层示例）：

viewBox 高度 = 图例底部 + 16px 余量，向上取整。

层标题 y = 12  (viewBox 内首个元素位置)
层标题 h = 32  (胶囊形标题条)

组件 y   = 层标题 y - 分组框 y + 58
         = (分组框内标题条高度 32 + 组件上方间距 14 + 填充 12)
组件 h   = 44  (标准组件)

分组框 y = 层标题 y - 12   (上方 12px 填充)
分组框 h = 120  (12px 上填充 + 32 标题 + 14 间隔 + 44 组件 + 12 下填充 = 114 → 取整)

// 层间距
层 N 框底 = 分组框_y + 120
箭头起点 = 层 N 框底 + 8
箭头终点 = 箭头起点 + 24 = 层 N+1 框顶 - 8
层 N+1 框顶 = 箭头终点 + 8

5层架构实际坐标（viewBox="0 0 680 910"）：

存储层特殊处理：含两行组件（44px + 28px），分组框高度 = 152px。

分组框 CSS 类定义：

\x3Cstyle>
  .layer-box {
    fill: none;
    stroke: #B0B0B0;
    stroke-width: 1.2;
    stroke-dasharray: 6 3;
  }
  .layer-badge {
    font: 500 11px sans-serif;
    fill: #666;
  }
\x3C/style>

\x3C!-- 使用示例 -->
\x3Crect class="layer-box" x="28" y="40" width="624" height="120" rx="10"/>
\x3Ctext class="layer-badge" x="40" y="54">第1层\x3C/text>

层间箭头：

\x3Cstyle>
  .arr-down {
    stroke: #888;
    stroke-width: 1.8;
    marker-end: url(#arrow-down);
    fill: none;
  }
\x3C/style>

\x3C!-- L1→L2，40px 箭身 -->
\x3Cline x1="340" y1="168" x2="340" y2="206" class="arr-down"/>

图例布局：

图例放在最底部，横排紧凑展示所有类别。

┌─ 图例框（浅灰填充，无虚线）──────────────────────────┐
│ 图例  ■ 用户交互  ■ 引擎处理  ■ AI执行  ■ 工具调用  ■ 存储层  → 层间调用 │
└────────────────────────────────────────────────────┘

关键约束：

• 图例 y 坐标 = 最下层框底 + 16px
• 图例行内箭头使用与主图相同的 marker（orient="auto" 自动适配水平方向）
• 图例高度 ≤30px，给主图留更多空间

viewBox 高度计算公式：

viewBox_H = 图例底部_y + 16
         = (最下层框底_y + 16) + 图例高度 + 16
         = 864 + 16 + 22 + 16 = 918
         → 取整 920（或保守一点取 910，只要箭头和图例都能完整显示）

原则：viewBox 高度宁可多留 10px，也不要让任何元素被裁切。

设计规范

• 颜色：加载read_me diagram后按CSS变量定义使用
• 字体：font-family="sans-serif"
• 间距：组件间距≥16px，文字与边框间距≥8px
• 图例：复杂图表右下角添加图例说明

Mermaid语法参考

流程图（Flowchart）

flowchart TD
    A([开始]) --> B[步骤一]
    B --> C{判断条件}
    C -->|是| D[步骤二A]
    C -->|否| E[步骤二B]
    D --> F([结束])
    E --> F

    %% 样式
    style A fill:#2ecc71,color:white
    style F fill:#e74c3c,color:white
    style C fill:#f39c12,color:white

节点形状：

方向：TD（上下）、LR（左右）、BT（下上）、RL（右左）

时序图（Sequence Diagram）

sequenceDiagram
    autonumber
    participant C as 客户端
    participant G as API Gateway
    participant S as 业务服务
    participant D as 数据库

    C->>G: POST /api/login
    G->>S: 验证请求
    S->>D: 查询用户
    D-->>S: 返回用户数据
    S->>S: 校验密码
    alt 登录成功
        S-->>G: 返回 Token
        G-->>C: 200 OK {token}
    else 登录失败
        S-->>G: 认证失败
        G-->>C: 401 Unauthorized
    end

消息类型：

• A->>B: 消息 — 实线箭头（同步）
• A-->>B: 消息 — 虚线箭头（返回/异步）
• A-)B: 消息 — 异步（无箭头实线）
• A-xB: 消息 — 带 × 的箭头（失败）

控制块：

loop 每10秒轮询
    ...
end

alt 条件A
    ...
else 条件B
    ...
end

opt 可选操作
    ...
end

par 并行操作1
    ...
and 并行操作2
    ...
end

状态机（State Diagram v2）

stateDiagram-v2
    [*] --> 待支付
    待支付 --> 已支付 : 用户支付
    待支付 --> 已取消 : 超时/主动取消
    已支付 --> 发货中 : 商家发货
    发货中 --> 已完成 : 确认收货
    发货中 --> 退款中 : 申请退款
    退款中 --> 已退款 : 退款成功
    已完成 --> [*]
    已取消 --> [*]
    已退款 --> [*]

    note right of 发货中
        物流跟踪中
    end note

ER 图（Entity Relationship）

erDiagram
    USER {
        int id PK
        string name
        string email
        datetime created_at
    }
    ORDER {
        int id PK
        int user_id FK
        decimal total_amount
        string status
        datetime order_time
    }
    ORDER_ITEM {
        int id PK
        int order_id FK
        int product_id FK
        int quantity
        decimal unit_price
    }
    PRODUCT {
        int id PK
        string name
        decimal price
        int stock
    }

    USER ||--o{ ORDER : "下单"
    ORDER ||--|{ ORDER_ITEM : "包含"
    PRODUCT ||--o{ ORDER_ITEM : "被订购"

基数符号：

类图（Class Diagram）

classDiagram
    class Animal {
        +String name
        +int age
        +makeSound() void
    }
    class Dog {
        +String breed
        +fetch() void
    }
    class Cat {
        +bool indoor
        +purr() void
    }
    Animal \x3C|-- Dog : 继承
    Animal \x3C|-- Cat : 继承
    Dog "1" --> "0..*" Owner : 属于

    class Owner {
        +String name
        +adoptPet(animal: Animal) void
    }

甘特图（Gantt）

gantt
    title 项目开发计划
    dateFormat YYYY-MM-DD
    section 需求阶段
    需求调研     :a1, 2026-05-01, 7d
    需求评审     :a2, after a1, 3d
    section 开发阶段
    后端开发     :b1, after a2, 14d
    前端开发     :b2, after a2, 14d
    section 测试阶段
    集成测试     :c1, after b1, 7d
    UAT 测试     :c2, after c1, 5d
    section 发布
    上线部署     :d1, after c2, 2d

饼图（Pie Chart）

pie title 技术栈分布
    "后端" : 35
    "前端" : 30
    "DevOps" : 20
    "数据" : 15

思维导图（Mindmap）

mindmap
  root((系统架构))
    前端
      Web App
        React
        Vue
      Mobile App
        iOS
        Android
    后端
      API Gateway
      微服务
        用户服务
        订单服务
        支付服务
    数据层
      MySQL
      Redis
      Elasticsearch
    基础设施
      Kubernetes
      CI/CD
      监控告警

常用技巧

添加链接：

A --> B
click A "https://example.com" "跳转说明"

子图（Subgraph）：

flowchart LR
    subgraph 前端
        A[Web] & B[Mobile]
    end
    subgraph 后端
        C[API] --> D[服务]
    end
    A & B --> C

自定义样式：

style nodeId fill:#color,stroke:#color,color:#color
classDef myClass fill:#f9f,stroke:#333
class nodeId myClass

图表配置：

%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#3498db'}}}%%

可用主题：base、default、dark、forest、neutral

使用规则

1. 判断图表类型：根据信息特征选择最匹配的图表类型
2. 按三步执行：分析信息结构→选择编码方案→布局渲染
3. 产出交付：按领域要求清单逐项填充，或按DF-01范本结构替换实际内容
4. 渲染输出：优先show_widget内联SVG；需嵌入文档时用Mermaid代码块
5. 用户主权：AI产出的图表是起点，用户对布局、颜色、实体选取有调整权

事实纪律

1. 图表类型选择必须基于信息结构特征，不得因"好看"选择不匹配的类型
2. 实体数量必须控制在合理范围内（单图≤20），超出时拆分为多张子图
3. SVG输出必须经过可渲染验证，不可输出无效标记
4. 涉及敏感信息的图表必须标注脱敏要求