Velix-MPV-Core Memory

项目：独立 HarmonyOS MPV 播放内核，禁止混入 Velix 主应用源码。
当前阶段：Phase 4 CODE COMPLETE / GPU INTEROP BLOCKED / DEVICE VALIDATION PENDING；OHCodec 适配与软件回退已完成，模拟器启动/EGL smoke 已验证。
基线：MPV 182fa6ca49f455cadb884858f386e2f00540aeb7，分支 harmony-port。
SDK：OpenHarmony API 24 / 6.1.1.125 / aarch64-linux-ohos / Clang 15.0.4。
关键结论：首版 GLES+EGL+libmpv Render API；OHAudio AO；官方 FFmpeg OHCodec 路线。
Phase 1 产物：build/ohos-arm64/prefix/lib/libmpv.so.2.5.0，AArch64 ELF，OpenGL Render API symbols 完整。
远程：origin 为私有 Gitea 仓库，默认分支 harmony-port；upstream 为 MPV 官方仓库。
Phase 2：playback_lab/ 独立 HAP，XComponent/OHNativeWindow/EGL/libmpv/软件解码已通；实体设备待验。
Phase 3：audio/out/ao_harmony.c + OHAudio pull callback、pause/flush/clock/metrics 已通；实体机路由/A-V sync/压力待验。
Phase 4：IMGFMT_OHCODEC、hwdec=ohcodec、API24 capability adapter、direct-surface experimental driver、软件构建矩阵、Playback Lab 诊断已提交；FFmpeg 保持 upstream。
Phase 4 边界：官方 OHCodec hwcontext/decoder 仅提供 surface 输出，NativeBuffer→EGL 仅做禁用默认 API probe，未宣称零拷贝/HDR/真实硬件帧；详见 DOCS/OHCODEC_GPU_INTEROP_DESIGN.md。
索引：memory/projects.md、memory/infra.md、memory/lessons.md、memory/2026-08-28.md。