HyperFrames
当用户要求 Parsifal 使用 HyperFrames 制作视频(例如 30 秒竖屏视频、短片头、电影微预告、产品推广、动画字幕、HUD 风格科技视觉、网页转视频或 HTML/CSS/JS 动态图形渲染)时,使用此技能。
HyperFrames 将 HTML 作为视频的唯一真实来源。将视频场景构建为 HTML 组合(包含 CSS 布局和 JavaScript 动画),验证布局,然后渲染为 MP4。
设置
如果未安装 HyperFrames 或缺少官方技能,请先安装:
parsifal skills install official/creative/hyperframes
使用 npx hyperframes 进行项目操作。HyperFrames 需要 Node.js 和 FFmpeg。如果渲染或预览失败,请运行:
npx hyperframes doctor
工作流程
- 将用户的需求转换为简短的制作简报:时长、宽高比、目标平台、语言、风格、音乐或配音需求以及最终输出路径。
- 对于不完整的简报,使用合理的默认值。竖屏短视频使用 1080x1920,横屏视频使用 1920x1080,帧率 30 fps,输出格式 MP4。
- 创建或复用 HyperFrames 项目:
npx hyperframes init my-video --non-interactive
- 使用 HTML/CSS/JS 编写组合。在添加动画之前,确保静态主框架布局正确。
- 渲染前进行验证:
npx hyperframes lint
npx hyperframes inspect --samples 15
- 必要时预览:
npx hyperframes preview
- 渲染最终视频:
npx hyperframes render --output final.mp4 --quality standard
快速迭代时使用 --quality draft,当用户需要高质量导出时使用 --quality high。
组合规则
- 使用带有
data-composition-id、data-width和data-height的根元素。 - 对于定时片段,使用
data-start、data-duration和data-track-index。 - 在
window.__timelines上同步注册 GSAP 时间线。 - 使用 CSS 作为最终布局状态,然后从该状态(或动画到该状态)进行动画。
- 媒体播放应在 HyperFrames 运行时控制下。请勿手动调用
play()、pause()或 seek 媒体。 - 避免非确定性动画逻辑,如
Math.random()或Date.now(),除非使用种子生成器。 - 不要使用无限重复。根据组合持续时间计算有限重复次数。
- 检查文本、字幕、UI 面板和 HUD 元素在每个检查的时间戳是否保持在帧内。
交付
完成后,告知用户:
- 渲染后的 MP4 路径;
- 如果预览服务器正在运行,提供预览 URL;
- 关于时长、宽高比、风格、旁白或音乐的任何假设;
- 任何未解决的验证问题。
编写 HTML 后不要停下。HyperFrames 任务只有在组合经过 lint 和 inspect 检查并渲染为 MP4 后(除非用户明确要求仅提供源文件)才算完成。