用途:根据用户需求生成 .drawio XML 文件,并调用本地 draw.io 桌面应用 CLI 导出为 PNG、SVG、PDF、JPG,无需浏览器自动化。适用于流程图、架构图、决策树、多组件系统说明等场景;简单列表或表格可满足时不必使用。
主要能力:支持 PNG/SVG/PDF 导出时用 -e 嵌入完整图表 XML,导出文件可在 draw.io 中恢复为可编辑图表,建议使用 name.drawio.png 双扩展名。工作流包括检查依赖、规划布局、生成 XML、导出草稿 PNG、自检(重叠、标签截断、连线缺失、越界、边穿形状、边堆叠,最多两轮)、与用户评审迭代(单元素就地改 XML,布局级改动整体重生成,最多 5 轮后建议手动微调)、最终导出并报告路径。
使用方式:需先安装 draw.io 桌面版并确保 CLI 可用,例如 macOS 用 brew install --cask drawio,Windows 用 "C:\Program Files\draw.io\draw.io.exe",Linux 无头环境需 xvfb-run -a。导出命令示例:draw.io -x -f png -e -s 2 -o diagram.drawio.png input.drawio;SVG 用 -f svg,PDF 用 -f pdf。常用参数:-x 导出模式,-f 格式,-e 嵌入 XML,-s 缩放,-o 输出路径,-b 边框,-t 透明背景,--page-index 指定页。
限制与注意:XML 必须包含 id="0" 和 id="1" 根单元,用户形状从 id="2" 起;边必须使用展开形式并含 mxGeometry 子元素,自闭合边不渲染;注释中不可出现 --;属性值需转义 &、<、>、"。PDF 导出需 Chromium 可用;CLI 背景色存在已知问题,可用 --transparent 或样式设置。资料未提供收费、价格与平台支持范围等信息。