Communitygithub.com

octaviosilva2/frontend-video-skill

使用 HyperFrames 生成确定性视频 — 通过 Chrome/FFmpeg 捕获 HTML/CSS 合成,支持声明的格式、帧率、时长和分辨率,并需用户授权渲染。适用于交付物为渲染后的媒体文件(MP4、WebM、MOV、PNG)的场景,当用户要求视频片段、导出动画或可复现的合成时使用。不用于嵌入网站的视频(属于普通 Web 素材)或可交互的动画 UI。

frontend-video-skill 是什么?

本技能用于通过 HyperFrames 引擎生成确定性视频。其核心原理是利用 Chrome 渲染 HTML/CSS 页面,再通过 FFmpeg 捕获为指定的媒体格式(如 MP4、WebM、MOV、PNG),支持精确控制分辨率、帧率、时长等参数,并可确保输出在相同环境下完全可复现。该技能特别适用于需要以媒体文件作为最终交付物的场景,例如短片、动画导出、演示视频。它明确区分于普通的 Web 嵌入式视频或交互式 UI 动画——后两者应作为标准 Web 资源处理。技能工作流包含严格的门控检查:格式、分辨率、帧率和时长必须由用户显式提供(无默认值);渲染操作必须经过用户明确授权;运行环境依赖 Chrome 和 FFmpeg 的安装;完整可复现性需要锁定 HyperFrames、Chrome、FFmpeg 的精确版本及所有资源。注意:本技能不涉及 SEO、可索引 DOM、导航流程或应用状态——确定性媒体不含这些元素,运行时的浏览器仅作为捕获工具而非最终目标。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add octaviosilva2/frontend-video-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

门控——在任何合成之前

字面触发条件:交付物是一个渲染后的媒体文件。 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。如果版本更改或 合成依赖未在清单中涵盖的能力,请重新审计。

始终有效的原则

  1. 真实内容,绝不编造——不使用貌似最终效果的占位符。
  2. 字幕和对比度是交付物的一部分,而非额外选项。
  3. 对实际输出进行验证,而不是预览。预览显示的内容与最终文件中包含的内容可能 存在差异——编解码器、颜色和时序在两者之间可能不同。
  4. 场景代码仍然负责自身的清理。 合成中的 Three/WebGL 场景需要像在其他任何地方一样 进行拆卸。

相关技能