# 数字人 / 视频素材质检自查清单 v1

> 出处：爱智工坊 2026-10-21《视频动态分析的 5 条铁律》配套清单。
> 每条都对应一次真实返工，数字为实测值，非经验估计。

## 0. 准备

- [ ] 分析分辨率固定 **540×960**（判断微动的中间层），最终结论一律回 **1080×1920** 全分辨率复核
- [ ] 所有中间产物落在处理节点，本机只留成品；本机工作区文件数 **≤ 500**
- [ ] 禁止在本机落 `*.raw` / `*.npy` / 抽帧 `*.png` / 中间态 `*.mp4`

## 1. 锚点与 ROI

- [ ] 用「黑底非黑像素包围盒顶部 − 23 px」求真实头顶 `T`
- [ ] ROI 用绝对偏移，不用画面高度百分比
  - face `(218, T+25, 76, 105)`
  - mouth `(236, T+75, 48, 40)`
  - torso `(160, T+140, 220, 220)`
  - legs `(170, T+485, 200, 380)`
- [ ] 改 ROI 前先出一张网格叠加图，目视确认框在正确部位
- [ ] **判据**：mouth 框内应只有嘴与少量下巴；若框进双手/腹部＝坐标切错，全部读数作废

## 2. 动态口径

- [ ] 不用「帧间差均值」作动态判据（实测 0.15 / 0.53 均属亚像素噪声量级）
- [ ] 用相位相关位移：输出 max dx / max dy（px@1080）
- [ ] 明确口径：累积位移（对比首帧）还是帧间位移（对比上一帧），两者不可混用
- [ ] 低纹理区（黑底腿部）读数必须交叉验证后再采信
- [ ] 判「活气」看非刚性形变；热图上只亮轮廓＝刚体运动，调参数也做不出活气

## 3. 重编码质量

- [ ] 全程 YUV420p 直通（ffmpeg 抽 `-pix_fmt yuv420p` raw → 只处理 Y 平面 → 回编码器）
- [ ] 不做 BGR 往返（实测 MAE 1.53 / 亮度偏移 1.434，指纹≈235−16 range 错配）
- [ ] 目标：亮度偏移 **< 0.1**（YUV 直通实测 0.084）
- [ ] 锚点残差对比噪声底（实测 0.175），低于噪声底即到位，**不追求 0**

## 4. 取帧正确性

- [ ] ffmpeg 抽指定帧号必须带 `-vsync 0`
- [ ] 校准：同一视频「顺读」vs「select 抽帧」逐帧比对，差值应为 **0.000**
- [ ] 不用 `cv2.VideoCapture` 的 `POS_FRAMES` seek 取精确帧（H.264 不精确）
- [ ] 跨素材比较距离前，先跑一次读帧校准（曾出现 7.23 vs 36.56，差 3.4 倍）

## 5. 首尾闭环（循环素材）

- [ ] 首帧与末帧同点比对，允许残差 ≤ 重编码噪声底
- [ ] 进入方向与退出方向分别核对（闭环只考核一半会漏）
- [ ] 漂移量测：整段累积位移不应单调增长

## 6. 交付前

- [ ] 结论在全分辨率下复核（缩略图/拼格会抹平 1~3 px 位移）
- [ ] 上线后对外链路实拉校验：`curl -sk -o x.mp4 <url>` + `md5sum` + HTTP 200
- [ ] 记录本次使用的 ROI 坐标、口径（累积/帧间）、噪声底数值，写进交付说明

---
本清单可自由用于内部验收。需要完整量测报告（热图 + 位移表 + 闭环结论 + 逐项判据）见 https://www.aizhigongfang.com/services/