Velix-MPV-Core/DOCS/SEEK_PIPELINE.md

Seek Pipeline

seek request
  -> mpv seek command
  -> SEEK event / demux recovery
  -> VIDEO_RECONFIG
  -> PLAYBACK_RESTART
  -> first video frame
  -> first render / EGL swap

seekCommandLatencyMs 是 API request 到 command 提交的耗时；seekRecoveryMs 是 request 到 PLAYBACK_RESTART 的耗时；seekFirstVisibleFrameMs 是 request 到首个成功 swap 的耗时。若 MPV 没有产生对应事件，字段为 -1。每次新 seek 会重置上一次 seek 字段，不把旧会话值带入新会话。

模拟器 runner 使用 +10s 相对 seek，50 次中 49 次产生 recovery，1 次返回稳定 SEEK / error running command；该失败保留在 JSON，不被隐藏。精确/百分比 seek 入口仍由公共 API 暴露，但短样片不足以让输入框自动化可靠覆盖，需更长受控 fixture。