1. 工具用途与主要优势

REVIT.ClashViewer 的主要优势是节省专业人员的时间。打开报告时，工具会检查碰撞是否仍然有效，并自动筛除及隐藏不对应实际碰撞的记录：

• 两个参与对象实际为同一模型图元的虚假重复碰撞；
• 已经修正、图元不再相交的碰撞；
• 一个或两个图元已从模型中删除的碰撞。

如果第二个图元位于已卸载或根本未链接的模型中，工具会发出警告。链接不可用不等同于图元已删除或碰撞已解决。

工具还可将处理任务交给在另一个模型中工作的专业人员，并围绕碰撞展开讨论，附加文件、截图及其他资料。专业人员因此可以把时间用于当前任务及其协调，而非手动核查过时的问题。

工具支持任意坐标系和 Navisworks 报告格式，可按碰撞参与图元的 ID 筛选，仅显示当前模型的碰撞。不论 Navisworks 模型由各 Revit 文件分别导出后组合而成，还是由联合模型一次导出，都可使用。因此，BIM 专业人员无需为每位设计人员单独准备报告，设计人员也无需手动筛除他人的碰撞：每个人始终只看到涉及当前打开模型图元的碰撞。

REVIT.ClashViewer 在 Revit 中持续可用的可停靠面板内打开报告。设计人员无需离开工作模型，只需选择相应行并点击“转到”。工具准备 3D 视图，在冲突区域周围创建局部 section box，按 ID 匹配图元，选中它们，并可按需临时隔离。

这样，Navisworks 报告便从列出问题的外部文档转变为模型中的工作导航器。专业人员无需按坐标查找、复制 ID 或手动创建 3D 视图，即可直接获得定位后的区域，检查并解决冲突。

图 1。“Navisworks Clashes”命令位于 RS-Systems 选项卡，可打开碰撞可停靠面板。

2. 碰撞工作流程的变化

3. 支持的 Navisworks 报告格式

当前实现可读取 Navisworks Manage 生成的主要报告形式：

• 采用 exchange 结构的 XML 报告 → clashtest → clashresult;
• XLSX 报告，包括多页和多工作表工作簿；工具读取并处理同一文件所有相关工作表中的报告数据；
• 将结果汇总在同一表格中的表格型 HTML 报告；
• report/viewpoint 格式的非表格型 HTML 报告；
• 扩展名为 .html 或 .htm 的 HTML 文件；还会根据内容识别文件类型。

从报告中提取测试名称、碰撞名称、GUID、状态、距离、碰撞点、对象 ID、图层、图元名称与类型、备注及图像链接。图像支持相对于报告文件位置的 JPG、JPEG 和 PNG 链接。

图 2。报告在右侧可停靠面板中打开，碰撞列表与 Revit 模型可同时使用。

4. 坐标系与单位

工具提供三种工作区域定位模式，因此可适应不同的 NWC 导出规则和项目共享坐标设置。

对于 XML 报告，代码会使用报告记录的单位：米、毫米、厘米、英尺和英寸。当前版本对 HTML 报告按米处理。

图 3。选择共享坐标、内部坐标，或按图元及其 ID 构建区域的模式。

5. 按当前模型的图元 ID 筛选碰撞

工具的核心功能是“仅我的模型”复选框。加载报告后，插件会检查每个碰撞对象，尝试在当前 Revit 文档中查找具有报告所列数字 ID 的图元。只要至少一个碰撞对象在主体文档中找到，就认为该碰撞属于当前模型。

筛选不依赖 NWC 名称、模型名称、测试名称或 BIM 协调员组合 Navisworks 文件的具体方式。判定依据是 Navisworks 保存在对象数据中的 ElementId。

如果在当前模型中没有找到任何碰撞，工具不会只留下空表格：它会自动取消筛选，显示所有结果，并提示 ID 可能不匹配，或报告属于其他模型。

图 4。“仅我的模型”筛选器、坐标模式、隔离设置与报告前几行。

6. 匹配主体模型与链接文件中的图元

跳转到碰撞时，先在当前主体模型中检查每个 ID；若未找到图元，再搜索所有已载入的 Revit 链接模型。因此，插件既可用于单一专业的工作文件，也可用于包含链接的联合协调模型。

• 主体模型图元直接选中。
• 若对象位于链接内部，则选中并隔离相应的 RevitLinkInstance 实例。
• 未载入的链接不参与搜索。
• 没有几何类别的辅助图元和类型不会被当作碰撞对象。

7. 在 Revit 中定位碰撞

点击行内“转到”按钮或双击碰撞即可跳转。工具依次执行以下操作：

1. 使用当前 3D 视图。若当前不是 3D 视图，则尝试切换到第一个合适的可打印 3D 视图。

