apk-reverse – skill Dữ liệu & Khoa học cho agent AI

Bundled upstream support

Supporting files are included at skill-relative paths. See [UPSTREAM-NOTICE.md](UPSTREAM-NOTICE.md) for their pinned sources, licenses, hashes, and import changes.

Supporting material availability

These paths remain unavailable in this catalog copy:

• <support-root>/scripts/decode.ps1
• <support-root>/scripts/frida-run.ps1
• <support-root>/scripts/rebuild-sign-install.ps1

Do not invoke a step that requires one of these files. Obtain the original material and review its dependencies, license, and effects before use. Independent inline steps and the bundled helpers can proceed within the user’s authorized scope.

> ⚠️ AUTHORIZED USE ONLY

> This skill is for educational purposes or authorized security assessments only.

> You must have explicit, written permission from the system owner before using this tool.

> Misuse of this tool is illegal and strictly prohibited.

> Mandatory confirmation gate

> Before running any command that probes, exploits, changes, persists on, extracts data from, or attempts credential access against a target:

> 1. Ask the user to state the exact target URL, IP, account, or resource.

> 2. Ask the user to confirm written authorization and the permitted scope.

> 3. Show the exact command(s) and explain their expected effect.

> 4. Wait for explicit confirmation in the current conversation.

>

> Without that confirmation, remain read-only and provide defensive guidance only. Prefer a sandbox, disposable VM, or controlled lab.

When to Use

• Analyzing or modifying an Android APK during an authorized assessment.
• Hooking runtime behavior of an app you own or are cleared to test.

适用范围

当任务属于以下场景时优先使用本 skill：

• 分析 APK 的 Java 业务逻辑
• 定位登录、签名、风控、证书校验、root 检测
• 查看与修改 AndroidManifest.xml
• 查看与修改 smali
• 重打包 APK
• 用 Frida 做 Java/native 动态 Hook
• APK 内含 .so 时切到 native 分析

上游环境工具记录（不代表当前机器已验证）

• jadx 1.5.5
• apktool 3.0.2
• frida-ps 17.9.6
• adb
• java

优先使用脚本的场景

以下流程高频且参数容易出错，优先用 skill 自带脚本：

• 一次性完成 jadx + apktool 落盘并产出摘要：scripts/decode.ps1
• Frida 设备检查、进程列举、spawn/attach 注入：scripts/frida-run.ps1
• 重建、对齐、签名、安装 APK：scripts/rebuild-sign-install.ps1
• 快速抽取 Manifest 关键组件与权限：scripts/manifest-summary.ps1

以下一行命令保持直接调用，不单独封装：

• adb devices
• adb logcat
• frida-ps -U
• jadx --version
• apktool --version

自带脚本

scripts/decode.ps1

用途：

• 统一跑 jadx 和 apktool
• 默认在原 APK 同目录创建任务输出目录
• 输出 package、java_files、smali_dirs、so_files 等摘要
• 兼容 jadx 部分反编译错误但仍然有可用产物的情况

示例：

pwsh -File "<skill-root>\apk-reverse\scripts\decode.ps1" -ApkPath "D:\DOWNLOAD\app.apk" -Clean
pwsh -File "<skill-root>\apk-reverse\scripts\decode.ps1" -ApkPath "D:\DOWNLOAD\app.apk" -Name demo -SkipJadx

scripts/frida-run.ps1

用途：

• 统一 Frida 的设备、进程、spawn/attach 入口
• 避免手写参数时混淆 -f、-n、-U

示例：

pwsh -File "<skill-root>\apk-reverse\scripts\frida-run.ps1" -ListDevices
pwsh -File "<skill-root>\apk-reverse\scripts\frida-run.ps1" -Usb -ListProcesses
pwsh -File "<skill-root>\apk-reverse\scripts\frida-run.ps1" -Usb -Spawn -Package com.example.app -ScriptPath "D:\hooks\test.js"

scripts/rebuild-sign-install.ps1

用途：

• apktool b 重建 APK
• zipalign 对齐
• apksigner 签名与验签
• 可选直接 adb install

示例：

pwsh -File "<skill-root>\apk-reverse\scripts\rebuild-sign-install.ps1" -ProjectDir "C:\work\apktool_out" -Clean
pwsh -File "<skill-root>\apk-reverse\scripts\rebuild-sign-install.ps1" -ProjectDir "C:\work\apktool_out" -Install -Reinstall -DeviceSerial "127.0.0.1:7555"

