opencecs/tebox

项目介绍

tebox 是一套基于 QEMU 的 Android GSI 运行基座。它负责启动通用 ARM64 GSI 镜像，内置 gfxstream（ANGLE + Vulkan）与 VirGL（Mesa）两条图形加速路径，并提供自研的 ARM Mali GPU 直通技术。面向需要在物理设备之外反复验证 GSI、扩展运行框架或做自动化测试的 Android 平台与图形开发者。

它不是某一机型的一键刷机包。目标 GSI 能否完整启动取决于其 Treble / VINTF 要求，厂商专有分区和闭源服务需要使用者自行适配。

运行环境

宿主	说明
macOS ARM64（Apple Silicon M1–M4）	推荐；HVF + gfxstream / VirGL 已验证
Linux ARM64	原生构建与运行（KVM）
Linux x86_64	主要用于交叉编译 Android ARM64 客体
Windows x86_64	原生 QEMU/VirGL PE 运行时

快速开始

镜像资源通过 Git LFS 存放，需先安装 LFS（macOS：brew install git-lfs；Ubuntu/Debian：sudo apt-get install git-lfs），然后克隆并拉取：

git lfs install
git clone https://github.com/opencecs/tebox.git
cd tebox
git lfs pull

接着构建并运行 AOSP 示例变体：

bash .ci/install-deps.sh
source build/envsetup.sh
lunch aosp_arm64-BP4A.251205.006
m
SNAPSHOT=1 ./run aosp_arm64-BP4A.251205.006

GSI 变体树位于对应的 GSI/... 分支（AOSP 示例为 GSI/AOSP/aosp_arm64-BP4A.251205.006）。要尝试其他 GSI，检出对应分支后替换 src/aosp/<variant>/images/system.img 即可。社区 GSI 镜像可从 Mystic GSI Updates 获取。

使用约束

构建流程依赖类 Unix shell 和 AOSP 构建工具链（build/envsetup.sh、lunch、m），README 没有给出 Windows 原生的独立构建步骤。并非所有 GSI 都能成功启动，取决于目标镜像的 Treble 与 VINTF 兼容性。从设备提取固件或厂商镜像时，需自行遵守当地法律、厂商许可协议与版权要求。

项目以 Apache-2.0 开源，随附的第三方源码与二进制遵循其各自许可证。

AI 辅助开发

README 指引 Agent 与自动化工具先读根目录 README，再进入 .ai/README.md 获取技能、提示词与开发流程，工程约束写在 .ai/AGENTS.md。

HotRepo 点评

该仓库暂时没有 HotRepo 榜单记录或快照，日榜名次未知。仓库创建于 2026-09-29，比较新，但已积累 92 个 Star 和 60 个 Fork；对于一个依赖 Git LFS 和 AOSP 构建链路的项目，这个 Fork 与 Star 的比例不低。README 对宿主支持、构建命令和 GSI 分支布局写得具体，读者可以直接据此评估和复现。对准备采用的人来说，主要待确认的是 Mali GPU 直通和各变体树在仓库中的实际完整程度，因为文档把内容指向了独立的 GSI/... 分支，并未逐项清点。