BIM引擎底座 · 操作手册

文档版本：0.26 ｜ 最近核对日期：2026-11-09

1. 使用范围

本手册描述首期操作流程。依据最新测试与验收记录，本机开发环境已跑通RVT导航、上传、转换、解析、几何预览、检查发布与历史读取；远程开发环境到引擎网络仍受阻，不能将本机结果外推为所有环境可用。生产已发布并有接口验证记录，尚未完成生产真实业务模型验收。2026-11-09用户决定本期按RVT收口，PAK支持延期。

首期支持模型上传、转换、全量构件与属性入库、预览和检查后直接发布。进度绑定、进度着色、CAD 及专业工程量统计不在本手册操作范围内。

2. 使用前准备

1. 已在工程基础中建立有效单位工程，线路、标段、工点与标准专业齐备，账号具有该标段工点组合或同线整线授权。
2. 账号具有模型查询权限；上传、重新处理、预览、发布和源文件下载按需分别授权。
3. 准备RVT文件。每份文件属于一个单位工程，可覆盖该工程全部内容，也可仅为主体结构、风亭等局部范围。PAK支持后续提供，本期不作为可用格式承诺。
4. 专业由单位工程带出，不另填；综合专业下的局部范围写在模型名称中。同工点多份模型集中查看前，源模型坐标应一致。

系统在上传处展示当前格式与大小限制。RVT 的具体软件版本兼容范围以部署环境验证结果为准。不能将文件改扩展名后当作支持格式上传。

3. 查找模型与建立资产

开发库入口：BIM引擎底座 → 模型管理。

左侧使用与单位工程台账一致的“工程台账导航”。默认“在建＋空间视图”，可切换规划/运营或合同视图：

• 空间视图：线路 → 工点 → 标段 → 单位工程。
• 合同视图：线路 → 标段 → 工点 → 单位工程。

点击节点，右侧立即显示对应范围的模型；点击工点汇总有权访问的单位工程模型，点击单位工程只看它的模型。树搜索支持线路、工点、标段、单位工程名称及编码；无模型的单位工程也可选。页面不设置独立查询卡，模型名称和专业筛选放在列表工具栏，选中单位工程后专业自动显示。

上层节点右侧数字表示单位工程数，单位工程叶节点数字表示模型数。先在树中选中单位工程，再点“新建模型”；上层汇总视图会提示先选择单位工程。查看版本或预览返回时恢复原导航位置。

新建时填写：

字段	填写方式
单位工程及工程路径	由左树当前单位工程带入，只读显示线路、工点、标段及工程名称
专业	由单位工程带出，不重复选择
模型名称	描述该文件范围，例如“主体结构”“1号风亭”；同一单位工程可建立多份模型

资产建好后上传首个版本。模型名称以后可调整，工程归属不通过编辑转移。误归属文件应重新在正确单位工程建立和上传，避免影响历史记录。已有模型的单位工程受到引用保护，不能通过删除工程或调整标段清除其归属。

4. 上传并查看处理结果

1. 在模型版本区选择“上传版本”，选择RVT文件；既有页面如仍展示PAK选项，不代表PAK已完成验证，本期请使用RVT。
2. 上传成功后，系统记录原文件及版本序号并自动开始后续处理。
3. 查看处理阶段：上传引擎、排队/转换、解析入库、完整性核查。
4. 解析完成后核对内部文件数、构件数及属性条数，并进入预览检查。

原文件上传达到 100% 不代表模型可用。离开页面不会停止后台处理，系统通过私有化后台安全传输与自动推进，返回后可查看最新状态；构件树根节点自动标准化呈现为带版本号的文件名称（如 复盛站主体结构_V1.rvt）。

提示	含义与处理
待处理/排队	等待平台任务或转换服务处理
转换中	正在生成几何资源和引擎数据；显示实际阶段进度
解析中	正在把全量构件和属性写入平台；此时不能发布
核查中	正在核对文件覆盖、构件集合及属性读取结果
处理成功	全量解析核查已完成，仍须检查画面与数据后发布
处理失败	查看失败阶段和原因；解决问题后对未发布版本选择重新处理

重新处理不会改写其他已发布版本。仅解析失败且转换成果仍有效时，系统复用已有成果重新解析，无需重新上传原文件；上传或转换结果未明时先核实远端状态，不盲目重复处理。已经发布的版本不能原地重新转换或解析；模型文件有变化时上传新版本。

5. 预览与查看构件属性

5.1 检查一个版本

