核心用法
bruce-drawio 是一项代码优先的图表生成技能，用户只需用自然语言描述需求，AI 即可直接编写符合 draw.io 规范的 XML 文件，涵盖流程图、系统架构、UML（时序/类图）、ER 图、思维导图及网络拓扑等全场景。
工作流分为六步：理解需求 → 生成 XML → 自检审查 → 保存 .drawio 文件 → CLI 导出图片 → 交付成果。关键亮点在于“纯 XML 直写”——不依赖任何外部脚本或 API，完全由 AI 控制坐标、样式与布局，确保输出可离线编辑、跨平台兼容。
显著优点
- 精确布局控制：内置网格对齐、防重叠算法、对称留白等规则，输出美观专业；支持多格式导出（PNG/SVG/PDF）及 2x 高清缩放。
- 完全可编辑：交付
.drawio源文件，用户可在 https://app.diagrams.net 二次修改，非一次性图片。 - 架构图最佳实践：采用“分层块式（Layered Block Style）”——无箭头、水平分层、左侧标签栏，符合现代技术文档审美。
- CLI 自动化：自动检测 draw.io 桌面端路径，支持无头导出；提供跨平台安装指引，降低环境配置门槛。
潜在局限与风险
- 环境依赖：必须本地安装 draw.io 桌面版才能执行 CLI 导出；若未安装，AI 仅能提供安装指引，无法自动完成。
- 复杂布局天花板：极端复杂的时序图或大型 ER 图，自动坐标计算可能产生密集交叉线，仍需人工微调。
- 无实时预览：生成过程为批处理模式，用户无法像在线工具那样拖拽即时调整。
适合人群
- 技术写作者、架构师、产品经理：需快速将文字描述转化为可交付的工程图表。
- 文档自动化场景：CI/CD 流水线中自动生成并嵌入架构图。
- 对排版美感有要求但不愿手动拖拽的 draw.io 用户。
常规风险
- XML 语法或 ID 冲突导致文件无法打开（已内置自检清单缓解）。
- 坐标计算溢出页面边界（需遵守 Step 3 的页边距规则）。
- 多语言标签未正确转义换行符（

vs\n易混淆）。