用途:帮助在复刻带有动效的参考网站时,系统性地研究、记录并复现其动效设计,而不是凭截图印象直接写动画代码。核心原则是:每一处上线的动画都应能追溯到实际研究过的视频帧。
主要能力:
- 动效数据采集:analyze_stack 识别网站框架与 CSS 框架;analyze_scroll_map 给出逐元素的滚动触发、时长、缓动及关键帧矩阵;analyze_hover_census 采集悬停规则与计算样式差异;get_motion_dna 汇总动效词汇(库、缓动 token、时长分位数);analyze_bundle 在需要时对脚本包做取证分析。
- 录制:record_site_motion(MCP 工具,附带内联胶片条与 .webm 路径,已知上限约 30 秒)或仓库内的 scripts/record-scrollthrough.mjs(Playwright 可控录制,7 秒预加载停留、约 450px/600ms 阶梯滚动、注入虚拟光标),必要时直接用 Playwright。
- 3D 与画布:capture_pose_3d 采集 WebGL/canvas 首屏姿态网格;capture_scene_3d 配合 three 或 spector 适配器有限度地读取证据。
- 审核与构建:verify_build 对构建产物做动效指纹比对、真实浏览器性能探测和反模式扫描;build_project --motion 生成动效清单与挂载钩子;build_gsap_stub 生成可运行的 GSAP+ScrollTrigger 起始代码。
使用方式:先跑数据工具做动效普查,再录制需人工观察的动效(入口、滚动、悬停、页面过渡),按元素分片以 1–2 fps 抽帧阅读,整理成含触发、变换属性、时长、缓动、错峰与重叠的动效清单,然后依据清单编写动画(推荐 GSAP ScrollTrigger、Lenis),最后用同样方式重录自己的构建结果逐格比对并修正。
适用场景:复刻 Awwwards 类高动效网站、把参考站研究结果整理成可交接的构建提示词、对已有构建做动效与性能验证。
限制:录制内容仅作本地研究,不应再发布;MCP 录制有约 30 秒上限,超时需退回脚本;懒加载页面须先预滚动再录制;3D 场景仅有有限还原能力,模块局部场景、父级变换与未绑定贴图无法恢复;脚本与记忆工具仅在仓库检出环境中可用。版本配置方面,v2 配置使用另一套工具映射(capture_page、inspect_page、analyze_motion、audit_page、build_motion),build_project 与 verify_build 保持不变。