hyperframes-registry

插件安装： 在运行 setup 或 freshness 命令前，如果此技能位于 HyperFrames 插件中，请遵循插件执行规则。

HyperFrames 注册表

从现有项目开始通常更快，也往往比自己编写效果更好；安装的项目就是你项目中的普通源代码：可以修改、删减并重新设置样式。

查找并安装

npx hyperframes catalog --query "<what the beat should do, in English>" --json
npx hyperframes add <name> --json        # prints the written files and the mount snippet

• 即使视频不是英文，也请用英文查询：目录的索引使用英文；使用其他文字体系会返回 No searchable words in query，这并不表示目录有缺漏。
• 搜索在本地进行，不会发送任何内容。默认的 words 层级只会找到重用了你的词语的项目；--on-device 会在一次性下载约 33 MB 数据后按含义排序。请提供此下载选项，让用户自行决定；切勿静默启用。--json 信封会标明响应所用的层级。
• 使用 --type block|component 和 --tag <tag> 缩小范围。add <tag> 会安装带有该标签的所有区块；依赖项会先安装。即使之前安装过某个项目，add 仍需要网络；搜索则可通过缓存的清单离线运行。
• 找不到合适的项目时，无论使用哪个层级，都应在自行构建前先报告。catalog --query 会预先填入报告命令（在 --json 中为 report_gap）：npx hyperframes feedback --search-miss "<query>" --wanted "<the move you needed>" --tier <tier>。请描述效果，而不是你设想的项目名称。

关于层级、dropped 和 unindexed、索引过期以及离线行为，请参阅：references/search.md。

包含的内容

区块：带有独立时间线的场景	示例
转场	beat-freeze-cut、chromatic-radial-split、cinematic-zoom
叠加层和字幕条	camcorder-hud、editorial-flash-overlay、lt-clean-bar
标题卡和动态文字	canopy-part-title、code-slice-hero
社交、聊天和 UI 卡片	ai-chat-reveal、chatgpt-exchange
代码、图表、数据和地图	code-diff、bar-chart-race、data-chart
3D、着色器和背景	app-showcase、aurora、blob

组件：合并到场景中的代码片段	示例
动态效果基元和文字效果	agent-cursor、blur-in、bottom-up-letters
字幕样式	caption-clip-wipe、caption-editorial-emphasis
摄像机运动	camera-shake、camera-scan-gate
产品演示和 UI 道具	before-after-wipe、browser-device-stage
纹理、粒子和效果	ascii-render-pass、grain-overlay

接入

• 区块：安装到 compositions/<name>.html。使用 data-composition-src 挂载，并让 data-composition-id 与区块自身的 id 一致，再设置 data-start 和所需的 data-duration；add 打印的代码片段可作为起点。参阅 references/wiring-blocks.md。
• 组件：安装到 compositions/components/<name>.html。将其标记、<style> 和脚本复制到场景中；如果组件会接入时间线，请遵循其注释块中的说明。参阅 references/wiring-components.md。
• 选择适用的最大单元，然后进行修改。保留已安装项目原有的 id 前缀，以免不同项目发生冲突。
• 每个项目都有自己的变量；如需为某个挂载单独设置变量，请在其宿主元素上使用 data-variable-values（add --vars '{"title":"…"}' 会写入该属性），并将其颜色和字体变量指向你的品牌配置。
• 与节拍同步的区块会从 npx hyperframes beats --json 获取命中时间：用节拍时间减去挂载的 data-start。
• 安装路径由 hyperframes.json 指定（参阅 references/install-locations.md）。

贡献

如需为上游 PR 编写新区块或组件，请参阅 references/contributing.md；入门模板见 references/templates.md，质量标准见 references/component-quality-bar.md。