Visio 安全图纸

解决什么问题

画架构图时，Visio/Draw.io 产出的图形经常遇到文本溢出、连线端点漂移、中英文标签换行异常、SVG 被浏览器或图片管线渲染成坏图。visio-safe-diagrams 把 .drawio 当作可编辑主文件，先生成稳定的 SVG，再按交付检查表验证，适合需要可复现图纸的团队。

工作流与能力

核心步骤：

• 优先创建或修复 .drawio，保持 未压缩、内联 的 mxGraphModel，避免把 XML 当文本塞入节点，也避免用 base64/deflate 包一层。
• 对必须对齐参考图的线条，使用固定点边：边节点设置坐标与几何，减少依赖 source/target 自动路由带来的偏移。
• 元素按 root cells、标题/背景、边与边标签、设备/组件框的顺序放置，保持可读性和导出稳定性。
• 用 scripts/drawio_to_svg.py 从 .drawio 生成 SVG，脚本会复制固定点边、拆分标签文本、按框加 clipPath，并对中英混排做保守换行，输出 UTF-8。

交付前检查：.drawio 能解析且存在 mxGraphModel、几何属性使用 as="geometry"、中文标签在 UTF-8 下可见、SVG 可解析，并实际渲染检查无坏图、文字不出框、标签不盖住关键连线端点。

适用边界

它适合 Visio 安全风格的架构/设备图、需要可编辑源文件和 SVG 成品的场景。若输入是压缩或 base64 的 .drawio，或缺少内联 mxGraphModel，需要先用 Draw.io 导出未压缩 XML 或手工修复。它也偏重布局稳定与兼容性，不替代复杂流程图语义建模。