从版本记录进入“预览”。检查模型是否实际显示、是否缺少明显部分、单位和方向是否正常。如出现“引擎已响应加载但未取得构件几何”等提示，该状态不得视为检查通过；本机已通过的RVT样本不应再沿用早期几何不可用结论。可旋转、缩放、平移或复位；从构件树选择对象，或在画面点击构件进行定位与属性查看。

部分构件只有信息而没有可显示几何，这些构件仍应出现在解析数据中。属性按照原始分组显示；同名属性、空值和零值不会自动合并。解析尚未完成时，画面可能先可检查，但属性区域会提示数据未就绪。

5.2 集中查看一个工点

从工点进入集中预览，选择需同时查看的已发布模型，可包含有权访问的不同单位工程及多份局部模型。从单位工程进入时只加载该工程的模型，从标段内工点进入时保留标段范围。模型列表按单位工程组织并可切换显隐，选择构件后显示其实际所属工程、模型和版本。

线路或跨工点标段视图只汇总台账，请下钻到工点或单位工程再集中预览；不在同一场景叠加不同工点。

未发布版本不会自动进入集中查看。个别模型加载失败时会列明失败对象，其他已加载模型可继续查看。如果各模型明显错位，应核查源模型坐标；首期不提供在页面拖动模型完成配准的功能。

5.3 查询入库数据

在具体版本中查看构件列表，可按构件名称或属性分组、名称、原始值筛选，分页查看结果。选中构件后查看其完整属性，并在模型具备几何时定位。

这些资料用于后续业务检索和统计，不自动形成工程量结论。不同模型的单位、分类或属性名称可能不同，不能将同名字段直接当作统一工程量汇总。

6. 检查后发布

当前状态：几何画面未通过（部署资源侧限制），因此本步骤尚不能完成实际检查与发布；下面的流程为设计行为，接口前置校验已生效。

具有发布权限的人员执行：

1. 确认该版本转换与全量解析已成功，文件、构件及属性计数合理。
2. 打开预览，确认实际几何显示，抽查代表性构件属性与原模型一致。
3. 在发布操作中确认已完成检查，再执行发布。
4. 核对该版本变为当前发布版本，并显示发布人和发布时间。

发布不走审批流程，上传人也可在具有发布权限时完成发布。系统不会因为引擎返回成功回调就自动确认检查通过。

新版本发布前，已有当前发布版本继续使用。新版本失败不会让旧版本下线。首期不提供撤回发布、删除历史或一键回滚动作。

7. 换版、历史与下载

模型更新时在原资产下“上传版本”，不要为同一持续交付模型反复建立新资产。新版本完成检查并发布后成为当前版本，旧版保留为历史发布版本。

查看历史时确认页面标题中的版本号；画面、构件树及属性应全部属于该版。历史资源无法读取时系统应明确报错，不以最新模型替代。具有源文件下载权限时可从对应版本下载原文件。

首期只保存构件匹配所需标识，不处理下游业务绑定。以后接入业务关联时，稳定标识唯一匹配成功的关系自动继承，异常由人工处理；目前不限定一个构件能关联多少个进度项。

8. 常见问题

问题	处理方式
看不到单位工程或模型	核查当前建设状态、树搜索和工程授权；有同工点其他标段权限不代表能访问该单位工程
新建模型按钮不可用	先在左侧树选中具体单位工程，再核查新增/上传权限；没有单位工程时先维护工程基础
同一单位工程已有模型还能上传吗	可以。独立局部范围新建资产，同一模型更新则上传新版本
上传成功但一直不能预览	检查转换及资源处理阶段；上传成功不代表几何已生成
页面有引擎背景但没有模型	不执行发布；检查具体模型加载错误及资源情况，由维护人员定位
解析失败但画面正常	画面与属性处理是不同环节，先解决解析失败并完成完整性核查
某构件无属性	可能是源文件确实未提供；须区别“无属性”和“属性读取失败”
原模型有属性，系统里没有	保留模型版本、构件名称和缺失属性说明，核查转换配置和解析覆盖，不自行补造原值
发布按钮不可用	查看是否仍在处理、检查未确认或缺少发布权限
模型叠加错位	核查源模型坐标与转换设置，首期不在浏览器中人工配准
为什么看不到进度和CAD	首期建设基础模型能力，这些功能属于后续模块接入范围

反馈问题时提供工点、标段、单位工程、模型名称、版本号、发生时间和可见错误提示。不要发送密码、访问令牌或包含敏感信息的网络日志。