设施与模型
星火管网智绘平台模型包：安装官方模型包、导入导出团队共享包
要点速览
模型包是扩展名为 .spmodel 的模型与映射方案合集，入口为「模型」选项卡 → 共享 → 模型包。官方模型包在「官方在线」中一键安装（需本机在线激活、个人版及以上），离线授权导入随合同提供的 .spmodel 文件；团队共享包用「导出团队包」把自建模型和映射方案打包给同事，导出和导入团队包都需要团队版及以上。
本篇讲星火管网智绘平台的模型包：怎样安装官方模型包、怎样把本单位做好的设施模型和映射方案打包分享给同事，以及导入时的签名与授权规则。适合负责统一团队模型标准的项目负责人和实施工程师。模型的日常管理见 模型中心。
什么是模型包 #
模型包是一个 .spmodel 文件（压缩包），里面包含：
- 包信息：名称、版本、发布者、是否官方；
- 若干模型文件（GLB）及其属性（编码、专业、分类、插入点、贴合方式、参数化设置等），每个文件附 SHA-256 校验值；
- 可选的映射方案。
模型包分两种：
| 类型 | 来源 | 签名 | 导入后 |
|---|---|---|---|
| 官方模型包 | 官网在线下载，或离线项目随合同提供 | 必须有官方签名并校验通过 | 模型加密存放，绑定本机授权；标「官方」，不能修改文件、不能再导出 |
| 团队共享包 | 本单位成员用「导出团队包」生成 | 不签名 | 模型以「模型包」来源入库，可像自建模型一样编辑 |
单个模型包不超过 2 GB。
入口与界面 #
入口：「模型」选项卡 → 共享 → 模型包，或在模型中心顶部切换到「模型包」。
面板顶部有两个页签和两个按钮：
| 控件 | 说明 |
|---|---|
| 已安装 | 本机已安装的模型包：名称、版本、模型数量、安装日期，以及「官方」或「团队」标签 |
| 官方在线 | 当前授权可下载的官方模型包 |
| 导入模型包 | 选择本地 .spmodel 文件导入 |
| 导出团队包 | 把自建模型和映射方案打包（团队版及以上可用） |
当前授权不含模型包时，按钮左侧显示小锁和「当前套餐不含模型包」。
安装官方在线模型包 #
- 切换到 「官方在线」 页签，软件向官网查询当前授权可下载的模型包。
- 列表中每个包显示名称、版本、模型数量、大小（MB）和说明。
- 点 「安装」（已安装过的显示为「更新」），按钮显示「处理中…」直到下载并安装完成。
- 完成后提示「已导入「包名」，共 N 个模型」，模型出现在模型库中，来源为「模型包」。
下载完成后软件会核对文件哈希，不一致时提示「模型包下载不完整或被篡改（哈希不符），请重试」。下载地址有时效，提示 HTTP 错误时重新点「安装」即可。
在线安装的条件
- 本机需要在线激活。离线激活的电脑会提示「本机尚未在线激活，无法获取在线模型包（离线版请导入随合同提供的模型包文件）」。
- 需要个人版及以上。当前套餐不含时提示「当前套餐不含在线模型包，请升级到个人版及以上」。
- 列表为空时显示「当前授权下暂无可下载的模型包」。
导入模型包文件 #
适用于离线授权随合同交付的官方包，以及同事发来的团队共享包。
- 点 「导入模型包」，选择 .spmodel 文件。
- 弹出「模型包内容」确认框，显示包名、版本、发布者，「已签名」或「未签名（团队包）」，模型数量和前 20 个模型的编码与名称。
- 点 「导入」。成功后提示「已导入「包名」，共 N 个模型」。
导入时软件会：
- 先校验包内每个模型文件的哈希，全部通过才写入，不会出现装了一半的情况；
- 同一个包（包 ID 相同）再次导入时覆盖为新版本；
- 把包内的映射方案写入方案库，相同 ID 的方案更新为包内版本；
- 团队包中的模型编码与本机已有模型重复时，自动在编码后加短后缀，避免冲突。
常见拒绝原因：
| 提示 | 原因 |
|---|---|
| 不是星火智绘管网的模型包 | 文件不是 .spmodel 格式，或已损坏 |
| 官方模型包缺少签名，拒绝导入 / 模型包签名校验失败 | 官方包被修改过，请重新获取 |
| 模型“X”文件校验失败，模型包可能已损坏或被修改 | 传输过程中文件损坏 |
| 当前授权不包含该模型包，请升级套餐 | 该官方包需要更高的授权等级 |
| 该模型包授权给其他单位，不能在本机使用 | 离线交付的官方包绑定了授权单位名称，与本机授权的单位不一致 |
| 导入团队共享模型包需要团队版授权 | 当前套餐不能导入未签名的团队包 |
| 模型包超过 2 GB 上限 | 文件过大 |
导出团队共享包 #
把本单位做好的自建模型和映射方案分享给同事，让整个团队用同一套设施模型和映射规则。
- 点 「导出团队包」，弹出对话框，说明为「将选中的自建模型和映射方案打包，供团队成员导入（团队版及以上）」。
- 填写 包名称（最多 60 字）。
- 左列勾选要打包的自建模型（包含已停用的自建模型），右列勾选要打包的自定义映射方案。内置模型、官方模型和内置方案不会出现在列表中。
- 点 「导出」，选择保存位置，默认文件名为「包名称.spmodel」。
导出的包版本号为导出当天的日期（如 2026.10.13），发布者为当前授权所属的单位名称。
至少要选一个模型
只勾选映射方案、不勾选任何模型时会提示「请至少选择一个模型」。映射方案中引用的模型如果没有一起打包，同事导入后对应规则会因找不到模型而不生效，请把方案用到的自建模型一并勾选。
同事拿到 .spmodel 文件后，在自己电脑的模型包面板中点「导入模型包」即可。导入后，在 映射方案 中能看到随包带来的方案，在管线建模时选择它即可。
套餐限制
- 安装官方在线模型包：个人版及以上，且官方包所需的授权等级不超过本机授权；
- 导出团队包、导入团队包：团队版及以上（「导出团队包」按钮在其他套餐下置灰）；
- 官方授权模型不能导出共享，会提示「“模型名”是官方授权模型，不能导出共享」。