# 官方 OTA 固件库说明（v1.0 新增）

> 位置：工具箱 →「提权」页 →「OTA 固件库」；数据文件 `assets/data/ota_index.json`；索引代码 `data/OtaIndex`。

---

## 一、它是什么

把「官方 OTA 整包」变成 App 内的可用资产：

1. **内置官方固件索引**：随 App 打包，不用联网也能看版本列表；
2. **一键下载**：用系统 DownloadManager 把整包下到 `…/安小猪的世界/PLZ110固件/已下载/`；
3. **下载后本地解析**：把 OTA 交给工具内置的 `libextract`，提取内核镜像并生成 GhostLock offsets 配置，
   再配合 v1.8 的「运行时 conf→blob」直接在工具内运行 GhostLock。

---

## 二、内置数据（PLZ110 / 一加 15T）

`assets/data/ota_index.json` 共 **9 条** PLZ110 固件：

| # | 版本 | 类型 | 大小（官方口径） | MD5 | 直链 |
|---|---|---|---|---|---|
| 1 | PLZ110_17.0.0.107(CN01) | OTA | 9107.96 MB | 4d6df6f2b832e42e3e0e116dd8e58609 | ✅ 官方直链（已实测 302 → 官方 CDN） |
| 2 | PLZ110_16.0.10.500(CN01) | OTA | 8745.44 MB | c613b61ceaf628f331eefc5856f3d88f | ✅ 官方直链 |
| 3 | PLZ110_16.0.9.400(CN01) | OTA | 8718.25 MB | b5b3730e9d5f92f6ba4ef5a6685ce384 | ✅ 官方直链 |
| 4 | PLZ110_16.0.8.300(CN01) | OTA | 8685.5 MB | cb6375da24d98d90048a13f9d6a67d5f | ✅ 官方直链 |
| 5 | PLZ110_16.0.7.201(CN01) | OTA | 8527.95 MB | 55f12e234207b43bcfcd81ae36828d6c | ✅ 官方直链 |
| 6-9 | 17.0.0.106 / 16.0.7.200 / 16.0.5.703 / 16.0.5.701 | — | — | — | ⚠️ 仅版本名（RomCloud 口径），UI 禁用下载 |

说明：RomCloud（roms.lian86.top）把 PLZ110 标注为「一加 15T」；另一些站点把它归到别的机型，**请先核对你的设备**。
直链是带 `Expires` 的官方下载处理器 URL，过期需重新获取；App 里保留的是未跳转的官方地址。

### ✅ 实测下载状态（2026-11-01 16:48，5/5 完成）

上表 1–5 号整包**已全部下载并 MD5 校验通过**（合计 45.9 GB），存放在
`PLZ110固件/已下载/`；并已用工具内置 `libextract` 逐个解析，结果见
`PLZ110固件/提取结果/说明.md`：

- 16.0.7.201 / 16.0.8.300 / 16.0.9.400 / 16.0.10.500 四版内核均为
  `6.12.38-android16-5-g844001fb8721-ab14552068-4k`，四份 `offsets.conf` **逐字节相同**，
  CVE-2026-43499 漏洞 primitive **存在（未修复）** → GhostLock 链可用，且 v1.0 内置 profile 直接匹配；
- 17.0.0.107 内核为 `6.12.69-android16-6-g242e1a07f878-ab15865446-4k`，该漏洞**已被修复** → GhostLock 不可用。

---

## 二·补：内核自动匹配对照表（v1.9 新增）

| 固件 | 内核 release | 实测结论 |
|---|---|---|
| 16.0.7.201 / 16.0.8.300 / 16.0.9.400 / 16.0.10.500 | `6.12.38-android16-5-g844001fb8721-ab14552068-4k` | ✅ 官方实测 **CVE-2026-43499 漏洞存在**，GhostLock 可走（profile+blob 已内置） |
| 17.0.0.107 | `6.12.69-android16-6-g242e1a07f878-ab15865446-4k` | ⛔ 官方实测**已修复**（rtmutex UAF fix 进内核），GhostLock / pkj110 不可用 |

