mcpField
F
flutter-performance

flutter-performance

github.com/thienqo开发946 次安装1 天前更新
代码仓库

关于 flutter-performance

flutter-performance 是面向 Flutter 开发者的性能排查 Skill,指导复现测量、按症状诊断,并通过前后对比验证改动。

主要功能

  1. 01可复现的 Profile 模式测量
  2. 02按性能症状诊断
  3. 03帧、CPU 与内存分析
  4. 04启动与应用体积排查
  5. 05改动前后验证

适用场景

  1. 01排查帧卡顿或过度重建
  2. 02追踪启动缓慢或内存增长
  3. 03比较 Release 应用体积
  4. 04验证性能改动

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/thienqo/flutter-skills --skill flutter-performance

安装后在 Claude Code 中输入/flutter-performance确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

evals/
cases.json
references/
memory-startup-and-size.md
profile-and-frame-analysis.md

详细介绍

Flutter 性能优化

更改代码之前,先测量可复现的流程。调试模式下的耗时不能作为发布性能的证据。

收集证据

记录目标设备、Flutter 版本、构建模式、流程、数据集和指标。如果问题会影响用户体验,请在具有代表性的硬件上以 profile 模式复现。

根据症状诊断

  • 帧卡顿:检查 UI/光栅耗时,以及开销较大的构建、布局、绘制、着色器或图像处理。
  • 重建过多:在机械地添加 const 之前,先检查状态订阅范围和组件标识。
  • 启动缓慢:追踪初始化过程,并延后不影响首个有效帧的工作。
  • 内存增长:比较重复执行流程后的快照,找出未释放的所有权、监听器、控制器或缓存。
  • 二进制文件过大:使用 Flutter 的应用体积分析功能,并对可比的发布产物进行比较。
  • Dart 占用 CPU 过高:使用时间线/CPU 性能分析,并在定位到具体工作后再考虑使用 isolate。

优先移除或转移工作,而不是把所有内容都缓存起来。限制缓存容量并确保正确性。

如果要排查帧、CPU、图像、重建或 Web 渲染问题,请加载性能分析与帧分析。如果要处理资源保留、首个有效帧或产物体积问题,请加载内存、启动和体积。

验证

更改后重复相同场景,并报告更改前后的证据及其波动情况。运行正确性测试,因为性能更改往往会影响生命周期或缓存行为。

来源

评论

支持 Markdown