Hyperframes Registry — Hyperframes 注册表

HyperFrames 注册表 注册表提供可重用的块和组件，可以通过 hyperframes add 安装。块 —— 独立的子组合（拥有自己的尺寸、持续时间、时间轴）。通过 data-composition-src 在宿主组合中包含。组件 —— 效果片段（没有自己的尺寸）。直接粘贴到宿主组合的 HTML 中。

何时使用此技能 用户提到 hyperframes add、"block"、"component" 或 hyperframes.json hyperframes add 的输出出现在会话中（文件路径、剪贴板片段） 您需要将已安装的项目连接到现有的组合中 您想发现注册表中有什么

快速参考 hyperframes add data-chart # 安装一个块 hyperframes add grain-overlay # 安装一个组件 hyperframes add shimmer-sweep --dir . # 指定特定的项目 hyperframes add data-chart --json # 机器可读输出 hyperframes add data-chart --no-clipboard # 跳过剪贴板（CI/无头） 安装后，CLI 打印写入的文件和要粘贴到宿主组合中的片段。该片段是一个起点 —— 您需要添加 data-composition-id（必须与块的内部组合 ID 匹配）、data-start 和 data-track-index 属性以连接块。

注意：hyperframes add 只适用于块和组件。对于示例，请使用 hyperframes init

--example 代替。

安装位置 块默认安装到 compositions/.html。组件默认安装到 compositions/components/.html。这些路径可以在 hyperframes.json 中配置： { "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry", "paths": { "blocks": "compositions", "components": "compositions/components", "assets": "assets" } } 请参阅 install-locations.md 以获取更多详细信息。

连接块 块是独立的组合 —— 通过 data-composition-src 在宿主 index.html 中包含：

关键属性： data-composition-src —— 块 HTML 文件的路径 data-composition-id —— 必须与块的内部 ID 匹配 data-start —— 块在宿主时间轴中出现的时间（秒） data-duration —— 块播放的时间 data-width / data-height —— 块画布尺寸 data-track-index —— 层次顺序（更高 = 在前面） 请参阅 wiring-blocks.md 以获取更多详细信息。

连接组件 组件是片段 —— 将它们的 HTML 粘贴到您的组合的标记中，将它们的 CSS 粘贴到您的样式块中，并将它们的 JS 粘贴到您的脚本中（如果有）： 读取已安装的文件（例如 compositions/components/grain-overlay.html） 将 HTML 元素复制到您的组合的