Deepin 25 (crimson) + Intel N150 核显硬解失效问题排查报告
======================================================================
生成时间：2025-05-13
排查范围：玲珑包（影院/浏览器/Edge）、deb包（Bilibili Electron版）

〇、现象描述（用户反馈）
----------------------------------------------------------------------
- 系统自带的玲珑包「影院」和「浏览器」，播放视频均为 CPU 软解，未调用核显硬解
- 玲珑包「Edge 浏览器」同样无法使用核显硬解
- deb 包「VLC」是目前唯一测试出能正常使用核显硬解播放视频的软件
- deb 包「Bilibili 桌面版」（基于 Electron 封装）也无法使用核显硬解
- 硬件环境：Intel N150（Alder Lake-N）核显，Deepin 25 (crimson) 全新安装
- 用户已按官方指引更新 Mesa 至最新版，问题依旧

一、系统环境
----------------------------------------------------------------------
操作系统：Deepin 25 (crimson)
内核版本：Linux 6.18.27-amd64-desktop-rolling
CPU：Intel N150（Alder Lake-N）
GPU：Intel Graphics ADL-N（device ID 46d4）
显示服务器：X11
桌面环境：DDE (KWin)
Mesa版本：25.0.7-2
libva版本：2.20.0-2
宿主机VA-API驱动：intel-media-va-driver-non-free 24.2.2+ds1-1
玲珑版本：linglong-bin 1.12.2 / linglong-box 2.1.2

二、宿主机 VA-API 状态（基准参考）
----------------------------------------------------------------------
宿主机上直接运行 vainfo 结果：
  - libva 版本：1.20.0 (libva 2.20.0)
  - 驱动版本：Intel iHD driver for Intel(R) Gen Graphics - 24.2.2
  - 支持的编码格式：MPEG2、H.264、VC-1、JPEG、VP8、HEVC(8/10/12bit)、VP9(8/10bit)、AV1
  - 设备 /dev/dri/card0 和 /dev/dri/renderD128 正常可访问

确认宿主机层面 VA-API 硬解能力正常。GuC/HuC 固件均已加载。

三、玲珑容器内 VA-API 问题
----------------------------------------------------------------------
3.1 设备权限
  - /dev/dri/renderD128 和 /dev/dri/card0 在容器内均可见
  - ACL 权限为 user:Light:rw-（可读写），无权限问题
  - 容器内用户 Light 未加入 render/video 组，但 ACL 已覆盖

3.2 驱动文件分布
  容器内 VA-API 驱动搜索路径（LIBVA_DRIVERS_PATH）：
    /usr/lib/x86_64-linux-gnu/dri:/opt/extensions/org.deepin.driver.media.intel/lib/dri

  - 路径一 /usr/lib/x86_64-linux-gnu/dri/ ：不存在 iHD_drv_video.so
  - 路径二 /opt/extensions/org.deepin.driver.media.intel/lib/dri/ ：存在 iHD_drv_video.so

3.3 扩展驱动与宿主机驱动文件对比
  宿主机 iHD 驱动：
    路径：/usr/lib/x86_64-linux-gnu/dri/iHD_drv_video.so
    大小：37,310,136 字节（约 37 MB）
    版本：Intel iHD driver - 24.2.2（来自 intel-media-va-driver-non-free 包）
    MD5：b18e4682c851de4c75b6e374520deea5

  玲珑扩展 iHD 驱动：
    路径：玲珑扩展 org.deepin.driver.media.intel (version 25.0.0.0) 内
    大小：14,621,176 字节（约 14.6 MB，仅为宿主机驱动的 39%）
    MD5：d5c4a46af8908cae57a7cc143922ac38

  -> 扩展驱动文件大小仅为宿主机驱动的约 2/5，差异显著。