说明：

• 默认生成并复用调试 keystore
• 默认输出到 ProjectDir 同目录，便于和原始包、解包目录放在一起

scripts/manifest-summary.ps1

用途：

• 抽取包名
• 列权限
• 列 activity/service/receiver/provider
• 标出主启动 activity

示例：

pwsh -File "<skill-root>\apk-reverse\scripts\manifest-summary.ps1" -ManifestPath "C:\work\apktool_out\AndroidManifest.xml"

如果要分析 .so、lib/arm64-v8a/*.so、lib/armeabi-v7a/*.so，再结合：

• ida-reverse
• radare2

工具分工

jadx

用于：

• Java 反编译阅读
• 包名、类名、方法名搜索
• 先从高层逻辑理解 APK

常用命令：

jadx -d jadx_out app.apk
jadx --single-class com.example.LoginActivity -d jadx_out app.apk
jadx --deobf -d jadx_out app.apk

JEB Pro（可选商业工具）

用于：

• Android DEX / APK / ARM 的交叉验证与深度反编译
• 在 JADX 输出不完整或混淆较重时补充静态分析
• 对同一目标的类、方法与调用关系进行第二工具链校验

边界：

• JEB Pro 是商业软件，必须由用户自行取得并安装有效许可证；本包不会下载、破解或规避许可。
• 仅在 tool-index 已确认本机 JEB 可用时调用；否则继续使用 jadx、apktool、Ghidra、IDA 或 radare2。
• 第三方 JEB MCP bridge 不是本包依赖。安装前必须按 ../ops/skill-supply-chain.md 审阅源码、权限、网络行为和版本，再由用户明确确认注册。

apktool

用于：

• 解包 APK
• 查看和修改 AndroidManifest.xml
• 查看和修改 smali
• 重建 APK

常用命令：

apktool d app.apk -o apktool_out
apktool b apktool_out -o rebuilt.apk

frida

用于：

• 动态观察 Java 方法调用
• Hook native 导出函数
• 绕过 root 检测、证书校验、调试检测

常用命令：

frida-ps -U
frida -U -f com.example.app -l hook.js
frida-trace -U -f com.example.app -j '*!*certificate*'

adb

用于：

• 设备连接
• 安装 APK
• 查看日志
• 拉取文件

常用命令：

adb devices
adb install -r app.apk
adb shell pm list packages
adb logcat
adb pull /data/local/tmp/file .

推荐工作流

1. Triage

先确定 APK 大致构成，不急着改包或 Hook。

建议动作：

1. 用 jadx -d jadx_out app.apk 导出 Java 代码

2. 用 apktool d app.apk -o apktool_out 导出 smali 和资源

3. 先看：

• AndroidManifest.xml
• 主 package
• application、activity、service、receiver
• lib/ 目录里是否有 .so

4. Issue #65 威胁形态速查（授权样本/设备；详见 ../reverse-engineering/references/nonpe-format-cookbook.md §7–8）：

• 透明/隐藏图标（AU）：aapt dump badging + manifest theme/label/icon → E-android-hidden-icon-manifest
• Magisk/脚本格机特征与远程 curl|sh（AR/AS）→ 特征与 URL 入证，不执行破坏命令 <!-- security-allowlist: curl-pipe-bash -->
• 持久化路径（AT）：service.d / priv-app 等 → E-android-persistence

2. Java 逻辑观察

优先从 jadx_out 读：

• MainActivity
• Application
• 登录、网络、加密、风控相关类
• 第三方 SDK 初始化类

常见关键词：

• login
• sign
• encrypt
• cipher
• token
• root
• certificate
• trust
• okhttp
• retrofit
• webview

如果 Java 代码可读，先在这里定位业务逻辑。

3. Smali 与资源层确认

当 jadx 结果不完整、混淆重、或需要实际 patch 时，切到 apktool_out：

• 看 smali*/
• 看 res/values/strings.xml
• 看 AndroidManifest.xml

优先 patch：

• android:exported
• 调试标记
• root 检测返回值
• 登录验证逻辑
• 证书校验分支

4. 重建与安装

修改后：

apktool b apktool_out -o rebuilt.apk

或者直接用脚本闭环：

pwsh -File "<skill-root>\apk-reverse\scripts\rebuild-sign-install.ps1" -ProjectDir "apktool_out" -Install -Reinstall -DeviceSerial "127.0.0.1:7555"

说明：

