用途:HyperFrames 把 HTML 页面渲染成视频。一个合成(composition)就是一个 HTML 文件,用 data-* 属性定义时序、用 GSAP 时间线做动画、用 CSS 定义外观;引擎逐帧截取页面,经 FFmpeg 编码为 MP4/WebM。它适合动态图形、带字幕的口播视频、产品演示、社交覆盖层、着色器转场,以及任何由真实视频/音频驱动的动画;纯数学/公式动画(如 3B1B 风格)建议改用 manim-video,也不用于图像生成、直播或会议。
主要能力:脚手架初始化、lint 校验、validate 对比度审计(WCAG,正文 4.5:1、大字 3:1)、inspect 视觉布局审计(溢出、越界、遮挡)、浏览器实时预览与渲染输出;支持 TTS、按词转写生成字幕、音频反应式视觉、标记高亮、CSS 与着色器转场;另提供 7 步 URL 转视频流程。
使用方式:一次性安装用 bash "$(dirname "$(find ~/.hermes/skills -path '*/hyperframes/SKILL.md' 2>/dev/null | head -1)")/scripts/setup.sh",它会检查 Node.js >= 22 与 FFmpeg、全局安装 CLI(npm install -g hyperframes@>=0.4.2)、通过 Puppeteer 预缓存 chrome-headless-shell 并运行 doctor。常用命令:npx hyperframes init my-video、npx hyperframes lint、npx hyperframes preview(端口 3002)、npx hyperframes render --output final.mp4、npx hyperframes doctor。渲染参数含 --quality draft|standard|high、--fps 24|30|60、--format mp4|webm、--docker、--strict。TTS 示例:npx hyperframes tts "Script text" --voice af_nova --output narration.wav。转场安装:npx hyperframes add <transition-name>。
限制与注意:时间线必须注册到 window.__timelines 并以 paused 启动;禁用 repeat: -1,需算有限次数;动画必须确定性,不用 Math.random()、Date.now()、异步构建;音频用独立 <audio> 元素、视频静音;不自行调用 video.play();多场景必须用转场且不混用 CSS 与着色器转场;每个字幕组退出后要硬性置隐藏。渲染失败时运行 doctor 并附输出。其他平台与收费信息暂未提供。