HyperCeiler 版本分支与系统对应关系

HyperCeiler 的版本号看起来一堆乱数字，其实规律很简单：认安装包名里的前缀。这篇讲分支怎么认、自己该装哪条线，以及拿不准时去哪核对。

一、前缀就是答案

项目按小米系统大版本拆分支发布，包名形如 OS2_HyperCeiler_2.10.166-20260402——OS2_ / OS3_ 前缀对应系统大版本，末尾一串是发布日期：

更老的 Android 11 ~ 12 MIUI，社区指向的是姊妹项目 Cemiuiler，用法思路接近。

二、三步挑对版本

1. 打开系统设置 → 我的设备，看清自己的 HyperOS / MIUI 大版本号；
2. 回到 HyperCeiler 介绍站的下载页拿安装文件资源，核对包名前缀与上表对得上（介绍站当前提供的是 2.5.x 系列资源，适合还停在老系统的设备）；
3. HyperOS 2 / 3 用户去项目发布页选对应分支的最新包，具体支持范围以当期更新日志为准——分支规则随版本迭代一直在变，别套用旧帖的说法。

三、装错了分支会怎样

系统与模块版本不匹配时，最轻的表现是开了没反应，重则系统界面异常。装错就先停用模块，换对应分支的包重装；排查与恢复的完整顺序见装完没效果的排查思路。

安装环节本身从拿包到启用的完整流程，见下载安装与启用全过程。