Drawio 技术架构图绘制

问题定位

架构图常卡在两件事：手绘版式漂移，以及导出成图片后无法继续改。这个技能面向技术汇报、架构文档和 PPT 场景，把 需求分层、视觉规范、Draw.io XML 生成、导出 串成一条链路。它默认采用 国网蓝轻量化极简政企风：扁平化、单一国网蓝色系（主蓝 #005BAB）、无渐变、无阴影、无装饰图标，重点保留层级架构、交互链路和通信协议。

核心能力

• 架构分析：识别系统类型、3-5 层架构、核心模块、调用关系和外部接口。
• 规范绘制：统一层级容器、功能模块、数据库、外部系统容器、连接线标签和交互编号。
• 格式生成：输出 Draw.io 可识别的 mxGraphModel XML。
• 智能导出：生成 .drawio；用户指定时导出带嵌入式 XML 的 PNG/SVG/PDF，便于继续编辑。

工作流程

先确认系统类型、层次、模块、接口和输出格式；再选择智能体平台、综合服务平台、数据治理或智能客服等架构模式；随后应用国网蓝配色、容器边界和连接线规范。HTTP 请求/调用用单向实线，WebSocket 双向流用双向虚线，数据写入用深蓝实线，连接线旁用 ① ② ③ 标注步骤并保证与图例一致。最后写入文件，文件名用小写字母和连字符，如 system-architecture.drawio，再按需导出。

适用边界与注意点

适合技术架构、分层视图、交互链路和协议标注，不建议替代详细 UML、网络拓扑或数据库 ERD。单个架构图建议不超过 30 个模块，复杂系统应拆成多个视图。生成 XML 时不能在注释中使用 --，属性值中的 < > & " ' 必须转义，每个 mxCell 的 id 要唯一，所有元素要有 parent="1"。箭头方向、旁路走线和序号规范还需参考 troubleshooting.md 中的检查清单。详细视觉规范见 architecture-guide.md。