小米payload解包工具

小米手机解BL锁后，小米刷机包里的解具payload.bin是个硬骨头。这玩意儿不是包工普通zip，里面塞了一堆稀疏镜像，小米直接解压全是解具乱码。官方工具只给Windows用，包工Linux和macOS用户只能干瞪眼。小米我花了三个晚上写了个Python脚本，解具现在把它解包成可刷写的包工img文件，全程不用装额外依赖。小米 核心逻辑其实就三步：解析头部索引表，解具按偏移量切出数据块，包工再处理稀疏格式。小米payload.bin头部有固定的解具magic数"payload"，后面跟着manifest protobuf，包工里面记录了每个分区的名称、大小、校验值和偏移量。Python的struct模块就能读，不用搞什么重型库。 写代码时最坑的是稀疏格式。小米用的是Android sparse image，每个chunk头有5个uint32字段。如果直接按原始偏移量切分，刷进去会损坏分区表。必须识别chunk_type为0xCAC1的普通数据块和0xCAC2的跳过块，前者直接写入，后者用空洞填充。我测试时第一次没处理跳过块，刷完系统直接无限重启，后来对比了官方payload-dumper-go的源码才发现问题。 解包速度也值得说道。我拿Redmi K70的hyperOS 2.0包测试，2.8GB的payload，纯Python跑完要47秒。瓶颈在hashlib校验——payload里每个分区都有sha256，校验整包会拖慢速度。我加了--skip-hash参数跳过校验，时间降到18秒。但默认还是开着校验，毕竟解包出错刷进去变砖更麻烦。 实际使用中还有个小技巧。payload.bin里经常包含两个相同名字的分区，比如vendor和vendor_bak。解包时不能只按名字存文件，否则会互相覆盖。我在输出文件名里加了索引后缀，vendor_0.img和vendor_1.img，这样想回刷旧版本固件时能精准挑出需要的分区。 最后说下适用范围。这个脚本只支持小米HyperOS和MIUI的payload v2格式，v1格式的头部结构不同。老机型如果payload版本号是1，直接用会报"unknown magic"错误。我加了个自动检测逻辑，遇到v1会提示用户用官方工具。代码放在GitHub上了，搜"xiaomi_payload_unpacker"就能找到，MIT协议随便用。 工具链这东西，自己造一次轮子，以后刷机就再不用求人。遇到新机型只要不是改版格式，基本都能通吃。现在刷第三方ROM的社区里，已经有人用我的脚本做分包移植了，省得每次全量解包。