droboticflow/docs/raw-human-workflow.md

2.9 KiB
Raw Permalink Blame History

原始数据持续接入与人工闭环交付

范围与流程

新增独立模板,不修改现有预处理模板或已有任务:

持续扫描 → 目录读取 → 原始文件配对/基础校验 → 人工切片与标注 → 质检/返工 → 抽样最终验收 → 无姿态打包交付

不执行去畸变、人脸模糊、Qwen、HeadPose、HandPose。每个 part 独立 Run、独立人工任务和抽样决定;等待人工不占自动并发。创建项目仍需配置成员、字典、监听目录和交付目录;新实例默认不启动。

隔离约定

  • 通过人工节点的 PROCESSING_PROFILE=raw_human 生成 Run 的固定处理模式,再传入人工批次、标注任务和最终验收任务。
  • 缺少模式字段的旧记录保持原逻辑,不根据“缺少模型文件”推断无姿态模式。
  • 新模板使用独立 digest 固定的标准化、打包镜像;不修改旧算子库镜像或原模板固定引用。
  • 左右视频与左右 PTS 独立端口绑定;无 Qwen 时初始化全覆盖切片,不伪造模型产物。
  • 原视频不做几何变换或自动脱敏。标注/验收界面明确提示;其他任务池、字典、切片和审核交互保持一致。
  • 新模式不要求姿态决策或排除原因;旧模式仍要求 include/exclude。打包同时校验节点模式与验收证据模式,拒绝混用。
  • 无姿态交付清单记录 not_generated、未去畸变、未脱敏,不生成空姿态文件,也不声称经过人工姿态检查。

数据检查

沿用目录齐全/稳定性检查;新模式在进入人工前核验视频解码帧数、PTS 行数与递增、已有 meta 帧数,并保留同 part 的 IMU 文件匹配要求。按用户要求,暂时注释掉 raw-human 专属 IMU 内容/全覆盖校验调用,允许视频与 IMU 的 part 边界不完全重合;这不代表 IMU 已通过覆盖校验。不新增人工转码确认开关,不重写设备时间戳。两份标定原样进入交付。

发布

先构建独立 raw-normalizer 和 raw-package 镜像,再部署 API/Worker。API 设置 FANYU_RAW_NORMALIZER_IMAGE 和 FANYU_RAW_PACKAGE_IMAGE 为已验证摘要后,模板列表才注册新模板及独立 release。

发布不自动启动监听、不迁移已有任务、不修改原模板。停止新模板的接入不影响旧模板处理。

验证门槛

  • 新模板仅四节点,旧模板序列化内容不变,首次初始化与重复注册幂等。
  • 新模式无 Qwen、无姿态可完成任务和验收;旧模式缺失姿态决策仍拒绝。
  • 0%/100% 抽样打包均可用;无姿态文件、原始视频与标定不被前置算法修改。
  • 旧预处理模板、切片/描述修改、质检返工和交付保护回归。
  • 新旧验收界面模式切换、旧控件保留、新模式隐藏姿态控件。

真实业务完整交付须由项目成员按角色完成;单元/隔离测试和发布健康检查不能替代实际业务验收。