用途:从源代码生成生产级图表,基于 Mermaid.js,并用 mmdc 渲染为 SVG/PNG。
主要能力:支持架构图(graph TD)、ER 图(erDiagram)、时序图(sequenceDiagram)、类图(classDiagram)、流程图(flowchart TD)、状态图、依赖图和甘特图,用户可指定意图选择类型。
使用方式:流程为分析代码库、规划图表类型、编写 .mmd、用 mmdc 渲染、读取输出验证。环境需预装 Chromium + Node.js + mmdc;如无 mmdc 先执行 npm install -g @mermaid-js/mermaid-cli,并创建 /tmp/puppeteer-config.json 配置无头环境。渲染命令:SVG 用 mmdc -i diagram.mmd -o diagram.svg -b transparent -p /tmp/puppeteer-config.json,PNG 用 mmdc -i diagram.mmd -o diagram.png -b white -s 2 -p /tmp/puppeteer-config.json,建议两种格式都生成。分析采用渐进式:先 glob 扫描目录,再查入口文件,按图表类型定向读取,GitHub 仓库可用 git clone --depth 1 <url> /tmp/repo-name。
限制:ER 图建议不超过约 10 个实体,单图节点不超过约 20 个,超出应拆分;图需验证无语法错误。