外观
截图时间轴与界面上下文对照指南：性能波形与视觉界面的精准对齐
在性能测试中，单纯的“曲线图”往往是抽象的。例如：当监控图表上出现了一个 400ms 的严重卡顿（BigJank），研发往往会问：“这个卡顿发生在哪个具体页面？用户当时正在执行什么操作？”
Perfowl 创新性地引入了 截图时间轴 (Screenshot Timeline) 功能，将高频设备截图与性能采样点基于统一的硬件单调时钟严格对齐，帮助测试人员和研发一眼看清“卡顿发生那一刻的真实手机界面”。
1. 工作机制与时间轴对齐
1.1 独立长连接与固定节拍
- 独立连接：截图使用独立子进程与独立 DVT 长连接（
com.apple.instruments.server.services.screenshot），Session 开始时建立一次、结束时关闭，不是每次截图单独建连——这是为了避免早期"每秒重新建连"方案在长测中产生的大量进程启动/DVT 重连开销（详见 Session 架构演进与实验）。 - 采集频率：固定 1.0 秒一张 的节拍，无论是否勾选「ScreenShot」持久化选项，只要 Session 处于采集中就以该节拍刷新；不启动录屏进程，不影响前台应用的渲染与操作流畅度。
- 预览与持久化分离：每一次有效截图都会更新工作台顶部的内存实时预览；只有勾选「ScreenShot」时才额外把该帧写入 Session 的
screenshots/目录——未勾选时磁盘 0 写入，但预览仍然刷新。 - 时钟坐标：每一张截图携带的
elapsedSeconds由 Session 时间轴 统一投影得到，与同窗的 CPU、内存、FPS 指标曲线共享同一条播放坐标（而不是各自独立的纳秒硬件时钟）。
1.2 实时工作台与时间轴卡片
- 测试运行中：工作台截图区域呈现为自左向右横向推进的时间轴卡片流，每秒更新一张，清晰展示业务操作进程。
- 测试结束后：所有截图永久保存在本地 Session 资产中，支持随时拖动时间轴游标进行回放与逐帧复查。
2. 核心测试价值与应用场景
| 应用场景 | 传统测试痛点 | Perfowl 截图时间轴解决方案 |
|---|---|---|
| 卡顿场景定位 | 看到 FrameTime 飙高，无法确定是滑入哪个 Feed 或展开哪个弹窗导致的 | 拖动时间轴游标至卡顿尖峰点，直接查看对应时刻的屏幕卡片，瞬间确认问题视图 |
| 内存泄漏操作复盘 | 记录了 10 轮内存阶梯上升，但无法向研发证明“每轮操作是否完全一致” | 翻阅截图时间轴，完整呈现每轮进入、滑动、退出的标准化界面，证据确凿 |
| 启动首屏核验 | 难以判断启动结束那刻界面到底呈现了骨架屏、广告页还是真实业务首屏 | 对照 Initial Frame Rendering 结束时间戳与截图，精准核对首帧画面完整度 |
3. 质量语义与异常处理
为了确保测试资产的严谨性，Perfowl 严格遵循数据事实原则：
- 成功采集：截图当前默认持久化编码为 HEIC（约 1800px 宽 / Q75，有损压缩），本机无 HEIC 编码器时降级为 JPEG，不会降级为 PNG；历史归档 Session 可能仍是早期版本落盘的 PNG 格式，Review 侧按格式无关的方式解码，不强行假设文件后缀。这与"无损"不同，是在清晰度和长会话存储体积之间做的有意权衡。
- 设备偶发超时或黑屏：若在快速息屏或横竖屏切换时未能获取截图，时间轴保留该时间点的事件占位，并显式标注
failed/cancelled，绝不用上一张旧图冒充当前时刻，确保画面与指标严格守序。 - 数据流轻量化：在导出 JSONL / CSV 性能数据时，截图仅记录相对文件路径、采集质量与错误原因，不记录逐张截图的哈希校验码，也不将庞大的二进制图像塞入文本文件，保证数据流通畅。