Communitygithub.com

Bailipa/EZTor_FULLBLOOD

创建视频合成、动画、标题卡、覆盖层、字幕、配音、音频反应视觉和场景过渡的 HyperFrames HTML 技能。用于构建任何基于 HTML 的视频内容、添加与音频同步的字幕、生成语音旁白、创建音频反应动画(节拍同步、发光、脉动)以及添加场景过渡。

EZTor_FULLBLOOD 是什么?

这个技能专为 HyperFrames 框架设计,用于通过 HTML 全面制作视频。它将 HTML 文件作为视频合成的唯一真实来源,利用 `data-*` 属性控制时间,使用 GSAP 库驱动动画,并通过 CSS 定义视觉样式。技能的核心工作流程包括:明确视觉身份(通过 `DESIGN.md` 或用户指定)、先构建静态布局(“先布局后动画”原则)、再添加入场和退场 GSAP 动画。支持子合成、多轨道音频/视频叠加、音频反应动画(节拍同步、发光、脉冲)、文本高亮动画(标记扫描、手绘圆圈、爆发线条)和多种场景过渡(交叉淡入淡出、擦除、显示、着色器过渡)。当在 Open Design(OD)环境中运行时,技能会自动采用优化路径:使用脚手架快速生成可渲染模板,并通过 OD 守护进程进行渲染(避免沙箱问题),同时将合成源文件保存在隐藏缓存目录中,不污染用户的项目视图。该技能适用于 Claude Code、Cursor 等 AI 代理工具,覆盖从构思、编辑到最终渲染的完整视频制作流程。对于 CLI 子命令(如 `init`、`lint`、`preview`、`render`、`transcribe`、`tts`),用户应参考 `hyperframes-cli` 技能文档。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Bailipa/EZTor_FULLBLOOD/tree/HEAD/.opencode/skills/open-design/hyperframes

在你喜欢的 AI 中提问

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

文档

HyperFrames

HTML 是视频的唯一真实来源。一个合成就是一个 HTML 文件,使用 data-* 属性控制时间,使用 GSAP 时间线驱动动画,并使用 CSS 控制外观。该框架负责处理剪辑可见性、媒体播放和时间线同步。

在 Open Design 中的集成(对本技能至关重要)

当此技能在 Open Design(即设置了 $OD_PROJECT_DIR)中运行时,输出流程是固定的:只有渲染后的 .mp4 文件应放在项目根目录。合成源文件(hyperframes.json、meta.json、index.html、资源文件)应放在隐藏的缓存目录中,这样它们就不会弄乱用户的 FileViewer 或聊天中的“生成文件”标签。

在 OD 中的渲染工作流程——快速路径:

对于大多数 OD 请求(“测试视频”、“5秒产品展示”、“演示片段”),不要从头编写合成 HTML。使用 HyperFrames 内置的脚手架,只编辑提示实际更改的内容。“从头创作”的路径会花费数分钟的模型输出和静默的聊天工具时间;脚手架路径只需要几秒钟。

# 1. 选择一个隐藏的缓存槽。点号前缀 → OD 的项目文件
#    列表会跳过它,因此源文件永远不会弄乱聊天。
COMP_REL=".hyperframes-cache/$(date +%s)-$(openssl rand -hex 2)"
COMP="$OD_PROJECT_DIR/$COMP_REL"

# 2. 获取一个立即可渲染的脚手架(hyperframes.json、
#    meta.json、index.html 包含 GSAP CDN 和已注册的
#    window.__timelines.main)。这在你的 shell 中运行——纯文件复制,
#    不需要 Chrome,除了 npx 缓存外不需要网络。
npx hyperframes init "$COMP" --example blank --skip-skills --non-interactive

# 3. 只编辑 $COMP/index.html——如果需要一个非默认长度,更改根元素上的
#    `data-duration`;在 `<style>` 中替换占位调色板;为文字/图像添加
#    1-3 个剪辑 `<div>`;并在现有的
#    `window.__timelines["main"] = gsap.timeline({paused:true})` 块内
#    添加匹配的 GSAP 补间动画。保持编辑最小化;脚手架已经是有效的 HF。

