| name | xml-diagram |
| description | 根据自然语言描述生成 XML 格式（drawio）的图形文件。支持流程图、卡片、图表、图标等常用图形，输出可直接在 drawio 中打开编辑的 .drawio 文件。与 svg-generator 功能完全一致，但输出 drawio XML 格式。当用户提到 XML 绘图、drawio、生成图形、流程图时触发。 |
XML 图形生成器（drawio 格式）
核心工作流
用户描述 → 解析需求 → 设计图形 → 生成 drawio XML → 验证输出 → 保存文件
详细流程如下：
- 接收用户描述
- 用户可能会描述需要的图类型（流程图、卡片、图表等）、布局（横向、纵向、网格等）、内容（文字、emoji）和风格（简约，专业、可爱等）。
- 解析用户输入，提取关键信息以指导后续的图形设计和生成。
- 解析用户需求
- 思考需要绘制的图类型、结构、元素、布局和配色，如果不清楚的情况，请用户确认。
- 评估元素数量，合理分组，避免单个图形承载过多内容
- 根据分析结果，设计图的布局和元素
- 确定图的整体结构和层次关系
- 设计每个元素的样式（颜色、形状、大小等）
- 确定元素之间的连接方式（线条、箭头等）
- 生成 drawio XML 代码
- 使用 drawio 的 mxGraph XML 格式构建图形
- 应用 CSS 样式内嵌到 SVG 中
- 根据风格选择应用滤镜和阴影效果
- 针对生成的图进行验证，确保其符合用户需求和预期的视觉效果
- 背景模式确认：
- 确认用户选择的背景模式（浅色/深色）
- 未明确时默认使用浅色背景
- 深色模式下文字和边框使用浅色系
- 基础结构验证（避免元素重叠和布局错乱）：
- 检查图的结构和元素是否正确
- 确保所有节点坐标计算准确，无重叠
- 验证连接线起点/终点精确指向节点边缘
- 检查文字与图形边界间距 ≥8px，避免文字溢出
- 布局规约验证（避免空白过多和拥挤）：
- 画布尺寸紧凑合理，利用率 60%-80% 为宜
- 节点间距合理，无过大或过小
- 分支路径清晰，无路径交叉
- 折线转折点不与节点重叠
- 显示完整性保障（避免显示不完整）：
- 计算画布尺寸：
画布高度 = 标题高度 + 内容总高度 + 节点间距 × (节点数-1) + 图例说明区高度(如有) + 边距
- 确保所有节点、文字、连线、箭头都在画布范围内
- 各边保留 ≥30-40px 边距，避免内容被裁剪
- 箭头与连接验证（避免箭头混乱）：
- 检查箭头样式统一
- 验证箭头指向准确，无偏移或错位
- 检查折线路径节点顺序正确，无交叉混乱
- 验证虚线仅用于异步流程，错误分支使用实线
- 稳健性设计检查：
- 避免使用嵌套坐标，所有坐标使用明确数值
- 确保菱形判断节点中心坐标准确，分支从底部中心出发
- 验证汇聚点位置在分支节点正下方，避免路径交叉
- 图例应置于图形底部，避免与主流程重叠，预留专用图例区域
- 样式与颜色验证：
- 确保颜色和样式符合选择的风格
- 验证 drawio XML 代码的正确性和兼容性
- 检查图的布局和元素之间的连接是否合理、线条是否清晰准确、图形是否清晰可读、颜色是否符合预期、排版是否整齐
- 检查图中箭头是否清晰、连接是否正常、大小是否合适
- 检查图片是否能够完整显示，是否有元素被截取
- 复杂流程图验证：
- 分支流程使用不同颜色区分（错误分支用红色，主线用灰色/蓝色）
- 条件判断节点使用菱形形状
- 异步流程使用虚线连接（仅用于异步场景）
- 汇聚点明确标注
- 可选区域用虚线框表示
- 输出最终的 drawio XML 文件，供用户使用和修改
- 将 drawio XML 保存到指定路径，文件名以
.drawio 结尾
- 提供 drawio XML 代码字符串供用户复制使用
核心原则：生成的 drawio 图形要简洁美观，符合现代设计规范，与 svg-generator 风格保持一致。
视觉风格规范
背景模式
重要：生成图形时必须明确用户需要的背景模式，未明确时默认使用浅色背景
1. 浅色背景模式（默认）
适用于：浅色主题文档、PPT、网页等
参考示例：浅色流程图、浅色架构图
| 用途 | 颜色代码 |
|---|
| 背景色 | #f8f9fa |
| 卡片背景 | #ffffff |
| 标题文字 | #333333 |
| 正文文字 | #666666 或 #999999 |
| 边框色 | #e0e0e0 |
| 箭头颜色 | #999999 或 #666 |
2. 深色背景模式
适用于：深色主题文档、演示文稿、代码编辑器主题等
参考示例：深色流程图、深色时间线
| 用途 | 颜色代码 |
|---|
| 背景色 | #1a1a2e |
| 卡片背景 | #16213e |
| 标题文字 | #ffffff |
| 正文文字 | #aaaaaa 或 #888888 |
| 边框色 | #333333 |
| 箭头颜色 | #666666 或 #555555 |
深色模式配色速查：
| 用途 | 颜色代码 |
|---|
| 主色（蓝） | #3498db |
| 成功（绿） | #2ecc71 |
| 警告（橙） | #e67e22 |
| 错误（红） | #e74c3c |
| 紫色 | #9b59b6 |
| 青色 | #1abc9c |
| 黄色 | #f39c12 |
| 青色2 | #00cec9 |
深色背景下的特殊处理：
- 文字使用浅色系确保对比度
- 节点边框适当加粗（2-3px）以增强可见性
- 建议使用圆角卡片提升视觉层次
配色方案
| 用途 | 颜色代码 |
|---|
| 主色（蓝色） | #3498db |
| 辅助色（绿色） | #2ecc71 |
| 强调色（橙色） | #e67e22 |
| 警示色（红色） | #e74c3c |
| 背景色 | #f8f9fa |
| 文字色 | #333333 或 #666666 |
| 边框色 | #e0e0e0 |
| 箭头颜色 | #999999 或 #3498db（灰色/蓝色） |
图形规范
| 项目 | 浅色模式默认值 | 深色模式默认值 |
|---|
| 画布尺寸 | 800×600 | 800×600 |
| 圆角半径 | 8px（卡片） | 8px（卡片） |
| 阴影 | 柔和阴影 | 无阴影或淡阴影 |
| 边框宽度 | 2px | 2-3px |
| 字体 | PingFang SC, Microsoft YaHei, sans-serif | PingFang SC, Microsoft YaHei, sans-serif |
| 线条粗细 | 2px | 2px |
布局规范（重要）
1. 形状拼接规范（避免圆弧不协调）
问题说明：当一个形状内部包含另一个形状（如带标题栏的卡片）时，如果分别设置圆角会导致边界不协调。
正确做法 - 使用单层结构：
<mxCell id="node1" value="节点名称" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#3498db;strokeWidth=2;fontColor=#333333;fontSize=14;fontStyle=1;shadow=1;" vertex="1" parent="1">
<mxGeometry x="100" y="100" width="140" height="60" as="geometry" />
</mxCell>
简化设计原则：
- 避免使用双层形状叠加（一个带圆角的矩形+一个矩形标题栏）
- 如需区分标题区域，使用颜色填充而非叠加形状
- 标题文字使用粗体或不同颜色区分，不单独创建标题块
- drawio 中直接使用
fontStyle=1 让文字加粗，或使用不同 fontColor 区分标题
2. 线条布局规范（避免混乱与重叠）
节点间距规则：
- 横向节点间距：≥ 40px
- 纵向节点间距：≥ 30px
- 分支节点间距：分支点前垂直距离 ≥ 50px
连接线规范：
- 连接线端点距节点边界：≥ 5px
- 折线转折点：使用整数坐标
- 避免三条以上路径经过同一坐标点
- 优先使用直线，其次折线，谨慎使用曲线
- 使用
edgeStyle=orthogonalEdgeStyle 确保折线正交
分支路径规则：
- 双分支左右偏转角度：30-45°
- 分支展开角度合理，避免交叉
- 汇聚点位于所有分支节点的公共下方
防重叠检查：
- 连接线不穿过其他节点
- 文字与图形边界间距 ≥ 8px
- 图例与主流程保持 ≥ 30px 间距
drawio XML 格式规范
基础结构
<mxfile host="app.diagrams.net">
<diagram name="页面-1">
<mxGraphModel dx="1200" dy="800" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="800" pageHeight="600" math="0" shadow="1">
<root>
<mxCell id="0" />
<mxCell id="1" parent="0" />
</root>
</mxGraphModel>
</diagram>
</mxfile>
常用元素格式
1. 浅色模式圆角矩形卡片
<mxCell id="node1" value="节点名称" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#3498db;strokeWidth=2;fontColor=#333333;fontSize=14;fontStyle=1;shadow=1;" vertex="1" parent="1">
<mxGeometry x="100" y="100" width="140" height="60" as="geometry" />
</mxCell>
2. 深色模式圆角矩形卡片
<mxCell id="node1" value="节点名称" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#16213e;strokeColor=#3498db;strokeWidth=2;fontColor=#aaaaaa;fontSize=14;fontStyle=1;" vertex="1" parent="1">
<mxGeometry x="100" y="100" width="140" height="60" as="geometry" />
</mxCell>
3. 菱形判断节点
<mxCell id="node2" value="判断?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#e67e22;strokeWidth=2;fontColor=#333333;fontSize=12;" vertex="1" parent="1">
<mxGeometry x="200" y="200" width="80" height="80" as="geometry" />
</mxCell>
4. 圆形节点
<mxCell id="node3" value="开始" style="ellipse;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#3498db;strokeWidth=2;fontColor=#333333;fontSize=12;" vertex="1" parent="1">
<mxGeometry x="100" y="100" width="60" height="60" as="geometry" />
</mxCell>
5. 箭头连接线
<mxCell id="edge1" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeColor=#999999;strokeWidth=2;endArrow=classic;endFill=1;" edge="1" parent="1" source="node1" target="node2">
<mxGeometry relative="1" as="geometry" />
</mxCell>
6. 虚线连接（异步/可选流程）
<mxCell id="edge2" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeColor=#9b59b6;strokeWidth=2;dashed=1;endArrow=classic;endFill=1;" edge="1" parent="1" source="node2" target="node3">
<mxGeometry relative="1" as="geometry" />
</mxCell>
7. 红色箭头（错误分支）
<mxCell id="edge3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeColor=#e74c3c;strokeWidth=2;endArrow=classic;endFill=1;" edge="1" parent="1" source="node2" target="node4">
<mxGeometry relative="1" as="geometry" />
</mxCell>
8. 虚线框（可选区域）
<mxCell id="optional" value="可选流程" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8f9fa;strokeColor=#999999;strokeWidth=1;dashed=1;fontColor=#999999;fontSize=10;" vertex="1" parent="1">
<mxGeometry x="50" y="200" width="200" height="120" as="geometry" />
</mxCell>
9. 汇聚点
<mxCell id="join" value="" style="ellipse;whiteSpace=wrap;html=1;fillColor=#666666;strokeColor=#666666;strokeWidth=0;" vertex="1" parent="1">
<mxGeometry x="300" y="400" width="12" height="12" as="geometry" />
</mxCell>
样式属性说明
| 属性 | 说明 | 常用值 |
|---|
| rounded | 圆角 | 0=无, 1=有 |
| whiteSpace | 文本换行 | wrap |
| html | HTML渲染 | 1 |
| fillColor | 填充颜色 | #ffffff, #16213e 等 |
| strokeColor | 边框颜色 | #3498db, #e74c3c 等 |
| strokeWidth | 边框宽度 | 2 |
| fontColor | 文字颜色 | #333333, #aaaaaa 等 |
| fontSize | 字体大小 | 12, 14, 16 等 |
| fontStyle | 字体样式 | 0=普通, 1=粗体 |
| dashed | 虚线 | 0=实线, 1=虚线 |
| shadow | 阴影 | 0=无, 1=有 |
| edgeStyle | 连线样式 | orthogonalEdgeStyle=正交, elbowEdgeStyle=肘部 |
分层架构图容器
<mxCell id="layer1" value="" style="rounded=1;whiteSpace=wrap=1;html=1;fillColor=#E3F2FD;strokeColor=#3498db;strokeWidth=1;" vertex="1" parent="1">
<mxGeometry x="100" y="80" width="900" height="80" as="geometry" />
</mxCell>
<mxCell id="label1" value="① 接入层" style="text;html=1;strokeColor=none;fillColor=none;align=left;verticalAlign=middle;whiteSpace=wrap=1;rounded=0;fontColor=#3498db;fontSize=14;fontStyle=1;" vertex="1" parent="1">
<mxGeometry x="110" y="85" width="100" height="20" as="geometry" />
</mxCell>
执行步骤
第 1 步：解析用户需求
用户可能提供：
- 图形类型：流程图、卡片、图表、图标、关系图、架构图
- 布局描述：横向、纵向、网格、环形
- 内容：文字、emoji、颜色偏好
- 风格：简约、专业、可爱
- 背景模式：浅色/深色（重要：必须明确，未明确时默认浅色）
背景模式确认
关键步骤：生成前必须确认用户需要的背景模式
- 询问用户：「需要浅色背景还是深色背景的图？」
- 如用户未指定，默认使用浅色背景
- 适用场景参考：
- 浅色背景：文档、PPT、网页展示
- 深色背景：代码截图、IDE配套图、深色主题设计稿
第 2 步：选择模板或新建
常用模板：
- 横向流程图 - 步骤从左到右排列
- 纵向流程图 - 步骤从上到下排列
- 循环流程图 - 首尾相连的闭环
- 卡片网格 - 多张卡片并列
- 对比图 - 左右对比布局
- 时间线 - 垂直或水平时间轴
- 饼图/柱状图 - 数据可视化
- 架构图 - 系统、部署、应用架构图，架构图要分层显示
- 表格对比 - 数据表格可视化
第 3 步：生成 drawio XML 代码
根据需求生成完整的 drawio 文件：
浅色背景模板
<mxfile host="app.diagrams.net">
<diagram name="页面-1">
<mxGraphModel dx="1200" dy="800" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="800" pageHeight="600" math="0" shadow="1">
<root>
<mxCell id="0" />
<mxCell id="1" parent="0" />
<mxCell id="bg" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#f8f9fa;strokeColor=#e0e0e0;" vertex="1" parent="1">
<mxGeometry x="0" y="0" width="800" height="600" as="geometry" />
</mxCell>
<mxCell id="title" value="图形标题" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap=1;rounded=0;fontSize=20;fontStyle=1;fontColor=#333333;" vertex="1" parent="1">
<mxGeometry x="300" y="20" width="200" height="30" as="geometry" />
</mxCell>
...
</root>
</mxGraphModel>
</diagram>
</mxfile>
深色背景模板
<mxfile host="app.diagrams.net">
<diagram name="页面-1">
<mxGraphModel dx="1200" dy="800" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="800" pageHeight="600" math="0" shadow="0">
<root>
<mxCell id="0" />
<mxCell id="1" parent="0" />
<mxCell id="bg" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#1a1a2e;strokeColor=#333333;" vertex="1" parent="1">
<mxGeometry x="0" y="0" width="800" height="600" as="geometry" />
</mxCell>
<mxCell id="title" value="图形标题" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap=1;rounded=0;fontSize=20;fontStyle=1;fontColor=#ffffff;" vertex="1" parent="1">
<mxGeometry x="300" y="20" width="200" height="30" as="geometry" />
</mxCell>
<mxCell id="node1" value="节点内容" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#16213e;strokeColor=#3498db;strokeWidth=2;fontColor=#aaaaaa;fontSize=12;" vertex="1" parent="1">
<mxGeometry x="100" y="80" width="140" height="60" as="geometry" />
</mxCell>
...
</root>
</mxGraphModel>
</diagram>
</mxfile>
深色背景配色速查表：
| 元素 | 颜色代码 |
|---|
| 背景 | #1a1a2e |
| 卡片背景 | #16213e |
| 标题文字 | #ffffff |
| 正文文字 | #aaaaaa / #888888 |
| 边框 | #333333 |
| 箭头 | #666 |
| 主色边框 | #3498db |
| 成功色 | #2ecc71 |
| 错误色 | #e74c3c |
第 4 步：保存文件
将生成的 drawio 保存到用户指定的位置，文件名以 .drawio 结尾。
箭头规范
箭头样式
| 样式 | 属性值 |
|---|
| 灰色箭头（推荐） | strokeColor=#999999 |
| 蓝色箭头 | strokeColor=#3498db |
| 红色箭头 | strokeColor=#e74c3c |
| 紫色箭头 | strokeColor=#9b59b6 |
线条样式
| 样式 | 使用场景 | 属性 |
|---|
| 实线 | 主线流程、正确分支、错误分支 | dashed=0 |
| 虚线 | 异步/回调/可选流程 | dashed=1 |
重要原则：
- 错误分支必须使用实线，用颜色（红色）区分，不可用虚线
- 虚线仅用于表示异步、回调、定时任务等非同步场景
箭头端点样式
endArrow=classic;endFill=1;
endArrow=classicEmpty;endFill=0;
endArrow=diamond;endFill=1;
流程图规范
画布尺寸计算规则
画布高度 = 标题高度 + 内容总高度 + 节点间距 × (节点数-1) + 边距
画布宽度 = 边距 + 最大节点宽度 × 列数 + 列间距 × (列数-1) + 边距
节点排列
- 横向流程：节点水平排列，间距 40-60px
- 纵向流程：节点垂直排列，间距 30-50px
连接线类型
直线连接
<mxCell id="edge1" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;strokeColor=#999999;strokeWidth=2;endArrow=classic;" edge="1" parent="1" source="node1" target="node2">
<mxGeometry relative="1" as="geometry" />
</mxCell>
折线连接（路径转向）
<mxCell id="edge2" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;strokeColor=#999999;strokeWidth=2;endArrow=classic;" edge="1" parent="1" source="node2" target="node3">
<mxGeometry relative="1" as="geometry">
<Array as="points">
<Object x="250" y="180" />
</Array>
</mxGeometry>
</mxCell>
曲线连接（循环/回退）
<mxCell id="edge3" style="edgeStyle=elbowEdgeStyle;rounded=1;html=1;strokeColor=#9b59b6;strokeWidth=2;dashed=1;endArrow=classic;" edge="1" parent="1" source="node3" target="node1">
<mxGeometry relative="1" as="geometry" />
</mxCell>
分支与汇聚
菱形判断节点
<mxCell id="decision" value="判断条件" style="rhombus;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#e67e22;strokeWidth=2;fontColor=#333333;fontSize=12;" vertex="1" parent="1">
<mxGeometry x="200" y="150" width="80" height="80" as="geometry" />
</mxCell>
分支连线标注
在连线旁边添加标注：
<mxCell id="label1" value="是" style="text;html=1;strokeColor=none;fillColor=none;align=center;fontColor=#666666;fontSize=10;" vertex="1" parent="1">
<mxGeometry x="220" y="230" width="30" height="20" as="geometry" />
</mxCell>
架构图规范
分层结构
架构图应采用分层设计，从上到下：
- 接入层（客户端、CDN、负载均衡、网关）
- 服务层（业务服务、认证服务、消息队列）
- 数据层（Redis、MySQL、MongoDB）
- 基础层（Docker、K8s、监控）
架构图组件模板
服务节点
<mxCell id="service1" value="服务名称" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E8F5E9;strokeColor=#2ecc71;strokeWidth=2;fontColor=#333333;fontSize=12;shadow=1;" vertex="1" parent="1">
<mxGeometry x="150" y="100" width="100" height="40" as="geometry" />
</mxCell>
数据库节点
<mxCell id="db1" value="数据库" style="shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;backgroundOutline=1;size=5;fillColor=#FCE4EC;strokeColor=#e74c3c;strokeWidth=2;fontColor=#333333;fontSize=12;" vertex="1" parent="1">
<mxGeometry x="300" y="350" width="60" height="50" as="geometry" />
</mxCell>
队列节点
<mxCell id="queue1" value="消息队列" style="shape=hexagon;whiteSpace=wrap;html=1;fillColor=#F3E5F5;strokeColor=#9b59b6;strokeWidth=2;fontColor=#333333;fontSize=12;perimeter=hexagonPerimeter;" vertex="1" parent="1">
<mxGeometry x="400" y="200" width="100" height="40" as="geometry" />
</mxCell>
箭头使用规则
分层架构图中箭头是可选的：
-
无箭头架构图：当重点展示系统层次结构和组件分层时，可以不加箭头。
-
带箭头架构图：当需要表示数据流向、调用关系或处理顺序时，可添加箭头。箭头应使用统一灰色（#999999）。
<mxCell id="arrow1" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;strokeColor=#999999;strokeWidth=2;endArrow=classic;endFill=1;" edge="1" parent="1" source="layer1" target="layer2">
<mxGeometry relative="1" as="geometry" />
</mxCell>
验证清单
1. 背景模式确认
生成前必须确认：
2. 基础结构验证
3. 布局规约验证
4. 图形完整显示验证
5. 颜色与样式验证
输出说明
生成的 drawio XML 文件可以直接：
- 在 drawio 中打开查看和编辑
- 保存为 .drawio 文件
- 导出为 PNG、SVG、PDF 等格式
- 嵌入到文档中使用
触发条件
当用户提到以下内容时触发：
- XML、drawio、绘图
- 流程图、关系图、结构图、架构图
- 生成一个图、把文字变成图
- drawio 编辑
与 svg-generator 的对应关系
本 skill 与 svg-generator 功能完全一致，区别在于输出格式：
| svg-generator | xml-diagram |
|---|
| 输出 SVG 格式 | 输出 drawio XML 格式 |
.svg 文件 | .drawio 文件 |
| 可在浏览器打开 | 可在 drawio 中编辑 |
| 相同配色方案 | 相同配色方案 |
| 相同布局规范 | 相同布局规范 |
| 相同验证清单 | 相同验证清单 |
