用途:这是 design-builder 的动效知识层,为设计流程补充库级动画知识(缓动曲线、注册模式、性能、无障碍),并在 /improve 或 /review 时提供动效反模式检查。它本身不产出代码,由 /build 依据其建议发出生产可用代码。
主要能力与用法:先做模式路由。生产网页应用、动效只是 UI 附带时用 web-ui 模式,先读 references/selection.md 选库,再读对应 references/web-animations/*.md;用户要短视频、片头片尾、社交广告、渲染成 MP4/WebM 时切到 video 模式(HyperFrames 管线)。若已有 Lottie/After Effects 导出走 lottie 参考;3D/WebGL 按是否交互选 web-ui 或 video。需求模糊时默认 web-ui,只有明确说渲染、视频、MP4 或给秒数与投放平台时才切换。选择矩阵摘要:CSS 动画用于装饰、微光、单元素入场;WAAPI 用于原生关键帧与 JS 计时;GSAP 是非平凡 UI 动效的默认选择,视频模式必需;Anime.js 适合已有该项目时的 SVG/DOM 点缀;Lottie 用于设计师制作的插画式微动效;Three.js 用于 3D 与粒子,需权衡包体。
web-ui 契约:遵循 prefers-reduced-motion(GSAP 用 gsap.matchMedia(),CSS 用 @media,WAAPI 在 JS 检查后调用 element.animate());只动 transform 与 opacity;时长与重复次数有限;不用阻塞渲染的 JS,非首屏动效懒加载;同一关注点只用一个库。video 契约:确定性(禁用 Math.random、Date.now、performance.now,随机用 mulberry32);同步注册时间线到 window.__timelines;一切有限;HyperFrames 通过 window.__timelines、window.__hfAnime、window.__hfLottie 及 hf-seek 事件适配各库;视频收尾跑 npx hyperframes lint && npx hyperframes inspect && npx hyperframes render。
适用的接入点:/design_page、/design_screen 的 animation 块可引用其选型建议;/build 依据它生成代码;/improve 参考 references/anti-patterns.md。反模式包括线性缓动、缺少 reduced-motion 回退、动布局属性、无出口的无限循环、忽略 reduced-motion 的滚动视差、同组件混用多库、首屏全体入场动画、妨碍阅读的装饰动效。限制:动效非请求范围时不应主动建议;未提供具体收费、平台、效果数据。