SuperAPI AI 工具集

drawio-core-xml-format

设计与创作

查看项目

更新于 10-15 22:18

技能介绍

用途:该技能讲解 Draw.io(.drawio/.xml)文件使用的完整 mxGraph XML 格式,帮助正确生成、读取和修改图表,避免 AI 常见的压缩或畸形 XML 错误。

主要能力与规则:始终生成未压缩 XML(compressed="false" 或简化格式);必须包含结构单元 <mxCell id="0"/> 与 <mxCell id="1" parent="0"/>;所有 cell ID 在整份文件(含所有页面)中唯一;标签含 HTML 时 style 必须写 html=1;禁止生成压缩或 Base64 内容。

结构:mxfile > diagram > mxGraphModel > root > mxCell。单页可用简化格式(仅 mxGraphModel),多页或需文件级变量时用完整格式。每个页面有独立 mxGraphModel 与结构单元。

单元类型:结构单元、顶点(vertex="1")、边(edge="1",含 source/target),二者不可同时设置。顶点用绝对坐标 mxGeometry(x、y、width、height),边用 relative="1"。样式为分号分隔的 key=value; 对,顶点必须含 html=1 与 whiteSpace=wrap;非矩形形状需匹配 perimeter(如 ellipsePerimeter、rhombusPerimeter)。

层级与图层:parent="0" 的 cell 即图层,默认图层 id="1" 始终存在;visible="0" 隐藏图层,文档顺序决定堆叠。HTML 标签需 XML 转义。自定义元数据用 <object> 包裹,id 与 label 移到外层,内层 mxCell 不再有 id 或 value。

限制:AI 无法执行 DEFLATE 压缩,故必须用未压缩格式;交付前需校验 XML 良构、结构单元、ID 唯一、边引用有效、parent 有效、HTML 转义等。