插件安装: 在执行设置或刷新命令之前,请遵循 插件执行规则(当此技能位于 HyperFrames 插件内部时)。独立安装请保留下方的更新说明。
HyperFrames 动画
所有动效知识汇聚于一个技能:规则(原子配方)、蓝图(多阶段场景模板)、转场(场景间切换)、技巧(更广泛的动效设计模式)以及适配器(各运行时 API)。
关于组合约定的详细信息(数据属性、子组合、确定性),请参阅 hyperframes-core。
默认方式:组合原子规则
从 rules-index.md 中选择 2–4 条规则,通过单条暂停的 GSAP 时间线进行组合。这种方式比从蓝图开始速度更快,生成的代码更少。
何时加载蓝图
- 当前场景匹配已有的预设计多阶段模板(品牌展示、社交证明等),且复用其相位流水线可显著节省创作时间
- 你需要为复杂的 4–5 阶段编排提供可运行的基准代码
蓝图位于 blueprints-index.md 中。每条条目指向 blueprints/<id>.md(配方)。请勿出于推测目的读取它;只有在确定需要场景级编排时才加载。
路由
| 你想…… | 阅读 |
|---|---|
| 按触发条件/标签选择原子运动模式 | rules-index.md |
| 阅读一条规则的完整 HTML / CSS / GSAP 配方 | rules/<name>.md |
| 选择多阶段场景模板 | blueprints-index.md |
| 阅读一条蓝图的完整配方 | blueprints/<id>.md |
| 创作场景转场(CSS 驱动,两个片段之间) | transitions/overview.md, transitions/catalog.md |
| 查找更广泛的动效设计技巧 | techniques.md |
| 运动模糊 — 元素上的快门拖影效果,以及何时不应使用 | references/motion-blur.md |
| 分析现有组合的动画映射 | scripts/animation-map.mjs |
| GSAP API — 时间线 / 补间 / 位置参数 | adapters/gsap.md |
| GSAP — 即用型效果配方 | rules/gsap-effects.md |
| GSAP — 变换 / 性能 | adapters/gsap-transforms-and-perf.md |
| GSAP — 缓动 / 交错 | adapters/gsap-easing-and-stagger.md |
| GSAP — 时间线 / 标签 | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie(After Effects 导出,window.__hfLottie) | adapters/lottie.md |
| 角色动画(行走循环、吉祥物、关节木偶、手势) | adapters/lottie.md → 角色 |
Three.js / WebGL(3D 场景,AnimationMixer,hf-seek) | adapters/three.md |
Anime.js(window.__hfAnime) | adapters/animejs.md |
CSS 关键帧(animation-delay / play-state / fill-mode) | adapters/css-animations.md |
Web 动画 API(element.animate(),currentTime 查找) | adapters/waapi.md |
TypeGPU / WebGPU(navigator.gpu,WGSL,计算管线) | adapters/typegpu.md |
HTML 作为纹理 + WebGL/GLSL 后期特效(通过 drawElementImage 捕获实时 DOM) | adapters/html-in-canvas-patterns.md |
命名的文本动画效果(24 个 ID,通过外部 animate-text 技能) | adapters/animate-text.md |
选择运行时
- GSAP 是 95% 动效工作的默认选项 —— 涵盖时间线编排、变换、缓动、交错。本技能中的所有原子规则均基于 GSAP。
- Lottie 当资源自带预置时间线时(通常是 After Effects 导出),包括行走、手势或反应的角色。
- Three.js 用于 3D 场景、摄像机运动、着色器驱动的视觉效果。
- Anime.js 用于轻量级补间,当 GSAP 过于复杂时使用。
- CSS 用于简单的重复图案、装饰、闪烁 —— 无需 JavaScript 动画成本。
- WAAPI 用于原生浏览器关键帧,无需 GSAP 依赖。
- TypeGPU / WebGPU 用于 GPU 渲染的画布(粒子、液态玻璃、自定义着色器)。
多个运行时可以在同一组合中共存。每个运行时将其实例注册到特定于运行时的全局对象上,以便 HyperFrames 在单次遍历中查找所有实例。
关键约束
前提条件:hyperframes-core → 单条暂停的时间线 + 不可协商的规则(单条暂停的时间线,data-duration 控制时长,不使用 Math.random / Date.now / performance.now,没有不带有限根 data-duration 的 repeat: -1,没有页面加载时对后续场景片段使用 gsap.set,没有 display 或原始 visibility 补间,且仅在时间线完全构建后才注册,包括当构建在异步回调内运行时,例如 document.fonts.ready)。GSAP 的 autoAlpha 和零持续时间可见性设置在明确的时间线边界处仍被核心允许。仅在非片段元素或片段内部的包装器上使用这些例外;框架拥有 .clip 生命周期。请勿在此重复完整约定。
在核心约定基础上的动画创作补充:
- 预计算的布局常量 — 切勿在补间时从
getBoundingClientRect()推导位置。补间时的 DOM 测量会因渲染器并行采样而不同步;在组合设置时一次性计算坐标并复用。 - 空间运动仅使用 GSAP 变换别名(
x、y、scale、rotation)。核心允许列表也允许opacity/color/backgroundColor/borderRadius用于非空间属性补间 — 但绝不使用width/height/top/left进行布局更改。
脚本
node <SKILL_DIR>/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
读取注册在 window.__timelines 上的每个 GSAP 时间线,枚举补间,采样边界框,计算标志,输出 animation-map.json。在创作后用于审计编排(死区、交错一致性、生命周期警告)。
animation-map.mjs 首先解析当前项目中的辅助包,然后可以引导捆绑的 HyperFrames 包版本。仅在技能在捆绑的 CLI/技能安装之外运行且需要明确固定该引导版本时,设置 HYPERFRAMES_SKILL_PKG_VERSION=<版本>。
另请参阅
hyperframes-core— 组合结构、数据属性、子组合、确定性渲染约定hyperframes-creative— 调色板、字体排印、叙事、节拍规划(非动画创意方向)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render