# 2520 — 具身智能/机器人模糊测试框架

## 快速开始

### 环境要求
- **PC端**: Windows 10/11, Python 3.8+, 与Jetson同一局域网
- **Jetson端**: Jetson Nano/Orin/AGX, Python 3.8+, 已连接网络

### 使用步骤

#### 1. 启动服务（首次使用）
双击 `2520_launcher.bat` 选择 [1] 安装向导，依次输入：
- Jetson IP 地址
- SSH 用户名（默认 nvidia）
- SSH 密码（默认 nvidia）

向导会自动：
- 测试SSH连接
- 上传Jetson Agent到远程设备
- 安装依赖
- 启动PC端服务
- 打开浏览器

#### 2. 或手动部署
```bash
# 启动PC端服务
cd server
python Run_2520.py

# 手动部署到Jetson
# 将 2520_jetson_deploy.tar.gz 传到Jetson并解压
# 运行: python3 jetson_agent.py
```

#### 3. 访问控制面板
浏览器打开: http://127.0.0.1:7885/

### 目录说明

| 目录/文件 | 说明 |
|-----------|------|
| `7884_brain.exe` | 7884结构归纳引擎 |
| `server/` | PC端主控服务，包含Web前端和工具 |
| `server/Run_2520.py` | PC端主控程序（启动这个） |
| `server/web/` | Web控制面板和文档 |
| `server/tools/` | 漏洞报告生成工具 |
| `jetson/` | Jetson端Agent和Fuzz模块源码 |
| `deploy/` | 手动部署辅助脚本 |
| `2520_jetson_deploy.tar.gz` | Jetson部署压缩包 |
| `setup_wizard.py` | 交互式安装向导 |
| `2520_launcher.bat` | Windows启动菜单 |

### 关于7884结构归纳引擎

2520 可选集成 7884 结构归纳引擎，用于从二进制样本自动推导格式模型并生成 Peach XML。

- **引擎位置**: 将 `7884_brain.exe` 放置于项目根目录（与 `setup_wizard.py` 同级）
- **配置方式**: `server/config.json` 中 `brain_exe` 字段默认指向 `../7884_brain.exe`
- **检查状态**: 启动后访问 Web 界面，查看"结构归纳"标签页顶部会显示引擎是否存在
- **注意事项**: 该引擎为可选组件，不影响 Jetson 本地 Fuzz 模块（CAN/串口/摄像头等）的正常使用

```
2520Fuzz/             ← 解压根目录
├── 7884_brain.exe              ← 7884结构归纳引擎（需手动放置）
├── README.md
├── 2520_launcher.bat           ← 双击启动
├── setup_wizard.py
├── server/                     ← PC端
│   ├── Run_2520.py
│   ├── config.json
│   ├── web/
│   │   ├── index.html
│   │   
│   └── tools/
│       ├── bug_report_generator.py
│       └── bug.html
├── jetson/                     ← Jetson端源码
│   ├── jetson_agent.py
│   ├── jetson_fuzz_modules.py
│   └── install_jetson_deps.sh
├── deploy/
│   ├── deploy_windows.py
│   └── deploy.sh
└── 2520_jetson_deploy.tar.gz   ← Jetson部署包
└─http://www.asm64.com/2520.html   ← 使用说明