全部技能 / 内容创作 / hyperframes-registry
内容创作 · heygen-com/hyperframes

hyperframes-registry

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

风险提醒：黄色 · 留意使用AI 侦查报告
作者 heygen-comGitHub heygen-com/hyperframes ↗Stars 48297许可 Apache-2.0（仓库根 LICENSE；GitHub API spdx Apache-2.0）commit b8328f9573
agent 宿主通常会约束 skill 执行权限；风险提醒为 AI 侦查观点，不构成质量或安全保证。第三方 skill 仅作拆解与展示，安装使用风险自负，版权归原作者。

1实现原理 · 为什么它能做到

核心机制是本地 CLI：`hyperframes add`（安装 block/component）与 `hyperframes catalog`（发现），SKILL.md 是 CLI 的操作手册而非独立实现；registry 源默认指向 GitHub raw 上的 registry.json。

skills/hyperframes-registry/SKILL.md
hyperframes add data-chart # install a block hyperframes add grain-overlay # install a component hyperframes add captions # install every block tagged captions
注：registry 位置可配：'"registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry"'（SKILL.md 内嵌 hyperframes.json 片段）——block/component 由 CLI 从该源拉取。

block 与 component 是两类不同接线对象：block 是独立 sub-composition（自带尺寸/时长/时间线），经 `data-composition-src` + data-composition-id/data-start/data-track-index 挂进宿主；component 是无尺寸的效果片段，需人工把 HTML/CSS/JS 三块粘进宿主。

skills/hyperframes-registry/SKILL.md
<div data-composition-id="data-chart" data-composition-src="compositions/data-chart.html" data-start="2" data-duration="15" data-track-index="1" data-width="1920" data-height="1080" ></div>
注：SKILL.md 详列关键属性语义（data-composition-src 路径、data-composition-id 须匹配 block 内部 ID、data-start/duration 秒、data-track-index 层级），并指引 references/wiring-blocks.md、wiring-components.md 的完整步骤。

发现策略刻意『按意图搜索优先于浏览』：`catalog --query` 本地词汇排名为默认层，`--on-device` 需要一次同意的 33MB 模型下载才启用语义层；搜索本身『sends nothing』。

skills/hyperframes-registry/SKILL.md
Search is local and sends nothing. By default it ranks on vocabulary shared with the item's name, title and description, so it only finds items that reuse your words; `--on-device` ranks by meaning instead, after a one-time model download.
注：SKILL.md 还规定查询必须用英文（catalog 双语索引、on-device 模型仅英文），否则返回 'No searchable words in query'——把常见失败模式解释为规则而非缺陷。

目录缺口被设计成主动上报通道：`hyperframes feedback --search-miss` 是『唯一把查询发出去的路径』，且是独立显式命令（携带 --tier 标识词汇/语义哪层答的），报告内容不含评分、指导贡献方向。

skills/hyperframes-registry/SKILL.md
npx hyperframes feedback --search-miss "<the query you ran>" --wanted "<the move you needed>" --tier on-device
注：上下文明确：'This is the only path that sends a query anywhere, which is exactly why it is a separate deliberate command rather than something the search does on its own.'——外发被限制在单条用户可预期的命令。

离线/缓存语义精确：manifest 缓存 24h 内有效、revalidation 失败继续服务旧清单；但 `add` 每次安装仍必须联网取文件——SKILL 明确禁止承诺离线安装。

skills/hyperframes-registry/SKILL.md
**`add` still needs the network, even for an item you installed yesterday.** Only manifests are cached; the item's actual files are fetched on every install.
注：CLI 不可达时的回退被写为显式 curl 示例：'curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json'（SKILL.md）。

上游贡献路径完整内建：idea → scaffold → build → validate → preview → PR 全流程在 references/contributing.md，starter 模板（caption/VFX/component/registry-item.json）在 templates.md。

skills/hyperframes-registry/SKILL.md
To author a NEW registry item (caption style, VFX block, transition, lower third, or a reusable component) and ship it as an upstream PR — not install an existing one — follow the full idea → scaffold → build → validate → preview → ship workflow in [contributing.md](./references/contributing.md).
注：SKILL.md 标题自述职责含 'authoring a new block or component to contribute upstream (idea → scaffold → validate → PR)'——registry 同时是消费层与贡献层接口。

2核心能力

01安装单条目/标签批量安装/指定目录/机器可读输出（hyperframes add 各形态）
02意图驱动目录搜索与浏览过滤（--query/--type/--tag/--json/--human-friendly）
03安装位置定制与 hyperframes.json 路径配置（blocks/components/assets）
04block 接线教学：data-composition-src/ID/start/duration/track-index 语义
05component 三明治接线教学（HTML/CSS/JS 分块并入宿主 + GSAP 时间线集成）
06目录缺口上报（feedback --search-miss，唯一外发查询路径）
07上游贡献工作流：idea→scaffold→validate→PR 与组件质量标准（component-quality-bar）

