用途:针对已知属于动画/动效类的前端性能问题,先测量真实页面再修改。目标不是删除动效,而是让离屏工作停止、可见动效正常恢复、路由与卸载时释放长期资源。适用于 React/Vite/Next 等前端页面。
主要能力:审计 CSS 动画(按 animationName、animationPlayState、visibility 统计,含 ::before/::after)、canvas/WebGL 元素、RAF 循环、监听器、观察器、定时器、GSAP 补间、媒体元素;用 IntersectionObserver 或 is-offscreen 类门控动效;对 canvas/WebGL 直接控制 RAF 循环;做内存泄漏加固(清理定时器、取消 RAF、断开观察器、移除监听器、释放 Three/WebGL/GSAP 资源、停止媒体流、用 isDisposed 守卫异步加载);验证离屏运行计数、DOM/canvas 计数与路由循环稳定性。
使用方式:优先使用 Codex Browser(除非用户明确要求 Chrome)。流程为:检查仓库上下文(读 AGENTS.md、git status --short、定位动画相关代码与清理逻辑);在浏览器采集基线(顶部、中部、页脚、移动视口,记录离屏运行的动画名与 DOM 归属,内存类需求另记元素/canvas/图片/iframe 计数与空闲、路由循环样本);对最小控制动效的归属打补丁;验证行为而非仅构建;运行本地检查,如 git diff --check、npm run lint、npm run build;按需窄范围提交。
限制:不用于通用性能产物分诊(如解读 trace、查询计划、压测结果或 CWV/Lighthouse 报告并决定先调哪个瓶颈),那应交给 performance-optimization;仅在目标已确定为动画/动效前端工作时使用。堆内存 API 不可用或浏览器沙箱阻止 monkey-patch 时需说明,并依赖可观察计数与源码审计。避免为通过而删除全部动画、用祖先选择器误停可见动效、仅凭截图证明性能、在脏工作区提交无关改动。