参考视频时间窗裁剪：越界拒绝与保留帧验收

01准备环境与输入

1. 准备 Node.js 与 FFmpeg，必要时设置 FFMPEG_BIN。脚本创建 320×180、每秒十帧、三秒长的原创参考夹具。
2. 查看 window.json：源时长来自三十个解码帧和本夹具明确的恒定帧率，选定起点为 0.5 秒、终点为 1.5 秒。
3. 选择新的输出目录，先用配套 CFR 夹具验证。任意 VFR 或非零起点参考的可用尾部边界，需要另外建立时间戳清单。

02执行配方

运行命令

node run-recipe.mjs --out ./my-run

1. 确认源片真正可用的区间

   完整解码原创夹具，确认每秒十帧下确有三十帧，由此建立受控的三秒区间。构建用原始 RGB 暂存会在 finally 清理。这种受控 CFR 时长算法不能直接当成通用 VFR 时长推算。

2. 编码前拒绝无效边界

   本地校验要求两个值有限、起点不小于零、终点大于起点，且不超过源时长。脚本分别实跑负起点、相等边界、倒序边界、超尾请求和 NaN，不静默纠正。

3. 裁剪后重新设置时间原点

   实际应用 trim=start=0.5:end=1.5,setpts=PTS-STARTPTS 并重新编码。trim 保留源片连续区间，setpts 让输出从零开始；终点不包含从源片 1.5 秒开始的那一帧。

4. 同时比较首尾画面与输出时间

   结果应完整解码为十帧，首尾分别与源索引 5、14 的 RGB 比较，再解析真实 showinfo 日志，确认输出 PTS 从 0.0 到 0.9、间隔 0.1 秒。本次首尾最大通道差均为零。

03检查结果

• 源片实际解码为三十帧 320×180，符合受控十 FPS。
• 0.5–1.5 秒通过有限数值与区间边界规则。
• 裁剪片段准确解码为十帧，对应十 FPS 下的一秒。
• 输出首尾分别匹配源索引 5、14，通道差不超过四，本次均为零。
• 实际输出时间戳从零开始，最后为 0.9 秒。
• 五种无效窗口均被拒绝，十一项回执与 showinfo 实际日志一同保留。

04排错与交付

把请求时间窗、源片可用区间与解码端点检查一起保存。小型 CFR 夹具证明这次裁剪操作，不代表所有真实参考片的时间戳行为。

05下载脚本与样例

• 原创任务专用本地夹具示意图 ↓
• 完整可运行包：原创输入与真实回执 ↓
• 任务专用标准库夹具脚本 ↓
• 有界本地执行与回执辅助模块 ↓
• 英文执行与验收说明 ↓
• 英文结构化任务说明 ↓
• 中文执行与验收说明 ↓
• 中文结构化任务说明 ↓
• 实际完整通过回执 ↓
• 实际预期拒绝回执 ↓
• 命名任务检查结果 ↓
• 分发文件 SHA-256 清单 ↓
• 实跑夹具：window.json ↓
• 实跑夹具：three-second-reference.mp4 ↓
• 实跑夹具：reference-0.5-to-1.5.mp4 ↓
• 实跑夹具：trim-showinfo.txt ↓