Velix-MPV-Core/DOCS/RISK_ASSESSMENT.md

Risk Assessment

Top 10

#	风险	可能性 / 影响	证据	缓解与验收
1	MPV 无 OHOS 平台检测，OHOS 被泛 POSIX/Linux 逻辑误分类	高 / 高	当前 meson.build 无 harmony/ohos；编译器同时定义 __linux__	显式 features['harmony']；每个 Linux feature 用 compile/link probe
2	交叉依赖链复杂且 pkg-config 污染宿主库	高 / 高	本机无 Meson/Ninja/pkg-config；MPV 强依赖 FFmpeg/libplacebo/libass	单一 staging prefix、清空默认 PKG_CONFIG_PATH、产物 readelf 审计
3	HTTPS/TLS 无可直接复用的 FFmpeg Harmony backend	高 / 高	SDK有 libnet_ssl.so，FFmpeg不使用它	交叉构建 OpenSSL；真机证书/SNI/Range/HLS 测试
4	Surface 生命周期与 GL 线程竞态导致黑屏/崩溃	高 / 高	XComponent异步 create/change/destroy，EGL context 有线程归属	单一 render thread 状态机；销毁屏障；旋转/后台压力测试
5	OHAudio callback 与 MPV buffer/clock 语义不匹配	中高 / 高	MPV无 Harmony AO	realtime-safe callback；timestamp/delay 校准；seek/route switch 测试
6	FFmpeg OHCodec虽已 upstream，但 MPV完全不识别 OHCODEC	高 / 高	MPV无 AV_PIX_FMT_OHCODEC / AV_HWDEVICE_TYPE_OHCODEC	软件基线后小步接入；先独立验证 FFmpeg backend
7	Direct Surface decode 绕过 MPV shader/ASS/色彩管理	高 / 高	FFmpeg OHCodec向 window直接 render	优先研究 OHNativeBuffer GPU import；direct surface仅作验证路径
8	4K/10-bit/HDR 能力因机型/驱动不同，SDK存在不等于设备支持	高 / 高	capability API要求运行时查询	保存设备矩阵、profile/level/format/extension；不做泛化承诺
9	GPL/LGPL 与静态链接/FFmpeg选项污染商业发布	中高 / 极高	MPV默认 GPLv2+；开关不自动产生 LGPL授权	默认 GPL 管理；保存完整 build manifest；发布前法务审计
10	arm64 OHOS ABI/符号/打包规则与普通 Linux不同	中 / 高	target 是 aarch64-linux-ohos，系统库命名含 .z.so	小探针→依赖→libmpv；检查 SONAME、NEEDED、符号可见性和 HAP 装载

其他风险

• 字体发现和字体包体积影响 ASS 首帧及中日韩字幕正确性。
• 网络切换、代理、IPv6、慢速 Range、HLS discontinuity 对稳定性影响大。
• MPV master 与 FFmpeg master 同时变化，需锁 commit 并记录组合。
• API 24 SDK header含更低 API接口，但实际目标机系统版本仍要匹配。
• Vulkan headers/loader存在不代表驱动质量和 HDR swapchain 可用。

决策门禁

决策	必需证据
进入 Phase 1	Phase 0 文档完成；origin/upstream/branch明确；依赖与 license 策略确认
开始 Playback Lab	libmpv arm64真实产物及 build report
启用 OHCodec	software decode 基线 + 官方 FFmpeg OHCodec 独立验证
宣称 low-copy/zero-copy	帧路径、buffer ownership、GPU import、同步与 copy 测量证据
采用 Vulkan	GLES benchmark证明瓶颈且 Vulkan原型在目标机显著改善
商业发布	实际链接清单、许可证正文、源码义务、法务审核全部完成