用途:本技能用于通过注册表安装可复用的区块(blocks)与组件(components),并把已安装项接入 HyperFrames 合成。区块是独立子合成,拥有自身尺寸、时长与时间线;组件是效果片段,无自身尺寸,需直接粘贴进宿主合成的 HTML。
主要能力:处理 hyperframes add 命令、安装区块或组件、把已安装项接入 index.html、以及与 hyperframes.json 相关的操作,并支持浏览注册表内容。
使用方式:安装用 hyperframes add <name>,例如 hyperframes add data-chart 安装区块、hyperframes add grain-overlay 安装组件;可用 --dir 指定项目、--json 输出机器可读结果、--no-clipboard 跳过剪贴板(CI/无头环境)。安装后 CLI 会打印写入的文件与可粘贴的片段。区块默认安装到 compositions/<name>.html,组件默认安装到 compositions/components/<name>.html,路径可在 hyperframes.json 的 paths 中配置。接入区块时在宿主 index.html 用 data-composition-src 引入,并补充 data-composition-id(需与区块内部 ID 一致)、data-start、data-track-index 等属性,另有 data-duration、data-width、data-height。接入组件则手动合并:复制 HTML 进合成容器、复制 style 进样式、复制 script 内容到脚本(置于时间线代码之前),若片段注释说明支持 GSAP 时间线集成,再添加相应调用。发现可读注册表清单及其 registry-item.json 字段。
限制:hyperframes add 仅适用于区块与组件;示例需改用 hyperframes init <dir> --example <name>。片段仅为起点,接入区块时仍需自行补充必要属性。其余细节暂未提供。