它能做什么
中文摘要
hyperframes-registry 是 HyperFrames 的素材注册表技能:约 450 个现成的 block(自带时间线的整段场景)与 component(可合并进场景的片段)以可编辑源码形式安装到项目里,涵盖转场、叠加层与下三分之一、标题卡与动态字体、社交/聊天/UI 卡片、代码/图表/数据/地图、3D 与着色器背景,以及字幕样式、运镜、纹理粒子等。技能强调“先取现成再改”优于从零手写效果;搜索用 `catalog`(默认 words 词面匹配,可选 --on-device 语义排序,需一次性约 33MB 下载),安装用 `add`,并说明 block 挂载参数(data-composition-src / data-composition-id / data-start / data-duration)、component 复制标记与样式脚本、变量覆盖、与 beats 节拍对齐,以及搜索落空时先上报缺口。
为什么推荐
推荐理由
适合已经在用 HyperFrames 做视频、又不想从零实现视觉效果的场景:它把常见命名效果(CRT 扫描线、故障、胶片颗粒、图表、转场、字幕等)变成可直接改源码的项目文件,省去手写与调参。安装量超 121 万、周安装量整体走高,说明生态成熟。需注意两点边界:`add` 即使装过也需要联网(搜索可离线读缓存清单),语义搜索需用户同意后下载约 33MB 模型,且查询必须用英文。
什么时候用
适用场景
- 需要片头、标题卡、转场或叠加层等现成镜头,想先取用再改造时
- 要加字幕样式、运镜、纹理/粒子等可合并进场景的小片段时
- 要做柱状图竞赛、代码 diff、数据图表或地图叠加等数据类画面时
- 需要与音乐节拍同步的卡点片段,用 beats 输出换算挂载时间时
- 想把手上的 CRT 扫描线、故障、胶片颗粒等命名效果直接取用而非手写时
- 用 data-variable-values / add --vars 覆盖标题、颜色、字体变量以贴合品牌时
- catalog 搜不到合适条目、需要在手写前上报 search-miss 缺口时
使用前先看
主要亮点
- 01
约 450 个现成 block 与 component,以可编辑源码安装,可修改、裁剪、改样式
- 02
没有 `hyperframes registry` 命令:搜索用 `npx hyperframes catalog --query`,安装用 `npx hyperframes add <name>`
- 03
搜索完全本地、不外发;默认 words 层只做词面匹配,`--on-device` 按语义排序但需一次性约 33MB 下载,且应征得用户同意、不得静默开启
- 04
查询需用英文,否则可能返回 `No searchable words in query`
- 05
可用 `--type block|component` 与 `--tag <tag>` 收窄;`add <tag>` 会安装该标签下全部 block,依赖先装
- 06
`add` 即使安装过的条目也需要网络;搜索可离线使用缓存清单
- 07
block 安装到 compositions/<name>.html,用 data-composition-src、匹配自身 id 的 data-composition-id、data-start 与 data-duration 挂载
- 08
component 安装到 compositions/components/<name>.html,需把标记、<style> 与脚本复制进场景
- 09
应保留已安装条目的 id 前缀,避免两个条目冲突;颜色与字体变量可指向品牌值
- 10
节拍同步块用 `npx hyperframes beats --json`,取节拍时间减去挂载 data-start
- 11
搜索无结果时先在任一搜索层上报:`npx hyperframes feedback --search-miss ... --wanted ... --tier ...`,描述效果而非臆想的条目名
- 12
技能启动时运行一次 `npx hyperframes events --skill=hyperframes-registry` 使用信标,随 CLI 常规遥测发送技能名并尊重退出设置
- 13
插件内安装需遵循 plugin execution rules;安装路径由 hyperframes.json 决定
原始文档
原文摘录
**Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md). **Usage beacon:** run `npx hyperframes events --skill=hyperframes-registry` once as this skill starts. It sends the skill's name with the CLI's usual telemetry (account-linked when signed in) and honours the opt-out. HyperFrames registry