SuperAPI AI 工具集

hyperframes-registry

通用与其它

查看项目

更新于 10-16 03:05

技能介绍

用途:把注册表中的区块(block)与组件(component)安装并接入 HyperFrames 合成。区块是独立子合成,自带尺寸、时长与时间线,通过 data-composition-src 嵌入宿主合成;组件是无独立尺寸的特效片段,直接粘贴进宿主 HTML。

主要能力:hyperframes add 安装区块或组件,并输出写入的文件路径与可粘贴片段;支持指定项目目录、JSON 输出、跳过剪贴板(CI/无头环境)。区块默认装入 compositions/<name>.html,组件默认装入 compositions/components/<name>.html,路径可在 hyperframes.json 的 paths.blocks、paths.components、paths.assets 中配置。可用 curl 读取 registry.json 及各项 registry-item.json 发现条目(含 name、type、title、description、tags,区块另有 dimensions、duration 与文件列表)。

用法:运行 hyperframes add data-chart 或 hyperframes add grain-overlay;接入区块时在宿主 index.html 中使用 div 加 data-composition-id(须与区块内部 ID 一致)、data-composition-src、data-start、data-duration、data-track-index、data-width、data-height。接入组件时,把其 HTML 复制进宿主合成元素,把 style 复制进样式块,script 复制进脚本(放在时间线代码之前),如片段注释说明有 GSAP 时间线集成,还需把相应调用加入时间线。示例要用 hyperframes init <dir> --example <name>。

限制:hyperframes add 仅适用于区块与组件,不适用于示例;安装后输出的片段只是起点,接入区块时仍需自行补全上述属性。代理 URL、命令行参数等以资料为准,其余细节暂未提供。