用途:将品牌自有视频 URL 列表转化为可复用、带索引的片段库。下载视频、逐条观看、按语义命名切分片段,并写出可搜索的片段索引,让下游剪辑者或智能体无需重看全部视频即可找到合适素材(如仪表盘 UI 演示、片尾卡、金融 B-roll)。这是 research-new-brand 的素材对应物,品牌有可复用真实素材时运行。
输入:brand(必填,项目顶层文件夹短标识);product(可选,用于索引文件名与标题);video_urls(必填,品牌自有视频 URL 列表);output_dir(可选,默认 <brand>/brand-assets/);max_height(可选,默认 1080)。
组成:download-youtube-video(逐个 URL 下载为本地 mp4);trim-video-clips(按 {name, start, end} 规格切分);外部技能 watch:watch(下载/转写/抽帧以选择片段窗口)。
流程:校验视频为品牌自有并确认已安装 yt-dlp 与 ffmpeg;创建输出目录与 clips/;逐个下载并保留字幕与 .info.json;用 watch:watch 逐条理解,识别 10–20 个可复用片段并记录语义名、入出时间码、视觉描述、音频/VO 备注、最佳用途与标签;写 clips.json 并切分;按模板写片段索引(含源视频表、逐片段条目、按需求与标签分组的 Clip Finder);写 clip-library-manifest.json。
规则:仅处理品牌自有或拥有明确权利的视频,拒绝第三方内容并记录权利依据;单个视频失败则跳过并记录,不中断;片段名语义化且稳定;重复运行不重复下载,已存在片段默认跳过除非传 --overwrite;注意 16:9 品牌片与 9:16 社交广告的差异,索引中标注可能需要重构/裁剪。
输出:源视频、clips/ 片段与清单、片段索引 md、运行清单 json。
限制:yt-dlp 或 ffmpeg 缺失需先安装(brew install yt-dlp ffmpeg);私有/年龄限制视频(HTTP 403)需跳过并请求替代来源;watch:watch 不可用时无法选择片段窗口,应报告受阻而非猜测。