Appearance
3.5 注册模型供推理使用
注册 = 把导出的模型登记进模型注册表,推理端才能按名字找到它。 未注册的模型对推理端不可见——这是最多新人踩的「我明明导出了」坑。
注册流程
- 导出完成页直接点「注册模型」,或
模型 → 注册表 → 注册; - 填写注册信息:
| 字段 | 要求 |
|---|---|
| 模型名称 | 全团队唯一,语义化,如 line3_scratch_detector |
| 版本号 | 与导出文件版本对应,如 v1.2 |
| 来源训练任务 | 自动关联,回溯指标与数据版本的依据 |
| 用途描述 | 一两句话:什么场景、替代什么、已知限制 |
| 适用工况 | 光照/角度/速度范围——写清楚,防误用 |
- 确认注册,状态默认为「候选」。
模型生命周期
| 状态 | 含义 | 谁能改 |
|---|---|---|
| 候选 | 已注册,小批量验证中 | 训练工程师 |
| 生产 | 推理端默认加载的版本 | 管理员 |
| 归档 | 保留记录,不再加载 | 管理员 |
推理端怎么用
- 推理端(或 Studio 内推理工具)按「模型名称 + 版本/状态」加载:指定版本 = 精确复现;指定「生产」 = 永远拿当前上线版。
- 加载时自动读取元数据:输入尺寸、类别映射、预处理要求——推理端不需要手工对齐这些。
- 切换模型只改配置不改代码。
注册表管理
模型 → 注册表 是团队级资产台账:
| 列 | 说明 |
|---|---|
| 名称/版本 | 主键 |
| 状态 | 候选/生产/归档 |
| 指标 | 注册时带入的 mAP、关键类 Recall |
| 来源 | 训练任务 → 数据集版本 → 项目,一路可点 |
| 适用工况 | 防误用的护栏 |
| 最近验证记录 | 谁、何时、什么结论 |
生产状态变更需谨慎
把「候选」提成「生产」等于换产线模型,必须有小批量试产结论 + 管理员批准。注册表支持一键回滚到上一个生产版本——回滚能力是敢升级的前提。
常见问题
| 现象 | 处理 |
|---|---|
| 推理端搜不到模型 | 未注册或名称拼错;确认状态非「归档」 |
| 两个同名版本冲突 | 版本号规则没统一;按「语义化版本」重注册 |
| 换了模型推理结果全变 | 工况不匹配或类别映射不一致;核对注册表的适用工况 |
| 注册表条目太多 | 定期归档旧版本;归档不删记录,只退出加载 |
下一步 → 第 4 部分 · 团队协作——模型上了产线,协作侧的工作还没完。