SuperAPI AI 工具集

hyperframes-registry

通用与其它

查看项目

更新于 10-15 22:40

技能介绍

用途:HyperFrames Registry 提供可复用的区块(blocks)与组件(components),用于 HyperFrames 视频合成。区块是独立子合成,拥有自己的尺寸、时长和时间线,通过 data-composition-src 引入宿主合成;组件是效果片段,没有独立尺寸,直接粘贴进宿主合成的 HTML。

主要能力:用 hyperframes add <name> 安装条目,例如 hyperframes add data-chart 安装区块、hyperframes add grain-overlay 安装组件、hyperframes add captions 安装所有带 captions 标签的区块;支持 --dir 指定项目、--json 输出机器可读结果、--no-clipboard 跳过剪贴板(CI/无头环境)。安装后 CLI 会打印写入的文件和可粘贴到宿主合成的片段。位置参数先按精确名称解析,若无匹配且为标签,则安装该标签下所有区块;注册表依赖会先于目标条目安装。add 仅适用于区块和组件,示例需用 hyperframes init <dir> --example <name>。

使用方式:区块默认安装到 compositions/<name>.html,组件默认安装到 compositions/components/<name>.html,路径可在 hyperframes.json 中配置。接入区块时需在宿主 index.html 中通过 data-composition-src 引入,并补充 data-composition-id(须与区块内部 ID 一致)、data-start、data-duration、data-width/data-height、data-track-index 等属性。接入组件时,把其 HTML 粘贴进合成标记、CSS 粘贴进样式块、JS 粘贴进脚本(若有),并按注释将 GSAP 时间线调用加入时间线。

发现:优先用 CLI 搜索,如 npx hyperframes catalog --query "...",搜索在本地进行、不发送数据;默认按名称、标题、描述中的词汇排序,--on-device 按语义排序(需一次性模型下载)。查询须用英文,其他语言查询会返回无可搜索词。也可用 catalog 浏览或按 --type、--tag 过滤,--human-friendly 打开交互选择器并立即安装。若结果无合适条目,可用 hyperframes feedback --search-miss ... --wanted ... --tier ... 报告缺口。

限制:add 安装需要网络,即使昨天装过也需重新获取文件;仅清单有缓存,离线可搜索和查看条目,但安装会在文件获取时失败。若 CLI 无法访问注册表,可回退查看原始清单。每个条目的 registry-item.json 包含 name、type、title、description、tags、dimensions(仅区块)、duration(仅区块)和文件列表。贡献新条目需按 contributing.md 的完整流程操作。