| name | drawio-generator |
| description | 生成Draw.io图表XML文件,可直接在diagrams.net中打开和编辑。当用户请求创建流程图、思维导图、架构图、组织架构图、甘特图、时间轴或其他可视化图表时使用。支持所有标准Draw.io形状、样式和连接。 |
Draw.io 图表生成器 v12
生成与Draw.io兼容的XML文件,可在diagrams.net中直接打开进行进一步编辑。
快速参考（Agent必读）
每次生成图表的6步工作流程：
- 理解需求 - 明确图表类型和内容要求
- 加载参考 - 读取
references/{类型}/{类型}_rule.md（规则文件会指引扩展资源）
- 生成XML - 创建完整的
<mxfile>...</mxfile>
- 保存文件 - 使用
{主题名}_{类型}.drawio 命名
- 修正与对齐 - 运行
script/fix_drawio_xml.py（必须）+ 对齐脚本（推荐）
- 提供文件 - 返回最终文件
关键要点：
- 第5步不能跳过，必须运行修正脚本
- 文件扩展名必须是
.drawio，禁止使用 .xml
文件命名规则
格式：{主题名}_{类型}.drawio
关键要求：
- 文件必须以
.drawio 结尾
- 禁止使用
.drawio.xml 或 .xml 作为扩展名
- 最终提供给用户的文件必须是
.drawio 格式
命名示例：
电商注册_流程图.drawio系统架构_架构图.drawio公司组织_组织架构图.drawio项目排期_甘特图.drawio
禁止 输出其他格式，只可输出xxx_xxx.drawio,生成其他的格式都会受到严重的惩罚！
核心工作流程（6步详解）
第1步：理解需求
与用户明确以下内容：
- 图表类型（流程图/思维导图/架构图/组织架构图/甘特图/时间轴）
- 具体内容要求
- 如有文件需要解析或需要网络检索，先行完成
第2步：加载参考
根据图表类型，读取对应的规则文件：
| 图表类型 | 规则文件路径 |
|---|
| 流程图 | references/flowchart/flowchart_rule.md |
| 思维导图 | references/mindmap/mindmap_rule.md |
| 架构图 | references/architecture/architecture_rule.md |
| 组织架构图 | references/architecture_organizational/architecture_organizational_rule.md |
| 甘特图 | references/gantt/gantt_rule.md |
| 时间轴 | references/timeline/timeline_rule.md |
重要提示：
- 规则文件会在"扩展资源"章节列出其他可选资源（如 examples.md、templates.md）
- 根据需要按需加载扩展资源
第3步：生成XML
按照规则文件中的规范，创建完整的 Draw.io XML 内容：
- 遵循 XML 基本结构
- 应用正确的样式规则
- 确保连接点配置正确
第4步：保存文件
按照"文件命名规则"保存为 .drawio 文件：
- 格式：
{主题名}_{类型}.drawio
- 确保扩展名正确
第5步：修正与对齐（必须执行！）
5.1 运行修正脚本（所有图表类型必须）
python script/fix_drawio_xml.py {文件名}.drawio
修正内容：
- style 属性引号错误
- ID 唯一性验证
- source/target 引用验证
5.2 运行对齐脚本（特定图表类型）
| 图表类型 | 对齐脚本 | 是否必须 | 特殊说明 |
|---|
| 流程图（普通/Z字） | script/align_drawio_nodes.py | 必须 | - |
| 流程图（泳道） | - | 禁止运行 | 泳道使用容器嵌套和相对坐标，对齐脚本无效且可能破坏布局 |
| 组织架构图 | script/align_drawio_nodes.py | 必须 | - |
| 架构图 | script/align_drawio_architecture.py | 必须 | - |
| 思维导图 | script/align_mindmap_vertical.py | 必须 | - |
| 甘特图 | - | 不需要 | - |
| 时间轴 | - | 不需要 | - |
⚠️ 重要：泳道流程图特别说明
- 泳道布局使用容器嵌套结构，节点使用相对于泳道容器的坐标
- 对齐脚本只能处理绝对坐标，无法识别相对坐标关系
- 生成泳道图后直接跳过对齐脚本，只运行修正脚本即可
- 泳道图的对齐由容器自动处理，关键是生成时精确计算坐标
第6步：提供文件
将修正并对齐后的 .drawio 文件返回给用户。
正确做法 vs 错误做法
正确做法
完整流程：
- 读取对应图表类型的规则文件（如
references/flowchart/flowchart_rule.md）
- 根据规则生成完整的 XML 内容
- 按命名规则保存为
.drawio 文件
- 运行
script/fix_drawio_xml.py 修正错误
- 根据图表类型运行对应的对齐脚本（
script/align_*.py）
- 将最终文件返回给用户
以下做法会导致任务失败：
错误1：直接在对话中输出 XML 文本
- 问题：用户无法直接使用文本形式的 XML
- 正确：必须创建文件
错误2：保存文件后不运行修正脚本
- 问题：文件可能有引号错误，无法在 Draw.io 中打开
- 正确：必须运行
script/fix_drawio_xml.py
错误3：跳过第5步（修正与对齐）
- 问题：文件质量无法保证，可能无法正确渲染
- 正确：必须运行修正脚本，推荐运行对齐脚本
错误4：对应该对齐的图表类型不运行对齐脚本
- 问题：图表不规整，连线弯折
- 正确：普通流程图/Z字流程图/组织架构图运行
align_drawio_nodes.py，架构图运行 align_drawio_architecture.py，思维导图运行align_mindmap_vertical.py
错误4.1：对泳道流程图运行对齐脚本
- 问题：泳道使用容器相对坐标，对齐脚本会破坏布局
- 正确：泳道流程图禁止运行对齐脚本，只运行修正脚本
错误5：使用错误的文件扩展名
- 问题：文件无法被 Draw.io 正确识别
- 正确：必须使用
.drawio 扩展名，禁止使用 .drawio.xml 或 .xml
视觉风格模式
根据用户意图或关键词（如"手绘"、"草图"、"白板"），选择以下风格之一：
1. 专业标准风格（默认）
适用场景： 正式文档、技术评审、交付物
样式参数：
- 节点：
rounded=1;whiteSpace=wrap;html=1;shadow=0;glass=0;sketch=0
- 连线：
edgeStyle=orthogonalEdgeStyle;rounded=0;sketch=0
- 字体：默认字体（Helvetica/Verdana）
2. 手绘草图风格
适用场景： 头脑风暴、早期设计、非正式讨论
触发关键词： "手绘"、"草图"、"白板"
样式参数：
- 节点/连线：
sketch=1（开启手绘）hachureGap=4（线条间隙）jiggle=2（抖动程度）curveFitting=1fontFamily=Architects DaughterfontSource=https://fonts.googleapis.com/css?family=Architects+Daughter
- 连线额外选项：
curved=1（使线条更自然）
注意： 手绘风格时，所有文本节点也必须应用手绘字体。
图表类型速查
支持的6种图表类型
| 类型 | 关键词 | 适用场景 |
|---|
| 流程图 | 流程、工作流、步骤、程序、顺序 | 流程处理、决策树 |
| 思维导图 | 头脑风暴、想法、概念、组织思路 | 层级化想法组织 |
| 架构图 | 系统、组件、服务、技术栈、拓扑 | 系统架构、网络拓扑 |
| 组织架构图 | 组织、团队、汇报关系、部门 | 公司/团队层级结构 |
| 甘特图 | 甘特、项目计划、排期、进度 | 项目排期、时间线管理 |
| 时间轴 | 时间轴、历程、发展、事件、演变 | 发展历程、里程碑展示 |
图表类型选择指引
当用户请求图表但未指定类型时，根据关键词自动识别：
- 提到"流程"、"步骤" → 流程图
- 提到"想法"、"头脑风暴" → 思维导图
- 提到"系统"、"架构" → 架构图
- 提到"组织"、"部门" → 组织架构图
- 提到"排期"、"进度" → 甘特图
- 提到"历程"、"发展" → 时间轴
Python脚本说明
1. fix_drawio_xml.py（必须运行）
位置： script/fix_drawio_xml.py
适用范围： 所有图表类型
功能：
- 修正 style 属性引号错误
- 修正 style 属性分裂
- 修正 key="value" 模式错误
- 验证 ID 唯一性
- 验证 source/target 引用有效性
使用方法：
python script/fix_drawio_xml.py {文件名}.drawio
2. align_drawio_nodes.py（流程图/组织架构图）
位置： script/align_drawio_nodes.py
适用范围： 流程图、组织架构图
功能：
- 纵列对齐（垂直方向）
- 横列对齐（水平方向）
- AABB 碰撞检测与推挤
使用方法：
python script/align_drawio_nodes.py {文件名}.drawio
3. align_drawio_architecture.py（架构图）
位置： script/align_drawio_architecture.py
适用范围： 架构图
功能：
- 父子节点关系处理
- 容器自动扩展
- 层容器间距调整
- 确保无重叠无溢出
使用方法：
python script/align_drawio_architecture.py {文件名}.drawio
4. align_mindmap_vertical.py（思维导图）
位置： script/align_mindmap_vertical.py
适用范围： 思维导图（逻辑树和放射状）
功能：
- 垂直方向防重叠检测
- 从上到下碰撞检测
- 向下推开重叠节点
- 保持最小垂直间距
使用方法：
python script/align_mindmap_vertical.py {文件名}.drawio [最小间距]
参数说明：
通用 XML 规则
1. 基本结构
<mxfile host="app.diagrams.net">
<diagram id="unique_id" name="图表名称">
<mxGraphModel dx="1200" dy="800" grid="1" gridSize="10">
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
<mxCell id="node1" value="文本"
style="rounded=1;fillColor=#3366CC;strokeColor=#3366CC;"
vertex="1" parent="1">
<mxGeometry x="100" y="100" width="180" height="60" as="geometry"/>
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>
2. Style 属性规则（最容易出错）
关键原则：永远不要在 style 属性值内部添加引号！
这是最常见的错误，会导致 Draw.io 完全无法解析 XML。
错误示例：
style="fillColor="#3366CC;strokeColor="#666;"
style="fillColor="#3366CC;strokeColor=#666;"
style="rounded=1;fillColor="#3366CC;"
正确示例：
style="fillColor=#3366CC;strokeColor=#666;"
style="rounded=1;fillColor=#3366CC;fontColor=#FFFFFF;"
核心规则：
- style 的值已经被外层双引号包裹，内部不能再有引号
- 颜色值：
fillColor=#RRGGBB（无引号）
- 数字值：
rounded=1（无引号）
- 所有参数必须是
key=value 格式（不能只写 rounded，必须写 rounded=1）
3. 连接点规则
出入口坐标是 mxCell 属性，不是 style 参数：
<mxCell id="edge1"
style="edgeStyle=orthogonalEdgeStyle;endArrow=block;"
edge="1" parent="1" source="node1" target="node2"
exitX="1" exitY="0.5" entryX="0" entryY="0.5">
<mxGeometry relative="1" as="geometry"/>
</mxCell>
连接点坐标系统：
- X 轴：
0（左）/ 0.5（中）/ 1（右）
- Y 轴：
0（上）/ 0.5（中）/ 1（下）
4. 换行处理
使用 <br> 配合 html=1;whiteSpace=wrap; 实现换行：
<mxCell id="node1" value="第一行<br>第二行<br>第三行"
style="rounded=1;fillColor=#3366CC;html=1;whiteSpace=wrap;"
vertex="1" parent="1">
5. 节点关系规则
基本要求： 所有 mxCell 元素是 <root> 的直接子元素（XML 不嵌套），通过 parent 属性表示层级关系。
标准结构：
<mxCell id="0"/> - 根节点<mxCell id="1" parent="0"/> - 画布节点
parent 属性使用：
- 一般图表（流程图/思维导图/甘特图/时间轴）：所有节点
parent="1"（扁平结构）
- 架构图/组织架构图：允许使用父子嵌套
- 容器节点：
parent="1"
- 子节点：
parent="容器ID"（坐标相对父容器）
注意： 父子关系通过 parent 属性表达，不是 XML 标签嵌套。
工作流强制要求
完整工作流：
| 步骤 | 操作 | 要点 |
|---|
| 1 | 理解需求 | 明确图表类型和内容 |
| 2 | 加载规则文件 | references/{类型}/{类型}_rule.md |
| 3 | 生成XML | 创建完整的 <mxfile> 结构 |
| 4 | 保存文件 | {主题名}_{类型}.drawio |
| 5.1 | 运行修正脚本 | script/fix_drawio_xml.py（必须） |
| 5.2 | 运行对齐脚本 | 根据图表类型选择（必须） |
| 6 | 提供文件 | 返回最终 .drawio 文件 |
关键提醒：
- 必须运行修正脚本，确保文件可以正确渲染
- 根据图表类型运行对应的对齐脚本
- 最终文件必须是
.drawio 格式
