Skip to content

3.5 注册模型供推理使用 ​

注册 = 把导出的模型登记进模型注册表,推理端才能按名字找到它。 未注册的模型对推理端不可见——这是最多新人踩的「我明明导出了」坑。

注册流程 ​

  1. 导出完成页直接点「注册模型」,或 模型 → 注册表 → 注册;
  2. 填写注册信息:
字段要求
模型名称全团队唯一,语义化,如 line3_scratch_detector
版本号与导出文件版本对应,如 v1.2
来源训练任务自动关联,回溯指标与数据版本的依据
用途描述一两句话:什么场景、替代什么、已知限制
适用工况光照/角度/速度范围——写清楚,防误用
  1. 确认注册,状态默认为「候选」。

模型生命周期 ​

候选生产归档注册验证通过 + 管理员批准被新版本替代验证失败工况变更 / 退役
状态含义谁能改
候选已注册,小批量验证中训练工程师
生产推理端默认加载的版本管理员
归档保留记录,不再加载管理员

推理端怎么用 ​

  • 推理端(或 Studio 内推理工具)按「模型名称 + 版本/状态」加载:指定版本 = 精确复现;指定「生产」 = 永远拿当前上线版。
  • 加载时自动读取元数据:输入尺寸、类别映射、预处理要求——推理端不需要手工对齐这些。
  • 切换模型只改配置不改代码。

注册表管理 ​

模型 → 注册表 是团队级资产台账:

列说明
名称/版本主键
状态候选/生产/归档
指标注册时带入的 mAP、关键类 Recall
来源训练任务 → 数据集版本 → 项目,一路可点
适用工况防误用的护栏
最近验证记录谁、何时、什么结论

生产状态变更需谨慎

把「候选」提成「生产」等于换产线模型,必须有小批量试产结论 + 管理员批准。注册表支持一键回滚到上一个生产版本——回滚能力是敢升级的前提。

常见问题 ​

现象处理
推理端搜不到模型未注册或名称拼错;确认状态非「归档」
两个同名版本冲突版本号规则没统一;按「语义化版本」重注册
换了模型推理结果全变工况不匹配或类别映射不一致;核对注册表的适用工况
注册表条目太多定期归档旧版本;归档不删记录,只退出加载

下一步 → 第 4 部分 · 团队协作——模型上了产线,协作侧的工作还没完。