DronePlanning/tools/test_validate/README.md

Test & Validation Tools (Unified)

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

🚀 快速开始

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

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 产物

📂 目录结构

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 文件，测试时会在菜单中自动列出供选择。