用途:这是一个基于症状的 Draw.io 渲染错误诊断技能,针对“图表能渲染但看起来不对”的情况,帮助系统性地定位并修复视觉问题,避免误判为渲染引擎故障。
主要能力:提供主诊断决策树,按症状分支到具体章节,覆盖形状不可见、连线位置错误、标签截断/重叠/缺失、容器子元素错位或裁剪、字体渲染差异、编辑器正常但导出异常、形状重叠或未对齐等场景。每类问题给出检查顺序与修复建议,并附快速修复对照表。
关键检查点:形状不可见时依次检查 fillColor 与 strokeColor 是否都为 none、opacity 是否为 0、fillOpacity 与 strokeOpacity、宽高是否为 0、坐标是否超出画布、父容器是否折叠、noLabel 属性。连线错位时检查 perimeter 是否与形状匹配(椭圆用 ellipsePerimeter、菱形用 rhombusPerimeter 等)、exitX/entryX 等连接点是否在 0–1 范围、边几何是否带 relative="1"、是否存在过期路径点。标签问题检查 noLabel、value、textOpacity、fontColor、overflow、whiteSpace=wrap、形状尺寸与间距。容器问题检查父级 container=1、子元素是否使用相对坐标、resizeParent、childLayout、swimlane 的 startSize。字体问题涉及 fontStyle 位掩码(1=粗体、2=斜体、4=下划线、8=删除线)与安全字体列表。导出问题区分 SVG、PNG、PDF 的常见差异。
使用方式:按症状进入对应决策树,逐项核对属性并应用修复。资料强调布尔属性一律用 0/1,边几何必须包含 relative="1",容器子元素必须使用相对坐标。
适用场景:编辑或生成 Draw.io XML 后出现视觉异常时排查。限制:资料未提供具体安装命令、收费信息或平台支持范围;部分问题标注为已知限制(如渐变、CMYK 与 RGB 差异、rough.js 随机性),无法完全修复。