用途:将 Mermaid 图表代码渲染为 SVG 和 PNG 图像,适用于流程、API 调用、状态机、UML 类图、数据库关系等可视化场景。
主要能力:支持 Flowchart、Sequence、State、Class、Entity-Relationship 五类图表;内置 Default、Dracula、Solarized、Tokyo Night 系列、Catppuccin Latte、Nord、GitHub、One Dark、Zinc Dark 等主题,未指定时使用 default。
使用方式:先准备或生成 Mermaid 代码,再运行渲染脚本生成 SVG,例如 bun run scripts/render.ts --code "graph TD; A-->B" --output diagram --theme default,也可用 --input diagram.mmd 从文件读取;替代运行时可用 npx tsx 或 deno run --allow-read --allow-write --allow-net。随后用 bun run scripts/create-html.ts --svg diagram.svg --output diagram.html 生成 HTML 包装,再借助 agent-browser 截图:agent-browser set viewport 3840 2160、agent-browser open "file://$(pwd)/diagram.html"、agent-browser wait 1000、agent-browser screenshot --full diagram.png、agent-browser close。最后清理中间文件,如 rm diagram.html。
限制与注意:PNG 渲染依赖 agent-browser 技能,需先加载;边标签应使用 A -->|label| B 管道语法,避免 -- label --> 空格破折号写法;含特殊字符的节点标签需加引号;节点 ID 需唯一、括号需闭合;渲染异常时可在 mermaid.live 校验语法。输出默认保存到当前工作目录,PNG 为 4K 视口高分辨率截图。其余细节暂未提供。