droboticflow-new/docs/annotation-operations.md
2026-08-17 20:44:16 +08:00

2.1 KiB
Raw Blame History

标注生产闭环

/annotation-operations 提供项目级语义模板、供应商分组、逐段标注、质检、验收、返工和工时统计。平台全局角色仍负责系统权限,业务分工由项目成员关系单独表达:

  • annotator:提交首轮标注或返工 revision。
  • quality_reviewer:对当前 revision 做质检通过或打回。
  • acceptance_reviewer:对质检通过的 revision 做最终验收。

每个成员关系同时绑定 projectId、workgroupId 和 vendorId。除管理员、流程工程师和兼容管理员外,后端只返回当前用户所在分组的任务、模板、分组和工时事件;前端隐藏不是安全边界。

核心接口

  • GET/POST /api/annotation-workgroups
  • GET/POST /api/annotation-memberships
  • GET/POST /api/annotation-templates
  • POST /api/annotation-templates/{id}/publish
  • GET/POST /api/annotation-tasks
  • GET /api/annotation-tasks/{id}
  • POST /api/annotation-tasks/{id}/revisions
  • POST /api/annotation-tasks/{id}/reviews
  • GET /api/annotation-workload-summary

模板必须发布后才能创建任务。时间段必须位于 clip 范围内、不能重叠,置信度必须位于 [0, 1]。质检或验收拒绝会把任务转为 rework 并指向下一 revision,不在工作流 DAG 中建立环。

工作量口径

首次 revision 产生 outputDelta=1;返工 revision 记录工时和返工次数,但 outputDelta=0,因此不会重复增加正式产出。质检、验收及拒绝原因分别记录为不可变工作量事件,汇总可按用户、供应商、分组和模板版本查询。

泛宇算子

custom-operators/fanyu-annotation/operator-definitions.json 登记两个 draft 算子:

  • Orbbec Ego 数据标准化:将视频、PTS、IMU、音频和标定对象配对为 droboticflow.orbbec.normalized/v1。
  • 版本化语义预标:将视频动作分段映射为 droboticflow.semantic.prelabels/v1。

两者在独立镜像构建、digest 固定、真实工作流验收和 artifact/lineage 回读前保持 draft,不能借用其他镜像的 digest 标记为已发布。