用途:把 Mermaid 图表渲染为 SVG 和 PNG 两种输出,供用户请求渲染 Mermaid 图时使用。
主要能力:支持流程图(流程、决策树、CI/CD 流水线)、时序图(API 调用、OAuth 流程、数据库事务)、状态图、类图、实体关系图。主题包括 Default、Dracula、Solarized、Zinc Dark、Tokyo Night 系列、Catppuccin Latte、Nord、GitHub Dark/Light、One Dark 等,未指定时使用 default。
使用方式:先获知或生成合法 Mermaid 代码(语法细节见 references/mermaid-syntax.md)。渲染 SVG 可执行:bun run scripts/render.ts --code "graph TD; A-->B" --output diagram --theme default,或用 --input diagram.mmd 从文件读取,也支持 npx tsx 与 deno run 运行。接着运行 bun run scripts/create-html.ts --svg diagram.svg --output diagram.html 生成 HTML 包装文件,再用 agent-browser 截取高分辨率 PNG,例如设置 3840 2160 视口后打开 file:// 路径、等待 1000 毫秒、使用 --full 截图。PNG 渲染依赖 agent-browser 技能,需先加载。完成后清理中间文件,仅保留最终 .svg 与 .png;临时 .mmd 文件也应删除。
限制与注意:边标签用管道语法 A -->|label| B,避免 A -- label --> B;含特殊字符的节点标签需加引号;主题未生效时检查渲染输出与 SVG 中的 --bg、--fg;图形被截断可检查节点 ID 唯一性与括号闭合;语法可用 mermaid.live 校验。输出默认保存在当前工作目录,除非用户指定路径。