用途:根据用户描述生成 Mermaid 图表代码,并输出可复用的文件。
主要能力:支持流程图、时序图、类图、状态图、ER 图、甘特图、饼图、思维导图、时间线、Git 图、象限图、需求图、C4 图、桑基图、XY 图、块图、数据包图、看板、架构图、雷达图、树图、用户旅程、ZenUML 等类型;支持主题、指令、布局、全局配置与 KaTeX 数学公式($$...$$,需放在引号内)。
使用方式:先执行 mkdir -p figures 创建输出目录;按需求选择图表类型并参考对应语法;生成后同时保存 figures/<diagram-name>.mmd(纯 Mermaid 源码)和 figures/<diagram-name>.md(含 mermaid 代码块),文件名用 kebab-case。随后用 mmdc 校验:mmdc -i figures/<diagram-name>.mmd -o figures/<diagram-name>.png -b transparent;若不可用则用 npx -y @mermaid-js/mermaid-cli@latest 替代。语法错误最多修正 3 轮(MAX_ITERATIONS = 3)。渲染后需读取 PNG 做严格审查与评分,检查文件一致性、箭头方向、节点内容、完整性与视觉质量,评分低于 9 分需继续修正。
适用场景:流程与决策、API 交互、数据库设计、项目计划、系统架构、学术论文配图等。
限制:需本地具备 mmdc 或可访问 npx;KaTeX 需 Mermaid v10.9.0+,部分表达式可能无法在所有环境渲染;节点标签换行用 <br/>,不要用 \n;含特殊字符的标签需加引号。具体收费、平台支持等信息暂未提供。