1. 解决方案用途与核心优势
REVIT.ClashViewer 的核心价值是节省专业人员的时间。打开报告时，解决方案会检查碰撞是否仍然有效，并自动筛除和隐藏不代表真实碰撞的记录：
- 碰撞双方实际上是同一个模型构件的虚假重复记录；
- 已经修正、构件不再相交的碰撞；
- 其中一个或两个构件已从模型中删除的碰撞。
如果第二个构件位于已卸载或根本未链接的链接模型中，解决方案会发出警告。链接不可用不等同于构件已删除或碰撞已解决。
解决方案还允许将处理任务移交给在第二个模型中工作的专业人员，并通过附加文件、截图和其他资料进行讨论。专业人员可将时间用于当前有效的问题及其协调，而不必手动核查过时的问题记录。
本解决方案可适用于任意坐标系统和 Navisworks 报告格式。它能够按参与碰撞的元素 ID 过滤结果，因此无论报告来自逐个导出 Revit 文件后创建的 Navisworks 模型，还是来自一次导出的综合模型，用户都只会看到与自己模型相关的碰撞。因此，BIM 专业人员无需为每位设计人员单独准备报告，设计人员也不必手动筛除其他专业的碰撞——每个人只会看到与 Revit 当前打开模型中的元素有关的碰撞。
REVIT.ClashViewer 在 Revit 中始终可用的可停靠面板内打开报告。设计人员留在自己的工作模型中，选择需要的行并单击“转到”。解决方案会准备 3D 视图，在冲突区域周围创建局部 section box，按 ID 匹配并选择元素，并在需要时临时隔离它们。
这样，Navisworks 报告就从一个列出问题的外部文档变成了模型中的工作导航器。设计人员无需查找坐标、复制 ID 或手动创建 3D 视图，而是可以立即进入一个局部区域，在其中检查并修复冲突。
图 1.“Navisworks Clashes”命令位于 RS-Systems 选项卡中，用于打开可停靠的碰撞面板。
2. 碰撞处理流程的变化
传统报告分发方式 | 使用 REVIT.ClashViewer |
|---|
BIM 协调员按专业或模型拆分公共报告。 | 一份公共报告分发给所有参与者。 |
设计人员需要在其他专业的碰撞中手动查找自己的碰撞。 | “仅当前模型”过滤器根据 ElementId 判断碰撞归属。 |
坐标必须手动核对和转录。 | 可在面板中选择坐标模式，并可按元素 ID 导航。 |
每个碰撞都需要手动创建 3D 区域。 | section box 会自动围绕碰撞点或元素边界创建。 |
必须分别查找对象并手动启用隔离。 | 元素会被自动选择，并可自动隔离。 |
每次都要在项目文件夹中查找报告。 | “最近”列表中最多可访问 12 个最近打开的报告。 |
3. 支持的 Navisworks 报告格式
当前实现可读取 Navisworks Manage 生成的主要报告类型：
- 具有 exchange → clashtest → clashresult 结构的 XML 报告；
- XLSX 报告，包括多页、多工作表的工作簿；解决方案会读取并处理单个文件中所有相关工作表的数据；
- 结果汇总在统一表格中的表格式 HTML 报告；
- report/viewpoint 格式的非表格式 HTML 报告；
- 扩展名为 .html 或 .htm 的 HTML 文件；文件类型还会根据内容进行识别。
解决方案会从报告中提取测试名称、碰撞名称、GUID、状态、距离、碰撞点、对象 ID、图层、元素名称与类型、注释以及图像链接。图像支持相对于报告文件路径的 JPG、JPEG 和 PNG 链接。
实际优势 无需要求 BIM 专业人员专门为插件创建特殊格式。可以直接使用标准 Navisworks XML 或 HTML 报告，并将快照文件夹保存在报告旁边。 |
|---|
图 2. 报告在右侧可停靠面板中打开：碰撞列表可与 Revit 模型同时保持可见。
4. 坐标系统和单位
解决方案提供三种确定工作区域的模式。因此，即使 NWC 导出规则或项目共享坐标设置不同，也可以使用同一个工具。
模式 | 位置如何确定 | 适用场景 |
|---|
共享 (Shared) | 将报告中的点视为共享/测量坐标，并通过当前 Project Location 转换为活动文档的内部坐标系统。 | 模型通过共享坐标对齐的标准协调流程。 |
内部 (Project) | 报告中的点在进行单位转换后作为 Revit 内部坐标使用。 | 导出以内部原点为基准，或报告坐标已经与文件内部坐标系统一致。 |
按元素 (ID) | 报告坐标不是主要依据：section box 根据在宿主模型中找到的元素边界创建。 | 综合模型的坐标不可靠、与当前打开的专业模型存在偏差，或报告由不同导出方式生成的文件组合而成。 |
对于 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 m 的范围。用户可针对大型机电系统增大该值，也可针对密集协调区域减小该值。
在 Shared 和 Project 模式下，插件不会盲目信任 Navisworks 坐标。如果按 ID 找到宿主模型元素，报告中的点会根据它们的包围框进行修正：优先移动到两个包围框的交集；如果没有交集，则移动到元素组合范围。该算法可补偿综合模型与当前打开专业模型之间的固定偏移。
在“按元素 (ID)”模式下，box 会直接围绕找到元素的边界并按指定余量创建。如果没有找到宿主元素，但报告中包含碰撞点，则插件会回退到基于坐标的导航。
防止相机“飞走” 设置 section box 后，解决方案会带少量余量精确缩放到其角点。远处几何体或错误的链接点不应把局部协调区域缩小到只有几个像素。 |
|---|
9. 元素选择与临时隔离
“隔离”复选框控制活动 3D 视图的临时 Hide/Isolate 模式。启用后，选择另一行会立即更新隔离状态，设计人员无需每次都单独运行命令。
- 宿主模型中的元素会被直接选择并隔离。
- 对于链接模型中的对象，会隔离相应的链接实例。
- 清除复选框会关闭临时隔离，同时保留已创建的 section box。
- 复选框状态会被记住，并在下次启动插件时继续使用。
此模式适合处理密集的机电协调区域：视图中只保留参与冲突的元素，同时设计人员可以快速关闭隔离查看周边环境，而不会丢失局部 section box 区域。
 |  |
