SuperAPI AI 工具集

drawio

设计与创作

查看项目

更新于 10-15 20:27

技能介绍

用途:当用户要求创建、生成、绘制或设计图表(流程图、架构图、ER 图、时序图、类图、网络图等)时,生成 draw.io 图表。

主要能力:以 mxGraphModel 格式生成 draw.io XML,写入当前工作目录下的 .drawio 文件;可选导出为 PNG、SVG、PDF(内嵌图表 XML,导出文件在 draw.io 中仍可编辑)。

使用方式:用 Write 工具把 XML 写入 .drawio 文件;若用户要求导出格式,定位 draw.io CLI 后使用 --embed-diagram 导出,再删除源 .drawio 文件;若未找到 CLI,则保留 .drawio 文件并告知用户。打开结果:导出则打开导出文件,否则打开 .drawio 文件;打开失败则打印文件路径。

导出命令:drawio -x -f <format> -e -b 10 -o <output> <input.drawio>。关键参数:-x 导出,-f 格式,-e 内嵌图表 XML(仅 PNG/SVG/PDF),-o 输出路径,-b 边框,-t 透明背景(仅 PNG),-s 缩放,--width/--height 尺寸适配,-a 导出全部页面(仅 PDF),-p 选择页码。PNG、SVG、PDF 支持内嵌 XML;jpg 不支持且为有损。

CLI 定位:macOS 为 /Applications/draw.io.app/Contents/MacOS/draw.io,Linux 为 drawio,Windows 为 "C:\Program Files\draw.io\draw.io.exe",WSL2 经 /mnt/c/... 调用 Windows 可执行文件,非默认路径需检查替代位置。

文件命名:按内容使用描述性小写连字符名;导出使用双扩展名 name.drawio.png 等;导出成功后删除中间 .drawio 文件。

限制与注意:必须直接生成原生 mxGraphModel XML,Mermaid 和 CSV 需服务端转换。禁止在输出中包含 XML 注释,需转义特殊字符,每个 mxCell 使用唯一 id。导出失败常见于无效 XML、缺少根单元格 id="0" 和 id="1"、边缺少 mxGeometry 子元素。完整 XML 参考见 https://raw.githubusercontent.com/jgraph/drawio-mcp/main/shared/xml-reference.md 。