HyperFrames Registry 是 HyperFrames 生态中的注册表,用于搜索、安装和接入可复用的区块(blocks)与组件(components)。其核心用途是避免手动构建具名视觉元素,在开发合成时优先查找注册表中已有的实现。
主要能力包括:通过 hyperframes add <name> 安装块或组件;支持按名称精确匹配,若无匹配则按标签安装所有块;安装时自动处理注册表依赖;默认将块安装到 compositions/<name>.html,组件安装到 compositions/components/<name>.html,路径可在 hyperframes.json 中配置。工具还提供 hyperframes catalog 命令用于浏览和过滤目录,支持按类型(block/component)、标签筛选,以及 --json 机器可读输出和 --human-friendly 交互式选择。搜索功能通过 hyperframes catalog --query "..." 实现,默认基于词汇匹配,--on-device 可基于语义进行本地排序(需一次性模型下载)。当目录中无合适条目时,可使用 hyperframes feedback --search-miss 报告缺口。
使用方式上,块作为独立子合成,通过宿主 index.html 中的 data-composition-src 等属性嵌入,需设置 data-composition-id(须与块内部 ID 一致)、data-start、data-duration、data-width、data-height、data-track-index 等属性。组件则需将其 HTML 元素复制到宿主合成的 div[data-composition-id] 内,将 <style> 块复制到样式区,将 <script> 内容复制到脚本区(在时间线代码之前),如组件提供 GSAP 时间线集成,还需将相应调用加入时间线。
适用场景包括:在 HyperFrames 合成制作中快速复用数据图表、纹理覆盖、字幕样式、过渡效果等视觉元素;通过目录搜索发现可用的块和组件;在 CI 或无头环境中使用 --json 和 --no-clipboard 等选项。限制方面:add 命令需要网络连接(仅缓存清单,文件每次安装都重新获取);搜索查询需使用英文,否则无法返回结果;离线时只能搜索和查看条目,无法安装;注册表不可达时,目录仍可基于上次缓存的清单进行发现,但安装会失败。