1实现原理 · 为什么它能做到
整份文档的因果起点是 Studio 的渲染模型：时间线为每个顶层元素画一行。因此「层级怎么切」直接决定用户能不能在 Studio 里编辑，而不是审美问题。
skills/hyperframes-studio/SKILL.md
Studio draws one timeline row per top-level element. A project that follows the rules below opens as a short, readable timeline; one that does not opens as a wall of unlabeled rows the user cannot edit.
注：这里在做什么：把「结构约定」论证成「可用性约束」，先给失败态（一排无法编辑的无名行），再给四条规则。
规则一：根合成只装顶级宿主、媒体与音频；任何有嵌套结构的场景都拆成独立文件、经 data-composition-src 挂载——留在根里的嵌套标记不会变成独立行。
skills/hyperframes-studio/SKILL.md
The root composition holds only timed hosts, media and audio.
注：这里在做什么：给出可判定的判据（「有子元素就拆」），并点明后果——不拆的嵌套会藏进一个不可分段剪裁的不透明白行。
规则二：全部字幕只占一条轨——单个带 data-track-kind="captions" 的子合成宿主按顺序承载所有字幕组；不许一个字幕组一行，也不许和别的类型混轨。
skills/hyperframes-studio/SKILL.md
- All captions live on one track: a single sub-composition host (one `data-track-index`)
注：这里在做什么：把「轨」定义成「用户能整体选中/静音/拖动的一组」，因此按类型聚合而不是按内容分组；词级时间规则仍归 /embedded-captions 与 caption_* lint 规则。
规则三：每条轨只放一种元素类型，用 data-track-kind 标出（video/graphics/captions/audio），且 data-track-index 只是显示序号、不决定层级——层级用 CSS 决定。
skills/hyperframes-studio/SKILL.md
Give each kind its own `data-track-index`; the number is display only; it never changes what renders on top.
注：这里在做什么：消除一个常见误解（以为 track-index 是 z 序），把手写 HTML 里容易搞混的「轨序 vs 层序」明确切开。
规则四：安全区只在预览面板里画、绝不写进合成；横竖两种画幅共用同一套安全框（Adobe Premiere 默认：动作安全 90%、标题安全 80%），字幕与关键内容须落在标题安全框内。
skills/hyperframes-studio/SKILL.md
Safe margins: everything visible stays inside the action-safe box (90%), and captions and key content stay inside the title-safe box (80%).
注：这里在做什么：把「引导线属于工具、不属于产物」写成纪律，防止导出的 HTML 里混进只在编辑器里有意义的方块；两栏/对分布局也要求各自落在标题安全框内。
收尾是双证据核对：先跑 hyperframes lint 修完所有发现，再在 Studio 里目视确认时间线构成（一条基础行 + 每个场景宿主一行 + 一条字幕行 + 音频行）。
skills/hyperframes-studio/SKILL.md
Run `hyperframes lint` and fix every finding.
注：这里在做什么：把「结构对不对」交给静态检查，把「读起来顺不顺」留给人的眼睛，两条都要过。
边界写得很清楚：本 skill 只讲「该建出什么形状」，具体怎么改一个片段（切/裁/变速/音量/复制/替换）一律回到 /hyperframes-core 的 creator-editing-recipes.md，不许自创同义做法。
skills/hyperframes-studio/SKILL.md
For how to change a clip, follow `/hyperframes-core` `references/creator-editing-recipes.md` and never invent a different form of the same edit.
注：这里在做什么：显式拒绝重复定义别家规则（单一定义源原则），也让触发条件（谁来用这个 skill）在 description 里就写清。
2核心能力
01根合成切分契约：根只保留计时宿主/媒体/音频，任何含子元素的场景拆成独立文件并用 data-composition-src 挂载
02字幕单轨契约：所有字幕组承载在一条 data-track-kind="captions" 的宿主轨上，既不分组成行也不与其他类型混轨
03轨类型清单与标注方式：video（来自标签）/ graphics / captions / audio（来自标签），子合成宿主需显式写 data-track-kind
04安全区规范：动作安全 90%（每边内缩 5%）、标题安全 80%（每边内缩 10%），两种画幅共用；两栏/对分布局各自受标题安全框约束
05引导线归位：安全框/标尺只存在于预览面板，产物 HTML 里不得出现辅助元素
06收尾双证据核对：lint 全绿 + 在 Studio 目视确认时间线由「基础行 / 每场景宿主一行 / 一条字幕行 / 音频行」组成
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | hyperframes lint（唯一被本 skill 点名的外部命令，作为结构正确性的静态门禁） |
4风险提醒 风险提醒：绿色 · 放心使用
风险提醒：绿色 · 放心使用
- 约定与宿主实现耦合 — 文档引用的常量名与 lint 规则名（caption_*）全部在宿主侧；一旦宿主改名或调整安全框默认值，这份文档会静默失真。使用前建议核对版本。
- 不覆盖单品编辑，误用会走偏 — description 已声明本 skill 不负责 split/trim/retime/volume/copy/swap；若把它当成编辑手册，会得到「形状对了但不知道怎么动手」的结果。
- 只对 Studio 场景有效 — 约定的前提是「有人会在 Studio 里打开这个项目编辑」。纯渲染交付（无人打开时间线）的项目套用这些规则只会增加结构复杂度。
- 依赖 agent 自觉执行 — 文档无强制机制；结构错误只能靠 hyperframes lint 与人工目视发现，agent 若跳过收尾核对，违规结构会一路带进交付。
风险提醒：绿色，放心使用。判级对象＝skill 自身目录：仅 1 个 markdown 文件，零脚本、零网络调用、零凭证/环境变量读取、零写入指令；全域 token 扫描（http(s) URL / fetch / process.env / child_process / writeFile / API_KEY|TOKEN|SECRET）命中 0。它只做两件事：给出时间线结构的四条约定与安全区百分比，然后要求跑 hyperframes lint 并目视核对——执行发生在宿主 CLI 侧，按范式「宿主行为不改档位」记入 reason 而不抬档。唯一可验证的对外引用（安全区常量所在的 packages/studio/src/utils/previewSafeMargins.ts）是仓库内读数，实测 ACTION_SAFE_PERCENT=90、TITLE_SAFE_PERCENT=80，与文档表格一致。
5第二遍独立确认
- [ok] 安全区百分比与宿主源码常量是否一致（文档唯一可被代码验证的声明） — SKILL.md 给出 Action-safe 90%（每边 5%）、Title-safe 80%（每边 10%），并指明来源 packages/studio/src/utils/previewSafeMargins.ts。打开该文件实测：`export const ACTION_SAFE_PERCENT = 90;` 与 `export const TITLE_SAFE_PERCENT = 80;`，注释亦写明「Adobe Premiere default: action-safe and title-safe margins are 10% and 20% total (5% and 10% per edge)」——文档与代码一致。
- [ok] 是否遗漏网络调用 / 脚本 / 凭证（绿档判定的关键反例检查） — 全域扫描 URL、fetch、process.env、child_process、writeFile、credential 关键词均为 0 命中；目录内只有 1 个 md 文件，无 scripts/、references/、资产。因此不存在隐藏执行面。
- [ok] 「轨类型 / 字幕单轨」等约定是否与仓库 lint 规则对得上（避免文档与实现脱节） — 文档自述「Author as if a structure lint rejects any violation」，并把词级时间规则交给 /embedded-captions 与 caption_* lint 规则；同仓 /embedded-captions 与 /hyperframes-core 的 lint 域存在对应规则，故约定不是孤例自说。本 skill 自身不实现 lint，属声明面。
- [ok] 是否存在夸大（把宿主能力说成自己的） — 文档通篇用祈使式约定（该建出什么形状）与指向（去看某文件），没有声称自己执行检查或渲染；收尾要求跑的是 hyperframes lint（宿主命令）。与同批 hyperframes-keyframes 同型：纯约定文档，能力来自宿主。
6结论
适合：适合在做「会被人打开 Studio 编辑」的 HyperFrames 项目时当结构规范：把根合成切薄、把场景做成子合成、字幕收成一条轨、按类型分轨、内容守安全区，收尾跑 lint 再目视核对时间线形状。也适合作为团队约定被其他工作流 skill 复用（它是 hyperframes 家族的结构纪律来源之一）。
不适合：不适合：① 需要具体编辑操作说明的场景（切/裁/变速/音量/复制/替换 → 用 /hyperframes-core）；② 不面向 Studio 的纯渲染项目（约定的收益不成立）；③ 只关心某个动效怎么实现的场景（应看 hyperframes-animation / hyperframes-keyframes）；④ 期待本 skill 自动修复结构错误的人——它只给约定与检查点，不执行修改。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-28
方式 A · 人下载镜像包下载 hyperframes-studio.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agente1afb0832db4ac26…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库heygen-com / heygen-com/hyperframes
原始 GitHubheygen-com/hyperframes ↗
Stars44283
最近推送2026-09-06
本 skill commit
d2f0bc7f34许可Apache-2.0（仓库根 LICENSE 为 Apache License Version 2.0；池内值亦为 Apache-2.0）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。