feat(termux): glibc 构建自动启用自编 Mesa 26 turnip ICD（GPU 打通）

- app/boot/termux_gpu：glibc 构建 + Termux 且随附 ICD 存在时，在探测前设
  VK_ICD_FILENAMES/VK_DRIVER_FILES；用户显式设置不覆盖
- 文档：Mesa 26.2.6 + KGSL 的完整构建/安装/验证步骤（含 shebang、
  --wrap-mode=nofallback、C++/链接参数三处坑）
- 实测：wgpu 选中 Adreno 840（turnip Mesa 26.2.6），截图首帧 61 ms
- README.termux：GPU 标 ✅，MC 标 🟡（glibc JRE+AWT 已验证，GLX 待 GL 构建）

packaging/docs/termux-glibc-build.md

@@ -169,37 +169,62 @@ DISPLAY=:0 .gnu/target/release/unlucky-launcher-iced \
 - 已实测：`ull java install 17` 从 SAU 镜像装完 `openjdk-17`（含 `openjdk-17-x`），
   约 20 秒；`ull java list` 随后列出 `[system]` 的 17。
 
-## 5. GPU（已排查，当前被驱动挡在 glibc 侧）
+## 5. GPU（已打通：自编 Mesa 26.2.6 + KGSL）
 
-termux-x11 的 X 客户端**可以**走硬件：本机 bionic 栈实测
-`glxinfo -B` → `zink Vulkan 1.4 (Adreno 840 (MESA_TURNIP))`、`Accelerated: yes`，
-`vulkaninfo` 中 Adreno 设备带 `VK_KHR_xcb_surface` / `VK_KHR_xlib_surface`。
+termux-x11 的 X 客户端可以走硬件；glibc 侧的问题在**驱动**，不在 loader：
 
-glibc 侧已把链路搭好并实测到具体阻塞点：
+1. `vulkan-icd-loader-glibc` + ICD JSON 本身正常。
+2. Termux 软件源的 glibc Mesa 24.2.6 不认识 Adreno 840
+   （`chip_id = 44050A31 is unsupported`）。
+3. Arch 的 `vulkan-freedreno 26.2.6` 能加载，但它是 Linux/DRM 构建，缺 KGSL
+   （`/dev/dri` 对 `untrusted_app` 被 SELinux 拒绝）。
 
-1. **loader 正常**：`vulkan-icd-loader-glibc` + 自写 ICD JSON 能加载 ICD。
-2. **Termux 的 glibc Mesa 太旧**：`mesa-vulkan-icd-freedreno-glibc` 是 24.2.6（2024），
-   `vulkaninfo` 报 `chip_id = 44050A31, gpu_id = 6860 is unsupported`
-   （Adreno 840 不在该版本的支持表里）。
-3. **Arch 的新驱动也走不通**：`vulkan-freedreno 26.2.6`（Arch Linux ARM）能加载、
-   但它是 Linux/DRM 构建，找不到设备——Android 的 GPU 走 KGSL，而
-   `/dev/dri` 对 `untrusted_app` 被 SELinux 拒绝（`ls /dev/dri` → Permission denied，
-   设备节点本身是 `crw-rw-rw-`）。
-
-结论：glibc 侧要用硬件 GPU，需要一个 **Mesa 26+ 的 glibc 构建且带 Android/KGSL 后端**；
-现有包都缺一半。在那之前用 CPU（tiny-skia）。
-
-GPU 变体仍可构建并验证降级链：
+**解法：给 glibc 自编一份带 KGSL 的 Mesa 26.2.6。** 本机实测通过：
 
 ```sh
-cargo ... build --release -p unlucky-app-iced     # 默认 feature，带 wgpu
-VK_ICD_FILENAMES="$PREFIX/glibc/share/vulkan/icd.d/freedreno_icd.aarch64.json" \
-VK_DRIVER_FILES="$VK_ICD_FILENAMES" \
-  DISPLAY=:0 .gnu/target/release/unlucky-launcher-iced --renderer=gpu
+# 1) 源码 + 依赖
+#    mesa-26.2.6.tar.xz（archive.mesa3d.org）
+#    Debian libstdc++-14-dev 的头（$G/gnu-support/usr/include/c++/14）
+#    meson / ninja（pip 装 meson）
+# 2) 把源码里 *.py 的 shebang 从 #!/usr/bin/env python3 改成 Termux python3
+#    （Android 没有 /usr/bin/env）
+# 3) meson setup（cc-glibc 包装器：-c 不带链接参数、C++ 加 -stdlib=libstdc++、
+#    共享库链接加 -lstdc++；详见 §3）
+meson setup build3 --native-file="$G/mesa-native.ini" --wrap-mode=nofallback \
+  -Dbuildtype=release -Dstrip=true -Dplatforms=x11 \
+  -Dvulkan-drivers=freedreno -Dfreedreno-kmds=kgsl \
+  -Dgallium-drivers=zink,softpipe -Dglx=dri -Dopengl=true -Degl=enabled \
+  -Dgles1=disabled -Dgles2=enabled -Dllvm=disabled -Dgbm=disabled \
+  -Dvideo-codecs= -Dzstd=enabled -Dbuild-tests=false
+ninja -C build3
 ```
 
-没有可用驱动时它会打印具名错误并**自动降级**到 tiny-skia（同一进程不能重建事件循环，
-降级走 respawn），所以 GPU 变体在只有 CPU 的环境里也能跑。
+`--wrap-mode=nofallback` 是为了跳过 libarchive 子项目（它只被 freedreno 的 decode 工具需要，
+且它自带的 `id_t` 兜底宏会和 glibc 头冲突）。
+
+安装与启用：
+
+```sh
+cp build3/src/freedreno/vulkan/libvulkan_freedreno.so \
+   "$PREFIX/glibc/lib/libvulkan_freedreno_ull.so"
+cat > "$PREFIX/glibc/share/vulkan/icd.d/ull_freedreno.json" <<EOF
+{"ICD":{"api_version":"1.4.335","library_path":"$PREFIX/glibc/lib/libvulkan_freedreno_ull.so"},"file_format_version":"1.0.0"}
+EOF
+```
+
+应用启动时（glibc 构建 + Termux + 该 JSON 存在）会自动把它设进
+`VK_ICD_FILENAMES` / `VK_DRIVER_FILES`（`app/boot/termux_gpu.rs`）；用户显式设了这两个
+变量时不覆盖。实测日志：
+
+```text
+[probe] adapters=1 [Adreno (TM) 840 [IntegratedGpu]] hardware=true :: request=auto -> ICED_BACKEND=wgpu
+[gpu] Selected: AdapterInfo { name: "Adreno (TM) 840", driver: "turnip Mesa driver",
+      driver_info: "Mesa 26.2.6", backend: Vulkan }
+[shot] 1657x1067 renderer=wgpu，首帧 61 ms
+```
+
+没装驱动/没有 GPU 时仍会打印具名错误并自动降级 tiny-skia（同一进程不能重建事件循环，
+降级走 respawn），所以 GPU 变体在纯 CPU 环境也能跑。
 
 ## 6. 已知边界