Velix-MPV-Core/DOCS/PERFORMANCE_METRICS.md

Phase 6 性能指标

所有时间均为单调时钟相对当前 load session 的毫秒数。-1 表示该事件没有发生或无法可靠观察；runner 会把负值转换为 null，不参与百分位统计。

类别	字段/来源	语义	模拟器可用性
启动	timeline.startupTotalMs / firstSwapMs	load 到首个成功 EGL swap	可用
启动分段	create、initialize、load、START_FILE、FILE_LOADED、decoder reconfig、render context	各阶段首次事件	可用，缺失阶段为 -1
网络	firstByteMs、networkWaitMs、HTTP status、206/range	只记录观察到的请求/日志证据	HTTP fixture 可用，HTTPS/HLS pending
seek	seekCommandLatencyMs、seekRecoveryMs、seekFirstSwapMs	seek request/command 到恢复首帧/首 swap	相对 +10s 可用
buffering	enter/exit 次数、累计时长、单次最大时长	cache-buffering 状态边沿	字段可用；本地短片通常为 0
音频	renderer start、首 callback、submitted/played、delay、starvation、flush/reset	首 callback 时间由诊断轮询观察，不冒充 callback 内精确时间	模拟器字段可用，设备路由 pending
视频	dropped、late、mistimed、decoder frames、render count	MPV stats 或 renderer 计数	计数接口可用，部分 MPV 值可能为 -1
内存	/proc/<pid>/status VmRSS/VmSize	进程 RSS/虚拟地址空间	可用；PSS/精确 heap 为 null
CPU	/proc/<pid>/stat utime+stime	原始 jiffies	原始值可用；未取得可靠 tick/采样归一化，不输出 permille
线程/资源	Threads、/proc/<pid>/fd	进程线程和 fd 快照	可用；fd=0 视为不可用
NAPI	getState 次数、序列化微秒、估算 payload	NAPI 状态导出成本	可用；payload 是上界估算，不是分配追踪
渲染诊断	render update/frame update、core sync/skipped	优化前后计数及合并效果	可用

NAPI 返回使用 Number 以保持 Inspector 可序列化；大整数仅用于内部原子计数。任何未被设备或 API 真实提供的数据都保持 unavailable，不由模型推断。