用途:该技能面向 diagrams.net / draw.io 的 .drawio、mxfile 文件,目标是在保持图表语义稳定的前提下提升可扫描性,通过减少连接线、方框和文字之间的碰撞,并统一路由、间距与标签处理。
主要能力:
- 识别杂乱来源,例如横穿主体内容的长回边、压在繁忙连接线上的边标签、高度不足以容纳换行文字的节点,以及被放置在连线通道上的注释或容器标题。
- 做语义优先的整理:不重命名节点、不删除连接、不改变流程,除非用户明确要求;优先采用重路由、调整尺寸、增加间距或处理标签的方式。
- 规范布局:每页保持一个主导流向(通常为从左到右),把例外与反馈回路安排在图表外围,而非穿过中部;同级节点保持对齐并留出可见间隙。
- 先清理连线再移动节点:保留 orthogonalEdgeStyle(除非文件已有其他确定风格),为长边或回边添加显式路径点,为带标签的连线设置白色标签背景与内边距,缩短边标签并把解释性文字移入独立文本注释。
- 按需清理节点:优先加高方框而非缩小字号,保留 whiteSpace=wrap;若连线仍与文字冲突,把文字移入独立注释单元或让连线绕开方框。
- 复查 XML,重点检查风险较高的边:路径点坐标是否穿过其他节点边界,外围长路径是否避开容器与标题区域。
使用方式: 先读取 references/layout-rules.md(当图表边数较多或存在长回边时),再检查目标 .drawio / mxfile 并定位杂乱来源;按上述顺序调整,最后重新阅读 XML 校验高风险连线。资料给出的样式片段为: style="edgeStyle=orthogonalEdgeStyle;rounded=0;jettySize=auto;html=1;strokeWidth=2;labelBackgroundColor=#FFFFFF;labelBorderColor=none;spacing=6;" 长回边的外围路径点示例: <Array as="points"> <mxPoint x="1560" y="60" /> <mxPoint x="425" y="60" /> </Array>
默认规则:空间允许时,同级节点间留约 40–80 px;为长回线保留顶部或底部通道;节点标签优先控制在 2–3 行,内容更长时调整方框尺寸;边标签保持简短(如 extract、append row、test only);多句说明使用独立注释块。
输出期望:保持差异紧凑可读,说明具体重路由或调整尺寸的边与节点;若文件过于密集无法一次安全处理,应明确说明并建议拆分为多页或分泳道。
适用场景:需要维护 draw.io / diagrams.net 图表可读性的场景,尤其是边较多、存在长反馈回路或边标签拥挤的工程与流程示意图。
限制:资料未提供收费、价格、平台兼容版本与效果量化等信息;该技能以 XML 层面的小幅编辑为主,不负责改写图表语义,也不保证一次处理即可修复高度密集的图表。