Archive B-roll 是 bintzgavin/helios 下的一个技能,用于从 Internet Archive(archive.org)为 Helios 视频查找、预览、剪辑和标注档案 B-roll 素材。Internet Archive 收录数百万影片,包括 Prelinger Archives(工业、教育、广告类)、NASA、新闻影片、家庭影片和 Creative Commons 上传内容。无需 API 密钥。脚本 scripts/archive-broll.mjs 需要 Node 18+,剪辑片段时需要 ffmpeg,封装了三个端点:search 调用 advancedsearch.php 列出具有可复用权利的影片条目;inspect 调用 metadata/<id> 挑选最佳 MP4 并按秒偏移保存缩略图;clip 调用 download/<id>/<file> 通过 HTTP 只裁剪所需秒数并写入致谢信息。
使用方式:
- 搜索:运行 node <this-skill>/scripts/archive-broll.mjs search "factory assembly line" --rows 12,可使用 Archive 搜索语法(如 title:(...)、subject:(...)、AND、OR),结果按相关性排序,可用 --sort downloads 按流行度排序。每条结果带有权利标签:public-domain(公共领域标记或 CC0,仍建议致谢)、cc-by(需要致谢)、cc-by-sa(需要致谢,且成品视频须采用相同许可证,用于商业视频前应告知用户)、collection-policy(条目无许可证,集合发布权利声明,如 Prelinger Archives,需致谢集合并链接声明)。非商业、禁止演绎和未知权利的条目会被排除;--include-unknown 可显示未知条目,但需用户确认拥有权利后使用。标签来自上传者元数据,是过滤条件而非法律建议;即使标注为公共领域,也应注意疑似商业影片、电视节目或商标密集的素材。
- 预览:运行 node <this-skill>/scripts/archive-broll.mjs inspect <identifier> --out videos/<slug>/broll --thumbs 16,生成 item.json 和按偏移命名的缩略图(如 00450s.jpg 表示 7:30 处),可用图像工具打开并选择开始时间;--large 可在 Archive 的 160px 缩略图不够清晰时用 ffmpeg 抓取更清晰的 640px 帧。
- 剪辑:运行 node <this-skill>/scripts/archive-broll.mjs clip <identifier> --start 450 --duration 3 --out videos/<slug>/broll --name traffic-01.mp4,输出 H.264、无音频(--audio 可保留音频),关键帧间隔短以便逐帧定位,--width 1920 可放大;建议每侧多剪约 0.5 秒用于转场。每个片段会追加到输出文件夹的 CREDITS.md 和 credits.json。
- 页面使用:渲染器在每帧前将每个 <video> 定位到 (t - data-helios-offset) + data-helios-seek 并等待。DOM 页面可直接放置并设置样式;Canvas 页面保留相同的隐藏 <video>,并在 renderAt 中等待 seek 完成后再绘制。建议通过 SVG 颜色矩阵、mix-blend-mode 或绘制到风格板(双色调、半调、墨水密度)使素材融入整体外观。多数档案影片为 1940s–70s 的 4:3 标清,更适合遮罩、画框和拼贴而非全出血。
- 致谢:保留 CREDITS.md,并按许可证要求在片尾卡、描述或项目文档中放置致谢(CC BY 和 CC BY-SA 始终需要)。交付时列出片段及其权利。
适用场景:为 Helios 视频项目寻找和剪辑可复用权利的档案 B-roll,尤其适合需要公共领域或知识共享影片的创作。限制:非商业、禁止演绎和未知权利条目默认排除;权利标签仅为过滤参考,不构成法律建议;需要用户自行确认最终使用权。