Communitygithub.com

bobzhou-source/Parsifal-Demo

使用 HyperFrames 在 Parsifal 中通过 HTML、CSS 和 JavaScript 组合创建 AI 视频,并验证、渲染为 MP4。适用于短视频片头、电影预告片、产品推广、字幕动画、HUD/科技视觉效果、Web 转视频以及动态图形制作。

Parsifal-Demo 是什么?

该技能允许开发者利用 HyperFrames 框架,在 Parsifal 环境中直接通过 HTML、CSS 和 JavaScript 构建视频场景,并最终渲染为 MP4 文件。它的核心优势在于将 HTML 作为视频源,使得 Web 开发者可以复用前端技能创建高质量视频,无需学习传统视频编辑工具。技能支持完整的创作工作流:从需求分析、项目初始化、布局动画编写,到验证(lint 和 inspect)和渲染(支持 draft/standard/high 质量)。适用于短视频片头、电影微预告、产品宣传片、滚动字幕动画、HUD/UI 科技视觉效果以及 Web 页面转视频等场景。需要注意的是,渲染过程依赖 Node.js 和 FFmpeg,且动画逻辑必须确定(避免 Math.random 或无限循环),并通过数据属性(data-composition-id、data-start、data-duration 等)精确控制每个片段。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bobzhou-source/Parsifal-Demo/tree/HEAD/packages/skills/hyperframes

在你喜欢的 AI 中提问

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

文档

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

工作流程

  1. 将用户的需求转换为简短的制作简报:时长、宽高比、目标平台、语言、风格、音乐或配音需求以及最终输出路径。
  2. 对于不完整的简报,使用合理的默认值。竖屏短视频使用 1080x1920,横屏视频使用 1920x1080,帧率 30 fps,输出格式 MP4。
  3. 创建或复用 HyperFrames 项目:
npx hyperframes init my-video --non-interactive
  1. 使用 HTML/CSS/JS 编写组合。在添加动画之前,确保静态主框架布局正确。
  2. 渲染前进行验证:
npx hyperframes lint
npx hyperframes inspect --samples 15
  1. 必要时预览:
npx hyperframes preview
  1. 渲染最终视频:
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 后(除非用户明确要求仅提供源文件)才算完成。

相关技能