AI笔记本

折腾笔记

【AI 参考文章】给 AI Agent 的小米 HyperOS 实操手册:REDMI K90 Ultra 从解锁后到 Root + 框架 + 去预装

2026-11-17

读者:执行刷机/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 「有没有全球版」的判定方法 [实测]

结论:该机型没有海外固件。可复用判据:

  1. 拉 XiaomiFirmwareUpdater/miui-updates-tracker 的 devices.yml,grep 代号:只有 warsaw(China),无 warsaw_global / warsaw_eea_global;
  2. 对照同代机型:Redmi K90(annibale)有 6 个海外版,K80(zorn)海外版是 POCO F7 Pro —— 说明「没有海外版」是机型策略,不是搜索失败;
  3. 设备侧 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 三条纪律

  1. 哈希先行:文件名带哈希的包,先算 MD5/SHA256 再谈刷。本次线刷包名尾 6a6101b221、卡刷包名尾 220d1ce4e3,实测比对通过 [实测]。
  2. 能抽就不重下:需要原厂 init_boot.img 时,不要下 11 GB 线刷包——用 payload-dumper-go 从已下载的 9 GB OTA 包里抽 8 MB [实测]。
  3. 同名不同物要查源码:用户要装「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 硬规则

  1. 刷机前必须显式取得「数据会全没」的确认——本次连问两次(用户先选「保数据升级」,失败后才改选线刷)。
  2. 不要顺手回锁。回锁前必须保证所有分区都是官方且无残留,否则可能直接不开机;本次明确拒绝执行 flash_all_lock.bat。
  3. 刷完清理下载物前先核对路径:Resolve-Path 拿绝对路径 + 列出待删内容,确认目录内只有自建文件再删(本次删 D:\rom 24.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)。替换步骤:

  1. ksud module install Vector-2.2.zip;
  2. 不删旧模块,只写 disable 标记:touch /data/adb/modules/zygisk_lsposed/disable(可逆);
  3. 重启 → 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 三条可逆工程规范

  1. 先备份清单再动手:pm list packages -3 -f 存成 warsaw_preloads_backup.txt(含安装路径);
  2. 生成还原脚本:warsaw_restore_preloads.ps1 里 38 个包,install-existing + pm enable 一条命令全部回来;
  3. 区分「卸载」与「禁用」:独立推广 App 卸载,系统服务只禁用(避免框架调用缺失组件时报错)。

7.4 一个必须纠正的预期

/cust 是只读分区,APK 本体删不掉(没 root 也不行)。卸载只清了用户数据与沙箱,因此 /data 占用变化不明显 —— 这不是「没删干净」。恢复出厂或某些 OTA 后,这些预装可能自己回来,届时跑还原脚本的反向操作。

7.5 「删掉 X」的排查模板 [实测]

用户要求「删除国家反诈 App」。处置流程可直接复用:

  1. pm path com.hicorenational.antifraud → 空;
  2. 402 个包全量匹配 fraud|hicore|antifraud|gov|police → 0 命中;
  3. 全盘 find /product /system_ext /cust /data/app → 0 命中;
  4. root 下 grep /data/system/packages.xml → 无记录;
  5. 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。尝试路径与结论:

  1. 定位数据库:/data/user_de/0/com.miui.home/databases/launcher4x6.db(注意是 user_de,不是 user/0);
  2. 对比 schema:两端表结构不同(warsaw 多 extendContainer、isOnlySupportExtend 两列)→ 直接拷库必崩;
  3. 改走低风险:不换库,只按 nezha 的 (screen, cellX, cellY, container) 重排 warsaw 现有图标;
  4. 写入后 am force-stop com.miui.home 让桌面重建;
  5. 结果:桌面把写入「规范化」了 —— 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 结论(按可能性排序)

  1. 微信自身缩略图缓存索引损坏(最可能):/sdcard/Android/data/com.tencent.mm/cache/imgcache/cache.data* 5 个文件全 0 字节,微信用了 4 个多月,属异常状态;
  2. Xiaomi Ultra HDR 多图 JPEG 兼容性:1660 张相机 JPG 里 1126 张(68%) 是 hdrgm + MPF 容器,且非标准写法——主图 JPEG 之后追加的增益图是 PNG(文件尾是 IEND,不是 FFD9),很多第三方解码器只能读出「主图不完整」→ 画黑格;
  3. 杜比视界视频封面抽帧失败:105 个 *_DOLBY.mp4,微信启动日志明写 Unsupported mime video/dolby-vision;
  4. 两亿像素照片(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 修复建议(分层给,不打包票)

  1. 微信 → 设置 → 通用 → 存储空间 → 清理缓存(不动聊天记录)→ 强杀重开;
  2. 对 HDR 照片做一次「编辑→保存」导出普通 JPEG,或关掉相机的 HDR/超清保存;
  3. 杜比视界视频先转 H.264 再发;
  4. 仍不行:关深色模式 → 最后才考虑重装(先备份聊天记录)。

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 自己,不是给用户的免责声明)

  1. 只操作设备所有者本人的机器;本文所有操作都在用户明确指示下、针对用户自己的两台手机完成。
  2. 不做规避金融风控的「反检测」教程:root + Zygisk + Xposed 必然触发风控,正确建议是「敏感操作换一台未改动的设备」,而不是教怎么绕过。
  3. 不制造「隐私恐慌」:解释数据链路时给出机制(安装器云校验、统计 SDK、账号绑定、运营商层),而不是渲染「被监控」。
  4. 破坏性操作要有二次确认:刷机清数据、回锁、卸载系统组件,三者的确认必须显式,不接受「你看着办」。
  5. 保留可回滚物:原厂 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. 结语:把流程迁移到别的机型

四句话:

  1. 身份优先:代号 + 版本平台段 + 型号三者吻合才动手;verifiedbootstate 决定你能做什么。
  2. root 走 LKM:init_boot 打补丁 + 匹配 KMI 的 .ko + 保留另一槽原厂镜像 = 可随时全身而退。
  3. 框架看 API:模块声明 102 就别用 93;能用 CLI 就别让用户点勾选框。
  4. 一切可逆:清单、脚本、原厂镜像三件套备齐,破坏性操作前先想「怎么退回去」。

剩下的,都是耐心和如实汇报。