# 4. 通过 OD 守护进程调度渲染。不要在此 shell 中运行 `npx hyperframes
#    render`——守护进程会为你在一个非沙盒进程中运行它。(许多代理 CLI,
#    特别是 Claude Code,会将 Bash 包装在 macOS sandbox-exec 中,
#    导致 puppeteer 的 Chrome 子进程在帧捕获过程中挂起。守护进程是
#    非沙盒的,因此渲染可以可靠完成。)
#
#    调度器在大约 1 秒内返回一个 {taskId};通过循环调用
#    `od media wait <taskId>` 驱动渲染完成。
#    每次调用长轮询最多 25 秒(远低于 shell 工具的默认 30 秒上限),
#    并以退出码 0/2/5 表示完成/运行中/失败。
out=$(node "$OD_BIN" media generate \
  --project "$OD_PROJECT_ID" \
  --surface video \
  --model hyperframes-html \
  --output "<描述性名称>.mp4" \
  --composition-dir "$COMP_REL")
ec=$?
task_id=$(printf '%s\n' "$out" | tail -1 | jq -r '.taskId // empty')
since=$(printf '%s\n' "$out" | tail -1 | jq -r '.nextSince // 0')
while [ "$ec" -eq 2 ] && [ -n "$task_id" ]; do
  out=$(node "$OD_BIN" media wait "$task_id" --since "$since")
  ec=$?
  since=$(printf '%s\n' "$out" | tail -1 | jq -r '.nextSince // '"$since")
done
[ "$ec" -ne 0 ] && { echo "$out" >&2; exit "$ec"; }

每次 generate 和 wait 调用最多持续约 25 秒,因此代理 shell 工具的默认约 30 秒上限永远不会触发。来自 HF 的进度行(Capturing frame N/M)在整个循环中实时流式传输到 stderr。当渲染完成时,最后的 stdout 行是 {"file": { "name": "<output>", "size": …, "kind": "video", … }}——在你的回复中引用 file.name,以便用户知道生成了什么。

