用途:在既有 Web 项目中加入 Three.js / React Three Fiber 场景、GSAP 滚动编排与物理动效,而不重写项目、不破坏构建、不超性能预算,也不向弱设备或禁用 WebGL 的用户交付空白画布。原生 iOS/Android(SwiftUI / Compose)不在范围内。
主要能力:先审计仓库(框架、渲染模型、样式、已有动效/3D 库、构建工具、性能基线),判断 3D 是否真正服务于理解或品牌,再按决策矩阵选择最小库组合。覆盖英雄场景、产品查看器/配置器、滚动叙事、环境背景、3D 数据可视化、微交互等场景。
使用方式:按扫描、适配检查、诊断、选栈、实现、验证的顺序推进。React 项目用 R3F + drei + Motion;滚动驱动 3D 用 Three.js/R3F + GSAP ScrollTrigger;物理拖拽用 @react-spring/three;非 React 用原生 three.js + GSAP。同一属性只由一个动画系统驱动。
限制与要求:必须内置性能预算(限制 DPR、按需渲染、离屏暂停、Draco/KTX2 压缩、代码分割)、prefers-reduced-motion 与无 WebGL 降级、SSR 安全(如 dynamic(..., { ssr: false }))以及卸载清理。需在中端设备验证 FPS、绘制调用与 LCP 未回退。具体价格、平台支持等资料暂未提供。