Appearance
5.1 常见问题 FAQ
按环节分组。先在这里对现象,没有对应条目再走 5.3 故障排查清单。
安装与启动
Q:启动闪退怎么办? A:先升级显卡驱动;再检查 VC++ 运行库;用命令行启动看输出(1.1)。
Q:换电脑后项目打不开? A:项目数据在「工作目录」,不在安装目录。从旧机器拷贝工作目录中的项目文件夹,或当初导出过项目文件则直接导入。
Q:应用变卡? A:画布上对象过多时正常现象;检查视图全量扫描期间也会卡。大项目按帧范围分区处理。
账户与协作
Q:登录后看不到项目? A:确认左上角团队空间正确;让管理员确认你已被加入项目成员。
Q:提交报「版本落后」? A:他人先提交了。先回传、处理冲突,再提交(4.2)。
Q:冲突界面不敢点? A:对照双方提交说明逐对象裁决;拿不准先「采用对方的」保底,自己的改动在本地历史里可找回(提交前本地快照保留 7 天)。
Q:换机器怎么继续? A:旧机器释放副本前确保已提交;新机器登录后检出工作副本即可。
导入与标注
Q:导入数量对不上? A:哈希去重跳过了重复文件,看导入报告的跳过清单。
Q:视频导入后时间轴断档? A:抽帧中间失败。重抽该片段,或对失败片段单独转码后导入。
Q:快捷键失灵? A:输入法处于中文状态会吞快捷键;切到英文输入法,或检查是否焦点在输入框里。
Q:标注能撤销多少步? A:当前会话内全量可撤销;保存并关闭项目后撤销栈清空——大批量操作前先保存。
Q:分割标注文件特别大? A:掩膜按像素存,属正常。控制单帧对象数、及时归档旧版本可缓解。
数据集版本与训练
Q:改了标注,训练用的还是旧数据? A:训练只认数据集版本。改完标注要重新生成版本,并在训练配置里换数据源(2.4)。
Q:val 指标很高,现场很差? A:高度怀疑划分泄漏(同序列跨集合)。改「按序列划分」重新生成版本重训(3.3 归因表)。
Q:训练启动即 CUDA OOM? A:降 batch 或 imgsz;确认没有别的任务占着显卡(3.2)。
Q:loss 出现 NaN? A:数据含异常(空白图/越界标注)或 lr 过大。先跑检查视图,再降 lr 重试。
Q:能中途改数据集吗? A:不能。中止任务 → 处理数据 → 生成新版本 → 用 checkpoint 断点续训(数据变了续训未必划算,多数情况重开)。
Q:导不出模型? A:未过评估门禁(3.3)。确需提前导出走管理员豁免并记录。
导出与注册
Q:推理端找不到模型? A:导出 ≠ 注册。去 3.5 完成注册。
Q:ONNX 推理结果和训练端不一致? A:关掉 simplify 重导、核对 opset 与输入尺寸(3.4)。
Q:同名模型多个版本? A:注册表按「名称+版本」管理,推理端指定精确版本即可;清理时归档旧版。
附录功能
Q:预标注结果很差还要用手标? A:是。预标注是草稿生成器,价值在「改比画快」,不在替代人(附录 B)。
Q:缺陷合成能直接用吗? A:仅限扩充训练数据,且需人工抽检;不得用于生成「交付用」样本(附录 C)。
下一步 → 5.2 错误码