ethanreedlabs/sulde/perf-diagnose

慢 / 卡 / 延迟 / 优化 / 提速 / 卡顿 / 抖动 / 掉帧 / jank / lag
进场慢 / 加载慢 / 响应慢 / 启动慢
内存增长 / OOM / 内存泄漏
为什么这么慢 / 性能差 / 体验差

think hard。
 
角色:资深移动端性能工程师(stack 见 references)
 
执行流程(5 阶段):
 
阶段 1【重现 repro】
  - 确认问题边界(滚动 / 启动 / 内存 / 网络 / 动画)
  - 真机型号 + 系统版本
  - 冷启动 vs 热路径
  - 大致严重程度(用户感知描述)
 
阶段 2【测量 measure】
  - 按问题类型选 profiler(详 references/{stack}.md §2)
  - 跑自动化抓取(优先),GUI 工具作补充
  - 数据归档到 .ai-workspace/diag/
 
阶段 3【假说 hypothesise】
  - 基于实测数据列出至少 3 个候选根因,按数据支撑度排序
  - 区分:主线程阻塞 / 渲染瓶颈 / 内存增长 / 网络延迟 / 锁等待
  - **严禁星级置信度替代实测**
 
阶段 4【建议 fix 方向(不写 fix 代码)】
  - 每个候选给"预期改善 ~Xms / ~X%"
  - 标注实施成本与风险
  - 自我批判:数据是否足以支撑?有无遗漏候选?
 
阶段 5【再测量 re-measure 路径(列给协调端)】
  - 给出 fix 后必须复测的指标 + 工具
  - 给出对比基线(本次测得的 P50/P99 等数值)

# 性能诊断报告:{问题简述}
 
## 问题类型
-[ ] 滚动卡顿  [ ] 启动慢  [ ] 内存  [ ] 网络  [ ] 动画  [ ] 其他
 
## 环境
-设备:{型号} / 系统:{版本} / App 版本:{构建号}
-触发条件:{冷启动 / 列表第 N 屏 / 特定操作链}
 
## 诊断数据(实测,非推断)
 
| 指标 | 数值 | 工具 | 截图 / 文件 |
|---|---|---|---|
| Jank frames 比例 | X% (N/Total) | {stack 工具} | `.ai-workspace/diag/{slug}-frames.{ext}` |
| P99 帧耗时 | Xms | {stack 工具} | 同上 |
| 主线程最大 spike | Xms({函数名}) | {stack 工具} | `.ai-workspace/diag/{slug}-flame.{ext}` |
| 启动时间 | Xms | {stack 工具} | `.ai-workspace/diag/{slug}-launch.{ext}` |
| 内存峰值 | XMB | {stack 工具} | `.ai-workspace/diag/{slug}-mem.{ext}` |
| 网络请求 1 | Xms({串行/并行}) | Charles / 抓包 | `.ai-workspace/diag/{slug}-net.{ext}` |
| 响应体大小 | XKB / N条 | 同上 | 同上 |
 
## Top-3 耗时来源(实测,非推断)
 
1.**[具体函数/操作名]** — Xms(占总耗时 X%)
   证据:`.ai-workspace/diag/{slug}-flame.{ext}` 主线程最宽块
2.**[操作名]** — Xms / 重渲 N 次/秒
   证据:同上
3.**[接口名]** — Xms
   证据:`.ai-workspace/diag/{slug}-net.{ext}`
 
## 排除项(列已测但排除的候选)
 
-[候选 A]:实测 Xms 占比不显著 → 排除
-[候选 B]:profiler 未出现在主线程 → 排除
-[候选 C]:与 jank 时间段不重合 → 排除
 
## 建议 fix 方向(数据支撑,不写代码)
 
1.[fix 1]:预期改善 ~Xms(根据 top-1 函数耗时)
2.[fix 2]:预期改善 ~X%(根据 jank 比例)
3.[fix 3]:预期改善 ~XMB(根据内存峰值)
 
## fix 后复测路径(协调端派 fix task 时引用)
 
-复测指标:{P99 帧耗时 / Jank 比例 / 启动时间 / ...}
-复测工具:{同诊断工具,保证可比}
-验证阈值:{P99 < 16ms / Jank < 1% / 启动 < 1.5s / ...}
-基线数值(本次):{填实测数值}
 
## 截图 / trace 文件清单
 
-`.ai-workspace/diag/{slug}-flame.{ext}`(CPU 火焰图)
-`.ai-workspace/diag/{slug}-frames.{ext}`(帧率)
-`.ai-workspace/diag/{slug}-launch.{ext}`(启动,如适用)
-`.ai-workspace/diag/{slug}-mem.{ext}`(内存,如适用)
-`.ai-workspace/diag/{slug}-net.{ext}`(网络,如适用)
-`.ai-workspace/diag/{slug}-overdraw.{ext}`(过度绘制,如适用)

用户:首页 Feed 滚动卡顿,iPhone 12 上特别明显
助手:/perf-diagnose 启动。先确认边界(AskUserQuestion):
 
  1. 问题类型?→ 滚动卡顿
  2. 冷启动还是每次都卡?→ 每次进首页滚 5 秒都卡 2 次
  3. 型号 + 系统?→ iPhone 12 / iOS 17.4
  4. 严重程度?→ 用户能明显感知
 
正在按 references/ios.md §2 跑诊断套件:
  - Time Profiler(滚动 15s)→ trace 文件已存到 .ai-workspace/diag/
  - SwiftUI Profiler → body 重算次数已记录
  - Core Animation → FPS 曲线已抓
  - Memory Allocations → 增长曲线已抓
 
诊断报告写完:.ai-workspace/handoff/<date>-home-feed-jank-diag.md
  - P99 帧耗时:42ms(警戒线 16ms)
  - Top-1 耗时:`FeedItemView.body` 主线程 35ms × 多次(占总耗时 60%)
  - 排除项:网络请求(不在 jank 时间段)/ 图片解码(已在后台)
  - fix 方向:1. `EquatableView` 减少重算 / 2. 列表 cell 高度预计算
 
请把 handoff 交给协调端,协调端基于数据写 fix task。