用途：把创作者自己的B-roll素材（街景、夜间书桌、日落、健身房、屏幕录制、照片）扫描成可检索的素材库，让剪辑时用一次grep就能找到“夜里在书桌前的我”，无需逐个打开视频。
主要能力：用ffprobe/ffmpeg扫描素材，生成library.json、library.md（每行一条，代理grep用）、3x2共6帧的缩略图sheets/<id>.jpg，以及tags/batch-NN.json标签；标签由Haiku代理按批次生成，包含标题、描述、场景、情绪、时段、镜头类型、关键词、是否有本人、质量标记和best_start。支持/broll setup、add、search、use、reject五类操作；用grep -i -E "sunset|dusk|golden" video-agent/broll/library.md等方式搜索，也可叠加grep过滤。可根据转写文本把B-roll插入短视频，并回写used避免重复使用。
使用方式：先检查ffmpeg -version && node -v，缺失时用/studio-setup tools。命令均在包含video-agent/的项目目录运行。扫描、合并标签与重建library.md通过给定的node -e脚本执行；GPS地点用Nominatim反查，无GPS不猜测。搜索命中后需人工Read对应缩略图确认。插入时复制clip到video-agent/studio/public/broll/并写入edit.json的broll字段，依赖short-editing的broll layer。
限制：标签只写画面可见内容，不写读不出的地点、品牌或姓名；无本人照片时is_self保持false。素材文件不会被移动、编辑或删除。标签需逐个检查，JSON无效或缺id要重跑标签代理。每8到15秒最多一个B-roll，每个2到5秒。无合适素材时保留创作者画面或callout，不随意插入。库超过300条可先标100条，其余后台处理。