深度 Raw 源的质量与发布语义 v2

定义与来源

Raw 源	对应 metricID	scope	unit / 来源字段	发布质量
Process Network	ios.process.network.send_rate / receive_rate	process	debug-gauge NetworkStatistics，bytes-per-second	同 PID+generation，字段与窗口成立才派生
Energy	ios.process.energy.*_cost 六项	process	debug-gauge Energy，source-native-cost	保留源单位，不冒充瓦特/焦耳
CoreProfile	ios.frame.time 及 ios.frame.*	foreground-device	kernel kdebug raw + mach timebase	decoder 和 exact debugid 同时通过才提升

RAW v2 metadata 规则

固定 header 与 thread map 之后允许存在非零 metadata。decoder 只在绝对 64-byte 边界上做 8 MiB 有界搜索；连续 kd_buf 门禁通过后，起点前字节记为 metadata，之后的残余字节或无有效起点都标记 unknown/unsupported-schema。任何缺失、未知或 schema 失败均保持 missing，不写成 0。

窗口、差分与重置

Process Network 在同一 PID、generation 与相邻时间窗内差分；首点 warmup，负差为 counter-reset。Energy 为每次源回包的原值，不做跨窗口累计推断。CoreProfile 合并同 Session trace 后按 timestamp 排序检查，相邻 accepted 事件产生 FrameTime，首帧 warmup。

当前校准状态与版本

• iOS 16/17/18 raw transport 与 CoreProfile 来源均有匿名 E4；decoder 为 core-profile-v2-presented-frame.candidate.v2。
• 进程网络和 Energy 公式为 candidate；GPU schema、物理能耗、目标进程专属逐帧与竞品同窗校准仍开放。
• 对外发布仍受 GPL、Developer ID、公证、universal2 与 notices 门禁约束。

版本历史

• v2（2026-09-05）：新增 RAW v2 metadata 有界识别、iOS 17/18 E4 与 native remoted 生命周期。来源：CORE-18。
• v1（2026-09-04）：冻结三类深度 raw 的初始 scope、unit 与发布门禁，已被本页取代。