droboticflow/docs/raw-human-workflow.md

40 lines
2.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 原始数据持续接入与人工闭环交付
## 范围与流程
新增独立模板,不修改现有预处理模板或已有任务:
`持续扫描 → 目录读取 → 原始文件配对/基础校验 → 人工切片与标注 → 质检/返工 → 抽样最终验收 → 无姿态打包交付`
不执行去畸变、人脸模糊、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% 抽样打包均可用;无姿态文件、原始视频与标定不被前置算法修改。
- 旧预处理模板、切片/描述修改、质检返工和交付保护回归。
- 新旧验收界面模式切换、旧控件保留、新模式隐藏姿态控件。
真实业务完整交付须由项目成员按角色完成;单元/隔离测试和发布健康检查不能替代实际业务验收。