Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

3.8 KB
Raw Blame

类图公共主干冲突修复验收(#791)

范围与完成定义

修复接口继承、接口实现或普通关系共享同一个目标端口、覆盖对方线型/端点符号的问题。目标是让合法的自动关系保留正确的 UML 语义,并保留原有同类公共主干的阅读价值。

本轮按用户确认直接推进局部修复和 PR。范围以 Issue #791 的复现为起点;不新增 schema、配置、关系种类,也不改共享 Router 接口。

实现约束

  1. 主干候选仍按目标与关系种类分组,先保留原有节点障碍检查。
  2. 只允许同一候选组共享端口和走廊;检查本组与完整场景中组外路线的端点间距、重叠走廊及内部交叉。
  3. 有冲突时整组回退,通过现有普通路由器重新分配;仅发生回退后启用已有的独立端口模式,防止等高交错关系重新共享走廊。
  4. 每轮只删除冲突组,再检查剩余主干。候选集合单调缩小,最多候选组数次回退;不增加无界重试。
  5. 节点位置、文本、关系身份和方向不变。保留显式 via、侧边、直线路由及 labelAt;不增加对所有固定路线间距或任意布局成功的保证。 空数组 via: [] 在关系入口与省略字段统一;仅克隆需要归一化的条目,不改原始文档,非空路径仍保持显式控制。
  6. 正常同类主干保留反向绘制和 source-to-target 的 data-motion-path,Focus 与独立 SVG 导出继续使用正确语义。

验收记录

基线为 9ef09617bd9ed2fe7bb4ad17fba7c8fce6b0ce76,初版运行时代码的内容摘要记录在比较证据中。空 via 跟进的代码摘要及 18 个输出复核记录见跟进证据。

行为 检查及结果
主干+实现/依赖、混合双主干 standard/showcase,原序与逆序,公开 validate/render/check 及 SVG 几何通过
等高、交错的继承/实现 首次 fallback 实现仍失败;开启已有独立端口模式后通过
同类、独立 Storage 主干 保留共享主干;另一组回退不取消它
显式几何 via、侧边、straight 和 labelAt 保留
图与画布 关系身份、方向、节点边界及所有路径点的有限性/画布范围通过
浏览器交互与导出 light/dark 的 Focus 与 SVG 导出通过;原有同类主干的运动方向检查通过
兼容样例 18 个固定输入前后都通过公开命令;13 个完整 HTML/SVG 相同;4 个复现和已有 shapes 案例的路线改变
类型与成员信息 全部 9 个 Class 对比输入的节点位置、尺寸、文字与关系身份/种类一致
实际视觉观察 3 个案例、light/dark、前后共 12 张截图检查通过

初版 34 项 Class 专项、18 项核心 smoke、2 项真实 Chrome 检查及 generated 检查通过。空 via 跟进后 Class 专项为 41 项,Chrome 2 项与 generated 检查重新通过;旧 18 个输入的公开命令及输出字节重新核验一致。无需改写其他图类型的黄金结果;本轮没有执行本地 test:full,远端最终提交的适用 CI 另行验证并记录于 PR。

边界

  • 这是主干协调与局部回退,不是通用图布局保证。不同目标的复杂交错层次仍可能被现有 crossing 约束拒绝。
  • 固定几何保持原值,既有 Router 对固定与自动端点的全部间距边界不在本次修复范围。
  • 自动路线允许变化;测试保护关系语义、真实冲突和作者控制,不冻结自动坐标。
  • 实现与本地验收完成;维护者审查、合并、发布和安装各自独立。

详细截图、复现命令和包证据见验收证据。