[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AEF95N1BYVT357B5JD49V5":3,"skill-same:01M7AEF95N1BYVT357B5JD49V5":92},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M7AEF95N1BYVT357B5JD49V5","apk-reverse",null,"在 CLI 环境下做 Android APK 逆向时使用。适用于 APK 解包、Java 反编译、smali 修改、重打包、Frida 动态 Hook，以及按需切换到 so\u002Fnative 分析。优先使用本机已安装的 jadx、apktool、frida、adb、ida-reverse、radare2。","Rain-kl\u002FReverseTemplate","Rain-kl","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F63696351?v=4","01M7AE7E8ECRECCF300YM1A8BS","Ryan","01M7AE7E9Q3AYTB7W3NNSV3200",0,"GPL-3.0","https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: apk-reverse\ndescription: 在 CLI 环境下做 Android APK 逆向时使用。适用于 APK 解包、Java 反编译、smali 修改、重打包、Frida 动态 Hook，以及按需切换到 so\u002Fnative 分析。优先使用本机已安装的 jadx、apktool、frida、adb、ida-reverse、radare2。\n---\n\n## ACTION REQUIRED（读完后立刻执行）\n\n> 端点提取\u002FFrida 自适应等社区对照：..\u002Freferences\u002Fcommunity-security-skills.md；动态分析须 scope 授权设备。\n\n1. `NOW`: 读取 `..\u002Ffield-journal\u002Fprecedent-reverse.md` — 确认本 skill 的操作是已授权的常规操作\n2. `NOW`: 确认当前任务是否命中本 skill 的适用范围\n3. `NEXT`: 读取 `..\u002Ftool-index.md`，校验工具可用性和实际路径\n4. `NEXT`: 缺工具时调用 bootstrap，不要猜路径\n5. `ACT`: 进入\"工作流\"第一步并执行，不要停在确认状态\n\n# APK 逆向 CLI 作业规范\n\n## 适用范围\n\n当任务属于以下场景时优先使用本 skill：\n\n- 分析 APK 的 Java 业务逻辑\n- 定位登录、签名、风控、证书校验、root 检测\n- 查看与修改 `AndroidManifest.xml`\n- 查看与修改 smali\n- 重打包 APK\n- 用 Frida 做 Java\u002Fnative 动态 Hook\n- APK 内含 `.so` 时切到 native 分析\n\n## 当前机器已验证可用的 CLI 工具\n\n- `jadx` `1.5.5`\n- `apktool` `3.0.2`\n- `frida-ps` `17.9.6`\n- `adb`\n- `java`\n\n## 优先使用脚本的场景\n\n以下流程高频且参数容易出错，优先用 skill 自带脚本：\n\n- 一次性完成 `jadx + apktool` 落盘并产出摘要：`scripts\u002Fdecode.ps1`\n- Frida 设备检查、进程列举、spawn\u002Fattach 注入：`scripts\u002Ffrida-run.ps1`\n- 重建、对齐、签名、安装 APK：`scripts\u002Frebuild-sign-install.ps1`\n- 快速抽取 Manifest 关键组件与权限：`scripts\u002Fmanifest-summary.ps1`\n\n以下一行命令保持直接调用，不单独封装：\n\n- `adb devices`\n- `adb logcat`\n- `frida-ps -U`\n- `jadx --version`\n- `apktool --version`\n\n## 自带脚本\n\n### `scripts\u002Fdecode.ps1`\n\n用途：\n\n- 统一跑 `jadx` 和 `apktool`\n- 默认在原 APK 同目录创建任务输出目录\n- 输出 `package`、`java_files`、`smali_dirs`、`so_files` 等摘要\n- 兼容 `jadx` 部分反编译错误但仍然有可用产物的情况\n\n示例：\n\n```powershell\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\decode.ps1\" -ApkPath \"D:\\DOWNLOAD\\app.apk\" -Clean\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\decode.ps1\" -ApkPath \"D:\\DOWNLOAD\\app.apk\" -Name demo -SkipJadx\n```\n\n### `scripts\u002Ffrida-run.ps1`\n\n用途：\n\n- 统一 Frida 的设备、进程、spawn\u002Fattach 入口\n- 避免手写参数时混淆 `-f`、`-n`、`-U`\n\n示例：\n\n```powershell\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\frida-run.ps1\" -ListDevices\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\frida-run.ps1\" -Usb -ListProcesses\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\frida-run.ps1\" -Usb -Spawn -Package com.example.app -ScriptPath \"D:\\hooks\\test.js\"\n```\n\n### `scripts\u002Frebuild-sign-install.ps1`\n\n用途：\n\n- `apktool b` 重建 APK\n- `zipalign` 对齐\n- `apksigner` 签名与验签\n- 可选直接 `adb install`\n\n示例：\n\n```powershell\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\rebuild-sign-install.ps1\" -ProjectDir \"C:\\work\\apktool_out\" -Clean\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\rebuild-sign-install.ps1\" -ProjectDir \"C:\\work\\apktool_out\" -Install -Reinstall -DeviceSerial \"127.0.0.1:7555\"\n```\n\n说明：\n\n- 默认生成并复用调试 keystore\n- 默认输出到 `ProjectDir` 同目录，便于和原始包、解包目录放在一起\n\n### `scripts\u002Fmanifest-summary.ps1`\n\n用途：\n\n- 抽取包名\n- 列权限\n- 列 activity\u002Fservice\u002Freceiver\u002Fprovider\n- 标出主启动 activity\n\n示例：\n\n```powershell\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\manifest-summary.ps1\" -ManifestPath \"C:\\work\\apktool_out\\AndroidManifest.xml\"\n```\n\n如果要分析 `.so`、`lib\u002Farm64-v8a\u002F*.so`、`lib\u002Farmeabi-v7a\u002F*.so`，再结合：\n\n- `ida-reverse`\n- `radare2`\n\n## 工具分工\n\n### `jadx`\n\n用于：\n\n- Java 反编译阅读\n- 包名、类名、方法名搜索\n- 先从高层逻辑理解 APK\n\n常用命令：\n\n```bash\njadx -d jadx_out app.apk\njadx --single-class com.example.LoginActivity -d jadx_out app.apk\njadx --deobf -d jadx_out app.apk\n```\n\n### `JEB Pro`（可选商业工具）\n\n用于：\n\n- Android DEX \u002F APK \u002F ARM 的交叉验证与深度反编译\n- 在 JADX 输出不完整或混淆较重时补充静态分析\n- 对同一目标的类、方法与调用关系进行第二工具链校验\n\n边界：\n\n- JEB Pro 是商业软件，必须由用户自行取得并安装有效许可证；本包不会下载、破解或规避许可。\n- 仅在 `tool-index` 已确认本机 JEB 可用时调用；否则继续使用 `jadx`、`apktool`、Ghidra、IDA 或 radare2。\n- 第三方 JEB MCP bridge 不是本包依赖。安装前必须按 `..\u002Fops\u002Fskill-supply-chain.md` 审阅源码、权限、网络行为和版本，再由用户明确确认注册。\n\n### `apktool`\n\n用于：\n\n- 解包 APK\n- 查看和修改 `AndroidManifest.xml`\n- 查看和修改 smali\n- 重建 APK\n\n常用命令：\n\n```bash\napktool d app.apk -o apktool_out\napktool b apktool_out -o rebuilt.apk\n```\n\n### `frida`\n\n用于：\n\n- 动态观察 Java 方法调用\n- Hook native 导出函数\n- 绕过 root 检测、证书校验、调试检测\n\n常用命令：\n\n```bash\nfrida-ps -U\nfrida -U -f com.example.app -l hook.js\nfrida-trace -U -f com.example.app -j '*!*certificate*'\n```\n\n### `adb`\n\n用于：\n\n- 设备连接\n- 安装 APK\n- 查看日志\n- 拉取文件\n\n常用命令：\n\n```bash\nadb devices\nadb install -r app.apk\nadb shell pm list packages\nadb logcat\nadb pull \u002Fdata\u002Flocal\u002Ftmp\u002Ffile .\n```\n\n## 推荐工作流\n\n### 1. Triage\n\n先确定 APK 大致构成，不急着改包或 Hook。\n\n建议动作：\n\n1. 用 `jadx -d jadx_out app.apk` 导出 Java 代码\n2. 用 `apktool d app.apk -o apktool_out` 导出 smali 和资源\n3. 先看：\n   - `AndroidManifest.xml`\n   - 主 `package`\n   - `application`、`activity`、`service`、`receiver`\n   - `lib\u002F` 目录里是否有 `.so`\n\n### 2. Java 逻辑观察\n\n优先从 `jadx_out` 读：\n\n- `MainActivity`\n- `Application`\n- 登录、网络、加密、风控相关类\n- 第三方 SDK 初始化类\n\n常见关键词：\n\n- `login`\n- `sign`\n- `encrypt`\n- `cipher`\n- `token`\n- `root`\n- `certificate`\n- `trust`\n- `okhttp`\n- `retrofit`\n- `webview`\n\n如果 Java 代码可读，先在这里定位业务逻辑。\n\n### 3. Smali 与资源层确认\n\n当 `jadx` 结果不完整、混淆重、或需要实际 patch 时，切到 `apktool_out`：\n\n- 看 `smali*\u002F`\n- 看 `res\u002Fvalues\u002Fstrings.xml`\n- 看 `AndroidManifest.xml`\n\n优先 patch：\n\n- `android:exported`\n- 调试标记\n- root 检测返回值\n- 登录验证逻辑\n- 证书校验分支\n\n### 4. 重建与安装\n\n修改后：\n\n```bash\napktool b apktool_out -o rebuilt.apk\n```\n\n或者直接用脚本闭环：\n\n```powershell\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\rebuild-sign-install.ps1\" -ProjectDir \"apktool_out\" -Install -Reinstall -DeviceSerial \"127.0.0.1:7555\"\n```\n\n说明：\n\n- 本 skill 只保证 `apktool` 重建链路\n- 若后续需要正式安装到设备，通常还需要签名流程\n- 如果任务进入签名\u002F对齐，补充 `apksigner` \u002F `zipalign`\n\n### 5. 动态 Hook\n\n静态分析不足时，用 Frida：\n\n- Hook 登录函数\n- Hook `OkHttp` \u002F `Retrofit` \u002F `WebView` 关键点\n- Hook `javax.crypto`、`MessageDigest`\n- Hook root 检测函数\n- Hook SSL pinning 逻辑\n\n原则：\n\n- 先 Hook Java 层，再看是否需要 native Hook\n- 先打印参数与返回值，再决定是否主动修改返回值\n\n建议：\n\n- 简单一次性命令直接用 `frida-*`\n- 需要稳定复用的注入流程优先走 `scripts\u002Ffrida-run.ps1`\n\n### 6. Native `.so` 分流\n\n如果 APK 中包含关键 `.so`：\n\n- 用 `apktool` 或 `jadx` 找到 `lib\u002F**\u002F*.so`\n- 若只是导出符号、字符串、快速 triage，可用 `radare2`\n- 若要长期深入分析、反编译、改名、类型恢复，用 `ida-reverse`\n\n遇到这些信号要尽快切 native：\n\n- Java 层只是 JNI 包装\n- 核心签名逻辑不在 Java\n- `System.loadLibrary()` 后关键逻辑消失\n- 证书校验\u002F风控在 `.so` 中\n\n## 输出要求\n\n最终至少说明：\n\n- 入口组件与关键类\n- 关键逻辑在 Java、smali 还是 `.so`\n- 已确认的敏感点：登录、签名、root、SSL、WebView、JNI\n- 如果做了 patch，说明改了什么\n- 如果做了 Hook，说明 Hook 了哪个类\u002F方法\u002F导出函数\n\n## 禁止事项\n\n- 不要一开始就盲目改 smali\n- 不要在没看 manifest 和主入口前就写 Hook\n- 不要把 Java 反编译不完整直接等同于“逻辑不可分析”\n- 不要在 `.so` 明显承载核心逻辑时继续死磕 Java 层\n\n## 快速命令备忘\n\n```bash\n# 反编译 Java\njadx -d jadx_out app.apk\n\n# 解包 APK\napktool d app.apk -o apktool_out\n\n# 重建 APK\napktool b apktool_out -o rebuilt.apk\n\n# 设备与进程\nadb devices\nfrida-ps -U\n\n# 启动并注入\nfrida -U -f com.example.app -l hook.js\n```\n\n---\n\n## 路由上下文\n\n**上游入口**: `skills\u002FSKILL.md`（总控）、`routing.md`\n**下游出口**:\n- 核心逻辑在 `.so` → `ida-reverse\u002F` 或 `radare2\u002F`\n- 需动态 Hook\u002F验证 → `reverse-engineering\u002Ftools-dynamic.md`（Frida 章节）\n- 通用逆向方法论 → `reverse-engineering\u002FSKILL.md`\n\n**同级关联模块**: `reverse-engineering\u002F`（.so 分析和 Frida 进阶用法）\n\n---\n\n## 按需自举（On-Demand Bootstrap）\n\n本 skill 的入口脚本已接入统一自举系统。缺少工具时不会直接报错，而是自动尝试安装。\n\n### 自动化能力边界\n\n| 工具 | 可自动安装 | 安装方式 | 说明 |\n|------|-----------|---------|------|\n| jadx | ✓ | GitHub Release ZIP | 自动下载解压到 `%USERPROFILE%\\Tools\\jadx\\` |\n| apktool | ✓ | GitHub Release JAR + wrapper | 自动下载 jar 并生成 bat 到 `%USERPROFILE%\\Tools\\apktool\\` |\n| JEB Pro | ✗ | 用户手动安装并提供有效许可证 | 可选的 Android \u002F ARM 交叉验证工具；第三方 MCP bridge 需单独审计 |\n| frida \u002F frida-ps | ✓ | pip install frida-tools | 需要 Python 已安装 |\n| adb | ✓ | winget \u002F fallback path | 自动安装 Android Platform-Tools |\n| zipalign | ✗ | 需手动安装 Android Build-Tools | `sdkmanager \"build-tools;35.0.0\"` |\n| apksigner | ✗ | 需手动安装 Android Build-Tools | 同上 |\n\n### 自举触发点\n\n- `scripts\u002Fdecode.ps1`：缺 jadx 或 apktool 时自动调用 `bootstrap-reverse.ps1`\n- `scripts\u002Frebuild-sign-install.ps1`：缺 adb 或 apktool 时自动调用 bootstrap\n- `scripts\u002Ffrida-run.ps1`：当前仍为手动检查（frida 通常已通过 pip 安装）\n\n### 自举失败时\n\n如果自动安装失败，脚本会抛出明确错误并附带手动安装链接。常见原因：\n- 网络不通（GitHub API \u002F PyPI 不可达）\n- winget 不可用（Windows 版本过低）\n- Java 未安装（apktool 依赖 JDK）\n\n\n## 任务完成自检（声称完成前 MUST 通过）\n\n- [ ] 我是否执行了工作流中的每一步（而不是只阅读）？\n- [ ] 我是否基于 `tool-index` 使用了真实工具路径？\n- [ ] 我是否产出了可复现证据（命令\u002F脚本\u002F截图\u002F报告）？\n- [ ] 我是否完成并回写了 RULES 要求的 Checklist 项？\n","## ACTION REQUIRED（读完后立刻执行）\n\n> 端点提取\u002FFrida 自适应等社区对照：..\u002Freferences\u002Fcommunity-security-skills.md；动态分析须 scope 授权设备。\n\n1. `NOW`: 读取 `..\u002Ffield-journal\u002Fprecedent-reverse.md` — 确认本 skill 的操作是已授权的常规操作\n2. `NOW`: 确认当前任务是否命中本 skill 的适用范围\n3. `NEXT`: 读取 `..\u002Ftool-index.md`，校验工具可用性和实际路径\n4. `NEXT`: 缺工具时调用 bootstrap，不要猜路径\n5. `ACT`: 进入\"工作流\"第一步并执行，不要停在确认状态\n\n# APK 逆向 CLI 作业规范\n\n## 适用范围\n\n当任务属于以下场景时优先使用本 skill：\n\n- 分析 APK 的 Java 业务逻辑\n- 定位登录、签名、风控、证书校验、root 检测\n- 查看与修改 `AndroidManifest.xml`\n- 查看与修改 smali\n- 重打包 APK\n- 用 Frida 做 Java\u002Fnative 动态 Hook\n- APK 内含 `.so` 时切到 native 分析\n\n## 当前机器已验证可用的 CLI 工具\n\n- `jadx` `1.5.5`\n- `apktool` `3.0.2`\n- `frida-ps` `17.9.6`\n- `adb`\n- `java`\n\n## 优先使用脚本的场景\n\n以下流程高频且参数容易出错，优先用 skill 自带脚本：\n\n- 一次性完成 `jadx + apktool` 落盘并产出摘要：`scripts\u002Fdecode.ps1`\n- Frida 设备检查、进程列举、spawn\u002Fattach 注入：`scripts\u002Ffrida-run.ps1`\n- 重建、对齐、签名、安装 APK：`scripts\u002Frebuild-sign-install.ps1`\n- 快速抽取 Manifest 关键组件与权限：`scripts\u002Fmanifest-summary.ps1`\n\n以下一行命令保持直接调用，不单独封装：\n\n- `adb devices`\n- `adb logcat`\n- `frida-ps -U`\n- `jadx --version`\n- `apktool --version`\n\n## 自带脚本\n\n### `scripts\u002Fdecode.ps1`\n\n用途：\n\n- 统一跑 `jadx` 和 `apktool`\n- 默认在原 APK 同目录创建任务输出目录\n- 输出 `package`、`java_files`、`smali_dirs`、`so_files` 等摘要\n- 兼容 `jadx` 部分反编译错误但仍然有可用产物的情况\n\n示例：\n\n```powershell\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\decode.ps1\" -ApkPath \"D:\\DOWNLOAD\\app.apk\" -Clean\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\decode.ps1\" -ApkPath \"D:\\DOWNLOAD\\app.apk\" -Name demo -SkipJadx\n```\n\n### `scripts\u002Ffrida-run.ps1`\n\n用途：\n\n- 统一 Frida 的设备、进程、spawn\u002Fattach 入口\n- 避免手写参数时混淆 `-f`、`-n`、`-U`\n\n示例：\n\n```powershell\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\frida-run.ps1\" -ListDevices\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\frida-run.ps1\" -Usb -ListProcesses\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\frida-run.ps1\" -Usb -Spawn -Package com.example.app -ScriptPath \"D:\\hooks\\test.js\"\n```\n\n### `scripts\u002Frebuild-sign-install.ps1`\n\n用途：\n\n- `apktool b` 重建 APK\n- `zipalign` 对齐\n- `apksigner` 签名与验签\n- 可选直接 `adb install`\n\n示例：\n\n```powershell\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\rebuild-sign-install.ps1\" -ProjectDir \"C:\\work\\apktool_out\" -Clean\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\rebuild-sign-install.ps1\" -ProjectDir \"C:\\work\\apktool_out\" -Install -Reinstall -DeviceSerial \"127.0.0.1:7555\"\n```\n\n说明：\n\n- 默认生成并复用调试 keystore\n- 默认输出到 `ProjectDir` 同目录，便于和原始包、解包目录放在一起\n\n### `scripts\u002Fmanifest-summary.ps1`\n\n用途：\n\n- 抽取包名\n- 列权限\n- 列 activity\u002Fservice\u002Freceiver\u002Fprovider\n- 标出主启动 activity\n\n示例：\n\n```powershell\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\manifest-summary.ps1\" -ManifestPath \"C:\\work\\apktool_out\\AndroidManifest.xml\"\n```\n\n如果要分析 `.so`、`lib\u002Farm64-v8a\u002F*.so`、`lib\u002Farmeabi-v7a\u002F*.so`，再结合：\n\n- `ida-reverse`\n- `radare2`\n\n## 工具分工\n\n### `jadx`\n\n用于：\n\n- Java 反编译阅读\n- 包名、类名、方法名搜索\n- 先从高层逻辑理解 APK\n\n常用命令：\n\n```bash\njadx -d jadx_out app.apk\njadx --single-class com.example.LoginActivity -d jadx_out app.apk\njadx --deobf -d jadx_out app.apk\n```\n\n### `JEB Pro`（可选商业工具）\n\n用于：\n\n- Android DEX \u002F APK \u002F ARM 的交叉验证与深度反编译\n- 在 JADX 输出不完整或混淆较重时补充静态分析\n- 对同一目标的类、方法与调用关系进行第二工具链校验\n\n边界：\n\n- JEB Pro 是商业软件，必须由用户自行取得并安装有效许可证；本包不会下载、破解或规避许可。\n- 仅在 `tool-index` 已确认本机 JEB 可用时调用；否则继续使用 `jadx`、`apktool`、Ghidra、IDA 或 radare2。\n- 第三方 JEB MCP bridge 不是本包依赖。安装前必须按 `..\u002Fops\u002Fskill-supply-chain.md` 审阅源码、权限、网络行为和版本，再由用户明确确认注册。\n\n### `apktool`\n\n用于：\n\n- 解包 APK\n- 查看和修改 `AndroidManifest.xml`\n- 查看和修改 smali\n- 重建 APK\n\n常用命令：\n\n```bash\napktool d app.apk -o apktool_out\napktool b apktool_out -o rebuilt.apk\n```\n\n### `frida`\n\n用于：\n\n- 动态观察 Java 方法调用\n- Hook native 导出函数\n- 绕过 root 检测、证书校验、调试检测\n\n常用命令：\n\n```bash\nfrida-ps -U\nfrida -U -f com.example.app -l hook.js\nfrida-trace -U -f com.example.app -j '*!*certificate*'\n```\n\n### `adb`\n\n用于：\n\n- 设备连接\n- 安装 APK\n- 查看日志\n- 拉取文件\n\n常用命令：\n\n```bash\nadb devices\nadb install -r app.apk\nadb shell pm list packages\nadb logcat\nadb pull \u002Fdata\u002Flocal\u002Ftmp\u002Ffile .\n```\n\n## 推荐工作流\n\n### 1. Triage\n\n先确定 APK 大致构成，不急着改包或 Hook。\n\n建议动作：\n\n1. 用 `jadx -d jadx_out app.apk` 导出 Java 代码\n2. 用 `apktool d app.apk -o apktool_out` 导出 smali 和资源\n3. 先看：\n   - `AndroidManifest.xml`\n   - 主 `package`\n   - `application`、`activity`、`service`、`receiver`\n   - `lib\u002F` 目录里是否有 `.so`\n\n### 2. Java 逻辑观察\n\n优先从 `jadx_out` 读：\n\n- `MainActivity`\n- `Application`\n- 登录、网络、加密、风控相关类\n- 第三方 SDK 初始化类\n\n常见关键词：\n\n- `login`\n- `sign`\n- `encrypt`\n- `cipher`\n- `token`\n- `root`\n- `certificate`\n- `trust`\n- `okhttp`\n- `retrofit`\n- `webview`\n\n如果 Java 代码可读，先在这里定位业务逻辑。\n\n### 3. Smali 与资源层确认\n\n当 `jadx` 结果不完整、混淆重、或需要实际 patch 时，切到 `apktool_out`：\n\n- 看 `smali*\u002F`\n- 看 `res\u002Fvalues\u002Fstrings.xml`\n- 看 `AndroidManifest.xml`\n\n优先 patch：\n\n- `android:exported`\n- 调试标记\n- root 检测返回值\n- 登录验证逻辑\n- 证书校验分支\n\n### 4. 重建与安装\n\n修改后：\n\n```bash\napktool b apktool_out -o rebuilt.apk\n```\n\n或者直接用脚本闭环：\n\n```powershell\npwsh -File \"\u003Cskill-root>\\apk-reverse\\scripts\\rebuild-sign-install.ps1\" -ProjectDir \"apktool_out\" -Install -Reinstall -DeviceSerial \"127.0.0.1:7555\"\n```\n\n说明：\n\n- 本 skill 只保证 `apktool` 重建链路\n- 若后续需要正式安装到设备，通常还需要签名流程\n- 如果任务进入签名\u002F对齐，补充 `apksigner` \u002F `zipalign`\n\n### 5. 动态 Hook\n\n静态分析不足时，用 Frida：\n\n- Hook 登录函数\n- Hook `OkHttp` \u002F `Retrofit` \u002F `WebView` 关键点\n- Hook `javax.crypto`、`MessageDigest`\n- Hook root 检测函数\n- Hook SSL pinning 逻辑\n\n原则：\n\n- 先 Hook Java 层，再看是否需要 native Hook\n- 先打印参数与返回值，再决定是否主动修改返回值\n\n建议：\n\n- 简单一次性命令直接用 `frida-*`\n- 需要稳定复用的注入流程优先走 `scripts\u002Ffrida-run.ps1`\n\n### 6. Native `.so` 分流\n\n如果 APK 中包含关键 `.so`：\n\n- 用 `apktool` 或 `jadx` 找到 `lib\u002F**\u002F*.so`\n- 若只是导出符号、字符串、快速 triage，可用 `radare2`\n- 若要长期深入分析、反编译、改名、类型恢复，用 `ida-reverse`\n\n遇到这些信号要尽快切 native：\n\n- Java 层只是 JNI 包装\n- 核心签名逻辑不在 Java\n- `System.loadLibrary()` 后关键逻辑消失\n- 证书校验\u002F风控在 `.so` 中\n\n## 输出要求\n\n最终至少说明：\n\n- 入口组件与关键类\n- 关键逻辑在 Java、smali 还是 `.so`\n- 已确认的敏感点：登录、签名、root、SSL、WebView、JNI\n- 如果做了 patch，说明改了什么\n- 如果做了 Hook，说明 Hook 了哪个类\u002F方法\u002F导出函数\n\n## 禁止事项\n\n- 不要一开始就盲目改 smali\n- 不要在没看 manifest 和主入口前就写 Hook\n- 不要把 Java 反编译不完整直接等同于“逻辑不可分析”\n- 不要在 `.so` 明显承载核心逻辑时继续死磕 Java 层\n\n## 快速命令备忘\n\n```bash\n# 反编译 Java\njadx -d jadx_out app.apk\n\n# 解包 APK\napktool d app.apk -o apktool_out\n\n# 重建 APK\napktool b apktool_out -o rebuilt.apk\n\n# 设备与进程\nadb devices\nfrida-ps -U\n\n# 启动并注入\nfrida -U -f com.example.app -l hook.js\n```\n\n---\n\n## 路由上下文\n\n**上游入口**: `skills\u002FSKILL.md`（总控）、`routing.md`\n**下游出口**:\n- 核心逻辑在 `.so` → `ida-reverse\u002F` 或 `radare2\u002F`\n- 需动态 Hook\u002F验证 → `reverse-engineering\u002Ftools-dynamic.md`（Frida 章节）\n- 通用逆向方法论 → `reverse-engineering\u002FSKILL.md`\n\n**同级关联模块**: `reverse-engineering\u002F`（.so 分析和 Frida 进阶用法）\n\n---\n\n## 按需自举（On-Demand Bootstrap）\n\n本 skill 的入口脚本已接入统一自举系统。缺少工具时不会直接报错，而是自动尝试安装。\n\n### 自动化能力边界\n\n| 工具 | 可自动安装 | 安装方式 | 说明 |\n|------|-----------|---------|------|\n| jadx | ✓ | GitHub Release ZIP | 自动下载解压到 `%USERPROFILE%\\Tools\\jadx\\` |\n| apktool | ✓ | GitHub Release JAR + wrapper | 自动下载 jar 并生成 bat 到 `%USERPROFILE%\\Tools\\apktool\\` |\n| JEB Pro | ✗ | 用户手动安装并提供有效许可证 | 可选的 Android \u002F ARM 交叉验证工具；第三方 MCP bridge 需单独审计 |\n| frida \u002F frida-ps | ✓ | pip install frida-tools | 需要 Python 已安装 |\n| adb | ✓ | winget \u002F fallback path | 自动安装 Android Platform-Tools |\n| zipalign | ✗ | 需手动安装 Android Build-Tools | `sdkmanager \"build-tools;35.0.0\"` |\n| apksigner | ✗ | 需手动安装 Android Build-Tools | 同上 |\n\n### 自举触发点\n\n- `scripts\u002Fdecode.ps1`：缺 jadx 或 apktool 时自动调用 `bootstrap-reverse.ps1`\n- `scripts\u002Frebuild-sign-install.ps1`：缺 adb 或 apktool 时自动调用 bootstrap\n- `scripts\u002Ffrida-run.ps1`：当前仍为手动检查（frida 通常已通过 pip 安装）\n\n### 自举失败时\n\n如果自动安装失败，脚本会抛出明确错误并附带手动安装链接。常见原因：\n- 网络不通（GitHub API \u002F PyPI 不可达）\n- winget 不可用（Windows 版本过低）\n- Java 未安装（apktool 依赖 JDK）\n\n\n## 任务完成自检（声称完成前 MUST 通过）\n\n- [ ] 我是否执行了工作流中的每一步（而不是只阅读）？\n- [ ] 我是否基于 `tool-index` 使用了真实工具路径？\n- [ ] 我是否产出了可复现证据（命令\u002F脚本\u002F截图\u002F报告）？\n- [ ] 我是否完成并回写了 RULES 要求的 Checklist 项？\n",{"name":5,"description":7},"main","5b045f5effb9db25a3199f06d549a00373078082",".agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse","https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate","https:\u002F\u002Fgithub.com\u002FRain-kl","2026-09-19 20:30:24",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add Rain-kl\u002FReverseTemplate --skill apk-reverse",{"tool":36,"command":37},"bunx","bunx skills add Rain-kl\u002FReverseTemplate --skill apk-reverse",{"tool":39,"command":40},"pnpm","pnpm dlx skills add Rain-kl\u002FReverseTemplate --skill apk-reverse","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002FSKILL.md",true,[44,50,54,58,62,68,72,76,80,84,88],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"references\u002Fandroid-advanced.md","REFERENCE","参考文档",10876,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Freferences\u002Fandroid-advanced.md",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"references\u002Fapk-security-checklist.md",6979,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Freferences\u002Fapk-security-checklist.md",{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Ffrida-bypass-kit.md",2436,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Freferences\u002Ffrida-bypass-kit.md",{"path":59,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Ffrida-cookbook.md",14149,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Freferences\u002Ffrida-cookbook.md",{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"scripts\u002Fdecode.ps1","SCRIPT","脚本",5769,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Fscripts\u002Fdecode.ps1",{"path":69,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":70,"sourceHtmlUrl":71},"scripts\u002Fdecode.sh",4885,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Fscripts\u002Fdecode.sh",{"path":73,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":74,"sourceHtmlUrl":75},"scripts\u002Ffrida-run.ps1",4026,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Fscripts\u002Ffrida-run.ps1",{"path":77,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":78,"sourceHtmlUrl":79},"scripts\u002Ffrida-run.sh",4083,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Fscripts\u002Ffrida-run.sh",{"path":81,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":82,"sourceHtmlUrl":83},"scripts\u002Fmanifest-summary.ps1",2695,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Fscripts\u002Fmanifest-summary.ps1",{"path":85,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":86,"sourceHtmlUrl":87},"scripts\u002Frebuild-sign-install.ps1",6889,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Fscripts\u002Frebuild-sign-install.ps1",{"path":89,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":90,"sourceHtmlUrl":91},"scripts\u002Frebuild-sign-install.sh",6737,"https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fapk-reverse\u002Fscripts\u002Frebuild-sign-install.sh",[93,100,107,114,121,128],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M7AEMCR7PHAB7SRFX17KAKKS","windows-ad","Use for authorized Active Directory and Windows identity attacks including Kerberos, AD CS, BloodHound paths, NTLM relay, and domain privilege escalation research.","https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fwindows-ad\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":19},"01M7AEMA913F9CGJPHXGRA4DMW","wifi-wireless","Use for authorized wireless security assessment including Wi-Fi capture, WPA handshake analysis, rogue AP detection research, and lab-only deauth testing.","https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fwifi-wireless\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":19},"01M7AEM7SKHX0JD2HKD4EP7FCH","threat-hunting","Use for blue-team threat hunting, detection engineering with Sigma\u002FYARA, SIEM query design, and incident detection validation.","https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fthreat-hunting\u002FSKILL.md",[],[],{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":19},"01M7AEM4S61F6E0F20A2HB50QM","thick-client","Use for authorized security testing of desktop thick clients including local storage, update channels, IPC, traffic, and client-side trust boundaries.","https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fthick-client\u002FSKILL.md",[],[],{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":19},"01M7AEM1KQQHZBD9RDQ2P3GKWH","supply-chain-security","Use for software supply-chain security assessment covering SBOM, SCA, CI\u002FCD pipelines, container images, build integrity, dependency provenance, and vulnerability reachability.","https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Fsupply-chain-security\u002FSKILL.md",[],[],{"skillNo":129,"name":130,"nameZh":6,"description":131,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":132,"categories":133,"keywords":134,"publishedAt":19},"01M7AEKXA2PNZA2NYRW63RFNZS","dsl-vm-reverse","Reverse JavaScript-based custom DSL\u002FVM interpreters, non-standard WASM-like runtimes, and risk-control engines. Use when analyzing IIFE or switch-based opcode dispatchers, extracting instruction tables, recovering bytecode semantics, capturing VM state at runtime, or reconstructing execution flow.","https:\u002F\u002Fgithub.com\u002FRain-kl\u002FReverseTemplate\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freverse-skill\u002Fskills\u002Freverse-engineering\u002Fdsl-vm-reverse\u002FSKILL.md",[],[]]