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外部依赖
| Kind | Dependency / Endpoint |
|---|---|
| cli | hyperframes CLI（add/catalog/feedback/init；经 npx 或项目内安装） |
| network | registry 源 |
| network | CLI 不可达时的 raw manifest 回退 |
| network | catalog 语义层模型下载（--on-device，一次性、需同意，约 33MB） |
| network | feedback --search-miss 上报（唯一发送查询的命令） |
| network | CDN 依赖（component/demo 模板引 gsap；contributing 流程示例） |
4管控建议与判定依据
建议配套管控措施
面向 Agent
分级或逐次授权，建议在沙箱运行
面向管理者
审批流程、可回滚、全程审计
判定依据（文件路径与关键语句摘要）
- scripts/: 执行本地脚本或命令: hyperframes add / npx hyperframes catalog / feedback --search-miss / hyperf
- 网络端点: 声明外部网络访问: registry 安装拉取：每次 add 都从 raw.githubusercontent.com/heygen-com/hyperframes 取条
- 本地工作目录: 文件读写与工件输出: 安装产物：compositions/<name>.html（blocks）、compositions/components/<name>.html（c
审计说明： 。常规网络调用且外发对象可预期：搜索本地零外发；联网点集中在官方 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结论
适合： 适合所有需要在 HyperFrames composition 里复用 catalog block/component 的创作会话（数据图表、grain overlay、转场、字幕样式），以及想给目录补条目的贡献者（idea→PR 全流程在此）。
不适合： 不适合离线渲染/安装场景（add 必须联网）；不适合不需要 registry 的极简 composition（先问 hyperframes-core）；不适合想从零手写组件样式而非搜 catalog 的探索型会话（应先 catalog 后手写）。
Install Agent-Ready
① Verified Mirror 2026-09-09
Option A · Direct DownloadDownload hyperframes-registry.tar.gz
sha256:
Option B · Copy Guide for Agentf0bfec893d952c12…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit b8328f9573.