SuperAPI AI 工具集

frames

测试与质量

查看项目

更新于 11-06 16:14

技能介绍

Frames 是一项测量交互动画是否流畅的技能。它在节流 CPU 下录制一次交互的性能追踪,把每个慢帧归因到具体原因,然后用第二次录制证明修复有效。

用途

用于验证用户交互(如打开抽屉、输入字符、滚动面板)在动画过程中是否保持流畅,并定位导致掉帧或输入延迟的代码。

主要能力

  • 精确预算判断:每帧落在单个刷新间隔内(60Hz 下为 16.7ms),运动期间没有动画帧超过 50ms,交互响应在 200ms 内绘制。没有数字的“感觉流畅”会被视为一项发现。
  • CPU 节流:通过浏览器模拟调用将 CPU 节流 4 倍,代表中端手机。未节流的笔记本上的追踪会被标记为 frames-throttle-the-cpu。
  • 录制方式:通过浏览器的 evaluate 调用运行 observe.js,调用 window.__frames.start(),执行交互三次,再调用 window.__frames.stop()。长帧没有命名脚本时,额外录制完整性能剖析。
  • 预算读取:将录制结果与预算对比,掉帧或运动中的长动画帧标记为 frames-hold-the-budget;交互时长超过 200ms 标记为 frames-answer-in-200ms,并指明时间花在输入延迟、处理还是呈现。
  • 原因定位:读取每个长帧的脚本及其强制布局时间,再定位到代码。常见原因包括:在大子树上动画布局属性(frames-compositor-properties)、循环中读写样式造成强制同步布局(frames-no-forced-layout)、每帧状态更新导致组件树重渲染(frames-animate-outside-render)、每帧重绘大面积表面(frames-small-paint)。
  • 修复验证:用相同步骤和相同节流再次录制,并排报告两次录制。没有第二次录制的修复会被标记为 frames-before-and-after。完成后清除 CPU 节流。

使用方式

  1. 命名交互:写下路由、步骤和关键瞬间,例如“打开命令面板并输入三个字母”。通过浏览器模拟调用将 CPU 节流 4 倍。
  2. 录制:通过 evaluate 运行 observe.js,调用 start,执行交互三次,调用 stop。
  3. 读取预算:对比录制与预算,标记掉帧、长动画帧和超时交互。
  4. 查找原因:读取长帧脚本与强制布局时间,定位代码。
  5. 追踪修复:相同步骤和节流下再次录制,并排报告。

适用场景

  • 验证抽屉、面板、命令面板等交互动画是否流畅。
  • 定位掉帧或输入延迟的具体代码原因。
  • 证明性能修复有效。

限制

  • 浏览器不支持长动画帧时,脚本归因标记为“未验证”。
  • 运动值本身应是什么属于 motion 技能;逐帧拆解运动属于 deconstruct 技能;打开运行结果属于 verify 技能。
  • 严重程度分级:HIGH 为节流下交互超过 200ms,或报告流畅但无录制;MEDIUM 为运动期间掉帧、大子树布局属性动画、强制布局、每帧状态更新,或无节流的追踪;LOW 为保持预算的大面积重绘,或无第二次录制的修复。存在任何 HIGH 时阻止,否则批准。
  • 输出格式:每个根因一项发现,带测量数字,格式为 file:line - [rule-id] 问题描述(掉帧数、最差间隔、时长),随后是 Rule | Count | Severity 汇总。