# FreeAndroid

**Repository Path**: bernard5/free-android

## Basic Information

- **Project Name**: FreeAndroid
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-11
- **Last Updated**: 2026-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FreeAndroid — 小米 12S Ultra (thor) 刷机工程

本工程记录小米 12S Ultra（代号 **thor**）从 MIUI 14（Android 12）线刷升级到
**HyperOS 3.0.6.0（Android 15）** 并通过 **KernelSU 完成 root** 的完整过程、
工具链与可复用脚本。

## 目录结构

```
FreeAndroid/
├── bin/                  # 刷机工具链（adb / fastboot 及依赖 DLL）
│   ├── adb.exe           #   Google 版 adb 1.0.39（来自 MiFlash ThirdParty/Google/Android）
│   ├── fastboot.exe      #   Mi 版 fastboot（来自 MiFlash ThirdParty/Mi，兼容性最好）
│   └── AdbWinApi.dll / AdbWinUsbApi.dll
├── roms/                 # 刷机包存放目录（体积巨大，已 gitignore）
│   ├── thor_images_OS3.0.6.0.VLACNXM_*.tgz          # 线刷包（fastboot 完整镜像）
│   ├── thor-ota_full-OS3.0.6.0.VLACNXM-*.zip        # 卡刷包（recovery sideload 完整 OTA）
│   ├── miui_THOR_V14.0.15.0.TLACNXM_*.zip           # 旧版 MIUI 14 完整 OTA（备用回退参考）
│   └── thor_images_OS3.0.6.0.VLACNXM_15.0/          # 线刷包解压后的目录
├── work/                 # 工作文件（从手机拉回的 kernelsu_patched_*.img 等，已 gitignore）
├── scripts/
│   └── flash_thor.bat    # 一键线刷脚本（自动处理老版 fastboot 不支持 set_active 的问题）
├── docs/                 # 中文过程文档
│   ├── 01-工具准备.md
│   ├── 02-线刷流程.md
│   ├── 03-卡刷流程.md
│   ├── 04-KernelSU-Root流程.md
│   └── 05-预装应用精简与安装防护关闭.md
├── backup/               # 精简前的应用包备份与卸载清单（可恢复依据，小文本文件已入库）
└── README.md
```

## 快速开始

1. 手机解 BL 锁（已解锁可跳过），打开 USB 调试并授权本机。
2. 将线刷包 tgz 放入 `roms/` 并解压（右键"解压到当前文件夹"或 `tar -xzf xxx.tgz`）。
3. 双击或命令行执行：

   ```bat
   scripts\flash_thor.bat roms\thor_images_OS3.0.6.0.VLACNXM_15.0
   ```

   脚本会自动 `adb reboot bootloader`、调用官方 `flash_all.bat` 全量线刷、
   补跑 `set_active`（老版 fastboot 不支持），最后重启。

> ⚠️ **线刷会清空手机全部数据**，执行前务必备份。
> ⚠️ 刷机过程中不要拔线、不要睡眠/休眠电脑。

## 详细文档

| 文档 | 内容 |
| --- | --- |
| [docs/01-工具准备.md](docs/01-工具准备.md) | 从 MiFlash 提取工具链、符号链接失败的替代方案、fastboot 版本兼容性坑 |
| [docs/02-线刷流程.md](docs/02-线刷流程.md) | 完整线刷实录：命令、校验、set_active 补坑、验证结果 |
| [docs/03-卡刷流程.md](docs/03-卡刷流程.md) | recovery / adb sideload 卡刷流程（本次未采用，留档备用） |
| [docs/04-KernelSU-Root流程.md](docs/04-KernelSU-Root流程.md) | KernelSU root 实录：KMI 判定（android12-5.10）、修补 boot、临时引导测试、双槽永久刷入 |
| [docs/05-预装应用精简与安装防护关闭.md](docs/05-预装应用精简与安装防护关闭.md) | 27 个预装应用用户级卸载、root 安装绕过限制、关闭安装风险扫描 |

## 设备信息备忘

| 项目 | 值 |
| --- | --- |
| 设备型号 | 2203121C（小米 12S Ultra） |
| 代号 | thor（getvar product: thor，socid: 530） |
| 序列号 | 26d5f1d6 |
| Bootloader | 已解锁（未上锁） |
| 刷机前系统 | MIUI V14.0.15.0.TLACNXM（Android 12） |
| 刷机后系统 | HyperOS OS3.0.6.0.VLACNXM（Android 15） |
| 内核 / KMI | 5.10.236-android12（KMI = android12-5.10） |
| Root 状态 | KernelSU v3.3.0，boot_ab 双槽已刷入修补内核 |
| 当前槽位 | a |
| 防回滚 | anti = 1 |