3外部依赖

类型依赖
clihyperframes CLI（add/catalog/feedback/init；经 npx 或项目内安装）
networkregistry 源
networkCLI 不可达时的 raw manifest 回退
networkcatalog 语义层模型下载（--on-device，一次性、需同意，约 33MB）
networkfeedback --search-miss 上报（唯一发送查询的命令）
networkCDN 依赖（component/demo 模板引 gsap；contributing 流程示例）

4风险提醒 风险提醒：黄色 · 留意使用

风险提醒：黄色 · 留意使用
  • registry 条目 HTML/JS 并入宿主执行——远程内容信任面 — 每次 add 从 GitHub raw 拉文件并写入 compositions/，宿主渲染/预览时其脚本会在浏览器上下文运行；默认源官方维护但仍应按供应链对待。
  • feedback --search-miss 会把用户意图文本外发 — 命令显式、单条、无评分；SKILL 鼓励 agent 每次搜索落空都上报，频繁使用会产生可关联的创作意图数据流。
  • 用户自定义 registry 源无内置警告 — hyperframes.json 的 registry 字段可指向任意 URL；指向不可信源等于把不可信 HTML 接进渲染链，宿主需自行把关。
风险提醒：黄色，留意使用。常规网络调用且外发对象可预期：搜索本地零外发；联网点集中在官方 GitHub raw registry（每次 add 拉条目文件）、可选的 33MB on-device 模型下载（需同意）、显式的 feedback --search-miss 上报（发送查询文本）；另有 npx 首次拉官方包。无凭证读取、不碰 token。主要留意点是远程 registry 条目 HTML 并入可执行 composition 的供应链信任，以及用户自定义 registry 源时的来源可信度——但外发对象均为官方/可预期端点，故取 yellow 而非更高档。

5第二遍独立确认

  • [ok] registry 端点与回退 curl 行存在 — SKILL.md registry 配置 JSON（第 36 行附近）与 curl 回退命令原文复核一致。
  • [ok] 『搜索零外发』与『feedback 外发』并存无矛盾 — 两段原文同页复核：搜索本地词汇排名不发数据；唯一外发被明示为 feedback 命令。
  • [ok] on-device 模型下载规模与同意门槛 — 原文 'it needs a consented 33 MB download, so an agent run is on `words` unless it explicitly opted in' 复核一致。
  • [ok] SKILL.md 是否自带可执行脚本（隐藏代码面） — find 实测本技能目录仅 SKILL.md + references/(9) + examples/(2)，零 .mjs/.py——纯文档技能，能力全部来自 hyperframes CLI。
  • [discrepancy] 供应链面（远程 HTML 并入宿主执行）是否如实定级 — 首轮草稿曾倾向 blue（仅『本地 CLI』视角）；第二遍重审发现 registry 条目的 HTML/JS 会被安装后并入宿主 composition 执行，且 add 每次联网取文件，属有外发的远程内容信任面，按统一分档『有网络外发按对象分级』定为 yellow 并在 injection_surface 显式说明。

6结论

  • 网络纪律清晰可预期：默认搜索零流量，外发收窄为安装/反馈/模型下载三个显式动作
  • 对两代目录/安装性/离线边界都做诚实分层，避免 agent 把失败误报为缺陷
  • 接线语义（data-composition-src/id/start/track-index）讲得足够死，减少 sub-composition 装配类 bug
  • 消费与贡献一体、质量标准内建，缺口可回流成上游条目
    • 适合：适合所有需要在 HyperFrames composition 里复用 catalog block/component 的创作会话（数据图表、grain overlay、转场、字幕样式），以及想给目录补条目的贡献者（idea→PR 全流程在此）。
    不适合：不适合离线渲染/安装场景（add 必须联网）；不适合不需要 registry 的极简 composition（先问 hyperframes-core）；不适合想从零手写组件样式而非搜 catalog 的探索型会话（应先 catalog 后手写）。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-09-09
    方式 A · 人下载镜像包下载 hyperframes-registry.tar.gz
    sha256: f0bfec893d952c12…
    方式 B · JSON 格式安装指南，复制给 agent
    安装指南
    agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
    ② 上游 GitHub · 原始来源
    能访问 GitHub？直接去上游安装（实时版，可能已更新）GitHub 原始 ↗
    本页镜像锁定 commit b8328f9573；上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库heygen-com / heygen-com/hyperframes
    原始 GitHubheygen-com/hyperframes ↗
    Stars48297
    最近推送2026-09-09
    本 skill commitb8328f9573
    许可Apache-2.0（仓库根 LICENSE；GitHub API spdx Apache-2.0）
    本站信息
    收录日期2026-09-06
    分类内容创作
    侦查报告2026-09-06 · 2 遍
    本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。