“done“的六项标准：apk-reverse的验证与声明阶梯深入解读

"done"的六项标准：apk-reverse的验证与声明阶梯深入解读

【免费下载链接】apk-reverseSuitable for Android APK reverse engineering analysis项目地址: https://gitcode.com/gh_mirrors/ap/apk-reverse

apk-reverse 是一套面向 Android APK 逆向工程的 Agent 技能仓库，覆盖 dex 补丁、重打包签名、动态分析、广告移除与服务端行为判定等完整工作流。它最独特的地方，不是教你怎么改一个字节，而是明确规定：什么时候才允许说"做完了"。这篇文章带你读懂它的"done"六项标准，以及从第 0 级到第 7 级的声明阶梯（claim ladder）。

为什么"能编译"不等于"done"

做 Android 逆向最常踩的坑，就是过早宣布胜利。仓库里 pitfalls.md 记录的失败案例反复指向同一个现象：

一个补丁"组装成功"、"进程启动了"、"日志干干净净"——但功能根本没变，甚至悄悄弄坏了别的功能。

所以 SKILL.md 把"done"写死成一条规则：六项标准全部为真之前，任何结果都只是 checkpoint（检查点），必须大声标明还差什么。过早的"done"是最有破坏性的汇报，因为它会让使用者以为问题已解决，调查就此中止。

"done"的六项标准逐项解读

以下六条出自 SKILL.md 的What "done" means章节，缺一不可：

一个特别的细节：如果 1–4 都满足、但环境不对，那你手里的是一个prototype（原型），不是交付物——要明说"prototype"并指出差距在哪。

💡 核心思想："done" 指的是用户可见的结果。哪怕日志再干净，只要屏幕上还挂着一个阻塞弹窗，任务就没有完成。

声明阶梯（claim ladder）：0 到 7 级

如果说六项标准是"及格线"，那 verification.md 里的声明阶梯则是"证据等级表"。每一级比上一级证据更强，你要爬多高取决于任务要求，并且必须明确说出你爬到了哪一级：

各级的最低要求值得记住：

• 第 3 级是任何交付物的下限；
• 第 4 级才能声称"补丁解决了问题"；
• 第 5 级之前不能把产物交给用户；
• 第 6 级用于"子系统已死"这种强声明，而不只是"广告被藏起来了"；
• 第 7 级在产物离开你机器的任何时候都必须做到——上传可能截断文件、流水线可能重新签名，下载的人无从知道。

三个容易漏掉的验证细节

1. 结构检查有盲区。dex_classdiff.py 能通过不代表代码没坏——整树 smali 往返可以在所有表检查全绿的情况下，仍触发运行时崩溃。真正能看更深的检查（指令长度审计、等长替换盲区、验证器合法性）在 patch-audit.md。

2. 先跑对照组再怪补丁。出了问题时，用同一条流水线做一个零补丁的对照构建（repack.py）。对照失败 → 是流水线/环境/设备的问题；对照通过、打了补丁的失败 → 才轮到你二分排查。

3. 截图要看过才算数。行为验证要求"打开有广告的每个页面"、"把被 gate 住的流程走一遍"，并检查相邻功能。启动后约 20 秒内连续截图（snap.py）并且真的去看图——没被查看过的一堆截图不是证据，这条被写进了 SKILL.md 的不可妥协约束表。

报告模板：一次"done"汇报长什么样

verification.md 给出了一份固定的汇报骨架，把它当成 checklist 用即可：

Build: <路径> <sha256> Base: <原始 apk 名称/版本> Changes: <每个 dex 改了什么，一行一条> Structural: dex_classdiff 结果（逐个 dex） Signature: 签名校验详情，报告原始命令而不是"ok" Device: <机型 / 安卓版本 / ABI / 是否 root> Runtime: 进程 N 秒内 pid 稳定；无致命特征 Behavior: <实测的界面>，<前后对比> Regressions: <检查过的相邻功能> Distribution: 重新下载，sha256 与测试版本一致 Rung reached: 0..7 Residual: <哪些没修好，以及确切原因>

注意最后两项：爬到的阶梯级别和残留问题。原文的强调很到位——"广告 X 仍然存在，因为它随界面主数据下发，在传输层压掉会带崩整个界面"是有用的诚实结果；偷偷省略它不是。

延伸阅读 📚

想继续深入这套"验证哲学"，可以从这几个文件入手：

• 入口与六项标准全文：skills/apk-reverse/SKILL.md
• 声明阶梯与报告模板：skills/apk-reverse/references/verification.md
• 补丁是否落地、是否合法的审计方法：skills/apk-reverse/references/patch-audit.md
• 每条能力声明的证据强度（observed / inferred / unverified）：skills/apk-reverse/references/coverage-and-limits.md
• 真实目标上的实测记录：docs/tool-verification/README.md
• 失败案例目录（读完再动手）：skills/apk-reverse/references/pitfalls.md

一句话总结：apk-reverse 把"做完了"从一句口号变成了可执行的检查流程——六项标准守底线，八级阶梯定证据，报告模板留尾巴。下次你准备说"done"时，先问问自己爬到了第几级。

【免费下载链接】apk-reverseSuitable for Android APK reverse engineering analysis项目地址: https://gitcode.com/gh_mirrors/ap/apk-reverse