0 Fork 0

Files

T

angusdevgo 5109da6c31 feat: initial commit of seep-reverse-lab workbench

2026-09-24 02:06:21 +08:00

11 KiB

Raw Blame History

下载清单 (DOWNLOADS)

⚠️ 本包已内置全部工具（≈880 MB）—— 正常情况下你不需要下载任何东西。

本文用于：

了解内置工具是什么、从哪来、装在哪（便于排障与溯源）

内置工具损坏/缺失时，用 setup\repair-tools.ps1 重新下载

唯一需你自行准备的软件：IDA Pro（商业授权，见 MANUAL/IDA-PRO.md）

零、内置 vs 需自备

类别	组件	处理方式
✅ 已内置	jadx · radare2 · apktool · playwright-mcp · js-reverse-mcp · ida-pro-mcp · hook-mcp	随包提供，解压即用
🔴 需自备	IDA Pro 本体（商业授权）	见 `MANUAL/IDA-PRO.md`
🔴 需自填	模型 API 密钥 · playwright token	由你自行配置（本包不含凭据）
⚙️ 需 pip 装	`mcp` · `pytest` · `frida-tools`	`install-python.ps1` 自动

一、内置工具清单（已随包提供）

#	组件	上游来源	本包位置	体积
1	jadx	GitHub `skylot/jadx`	`Tool/mcp/Tool/safe/jadx/`	461 MB
2	radare2	GitHub `radareorg/radare2`	`Tool/mcp/Tool/safe/radare2/`	39 MB
3	apktool	GitHub `iBotPeaches/Apktool`	`Tool/mcp/Tool/safe/apktool/`	24 MB
4	playwright-mcp	npm `@playwright/mcp`	`Tool/mcp/Tool/safe/playwright-mcp/`	45 MB
5	js-reverse-mcp	npm `js-reverse-mcp`	`Tool/mcp/Tool/safe/js-reverse-mcp/`	234 MB
6	ida-pro-mcp	PyPI `ida-pro-mcp`	`Tool/mcp/Tool/safe/ida-pro-mcp/`	79 MB
7	hook-mcp	自研	`Tool/mcp/Tool/safe/hook-mcp/`	331 KB
			合计	≈ 880 MB

工具位置由 seep_mcp_server.py 硬编码决定：TOOL_DIR = <脚本目录>/Tool。即 Tool/mcp/ 旁边必须有 Tool/ 目录。不可搬动。

二、需自备：IDA Pro（商业授权）

IDA Pro 不随包分发。两种处理：

方案	操作
已有授权	跑 `setup\install-ida.ps1`（自动探测 + 装 ida-pro-mcp + 写配置）
无授权	用免费替代：`seep_r2_*`（Radare2 八件套）+ Ghidra —— 见 `MANUAL/IDA-PRO.md`

IDA 缺失不会阻塞任务 —— agent 会自动降级到 seep_r2_* 并标注“未使用 IDA 反编译器”。

三、需 pip 安装（`install-python.ps1` 自动）

包	版本约束	来源	用途
mcp	`>=1.20,<1.29`	PyPI	seep MCP 运行时
pytest	最新	PyPI	跑 apkseep 离线测试套件
frida-tools	最新	PyPI	动态 Hook（可选）

国内源回退：失败时自动重试 https://pypi.tuna.tsinghua.edu.cn/simple

⚠️ mcp 版本上限很重要：mcp>=1.29 移除了 mcp.server.fastmcp， seep MCP 会启动失败。不要手工升级到 1.29+。

四、pi 扩展包（12 个 npm 包）

由 install-pi.ps1 写入 ~/.pi/agent/settings.json 的 packages 字段，然后执行 pi update --extensions 安装：

npm:pi-open-tui
npm:pi-web-access
npm:@juicesharp/rpiv-todo
npm:@narumitw/pi-btw
npm:@narumitw/pi-plan-mode
npm:@narumitw/pi-usage
npm:pi-mcp-extension
npm:@smoose/pi-themes
npm:pi-tool-display
npm:@juicesharp/rpiv-ask-user-question
npm:pi-playwright
npm:pi-goal-x

目标：~/.pi/agent/npm/node_modules/ · 体积约 80 MB

1. jadx — Java/APK 反编译

项	值
上游	https://github.com/skylot/jadx
下载地址	`https://api.github.com/repos/skylot/jadx/releases/latest` → asset `jadx-<版本>.zip`
实测版本	`jadx-1.5.6.zip`
正则匹配	`^jadx-[\d.]+\.zip$`
目标	`Tool/mcp/Tool/safe/jadx/`
服务的工具	`seep_apk_decompile`
许可	Apache-2.0