3.4 驱动初始化测试
  在玲珑容器内分别测试两个驱动：

  测试 A（扩展自带驱动）：
    使用 /opt/extensions/.../lib/dri/iHD_drv_video.so
    -> 找到 __vaDriverInit_1_20 函数
    -> 但 init failed（va_openDriver() 返回 1）
    -> 回退到 i965_drv_video.so，同样 init failed
    -> vaInitialize 返回 -1，初始化完全失败

  测试 B（通过 /run/host/rootfs 使用宿主机驱动）：
    使用 /run/host/rootfs/usr/lib/x86_64-linux-gnu/dri/iHD_drv_video.so
    -> 找到 __vaDriverInit_1_20 函数
    -> va_openDriver() 返回 0（成功）
    -> vainfo 正常输出所有支持的编码格式
    -> 证明宿主机驱动在容器内完全可用

3.5 已确认存在的问题
  - 玲珑扩展 org.deepin.driver.media.intel 提供的 iHD_drv_video.so（14.6MB）
    在 N150(ADL-N) 上初始化失败，无法用于硬解
  - 容器内 /usr/lib/x86_64-linux-gnu/dri/ 下没有 iHD 驱动备份
  - 宿主机正常工作驱动（37MB 版本）虽可通过 /run/host/rootfs 访问，
    但未被纳入 LIBVA_DRIVERS_PATH 默认搜索范围

3.6 可能存在的问题
  - 扩展包来源问题：该 14.6MB 的 iHD 驱动可能是从不同的源码版本构建，
    或是裁剪版本，缺少 N150 所需的某些初始化模块
  - 扩展包版本号（25.0.0.0）与 Mesa/VA-API 生态版本体系不一致，
    存在版本对应混乱的可能
  - i965_drv_video.so 在扩展中也存在但同样初始化失败，
    此驱动本应对 ADL-N 无支持（ADL-N 属于 Gen12，i965 是 Gen7-10 驱动）

四、deb 版 Bilibili（Electron 28.2.1）硬解问题
----------------------------------------------------------------------
4.1 已验证的事实
  - Bilibili 自带 Electron v28.2.1 框架
  - 该 Electron 在 VA-API 相关代码中确实包含 VaapiVideoDecoder 等类
  - 但 Electron 使用 ANGLE 层（自带的 libEGL.so + libGLESv2.so）渲染
  - 在 X11 下 Electron 默认使用 --use-gl=angle，通过 ANGLE 连接系统 EGL
  - 测试中 Electron 的 GPU 进程日志反复出现：
    "Failed to get system egl display"
    "libEGL: Called unimplemented function: eglInitialize"
  - 系统 libEGL_mesa.so.0 文件存在（374KB），EGL vendor 配置存在

4.2 已确认存在的问题
  - Electron 卡自带 libEGL.so（ANGLE）在尝试初始化系统 EGL display 时失败，
    导致 GPU 子进程无法正常创建上下文
  - 即使 Electron 源码中编译了 VA-API 支持，但 GPU 进程未能正常启动，
    VA-API 解码通道无法建立

4.3 可能存在的问题
  - 该问题可能由 Mesa 25.x 与 Electron 28 的 ANGLE 之间的接口变更引起
    （Chromium 在较新版本中已修复此兼容性问题）
  - 也可能是 Deepin 25 的 libglvnd/EGL 加载机制与 Electron ANGLE 的交互
    方式不兼容
  - 由于 Electron v28.2.1 相对较旧（对应 Chrome 120-122 范围），该问题在
    Electron 30+（Chrome 130+）中可能已被上游修复，但 Bilibili 打包者
    尚未升级 Electron 版本

五、宿主机上其他应用的硬解情况
----------------------------------------------------------------------
确认 VA-API 在宿主机上正常工作：
  - vainfo ✅ （正常输出所有格式）
  - VLC ✅ （正常使用 VA-API 硬解）
  - ffmpeg VA-API 解码测试（见下方详细结果）

