用途:当关系、阶段或边界用图更易理解时使用 Mermaid 图表,替代冗长文字;简单改动或单一事实仍用文字即可。绘图前先核对相关实现或设计,说明图表描述的是当前行为、提案还是前后对比。
主要能力:展示重要关系与主要边界而非所有函数;子图按阶段或边界命名;实线箭头表示已实现连接,虚线箭头表示待接入或未连接集成;箭头用短动词或条件标注;用文字表达异步行为,不借用虚线;明确标注阻塞项、缺失连接与超范围工作。
使用方式:使用原生 Markdown mermaid 代码块,优先 flowchart TB,需要顺序说明时换用其他图表类型;YAML frontmatter 中启用 htmlLabels: true;节点用 <b>...</b> 短粗标题,用 <br/> 分隔补充行,每行约 15–25 字符,每节点约 2–3 行;配色含义:蓝为 API/配置/持久状态,紫为运维输入/密钥/外部依赖,青为处理与受保护操作,琥珀为门禁与阻塞条件,灰配虚线边框为待接入或超范围。
限制:避免长单行标签、固定宽度 HTML 容器、复杂内联 CSS 与过多文字,过满时拆分为多个聚焦视图;公开文档或 PR 中不得包含机密细节;验证需区分文字审阅、Mermaid 语法检查与渲染后视觉检查,若无法渲染应明确说明,不得称已完成视觉验证;图表检查不能证明运行时行为。