罗老师 Mermaid 图解助手

问题从哪来

技术文档、流程说明和方案讨论里，常见「一大段话」：步骤嵌在段落里、系统调用顺序要靠脑补、状态切换没有一张总览。你真正需要的是能贴进飞书、Obsidian、GitHub 或演示稿的结构图，而不是一段「看起来对」却从未跑通的 Mermaid 片段。

技能怎么做事

助手会先把你给的材料压成一句中心问题，再按问题类型选图型（例如顺序推进用 flowchart，多系统协作用 sequenceDiagram，状态机用 stateDiagram-v2 等）；若你没指定图型，会先简短说明理由再直接出图，而不是把选择题丢回给你。

随后建立节点清单：每个节点只承载一个含义，优先「动作 + 对象」或「角色 + 职责」，长说明放在图后。连接边上会写清顺序、条件分支和失败路径；中文节点与特殊字符统一用双引号，避免把 URL 或复杂 Markdown 塞进节点。

交付前会用 Mermaid CLI（mmdc）对代码做真实编译；失败则缩小到最小复现片段修复，最多连续尝试三次。输出包含：一句话结论、已验证代码、三到五条人话解释，以及验证回执；核心节点超过约 15 个时会优先拆图而不是硬塞一张。

边界与注意

它解决的是「看懂结构」与「可渲染代码」，不是替你做业务决策或填真实客户数据。飞书与 Obsidian 对语法支持略有差异，应以目标平台实际渲染为准；若要求「一张图装下全部」，通常会先给不超过 12 个主节点的总图，再附子图。