5.1 ffmpeg VA-API 硬解详细测试
  测试视频 A：本地文件 /home/Light/Videos/视频.mp4
    编码格式：H.264 (Main) / 1920×1080 / 60fps / 17.1 Mbps
    硬解指令：ffmpeg -hwaccel vaapi -hwaccel_output_format vaapi -i 视频.mp4 -vframes 200 -f null -
    结果：输出 wrapped_avframe, vaapi(tv, bt709, progressive)
          解码 200 帧用时，speed=12.5x
          确认硬解生效 ✅

  测试视频 B：B站下载视频（来自 BV1t94y1e7Y9，640×480 H.264）
    编码格式：H.264 (High) / 640×480 / 25fps
    硬解指令：ffmpeg -hwaccel vaapi -hwaccel_output_format vaapi -i bilibili_test.mp4 -vframes 200 -f null -
    结果：硬解 speed=112x
          软解对照（不加 -hwaccel vaapi）：speed=51x
          硬解比软解快 2.2 倍，确认硬解生效 ✅

5.2 mpv VA-API 硬解测试
  测试视频 A：本地文件 /home/Light/Videos/视频.mp4 (1920×1080, H.264, 60fps)
    命令：mpv --hwdec=vaapi --vo=gpu --no-audio --frames=200 --untimed 视频.mp4
    输出："Using hardware decoding (vaapi). VO: [gpu] 1920×1080 vaapi[nv12]"
    结果：硬解生效 ✅

  测试视频 B：B站下载视频 (640×480, H.264, 25fps)
    命令：mpv --hwdec=vaapi --vo=gpu --no-audio --frames=200 --untimed bilibili_test.mp4
    输出："Using hardware decoding (vaapi). VO: [gpu] 640×480 vaapi[nv12]"
    结果：硬解生效 ✅

5.3 Chromium 139 VA-API 硬解测试
  Chromium 版本：139.0.7258.66 (Deepin 25 仓库版)
  测试命令：
    chromium --no-sandbox \
      --enable-features=VaapiVideoDecoder,VaapiVideoEncoder \
      --ignore-gpu-blocklist \
      --disable-gpu-driver-bug-workarounds \
      --disable-software-rasterizer

  关键发现：
  - GPU 进程正常启动并加载了系统 iHD_drv_video.so（37MB 完整版）
  - GPU 进程同时加载了 libva.so.2.2000.0 和 dri_gbm.so，VA-API 栈完整
  - Chromium 使用 ANGLE 渲染路径，GPU 缓存中记录的 GL 信息为：
    "ANGLE (Intel, Mesa Intel(R) Graphics (ADL-N), OpenGL 4.6 (Core Profile) Mesa 25.0.7-2)"
  - 正确识别显卡为 ADL-N（Alder Lake-N），Mesa 版本 25.0.7
  - 未出现 Bilibili Electron 28 的 "Failed to get system egl display" 错误
  - VA-API VideoDecoder 特性已启用（--enable-features=VaapiVideoDecoder）

  结果：Chromium 139 在 Deepin 25 / Mesa 25.0.7 上能正常初始化 GPU 和 VA-API，硬解链路完整 ✅

5.4 宿主机 VA-API 硬解结论
  宿主机上 VA-API 能力正常——vainfo、ffmpeg、VLC、mpv、Chromium 139 均能正确调用 iHD 驱动实现硬解。
  问题仅局限在：
  - 玲珑容器（扩展驱动版本过小，初始化失败）
  - Bilibili deb 包（Electron 28 的 ANGLE 与 Mesa 25.x 不兼容）

六、总结：三个独立的问题
----------------------------------------------------------------------
问题1（玲珑容器）：玲珑扩展 org.deepin.driver.media.intel 提供的 iHD 驱动
  是裁剪版本（14.6MB vs 37MB），在 N150 上初始化失败。
  玲珑包的应用（影院、浏览器、Edge）均受影响。

问题2（玲珑容器）：容器默认 LIBVA_DRIVERS_PATH 未包含宿主机
  /run/host/rootfs/usr/lib/x86_64-linux-gnu/dri，导致无法回退到
  宿主机正常工作的驱动。

问题3（Bilibili deb 包）：Electron 28.2.1 自带的 ANGLE(libEGL.so)
  与系统 Mesa 25.x 的 EGL display 初始化接口存在兼容性问题，
  导致 GPU 子进程崩溃，VA-API 解码无法启动。

这三个问题独立存在，没有因果关系。VLC、mpv、Chromium 139 等原生应用不受影响。