【AI 参考文章】给 AI Agent 的小米 HyperOS 实操手册:REDMI K90 Ultra 从解锁后到 Root + 框架 + 去预装
读者:执行刷机/root 的 AI Agent。 本文把 2026-11-12 ~ 11-17 一次真实的小米双机操作(REDMI K90 Ultra + Xiaomi 17 Ultra)压缩成可判据、可复现、可回滚的流程。每一节都按同一个结构写:怎么确认现状 → 怎么做 → 怎么验证做成了 → 失败怎么退。
标记约定:文中标
[实测]的,有本次的 adb 输出、日志或脚本回显支撑,可直接当事实引用;标[通用]的,是行业通识、本次未亲手执行,引用前需要自己复核。没有标记的命令段默认来自本次实测。一句话纲领:小米机器的所有操作都必须建立在「读属性确认身份 → 算哈希确认文件 → 只动可回滚的分区 → 用系统侧证据验收」这四步上。跳过任何一步,就会在「以为是砖」和「以为成功了」之间反复横跳。
不适用:本文不覆盖解锁申请本身(§2 只讲判定与后果)、不覆盖非 HyperOS 机型、不覆盖需要自编译内核的场景(SUSFS 一类)。
0. 速览与读法
| 项目 | 内容 |
|---|---|
| 目标机 | REDMI K90 Ultra,代号 warsaw,型号 M332BF,序列号 a4120e83 |
| 副机 | Xiaomi 17 Ultra,代号 nezha,型号 2512BPNDAC,序列号 dc3ff6cb |
| 起点 | HyperOS 3.0.309.0.WHPCNXM / Android 16 / 中国电信定制(cn_chinatelecom),BL 已解锁 [实测] |
| 终点 | HyperOS 4.0.6.0.XHPCNXM / Android 17 + SukiSU LKM root + ZygiskNext + Vector(API 102) + HyperPGuard,第三方应用 69 → 37 [实测] |
| 技术主线 | 线刷重建系统 → 给 init_boot 打补丁拿 LKM root → 补 Zygisk 层 → API 102 框架跑隐私拦截模块 → 分类清理预装 → 跨机迁移 |
| 最大教训 | adb shell su 失败 ≠ 没有 root;MIUI 拦 adb 注入点击;launcher 数据库硬写会被桌面重排;目录站会错标机型代号 |
按这个顺序读:先跑 §1 拿到现状,用 §1.3 的决策树决定跳到哪一节;只有要动系统时才读 §4/§5/§6;只在用户提「删掉某个 App」「为什么某 App 不正常」时读 §7/§9。所有破坏性操作前,先读 §13。
0.1 决策树(拿到 getprop 结果后照此分支)
读 ro.boot.verifiedbootstate
├─ green(未解锁)
│ └─ 到 §2:先判定用户是否真要解锁;不要自作主张申请
├─ orange(已解锁)
│ ├─ ro.miui.cust_variant 是运营商定制(如 cn_chinatelecom)
│ │ └─ 目标是「洗干净/换底包」→ §4 线刷公开国行包(不要走 sideload)
│ ├─ 已经是公开国行,只需要 root
│ │ └─ §5:抽 init_boot → ksud 补丁 → 单槽刷入
│ ├─ 已有 LKM root,但 su 不可用
│ │ └─ §5.4 排错顺序:/proc/modules → ksud 进程 → su 授权 → 用户态初始化
│ └─ 已有 root,要跑 Xposed 模块
│ └─ §6:ZygiskNext → Vector → 模块作用域
└─ 读不到属性(设备离线/授权弹窗)
└─ §1.0 先解决通道,不要猜
1. 现状判定(唯一入口)
1.0 先解决通道
adb devices -l
# 期望:<序列号> device product:warsaw model:M332BF device:warsaw
unauthorized = 手机没点「允许 USB 调试」;offline = 换线或重启 adb server;多设备同时在线时,每一条命令都必须带 -s <序列号> [实测]。
1.1 一次 getprop 把身份读全 [实测]
adb shell getprop | grep -E 'ro.product.device|ro.product.model|ro.build.fingerprint|ro.build.version.incremental|ro.build.version.release|ro.build.version.sdk|ro.miui.cust_variant|ro.boot.verifiedbootstate|ro.boot.flash.locked|ro.boot.slot_suffix'
adb shell uname -r
| 属性 | warsaw(K90 Ultra) | nezha(17 Ultra) | 判据用途 |
|---|---|---|---|
ro.product.device |
warsaw |
nezha |
决定能刷哪个包,唯一硬判据 |
ro.product.model |
M332BF |
2512BPNDAC |
区分同代号不同 SKU |
ro.build.version.incremental |
OS3.0.309.0.WHPCNXM → OS4.0.6.0.XHPCNXM |
OS4.0.7.0.XPCNXM |
中间字母段 = 平台标识,必须与 rom 包一致 |
ro.build.version.release / sdk |
16/36 → 17/37 |
17/37 |
决定模块与 App 兼容性 |
ro.miui.cust_variant |
cn_chinatelecom → 刷机后 cn |
cn_chinatelecom |
运营商定制机,预装策略不同 |
ro.boot.verifiedbootstate |
orange |
orange |
orange = 已解锁,green = 未解锁 |
ro.boot.flash.locked |
0 |
0 |
0 = 未回锁 |
ro.boot.slot_suffix |
_a |
_a |
A/B 机型,动分区必须带槽位 |
uname -r |
6.6.118-android15-… |
6.12.69-android16-… |
决定用哪个 KMI 内核模块 |
ro.build.fingerprint |
Redmi/warsaw/warsaw:17/…WHPCNXM:user |
— | 整串都是判据,含地区码 |
1.2 fastboot 侧复核(更权威)
adb reboot bootloader
fastboot getvar product # 必须等于期望代号
fastboot getvar unlocked # yes
fastboot getvar current-slot # a
fastboot reboot
getvar product 与 ro.product.device 不一致时,停下来,说明包刷错过或设备不是你以为的那台。
1.3 机型身份只信三合一
本次真实陷阱 [实测]:某固件目录站把「REDMI K100 基础款」标成 codename = warsaw、型号 M786BC、版本 OS4.0.8.0.XHPCNXM,看起来和本机完全一致。交叉核对判定为目录站错标:
- 权威机型库(XiaomiFirmwareUpdater
devices.yml)里warsaw只有一条:Redmi K90 Ultra China; - K100 家族真实代号是
athens(K100 Pro,平台段XPI)和songyuan(K100 Pro Max); - 型号
M786BC≠M332BF,同代号也可能是不同硬件 SKU。
规则:兼容性判定要求 ro.product.device + 版本串平台段 + 型号三者同时吻合。任何单一来源(尤其 rom 聚合站)都不足以作为刷机依据。
1.4 「有没有全球版」的判定方法 [实测]
结论:该机型没有海外固件。可复用判据:
- 拉
XiaomiFirmwareUpdater/miui-updates-tracker的devices.yml,grep 代号:只有warsaw(China),无warsaw_global/warsaw_eea_global; - 对照同代机型:Redmi K90(
annibale)有 6 个海外版,K80(zorn)海外版是 POCO F7 Pro —— 说明「没有海外版」是机型策略,不是搜索失败; - 设备侧
getprop无任何global/eea字段,fingerprint 恒为…CNXM。
2. 解锁(BL)——只判定,不代做
2.1 本次的实际状态 [实测]
这两台机器在记录开始时就已经是解锁状态(verifiedbootstate=orange、flash.locked=0)。解锁动作发生在这批记录之前,本文不含解锁申请的操作日志。
所以正确姿势是:先判定解锁状态,再决定是否需要引导用户去解锁,不要默认设备未解锁。
adb shell getprop ro.boot.verifiedbootstate # orange=已解锁 / green=未解锁
adb shell getprop ro.boot.flash.locked # 0=未锁
fastboot getvar unlocked # unlocked: yes
2.2 解锁路径本身 [通用]
小米解锁政策变动频繁(账号绑定天数、社区等级、年度次数、机型白名单都改过多次),因此:
- 不要背具体天数,让用户看官方「小米解锁」页面当次公告;
- 解锁工具与申请入口以官方为准,第三方「代解锁/一键解锁」一律视为风险;
- 解锁会触发
verifiedbootstate=orange,这本身就会让部分金融/游戏类 App 判定环境异常,必须在动手前告知用户。
2.3 解锁状态的后果清单(提前说清,避免事后归因错误)
| 现象 | 是解锁/root 导致的吗 | 说明 |
|---|---|---|
| 支付类 App 提示「环境异常」 | 是 | Play Integrity / 厂商风控不通过 |
| 手游反作弊拒绝启动 | 是 | 同上 |
| 小米钱包 NFC/公交卡异常 | 可能 | 与 TEE/完整性相关 |
| OTA 后 root 消失 | 是 | init_boot 被覆盖,属正常 |
| Google Play Integrity 不通过 | 是 | 解锁即失效 |
可以直接复用这句话告诉用户:「这些是解锁 + root 的必然结果,不是刷坏了。」
3. 工具链与信任纪律
本次全流程工具都是公开源码项目,每个二进制都做了哈希核对:
| 工具 | 版本 | 用途 | 来源 |
|---|---|---|---|
| adb / fastboot | 34.0.1 / 35 | 设备通道、分区刷写 | AOSP platform-tools |
ksud.exe |
Windows 版取自 KernelSU v3.3.1(设备内 ksud -V 报 4.3.0-r2、uapi 6) |
给 init_boot.img 打 KernelSU 补丁 |
tiann/KernelSU |
payload-dumper-go |
2.1.0 | 从 OTA 的 payload.bin 抽原厂镜像 |
ssut/payload-dumper-go |
| SukiSU-Ultra | v4.3.0-r2 | root 管理器 + LKM 模块 | SukiSU-Ultra/SukiSU-Ultra |
| ZygiskNext | 1.5.3 | 给 KernelSU 系 root 补 Zygisk 层 | Dr-TSNG/ZygiskNext |
| Vector | v2.2 | Xposed 框架(LSPosed 下游分支,API 102) | JingMatrix/Vector |
| HyperPGuard | v1.8.0 | 拦截 HyperOS 预装组件上报 | vivibibi30/hyperpguard |
3.1 三条纪律
- 哈希先行:文件名带哈希的包,先算 MD5/SHA256 再谈刷。本次线刷包名尾
6a6101b221、卡刷包名尾220d1ce4e3,实测比对通过[实测]。 - 能抽就不重下:需要原厂
init_boot.img时,不要下 11 GB 线刷包——用payload-dumper-go从已下载的 9 GB OTA 包里抽 8 MB[实测]。 - 同名不同物要查源码:用户要装「Hyper 隐私卫士」时,实际存在两个项目(
io.github.hyperprivacyguard与vivibibi30/hyperpguard)。前者只出现在后者的 README「参考来源」里,GitHub 无仓库、LSPosed 官方索引 404 —— 最终拒绝安装,改装可核对哈希的开源版[实测]。
4. 线刷:把定制机洗成公开国行
4.1 为什么不用 sideload [实测]
用户最初下的是 A/B OTA 卡刷包(warsaw-ota_full-…zip,9,016,252,634 字节)。两条路都堵:
adb sideload→ recovery 直接拒绝(failed to read command),设备正常重启回系统,未写入任何分区;- 系统更新器「本地安装包」→ 需要点屏幕,而 MIUI 禁止 adb 注入点击(
SecurityException: Injecting input events requires INJECT_EVENTS)。
结论:设备已解锁且目标是换底包/清定制时,直接用 fastboot 线刷包(*_images_*.tgz),不要跟 A/B sideload 纠缠。
4.2 前置四件事 [实测]
# 1) 磁盘与电量:本次 C 盘只剩 102 GB,改下到 D 盘(tgz 11.08 GB + 解压 13.27 GB)
# 2) 校验:文件名尾哈希 = 文件 MD5 前缀
Get-FileHash 'D:\rom\warsaw_images_OS4.0.6.0.XHPCNXM.tgz' -Algorithm MD5
# 3) 解压后先读官方刷机脚本,不要盲跑
Get-Content .\flash_all.bat -TotalCount 60
Get-Content .\images\anti_version.txt # 本次 anti_version=1(防回滚版本)
# 4) 进 fastboot 复核身份
adb reboot bootloader
fastboot getvar product # warsaw
fastboot getvar unlocked # yes
4.3 执行与验收
执行官方 flash_all.bat(自带机型校验 + 防回滚检查):全程 OKAY,super 分区 15 个分块、userdata 3 个分块,最后 set_active a → rebooting,退出码 0 [实测]。首启约 3.5 分钟(清数据后属正常)。
验收不是「看起来开机了」,而是逐项读回:
| 验收项 | 期望值(本次实测) |
|---|---|
ro.build.version.incremental |
OS4.0.6.0.XHPCNXM |
ro.build.version.release / sdk |
17 / 37 |
ro.build.fingerprint |
Redmi/warsaw/warsaw:17/… |
ro.boot.slot_suffix |
_a |
ro.miui.cust_variant |
cn(定制标识已被公开包洗掉) |
ro.boot.verifiedbootstate |
仍 orange(脚本没有回锁,也没有回锁) |
/sdcard/Download |
空(确认 userdata 已重置) |
4.4 硬规则
- 刷机前必须显式取得「数据会全没」的确认——本次连问两次(用户先选「保数据升级」,失败后才改选线刷)。
- 不要顺手回锁。回锁前必须保证所有分区都是官方且无残留,否则可能直接不开机;本次明确拒绝执行
flash_all_lock.bat。 - 刷完清理下载物前先核对路径:
Resolve-Path拿绝对路径 + 列出待删内容,确认目录内只有自建文件再删(本次删D:\rom24.35 GB)[实测]。
5. Root:SukiSU 的 LKM 路线
小米 + Android 13 以上 + KernelSU 系,标准答案:不动内核,只给 init_boot.img 打补丁。
5.1 方案对比
| 方案 | 做法 | 代价 |
|---|---|---|
| Magisk | 补丁 init_boot/boot,用户态守护 |
生态成熟,但部分新 ROM 上 Zygisk 兼容有问题 |
| SukiSU + LKM(本次) | 补丁 init_boot 注入 kernelsu.ko,内核保持原厂 |
不触发 AVB 变化、不破坏厂商驱动、模块可卸、OTA 友好 |
| 自编译内核 | 换整个内核 | 需要对应机型内核源码,错了就是 bootloop |
LKM 的本质:init_boot 的 ramdisk 里多一个 .ko,开机早期 insmod 进内核,拿到内核态 hook 能力。SELinux 依然是 Enforcing,root 运行在独立域 u:r:ksu:s0 —— 不需要关 SELinux。
5.2 完整流程(可照抄)
# ① 确认内核 → 决定 KMI
adb shell uname -r # 6.6.118-android15-8-g0908354dac1b
# KMI = android15-6.6(由内核串决定,与 Android 版本号无关!)
# ② 取原厂 init_boot.img(从 OTA 的 payload.bin 抽,8 MB)
payload-dumper-go.exe -p init_boot -o .\stock warsaw-ota_full-….zip
# ③ 用 ksud 打补丁:boot 镜像 + 匹配的 .ko + KMI
ksud.exe boot-patch -b .\stock\init_boot.img `
-m .\ksu-android15-6.6.ko `
--kmi android15-6.6 `
-o .\patched `
--allow-shell
# 产物:patched\kernelsu_patched_20261112_041733.img
# ④ 只刷当前槽位,保留另一槽原厂(多一层保险)
adb reboot bootloader
fastboot flash init_boot_a .\patched\kernelsu_patched_….img
fastboot reboot
# ⑤ 装管理器(root 的用户态初始化靠它)
adb install -r SukiSU-v4.3.0-r2.apk
adb shell monkey -p com.sukisu.ultra -c android.intent.category.LAUNCHER 1
5.3 四重验收(缺一不可)[实测]
adb shell su -c id
# uid=0(root) gid=0(root) groups=0(root) context=u:r:ksu:s0
adb shell "cat /proc/modules | grep kernelsu"
# kernelsu 487424 1 - Live ... (O) ← 内核模块已加载
adb shell "su -c '/data/adb/ksu/bin/ksud -V'"
# ksud 4.3.0-r2 (uapi: 6)
adb shell getenforce
# Enforcing ← 不需要关 SELinux
5.4 失败分支:su 不通不等于补丁错 [实测]
打完补丁刷入、重启后 su 依然不可用。不是补丁错了:/proc/modules 里 kernelsu 已 Live,内核侧通了;缺的是用户态初始化——打开一次 SukiSU 管理器,让它完成 /data/adb/ksu 初始化,su 立刻出现。
排错顺序固定:
su 不可用
├─ /proc/modules 有 kernelsu?
│ ├─ 没有 → 补丁或 KMI 不匹配:核对 uname -r ↔ --kmi ↔ .ko 文件名
│ └─ 有 → 问题在用户态
│ ├─ ps 里有 ksud?没有 → 管理器没初始化
│ ├─ 有 → 检查 shell 是否被授权(uid 2000 默认不授权)
│ └─ 自动化场景:打补丁时加 --allow-shell,或管理器里给 Shell 授权
5.5 OTA 与撤销
| 场景 | 做法 |
|---|---|
| 系统 OTA 后 root 失效 | 打开 SukiSU → 安装 → 安装到未激活槽位 → 重启(无需电脑) |
| 临时关 root | 管理器内卸载模块 + 重启 |
| 彻底还原 | 刷回原厂 init_boot(两槽都刷),本次生成了 warsaw_unroot.ps1 |
| 变砖兜底 | fastboot flash init_boot_a stock\init_boot.img → 重启(5 秒恢复);最差整包线刷 |
warsaw_unroot.ps1 的核心就三行,这就是「可回滚」的具体形态:
fastboot flash init_boot_a .\root\stock\init_boot.img
fastboot flash init_boot_b .\root\stock\init_boot.img
fastboot reboot
6. 框架链:从 root 到「能跑 Xposed 模块」
6.1 依赖链(当电路图看)
BL 解锁 (verifiedbootstate=orange)
└─ SukiSU LKM root ← init_boot 补丁 + kernelsu.ko
└─ ZygiskNext 1.5.3 ← KernelSU 不自带 Zygisk,LSPosed 系模块全依赖它
└─ Vector 2.2 (libxposed API 102)
├─ HyperPGuard 1.8.0 ← 拦 HyperOS 预装组件上报
└─ HyperCeiler 2.10.166 ← 功能增强(对 Android 17 尚未适配)
缺任何一层,上面那层就不工作,而且报错往往很隐晦(模块「装了但没生效」)。
6.2 选型判据:为什么是 Vector [实测]
| 原版 LSPosed | Vector | |
|---|---|---|
| 最新 Release | v1.9.2(2023-10) | v2.2(2026-08) |
| Xposed API | 93 | 102(libxposed 新 API) |
| 支持上限 | Android 14 左右 | README 标注到 Android 17 Beta |
目标模块 module.prop |
minApiVersion=102 → 直接跳过不加载 |
✅ 满足 |
决定性理由是模块硬性声明 API 102,不是偏好。附带好处:Vector 提供 CLI,可以全自动配置。
6.3 用 CLI 全自动装配
不用让用户在手机上点勾选框,框架状态与作用域都能命令行读写:
# 框架状态
adb shell "su -c '/data/adb/lspd/cli status'"
# 模块清单(看到 enabled/disabled)
adb shell "su -c '/data/adb/lspd/cli modules ls'"
adb shell "su -c '/data/adb/lspd/cli modules enable io.github.vivibibi30.hyperpguard'"
adb shell "su -c '/data/adb/lspd/cli modules disable io.github.vivibibi30.hyperpguard'"
# 作用域读写(格式:包名/用户id)
adb shell "su -c '/data/adb/lspd/cli scope ls io.github.vivibibi30.hyperpguard'"
adb shell "su -c '/data/adb/lspd/cli scope add io.github.vivibibi30.hyperpguard com.miui.analytics/0 com.miui.packageinstaller/0'"
装模块走 ksud,不用点管理器:
adb shell "su -c '/data/adb/ksu/bin/ksud module install /sdcard/Download/Vector-2.2.zip'"
# 重启后:/data/adb/modules/zygisk_vector 出现,守护进程从 lspd 变 vectord
6.4 验收看注入日志,不看图标
最容易骗人的是「管理器里显示已启用」。真正生效的证据是目标进程里的 attach 日志:
I HyperPGuard: attach xmsf
I HyperPGuard: xmsf okhttp dns hooked=1 ← 1 = 域名拦截规则装上了
I HyperPGuard: attach market
I HyperPGuard: market okhttp dns hooked=0
验证套路:am force-stop 目标进程 → monkey 拉起 → logcat -d 抓 attach 行。
6.5 换框架时保住已有模块 [实测]
nezha 原来装的是 LSPosed 1.9.2(Zygisk 模块 id = zygisk_lsposed)。替换步骤:
ksud module install Vector-2.2.zip;- 不删旧模块,只写
disable标记:touch /data/adb/modules/zygisk_lsposed/disable(可逆); - 重启 → Vector 接管
/data/adb/lspd,自动迁移旧数据库,原有 3 个模块(HyperCeiler / Hail / 某个会员模块)连同作用域一起生效。
判断框架身份的技巧:Zygisk 模块 id 是
zygisk_lsposed= 经典 LSPosed;zygisk_vector= Vector。看进程lspd存在与否不足以区分。
6.6 模块选型:什么该装,什么别碰 [实测]
| 模块 | 结论 |
|---|---|
| ZygiskNext + Vector | 必需,缺了跑不了任何 Xposed 模块 |
| HyperPGuard 1.8.0 | 推荐(开源、GPL-3.0、133 KB、哈希可核) |
| HyperCeiler 2.10.166 | 装了但超纲:仅适配到 HyperOS 3 / Android 16,本机是 Android 17 |
| SUSFS | ❌ 用不了:需要定制内核,LKM 模式是原厂内核 |
| Shamiko / Zygisk Assistant | ⚠️ Magisk 生态 / 仓库已 404 |
改 /system、/vendor 的模块 |
❌ 破 AVB、破 OTA,且该机型没有官方 TWRP |
| 无源码 APK(尤其注入系统进程的) | ❌ 整机风险,先静态分析再决定 |
6.7 HyperCeiler 的隐形 bug(处理模板)
GitHub issue #1767:HyperOS 4 上 HyperCeiler 对 __system_property_get 的 inline hook 遇到 page-size compat 的零长度 maps 行,导致每 50 ms 全量重扫 4700 个映射,吃掉一个核心 25–30%,表现为「桌面卡顿」。规避不是卸载模块,而是把 com.miui.home 移出作用域:
adb shell "su -c '/data/adb/lspd/cli scope rm com.sevtinge.hyperceiler com.miui.home/0'"
adb shell "su -c 'am force-stop com.miui.home'" # 桌面会自动拉起
# 作用域 66 → 65
代价要说明:HyperCeiler 里所有「系统桌面」分类的功能随之失效(布局、图标、Dock、最近任务、手势)。因为 hook 挂在整进程上,做不到只关某一个开关。
7. 去预装与去上报
用户原话是「卸载所有 ROM 出厂预装」。正确反应不是照做,而是先分类。
7.1 三类预装,三种处理
| 类别 | 位置特征 | 处理 | 理由 |
|---|---|---|---|
| A. 渠道定制推广(本次 28 个) | /cust 分区 |
pm uninstall --user 0 直接卸 |
纯推广,卸了不影响系统 |
| B. product 分区的第三方(讯飞/百度输入法、WPS 轻量等) | /product |
谨慎,输入法最后动 | 卸掉可能没有输入法可用 |
| C. 小米系统应用(相册/时钟/日历/天气/安全中心/钱包…) | /product |
保留 | 安全中心被删可能影响权限管理与安装 |
本次执行 [实测]:第三方包 69 → 41(卸 28 个,0 失败),随后 C 类处理再降到 37。
7.2 统计/广告组件:用权限交叉找
用 root 把全量包信息 dump 到 PC 再解析,比逐个查快得多:
adb shell "dumpsys package > /data/local/tmp/dpkg.txt"
adb pull /data/local/tmp/dpkg.txt .
解析 QUERY_ALL_PACKAGES(读全部已安装应用)+ INTERNET 交叉结果 [实测]:
- 402 个包里 93 个持有
QUERY_ALL_PACKAGES(23%),其中 78 个同时能联网; - 另有 28 个持有
PACKAGE_USAGE_STATS(比「装了什么」更敏感:每天用了什么、用了多久)。
处理策略(可逆优先):
| 动作 | 包 | 回退方式 |
|---|---|---|
| 卸载(user 0) | com.xiaomi.shop、youpin、vipaccount、gamecenter、minigame、mfashiongallery.emag |
cmd package install-existing |
| 禁用(保留 APK) | com.miui.analytics、systemAdSolution、hybrid(快应用)、contentextension(负一屏) |
pm enable |
7.3 三条可逆工程规范
- 先备份清单再动手:
pm list packages -3 -f存成warsaw_preloads_backup.txt(含安装路径); - 生成还原脚本:
warsaw_restore_preloads.ps1里 38 个包,install-existing+pm enable一条命令全部回来; - 区分「卸载」与「禁用」:独立推广 App 卸载,系统服务只禁用(避免框架调用缺失组件时报错)。
7.4 一个必须纠正的预期
/cust是只读分区,APK 本体删不掉(没 root 也不行)。卸载只清了用户数据与沙箱,因此/data占用变化不明显 —— 这不是「没删干净」。恢复出厂或某些 OTA 后,这些预装可能自己回来,届时跑还原脚本的反向操作。
7.5 「删掉 X」的排查模板 [实测]
用户要求「删除国家反诈 App」。处置流程可直接复用:
pm path com.hicorenational.antifraud→ 空;- 402 个包全量匹配
fraud|hicore|antifraud|gov|police→ 0 命中; - 全盘
find /product /system_ext /cust /data/app→ 0 命中; - root 下 grep
/data/system/packages.xml→ 无记录; pm list packages -u(含已卸载保留)→ 无。
结论:本机没有这个 App。唯一带「国家反诈中心」字样的是短信 App 的一条 126 字节发送方签名识别规则(.../patterns/jz/guojiafanzhazhongxin.pattern),作用是「收到该签名的短信时显示发送方名字」,不上报任何数据。推断原因:原机是电信定制版,这类定制机常预装,线刷公开国行包时已被清掉。
方法论:用户说「删掉 X」时,先证明 X 是否存在、以什么形态存在(App / 系统组件 / 规则文件 / 快捷方式),再谈删。把「不存在」作为结论输出,比硬删一个同类包更有价值。
8. 跨机迁移与桌面布局
8.1 应用迁移:只装应用,不迁数据
需求:把 nezha 上除微信外的应用迁到 warsaw,网络类软件(v2ray/WireGuard/Telegram)只要装,不要历史数据。
# ① 设备侧收集(含 split 分包,用原文件名避免覆盖)
# ⚠️ root shell 里 /sdcard 可能不可见 → 用 /data/local/tmp 中转
for p in $(cat /data/local/tmp/mig_list.txt); do
mkdir -p /data/local/tmp/_mig/$p
pm path "$p" | sed 's/package://' | while read f; do cp -f "$f" /data/local/tmp/_mig/$p/; done
done
# ② 一次性拉回 PC(8.23 GB,比逐个小文件快得多)
adb pull /data/local/tmp/_mig D:\mig
# ③ 批量安装:必须用 install-multiple,兼容单包与 split
adb -s a4120e83 install-multiple -r -d <所有 apk>
结果 [实测]:68 个应用 → 67 个安装成功;唯一失败的是 com.sukisu.ultra(目标机版本更新,41150 > 41140,属正常拒绝)。目标机第三方应用 37 → 98。
8.2 两个隐蔽 bug(都是「看起来像设备问题,其实是脚本问题」)
| 现象 | 真因 | 修法 |
|---|---|---|
大量 adb: filename doesn't end .apk or .apex: D |
PowerShell 把单元素结果当字符串,$apks[0] 取到字符 D |
强制数组 @(...),或统一走 install-multiple |
最后一个包 com.synology.securesignin 被漏掉 |
清单文件末尾缺换行,while read 丢最后一行 |
写入时补 \n,或收集后校验「目录数 = 清单行数」 |
教训:批处理任务必须做数量对账(收集 N 个 / 安装 N 个 / 失败清单),否则静默丢件。
8.3 桌面布局迁移:一次诚实的失败 [实测]
目标:让 warsaw 的桌面布局复刻 nezha。尝试路径与结论:
- 定位数据库:
/data/user_de/0/com.miui.home/databases/launcher4x6.db(注意是user_de,不是user/0); - 对比 schema:两端表结构不同(warsaw 多
extendContainer、isOnlySupportExtend两列)→ 直接拷库必崩; - 改走低风险:不换库,只按 nezha 的 (screen, cellX, cellY, container) 重排 warsaw 现有图标;
- 写入后
am force-stop com.miui.home让桌面重建; - 结果:桌面把写入「规范化」了 —— 4 屏变 6 屏、分页 9/10/7/24/24/6、Dock 出现坐标冲突(两格同为 cellX=2)。图标没丢、系统没崩,但没复刻成目标布局。
原因:HyperOS 桌面启动时按自己的网格算法重排,外部直接写 SQLite 会被它的布局引擎整理掉。
正确路径:走官方本地备份——com.miui.backup 两端都存在,且 com.miui.home 声明了 CLEAR_BACKUP 动作,说明桌面布局受官方备份/恢复支持。让桌面自己生成、自己应用布局,而不是伪造它的数据格式。
元规则:要「伪造」某个 App 的内部数据前,先问一句——这个 App 有没有官方导入/导出的合法入口? 有就走入口,成功率远高于逆向它的存储格式。
9. 真机取证方法论(微信选图黑框案例)
9.1 现象与第一反应
用户:「微信发送图片时,选择图片有一部分是黑框。」
第一反应不该是猜原因,而是分层排除:文件 → 索引 → 权限 → 解码器 → 渲染。
9.2 七步取证流水线 [实测]
| 步骤 | 命令/手段 | 本次结果 |
|---|---|---|
| ① 连接确认 | adb devices -l + PnP |
命中 dc3ff6cb(17 Ultra,HyperOS 4 / Android 17) |
| ② 规模统计 | MediaStore 查询 | 图片 4171 / 视频 523;JPEG 4151、PNG 19、WebP 1,无 HEIC/AVIF |
| ③ 索引健康 | 比对 MediaStore 与实际文件 | 失效记录仅 8 条、尺寸不一致 0、is_pending 0 |
| ④ 缩略图缓存 | 列系统缩略图目录 | 4170 个,全部非空(0 字节只有 .nomedia) |
| ⑤ 字节级解码 | 抽样 50 张用 Pillow 解码 | 50/50 成功(含 2 张两亿像素) |
| ⑥ 权限 | dumpsys package com.tencent.mm |
READ_MEDIA_IMAGES: allow(不是「仅部分照片」) |
| ⑦ 渲染实测 | screencap 抓帧 + 像素统计 |
见下 |
9.3 模型没有眼睛时怎么看屏幕
本次 read_image 失败(模型侧不支持看图)→ 改用像素统计定量判断:
- 抓 18 帧(间隔数秒),用 Pillow 算每格平均亮度与彩色像素占比;
- 结果:4 列 × 6 行网格,每格平均亮度 6.8/255、彩色像素占比 0.0%,只有右上角选择圆圈被绘制;
- 多帧间隔 5 分钟完全不变 → 不是「加载中」,是渲染/解码失败。
通用性很强:空态 vs 黑图 vs 加载中,用「亮度 + 彩色占比 + 帧间差异」三个数就能分开。
9.4 结论(按可能性排序)
- 微信自身缩略图缓存索引损坏(最可能):
/sdcard/Android/data/com.tencent.mm/cache/imgcache/cache.data*5 个文件全 0 字节,微信用了 4 个多月,属异常状态; - Xiaomi Ultra HDR 多图 JPEG 兼容性:1660 张相机 JPG 里 1126 张(68%) 是
hdrgm+MPF容器,且非标准写法——主图 JPEG 之后追加的增益图是 PNG(文件尾是IEND,不是FFD9),很多第三方解码器只能读出「主图不完整」→ 画黑格; - 杜比视界视频封面抽帧失败:105 个
*_DOLBY.mp4,微信启动日志明写Unsupported mime video/dolby-vision; - 两亿像素照片(2 张)超出常见解码上限。
9.5 从日志里拿「能力声明」
adb shell "logcat -d" | grep -E 'VideoCapabilities'
# W/VideoCapabilities: Unsupported mime video/dolby-vision
# W/VideoCapabilities: Unsupported mime image/vnd.android.heic
App 启动时会自己声明「我不支持什么」——这比任何推测都可靠。顺序是:先找对方的自白,再找环境的问题。
9.6 修复建议(分层给,不打包票)
- 微信 → 设置 → 通用 → 存储空间 → 清理缓存(不动聊天记录)→ 强杀重开;
- 对 HDR 照片做一次「编辑→保存」导出普通 JPEG,或关掉相机的 HDR/超清保存;
- 杜比视界视频先转 H.264 再发;
- 仍不行:关深色模式 → 最后才考虑重装(先备份聊天记录)。
10. 踩坑总表
| # | 现象 | 真因 | 正确做法 |
|---|---|---|---|
| 1 | adb shell su 报 not found,误判「没有 root」 |
KernelSU 默认不授权 shell(uid 2000) | 看 /proc/modules 有 kernelsu、ps 有 ksud;要自动化就在打补丁时加 --allow-shell,或在管理器里给 Shell 授权 |
| 2 | input tap 无反应 |
MIUI 禁 INJECT_EVENTS(SecurityException) |
改用 uiautomator dump 读文本、screencap 看画面,或让用户点 |
| 3 | pm disable-user 系统包失败 |
shell 权限不够 | 必须 su -c 'pm disable-user …' |
| 4 | root shell 里 /sdcard 不可见 |
不同 mount namespace | 中转目录用 /data/local/tmp |
| 5 | /data/data/<pkg> 不存在 |
MIUI 限制 root 的 namespace | 用 /data/user/0/<pkg> 或 /data/user_de/0/<pkg> |
| 6 | adb sideload 被 recovery 拒绝 |
A/B 机型 recovery 不接受该包 | 换 fastboot 线刷包 |
| 7 | 按目录站「同代号」刷包 → 险些砖 | 聚合站错标代号(K100 被标成 warsaw) | 只信 ro.product.device + 版本平台段 + 型号三合一 |
| 8 | 批量安装大量 filename doesn't end .apk: D |
PowerShell 单元素被当字符串索引 | @() 强制数组 / install-multiple |
| 9 | 迁移少装最后一个包 | 清单末尾缺换行 | 补 \n + 数量对账 |
| 10 | 硬写 launcher DB 后布局被改乱 | 桌面有自研布局引擎,会重排 | 走官方本地备份/恢复 |
| 11 | 模块「已启用」但完全不生效 | 框架 API 版本低于模块要求(93 < 102) | 核 module.prop 的 minApiVersion;换 Vector |
| 12 | 换框架后以为旧模块全丢 | 以为需要重配 | 先只写 disable 标记不删目录,Vector 会自动迁移数据库 |
| 13 | 桌面莫名卡顿 | HyperCeiler 在 OS4 上的已知 hook bug(#1767) | 把 com.miui.home 移出作用域 |
| 14 | 想读屏幕但模型不支持看图 | 多模态能力缺失 | 用像素统计 + uiautomator dump + DB 回读替代 |
| 15 | 为了拿 init_boot 又下 11 GB |
没想到能从 OTA 抽 | payload-dumper-go -p init_boot |
11. 给 AI 的操作准则(可直接作为 system prompt 片段)
1. 先只读,后写入。任何写操作前,先输出「当前状态 + 判据 + 预期结果」。
2. 设备身份以 getprop/fastboot getvar 为准,商品名与目录站信息只作参考。
3. 多设备必须显式 -s <序列号>,并给设备起固定别名(warsaw / nezha)。
4. 一切大文件先算哈希,再解压/刷写;文件名带哈希的,哈希必须匹配。
5. 刷机/清数据/回锁/卸载系统组件:四类操作必须先取得用户明确同意。
6. 破坏性操作前必须准备回滚物(原厂镜像、包清单、还原脚本),并验证回滚物存在。
7. 验收看系统侧证据:getprop、/proc/modules、dumpsys、logcat 的 attach 行,
不看「界面上显示已启用」。
8. root 相关排错顺序:/proc/modules → ksud 进程 → su 授权 → 用户态初始化。
9. 遇到 App 行为异常,先找 App 自己的日志自白(capabilities/unsupported),
再怀疑环境。
10. 修改 App 私有数据前,先找官方导入导出入口;没有入口再考虑逆向,且必须备份。
11. 批量任务必须做数量对账,并输出失败清单与失败原因分类。
12. 模型看不了图就用数值:亮度均值、彩色占比、帧间差异、DB 行数、文件大小。
13. 不安装无源码、无法核对哈希、且要注入系统进程的 APK。
14. 如实报告失败。本次「桌面布局没复刻成功」就是如实说的,比伪造成功更有价值。
12. 命令速查卡
# ===== 身份与状态 =====
adb shell getprop ro.product.device
adb shell getprop ro.build.fingerprint
adb shell getprop ro.boot.verifiedbootstate # orange=已解锁
adb shell getprop ro.boot.slot_suffix
adb shell uname -r # → 决定 KMI
fastboot getvar product; fastboot getvar unlocked
# ===== Root(LKM)=====
payload-dumper-go -p init_boot -o ./stock ota.zip
ksud boot-patch -b stock/init_boot.img -m ksu-android15-6.6.ko --kmi android15-6.6 -o patched --allow-shell
fastboot flash init_boot_a patched/kernelsu_patched_*.img
adb shell su -c id # 期望 context=u:r:ksu:s0
adb shell "cat /proc/modules | grep kernelsu" # 期望 Live
# ===== 框架 =====
adb shell "su -c '/data/adb/ksu/bin/ksud module install /sdcard/Download/Vector-2.2.zip'"
adb shell "su -c '/data/adb/lspd/cli status'"
adb shell "su -c '/data/adb/lspd/cli modules ls'"
adb shell "su -c '/data/adb/lspd/cli scope add <module> <pkg>/0 <pkg>/0'"
adb shell "am force-stop <pkg>"; adb shell "monkey -p <pkg> -c android.intent.category.LAUNCHER 1"
adb shell "logcat -d" | grep -E 'attach|hooked'
# ===== 预装与权限分析 =====
adb shell "pm list packages -3 -f" > preloads.txt
adb shell "dumpsys package > /data/local/tmp/dpkg.txt"; adb pull /data/local/tmp/dpkg.txt .
adb shell "su -c 'pm uninstall --user 0 <pkg>'"
adb shell "su -c 'pm disable-user --user 0 <pkg>'"
adb shell "su -c 'cmd package install-existing <pkg>'" # 还原
adb shell "su -c 'pm enable <pkg>'" # 还原
# ===== 取证 =====
adb shell screencap -p /sdcard/s.png; adb pull /sdcard/s.png .
adb shell uiautomator dump /sdcard/ui.xml; adb pull /sdcard/ui.xml .
adb shell "dumpsys window | grep mCurrentFocus"
adb shell "dumpsys package <pkg> | grep -m2 -E 'versionName|firstInstallTime'"
13. 边界与风险(约束 AI 自己,不是给用户的免责声明)
- 只操作设备所有者本人的机器;本文所有操作都在用户明确指示下、针对用户自己的两台手机完成。
- 不做规避金融风控的「反检测」教程:root + Zygisk + Xposed 必然触发风控,正确建议是「敏感操作换一台未改动的设备」,而不是教怎么绕过。
- 不制造「隐私恐慌」:解释数据链路时给出机制(安装器云校验、统计 SDK、账号绑定、运营商层),而不是渲染「被监控」。
- 破坏性操作要有二次确认:刷机清数据、回锁、卸载系统组件,三者的确认必须显式,不接受「你看着办」。
- 保留可回滚物:原厂
init_boot.img、预装清单、还原脚本,缺一个就不该动手。
14. 本次环境、版本与时间线
| 组件 | 版本 | 备注 |
|---|---|---|
| HyperOS(warsaw 刷前/刷后) | OS3.0.309.0.WHPCNXM → OS4.0.6.0.XHPCNXM |
线刷包 11.08 GB,MD5 前缀 6a6101b221,anti_version=1 |
| HyperOS(nezha) | OS4.0.7.0.XPACNXM |
公库当时只有 4.0.5.0,故未 root |
| SukiSU-Ultra | v4.3.0-r2(管理器 41150) | nezha 为 r1(41140) |
| ksud | Windows 版取自 KernelSU v3.3.1;设备内 ksud -V 报 4.3.0-r2 (uapi: 6) |
boot-patch 打补丁用 |
| ZygiskNext | 1.5.3 | SHA256 186a0a26… |
| Vector | v2.2 | API 102,SHA256 9ee83235… |
| HyperPGuard | v1.8.0 | 133 KB,SHA256 0223b28d… |
| HyperCeiler | 2.10.166(OS3 分支) | 2026-03-31,最高适配 Android 16 |
时间线(压缩):
2026-11-12 10:54 检查设备 → MTP 认不出存储(未解锁屏幕/未选文件传输)
2026-11-12 11:00 开 USB 调试 → 读到身份:warsaw / M332BF / 电信定制 / BL 已解锁
2026-11-12 11:10 判定无全球版固件(多源交叉)
2026-11-12 11:35 OTA 卡刷失败(sideload 拒绝 + MIUI 拦注入)
2026-11-12 11:47 改线刷:11.08 GB → MD5 → 解压 → flash_all.bat → 4.0.6.0
2026-11-12 12:00 清理 24.35 GB 刷机残留
2026-11-12 12:10 卸 28 个渠道预装(69→41)
2026-11-12 12:15 SukiSU LKM root:抽 init_boot → ksud 补丁 → 刷 init_boot_a → 验证
2026-11-12 12:20 反诈 App 排查(结论:不存在,仅一条短信签名规则)
2026-11-12 12:25 402 包权限分析 → C 类处理(37 个第三方)
2026-11-12 12:30 ZygiskNext + Vector + HyperPGuard(18 作用域,注入日志确认)
2026-11-12 13:20 拒装微信来源的「隐私卫士」,说明两个同名项目的区别
2026-11-12 13:30 nezha:LSPosed 1.9.2 → Vector 迁移(旧模块全保住)
2026-11-12 13:50 68 应用迁移 → 67 成功(install-multiple)
2026-11-12 14:10 桌面布局迁移:DB 方案失败,改推官方备份
2026-11-17 10:30 微信选图黑框取证 → 缓存索引 0 字节 + HDR MPF 非标准容器
15. 结语:把流程迁移到别的机型
四句话:
- 身份优先:代号 + 版本平台段 + 型号三者吻合才动手;
verifiedbootstate决定你能做什么。 - root 走 LKM:
init_boot打补丁 + 匹配 KMI 的.ko+ 保留另一槽原厂镜像 = 可随时全身而退。 - 框架看 API:模块声明 102 就别用 93;能用 CLI 就别让用户点勾选框。
- 一切可逆:清单、脚本、原厂镜像三件套备齐,破坏性操作前先想「怎么退回去」。
剩下的,都是耐心和如实汇报。