# Test & Validation Tools (Unified)

该目录包含用于测试无人机规划系统、API 接口及 LLM 服务的集成验证工具集。

## 🚀 快速开始

使用统一入口脚本启动交互式菜单：

```bash
python run_tests.py
```

## 🛠️ 测试模式

### 1. 交互式单次测试 (Mode 1)
- **场景**: 快速验证单条指令，调试 Prompt。
- **操作**: 在终端输入自然语言指令，即时获取结果。
- **输出**: `validation/temporary/{指令名}/`
  - `response.json`: 完整 API 响应
  - `plan.png`: 可视化任务树
  - `process.log`: 请求与响应日志

### 2. 批量/场景测试 (Mode 2)
- **场景**: 
  - **场景测试**: 验证一组预定义指令的正确性（默认运行 1 次）。
  - **稳定性测试**: 对同一组指令进行高频重复测试（如运行 10 次），检测成功率和延迟抖动。
- **操作**: 
  1. 选择指令文件（位于 `instructions/` 目录）。
  2. 输入每条指令的运行次数（默认 1）。
- **输出**: `validation/{时间戳}/`
  - `test_summary.csv`: 统计摘要（成功率、平均耗时）
  - `test_details.csv`: 每次运行的详细记录
  - `instructions_backup.txt`: 本次测试使用的指令备份
  - `{指令名}/`: 包含所有运行的 `.json` 和 `.png` 产物

## 📂 目录结构

```text
tools/test_validate/
├── instructions/               # 指令集文件 (.txt)
├── modules/                    # 功能模块
│   ├── api_client.py           # API 客户端核心
│   ├── interactive_test.py     # 交互式测试逻辑
│   ├── batch_runner.py         # 批量测试逻辑
│   ├── visualizer.py           # 可视化工具库
│   ├── llm_tester.py           # LLM 连接测试
│   └── drone_uploader.py       # 任务上传工具
├── validation/                 # 测试产物输出
│   ├── temporary/              # 交互式测试结果
│   └── {时间戳}/               # 批量测试结果
└── run_tests.py                # 主程序入口
```

## 📄 配置文件

- **instructions/validate_instructions.txt**: 默认的预定义场景指令集。
- 您可以在 `instructions/` 下添加任意 `.txt` 文件，测试时会在菜单中自动列出供选择。