在 OD 内部跳过视觉身份门禁. 下面的 HARD-GATE 部分(在“方法”下)告诉你在编写任何合成之前,要先阅读 DESIGN.md / visual-style.md,或者停下来问 3 个情绪问题。那个门禁适用于独立的 HF 项目。OD 项目已经有自己的设计系统层——用户在创建项目时就选择了他们的视觉方向。对于 OD 测试渲染,默认为:深色画布(#0b0b0f)、一个暖色强调色(#ffb76b)、一个冷色强调色(#7da4ff)、克制的运动。只有当用户的提示过于模糊以至于无法选择主题时(很少见),才询问样式输入。

何时跳过脚手架并从头编写:只有当用户明确要求空白模板明显无法承载的内容时(例如,多合成时间线、音频反应覆盖层、与已生成的 TTS 轨道同步的字幕)。对于其他一切,init + edit 是默认路径。

你仍然可以从你自己的 shell 运行较轻量的 HF 子命令(它们不需要启动 Chrome):

  • npx hyperframes lint "$COMP" — 在调度前验证合成
  • npx hyperframes transcribe <audio> — 生成字幕
  • npx hyperframes tts <text> — 生成旁白

将守护进程调度保留给 render/inspect/preview(任何需要 Chrome 的操作)。

不要调用 od media generate --model hyperframes-html——那个调度路径会故意返回 400(AGENT_RENDERED)。HyperFrames 由你直接通过 npx 渲染。

不要将 hyperframes.json / meta.json / index.html 放在项目根目录;OD 的文件列表会递归扫描,用户会在聊天中看到三个不相关的文件出现。

对于 render 之外的 CLI 选项(lint、preview、transcribe、tts、inspect、benchmark),当任务需要时直接从你的 shell 工具调用它们(例如,在从合成中引用之前,将 TTS 音频生成到缓存中)。

方法

在编写 HTML 之前,从高层次思考:

  1. 什么——观众应该体验什么?识别叙事弧线、关键时刻和情感节拍。
  2. 结构——多少个合成,哪些是子合成与内联的,哪些轨道承载什么(视频、音频、覆盖层、字幕)。
  3. 时间——哪些剪辑决定了持续时间,过渡在哪里出现,节奏是什么。
  4. 布局——先构建最终状态。见下面的“先布局后动画”。
  5. 动画——然后使用下面的规则添加运动。

对于小的编辑(修复颜色、调整时间、添加一个元素),直接跳到规则。

视觉身份门禁

按此顺序检查:

  1. 项目根目录存在 DESIGN.md? → 阅读它。使用其确切的颜色、字体、运动规则和“不要做什么”约束。
  2. 存在 visual-style.md? → 阅读它。应用其 style_prompt_full 和结构化字段。(注意:visual-style.md 是项目特定的文件。visual-styles.md 是包含 8 个命名预设的样式库——不同的文件。)
  3. 用户指定了样式(例如,“Swiss Pulse”、“黑暗科技风”、“奢侈品牌”)?→ 阅读 visual-styles.md 中的 8 个命名预设。生成一个最小的 DESIGN.md,包含:## 样式提示(一段落)、## 颜色(3-5 个带角色的十六进制值)、## 字体(1-2 个字体系列)、## 不要做什么(3-5 个反模式)。
  4. 以上都没有? → 在编写任何 HTML 之前问 3 个问题:
    • 情绪是什么?(爆发式 / 电影感 / 流畅 / 技术感 / 混乱 / 温暖)
    • 浅色还是深色画布?
    • 有任何特定的品牌颜色、字体或视觉参考吗? 然后根据答案生成一个最小的 DESIGN.md。

每个合成必须将其调色板和字体追溯回 DESIGN.md、visual-style.md 或用户的明确指示。如果你正在使用 #333、#3b82f6 或 Roboto——你跳过了这一步。

关于运动默认值、大小、入场模式和缓动——遵循 house-style.md。house style 处理事物如何移动。DESIGN.md 处理事物看起来像什么。

先布局后动画

将每个元素定位在其最可见时刻应处的位置——即它完全进入、正确定位且尚未退出的那一帧。首先将其写为静态 HTML+CSS。不要使用 GSAP。

为什么这很重要: 如果你将元素定位在其动画起始状态(屏幕外、缩放为 0、透明度 0)并将它们补间到你认为应该着陆的位置,你是在猜测最终布局。重叠在视频渲染之前是不可见的。通过先构建最终状态,你可以在添加任何运动之前看到并修复布局问题。

过程

  1. 识别每个场景的英雄帧——最多元素同时可见的时刻。这就是你要构建的布局。
  2. 为该帧编写静态 CSS。.scene-content 容器必须使用 width: 100%; height: 100%; padding: Npx; 配合 display: flex; flex-direction: column; gap: Npx; box-sizing: border-box 来填充整个场景。使用内边距将内容向内推——永远不要在内容容器上使用 position: absolute; top: Npx。绝对定位的内容容器在内容高于剩余空间时会溢出。仅对装饰性元素保留 position: absolute。
  3. 使用 gsap.from() 添加入场——从屏幕外/不可见动画到 CSS 位置。CSS 位置是事实依据;补间描述了到达那里的过程。
  4. 使用 gsap.to() 添加退场——从 CSS 位置动画到屏幕外/不可见。

示例

/* scene-content 填充场景,内边距定位内容 */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* 容器填充任何场景尺寸(1920x1080、1080x1920 等)。
   内边距定位内容。Flex + gap 处理间距。 */

错误——硬编码尺寸和绝对定位:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// 步骤 3:动画进入这些位置
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// 步骤 4:从这些位置动画退出
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

当元素随时间共享空间时

如果元素 A 在元素 B 进入同一区域之前退出,两者都应该为其各自的英雄帧具有正确的 CSS 位置。时间线排序保证它们永远不会在视觉上共存——但如果你跳过布局步骤,你将不会发现由于时间错误而导致它们意外重叠的情况。

什么算是有意重叠

分层效果(文字后的发光、阴影元素、背景图案)和 z 轴堆叠设计(卡片堆叠、深度层)是有意的。布局步骤是关于捕捉无意的重叠——两个标题互相叠放、一个统计数字覆盖标签、内容溢出画面。

数据属性

所有剪辑

属性必需值
id是唯一标识符
data-start是秒数或剪辑 ID 引用("el-1"、"intro + 2")
data-durationimg/div/合成必需秒。视频/音频默认为媒体时长。
data-track-index是整数。同一轨道的剪辑不能重叠。
data-media-start否源文件的修剪偏移量(秒)
data-volume否0-1(默认为 1)

data-track-index 不影响视觉层叠——使用 CSS z-index。

合成剪辑

属性必需值
data-composition-id是唯一的合成 ID
data-start是开始时间(根合成:使用 "0")
data-duration是优先于 GSAP 时间线持续时间
data-width / data-height是像素尺寸(1920x1080 或 1080x1920)
data-composition-src否外部 HTML 文件的路径

合成结构

通过 data-composition-src 加载的子合成使用 <template> 包装器。独立合成(主 index.html)不要使用 <template>——它们将 data-composition-id div 直接放在 <body> 中。在独立文件上使用 <template> 会向浏览器隐藏所有内容并破坏渲染。

子合成结构:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- 内容 -->
    <style>
      [data-composition-id="my-comp"] {
        /* 作用域样式 */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // 补间动画...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

在根目录中加载:<div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

视频

…

[为翻译截断]

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Bailipa/EZTor_FULLBLOOD

A single-frame motion-design composition with looping CSS animations — rotating type ring, animated globe, ticking timer, parallax labels. Renders as a hero video poster you can hand straight to HyperFrames or any keyframe-based exporter. Use when the brief asks for "motion design", "animated hero", "loop", "video poster", "title card", or pairs Open Claude Design with HyperFrames for a kinetic export.

Bailipa/EZTor_FULLBLOOD

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Bailipa/EZTor_FULLBLOOD

A pixel / sprite-style animated explainer slide — full-bleed cream stage, bold display year, animated pixel-art mascot (e.g. Hanafuda card, mushroom, or 8-bit console), kinetic Japanese display type, ticking timeline ribbon. Reads like a single frame of an educational motion video — looping CSS keyframes, no JS, ready to be screen-recorded into a vertical video. Use when the brief asks for a "sprite animation", "pixel-art video", "8-bit explainer", "history of X explainer", "kinetic typography history", "Nintendo-style", "精灵图动画", "像素动画", or "复古动画".

Bailipa/EZTor_FULLBLOOD

Short-form video generation skill — 3-10 second clips for product reveals, motion teasers, ambient loops. Defaults to Seedance 2 but works the same with Kling 3 / 4, Veo 3 or Sora 2. Output is one MP4 saved to the project folder. When the workspace also ships an interactive-video / hyperframes skill, prefer composing several short shots into a single timeline rather than one long monolithic clip.

Bailipa/EZTor_FULLBLOOD

Use when playing animations, crossfading between animation states, or loading skeletal animations from GLTF in Three.js. Prevents the common mistake of not calling mixer.update(delta) every frame, wrong crossfade setup, or missing Clock. Covers AnimationMixer, AnimationClip, AnimationAction, KeyframeTrack, crossfade, blending. Keywords: animation, AnimationMixer, AnimationClip, AnimationAction, crossfade, skeletal, GLTF animation, keyframe, blend, Clock, camera animation, smooth camera, fly to, tween, GSAP.

相关技能