用途:当用户明确需要原生 .drawio 产物、编辑已有 draw.io 文件,或需要 draw.io 元数据与页面时使用。原生 XML 是唯一事实来源,导出文件与它并存;通用几何图、网格或图表不属于本技能。
主要能力:先形成读者与内容契约(读者、要回答的问题、可验证的答案、必需节点/边/分组/注释),再据此推导节点与边。默认未压缩的裸 mxGraphModel XML,包含根单元 0 和 1,adaptiveColors="auto",背景用 background="#FFFFFF",不输出 XML 注释;顶点先于边,每条边有 source/target 与子 mxGeometry relative="1" as="geometry",标签用 html=1 并转义,换行用 <br> 或 。布局上,新图默认自动布局(线性用 horizontalFlow/verticalFlow,层级用 horizontalTree/verticalTree,嵌套或路由架构用 ELK JSON,可选 orthogonalEdge);已有文件的局部修改保留 cell ID、页面、元数据与未受影响的几何。
使用方式:从技能根目录运行两个验证器:python3 scripts/validate_drawio_xml.py <file>.drawio 与 python3 scripts/validate_drawio_layout.py <file>.drawio;XML 验证为阻塞项。若已有 draw.io CLI 可用于导出(不要求为纯源码请求安装),按 $DRAWIO_BIN、PATH 上的 drawio、macOS 应用二进制的顺序查找,命令如 DRAWIO="${DRAWIO_BIN:-$(command -v drawio || echo /Applications/draw.io.app/Contents/MacOS/drawio)}",再执行 "$DRAWIO" -x -f svg -e -b 16 -o <name>.drawio.svg <name>.drawio 等;文本清晰优先 SVG。新图或重大视觉修改应导出并检查(含深色主题)。
适用场景:需要可被 draw.io 打开和继续编辑的图表,含页面、元数据或既有文件编辑需求。限制:不负责通用图表;注释层仅放名称与机制,不放标题、脚注、徽章等;自动布局是显式创作步骤而非查看器清理;容器分组在自动布局后可能需恢复子元素几何;导出器不可用时只能交付 .drawio 源文件并说明无法导出与目视检查。具体收费、平台支持与更多细节资料暂未提供。