TikTok 带货视频怎么渲染和质检？Day 4 实跑

Scott 的 Day 4 开源项目可以在本地把 6 段合成素材和预置配音渲染成一条约 23.4 秒的竖屏带货 MP4。本次复跑得到 1080 × 1920、30 fps 的 H.264 视频和 AAC 音轨。下面按运行步骤核对 10 条字幕、5 个剪辑缝点，以及规格通过后仍要人工看的地方。 Day 4 中文实操视频 · 固定版本源码

怎么在本地渲染带货视频？

准备 Git、Node.js 22 或更新版本、FFmpeg 和 FFprobe、装有 Pillow 的 Python 3，以及可供 HyperFrames 使用的 Chrome。依赖按锁文件安装，首次安装需要联网。默认样例使用虚构的极光保温杯、合成镜头、预置镜头标签和配音，不需要模型密钥或调用配音服务。样例说明 · SCTCamp 项目资源

git clone https://github.com/scotti1i/commerce-video-edit-automation-day04.git
cd commerce-video-edit-automation-day04
git switch --detach e5ddc3454dbb085a00145bba948ab27130adc5fa
npm ci --ignore-scripts
npm run demo

本次用 FFmpeg 9.0.1 运行。上面的固定版本会读取 FFmpeg 版本，对 7 及更新版本使用 -/filter_complex，对识别到的旧版使用原来的文件参数。如果旧检出报 Unrecognized option 'filter_complex_script'，先对照上面的提交号。 FFmpeg 参数变更 · 项目兼容代码

复跑后要看哪些文件？

文件	实测结果和用途
`jobs/demo/data/assembly-edl.json`	剪辑清单。6 段，时间线为 0–23.278 秒。`sourceStart` / `sourceEnd` 用于截取素材，`timelineStart` / `timelineEnd` 标出成片时间线位置。
`jobs/demo/data/captions.json`	10 条字幕，`s` 和 `e` 分别是起止秒数，`t` 是字幕文本。默认样例从预置配音的逐词时间生成。
`jobs/demo/qa/seams/report.json`	5 个镜头交界，状态 `review_required`。打开旁边的 `seam-*.jpg`，检查跳切、闪帧和商品是否被裁掉。
`jobs/demo/variants/douyin-vertical/renders/demo-vertical.mp4`	HyperFrames 渲染的最终竖屏文件，字幕已经画进画面。

前两段在 3.428 秒交接。第一条字幕是 0.096–3.198 秒，下一条在 3.524 秒出现。10 条字幕都落在各自镜头内且没有重叠，但最后一条只显示「了」，时间为 23.059–23.198 秒，约 0.14 秒。换成商品真片时要播放检查，像这种句尾碎字可以试着并回前一句，再检查读速和画面。字幕生成脚本

怎么验收最终 MP4？

在项目目录运行以下命令。

video=jobs/demo/variants/douyin-vertical/renders/demo-vertical.mp4

ffprobe -v error -show_entries \
  stream=codec_type,codec_name,width,height,avg_frame_rate,nb_frames:format=duration \
  -of json "$video"

npm run qa -- --job jobs/demo --video "$video" --fps 30/1

本次 ffprobe 读到 702 帧、30/1 帧率、1080 × 1920 的 H.264 视频和 AAC 音轨。视频画面长 23.4 秒，MP4 容器的总时长约 23.42 秒。质检生成 9 张成片抽帧，jobs/demo/qa/report.json 的 failures 为 []，状态仍是 review_required。成片质检脚本

本次合成样例的成片规格、字幕时间和复核状态可以直接下载核对。实测质检 JSON

交付前打开抽帧和 5 张缝点图，再在手机上从头播到尾。重点检查开头商品是否看得清、字幕有没有挡住商品或贴近平台界面、口播与镜头是否一致，以及音轨有没有断音。换真实素材时，用有权使用的文件，并把含客户、订单或未公开商品信息的素材和质检图留在内部。 Day 4 质检清单 · 分镜与 ASS 字幕样例