droboticflow/docs/fanyu-v5-workflow.md
2026-09-01 02:40:27 +08:00

5.2 KiB
Raw Permalink Blame History

泛宇 Capture 持续处理工作流 v5.8

泛宇业务数据层级固定为:

项目 → Capture 目录 → 切片

工作流只是 Capture 的处理配置,不是数据层级。泛宇全部页面、接口、目录和交付文件统一使用“项目、Capture、切片”三个业务概念;通用数据集算子的行业数据结构不受影响。

生产流程

持续监听 → Capture 完整/稳定检查 → 独立 Run → 标准化 → 双目去畸变 → 左右目脱敏 → Qwen 时间窗口建议 → 标注员真实切分与语义标注 → 同供应商审核 → 固定概率抽样 → 平台最终验收(抽中时)→ 自动打包交付

  • 监听器只扫描指定 BOS 前缀下的一级目录,不依赖目录名称。
  • 正式 Capture 需要左右视频、左右 PTS、IMU、Camera/IMU Calibration 和 source-manifest.json。
  • 文件齐全后至少两次指纹一致并满足 30 秒稳定窗口,才创建独立 Run。
  • (workflowId,capturePrefix,fingerprint) 唯一,重复扫描不会重复运行。
  • 自动算子按节点临时创建 Job/Pod,完成即释放;等待人工不占用 CPU/GPU,也不阻塞后续 Capture。

可变运行策略

正式工作流接收中仍可修改:

  • maxConcurrentCaptureRuns:每条持续工作流同时自动处理的 Capture 数,默认 2。
  • acceptanceSampleProbability:最终验收固定抽样概率,范围 0~1,默认 0.5。

接口:

  • GET/PATCH /api/workflows/{id}/runtime-policy
  • GET /api/workflows/{id}/runtime-policy/history

降低并发不会中止正在运行的 Capture,提高后等待队列立即补位。概率修改作用于所有尚未作出抽样决定的 Capture;已有抽样决定不可修改或重抽。

自动算子边界

  • 标准化输出双目视频、左右 PTS、IMU 和 Calibration。
  • 去畸变先于人脸脱敏,左右目均输出可播放的脱敏视频及检测摘要。
  • Qwen 只读取完整左目脱敏视频和绝对 PTS,只输出 [startTimestampUs,endTimestampUs) 建议窗口、置信度和建议标签,不生成切片视频。
  • HeadPose 和 WiLoR HandPose 是并行证据分支,不被描述成标注节点输入视频。
  • Qwen、HeadPose、WiLoR 失败关闭,不生成模拟结果。

人工切分和标注

  • 一个 Capture 创建一个公共标注任务;标注员领取时原子绑定其项目供应商。
  • 同一标注员完成切分校正和语义标注,可以先切后标或边切边标。
  • 切片没有最短、最长时长或动作边界限制,但必须在 1ms 容差内首尾相连、无空洞、无重叠,并完整覆盖双目/IMU 共同有效区间。
  • 切片使用半开区间 [start_us,end_us)。
  • 提交时才真实物化左右 MP4、左右 PTS、IMU、annotation.json 和 synchronized-slice.json。
  • 左右 PTS 行数必须等于各自视频帧数,PTS 单调递增,IMU 必须有序且覆盖窗口,否则提交返回 422。
  • Camera/IMU Calibration 在 Capture 根目录保留一份,切片 manifest 只引用文件名和 SHA;Audio/Audio PTS 不处理、不交付。

审核、抽样和验收

  • 审核单位是完整 Capture;审核员与标注员属于同一供应商,且不能审核自己的提交。
  • 打回必须填写原因、备注和至少一个问题切片,整个 Capture 返回原标注员并生成新 Revision。
  • 质量审核通过后,服务端执行一次不可变伯努利抽样并记录概率、策略修订、随机值和时间。
  • 抽中时系统创建项目级匿名最终验收任务;未抽中时直接释放自动打包。
  • 最终验收池隐藏供应商、标注员、审核员和历史分配信息。
  • 最终验收拒绝后返回质量审核阶段,保留原抽样结果,不重新抽样。
  • 新 v5.8 验收只提交决定、原因、备注和 HeadPose/HandPose include|exclude,不要求数字准确率、完整率或等级。

交付目录

Capture/
├── calibration/
│   ├── calibration_camera.yaml
│   └── calibration_imu.yaml
├── clips/
│   ├── slice-000001/
│   │   ├── left.mp4
│   │   ├── right.mp4
│   │   ├── left_pts.csv
│   │   ├── right_pts.csv
│   │   ├── imu.csv
│   │   ├── annotation.json
│   │   └── synchronized-slice.json
│   └── ...
└── packages-manifest.json

packages-manifest.json 包含完整覆盖证据、Calibration、文件 SHA、lineage、Pose 决策和 acceptanceSampling。未抽中的 Capture 明确记录 not_selected,抽中的 Capture 记录最终验收证据。

权限和统计

  • 项目角色仅使用 annotator、quality_reviewer 和 acceptance_reviewer;cutter 只读兼容历史任务。
  • 活动任务通过 ProjectMember 绑定项目、供应商和角色。
  • 组织标签字典由管理员维护,项目只选择启用范围;每个任务保存标签快照。
  • 当前只展示提交、时长、返工、审核和验收原始计数,不计算效率分、质量分、排名或结算金额。

验收边界

本地编译和测试只证明代码质量。最终验收必须在泛宇环境回读浏览器操作、RBAC、Kubernetes Job/Pod、Mongo 状态、BOS 文件、PTS/帧数、IMU、SHA 和交付 manifest。