Skip to content

下载模型产物 ​

模型训练完成或检查点导出后,模型产物保存在平台的对象存储中。你可以下载产物,在本地做离线分析,或在自己的环境中加载使用。

前置条件 ​

条件说明
角色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 中的说明为准。

下载步骤 ​

  1. 进入「模型部署 → 模型管理」,找到目标模型。
  2. 点击 详情,选择要下载的版本。
  3. 点击 下载,浏览器开始下载产物包。
  4. 下载完成后校验文件完整性:
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 与对应模型家族的代码版本

产品快速迭代中,表现效果以最新版本为准NexCore Docs · 鹿明机器人具身智能技能学习平台使用手册