• apktool 重建可能失败；必须验证实际输出，不能保证成功
• 若后续需要正式安装到设备，通常还需要签名流程
• 如果任务进入签名/对齐，补充 apksigner / zipalign

5. 动态 Hook

静态分析不足时，用 Frida：

• Hook 登录函数
• Hook OkHttp / Retrofit / WebView 关键点
• Hook javax.crypto、MessageDigest
• Hook root 检测函数
• Hook SSL pinning 逻辑

原则：

• 先 Hook Java 层，再看是否需要 native Hook
• 先打印参数与返回值，再决定是否主动修改返回值

建议：

• 简单一次性命令直接用 frida-*
• 需要稳定复用的注入流程优先走 scripts/frida-run.ps1

6. Native .so 分流

如果 APK 中包含关键 .so：

• 用 apktool 或 jadx 找到 lib/**/*.so
• 若只是导出符号、字符串、快速 triage，可用 radare2
• 若要长期深入分析、反编译、改名、类型恢复，用 ida-reverse

遇到这些信号要尽快切 native：

• Java 层只是 JNI 包装
• 核心签名逻辑不在 Java
• System.loadLibrary() 后关键逻辑消失
• 证书校验/风控在 .so 中

输出要求

最终至少说明：

• 入口组件与关键类
• 关键逻辑在 Java、smali 还是 .so
• 已确认的敏感点：登录、签名、root、SSL、WebView、JNI
• 如果做了 patch，说明改了什么
• 如果做了 Hook，说明 Hook 了哪个类/方法/导出函数

禁止事项

• 不要一开始就盲目改 smali
• 不要在没看 manifest 和主入口前就写 Hook
• 不要把 Java 反编译不完整直接等同于“逻辑不可分析”
• 不要在 .so 明显承载核心逻辑时继续死磕 Java 层

快速命令备忘

# 反编译 Java

jadx -d jadx_out app.apk

# 解包 APK
apktool d app.apk -o apktool_out

# 重建 APK
apktool b apktool_out -o rebuilt.apk

# 设备与进程
adb devices
frida-ps -U

# 启动并注入
frida -U -f com.example.app -l hook.js

---

路由上下文

上游入口: skills/SKILL.md（总控）、routing.md

下游出口:

• 核心逻辑在 .so → ida-reverse/ 或 radare2/
• 需动态 Hook/验证 → reverse-engineering/tools-dynamic.md（Frida 章节）
• 通用逆向方法论 → reverse-engineering/SKILL.md

同级关联模块: reverse-engineering/（.so 分析和 Frida 进阶用法）

---

按需自举（On-Demand Bootstrap）

以下为上游自举系统说明。本目录不包含这些入口脚本或自举实现；不得假定自动安装可用。安装任何依赖前先审阅固定版本、来源和效果，并取得用户授权。

自动化能力边界

| 工具 | 可自动安装 | 安装方式 | 说明 |

|------|-----------|---------|------|

| jadx | ✓ | GitHub Release ZIP | 自动下载解压到 %USERPROFILE%\Tools\jadx\ |

| apktool | ✓ | GitHub Release JAR + wrapper | 自动下载 jar 并生成 bat 到 %USERPROFILE%\Tools\apktool\ |

| JEB Pro | ✗ | 用户手动安装并提供有效许可证 | 可选的 Android / ARM 交叉验证工具；第三方 MCP bridge 需单独审计 |

| frida / frida-ps | ✓ | pip install frida-tools | 需要 Python 已安装 |

| adb | ✓ | winget / fallback path | 自动安装 Android Platform-Tools |

| zipalign | ✗ | 需手动安装 Android Build-Tools | sdkmanager "build-tools;35.0.0" |

| apksigner | ✗ | 需手动安装 Android Build-Tools | 同上 |

自举触发点

• scripts/decode.ps1：缺 jadx 或 apktool 时自动调用 bootstrap-reverse.ps1
• scripts/rebuild-sign-install.ps1：缺 adb 或 apktool 时自动调用 bootstrap
• scripts/frida-run.ps1：当前仍为手动检查（frida 通常已通过 pip 安装）

自举失败时

如果自动安装失败，脚本会抛出明确错误并附带手动安装链接。常见原因：

• 网络不通（GitHub API / PyPI 不可达）
• winget 不可用（Windows 版本过低）
• Java 未安装（apktool 依赖 JDK）

任务完成自检（声称完成前

… (nội dung đầy đủ có trong gói tải về)