laohan-sucai

# B-roll 素材供应器 只为已经判定为 BROLL_STOCK 的现实场景找素材。它不决定动画、不把库存素材伪装成事实、不合成视频。 ## 输入与停止条件 正式入口是 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 时，不搜索、不下载。没有 provider key 时只写出 `no_result` 与 `provider_errors`，不会发起搜索或下载。 ## 命令 ~~~bash # 搜索候选：Pexels/Pixabay/Coverr 并行检索；至少配置一个 key node scripts/sucai.mjs search --source 09-导演/source-manifest.json --out 10-素材 # 本地素材库优先参与；local 候选会复制到本 episode 后再抽帧 node scripts/sucai.mjs search --source 09-导演/source-manifest.json --out 10-素材 --local-library "/绝对路径/你的素材库" # 下载一个候选，并生成缩略图供实际视觉检查 node scripts/sucai.mjs download --manifest 10-素材/素材清单.json --beat B01 --candidate pexels:123 # 先实际查看缩略图或 contact sheet，再记录判定 node scripts/sucai.mjs verify --manifest 10-素材/素材清单.json --beat B01 --candidate pexels:123 --verdict pass --reason "主体、构图和事实边界均匹配" # 查看当前清单 node scripts/sucai.mjs report --manifest 10-素材/素材清单.json # PROOF 只物化已批准证据；显式视觉确认后复制到本期并登记 node scripts/register-proof-asset.mjs episodes/<slug> B03 <proof-file> <thumb-file> --visually-verified ~~~ 环境变量和官方申请入口见 references/providers.md。不要把 key 写入 SKILL.md、JSON、episode 或 Git。 ## 工作流 1. 读取 broll_requests 的 query_terms；缺 query_terms 时只用 visual_need，记录搜索理由。 2. 若传入 --local-library 或 LAOHAN_LOCAL_BROLL_DIR，先把本地库加入候选来源；随后并行调用 Pexels、Pixabay、Coverr。Mixkit 不做自动抓取。 3. 记录每个 provider 的 status、candidate_count、elapsed_ms、rate_limit...