用途:在 Project Protocol 视频流程中,把已理解的长视频转成短视频候选,完成候选规划、审批、横版提取,以及可选的 9:16 竖版交付。依赖 /video-understand 作为前置,需先运行以使用已验证的转录与规范时间线;还需 ffmpeg/ffprobe 在 PATH 中,以及带 Pillow 的 Python。
主要能力:分两阶段。规划阶段把转录映射到节目时间,编写并审批候选,写入 work/shorts/shorts-plan.json,不产出最终视频;定稿阶段在主线剪辑全部审批且共享主交付验证后,重跑 plan.py 绑定已批准区间,再提取横版与可选竖版。它负责候选判断、确定性资格校验、横版提取、短视频相对转录和可选竖版交付,不负责转录、改主线、加字幕图形、调色、发布或连续主体跟踪。
使用方式:先运行 prepare_transcript.py 生成节目转录;用 prepare_visual_context.py 生成视觉上下文并手工编写候选 JSON;用 candidates.py 校验;用 interaction.py 打开权威审批页,用户选择 1-5 个候选和一种交付模式(horizontal_only 或 horizontal_and_vertical),或由代理在明确委托下审批;再运行 plan.py 生成计划。主渲染验证后重跑 plan.py,然后运行 extract_shorts.py 提取横版。竖版需生成 1 秒或 0.5 秒视觉证据,编写 STATIC_CROP、SCENE_CROP、LETTERBOX 或 REVIEW_REQUIRED 策略,经 vertical_plan.py 校验、render_vertical.py 预览并审批后正式渲染。
适用场景:需要从长视频中挑选可独立理解的短片段,并保持与主线交付一致的可追溯性。
限制:资格要求总分至少 70、完整性至少 15、时长 20-90 秒、摘录精确、与更高排名短片重叠不超过 50%、默认最多五个输出。填充词删除仅限孤立且语义空的犹豫词,总删除不超过 15%,保留片段不短于 0.15 秒。提取保留至少 0.25 秒释放音频,目标 0.30 秒;源结束前无法保留则失败。竖版不支持连续跟踪,证据不足时标记 REVIEW_REQUIRED 并阻止正式渲染。审批与哈希绑定,源、候选、转录、页面、帧等变更会使审批失效。具体收费、价格与平台信息暂未提供。