下载模型产物
模型训练完成或检查点导出后,模型产物保存在平台的对象存储中。你可以下载产物,在本地做离线分析,或在自己的环境中加载使用。
前置条件
| 条件 | 说明 |
|---|---|
| 角色 | FAE 或研发工程师 |
| 模型状态 | 模型版本已登记(训练完成或检查点已导出) |
产物包内容
模型产物以 .tar.gz 压缩包提供,解压后结构如下(以 ACT 模型为例):
text
pick_place_v1_v20261020-01/
├── model_card.json # 模型卡:来源、数据集版本、步数、模型家族
├── checkpoint/
│ └── model.safetensors # 模型权重
├── config.json # 模型结构与超参快照
├── normalization.json # 观测与动作的归一化统计量
├── inference.yaml # 推理配置:相机、控制频率、动作分块
└── manifest.sha256 # 产物文件校验值| 文件 | 用途 |
|---|---|
model_card.json | 记录训练任务 ID、数据集版本、模型家族、步数、进度百分比(检查点)与导出时间 |
checkpoint/ | 权重文件 |
config.json | 加载模型时需要的结构参数 |
normalization.json | 推理时对观测做归一化、对动作反归一化 |
inference.yaml | 输入相机、控制频率等推理参数 |
manifest.sha256 | 校验下载完整性 |
不同模型家族的文件可能略有差异,以 model_card.json 中的说明为准。
下载步骤
- 进入「模型部署 → 模型管理」,找到目标模型。
- 点击 详情,选择要下载的版本。
- 点击 下载,浏览器开始下载产物包。
- 下载完成后校验文件完整性:
bash
tar -xzf pick_place_v1_v20261020-01.tar.gz
cd pick_place_v1_v20261020-01
sha256sum -c manifest.sha256全部显示 OK 即下载完整。
读取模型卡
python
import json
with open("model_card.json", encoding="utf-8") as f:
card = json.load(f)
print(card["model_family"], card["step"], card["dataset_versions"])使用注意事项
- 归一化一致:推理时必须使用产物包中的
normalization.json,否则动作输出会失真; - 相机与频率一致:推理时的相机配置与控制频率应与
inference.yaml一致; - 在真机上运行前先验证:建议通过 NexCore 部署与评测完成真机验证,再在其他环境中使用;
- 保留来源:分发模型时一并保留
model_card.json,便于追溯训练数据与版本。
常见问题
| 问题 | 处理 |
|---|---|
| 没有下载按钮 | 当前角色没有下载权限,或平台策略关闭了下载 |
| 校验失败 | 重新下载;仍失败请提交问题反馈并附模型版本 |
| 本地加载报结构不匹配 | 确认使用了产物包内的 config.json 与对应模型家族的代码版本 |

