58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
# 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` 文件，测试时会在菜单中自动列出供选择。
|