2. radare2 — 二进制逆向引擎

项	值
上游	https://github.com/radareorg/radare2
下载地址	`https://api.github.com/repos/radareorg/radare2/releases/latest` → asset `radare2-<版本>-w64.zip`
实测版本	`radare2-6.2.2-w64.zip`
正则匹配	`^radare2-.-w64\.zip$` ⚠️ 注意是 `w64` 不是 `windows`*
目标	`Tool/mcp/Tool/safe/radare2/`
服务的工具	`seep_r2_`（8 个工具*）
许可	LGPL-3.0

⚠️ 易错点：radare2 的 Windows 包名用 w64（如 radare2-6.2.2-w64.zip），不是 windows。早期若写成 windows.*\.zip$ 会匹配不到任何 asset，导致下载静默失败。

3. apktool — APK 解包/重打包

项	值
上游	https://github.com/iBotPeaches/Apktool
下载地址	`https://api.github.com/repos/iBotPeaches/Apktool/releases/latest` → asset `apktool_<版本>.jar`
实测版本	`apktool_3.0.3.jar`
正则匹配	`^apktool_[\d.]+\.jar$`
目标	`Tool/mcp/Tool/safe/apktool/`（脚本另写 `apktool.bat`）
服务的工具	`seep_apk_unpack`
许可	Apache-2.0

前置依赖：需 JDK 17+（apktool.bat 会读 JAVA_HOME）

4. playwright-mcp — 浏览器自动化

项	值
上游	https://github.com/microsoft/playwright-mcp（npm `@playwright/mcp`）
安装	`npm install @playwright/mcp`
目标	`Tool/mcp/Tool/safe/playwright-mcp/`
备注	也可直接用 `npx -y @playwright/mcp@latest`（无需安装）
需自填	`PLAYWRIGHT_MCP_EXTENSION_TOKEN`（由你自行配置）

5. js-reverse-mcp — JS 逆向

项	值
上游	https://github.com/zhizhuodemao/js-reverse-mcp
方式	npx 免安装：`npx -y js-reverse-mcp`
目标	无需下载（已在 `mcp.json.template` 中预置）
可选本地安装	`git clone` + `npm install` + `npm run build`
许可	见上游仓库

优点：零下载、零磁盘占用。首次调用时 npx 自动拉取。

6. ida-pro-mcp — IDA 桥接

项	值
上游	https://github.com/mrexodia/ida-pro-mcp
PyPI	https://pypi.org/project/ida-pro-mcp/
实测版本	1.4.0
安装	`pip install ida-pro-mcp`
目标	Python site-packages
服务的工具	`mcp_ida_*`（~243 个）
⚠️ 前置	需自备 IDA Pro（见 `MANUAL/IDA-PRO.md`）

三、Python 依赖（3 个）

install-python.ps1 执行：

包	版本约束	来源	用途
mcp	`>=1.20,<1.29`	PyPI	seep MCP 运行时（版本上限由 reverselab 约定）
pytest	最新	PyPI	跑 apkseep 的离线测试套件
frida-tools	最新	PyPI	动态 Hook（可选）

国内源回退：脚本失败时自动重试 https://pypi.tuna.tsinghua.edu.cn/simple

⚠️ mcp 的版本上限很重要：mcp>=1.29 移除了 mcp.server.fastmcp， seep MCP 会启动失败。不要手工升级到 1.29+。

四、pi 扩展包（12 个 npm 包）

由 install-pi.ps1 写入 ~/.pi/agent/settings.json 的 packages 字段，然后执行 pi update --extensions 安装：

npm:pi-open-tui
npm:pi-web-access
npm:@juicesharp/rpiv-todo
npm:@narumitw/pi-btw
npm:@narumitw/pi-plan-mode
npm:@narumitw/pi-usage
npm:pi-mcp-extension
npm:@smoose/pi-themes
npm:pi-tool-display
npm:@juicesharp/rpiv-ask-user-question
npm:pi-playwright
npm:pi-goal-x

目标：~/.pi/agent/npm/node_modules/

手工安装：

pi update --extensions
# 或逐个装
pi install npm:pi-mcp-extension

五、免下载项（零磁盘占用）

组件	方式	说明
js-reverse-mcp	`npx -y js-reverse-mcp`	首次调用时自动拉取
playwright MCP	`npx -y @playwright/mcp@latest`	同上（也可本地装）

六、镜像回退策略

install-tools.ps1 内置三级回退（按顺序尝试）：

