Forge Viewer中DiffTool扩展的工作原理与自定义对比逻辑咨询

API 探路者

2026-10-2

DiffTool模型对比逻辑与自定义实现方案

1. 默认模型对比核心逻辑

当前主流模型DiffTool扩展的默认匹配规则按优先级排序如下：

第一优先级：元素内置全局唯一ID（UUID/Element GUID）
第二优先级：元素在模型树中的完整父层级路径
第三优先级：元素属性组合（名称、类型、核心参数值）

相同元素被误标记为新增/修改的问题，核心原因是删除前序元素后，同层级后续元素的相对位置索引、层级路径计算值发生变更：如果模型上传时会重新生成元素ID、或是DiffTool默认关闭了ID优先匹配规则，路径变更会导致原版本的元素匹配失败，进而被误标记为Removed，新版本对应元素被误标记为Added。部分基于模型文件原始结构对比的工具，还会因为删除节点后子节点顺序索引整体偏移，触发大面积Modified误判。

2. 自定义对比逻辑的可行实现方案

方案1：调整内置规则优先级

进入DiffTool扩展的设置界面，开启「元素唯一ID优先匹配」选项，关闭「层级路径校验」「相对位置校验」相关开关，绝大多数场景下可直接解决同元素因位置变更导致的误判问题。

方案2：编写自定义匹配规则脚本

主流DiffTool均开放了自定义匹配逻辑的扩展能力，你可以根据自身需求编写匹配脚本，指定用于元素匹配的核心字段，示例逻辑如下：

# 示例匹配规则：仅以元素类型、全局ID、名称作为匹配依据，忽略路径、位置信息
def is_same_element(elem_v1, elem_v2):
    return (elem_v1["type"] == elem_v2["type"]
            and elem_v1["guid"] == elem_v2["guid"]
            and elem_v1["name"] == elem_v2["name"])

不同工具的脚本语法、入参结构存在差异，可参考对应扩展的开发者文档调整实现。