whale-town/HOW_TO_TEST.md

快速测试指南

快速开始

方法 1: 快速测试场景（推荐）

1. 在 Godot 编辑器中打开 scenes/TestGameplay.tscn
2. 按 F6 运行当前场景
3. 使用 WASD 或方向键移动角色

预期结果：

• ✅ 看到 Datawhale 办公室场景
• ✅ 角色可以自由移动
• ✅ 相机跟随角色
• ✅ 角色被墙壁和家具阻挡

方法 2: 完整游戏测试

1. 确保服务器正在运行：

   cd server
   yarn dev
   

2. 在 Godot 编辑器中按 F5 运行主场景

3. 输入用户名并创建角色

4. 测试移动、对话等功能

运行测试套件

属性测试

1. 在 Godot 编辑器中打开 tests/RunPropertyTests.gd
2. 按 F6 运行
3. 查看控制台输出

测试覆盖：

• 键盘输入响应
• 服务器同步
• 在线/离线角色显示
• 错误显示
• 重连机制

单元测试

运行特定测试文件：

1. 打开 tests/test_*.gd 文件
2. 按 F6 运行
3. 查看测试结果

可用测试：

• test_character_controller.gd - 角色控制器测试
• test_character_data.gd - 角色数据测试
• test_input_handler.gd - 输入处理测试
• test_game_state_manager.gd - 状态管理测试
• test_message_protocol.gd - 消息协议测试
• test_security_manager.gd - 安全管理测试
• test_rate_limiter.gd - 速率限制测试

测试功能

角色移动

• 使用 WASD 或方向键
• 角色应该平滑移动
• 不能穿过墙壁和障碍物

相机控制（调试模式）

• 移动相机: WASD 或方向键
• 缩放: 鼠标滚轮
• 重置: R 键

网络功能

• 创建角色
• 查看其他在线角色
• 角色状态同步

对话系统

• 接近其他角色
• 按 E 键交互
• 发送消息

常见问题

Q: 测试失败怎么办？ A: 查看控制台详细错误信息，确保所有文件已保存

Q: 服务器连接失败？ A: 确认服务器正在运行（yarn dev），检查端口 8080 是否被占用

Q: 角色不显示？ A: 确保游戏窗口是激活状态，检查控制台错误信息

性能测试

帧率测试

• 目标: 30+ FPS
• 查看 Godot 编辑器右上角的 FPS 显示

网络延迟

• 目标: 操作响应 < 200ms
• 观察角色移动的流畅度

下一步

• 查看 项目状态 了解已完成功能
• 查看 SETUP.md 了解开发环境配置
• 查看 server/README.md 了解服务器 API