门控——在任何合成之前
字面触发条件:交付物是一个渲染后的媒体文件。 MP4、WebM、MOV、PNG。 关注的是交付物的格式,而非外观。
不激活此技能的场景:
- 在网站内使用的视频——如英雄区、背景、用户证言。这是普通的 Web 素材,
与任何图片或字体一样处理(参见
referencias/assets.md)。 - 看似“视频”但可交互的动画 UI 片段——属于界面动画或 3D,而不是渲染输出。
区分标准是交付物的格式。如果结果在浏览器中打开并响应点击, 则不适用此技能。
格式、分辨率、帧率和时长没有默认值
选择“1080p 30fps 因为是常见规格”正是门控要防止的行为。这些 四个字段——格式、分辨率、帧率和时长——必须在合成开始前由用户提供。
操作成本——在承诺前确认
HyperFrames 不是一个导入操作:它是一个生产过程。它依赖于Chrome 和 FFmpeg 已安装,并且捕获过程可能分布式执行。
在承诺使用此路线之前,请确认基础设施存在。等到渲染时才发现 缺少 FFmpeg,意味着整个合成已经写完后才发现问题。
渲染永远不是自动的
没有任何渲染执行可以在没有用户明确授权的情况下进行。 渲染会消耗机器时间, 并且在涉及媒体生成时,还涉及实际成本。
当缺少某个资源且替代方案是生成它时:请明确指出缺少什么以及将要生成什么——然后 就此打住。
如何使用
frontend-video/
├── SKILL.md ← 本文件。唯一始终被读取的文件
└── referencias/
├── hyperframes.md 门控、格式/帧率/时长、确定性时间、
│ 适配器、字幕、渲染授权
├── direcao-visual.md 带书面理由的 Token,反通用
├── assets.md 来源、许可、优化——此处资源即交付物
└── validacao.md 适用于媒体的门控检查
| 你的任务 | 打开文件 |
|---|---|
| 决定格式、分辨率、帧率、时长 | hyperframes.md §3 |
| 内容、字体、字幕、权利 | hyperframes.md §4 |
| 确定性时间、可复现输出、场景适配器 | hyperframes.md §5 |
| 作品的可访问性和性能 | hyperframes.md §6 |
| 授权渲染 | hyperframes.md §7 |
| 合成的美学方向 | direcao-visual.md |
| 图片、字体、音轨的许可 | assets.md |
| 完成交付物 | validacao.md |
始终忽略: SEO、可索引 DOM、导航流程和应用状态——确定性媒体不包含任何这四项。 Web 运行时作为最终交付物也不适用:此处浏览器是捕获工具,而非目标。
可复现性——“确定性”真正要求什么
引擎使得合成可按时间搜索。仅此一点并不能保证输出完全一致。
承诺按字节可复现的文件需要固定所有这些项:HyperFrames、Chrome、 FFmpeg、字体、资源、编解码器和标志、分辨率、帧率、时长和环境。 没有这种锁定,即使是同一次提交也不允许做出此承诺。
审计来源:仓库 heygen-com/hyperframes,提交
af1cb1c10da33bade100db8233435c7591b7c0bc,该提交下的主要包 0.8.17,
根目录和 CLI 中为 Apache-2.0 许可。上次审计日期:2026-08-28。如果版本更改或
合成依赖未在清单中涵盖的能力,请重新审计。
始终有效的原则
- 真实内容,绝不编造——不使用貌似最终效果的占位符。
- 字幕和对比度是交付物的一部分,而非额外选项。
- 对实际输出进行验证,而不是预览。预览显示的内容与最终文件中包含的内容可能 存在差异——编解码器、颜色和时序在两者之间可能不同。
- 场景代码仍然负责自身的清理。 合成中的 Three/WebGL 场景需要像在其他任何地方一样 进行拆卸。