跳到主要内容

迭代详情与操作

这个功能解决什么问题​

主动学习 一旦启动，每轮迭代会自己往下推进大半程，但中途你需要随时知道现在跑到哪一步、要不要去审核、要不要点确认导入。迭代详情页就是干这个用的。

本页讲清楚详情页上每块区域看什么、每个状态对应什么操作，让你守着这一张页面就能把整轮迭代跟完。

进入迭代详情页​

进入项目工作区的「主动学习」Tab，看到的是迭代总览。点列表里任意一条迭代，就会进入对应的详情页。

迭代详情页总览
图1：迭代详情页由状态横幅、统计卡片、迭代历史表、关键操作区组成

详情页主要由四块区域组成：顶部的状态横幅、下方的统计卡片、再往下的迭代历史表，以及随状态变化的关键操作按钮。右上角还有一个刷新按钮，方便随时同步最新状态。

状态横幅​

页面顶部一条横幅，写明当前迭代处在哪个状态、整体推进到第几步。

横幅上能看到什么
  • 状态徽章：当前状态（draft / training / annotating / reviewing / import_pending / imported / completed / failed）。
  • 进度文案：用一句话概括现在卡在哪一步，比如「等待人工审核」「训练进行中（已用 12 分钟）」。
  • 下一步建议：如果需要人工介入，横幅会明确说「请到数据标注模块完成审核」或「请确认导入」之类。

状态变化时横幅会自动刷新。如果你的页面停留了很久没动，点右上角的「刷新」按钮手动同步。

统计卡片​

横幅下方是一组数字卡片，一揽子看本轮迭代的关键指标。

字段类型必填默认值说明
训练 mAP统计可选—本轮训练任务的 mAP（来自输出模型版本）。还没训练完或训练失败时显示「—」。
审核通过数统计可选0本轮 AL 审核批次里已通过的图片数。审核环节开始后实时增长。
审核退回数统计可选0本轮 AL 审核批次里被退回的图片数。退回多说明模型在这批图上效果不好，需要人工重标。
图片总数统计可选—本轮选出的待审核图片总量（等于预算 images_per_round 的实际值）。
怎么判断这一轮值不值
  • 审核通过率（通过数 / 图片总数）越高，说明这一轮选出来的图越「干净」，AI 标得也准。
  • 退回数过高通常意味着选图模型质量不够，下一轮可以考虑换一个更强的基线 Artifact。
  • 训练 mAP 应该和上一轮对比看，趋势比绝对值更重要。

迭代历史表​

详情页中下部有一张迭代历史表，列出本项目里所有迭代的关键信息。

历史表列字段
  • 版本号：第几轮迭代（1, 2, 3...）。
  • 状态：当前状态徽章。
  • 基线 Artifact：这轮用的是哪个模型制品。
  • 创建时间：迭代创建的时间戳。
  • 完成时间：迭代进入 completed 的时间，未完成的显示「—」。
  • 点击任意一行会跳到那轮迭代的详情页。

历史表方便你回看之前每一轮的表现，决定下一轮要不要换基线模型、调预算、改训练参数。

关键操作（按状态）​

详情页底部的操作按钮会随当前状态变化，每个状态对应一组动作。下面按状态逐个说明。

draft：启动迭代​

  1. 确认配置

    详情页会列出基线 Artifact、训练参数、预算（images_per_round）。对照确认一遍没问题。

  2. 点击「启动迭代」

    点底部的「启动迭代」按钮。系统创建训练任务，状态变为 training，整个流程开始自动推进。

training：等待训练完成​

这一步不用你做什么

迭代自动创建了一个训练任务，正在跑。横幅会显示已用时长大致进度。

想看具体训练情况，点横幅上的「查看训练任务」链接，跳到训练 Tab 的对应任务详情。

如果训练失败，迭代状态会切到 failed，详情页会显示训练日志的关键错误行。

annotating：等待标注完成​

这一步也不用你做什么

训练刚结束，系统正在用新模型对选出的图做 AI 标注。完成后会自动推进到 reviewing。

这一步通常很快（推理 + 写标签），如果卡了很久，可能是因为批量标注任务被其他任务阻塞，进入项目「数据标注」Tab 看一下队列状态。

reviewing：去审核​

这是整个流程里唯一需要人工的环节。

  1. 进入数据标注 Tab

    在项目工作区左侧导航点「数据标注」。

  2. 找到本轮的 AL 审核批次

    找到名字以「主动学习第 N 轮」开头的批次，状态是「进行中」或「待复核」。点进去。

  3. 逐张或批量审核

    操作跟普通 AI 标注批次完全一致：通过 / 退回 / 反例标记 / 跳过。具体操作见图片级审核。

  4. 审核完回到迭代详情页

    当所有图都处理完（待审核数降到 0），系统自动把迭代状态推进到 import_pending。回到迭代详情页就能看到状态变了。

import_pending：确认导入​

审核全部完成，等待管理员把标签写回数据集。

  1. 检查导入预览

    详情页会显示本轮将导入的图片数、覆盖的标签数。如果担心覆盖丢数据，先去数据集页面发布一个版本做快照留底。

  2. 点击「确认导入」

    确认无误后点底部的「确认导入」。系统用覆盖模式（duplicate_handling=overwrite）把标签写回数据集工作区。

  3. 等待导入完成

    导入完成后，迭代状态自动推进到 imported。

imported：确认发布​

标签已经写回工作区，但训练用的是不可变版本，必须发布新版本才算数。

  1. 点击「确认发布」

    点底部的「确认发布」按钮。系统基于当前数据集工作区生成一个新的数据集版本。

  2. 等待发布完成

    发布完成后迭代状态自动进入 completed，本轮迭代彻底结束。

completed 或 failed：开启新一轮​

想跑下一轮

不管上一轮是 completed 还是 failed，详情页底部都会出现「开启新一轮」按钮。点它会基于上一轮的配置预填创建对话框，你可以微调基线 Artifact、训练参数或预算后再启动。

刷新按钮​

详情页右上角有一个「刷新」按钮。状态变化由系统推送，但偶尔会因为浏览器长开、网络抖动等原因没及时更新。怀疑状态不对时，点一下刷新按钮就能拉到最新数据。

什么时候需要手动刷新
  • 训练明明跑完了，详情页还显示 training。
  • 审核全部完成了，状态没从 reviewing 推进到 import_pending。
  • 页面开了很久没操作，担心数据陈旧。

接下来​

常见问题​

「确认导入」按钮是灰的

说明还有图没审完，迭代还在 reviewing 状态。回到数据标注 Tab 把 AL 批次里剩下的待审核图处理掉，状态推进到 import_pending 后按钮自然可用。

「确认发布」按钮是灰的

说明迭代还在 import_pending 状态，导入还没完成。先点过「确认导入」并等状态变成 imported，发布按钮才会亮起。

迭代卡在 failed 怎么办

详情页会显示失败发生在哪一步（训练 / 标注 / 导入 / 发布）以及错误信息。常见原因：训练 OOM、模型文件损坏、磁盘空间不足等。修好根因后点「开启新一轮」重新跑就行，失败的迭代不会阻塞新迭代。

能不能跳过某些步骤

不能。状态机的每一步都有它的意义（比如不导入就没法发布，因为版本是基于工作区生成的）。如果只是想用 AL 选出来的图，不想要完整流程，可以不用主动学习模块，直接在数据标注模块手动建批次做 AI 标注。