用途
该技能是 React Native 性能优化的入口技能,适用于所有与性能相关的工作。其核心原则是:不要进行“散弹式”优化,必须先测量,定义“足够好”的标准(目标指标 + 阈值),修复最大的瓶颈,然后诚实地重新测量。
主要能力
- 快速扫描:使用 react-profiler-renders 获得实时渲染计数表,即时识别热点组件。
- 深度测量:加载 argent-react-native-profiler 技能,执行 react-profiler-start → 交互 → react-profiler-stop → react-profiler-analyze 流程。
- 检查工具:react-profiler-component-source 用于逐个发现项检查源码;react-profiler-fiber-tree 用于追溯组件祖先和渲染开销。
- 正确性验证:在修复前,从上述步骤重新收集信息并做出逻辑判断,评估该方案是否值得实施。
- 修复与验证:应用单个修复,提交前用 debugger-evaluate 验证。
- 重新测量:报告目标指标是改善、退化还是持平,检查其他区域是否出现回归。若无净收益或存在不可接受的权衡,则回滚。
- 为发现而剖析:不只用于验证,还要用剖析器发现静态分析遗漏的问题。
使用方式
流程总览
将以下检查清单复制到 TODO 列表:
Optimization Progress:
- [ ] Phase 1: Lint sweep (deterministic: catch mechanical issues without a running app)
- [ ] Phase 2: Semantic sweep (judgment: memoization, lists, animations, etc.)
- [ ] Phase 3: Baseline profile (find real bottlenecks, fix top offenders)
- [ ] Phase 4: Verify no regressions (crashes, errors, red screens)
第一阶段:Lint 扫描
在项目根目录运行一次 ESLint,使用全面的 RN 性能规则集。分派子代理修复结果:每个文件一个子代理。规则集和流程参见 references/lint-rules.md。
第二阶段:语义扫描
审查每个需要判断的区域:记忆化、列表渲染、动画、异步模式、副作用清理、状态卫生、Context 架构。每个检查项分派一个子代理。完整清单参见 references/semantic-checklist.md。
第三阶段:可视化剖析
- 加载 argent-react-native-profiler 技能,启动双重剖析。
- 演练关键用户流程(导航到用户指定的屏幕,或所有主要流程)。
- 使用 react-profiler-analyze + native-profiler-analyze + profiler-combined-report 进行分析。
- 将剖析结果与第一、二阶段的发现交叉对照。
- 修复影响最大的问题。架构性变更后重新剖析;机械性修复可批量处理。如果已录制的流程在修复后中断(例如 UI 布局变更),按照 argent-create-flow 技能修复流程,而非静默丢弃。
第四阶段:验证无回归
- 导航范围内每个屏幕和 UI 流程,确认均无错误渲染。若未指定范围,则验证整个应用:通过 argent-device-interact 覆盖所有可达屏幕。
- 使用 debugger-log-registry 检查运行时错误(若返回 status: "not_connected" 则说明没有日志文件,按其指引先重新连接)。
- 截图检查是否有红色/黄色错误屏幕。
- 检查修复引入的回归(例如重新渲染减少但 CPU 升高,或另一屏幕出现新的卡顿)。仅限主代理执行。
适用场景与限制
- 单次修复原则:架构性变更每个周期只做一个修复;机械性批量修复(内联样式、index keys)可以合并,批量后重新剖析一次。
- 设备交互录制:当测量涉及设备交互时,在首次运行前用 argent-create-flow 技能将其录制为流程,以便后续所有周期重放相同步骤。
- React Compiler:若 react-profiler-analyze 报告 reactCompilerEnabled: true,不要提出 useCallback/useMemo/React.memo,除非已通过 react-profiler-fiber-tree(缺少 useMemoCache)确认编译器退出优化。
- 子代理限制:第一、二阶段可派发子代理——每个文件一个处理 lint 结果,每个清单项一个处理语义审查。子代理不能接触设备——所有剖析和端到端验证必须在主代理中进行。
- 应用级优化流程:第一阶段集中运行 lint(一条命令),分派子代理并行按文件修复;第二阶段每个清单项一个子代理做语义扫描;第三阶段主代理剖析问题最多的屏幕,自顶向下修复架构问题;第四阶段主代理导航所有屏幕验证无崩溃。整个运行结束后再次运行 lint,验证改动未引入新问题。
缺失信息
资料未提供该技能的收费方式、价格、支持平台、具体性能提升数值或与其他工具的效果对比。