逆向与客户端安全实战工具箱使用指南 (Toolkit Guide)

本工作空间已将业界顶尖的逆向工程规范（reverse-skill）与我们本地实战经验（softseep、MuMu/XYplorer/Hills 注入体系、seep MCP 服务）深度融合，为日常的客户端鉴权分析、功能本地化、安卓逆向与攻防测试提供一站式支持。

一、核心工具与脚本目录一览

所有脚本统一存放在 Tool/scripts/ 下，严禁散落根目录：

脚本 / 工具	路径	核心用途
工具链自检	`Tool/scripts/refresh-tool-index.ps1`	秒级扫描系统已安装工具（IDA、Radare2、ADB、Python、Node 等）并生成状态表
任务建档门禁	`Tool/scripts/case-init.ps1`	新任务一键在 `work/<case_name>` 独立建档，自动生成 `scope.md` 与证据链
APK 反编译流水线	`Tool/scripts/apk/decode.ps1`	一键运行 `jadx` + `apktool` 解包反编译并生成组件摘要
APK 重打包与签名	`Tool/scripts/apk/rebuild-sign-install.ps1`	修改 Smali 后全自动执行 `apktool b` -> 4字节对齐 -> 签名 -> ADB 推送安装
Frida 动态注入	`Tool/scripts/apk/frida-run.ps1`	标准化设备枚举、进程列表与 Spawn/Attach 动态 Hook 运行
IDA Pro MCP 唤醒	`Tool/scripts/trigger_ida_mcp.ps1`	静默启动 IDA Pro 64 并自动挂载 MCP 分析链路

新建任务沙盒：

powershell -File Tool/scripts/case-init.ps1 -CaseName "hills-localize" -Preset offline-sample -Sample "D:\Target\app.exe"

产物将完整隔离在 work/hills-localize/ 下，不污染任何工作区根目录。

IDA 自动化辅助分析：
- 使用 mcp_ida_* 系列工具或唤醒 IDA Pro；
- 检索 License、VIP、Expire 等关键函数，提取判断逻辑分支。
编写免杀代理 DLL 热补丁：
- 遵循 softseep 战术，优先选取宿主必定隐式引用的系统库（如 version.dll、dinput8.dll）；
- 利用 DllMain 线程或劫持跳板对目标整型返回值函数进行无损 Patch（保持原 EXE 数字签名）；
- 使用 zig cc 或 MSVC 编译并部署验证。

一键反编译：

powershell -File Tool/scripts/apk/decode.ps1 -ApkPath "D:\Target\app.apk" -Clean

定位与修改逻辑：
- 查看 Java 逻辑定位鉴权与广告拦截点；
- 在生成的 smali/ 目录下按位点打桩（如 return-void 或强制返回 const/4 v0, 0x1）。
一键重打包、签名与安装：
```
powershell -File Tool/scripts/apk/rebuild-sign-install.ps1 -ProjectDir "D:\Target\app_apktool" -Install
```
脚本将全自动处理 zipalign 对齐和测试证书签名，并自动推送到当前运行的 MuMu 模拟器中。

当前知识库已扩展至 69 篇 专业攻防战术笔记，支持随时查询模式与代码：

日常与小π沟通时：