2. 将报告对象与主体模型及已载入链接中的图元匹配。

3. 按所选坐标模式确定工作区域中心。

4. 启用 section box 并设置其边界。

5. 选中找到的图元或链接实例。

6. 根据复选框状态启用或重置临时隔离。

7. 按确定的边界缩放至 section box。

用户立即进入限定范围，而不是整个模型的总体 3D 视图。在大型项目中这一点尤其明显：由于远处几何或放置错误的链接，标准 Zoom to Fit 可能使目标区域几乎无法看见。

图 5。跳转结果：局部 section box、已选中的匹配图元，并可通过临时隔离隐藏模型其余部分。

8. Section Box、位置校正与工作区域尺寸

工作区域尺寸以立方体的半边长表示，单位为米。值 0,5 表示每个坐标轴方向保留 ±0,5 米范围的立方体。用户可针对大型机电系统增大范围，或针对密集节点缩小范围。

在 Shared 和 Project 模式下，插件不会完全依赖 Navisworks 坐标。如果按 ID 找到主体模型图元，会依据其范围校正报告中的点：优先吸附到两个图元包围范围的交集；若没有交集，则使用图元合并后的范围。此算法可补偿联合模型与当前专业模型之间的固定偏移。

在“按图元（ID）”模式下，直接围绕找到的图元范围构建 box，并留出指定余量。如果未找到主体图元但报告中有点坐标，则回退为按坐标定位。

9. 图元选择与临时隔离

“隔离”复选框控制当前 3D 视图的临时 Hide/Isolate 模式。启用后，选择其他行会立即更新隔离状态，设计人员无需每次再执行单独的命令。

• 主体模型图元直接选中并隔离。
• 对于链接模型内的对象，隔离相应的链接实例。
• 取消勾选会关闭临时隔离，但保留已创建的 section box。
• 复选框状态会被记住，并用于下次启动。

此模式适合修正密集的机电节点：窗口中只保留冲突参与对象，设计人员也可随时关闭隔离查看周边环境，同时保留 section box 限定的局部区域。

所选碰撞的详细信息与已执行隔离的提示。	局部 section box 中隔离的模型片段。

10. 状态、搜索与快速筛选

可按 Navisworks 的标准状态筛选报告：全部、新建、活动、已解决、已核准和已审阅。俄语与英语 HTML 报告中的状态会统一为同一内部体系。

搜索框不仅检查碰撞名称，还会搜索：

• 碰撞名称；
• 参与对象的简短描述；
• 图元 ID；
• 图元名称与类型；
• 报告中的图层。

状态筛选、搜索与“仅我的模型”可同时使用。例如，工程师可先仅显示当前模型的新建碰撞，再查找特定立管、设备类型或 ID 对应的冲突。

图 6。按新建、活动、已解决、已核准和已审阅状态筛选碰撞。

11. 自动识别已修正的碰撞

• 两个参与对象实际为同一模型图元的虚假重复碰撞；
• 已经修正、图元不再相交的碰撞；
• 一个或两个图元已从模型中删除的碰撞。

如果第二个图元位于已卸载或根本未链接的模型中，工具会发出警告。链接不可用不等同于图元已删除或碰撞已解决。

12. 详情、截图、备注与表格列

选择一行后，面板下部显示碰撞数据：名称、测试、距离、坐标、各对象的 ID、名称、类型与图层。如果报告包含关联截图，且文件位于所指定的相对路径，将在预览中加载，且不会锁定原文件。

表格默认保持紧凑，也可通过列标题的右键菜单启用附加列：

• 测试；
• 状态；
• 距离；
• 点；
• 对象；
• 备注。

所选列组合会保存到用户设置中。设计人员可保留最简列表，BIM 协调员则可启用测试、状态、距离和备注，以分析报告。

图 7。所选碰撞的详细信息卡片：两个对象的坐标、ID、名称、类型与图层。

13. 报告历史与个人设置

插件保存最多 12 份最近打开的报告。用户可从下拉列表重新打开所需 XML 或 HTML，无需返回文件选择对话框。

按用户保存以下设置：

• section box 尺寸；
• 坐标模式；
• 默认隔离状态；
• “仅我的模型”筛选器状态；
• 显示的列组合；
• 最近报告历史；
• 窗口位置与尺寸。

设置与历史按 Revit 版本分别保存。用户可为 Revit 2021 和 Revit 2027 使用不同的工作参数，互不混淆。

下拉列表支持边输入边搜索，包括“最近使用”列表：仅保留匹配行，Enter 选择找到的项，Esc 清除搜索。

图 8。最近打开的报告列表便于在不同碰撞集合间快速切换。

14. 设计人员的实际工作流程