所选碰撞的详细信息以及隔离完成提示。 | 局部 section box 中被隔离的模型片段。 |
10. 状态、搜索和快速过滤
报告可按 Navisworks 标准状态过滤：全部、新建、活动、已解决、已批准和已审阅。俄语和英语 HTML 报告中的状态会统一映射到内部状态体系。
搜索框不仅检查碰撞名称，还会搜索：
- 碰撞名称；
- 参与对象的简要说明；
- 元素 ID；
- 元素名称和类型；
- 报告中的图层。
状态过滤、搜索和“仅当前模型”可同时使用。例如，工程师可以只显示当前模型中的新碰撞，然后进一步查找涉及特定立管、设备类型或 ID 的冲突。
图 6. 状态过滤：新建、活动、已解决、已批准和已审阅碰撞。
11. 自动识别已修复的碰撞
- 碰撞双方实际上是同一个模型构件的虚假重复记录；
- 已经修正、构件不再相交的碰撞；
- 其中一个或两个构件已从模型中删除的碰撞。
如果第二个构件位于已卸载或根本未链接的链接模型中，解决方案会发出警告。链接不可用不等同于构件已删除或碰撞已解决。
需要理解的重要说明 解决方案根据可用模型的当前状态检查报告记录是否仍然有效，包括构件是否存在以及是否仍然相交。更新后模型的最终协调检查通过在 Navisworks 中重新运行碰撞测试完成。 |
|---|
12. 详细信息、快照、注释和表格列
选择某一行后，面板下部会显示碰撞数据：名称、测试、距离、坐标、每个对象的 ID、名称、类型和图层。如果报告包含关联快照，并且文件存在于指定的相对路径，则会加载到预览中，同时不会锁定源文件。
默认情况下表格保持紧凑，但可通过表头右键菜单启用更多列：
所选列集合会保存在用户设置中。设计人员可以保持最简列表，而 BIM 协调员可启用测试、状态、距离和注释，以便分析报告。
图 7. 所选碰撞的详细卡片：两个对象的坐标、ID、名称、类型和图层。
13. 报告历史和个人设置
插件会保存最近打开的最多 12 个报告。用户可以直接从下拉列表重新打开需要的 XML 或 HTML 报告，无需返回文件选择对话框。
会保存以下个人设置：
- section box 尺寸；
- 坐标模式；
- 默认隔离状态；
- “仅当前模型”过滤器状态；
- 显示列集合；
- 最近报告历史。
设置和历史记录按 Revit 版本分别保存。用户可以为 Revit 2021 和 Revit 2027 使用不同的工作参数，而不会相互混用。
图 8. 最近打开的报告列表可快速在不同碰撞集合之间切换。
14. 设计人员的实际工作流程
1. 获取公共 Navisworks XML 或 HTML 报告，以及生成的图像文件夹（如有）。
2. 打开自己的 Revit 工作模型，并在 RS-Systems 选项卡中运行“Navisworks Clashes”。
3. 打开报告，并保持“仅当前模型”复选框启用。
4. 选择坐标模式。建议先使用 Shared；如果坐标不一致，则使用 Project 或“按元素 (ID)”。
5. 如有需要，筛选新建或活动碰撞并使用搜索。
6. 启用“隔离”，然后逐行单击“转到”。
7. 修正模型，并依次处理下一个碰撞。
8. 发布更新后的模型后，将其发送给 BIM 协调员以重新执行碰撞测试。
日常工作流程 报告 → “仅当前模型” → 状态 → “转到” → 修正 → 下一个碰撞。主要工作都在 Revit 内完成，无需手动查找坐标或元素。 |
|---|
15. BIM 专业人员的实际工作流程
BIM 专业人员可以保持统一的报告生成流程，而无需为每个专业准备单独文件。
1. 在 Navisworks 中为所有模型和专业创建统一的碰撞测试集合。
2. 将报告导出为包含对象 ID 的 XML 或 HTML；需要时包括快照和注释。
3. 将同一套资料分发给项目所有参与者。
4. 确定项目推荐的坐标模式和标准 section box 尺寸。
5. 接收更新后的模型，并在每轮修正后重新运行 Navisworks 碰撞测试。
这样，BIM 协调员负责公共报告的质量和重复几何验证，而设计人员可直接在自己的文件中独立获得各自需要处理的碰撞集合。
参与者 | 执行的工作 | 获得的结果 |
|---|
BIM 专业人员 | 创建一份公共报告，并在更新后重新执行碰撞测试。 | 减少手动分类工作，也减少需要准备的独立资料包。 |
专业设计人员 | 按当前打开的模型过滤，并在 Revit 中解决冲突。 | 只显示相关碰撞，并可立即导航到问题区域。 |
团队负责人 | 监控本专业新建/活动问题的处理情况。 | 无需发送大量独立文件即可形成清晰工作流程。 |
16. 当前版本的限制和重要特性
- 解决方案会读取报告，但不会把修改后的状态写回 Navisworks，也不提供双向同步。
解决方案根据可用模型的当前状态检查报告记录是否仍然有效，包括构件是否存在以及是否仍然相交。更新后模型的最终协调检查通过在 Navisworks 中重新运行碰撞测试完成。
- 模型过滤依赖报告中保存的数字 ElementId。如果报告不包含 ID，或对象重新创建后 ID 已改变，则无法进行匹配。
- 只有已加载的链接会参与链接文件中的搜索。
- 对于链接中的对象，Revit 可以选择和隔离链接实例，而不一定能把嵌套元素作为独立的宿主对象处理。
- “按元素 (ID)”box 模式使用找到的宿主模型元素边界；如果没有可用元素，则插件会回退到基于坐标的导航。
- 导航需要合适的 3D 视图。如果不存在，应创建或打开一个。
- HTML 解析器针对代码中支持的 Navisworks 表格式和非表格式结构设计；经过大幅修改的第三方 HTML 可能无法识别。
17. 兼容性、主题和界面语言
项目包含 Revit 2021–2027 的构建版本。Revit 2021–2024 使用 .NET Framework 4.8，Revit 2025–2026 使用 .NET 8，Revit 2027 使用 .NET 10。
可停靠面板会自动适应 Revit 的浅色和深色主题。界面根据 Revit 语言进行本地化，并包含 16 种界面语言的翻译表，包括俄语、英语、德语、法语、西班牙语、意大利语、波兰语、捷克语、葡萄牙语、日语、韩语和中文。
面板可以停靠在 Project Browser 或 Properties 旁边，使碰撞列表在修正模型时始终保持可见。
18. 优势与总结
REVIT.ClashViewer 连接了 Navisworks 中的模型检查与 Revit 中的问题修正。它并不取代 Navisworks Manage 的几何碰撞检测功能，而是把 Navisworks 报告转换成每位设计人员都可以直接使用的工作工具。
一句话概括 REVIT.ClashViewer 一份公共 Navisworks 报告 → 按当前打开模型中的 ID 自动过滤 → 选择坐标模式 → section box → 选择并隔离 → 在 Revit 中修正碰撞。 |
|---|
功能 | 实际结果 |
Navisworks XML 和 HTML 报告 | 无需特殊准备即可使用标准报告格式。 |
按 ElementId 的“仅当前模型”过滤器 | 每位专业人员都能在公共报告中看到自己的碰撞。 |
在宿主和已加载链接中搜索 | 解决方案同时适用于专业工作模型和综合模型。 |
Shared / Project / By Elements | 可在不同坐标系统和导出方式下正常导航。 |
根据元素边界修正碰撞点 | 在坐标存在偏移时，降低导航到错误区域的风险。 |
自动 section box 和缩放 | 碰撞会立即显示在局部空间中。 |
选择与临时隔离 | 无需手动查找即可清楚看到参与冲突的元素。 |
状态和全文搜索 | 大型报告可快速缩减为可处理的工作列表。 |
快照、注释和详细信息 | 问题上下文可直接在模型旁查看。 |
12 个报告的历史记录和个人设置 | 重复的日常工作可以更快完成。 |
对项目团队而言，最大优势是 BIM 专业人员只需生成一份高质量公共报告，而每位参与者无需额外手动分类即可从中获得与自己相关的碰撞集合。设计人员可以把时间用于修正模型，而不是寻找问题和准备视图。
