forked from longtao.wu/droboticflow
5.2 KiB
5.2 KiB
泛宇 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-policyGET /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。