1. 获取统一的 Navisworks XML 或 HTML 报告，以及生成的图像文件夹（如有）。

2. 打开自己的 Revit 工作模型，在 RS-Systems 选项卡启动“Navisworks Clashes”。

3. 打开报告，保持勾选“仅我的模型”。

4. 选择坐标模式。建议从 Shared 开始；若坐标不一致，则使用 Project 或“按图元（ID）”。

5. 按需筛选新建或活动碰撞，并使用搜索。

6. 启用“隔离”，逐行点击“转到”。

7. 修正模型，并依次处理下一个碰撞。

8. 发布更新模型后交给 BIM 协调员，重新进行碰撞测试。

15. BIM 专业人员的实际工作流程

BIM 专业人员可保持统一的报告生成流程，无需为每个专业单独准备文件。

1. 在 Navisworks 中为所有模型与专业建立统一的碰撞测试集。

2. 导出包含对象标识符的 XML 或 HTML 报告，按需包含截图与备注。

3. 将同一个文件包交给项目的所有参与者。

4. 明确项目推荐的坐标模式与 section box 常用尺寸。

5. 接收更新模型，在一轮修改完成后重新执行 Navisworks 碰撞测试。

由此，BIM 协调员负责统一报告的质量和复查几何，而设计人员可直接在自己的文件中独立获取需要处理的碰撞集。

16. 当前版本的限制与重要特性

• 工具读取报告，但不会将修改后的状态写回 Navisworks，也不执行双向同步。

工具依据当前可用模型的状态检查报告记录是否仍有效，包括图元是否存在及是否仍然相交。更新模型的最终协调检查仍需在 Navisworks 中重新运行碰撞测试。

• 模型筛选依赖报告中保存的数字 ElementId。若报告不含 ID，或对象重新创建后 ID 已改变，则无法匹配。
• 仅搜索已载入的链接文件。
• 对于链接内的对象，Revit 允许选择和隔离链接实例，但不一定能将内部图元作为独立的主体对象操作。
• “按图元（ID）”构建 box 的模式使用找到的主体模型图元范围；若未找到，则回退为按坐标定位。
• 定位需要合适的 3D 视图。若没有此类视图，应先创建或打开。
• HTML 解析器针对代码中已支持的 Navisworks 表格型与非表格型结构；经大幅修改的第三方 HTML 可能无法识别。
• 模型旁的 RS.CDE 文件夹，以及讨论、指派和累积碰撞数据库，仅在用户首次写入时创建，包括发送消息、指派任务、向累积数据库导入报告、更改状态、转交或添加附件。打开模型、面板与报告不会在磁盘上创建任何内容。

17. 兼容性、主题与界面语言

项目提供 Revit 2021–2027 的构建版本。Revit 2021–2024 使用 .NET Framework 4.8，Revit 2025–2026 使用 .NET 8，Revit 2027 使用 .NET 10。

面板与所有工具窗口支持“自动”“浅色”“深色”和 RS-Systems 主题，颜色与 Revit 保持一致。在“自动”模式下，主题实时跟随 Revit 切换，也会更新已打开的窗口。界面按 Revit 语言本地化，包含 16 种界面语言的翻译表，包括俄语、英语、德语、法语、西班牙语、意大利语、波兰语、捷克语、葡萄牙语、日语、韩语和中文。

可将面板停靠在 Project Browser 或 Properties 旁，使碰撞列表在修改模型时始终可见。

工具窗口中的按钮与列表支持键盘操作：Enter 执行主要操作，Esc 取消。窗口不会在 Windows 任务栏创建独立按钮，并会在会话间记住位置与尺寸。

面板底部的齿轮“⚙ 设置”打开工具设置窗口，提供主题、许可、更新和 Revit 视图选项卡着色。齿轮上的圆点表示有可用更新；“所有 RS-Systems 工具的更新…”按钮会一次检查全部已安装的系列插件，并在同一个窗口显示。

视图选项卡着色便于区分已打开的文档：按项目或文件颜色填充整个选项卡（默认），或在顶部显示色条。活动选项卡不会比其他选项卡更亮，而是通过项目颜色的色条标识。

也可从 RS.BIMManager 应用程序通过等同于点击功能区按钮的命令打开面板。

18. 优势与总结

REVIT.ClashViewer 将 Navisworks 中的模型检查与 Revit 中的问题修正连接起来。工具不替代 Navisworks Manage 的几何碰撞测试，而是让其报告成为每位设计人员方便使用的工作工具。

对项目团队的主要价值在于：BIM 专业人员生成一份高质量的统一报告，各参与者无需额外手动分类即可获得自己的碰撞集。设计人员把时间用于修改模型，而非查找问题和准备视图。