TikTok捕获流水线
运行 pipeline.sh。不要自行推导 ffmpeg、mpv 或 Xvfb 命令,也不要通过肉眼或时长来判断录制是否成功。
唯一规则
切勿报告捕获成功。只有 pipeline.sh 通过退出码决定。
这很重要,因为无声丢失最后一秒的录制仍然具有完全正确的时长和帧数。只有 verify.py 中的首帧/最后一帧比较能捕获这种情况。如果你曾试图检查时长或文件大小就认为成功,这正是此流水线要防止的失败。
运行单个任务
OUT_DIR=/data/out ./pipeline.sh "https://www.tiktok.com/@user/video/123"
需要cookies时,当源需要会话:
OUT_DIR=/data/out COOKIES=/data/cookies.txt ./pipeline.sh "$URL"
运行批量任务
从队列文件中逐行读取URL并循环。除非你先检查CPU预算,否则串行运行——每个任务需要大约2个vCPU才能保持30fps而不丢帧,每个任务从自己的PID派生出显示号和PulseAudio实例,因此并发运行不会冲突。
while read -r url; do
[ -z "$url" ] && continue
OUT_DIR=/data/out ./pipeline.sh "$url" || echo "FAILED: $url"
done < queue.txt
退出码
| 退出码 | 含义 | 操作 |
|---|---|---|
| 0 | 验证通过 | 记录输出路径。无需其他操作。 |
| 3 | 缺少依赖 | 停止并报告。不可重试。 |
| 10 | 下载失败 | 预期情况。被屏蔽、私密或已删除。记录并继续。 |
| 11 | 源无音频 | 记录并继续。 |
| 12 | 转码失败 | 记录。重试一次,然后报告。 |
| 13 | 捕获失败 | 检查 Xvfb/pulseaudio 是否已安装且显示范围可用。 |
| 14 | 修剪失败 | 引导段无法测量或验证。报告;不要盲目重试。 |
| 15 | 验证失败 | 输出位于 <output>.rejected。报告为流水线缺陷。 |
退出码10是常规情况,不是事故。在数据中心IP上,对于大量URL这是预期结果。报告为计数,不要在循环中重试。
当问题反复出现时
退出码14或15表示流水线本身有问题,而不是视频。读取运行的 manifest.json 测量值——first_frame_mae 和 last_frame_mae 区分两种情况:
- 最后一帧MAE高,首帧MAE低 → 引导段测量偏短,结尾被截断。
- 两者都高 → 捕获未对齐或显示器从未更新。
报告数字,而不是调整容差以强制通过。提高 --match-threshold 以获得绿色结果并不是修复方法。