test：完善API测试框架

- 添加Godot内置API测试脚本
- 实现Python API客户端测试套件
- 添加快速测试和完整测试脚本
- 支持跨平台测试运行(Windows/Linux)
- 更新测试文档和使用指南

tests/api/README.md

@@ -4,7 +4,39 @@
 
 ## 测试脚本说明
 
-### 1. `simple_api_test.py` - 简化版测试
+### 1. `quick_test.py` - 快速测试（推荐）
+快速验证API接口的基本功能，适合日常检查。
+
+**使用方法：**
+```bash
+python tests/api/quick_test.py
+```
+
+**测试内容：**
+- ✅ 应用状态检查
+- ✅ 发送邮箱验证码
+- ✅ 发送验证码（无效邮箱）
+- ✅ 用户登录
+- ✅ 用户注册（无邮箱）
+- ✅ 发送登录验证码
+
+### 2. `api_client_test.py` - 完整测试套件
+全面的API接口测试，包含所有业务流程和错误场景。
+
+**使用方法：**
+```bash
+python tests/api/api_client_test.py
+```
+
+**测试内容：**
+- 🔄 完整的邮箱验证流程
+- 🔄 用户注册流程（带邮箱验证）
+- 🔄 用户登录流程（密码+验证码）
+- 🔄 密码重置流程
+- 🔄 错误场景测试
+- 🔄 频率限制测试
+
+### 3. `simple_api_test.py` - 简化版测试
 快速验证API接口的基本连通性和功能。
 
 **使用方法：**
@@ -24,7 +56,7 @@ python tests/api/simple_api_test.py http://localhost:3000
 - ✅ 无效登录测试
 - ✅ 管理员登录测试
 
-### 2. `api_test.py` - 完整版测试
+### 4. `api_test.py` - 完整版测试
 全面的API接口测试，包括边界条件和错误处理。
 
 **使用方法：**
@@ -143,8 +175,19 @@ tester.run_basic_tests()
 
 ## 依赖要求
 
+### 安装依赖
 ```bash
+# 安装Python依赖
+pip install -r tests/api/requirements.txt
+
+# 或者手动安装
 pip install requests
 ```
 
-测试脚本使用Python标准库和requests库，无需额外依赖。
+### 依赖包说明
+- **requests** - HTTP请求库，用于发送API请求
+- **json** - JSON数据处理（Python标准库）
+- **time** - 时间处理（Python标准库）
+- **sys** - 系统功能（Python标准库）
+
+测试脚本主要使用Python标准库和requests库，依赖最小化。