数据来源：`assets/data/kernel_matrix.json`（`engine/KernelMatrix.java` 与它同源生成）；
同一份矩阵也驱动「独家速琪临时 Root」计划卡的内核结论 pill 与计划正文。

---

## 二·补2：提取（v2.0 新增）

下载到本地的整包，可以直接在工具里解：

1. 提权页 →「提取」；
2. 点「已下载的包」，选 `PLZ110固件/已下载/` 里的 zip；或点「选文件」；
3. 点「开始提取」，等几十秒；
4. 结果显示内核版本、对应固件、GhostLock 能不能走；
5. 文件存到 `PLZ110固件/提取结果/<包名>-<内核短名>/`（boot.img + offsets.conf）。

不需要 Root/ADB/Shizuku，也不需要联网。第一次用会让你开「所有文件访问」权限。

---

## 三、怎么用

1. 打开「提权」页 →「OTA 固件库」；
2. 选「本机机型」或「全部固件」；
3. 点某个版本：
   - **下载**：系统 DownloadManager 下载到 `…/PLZ110固件/已下载/`（若系统不允许写自定义目录，会回退到系统 Download，App 会自动扫描两处）；
   - **复制直链 / 复制 MD5**：手动用浏览器/迅雷/夸克下载；
   - **解析**：对已下载文件 → 跳「解析本地镜像 / OTA」→ `libextract` 生成 offsets conf；
4. 解析成功后可在 GhostLock 页用「运行时配置」直接运行（v1.8 新能力）；
5. **v1.9 起每个固件行会标出对应内核与实测结论**（见下节「内核自动匹配」）；
5. 也可以把整包/提取出的 boot.img 发我，我帮你生成配置/评估提权可行性。

> 权限提示：targetSdk 34 下写自定义目录可能需要「所有文件访问」权限；没有权限时用 App 的「复制直链」或把文件手动放入
> `…/安小猪的世界/PLZ110固件/已下载/`，App 的「已下载固件」区即可识别。

---

## 四、实测结果（重要，2026-11-01）

已在电脑/终端侧用同一套 `libextract` 解析官方整包 `PLZ110_17.0.0.107(CN01)`（9,550,384,952 字节，MD5 与官方完全一致）：

- ✅ 成功从 OTA payload 提取 `boot.img` / `xbl_config.img` / `uefi.img`；
- ✅ 恢复 kallsyms 132,055 个符号，推导内核信息：

```
release            6.12.69-android16-6-g242e1a07f878-ab15865446-4k
kernel_major       6.12
kernel_family      STRUCT_OFFSETS_6_12 (verified Android family)
kernel_phys_load   0xc7800000 (xbl_config FDT)
rt_mutex_waiter    lock=0x58 pi_tree=0x28 task=0x50 tree=0x0 wake_state=0x60 ww_ctx=0x68 size=0x70
mm_struct size     0x4c0
primitive          unavailable: kernel already fixed the vulnerability (rtmutex UAF fix present)
routes available   select_stack / multicast_waiter / tcp_zerocopy（但缺 primitive）
```

**结论**：`PLZ110_17.0.0.107` 的内核已修复 GhostLock 依赖的 rtmutex UAF，因此 **GhostLock 在这版固件上不可用**；
需要等待针对 6.12.69 的 CVE-2026-64560 类 payload。

> v1.0 更新（2026-11-01 16:48）：另外 4 个 16.0.x 整包也已下载并解析，
> 内核全部是 `6.12.38-android16-5-g844001fb8721-ab14552068-4k`，**漏洞存在（未修复）**，
> 四份 `offsets.conf` 逐字节相同 → GhostLock 可用，v1.9 起 App 会自动匹配。
> 逐版本对比见 `PLZ110固件/提取结果/说明.md`。

---

## 五、注意事项

- 固件刷机风险高（错误版本会变砖）：**先核对设置 → 关于手机中的型号/版本/内核**；
- 下载来源以官方 CDN 为准（App 只做索引，不镜像固件）；
- 整包 GB 级，建议 Wi-Fi 下载；下载后可自行删除，工具只读取用于解析；
- 本功能仅供个人设备维护/学习研究，风险自负。