# 前置依赖 (PREREQUISITES)

> `install.ps1` 会尽量自动装，但以下**基础运行时**需要你先准备好。

---

## 必需

| 组件 | 版本要求 | 检查命令 | 下载 |
| :--- | :--- | :--- | :--- |
| **Python** | **3.11+**（推荐 3.12/3.13） | `python --version` | https://www.python.org/downloads/ |
| **Git** | 任意 | `git --version` | https://git-scm.com/download/win |
| **PowerShell** | 5.1+（推荐 7.x） | `$PSVersionTable.PSVersion` | 系统自带 |

> **Python 安装时务必勾选 "Add Python to PATH"**。

## 建议

| 组件 | 版本 | 用途 |
| :--- | :--- | :--- |
| **Node.js** | 18+ | playwright-mcp / js-reverse-mcp |
| **7-Zip** | 任意 | 解压部分工具包 |

---

## install.ps1 会自动装的部分

| 组件 | 方式 |
| :--- | :--- |
| `mcp` Python 库 | `pip install "mcp>=1.20,<1.29"` |
| `pytest` | `pip install pytest` |
| `frida-tools` | `pip install frida-tools` |
| radare2 / jadx / apktool | 从 GitHub 下载解压到 `Tool/mcp/Tool/safe/` |
| playwright-mcp | `npm i @playwright/mcp` |
| js-reverse-mcp | 源码 + `npm install && npm run build` |
| ida-pro-mcp | `pip install ida-pro-mcp` |
| pi 扩展包（12 个） | `pi update --extensions` |

---

## 手动下载清单（脚本失败时用）

若 `install-tools.ps1` 因网络问题失败，手动下载后放到对应位置：

| 工具 | 下载地址 | 放到 |
| :--- | :--- | :--- |
| **jadx** | https://github.com/skylot/jadx/releases （`jadx-x.x.x.zip`） | `Tool/mcp/Tool/safe/jadx/` |
| **radare2** | https://github.com/radareorg/radare2/releases （Windows zip） | `Tool/mcp/Tool/safe/radare2/` |
| **apktool** | https://github.com/iBotPeaches/Apktool/releases （`apktool_x.x.x.jar`） | `Tool/mcp/Tool/safe/apktool/` |
| **playwright-mcp** | `npm i -g @playwright/mcp` | 全局即可 |
| **ida-pro-mcp** | https://github.com/mrexodia/ida-pro-mcp | `Tool/mcp/Tool/safe/ida-pro-mcp/` |

### apktool 的 `.bat` 封装（手动装时需要）

在 `Tool/mcp/Tool/safe/apktool/` 下新建 `apktool.bat`：

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

---

## 网络问题排查

| 现象 | 处理 |
| :--- | :--- |
| GitHub 下载超时 | 脚本会自动回退镜像 `ghproxy.net` / `gh-proxy.com` |
| 全部镜像都失败 | 用上面的手动清单，或配置代理后重跑 `install-tools.ps1` |
| `pip` 装不上 | 加国内源：`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <包名>` |
| `npm` 装不上 | 换源：`npm config set registry https://registry.npmmirror.com` |

---

## 装完自检

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

期望输出 `READY`（或列出待手工项）。