python 版 payload dumper 工具

刷机圈的工具老手都懂，从官方 ROM 里提取分区镜像是工具个体力活。以前用 Windows 下的工具 payload_dumper.exe，双击运行，工具等它吐出一堆 .img 文件。工具但换到 Linux 或 macOS 上，工具就得翻出老掉牙的工具 Python 2 脚本，或者干脆装个虚拟机。工具麻烦，工具真麻烦。工具

我写了个纯 Python 3 的工具 payload dumper，不到两百行，工具依赖只有一个标准库。工具没第三方包，工具没编译步骤，工具拷到任何有 Python 的机器上就能跑。解包速度嘛，拿小米的 MIUI 包试过，3GB 的 payload.bin，全分区解出来大概两分钟，比官方工具慢点，但胜在干净利落。

核心逻辑其实不复杂。payload 文件格式是 Google 定义的，头部有 magic number，跟着一堆 protobuf 编码的元数据。关键在差分算法——不是所有分区都是完整镜像，有些是 bsdiff 差分块。你得先读 manifest，搞清楚每个分区的操作类型，是 replace 还是 diff，然后按偏移量去拼原始数据。

我踩过的坑是差分块的处理。网上不少现成代码直接调 bsdiff 的 C 库，但那样就违背了“零依赖”的初衷。自己写了个纯 Python 的 bspatch 实现，虽然慢点，但胜在可控。有个细节：差分块里的 control 段是三元组，前两个是整数，第三个是额外数据长度。读的时候必须用 struct.unpack(">QQQ")，大端序，别搞反了，不然解出来的镜像直接损坏。

命令行界面也做得挺糙的，就两个参数：输入文件路径和输出目录。不加参数就打印帮助，加 --list 只看分区列表不解包。有次朋友拿它解 Pixel 的包，发现有个分区叫 vendor_boot，名字带下划线，我的正则没匹配上，直接跳过。后来改成先读全部分区名，再让用户用通配符过滤，这才算顺手。

说实话，这工具没多大技术含量，就是耐心活。但每次看到终端里刷出“Extracted boot.img in 3.2s”这种输出，心里还是有点爽。有人问我为啥不用现成的，我说现成的要么带 GUI 太重，要么依赖旧库跑不起来。自己写一个，想改就改，还能顺手加个进度条。

最后提个建议：如果你只是偶尔解包，直接用 GitHub 上 star 最多的那个项目就行。但如果想折腾或者有特殊需求，照着协议文档自己写一遍，比看别人代码快得多。毕竟 payload 格式又不会变，写一次能用好几年。