插件安装: 在执行设置或刷新命令之前,当此技能位于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 Animations 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 |
命名文本动画效果(通过外部 animate-text 技能的24个ID) | 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,无 repeat: -1 除非有有限的根 data-duration,后续场景片段无页面加载时 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