B-roll 素材供应器

只为已经判定为 BROLL_STOCK 的现实场景找素材。它不决定动画、不把库存素材伪装成事实、不合成视频。V5默认采用“永久本地素材Top-K＋网络高权重多样性”策略：本地catalog负责快速复用，Pexels/Pixabay/Coverr仍并行提供新候选；只下载最终选择项。

输入与停止条件

正式入口是 09-导演/source-manifest.json 的 broll_requests，以及已批准的 PROOF_PUBLIC/PROOF_USER source_entries。每项 BROLL 必须有 beat_id、source_mode=BROLL_STOCK、visual_need 和 must_not_imply；PROOF 必须有 evidence.id。

🛑 STOP：没有 broll_requests 或请求不是 BROLL_STOCK 时，不搜索、不下载。是否生成请求由⑨素材策略决定；只要真实B-roll能增加具体性或画面变化，默认生成请求，只有明确SKIP_WITH_REASON才跳过网络。没有 provider key 时记录provider_errors并继续永久本地素材召回。

命令

# 搜索候选：默认读取项目本地catalog，同时并行检索Pexels/Pixabay/Coverr
node scripts/sucai.mjs search --source 09-导演/source-manifest.json --out 10-素材/network

# 非项目cwd时可显式指定本地库；local候选会复制到本episode后再抽帧
node scripts/sucai.mjs search --source 09-导演/source-manifest.json --out 10-素材/network --local-library "/绝对路径/你的素材库"