Perfowl 技术阅读地图

这份地图不要求从 Registry ⓘ 或证据模型开始。更自然的阅读方式是：先理解 iOS 性能观测原理，再进入你关心的性能领域，然后看单指标 Canonical ⓘ，需要时再看该领域的技术演进与实验，最后才下钻到工程合同和验证证据。

每个领域统一遵循同一条阅读链：

领域总览 → 单指标 Canonical → 技术演进与实验 → 测试方法/诊断 → 工程合同

实验入口 · 2026-10-26

先看实验经验与对照方法：静帧/动画恢复、来源/发布节拍、参考工具扰动、磁盘与网络层级、逐帧完整集合、Energy、前台与在线准入、报告统计。每节区分已测事实、未证机制和复现方法，再链接各领域唯一指标页及原始开发记录。本月复盘盘点400份来源（包括计划/失败，不是实验次数）；当前55/66，其余11项暂停。

路线一：第一次系统理解 Perfowl

iOS 性能观测模型
→ 指标计算与窗口模型
→ 数据流、时钟与连续性
→ 选择一个性能领域深入
→ 数据质量与证据
→ Registry / 平台兼容等工程参考

推荐先读 iOS 性能观测模型，再看 指标计算与窗口模型 与 数据流、时钟与连续性。

路线二：我要理解画面为什么卡

Display Performance 总览
→ FrameTime / P95 / Refresh Rate / Jitter / FPS
→ Jank / Stutter
→ 技术演进与实验
→ CPU / GPU / I/O 同窗诊断

• Display Performance 总览
• FPS · FrameTime · P95 FrameTime · Refresh Rate · Frame Pacing Jitter · Jank、Stutter 与稳帧体验
• Display Performance 技术演进与实验：为什么最终选择 ActivityTrace FrameLifetime，而不是 CoreProfile、Hitches、GPU Trace 或视频 PTS
• 卡顿诊断与渲染归因

底层显示管线基础见 iOS 流畅度与帧体验总览，未产品化的高级字段见 渲染诊断研究候选。

路线三：我要理解启动性能

启动性能总览
→ App Launch Total / Startup Observation / Startup Phases
→ 启动观测与数据完整性
→ 启动测试方法与诊断
→ 技术演进与实验

iOS 启动性能总览 → App Launch Total · Startup Observation · Startup Phases → 启动观测与数据完整性 → 启动测试方法与诊断 → Startup 技术演进与实验：为什么 Total 可能比 9/9 阶段更稳定，kdebug ⓘ/CoreProfile/prewarm 路线为什么被采用或放弃

重点是区分 Launch Total、可观测阶段、端点完整性和 controlled process-cold 的边界；旧版 startup-timing.md 已改为拆分索引（兼容入口），不再是权威 Canonical。

路线四：我要理解资源指标

CPU / Scheduling

CPU 与调度总览 → APP CPU · TotalCPU · CPU Core Usage · Thread Count · Context Switch Rate · Interrupt Wakeup Rate → CPU / Sysmontap 技术演进与验证

Memory

iOS 内存拓扑总览 → Physical Footprint · Real Memory · Virtual Memory · Available Memory · Free Memory → Memory Contract 技术演进与实验：Footprint/Resident/Xcode alias 同源发现、Free/Available 分离、16 KiB page-size candidate 边界

Network / I/O

iOS 网络与 I/O 总览 → Process Network Tx/Rx · Device Network Tx/Rx · Disk I/O Rate → Network 采集技术演进与实验：source clock 修正案例（Wi-Fi 首两点相差约 19 分钟的真机异常）

GPU

GPU 与图形硬件总览 → GPU Utilization（Renderer/Tiler/Device） · Dynamic GPU Counter → GPU 采集技术演进与实验

Energy / Battery / Thermal

能耗、电池与热状态总览 → Process Energy Cost · Battery Electrical · Battery Temperature · Thermal Status → Energy/Battery/Thermal 技术演进与实验：为什么 Battery 三项至今仍是 Unsupported、ThermalStatus 为什么找不到稳定来源

路线五：我要理解 Session / 回放

Session 数据模型总览
→ Session 完整性与回放确定性
→ Session 回放与时间轴 / 截图时间轴 / 资产管理与导出
→ 架构演进与实验

Session 数据模型总览 → Session 完整性与回放确定性 → Session 回放与时间轴 · 截图时间轴 · Session 资产管理、标注与导出 → Session 架构演进与实验

路线六：我要确认"这个数据现在到底靠不靠谱"

先看 产品能力总览，需要工程细节时再进入：

• 技术能力矩阵
• 证据与能力状态
• 数据质量与 0 值判定
• iOS 平台兼容矩阵
• 连接与系统路由

这里最重要的原则仍然是：代码实现、source 可达、真机产生数据、数值与外部工具同窗等价，是不同层次的证据。

路线七：我要跨指标排查一个具体问题

先看 跨指标诊断与证据升级（Level 0～5 证据层级模型），再回到对应领域的"常见异常形态"章节和技术演进文章。

路线八：我要查精确工程合同

最后再看：

• Registry 指标合同索引
• 深度 Raw 源的质量与发布语义
• GPU Schema 与 Lifecycle 质量语义
• 无侵入边界

一句话记住新的阅读顺序

先理解系统原理
→ 再理解一个性能领域总览
→ 再看单指标 Canonical 怎么算、什么时候可信
→ 想知道"为什么最终这样设计"时看技术演进与实验
→ 最后进入 Registry、source 和平台证据

版本历史增量：2026-10-26，新增月度实验方法入口与证据层级提示，E1文档整理。