外观
04 自动标注与故障排查
自动标注
自动标注只接受当前数据集成功训练记录输出的best.onnx，并要求模型类别与当前数据集完全一致。
- 在训练工具中选择一张正式图片。
- 在右侧 自动标注选择成功训练输出模型，填写
0..1阈值。 - 点击画布工具栏中的 自动标注。
- 图片已有标注时确认是否整体替换；识别完成后逐框检查类别和边界。
- 结果不合适时使用撤销，再调整阈值或手工修正。
自动标注是起点，不是训练数据验收。空检测结果也会替换当前标注，因此确认前应检查图片和模型是否正确。
故障速查
| 现象 | 处理 |
|---|---|
| 抓抓没有可选模型 | 在当前项目重新导入.onnx，不要只把文件放在项目外部目录 |
| 检测测试始终无结果 | 确认活动图片和范围，清空期望类别后从默认阈值重新测试 |
| 阈值数组报数量错误 | 阈值数组必须与期望类别数量一致；需要统一阈值时只填一个数字 |
| 替换模型后结果没有更新 | 重新选择模型并再次检测；仍异常时关闭并重新打开抓抓会话 |
| 训练包或基础模型包不可用 | 选择解压后的目录根部，分别确认存在trainer.json或models.json |
| 无法开始训练 | 确认训练集、验证集都非空，且训练集至少有一张图片包含标注 |
| 自动标注模型被拒绝 | 从当前数据集的成功训练记录选择best.onnx，不要选择普通外部模型或其他数据集输出 |
| 数据集显示不可用 | 恢复原训练数据目录；训练数据不会随运行成品或缺少训练数据的项目包补齐 |
| 训练中不能修改数据 | 等待训练完成或停止训练；运行期间当前数据集会锁定 |
模型缺失导致打包失败时，回到源项目修复节点引用并重新保存，不要在成品目录中手工补模型。打包排障见项目打包故障排查。