1. 官方源          https://github.com/...          （直连）
2. ghproxy.net     https://ghproxy.net/https://github.com/...
3. gh-proxy.com    https://gh-proxy.com/https://github.com/...

触发条件：下载失败、超时（300s）、或文件 < 1 KB（视为无效）

日志示例：

[..] 尝试 official ...
[!!] 失败: The operation has timed out
[..] 尝试 ghproxy.net ...
[OK] 下载成功 (ghproxy.net)

七、手动下载清单（脚本全失败时）

工具	手动下载	放到	备注
jadx	https://github.com/skylot/jadx/releases → `jadx-x.x.x.zip`	`Tool/mcp/Tool/safe/jadx/`	解压后 `bin/jadx.bat` 应在
radare2	https://github.com/radareorg/radare2/releases → `radare2-x.x.x-w64.zip`	`Tool/mcp/Tool/safe/radare2/`	解压后 `bin/radare2.exe` 应在
apktool	https://github.com/iBotPeaches/Apktool/releases → `apktool_x.x.x.jar`	`Tool/mcp/Tool/safe/apktool/apktool.jar`	需另建 `apktool.bat`
ida-pro-mcp	`pip install ida-pro-mcp`	Python site-packages	—
playwright-mcp	`npm i @playwright/mcp`	`Tool/mcp/Tool/safe/playwright-mcp/`	或用 npx

apktool 的 `.bat` 内容（手动装时需要）

@echo off
if "%JAVA_HOME%"=="" (set JAVA=java) else (set JAVA="%JAVA_HOME%\bin\java.exe")
%JAVA% -jar -Duser.language=en "%~dp0apktool.jar" %*

八、验证下载是否成功

cd Desktop\Seep\setup
powershell -ExecutionPolicy Bypass -File .\verify.ps1

期望存在：

路径	期望内容
`Tool/mcp/Tool/safe/jadx/bin/jadx.bat`	jadx 启动器
`Tool/mcp/Tool/safe/radare2/bin/radare2.exe`	r2 主程序
`Tool/mcp/Tool/safe/apktool/apktool.jar`	apktool jar
`Tool/mcp/Tool/safe/hook-mcp/templates/`	Hook 模板（本包自带）
`Tool/mcp/Tool/reverselab/kb/`	289 篇知识库（本包自带）

九、不下载什么（刻意排除）

项	原因
IDA Pro 本体（1.6 GB）	商业授权，不得分发 —— 见 `MANUAL/IDA-PRO.md`
模型 API 密钥	隐私，由使用者自行配置
GitHub PAT / Sentry DSN	上游 `.env.example` 仅留空模板
Playwright token	需自备，由使用者自行配置

十、网络问题速查

现象	处理
GitHub API 超时	脚本会报 `无法获取 release 信息`，改用镜像或手动下载
下载中断	重跑 `install-tools.ps1`（已存在的会跳过）
`pip` 慢	`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <包>`
`npm` 慢	`npm config set registry https://registry.npmmirror.com`
全部失败	按 §七手动下载，放到对应目录

十一、磁盘空间预估

阶段	增量
解压本包	16 MB
装工具（jadx 460 + r2 39 + apktool 24 + playwright 45 + ida-pro-mcp 1）	~570 MB
Python 依赖（mcp + pytest + frida-tools）	~50 MB
pi 扩展包（12 个）	~80 MB
合计	≈ 700 MB

若只装核心链路（跳过 jadx）：可省 460 MB。命令：powershell -File .\install-tools.ps1 -Only radare2,apktool,ida-pro-mcp

11 KiB Raw Blame History Unescape Escape

下载清单 (DOWNLOADS)

零、内置 vs 需自备

一、内置工具清单（已随包提供）

二、需自备：IDA Pro（商业授权）

三、需 pip 安装（install-python.ps1 自动）

四、pi 扩展包（12 个 npm 包）

1. jadx — Java/APK 反编译

2. radare2 — 二进制逆向引擎

3. apktool — APK 解包/重打包

4. playwright-mcp — 浏览器自动化

5. js-reverse-mcp — JS 逆向

6. ida-pro-mcp — IDA 桥接

三、Python 依赖（3 个）

四、pi 扩展包（12 个 npm 包）

五、免下载项（零磁盘占用）

六、镜像回退策略

七、手动下载清单（脚本全失败时）

apktool 的 .bat 内容（手动装时需要）

八、验证下载是否成功

九、不下载什么（刻意排除）

十、网络问题速查

十一、磁盘空间预估

11 KiB

Raw Blame History

三、需 pip 安装（`install-python.ps1` 自动）

apktool 的 `.bat` 内容（手动装时需要）