fix/verification-code-button-state #1
55
.gitignore
vendored
55
.gitignore
vendored
@@ -1,3 +1,58 @@
|
|||||||
# Godot 4+ specific ignores
|
# Godot 4+ specific ignores
|
||||||
.godot/
|
.godot/
|
||||||
/android/
|
/android/
|
||||||
|
|
||||||
|
# Python cache files
|
||||||
|
__pycache__/
|
||||||
|
*.pyc
|
||||||
|
*.pyo
|
||||||
|
*.pyd
|
||||||
|
.Python
|
||||||
|
*.so
|
||||||
|
|
||||||
|
# IDE and editor files
|
||||||
|
.vscode/
|
||||||
|
.idea/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
*~
|
||||||
|
|
||||||
|
# OS generated files
|
||||||
|
.DS_Store
|
||||||
|
.DS_Store?
|
||||||
|
._*
|
||||||
|
.Spotlight-V100
|
||||||
|
.Trashes
|
||||||
|
ehthumbs.db
|
||||||
|
Thumbs.db
|
||||||
|
|
||||||
|
# Godot executable files (should not be in version control)
|
||||||
|
Godot/
|
||||||
|
*.exe
|
||||||
|
*.app
|
||||||
|
*.dmg
|
||||||
|
|
||||||
|
# Logs and temporary files
|
||||||
|
*.log
|
||||||
|
*.tmp
|
||||||
|
*.temp
|
||||||
|
|
||||||
|
# Build outputs
|
||||||
|
build/
|
||||||
|
dist/
|
||||||
|
*.zip
|
||||||
|
*.tar.gz
|
||||||
|
|
||||||
|
# Environment files
|
||||||
|
.env
|
||||||
|
.env.local
|
||||||
|
.env.*.local
|
||||||
|
|
||||||
|
# Test coverage reports
|
||||||
|
coverage/
|
||||||
|
*.coverage
|
||||||
|
.nyc_output/
|
||||||
|
|
||||||
|
# Dependency directories
|
||||||
|
node_modules/
|
||||||
|
vendor/
|
||||||
|
|||||||
345
README.md
345
README.md
@@ -1,101 +1,274 @@
|
|||||||
# whaleTown
|
# 🐋 whaleTown
|
||||||
|
|
||||||
一个使用 Godot 4.5 引擎开发的游戏项目。
|
一个使用 Godot 4.5 引擎开发的现代化像素游戏项目，集成了完整的用户认证系统和API接口。
|
||||||
|
|
||||||
## 项目信息
|
## 🎮 项目信息
|
||||||
|
|
||||||
- **引擎版本**: Godot 4.5
|
- **引擎版本**: Godot 4.5.1
|
||||||
- **渲染器**: Forward Plus
|
- **渲染器**: Forward Plus
|
||||||
- **项目类型**: 2D 游戏
|
- **项目类型**: 2D 像素游戏
|
||||||
|
- **架构模式**: 模块化 + 事件驱动
|
||||||
|
- **后端集成**: RESTful API + 用户认证
|
||||||
|
|
||||||
## 项目结构
|
## 🚀 快速开始
|
||||||
|
|
||||||
```
|
### 环境要求
|
||||||
whaleTown/
|
- [Godot Engine 4.5+](https://godotengine.org/download)
|
||||||
├── addons/ # Godot 插件目录
|
- Python 3.7+ (用于API测试)
|
||||||
├── assets/ # 游戏资源文件（图片、音频等）
|
|
||||||
├── data/ # 游戏数据文件（配置、关卡数据等）
|
|
||||||
├── docs/ # 项目文档
|
|
||||||
├── scenes/ # 游戏场景文件
|
|
||||||
│ └── main_scene.tscn # 主场景
|
|
||||||
├── scripts/ # GDScript 脚本文件
|
|
||||||
├── tests/ # 测试文件
|
|
||||||
├── icon.svg # 项目图标
|
|
||||||
└── project.godot # Godot 项目配置文件
|
|
||||||
```
|
|
||||||
|
|
||||||
## 开始使用
|
|
||||||
|
|
||||||
### 前置要求
|
|
||||||
|
|
||||||
- [Godot Engine 4.5](https://godotengine.org/download) 或更高版本
|
|
||||||
|
|
||||||
### 运行项目
|
### 运行项目
|
||||||
|
|
||||||
1. 克隆或下载此项目
|
|
||||||
2. 使用 Godot 编辑器打开项目
|
|
||||||
3. 在编辑器中点击"运行"按钮或按 F5 键启动游戏
|
|
||||||
|
|
||||||
### 开发指南
|
|
||||||
|
|
||||||
- **场景文件**: 所有场景文件存放在 `scenes/` 目录
|
|
||||||
- **脚本文件**: 所有 GDScript 脚本存放在 `scripts/` 目录
|
|
||||||
- **资源文件**: 图片、音频等资源存放在 `assets/` 目录
|
|
||||||
- **游戏数据**: 配置文件、关卡数据等存放在 `data/` 目录
|
|
||||||
|
|
||||||
### 命名规范
|
|
||||||
|
|
||||||
本项目遵循统一的命名规范以保持代码一致性：
|
|
||||||
|
|
||||||
**核心规则**：
|
|
||||||
|
|
||||||
- **场景文件**：`下划线_scene.tscn` 或 `下划线_prefab.tscn`
|
|
||||||
- 示例：`main_scene.tscn`、`player_prefab.tscn`
|
|
||||||
- **脚本文件**：`PascalCase.gd`（大驼峰）
|
|
||||||
- 示例：`PlayerController.gd`、`UI_MainMenu.gd`
|
|
||||||
- **节点名称**：`camelCase`（小驼峰）
|
|
||||||
- 示例：`playerHpBar`、`startButton`
|
|
||||||
- **变量/函数**：`camelCase`（小驼峰）
|
|
||||||
- 示例：`var moveSpeed`、`func getPlayerPos()`
|
|
||||||
- **常量**：`UPPER_CASE`（全大写 + 下划线）
|
|
||||||
- 示例：`const MAX_HEALTH = 100`
|
|
||||||
- **资源文件**：`lower_case`（小写 + 下划线）
|
|
||||||
- 示例：`bg_main_menu.png`、`sound_jump.wav`
|
|
||||||
|
|
||||||
📖 查看完整的 [命名规范文档](docs/naming_convention.md)
|
|
||||||
|
|
||||||
### Git 提交规范
|
|
||||||
|
|
||||||
本项目遵循统一的 Git 提交信息格式：`<类型>：<描述>`
|
|
||||||
|
|
||||||
**常用提交类型**：
|
|
||||||
|
|
||||||
- `init`：项目初始化
|
|
||||||
- `feat`：新增功能
|
|
||||||
- `fix`：修复 Bug
|
|
||||||
- `docs`：文档更新
|
|
||||||
- `scene`：场景文件相关
|
|
||||||
- `asset`：资源文件相关
|
|
||||||
- `ui`：UI 界面相关
|
|
||||||
- `gameplay`：游戏玩法相关
|
|
||||||
- `refactor`：代码重构
|
|
||||||
- `perf`：性能优化
|
|
||||||
|
|
||||||
**提交示例**：
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git commit -m "init：项目初始化，搭建Godot文件结构"
|
# 1. 克隆项目
|
||||||
git commit -m "feat：实现玩家角色的移动和跳跃"
|
git clone <repository-url>
|
||||||
git commit -m "fix：修复敌人穿墙的碰撞问题"
|
cd whale-town
|
||||||
git commit -m "scene：创建战斗场景并配置相机"
|
|
||||||
|
# 2. 使用Godot编辑器打开项目
|
||||||
|
# 3. 按F5运行或点击"运行"按钮
|
||||||
|
|
||||||
|
# 4. 测试API接口（可选）
|
||||||
|
python tests/api/simple_api_test.py
|
||||||
```
|
```
|
||||||
|
|
||||||
📖 查看完整的 [Git 提交规范文档](docs/git_commit_guide.md)
|
## 🏗️ 项目架构
|
||||||
|
|
||||||
## 贡献
|
### 核心设计理念
|
||||||
|
- **场景独立性** - 每个场景都是独立的功能模块
|
||||||
|
- **高度解耦** - 通过事件系统和管理器通信
|
||||||
|
- **组件复用** - 可复用组件统一管理
|
||||||
|
- **标准化** - 统一的命名规范和目录结构
|
||||||
|
- **测试驱动** - 完整的测试体系和文档
|
||||||
|
|
||||||
欢迎提交 Issue 和 Pull Request！
|
### 目录结构
|
||||||
|
```
|
||||||
|
whaleTown/
|
||||||
|
├── 🎬 scenes/ # 游戏场景
|
||||||
|
│ ├── auth_scene.tscn # 用户认证场景
|
||||||
|
│ ├── main_scene.tscn # 主游戏场景
|
||||||
|
│ └── prefabs/ # 预制体组件
|
||||||
|
├── 🔧 core/ # 核心系统（自动加载）
|
||||||
|
│ ├── managers/ # 全局管理器
|
||||||
|
│ ├── systems/ # 系统组件
|
||||||
|
│ └── utils/ # 工具类
|
||||||
|
├── 📝 scripts/ # 业务逻辑脚本
|
||||||
|
│ ├── scenes/ # 场景脚本
|
||||||
|
│ ├── network/ # 网络相关
|
||||||
|
│ └── ui/ # UI组件脚本
|
||||||
|
├── 🧩 module/ # 可复用模块
|
||||||
|
│ ├── UI/ # UI组件模块
|
||||||
|
│ ├── Character/ # 角色模块
|
||||||
|
│ ├── Combat/ # 战斗模块
|
||||||
|
│ ├── Dialogue/ # 对话模块
|
||||||
|
│ └── Inventory/ # 背包模块
|
||||||
|
├── 🎨 assets/ # 游戏资源
|
||||||
|
│ ├── sprites/ # 精灵图资源
|
||||||
|
│ ├── audio/ # 音频文件
|
||||||
|
│ ├── ui/ # UI界面资源
|
||||||
|
│ ├── fonts/ # 字体资源
|
||||||
|
│ ├── materials/ # 材质资源
|
||||||
|
│ └── shaders/ # 着色器资源
|
||||||
|
├── 📊 data/ # 配置数据
|
||||||
|
│ ├── configs/ # 游戏配置
|
||||||
|
│ ├── localization/ # 本地化文件
|
||||||
|
│ ├── characters/ # 角色数据
|
||||||
|
│ ├── items/ # 物品数据
|
||||||
|
│ ├── levels/ # 关卡数据
|
||||||
|
│ └── dialogues/ # 对话数据
|
||||||
|
├── 🧪 tests/ # 测试文件
|
||||||
|
│ ├── api/ # API接口测试
|
||||||
|
│ ├── auth/ # 认证UI测试
|
||||||
|
│ ├── unit/ # 单元测试
|
||||||
|
│ ├── integration/ # 集成测试
|
||||||
|
│ └── performance/ # 性能测试
|
||||||
|
└── 📚 docs/ # 项目文档
|
||||||
|
├── auth/ # 认证相关文档
|
||||||
|
├── api-documentation.md # API接口文档
|
||||||
|
├── project_structure.md # 项目结构说明
|
||||||
|
├── naming_convention.md # 命名规范
|
||||||
|
├── code_comment_guide.md # 代码注释规范
|
||||||
|
└── git_commit_guide.md # Git提交规范
|
||||||
|
```
|
||||||
|
|
||||||
## 许可证
|
### 核心系统
|
||||||
|
项目包含以下自动加载的核心系统：
|
||||||
|
|
||||||
[在此添加许可证信息]
|
- **GameManager** - 全局游戏状态管理
|
||||||
|
- **SceneManager** - 场景切换管理
|
||||||
|
- **EventSystem** - 事件通信系统
|
||||||
|
|
||||||
|
使用示例：
|
||||||
|
```gdscript
|
||||||
|
# 状态管理
|
||||||
|
GameManager.change_state(GameManager.GameState.IN_GAME)
|
||||||
|
|
||||||
|
# 场景切换
|
||||||
|
SceneManager.change_scene("battle")
|
||||||
|
|
||||||
|
# 事件通信
|
||||||
|
EventSystem.emit_event("player_health_changed", 80)
|
||||||
|
EventSystem.connect_event("player_died", _on_player_died)
|
||||||
|
```
|
||||||
|
|
||||||
|
## ✨ 主要功能
|
||||||
|
|
||||||
|
### 🔐 用户认证系统
|
||||||
|
- **用户注册** - 支持邮箱验证码验证
|
||||||
|
- **用户登录** - 多种登录方式（用户名/邮箱/手机号）
|
||||||
|
- **密码管理** - 密码重置和修改功能
|
||||||
|
- **GitHub OAuth** - 第三方登录集成
|
||||||
|
- **错误处理** - 完整的错误提示和频率限制
|
||||||
|
|
||||||
|
### 🎮 游戏功能
|
||||||
|
- **主场景** - 游戏主界面和菜单系统
|
||||||
|
- **认证场景** - 完整的登录注册界面
|
||||||
|
- **状态管理** - 用户状态和游戏状态管理
|
||||||
|
- **网络通信** - RESTful API集成
|
||||||
|
|
||||||
|
### 🧪 测试体系
|
||||||
|
- **API测试** - 完整的接口测试脚本
|
||||||
|
- **UI测试** - 认证界面的交互测试
|
||||||
|
- **错误场景** - 边界条件和异常处理测试
|
||||||
|
|
||||||
|
## 🔧 开发规范
|
||||||
|
|
||||||
|
### 命名规范
|
||||||
|
- **场景文件**: `snake_case_scene.tscn` (如: `auth_scene.tscn`)
|
||||||
|
- **脚本文件**: `PascalCase.gd` (如: `AuthScene.gd`)
|
||||||
|
- **节点名称**: `camelCase` (如: `loginButton`)
|
||||||
|
- **变量/函数**: `camelCase` (如: `playerHealth`)
|
||||||
|
- **常量**: `UPPER_CASE` (如: `MAX_HEALTH`)
|
||||||
|
- **资源文件**: `snake_case` (如: `bg_auth_scene.png`)
|
||||||
|
|
||||||
|
### 代码注释规范
|
||||||
|
- **文件头注释**: 说明文件用途、主要功能和依赖关系
|
||||||
|
- **函数注释**: 包含参数说明、返回值和使用示例
|
||||||
|
- **复杂逻辑**: 添加行内注释解释业务逻辑和设计决策
|
||||||
|
- **特殊标记**: 使用 TODO、FIXME、NOTE 等标准标记
|
||||||
|
- **AI辅助**: 支持AI补充注释，提供详细的上下文信息
|
||||||
|
|
||||||
|
### Git 提交规范
|
||||||
|
使用格式：`<类型>：<描述>`
|
||||||
|
|
||||||
|
常用类型：`feat` `fix` `docs` `refactor` `scene` `asset` `ui` `test`
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git commit -m "feat：实现用户登录功能"
|
||||||
|
git commit -m "fix：修复429错误处理"
|
||||||
|
git commit -m "test：添加API接口测试"
|
||||||
|
git commit -m "docs：更新项目文档"
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📚 项目文档
|
||||||
|
|
||||||
|
### 核心文档
|
||||||
|
- 📋 [项目结构详解](docs/project_structure.md) - 完整的架构说明
|
||||||
|
- 📝 [命名规范](docs/naming_convention.md) - 详细的命名规则
|
||||||
|
- 💬 [代码注释规范](docs/code_comment_guide.md) - 注释标准和AI辅助指南
|
||||||
|
- 🔀 [Git提交规范](docs/git_commit_guide.md) - 提交信息标准
|
||||||
|
|
||||||
|
### API和测试文档
|
||||||
|
- 🔌 [API接口文档](docs/api-documentation.md) - 完整的API说明和测试指南
|
||||||
|
- 🔐 [认证系统文档](docs/auth/) - 用户认证相关文档
|
||||||
|
- 🧪 [API测试指南](tests/api/README.md) - API测试使用方法
|
||||||
|
- 🎮 [认证UI测试](tests/auth/README.md) - UI测试场景说明
|
||||||
|
|
||||||
|
## 🛠️ 开发指南
|
||||||
|
|
||||||
|
### 添加新场景
|
||||||
|
1. 在 `scenes/` 创建场景文件
|
||||||
|
2. 在 `scripts/scenes/` 创建对应脚本
|
||||||
|
3. 在 `SceneManager` 中注册场景路径
|
||||||
|
4. 使用 `SceneManager.change_scene()` 切换
|
||||||
|
|
||||||
|
### 创建可复用组件
|
||||||
|
1. 在 `module/` 对应分类下创建组件
|
||||||
|
2. 实现标准接口
|
||||||
|
3. 通过 `EventSystem` 与其他模块通信
|
||||||
|
4. 在 `scenes/prefabs/` 创建预制体
|
||||||
|
|
||||||
|
### 资源管理
|
||||||
|
- 图片资源放入 `assets/sprites/` 对应分类
|
||||||
|
- 音频文件放入 `assets/audio/` 对应分类
|
||||||
|
- UI资源放入 `assets/ui/` 对应分类
|
||||||
|
- 配置文件放入 `data/configs/`
|
||||||
|
- 遵循命名规范，使用英文小写+下划线
|
||||||
|
|
||||||
|
### API接口测试
|
||||||
|
项目提供了完整的Python测试脚本来验证API接口：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 快速测试API连通性
|
||||||
|
python tests/api/simple_api_test.py
|
||||||
|
|
||||||
|
# 完整的API功能测试
|
||||||
|
python tests/api/api_test.py --verbose
|
||||||
|
|
||||||
|
# 自定义服务器地址测试
|
||||||
|
python tests/api/simple_api_test.py https://your-api-server.com
|
||||||
|
```
|
||||||
|
|
||||||
|
测试脚本会验证：
|
||||||
|
- ✅ 应用状态检查
|
||||||
|
- ✅ 用户注册和登录功能
|
||||||
|
- ✅ 邮箱验证码发送和验证
|
||||||
|
- ✅ 错误处理和频率限制（429错误）
|
||||||
|
- ✅ 管理员功能和权限控制
|
||||||
|
- ✅ 用户状态管理
|
||||||
|
- ✅ 安全功能测试
|
||||||
|
|
||||||
|
📖 查看 [API测试文档](tests/api/README.md) 了解详细使用方法
|
||||||
|
|
||||||
|
### 认证UI测试
|
||||||
|
项目还提供了Godot内置的UI测试场景：
|
||||||
|
|
||||||
|
1. 在Godot编辑器中打开 `tests/auth/auth_ui_test.tscn`
|
||||||
|
2. 运行场景进行交互式测试
|
||||||
|
3. 测试各种错误场景和边界条件
|
||||||
|
|
||||||
|
📖 查看 [认证UI测试文档](tests/auth/README.md) 了解详细使用方法
|
||||||
|
|
||||||
|
## 🔧 技术栈
|
||||||
|
|
||||||
|
- **游戏引擎**: Godot 4.5.1
|
||||||
|
- **脚本语言**: GDScript
|
||||||
|
- **架构模式**: 模块化 + 事件驱动
|
||||||
|
- **状态管理**: 单例管理器模式
|
||||||
|
- **通信机制**: 全局事件系统
|
||||||
|
- **API集成**: RESTful API + JSON
|
||||||
|
- **测试框架**: Python + Godot内置测试
|
||||||
|
|
||||||
|
## 🤝 贡献指南
|
||||||
|
|
||||||
|
1. Fork 项目
|
||||||
|
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
|
||||||
|
3. 遵循项目的命名规范和架构设计
|
||||||
|
4. 添加相应的测试用例
|
||||||
|
5. 更新相关文档
|
||||||
|
6. 提交更改 (`git commit -m 'feat：添加某个功能'`)
|
||||||
|
7. 推送到分支 (`git push origin feature/AmazingFeature`)
|
||||||
|
8. 开启 Pull Request
|
||||||
|
|
||||||
|
### 贡献类型
|
||||||
|
- 🐛 Bug修复
|
||||||
|
- ✨ 新功能开发
|
||||||
|
- 📚 文档改进
|
||||||
|
- 🧪 测试用例
|
||||||
|
- 🎨 UI/UX改进
|
||||||
|
- ⚡ 性能优化
|
||||||
|
|
||||||
|
## 📄 许可证
|
||||||
|
|
||||||
|
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 项目状态
|
||||||
|
|
||||||
|
- ✅ 基础架构搭建完成
|
||||||
|
- ✅ 用户认证系统完成
|
||||||
|
- ✅ API接口集成完成
|
||||||
|
- ✅ 测试体系建立完成
|
||||||
|
- ✅ 文档体系完善
|
||||||
|
- 🚧 游戏核心玩法开发中
|
||||||
|
- 🚧 更多功能模块开发中
|
||||||
|
|
||||||
|
**最后更新**: 2025-12-24
|
||||||
|
|||||||
1
assets/audio/music/.gitkeep
Normal file
1
assets/audio/music/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 音乐资源目录
|
||||||
1
assets/audio/sounds/.gitkeep
Normal file
1
assets/audio/sounds/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 音效资源目录
|
||||||
1
assets/audio/voice/.gitkeep
Normal file
1
assets/audio/voice/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 语音资源目录
|
||||||
1
assets/fonts/.gitkeep
Normal file
1
assets/fonts/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 字体资源目录
|
||||||
1
assets/materials/.gitkeep
Normal file
1
assets/materials/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 材质资源目录
|
||||||
1
assets/shaders/.gitkeep
Normal file
1
assets/shaders/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 着色器资源目录
|
||||||
1
assets/sprites/characters/.gitkeep
Normal file
1
assets/sprites/characters/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 角色精灵资源目录
|
||||||
1
assets/sprites/effects/.gitkeep
Normal file
1
assets/sprites/effects/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 特效精灵资源目录
|
||||||
1
assets/sprites/environment/.gitkeep
Normal file
1
assets/sprites/environment/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 环境精灵资源目录
|
||||||
BIN
assets/ui/auth/bg_auth_scene.png
Normal file
BIN
assets/ui/auth/bg_auth_scene.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 5.7 MiB |
40
assets/ui/auth/bg_auth_scene.png.import
Normal file
40
assets/ui/auth/bg_auth_scene.png.import
Normal file
@@ -0,0 +1,40 @@
|
|||||||
|
[remap]
|
||||||
|
|
||||||
|
importer="texture"
|
||||||
|
type="CompressedTexture2D"
|
||||||
|
uid="uid://bx17oy8lvaca4"
|
||||||
|
path="res://.godot/imported/bg_auth_scene.png-818065fcc20397e855c75507c1313623.ctex"
|
||||||
|
metadata={
|
||||||
|
"vram_texture": false
|
||||||
|
}
|
||||||
|
|
||||||
|
[deps]
|
||||||
|
|
||||||
|
source_file="res://assets/ui/auth/bg_auth_scene.png"
|
||||||
|
dest_files=["res://.godot/imported/bg_auth_scene.png-818065fcc20397e855c75507c1313623.ctex"]
|
||||||
|
|
||||||
|
[params]
|
||||||
|
|
||||||
|
compress/mode=0
|
||||||
|
compress/high_quality=false
|
||||||
|
compress/lossy_quality=0.7
|
||||||
|
compress/uastc_level=0
|
||||||
|
compress/rdo_quality_loss=0.0
|
||||||
|
compress/hdr_compression=1
|
||||||
|
compress/normal_map=0
|
||||||
|
compress/channel_pack=0
|
||||||
|
mipmaps/generate=false
|
||||||
|
mipmaps/limit=-1
|
||||||
|
roughness/mode=0
|
||||||
|
roughness/src_normal=""
|
||||||
|
process/channel_remap/red=0
|
||||||
|
process/channel_remap/green=1
|
||||||
|
process/channel_remap/blue=2
|
||||||
|
process/channel_remap/alpha=3
|
||||||
|
process/fix_alpha_border=true
|
||||||
|
process/premult_alpha=false
|
||||||
|
process/normal_map_invert_y=false
|
||||||
|
process/hdr_as_srgb=false
|
||||||
|
process/hdr_clamp_exposure=false
|
||||||
|
process/size_limit=0
|
||||||
|
detect_3d/compress_to=1
|
||||||
BIN
assets/ui/auth/login_frame_smart_transparent.png
Normal file
BIN
assets/ui/auth/login_frame_smart_transparent.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 587 KiB |
40
assets/ui/auth/login_frame_smart_transparent.png.import
Normal file
40
assets/ui/auth/login_frame_smart_transparent.png.import
Normal file
@@ -0,0 +1,40 @@
|
|||||||
|
[remap]
|
||||||
|
|
||||||
|
importer="texture"
|
||||||
|
type="CompressedTexture2D"
|
||||||
|
uid="uid://de4q4s1gxivtf"
|
||||||
|
path="res://.godot/imported/login_frame_smart_transparent.png-e5d0fd05b4713ddd3beae8223f2abb80.ctex"
|
||||||
|
metadata={
|
||||||
|
"vram_texture": false
|
||||||
|
}
|
||||||
|
|
||||||
|
[deps]
|
||||||
|
|
||||||
|
source_file="res://assets/ui/auth/login_frame_smart_transparent.png"
|
||||||
|
dest_files=["res://.godot/imported/login_frame_smart_transparent.png-e5d0fd05b4713ddd3beae8223f2abb80.ctex"]
|
||||||
|
|
||||||
|
[params]
|
||||||
|
|
||||||
|
compress/mode=0
|
||||||
|
compress/high_quality=false
|
||||||
|
compress/lossy_quality=0.7
|
||||||
|
compress/uastc_level=0
|
||||||
|
compress/rdo_quality_loss=0.0
|
||||||
|
compress/hdr_compression=1
|
||||||
|
compress/normal_map=0
|
||||||
|
compress/channel_pack=0
|
||||||
|
mipmaps/generate=false
|
||||||
|
mipmaps/limit=-1
|
||||||
|
roughness/mode=0
|
||||||
|
roughness/src_normal=""
|
||||||
|
process/channel_remap/red=0
|
||||||
|
process/channel_remap/green=1
|
||||||
|
process/channel_remap/blue=2
|
||||||
|
process/channel_remap/alpha=3
|
||||||
|
process/fix_alpha_border=true
|
||||||
|
process/premult_alpha=false
|
||||||
|
process/normal_map_invert_y=false
|
||||||
|
process/hdr_as_srgb=false
|
||||||
|
process/hdr_clamp_exposure=false
|
||||||
|
process/size_limit=0
|
||||||
|
detect_3d/compress_to=1
|
||||||
1
core/components/.gitkeep
Normal file
1
core/components/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 组件脚本目录
|
||||||
1
core/input_box/.gitkeep
Normal file
1
core/input_box/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 输入框组件目录
|
||||||
1
core/interfaces/.gitkeep
Normal file
1
core/interfaces/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 接口定义目录
|
||||||
50
core/managers/GameManager.gd
Normal file
50
core/managers/GameManager.gd
Normal file
@@ -0,0 +1,50 @@
|
|||||||
|
extends Node
|
||||||
|
|
||||||
|
# 游戏管理器 - 全局游戏状态管理
|
||||||
|
# 单例模式，管理游戏的整体状态和生命周期
|
||||||
|
|
||||||
|
signal game_state_changed(new_state: GameState)
|
||||||
|
|
||||||
|
enum GameState {
|
||||||
|
LOADING, # 加载中
|
||||||
|
AUTH, # 认证状态
|
||||||
|
MAIN_MENU, # 主菜单
|
||||||
|
IN_GAME, # 游戏中
|
||||||
|
PAUSED, # 暂停
|
||||||
|
SETTINGS # 设置
|
||||||
|
}
|
||||||
|
|
||||||
|
var current_state: GameState = GameState.LOADING
|
||||||
|
var previous_state: GameState = GameState.LOADING
|
||||||
|
var current_user: String = ""
|
||||||
|
var game_version: String = "1.0.0"
|
||||||
|
|
||||||
|
func _ready():
|
||||||
|
print("GameManager 初始化完成")
|
||||||
|
change_state(GameState.AUTH)
|
||||||
|
|
||||||
|
func change_state(new_state: GameState):
|
||||||
|
if current_state == new_state:
|
||||||
|
return
|
||||||
|
|
||||||
|
previous_state = current_state
|
||||||
|
current_state = new_state
|
||||||
|
|
||||||
|
print("游戏状态变更: ", GameState.keys()[previous_state], " -> ", GameState.keys()[current_state])
|
||||||
|
game_state_changed.emit(new_state)
|
||||||
|
|
||||||
|
func get_current_state() -> GameState:
|
||||||
|
return current_state
|
||||||
|
|
||||||
|
func get_previous_state() -> GameState:
|
||||||
|
return previous_state
|
||||||
|
|
||||||
|
func set_current_user(username: String):
|
||||||
|
current_user = username
|
||||||
|
print("当前用户设置为: ", username)
|
||||||
|
|
||||||
|
func get_current_user() -> String:
|
||||||
|
return current_user
|
||||||
|
|
||||||
|
func is_user_logged_in() -> bool:
|
||||||
|
return not current_user.is_empty()
|
||||||
1
core/managers/GameManager.gd.uid
Normal file
1
core/managers/GameManager.gd.uid
Normal file
@@ -0,0 +1 @@
|
|||||||
|
uid://c6bl6k5kkfah6
|
||||||
75
core/managers/SceneManager.gd
Normal file
75
core/managers/SceneManager.gd
Normal file
@@ -0,0 +1,75 @@
|
|||||||
|
extends Node
|
||||||
|
|
||||||
|
# 场景管理器 - 负责场景切换和管理
|
||||||
|
# 提供场景切换的统一接口
|
||||||
|
|
||||||
|
signal scene_changed(scene_name: String)
|
||||||
|
signal scene_change_started(scene_name: String)
|
||||||
|
|
||||||
|
var current_scene_name: String = ""
|
||||||
|
var is_changing_scene: bool = false
|
||||||
|
|
||||||
|
# 场景路径映射
|
||||||
|
var scene_paths: Dictionary = {
|
||||||
|
"main": "res://scenes/main_scene.tscn",
|
||||||
|
"auth": "res://scenes/auth_scene.tscn",
|
||||||
|
"game": "res://scenes/game_scene.tscn",
|
||||||
|
"battle": "res://scenes/battle_scene.tscn",
|
||||||
|
"inventory": "res://scenes/inventory_scene.tscn",
|
||||||
|
"shop": "res://scenes/shop_scene.tscn",
|
||||||
|
"settings": "res://scenes/settings_scene.tscn"
|
||||||
|
}
|
||||||
|
|
||||||
|
func _ready():
|
||||||
|
print("SceneManager 初始化完成")
|
||||||
|
|
||||||
|
func change_scene(scene_name: String, use_transition: bool = true):
|
||||||
|
if is_changing_scene:
|
||||||
|
print("场景切换中，忽略新的切换请求")
|
||||||
|
return false
|
||||||
|
|
||||||
|
if not scene_paths.has(scene_name):
|
||||||
|
print("错误: 未找到场景 ", scene_name)
|
||||||
|
return false
|
||||||
|
|
||||||
|
var scene_path = scene_paths[scene_name]
|
||||||
|
print("开始切换场景: ", current_scene_name, " -> ", scene_name)
|
||||||
|
|
||||||
|
is_changing_scene = true
|
||||||
|
scene_change_started.emit(scene_name)
|
||||||
|
|
||||||
|
if use_transition:
|
||||||
|
await show_transition()
|
||||||
|
|
||||||
|
var error = get_tree().change_scene_to_file(scene_path)
|
||||||
|
if error != OK:
|
||||||
|
print("场景切换失败: ", error)
|
||||||
|
is_changing_scene = false
|
||||||
|
return false
|
||||||
|
|
||||||
|
current_scene_name = scene_name
|
||||||
|
is_changing_scene = false
|
||||||
|
scene_changed.emit(scene_name)
|
||||||
|
|
||||||
|
if use_transition:
|
||||||
|
await hide_transition()
|
||||||
|
|
||||||
|
print("场景切换完成: ", scene_name)
|
||||||
|
return true
|
||||||
|
|
||||||
|
func get_current_scene_name() -> String:
|
||||||
|
return current_scene_name
|
||||||
|
|
||||||
|
func register_scene(scene_name: String, scene_path: String):
|
||||||
|
scene_paths[scene_name] = scene_path
|
||||||
|
print("注册场景: ", scene_name, " -> ", scene_path)
|
||||||
|
|
||||||
|
func show_transition():
|
||||||
|
# TODO: 实现场景切换过渡效果
|
||||||
|
print("显示场景切换过渡效果")
|
||||||
|
await get_tree().create_timer(0.2).timeout
|
||||||
|
|
||||||
|
func hide_transition():
|
||||||
|
# TODO: 隐藏场景切换过渡效果
|
||||||
|
print("隐藏场景切换过渡效果")
|
||||||
|
await get_tree().create_timer(0.2).timeout
|
||||||
1
core/managers/SceneManager.gd.uid
Normal file
1
core/managers/SceneManager.gd.uid
Normal file
@@ -0,0 +1 @@
|
|||||||
|
uid://bf5bmaqwstpuq
|
||||||
80
core/systems/EventSystem.gd
Normal file
80
core/systems/EventSystem.gd
Normal file
@@ -0,0 +1,80 @@
|
|||||||
|
extends Node
|
||||||
|
|
||||||
|
# 全局事件系统 - 提供解耦的事件通信机制
|
||||||
|
# 允许不同模块之间通过事件进行通信，避免直接依赖
|
||||||
|
|
||||||
|
# 事件监听器存储
|
||||||
|
var event_listeners: Dictionary = {}
|
||||||
|
|
||||||
|
func _ready():
|
||||||
|
print("EventSystem 初始化完成")
|
||||||
|
|
||||||
|
# 注册事件监听器
|
||||||
|
func connect_event(event_name: String, callback: Callable, target: Node = null):
|
||||||
|
if not event_listeners.has(event_name):
|
||||||
|
event_listeners[event_name] = []
|
||||||
|
|
||||||
|
var listener_info = {
|
||||||
|
"callback": callback,
|
||||||
|
"target": target
|
||||||
|
}
|
||||||
|
|
||||||
|
event_listeners[event_name].append(listener_info)
|
||||||
|
print("注册事件监听器: ", event_name, " -> ", callback)
|
||||||
|
|
||||||
|
# 移除事件监听器
|
||||||
|
func disconnect_event(event_name: String, callback: Callable, target: Node = null):
|
||||||
|
if not event_listeners.has(event_name):
|
||||||
|
return
|
||||||
|
|
||||||
|
var listeners = event_listeners[event_name]
|
||||||
|
for i in range(listeners.size() - 1, -1, -1):
|
||||||
|
var listener = listeners[i]
|
||||||
|
if listener.callback == callback and listener.target == target:
|
||||||
|
listeners.remove_at(i)
|
||||||
|
print("移除事件监听器: ", event_name, " -> ", callback)
|
||||||
|
break
|
||||||
|
|
||||||
|
# 发送事件
|
||||||
|
func emit_event(event_name: String, data: Variant = null):
|
||||||
|
print("发送事件: ", event_name, " 数据: ", data)
|
||||||
|
|
||||||
|
if not event_listeners.has(event_name):
|
||||||
|
return
|
||||||
|
|
||||||
|
var listeners = event_listeners[event_name]
|
||||||
|
for listener_info in listeners:
|
||||||
|
var target = listener_info.target
|
||||||
|
var callback = listener_info.callback
|
||||||
|
|
||||||
|
# 检查目标节点是否仍然有效
|
||||||
|
if target != null and not is_instance_valid(target):
|
||||||
|
continue
|
||||||
|
|
||||||
|
# 调用回调函数
|
||||||
|
if data != null:
|
||||||
|
callback.call(data)
|
||||||
|
else:
|
||||||
|
callback.call()
|
||||||
|
|
||||||
|
# 清理无效的监听器
|
||||||
|
func cleanup_invalid_listeners():
|
||||||
|
for event_name in event_listeners.keys():
|
||||||
|
var listeners = event_listeners[event_name]
|
||||||
|
for i in range(listeners.size() - 1, -1, -1):
|
||||||
|
var listener = listeners[i]
|
||||||
|
var target = listener.target
|
||||||
|
if target != null and not is_instance_valid(target):
|
||||||
|
listeners.remove_at(i)
|
||||||
|
print("清理无效监听器: ", event_name)
|
||||||
|
|
||||||
|
# 获取事件监听器数量
|
||||||
|
func get_listener_count(event_name: String) -> int:
|
||||||
|
if not event_listeners.has(event_name):
|
||||||
|
return 0
|
||||||
|
return event_listeners[event_name].size()
|
||||||
|
|
||||||
|
# 清空所有事件监听器
|
||||||
|
func clear_all_listeners():
|
||||||
|
event_listeners.clear()
|
||||||
|
print("清空所有事件监听器")
|
||||||
1
core/systems/EventSystem.gd.uid
Normal file
1
core/systems/EventSystem.gd.uid
Normal file
@@ -0,0 +1 @@
|
|||||||
|
uid://csuxtwgni1dmf
|
||||||
105
core/utils/StringUtils.gd
Normal file
105
core/utils/StringUtils.gd
Normal file
@@ -0,0 +1,105 @@
|
|||||||
|
class_name StringUtils
|
||||||
|
|
||||||
|
# 字符串工具类 - 提供常用的字符串处理功能
|
||||||
|
|
||||||
|
# 验证邮箱格式
|
||||||
|
static func is_valid_email(email: String) -> bool:
|
||||||
|
var regex = RegEx.new()
|
||||||
|
regex.compile("^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$")
|
||||||
|
return regex.search(email) != null
|
||||||
|
|
||||||
|
# 验证用户名格式（字母、数字、下划线）
|
||||||
|
static func is_valid_username(username: String) -> bool:
|
||||||
|
if username.is_empty() or username.length() > 50:
|
||||||
|
return false
|
||||||
|
|
||||||
|
var regex = RegEx.new()
|
||||||
|
regex.compile("^[a-zA-Z0-9_]+$")
|
||||||
|
return regex.search(username) != null
|
||||||
|
|
||||||
|
# 验证密码强度
|
||||||
|
static func validate_password_strength(password: String) -> Dictionary:
|
||||||
|
var result = {"valid": false, "message": "", "strength": 0}
|
||||||
|
|
||||||
|
if password.length() < 8:
|
||||||
|
result.message = "密码长度至少8位"
|
||||||
|
return result
|
||||||
|
|
||||||
|
if password.length() > 128:
|
||||||
|
result.message = "密码长度不能超过128位"
|
||||||
|
return result
|
||||||
|
|
||||||
|
var has_letter = false
|
||||||
|
var has_digit = false
|
||||||
|
var has_special = false
|
||||||
|
|
||||||
|
for i in range(password.length()):
|
||||||
|
var char = password[i]
|
||||||
|
if char >= 'a' and char <= 'z' or char >= 'A' and char <= 'Z':
|
||||||
|
has_letter = true
|
||||||
|
elif char >= '0' and char <= '9':
|
||||||
|
has_digit = true
|
||||||
|
elif char in "!@#$%^&*()_+-=[]{}|;:,.<>?":
|
||||||
|
has_special = true
|
||||||
|
|
||||||
|
var strength = 0
|
||||||
|
if has_letter:
|
||||||
|
strength += 1
|
||||||
|
if has_digit:
|
||||||
|
strength += 1
|
||||||
|
if has_special:
|
||||||
|
strength += 1
|
||||||
|
if password.length() >= 12:
|
||||||
|
strength += 1
|
||||||
|
|
||||||
|
result.strength = strength
|
||||||
|
|
||||||
|
if not (has_letter and has_digit):
|
||||||
|
result.message = "密码必须包含字母和数字"
|
||||||
|
return result
|
||||||
|
|
||||||
|
result.valid = true
|
||||||
|
result.message = "密码强度: " + ["弱", "中", "强", "很强"][min(strength - 1, 3)]
|
||||||
|
return result
|
||||||
|
|
||||||
|
# 截断字符串
|
||||||
|
static func truncate(text: String, max_length: int, suffix: String = "...") -> String:
|
||||||
|
if text.length() <= max_length:
|
||||||
|
return text
|
||||||
|
return text.substr(0, max_length - suffix.length()) + suffix
|
||||||
|
|
||||||
|
# 首字母大写
|
||||||
|
static func capitalize_first(text: String) -> String:
|
||||||
|
if text.is_empty():
|
||||||
|
return text
|
||||||
|
return text[0].to_upper() + text.substr(1)
|
||||||
|
|
||||||
|
# 转换为标题格式（每个单词首字母大写）
|
||||||
|
static func to_title_case(text: String) -> String:
|
||||||
|
var words = text.split(" ")
|
||||||
|
var result = []
|
||||||
|
for word in words:
|
||||||
|
if not word.is_empty():
|
||||||
|
result.append(capitalize_first(word.to_lower()))
|
||||||
|
return " ".join(result)
|
||||||
|
|
||||||
|
# 移除HTML标签
|
||||||
|
static func strip_html_tags(html: String) -> String:
|
||||||
|
var regex = RegEx.new()
|
||||||
|
regex.compile("<[^>]*>")
|
||||||
|
return regex.sub(html, "", true)
|
||||||
|
|
||||||
|
# 格式化文件大小
|
||||||
|
static func format_file_size(bytes: int) -> String:
|
||||||
|
var units = ["B", "KB", "MB", "GB", "TB"]
|
||||||
|
var size = float(bytes)
|
||||||
|
var unit_index = 0
|
||||||
|
|
||||||
|
while size >= 1024.0 and unit_index < units.size() - 1:
|
||||||
|
size /= 1024.0
|
||||||
|
unit_index += 1
|
||||||
|
|
||||||
|
if unit_index == 0:
|
||||||
|
return str(int(size)) + " " + units[unit_index]
|
||||||
|
else:
|
||||||
|
return "%.1f %s" % [size, units[unit_index]]
|
||||||
1
core/utils/StringUtils.gd.uid
Normal file
1
core/utils/StringUtils.gd.uid
Normal file
@@ -0,0 +1 @@
|
|||||||
|
uid://bturviv4bm4yk
|
||||||
1
data/characters/.gitkeep
Normal file
1
data/characters/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 角色数据目录
|
||||||
29
data/configs/game_config.json
Normal file
29
data/configs/game_config.json
Normal file
@@ -0,0 +1,29 @@
|
|||||||
|
{
|
||||||
|
"game": {
|
||||||
|
"name": "whaleTown",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"debug_mode": true
|
||||||
|
},
|
||||||
|
"network": {
|
||||||
|
"api_base_url": "https://whaletownend.xinghangee.icu",
|
||||||
|
"timeout": 30,
|
||||||
|
"retry_count": 3
|
||||||
|
},
|
||||||
|
"ui": {
|
||||||
|
"default_font_size": 14,
|
||||||
|
"toast_duration": 2.0,
|
||||||
|
"transition_duration": 0.3
|
||||||
|
},
|
||||||
|
"gameplay": {
|
||||||
|
"auto_save_interval": 300,
|
||||||
|
"max_inventory_slots": 50,
|
||||||
|
"default_player_stats": {
|
||||||
|
"level": 1,
|
||||||
|
"coins": 100,
|
||||||
|
"exp": 0,
|
||||||
|
"max_exp": 100,
|
||||||
|
"energy": 100,
|
||||||
|
"max_energy": 100
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
1
data/dialogues/.gitkeep
Normal file
1
data/dialogues/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 对话数据目录
|
||||||
1
data/items/.gitkeep
Normal file
1
data/items/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 物品数据目录
|
||||||
1
data/levels/.gitkeep
Normal file
1
data/levels/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 关卡数据目录
|
||||||
36
data/localization/zh_CN.json
Normal file
36
data/localization/zh_CN.json
Normal file
@@ -0,0 +1,36 @@
|
|||||||
|
{
|
||||||
|
"ui": {
|
||||||
|
"login": "登录",
|
||||||
|
"register": "注册",
|
||||||
|
"username": "用户名",
|
||||||
|
"password": "密码",
|
||||||
|
"email": "邮箱",
|
||||||
|
"confirm_password": "确认密码",
|
||||||
|
"verification_code": "验证码",
|
||||||
|
"send_code": "发送验证码",
|
||||||
|
"forgot_password": "忘记密码",
|
||||||
|
"enter_town": "进入小镇",
|
||||||
|
"logout": "退出登录"
|
||||||
|
},
|
||||||
|
"messages": {
|
||||||
|
"login_success": "登录成功！正在进入鲸鱼镇...",
|
||||||
|
"register_success": "注册成功！欢迎加入鲸鱼镇",
|
||||||
|
"network_error": "网络连接失败，请检查网络连接",
|
||||||
|
"invalid_username": "用户名只能包含字母、数字和下划线",
|
||||||
|
"invalid_email": "请输入有效的邮箱地址",
|
||||||
|
"password_too_short": "密码长度至少8位",
|
||||||
|
"password_mismatch": "两次输入的密码不一致",
|
||||||
|
"verification_code_sent": "验证码已发送到您的邮箱，请查收"
|
||||||
|
},
|
||||||
|
"game": {
|
||||||
|
"level": "等级",
|
||||||
|
"coins": "金币",
|
||||||
|
"experience": "经验",
|
||||||
|
"energy": "体力",
|
||||||
|
"explore": "探索小镇",
|
||||||
|
"inventory": "背包",
|
||||||
|
"shop": "商店",
|
||||||
|
"friends": "好友",
|
||||||
|
"settings": "设置"
|
||||||
|
}
|
||||||
|
}
|
||||||
2116
docs/api-documentation.md
Normal file
2116
docs/api-documentation.md
Normal file
File diff suppressed because it is too large
Load Diff
324
docs/auth/form_validation.md
Normal file
324
docs/auth/form_validation.md
Normal file
@@ -0,0 +1,324 @@
|
|||||||
|
# 表单验证规范文档
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
|
||||||
|
本文档详细说明了登录和注册表单的验证规则、UI交互规范和错误处理机制。
|
||||||
|
|
||||||
|
## 验证规则
|
||||||
|
|
||||||
|
### 1. 用户名验证
|
||||||
|
|
||||||
|
#### 规则
|
||||||
|
- **必填项**: 是
|
||||||
|
- **长度**: 1-50字符
|
||||||
|
- **格式**: 只能包含字母、数字和下划线
|
||||||
|
- **正则表达式**: `^[a-zA-Z0-9_]+$`
|
||||||
|
|
||||||
|
#### 错误提示
|
||||||
|
- 空值: "用户名不能为空"
|
||||||
|
- 长度不符: "用户名长度应为1-50字符"
|
||||||
|
- 格式错误: "用户名只能包含字母、数字和下划线"
|
||||||
|
|
||||||
|
### 2. 邮箱验证
|
||||||
|
|
||||||
|
#### 规则
|
||||||
|
- **必填项**: 是（注册时）
|
||||||
|
- **格式**: 标准邮箱格式
|
||||||
|
- **正则表达式**: `^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$`
|
||||||
|
|
||||||
|
#### 错误提示
|
||||||
|
- 空值: "邮箱不能为空"
|
||||||
|
- 格式错误: "请输入有效的邮箱地址"
|
||||||
|
|
||||||
|
### 3. 密码验证
|
||||||
|
|
||||||
|
#### 规则
|
||||||
|
- **必填项**: 是
|
||||||
|
- **长度**: 8-128字符
|
||||||
|
- **复杂度**: 必须包含字母和数字
|
||||||
|
- **安全性**: 不允许纯数字或纯字母
|
||||||
|
|
||||||
|
#### 错误提示
|
||||||
|
- 空值: "密码不能为空"
|
||||||
|
- 长度不足: "密码长度至少8位"
|
||||||
|
- 长度超限: "密码长度不能超过128位"
|
||||||
|
- 复杂度不够: "密码必须包含字母和数字"
|
||||||
|
|
||||||
|
### 4. 确认密码验证
|
||||||
|
|
||||||
|
#### 规则
|
||||||
|
- **必填项**: 是（注册时）
|
||||||
|
- **一致性**: 必须与密码字段完全一致
|
||||||
|
|
||||||
|
#### 错误提示
|
||||||
|
- 空值: "确认密码不能为空"
|
||||||
|
- 不一致: "两次输入的密码不一致"
|
||||||
|
|
||||||
|
### 5. 验证码验证
|
||||||
|
|
||||||
|
#### 规则
|
||||||
|
- **必填项**: 是（注册时）
|
||||||
|
- **长度**: 6位数字
|
||||||
|
- **格式**: 纯数字
|
||||||
|
- **有效性**: 必须先获取验证码
|
||||||
|
|
||||||
|
#### 错误提示
|
||||||
|
- 空值: "验证码不能为空"
|
||||||
|
- 长度错误: "验证码必须是6位数字"
|
||||||
|
- 格式错误: "验证码必须是6位数字"
|
||||||
|
- 未获取: "请先获取邮箱验证码"
|
||||||
|
|
||||||
|
## UI交互规范
|
||||||
|
|
||||||
|
### 1. 必填项标识
|
||||||
|
|
||||||
|
所有必填字段都使用水平布局来显示标签、红色星号和右对齐的错误提示：
|
||||||
|
|
||||||
|
#### 结构设计
|
||||||
|
```
|
||||||
|
VBoxContainer (字段容器)
|
||||||
|
├── HBoxContainer (标签和错误提示容器)
|
||||||
|
│ ├── Label (字段名称)
|
||||||
|
│ ├── Label (红色星号 " *")
|
||||||
|
│ ├── Control (弹性空间) [size_flags_horizontal = 3]
|
||||||
|
│ └── Label (红色错误提示) [右对齐，默认隐藏]
|
||||||
|
└── LineEdit (输入框)
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 视觉效果
|
||||||
|
- **标签**: 黑色文本，如 "用户名"、"邮箱"、"密码"
|
||||||
|
- **星号**: 红色文本 `Color(1, 0.2, 0.2, 1)`，内容为 " *"
|
||||||
|
- **弹性空间**: Control节点，`size_flags_horizontal = 3`，占据剩余空间
|
||||||
|
- **错误提示**: 红色文本，12px字体，右对齐显示 (`horizontal_alignment = 2`)
|
||||||
|
- **布局**: 标签和星号左对齐，错误提示右对齐
|
||||||
|
|
||||||
|
#### 交互行为
|
||||||
|
- **正常状态**: 显示 `用户名 * `
|
||||||
|
- **错误状态**: 显示 `用户名 * 用户名不能为空`
|
||||||
|
- **输入时**: 错误提示自动隐藏，回到正常状态
|
||||||
|
|
||||||
|
#### 优势
|
||||||
|
- 错误提示右对齐，与输入框右边缘对齐，视觉更整齐
|
||||||
|
- 利用弹性空间实现左右分布，布局更美观
|
||||||
|
- 不占用额外的垂直空间
|
||||||
|
- 避免UI布局被拉长导致溢出
|
||||||
|
- 保持界面紧凑美观
|
||||||
|
- 红色星号和错误提示颜色一致，视觉统一
|
||||||
|
- 错误提示位置固定，不会因为文本长度变化而影响布局
|
||||||
|
|
||||||
|
### 2. 实时验证
|
||||||
|
|
||||||
|
#### 失焦验证
|
||||||
|
- 当用户离开输入框时（`focus_exited`）触发验证
|
||||||
|
- 立即显示相应的错误提示
|
||||||
|
- 错误提示显示在输入框下方
|
||||||
|
|
||||||
|
#### 输入时验证
|
||||||
|
- 当用户开始输入时（`text_changed`）隐藏错误提示
|
||||||
|
- 提供即时的视觉反馈
|
||||||
|
- 避免在用户输入过程中显示错误
|
||||||
|
|
||||||
|
### 3. 错误提示样式
|
||||||
|
|
||||||
|
#### 视觉设计
|
||||||
|
- **颜色**: 红色 `Color(1, 0.2, 0.2, 1)`
|
||||||
|
- **字体大小**: 12px
|
||||||
|
- **位置**: 输入框正下方
|
||||||
|
- **显示状态**: 默认隐藏，验证失败时显示
|
||||||
|
|
||||||
|
#### 错误信息特点
|
||||||
|
- 简洁明了，直接指出问题
|
||||||
|
- 提供解决建议
|
||||||
|
- 使用友好的语言
|
||||||
|
|
||||||
|
### 4. 按钮状态管理
|
||||||
|
|
||||||
|
#### 发送验证码按钮
|
||||||
|
- **正常状态**: "发送验证码"
|
||||||
|
- **冷却状态**: "重新发送(60)" (倒计时)
|
||||||
|
- **禁用状态**: 请求进行中时禁用
|
||||||
|
|
||||||
|
#### 提交按钮
|
||||||
|
- **正常状态**: 可点击
|
||||||
|
- **禁用状态**: 表单验证失败或请求进行中时禁用
|
||||||
|
- **加载状态**: 显示"正在注册..."等提示
|
||||||
|
|
||||||
|
## 验证流程
|
||||||
|
|
||||||
|
### 1. 登录表单验证流程
|
||||||
|
|
||||||
|
```
|
||||||
|
用户输入 → 失焦验证 → 显示错误(如有) → 点击登录 → 整体验证 → 提交请求
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 验证步骤
|
||||||
|
1. 检查用户名是否为空
|
||||||
|
2. 检查密码是否为空
|
||||||
|
3. 所有验证通过后提交登录请求
|
||||||
|
|
||||||
|
### 2. 注册表单验证流程
|
||||||
|
|
||||||
|
```
|
||||||
|
用户输入 → 失焦验证 → 显示错误(如有) → 获取验证码 → 输入验证码 → 点击注册 → 整体验证 → 邮箱验证 → 用户注册
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 验证步骤
|
||||||
|
1. 验证用户名格式和长度
|
||||||
|
2. 验证邮箱格式
|
||||||
|
3. 验证密码强度
|
||||||
|
4. 验证确认密码一致性
|
||||||
|
5. 验证验证码格式和有效性
|
||||||
|
6. 发送邮箱验证请求
|
||||||
|
7. 验证成功后发送注册请求
|
||||||
|
|
||||||
|
### 3. 验证码获取流程
|
||||||
|
|
||||||
|
```
|
||||||
|
输入邮箱 → 验证邮箱格式 → 检查冷却时间 → 发送验证码 → 开始冷却计时
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 冷却机制
|
||||||
|
- **冷却时间**: 60秒
|
||||||
|
- **按钮状态**: 显示倒计时
|
||||||
|
- **重复发送**: 冷却结束后可重新发送
|
||||||
|
|
||||||
|
## 错误处理机制
|
||||||
|
|
||||||
|
### 1. 客户端验证
|
||||||
|
|
||||||
|
#### 即时验证
|
||||||
|
- 在用户输入过程中提供即时反馈
|
||||||
|
- 防止用户提交无效数据
|
||||||
|
- 提升用户体验
|
||||||
|
|
||||||
|
#### 提交前验证
|
||||||
|
- 在发送请求前进行完整验证
|
||||||
|
- 确保所有必填项都已正确填写
|
||||||
|
- 避免无效的网络请求
|
||||||
|
|
||||||
|
### 2. 服务器验证
|
||||||
|
|
||||||
|
#### 后端验证
|
||||||
|
- 服务器端进行二次验证
|
||||||
|
- 处理服务器返回的错误信息
|
||||||
|
- 显示相应的错误提示
|
||||||
|
|
||||||
|
#### 网络错误处理
|
||||||
|
- 连接失败提示
|
||||||
|
- 超时处理
|
||||||
|
- 服务器错误提示
|
||||||
|
|
||||||
|
### 3. 用户引导
|
||||||
|
|
||||||
|
#### 错误恢复
|
||||||
|
- 清晰的错误提示
|
||||||
|
- 提供解决方案
|
||||||
|
- 引导用户正确操作
|
||||||
|
|
||||||
|
#### 成功反馈
|
||||||
|
- 注册成功提示
|
||||||
|
- 自动跳转到登录界面
|
||||||
|
- 自动填充用户名
|
||||||
|
|
||||||
|
## 代码实现
|
||||||
|
|
||||||
|
### 1. 验证函数
|
||||||
|
|
||||||
|
每个字段都有对应的验证函数：
|
||||||
|
- `validate_username(username: String) -> Dictionary`
|
||||||
|
- `validate_email(email: String) -> Dictionary`
|
||||||
|
- `validate_password(password: String) -> Dictionary`
|
||||||
|
- `validate_confirm_password(password: String, confirm: String) -> Dictionary`
|
||||||
|
- `validate_verification_code(code: String) -> Dictionary`
|
||||||
|
|
||||||
|
### 2. 事件处理
|
||||||
|
|
||||||
|
#### 失焦事件
|
||||||
|
- `_on_register_username_focus_exited()`
|
||||||
|
- `_on_register_email_focus_exited()`
|
||||||
|
- `_on_register_password_focus_exited()`
|
||||||
|
- `_on_register_confirm_focus_exited()`
|
||||||
|
- `_on_verification_focus_exited()`
|
||||||
|
|
||||||
|
#### 输入事件
|
||||||
|
- `_on_register_username_text_changed(new_text: String)`
|
||||||
|
- `_on_register_email_text_changed(new_text: String)`
|
||||||
|
- `_on_register_password_text_changed(new_text: String)`
|
||||||
|
- `_on_register_confirm_text_changed(new_text: String)`
|
||||||
|
- `_on_verification_text_changed(new_text: String)`
|
||||||
|
|
||||||
|
### 3. 整体验证
|
||||||
|
|
||||||
|
- `validate_login_form() -> bool`
|
||||||
|
- `validate_register_form() -> bool`
|
||||||
|
|
||||||
|
## 测试用例
|
||||||
|
|
||||||
|
### 1. 用户名测试
|
||||||
|
|
||||||
|
| 输入 | 预期结果 | 错误信息 |
|
||||||
|
|------|----------|----------|
|
||||||
|
| "" | 失败 | "用户名不能为空" |
|
||||||
|
| "a" | 成功 | - |
|
||||||
|
| "test_user123" | 成功 | - |
|
||||||
|
| "test@user" | 失败 | "用户名只能包含字母、数字和下划线" |
|
||||||
|
| "a".repeat(51) | 失败 | "用户名长度应为1-50字符" |
|
||||||
|
|
||||||
|
### 2. 邮箱测试
|
||||||
|
|
||||||
|
| 输入 | 预期结果 | 错误信息 |
|
||||||
|
|------|----------|----------|
|
||||||
|
| "" | 失败 | "邮箱不能为空" |
|
||||||
|
| "test@example.com" | 成功 | - |
|
||||||
|
| "invalid-email" | 失败 | "请输入有效的邮箱地址" |
|
||||||
|
| "test@" | 失败 | "请输入有效的邮箱地址" |
|
||||||
|
|
||||||
|
### 3. 密码测试
|
||||||
|
|
||||||
|
| 输入 | 预期结果 | 错误信息 |
|
||||||
|
|------|----------|----------|
|
||||||
|
| "" | 失败 | "密码不能为空" |
|
||||||
|
| "1234567" | 失败 | "密码长度至少8位" |
|
||||||
|
| "12345678" | 失败 | "密码必须包含字母和数字" |
|
||||||
|
| "abcdefgh" | 失败 | "密码必须包含字母和数字" |
|
||||||
|
| "abc12345" | 成功 | - |
|
||||||
|
|
||||||
|
### 4. 验证码测试
|
||||||
|
|
||||||
|
| 输入 | 预期结果 | 错误信息 |
|
||||||
|
|------|----------|----------|
|
||||||
|
| "" | 失败 | "验证码不能为空" |
|
||||||
|
| "12345" | 失败 | "验证码必须是6位数字" |
|
||||||
|
| "1234567" | 失败 | "验证码必须是6位数字" |
|
||||||
|
| "12345a" | 失败 | "验证码必须是6位数字" |
|
||||||
|
| "123456" | 成功 | - |
|
||||||
|
|
||||||
|
## 最佳实践
|
||||||
|
|
||||||
|
### 1. 用户体验
|
||||||
|
|
||||||
|
- **即时反馈**: 在用户输入时提供即时的视觉反馈
|
||||||
|
- **清晰提示**: 错误信息要简洁明了，易于理解
|
||||||
|
- **引导操作**: 通过UI引导用户完成正确的操作流程
|
||||||
|
|
||||||
|
### 2. 性能优化
|
||||||
|
|
||||||
|
- **避免过度验证**: 不在每次字符输入时都进行复杂验证
|
||||||
|
- **合理的验证时机**: 在失焦和提交时进行验证
|
||||||
|
- **缓存验证结果**: 避免重复验证相同的内容
|
||||||
|
|
||||||
|
### 3. 安全考虑
|
||||||
|
|
||||||
|
- **客户端+服务端**: 双重验证确保数据安全
|
||||||
|
- **敏感信息**: 密码等敏感信息不在客户端明文存储
|
||||||
|
- **防止暴力破解**: 验证码冷却机制防止频繁请求
|
||||||
|
|
||||||
|
### 4. 可维护性
|
||||||
|
|
||||||
|
- **模块化设计**: 每个验证规则独立成函数
|
||||||
|
- **统一的错误处理**: 使用统一的错误显示机制
|
||||||
|
- **可配置的规则**: 验证规则可以根据需求调整
|
||||||
|
|
||||||
|
## 更新日志
|
||||||
|
|
||||||
|
- **v1.0.0** (2025-12-24): 初始版本，包含完整的表单验证规范
|
||||||
283
docs/auth/testing_guide.md
Normal file
283
docs/auth/testing_guide.md
Normal file
@@ -0,0 +1,283 @@
|
|||||||
|
# 表单验证测试指南
|
||||||
|
|
||||||
|
## 测试概述
|
||||||
|
|
||||||
|
本文档提供了完整的表单验证功能测试步骤，确保所有验证规则和用户交互都能正常工作。
|
||||||
|
|
||||||
|
## 测试环境准备
|
||||||
|
|
||||||
|
### 1. 启动后端服务
|
||||||
|
```bash
|
||||||
|
# 确保后端服务运行在 https://whaletownend.xinghangee.icu
|
||||||
|
# 或者本地开发环境: http://localhost:3000
|
||||||
|
npm start
|
||||||
|
# 或者你的后端启动命令
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 打开Godot项目
|
||||||
|
- 启动Godot编辑器
|
||||||
|
- 打开鲸鱼镇项目
|
||||||
|
- 运行主场景
|
||||||
|
|
||||||
|
## 登录表单测试
|
||||||
|
|
||||||
|
### 测试用例1: 必填项验证
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 点击"注册居民身份"进入登录界面
|
||||||
|
2. 不输入任何内容，直接点击用户名输入框外的区域
|
||||||
|
3. 不输入任何内容，直接点击密码输入框外的区域
|
||||||
|
4. 点击"进入小镇"或"密码登录"按钮
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 用户名输入框下方显示红色错误提示："用户名不能为空"
|
||||||
|
- 密码输入框下方显示红色错误提示："密码不能为空"
|
||||||
|
- 按钮点击无效，不会提交表单
|
||||||
|
|
||||||
|
### 测试用例2: 实时反馈
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 触发上述错误提示后
|
||||||
|
2. 在用户名输入框中输入任意字符
|
||||||
|
3. 在密码输入框中输入任意字符
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 开始输入时，对应的错误提示立即消失
|
||||||
|
- 提供即时的视觉反馈
|
||||||
|
|
||||||
|
### 测试用例3: 正常登录
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 输入有效的用户名："testuser"
|
||||||
|
2. 输入任意密码："password123"
|
||||||
|
3. 点击"进入小镇"
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 无错误提示显示
|
||||||
|
- 成功进入游戏主界面
|
||||||
|
- 显示用户名信息
|
||||||
|
|
||||||
|
## 注册表单测试
|
||||||
|
|
||||||
|
### 测试用例4: 用户名验证
|
||||||
|
|
||||||
|
#### 测试数据
|
||||||
|
| 输入 | 预期结果 | 错误信息 |
|
||||||
|
|------|----------|----------|
|
||||||
|
| (空) | 失败 | "用户名不能为空" |
|
||||||
|
| "test@user" | 失败 | "用户名只能包含字母、数字和下划线" |
|
||||||
|
| "a".repeat(51) | 失败 | "用户名长度应为1-50字符" |
|
||||||
|
| "test_user123" | 成功 | 无错误提示 |
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 点击"注册居民身份"
|
||||||
|
2. 依次输入上述测试数据
|
||||||
|
3. 每次输入后点击其他输入框（触发失焦验证）
|
||||||
|
|
||||||
|
### 测试用例5: 邮箱验证
|
||||||
|
|
||||||
|
#### 测试数据
|
||||||
|
| 输入 | 预期结果 | 错误信息 |
|
||||||
|
|------|----------|----------|
|
||||||
|
| (空) | 失败 | "邮箱不能为空" |
|
||||||
|
| "invalid-email" | 失败 | "请输入有效的邮箱地址" |
|
||||||
|
| "test@" | 失败 | "请输入有效的邮箱地址" |
|
||||||
|
| "test@example.com" | 成功 | 无错误提示 |
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 在邮箱输入框中依次输入测试数据
|
||||||
|
2. 每次输入后点击其他输入框
|
||||||
|
|
||||||
|
### 测试用例6: 密码验证
|
||||||
|
|
||||||
|
#### 测试数据
|
||||||
|
| 输入 | 预期结果 | 错误信息 |
|
||||||
|
|------|----------|----------|
|
||||||
|
| (空) | 失败 | "密码不能为空" |
|
||||||
|
| "1234567" | 失败 | "密码长度至少8位" |
|
||||||
|
| "12345678" | 失败 | "密码必须包含字母和数字" |
|
||||||
|
| "abcdefgh" | 失败 | "密码必须包含字母和数字" |
|
||||||
|
| "abc12345" | 成功 | 无错误提示 |
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 在密码输入框中依次输入测试数据
|
||||||
|
2. 每次输入后点击其他输入框
|
||||||
|
|
||||||
|
### 测试用例7: 确认密码验证
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 在密码框输入："abc12345"
|
||||||
|
2. 在确认密码框输入：""（空）
|
||||||
|
3. 点击其他输入框
|
||||||
|
4. 在确认密码框输入："different123"
|
||||||
|
5. 点击其他输入框
|
||||||
|
6. 在确认密码框输入："abc12345"
|
||||||
|
7. 点击其他输入框
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 步骤3: 显示"确认密码不能为空"
|
||||||
|
- 步骤5: 显示"两次输入的密码不一致"
|
||||||
|
- 步骤7: 无错误提示
|
||||||
|
|
||||||
|
### 测试用例8: 验证码功能
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 不输入邮箱，直接点击"发送验证码"
|
||||||
|
2. 输入无效邮箱"invalid"，点击"发送验证码"
|
||||||
|
3. 输入有效邮箱"test@example.com"，点击"发送验证码"
|
||||||
|
4. 立即再次点击"发送验证码"
|
||||||
|
5. 在验证码输入框输入"12345"（5位）
|
||||||
|
6. 在验证码输入框输入"12345a"（包含字母）
|
||||||
|
7. 在验证码输入框输入"123456"（正确格式）
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 步骤1: 邮箱框显示"邮箱不能为空"，聚焦到邮箱输入框
|
||||||
|
- 步骤2: 邮箱框显示"请输入有效的邮箱地址"
|
||||||
|
- 步骤3: 显示"正在发送验证码..."，按钮变为禁用状态
|
||||||
|
- 步骤4: 显示冷却提示"请等待 XX 秒后再次发送"
|
||||||
|
- 步骤5: 验证码框显示"验证码必须是6位数字"
|
||||||
|
- 步骤6: 验证码框显示"验证码必须是6位数字"
|
||||||
|
- 步骤7: 无错误提示
|
||||||
|
|
||||||
|
### 测试用例9: 完整注册流程
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 填写所有必填信息：
|
||||||
|
- 用户名: "testuser"
|
||||||
|
- 邮箱: "test@example.com"
|
||||||
|
- 密码: "password123"
|
||||||
|
- 确认密码: "password123"
|
||||||
|
2. 点击"发送验证码"
|
||||||
|
3. 查看控制台获取验证码
|
||||||
|
4. 输入验证码
|
||||||
|
5. 点击"注册"按钮
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 所有验证通过，无错误提示
|
||||||
|
- 显示"正在验证邮箱..."
|
||||||
|
- 显示"邮箱验证成功，正在注册..."
|
||||||
|
- 显示"注册成功！"
|
||||||
|
- 自动返回登录界面
|
||||||
|
- 用户名自动填入登录表单
|
||||||
|
|
||||||
|
## 边界情况测试
|
||||||
|
|
||||||
|
### 测试用例10: 网络异常
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 关闭后端服务
|
||||||
|
2. 尝试发送验证码
|
||||||
|
3. 尝试注册
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 显示"网络连接失败，请检查服务器是否启动"
|
||||||
|
- 按钮重新启用
|
||||||
|
|
||||||
|
### 测试用例11: 快速操作
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 快速连续点击"发送验证码"按钮
|
||||||
|
2. 快速连续点击"注册"按钮
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 按钮在请求期间被禁用
|
||||||
|
- 防止重复提交
|
||||||
|
|
||||||
|
### 测试用例12: 表单切换
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 在注册表单中输入信息并触发错误提示
|
||||||
|
2. 点击"返回登录"
|
||||||
|
3. 再次点击"注册居民身份"
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 切换到登录界面时，注册表单状态保持
|
||||||
|
- 再次进入注册界面时，表单被清空，错误提示被隐藏
|
||||||
|
|
||||||
|
## 性能测试
|
||||||
|
|
||||||
|
### 测试用例13: 响应速度
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 快速在各个输入框之间切换
|
||||||
|
2. 快速输入和删除文本
|
||||||
|
3. 观察错误提示的显示和隐藏速度
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 验证响应迅速，无明显延迟
|
||||||
|
- UI更新流畅，无卡顿现象
|
||||||
|
|
||||||
|
## 兼容性测试
|
||||||
|
|
||||||
|
### 测试用例14: 不同输入法
|
||||||
|
|
||||||
|
#### 步骤
|
||||||
|
1. 使用中文输入法输入用户名
|
||||||
|
2. 使用英文输入法输入用户名
|
||||||
|
3. 输入特殊字符
|
||||||
|
|
||||||
|
#### 预期结果
|
||||||
|
- 中文字符被正确验证为无效格式
|
||||||
|
- 英文字符正常通过验证
|
||||||
|
- 特殊字符按规则验证
|
||||||
|
|
||||||
|
## 测试检查清单
|
||||||
|
|
||||||
|
### 功能完整性
|
||||||
|
- [ ] 所有必填项都有红色星号标识
|
||||||
|
- [ ] 失焦验证正常工作
|
||||||
|
- [ ] 实时输入反馈正常
|
||||||
|
- [ ] 错误提示准确显示
|
||||||
|
- [ ] 验证码发送和验证功能正常
|
||||||
|
- [ ] 注册流程完整可用
|
||||||
|
|
||||||
|
### 用户体验
|
||||||
|
- [ ] 错误提示清晰易懂
|
||||||
|
- [ ] 按钮状态管理正确
|
||||||
|
- [ ] 表单切换流畅
|
||||||
|
- [ ] 成功反馈及时
|
||||||
|
|
||||||
|
### 错误处理
|
||||||
|
- [ ] 网络异常处理正确
|
||||||
|
- [ ] 服务器错误处理正确
|
||||||
|
- [ ] 边界情况处理正确
|
||||||
|
|
||||||
|
### 性能表现
|
||||||
|
- [ ] 验证响应速度快
|
||||||
|
- [ ] UI更新流畅
|
||||||
|
- [ ] 内存使用正常
|
||||||
|
|
||||||
|
## 测试报告模板
|
||||||
|
|
||||||
|
### 测试环境
|
||||||
|
- Godot版本:
|
||||||
|
- 操作系统:
|
||||||
|
- 后端服务状态:
|
||||||
|
- 测试时间:
|
||||||
|
|
||||||
|
### 测试结果
|
||||||
|
| 测试用例 | 状态 | 备注 |
|
||||||
|
|----------|------|------|
|
||||||
|
| 登录表单验证 | ✅/❌ | |
|
||||||
|
| 注册表单验证 | ✅/❌ | |
|
||||||
|
| 验证码功能 | ✅/❌ | |
|
||||||
|
| 网络异常处理 | ✅/❌ | |
|
||||||
|
| 完整注册流程 | ✅/❌ | |
|
||||||
|
|
||||||
|
### 发现的问题
|
||||||
|
1. 问题描述
|
||||||
|
- 重现步骤
|
||||||
|
- 预期结果
|
||||||
|
- 实际结果
|
||||||
|
- 严重程度
|
||||||
|
|
||||||
|
### 改进建议
|
||||||
|
1. 功能改进
|
||||||
|
2. 用户体验优化
|
||||||
|
3. 性能优化
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**测试完成日期**: ___________
|
||||||
|
**测试人员**: ___________
|
||||||
|
**测试版本**: v1.0.0
|
||||||
433
docs/code_comment_guide.md
Normal file
433
docs/code_comment_guide.md
Normal file
@@ -0,0 +1,433 @@
|
|||||||
|
# GDScript 代码注释规范
|
||||||
|
|
||||||
|
本文档详细说明了 whaleTown 项目中 GDScript 代码的注释规范，旨在提高代码可读性和维护性。
|
||||||
|
|
||||||
|
## 目录
|
||||||
|
|
||||||
|
- [基本原则](#基本原则)
|
||||||
|
- [文件头注释](#文件头注释)
|
||||||
|
- [类和函数注释](#类和函数注释)
|
||||||
|
- [变量注释](#变量注释)
|
||||||
|
- [行内注释](#行内注释)
|
||||||
|
- [特殊注释标记](#特殊注释标记)
|
||||||
|
- [AI辅助注释指南](#ai辅助注释指南)
|
||||||
|
|
||||||
|
## 基本原则
|
||||||
|
|
||||||
|
### 注释的目的
|
||||||
|
- **解释为什么**，而不是解释做什么
|
||||||
|
- **提供上下文**，帮助理解代码意图
|
||||||
|
- **记录重要决策**和设计考虑
|
||||||
|
- **警告潜在问题**和注意事项
|
||||||
|
|
||||||
|
### 注释质量标准
|
||||||
|
- 简洁明了，避免冗余
|
||||||
|
- 使用中文，保持一致性
|
||||||
|
- 及时更新，与代码同步
|
||||||
|
- 避免显而易见的注释
|
||||||
|
|
||||||
|
## 文件头注释
|
||||||
|
|
||||||
|
每个 GDScript 文件都应该包含文件头注释，说明文件的用途和基本信息。
|
||||||
|
|
||||||
|
### 标准格式
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# ============================================================================
|
||||||
|
# 文件名: PlayerController.gd
|
||||||
|
# 作用: 玩家角色控制器，处理玩家输入和移动逻辑
|
||||||
|
#
|
||||||
|
# 主要功能:
|
||||||
|
# - 处理键盘和手柄输入
|
||||||
|
# - 控制角色移动和跳跃
|
||||||
|
# - 管理角色状态切换
|
||||||
|
# - 处理碰撞检测
|
||||||
|
#
|
||||||
|
# 依赖: MovementComponent, AnimationComponent
|
||||||
|
# 作者: [开发者名称]
|
||||||
|
# 创建时间: 2024-12-24
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
extends CharacterBody2D
|
||||||
|
```
|
||||||
|
|
||||||
|
### 管理器类文件头
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# ============================================================================
|
||||||
|
# 游戏管理器 - GameManager.gd
|
||||||
|
#
|
||||||
|
# 全局单例管理器，负责游戏状态管理和生命周期控制
|
||||||
|
#
|
||||||
|
# 核心职责:
|
||||||
|
# - 游戏状态切换 (加载、认证、游戏中、暂停等)
|
||||||
|
# - 用户信息管理
|
||||||
|
# - 全局配置访问
|
||||||
|
# - 系统初始化和清理
|
||||||
|
#
|
||||||
|
# 使用方式:
|
||||||
|
# GameManager.change_state(GameManager.GameState.IN_GAME)
|
||||||
|
# GameManager.set_current_user("player123")
|
||||||
|
#
|
||||||
|
# 注意事项:
|
||||||
|
# - 作为自动加载单例，全局可访问
|
||||||
|
# - 状态变更会触发 game_state_changed 信号
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
extends Node
|
||||||
|
```
|
||||||
|
## 类和函数注释
|
||||||
|
|
||||||
|
### 类注释
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# 玩家数据类
|
||||||
|
#
|
||||||
|
# 存储和管理玩家的基本属性和状态信息
|
||||||
|
# 支持数据序列化和反序列化，用于存档系统
|
||||||
|
class_name PlayerData
|
||||||
|
|
||||||
|
# 武器组件类
|
||||||
|
#
|
||||||
|
# 为角色提供武器功能，包括攻击、换弹、特殊技能等
|
||||||
|
# 可以挂载到任何具有攻击能力的角色上
|
||||||
|
#
|
||||||
|
# 使用示例:
|
||||||
|
# var weapon = WeaponComponent.new()
|
||||||
|
# weapon.setup_weapon("sword", 50)
|
||||||
|
# add_child(weapon)
|
||||||
|
class_name WeaponComponent
|
||||||
|
```
|
||||||
|
|
||||||
|
### 函数注释格式
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# 处理玩家输入并更新移动状态
|
||||||
|
#
|
||||||
|
# 参数:
|
||||||
|
# delta: float - 帧时间间隔
|
||||||
|
#
|
||||||
|
# 返回值: 无
|
||||||
|
#
|
||||||
|
# 注意事项:
|
||||||
|
# - 需要在 _physics_process 中调用
|
||||||
|
# - 会自动处理重力和碰撞
|
||||||
|
func handle_movement(delta: float) -> void:
|
||||||
|
|
||||||
|
# 验证用户输入的邮箱格式
|
||||||
|
#
|
||||||
|
# 参数:
|
||||||
|
# email: String - 待验证的邮箱地址
|
||||||
|
#
|
||||||
|
# 返回值:
|
||||||
|
# Dictionary - 包含验证结果和错误信息
|
||||||
|
# {
|
||||||
|
# "valid": bool, # 是否有效
|
||||||
|
# "message": String # 错误信息（如果无效）
|
||||||
|
# }
|
||||||
|
#
|
||||||
|
# 使用示例:
|
||||||
|
# var result = validate_email("test@example.com")
|
||||||
|
# if result.valid:
|
||||||
|
# print("邮箱格式正确")
|
||||||
|
static func validate_email(email: String) -> Dictionary:
|
||||||
|
```
|
||||||
|
## 变量注释
|
||||||
|
|
||||||
|
### 成员变量注释
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# 玩家基础属性
|
||||||
|
@export var max_health: int = 100 # 最大生命值
|
||||||
|
@export var move_speed: float = 200.0 # 移动速度 (像素/秒)
|
||||||
|
@export var jump_force: float = -400.0 # 跳跃力度 (负值向上)
|
||||||
|
|
||||||
|
# 状态管理
|
||||||
|
var current_health: int # 当前生命值
|
||||||
|
var is_grounded: bool = false # 是否在地面上
|
||||||
|
var can_double_jump: bool = true # 是否可以二段跳
|
||||||
|
|
||||||
|
# 节点引用 - 在 _ready() 中初始化
|
||||||
|
@onready var sprite: Sprite2D = $Sprite2D
|
||||||
|
@onready var collision: CollisionShape2D = $CollisionShape2D
|
||||||
|
@onready var animation_player: AnimationPlayer = $AnimationPlayer
|
||||||
|
|
||||||
|
# 私有变量 - 内部使用
|
||||||
|
var _velocity: Vector2 = Vector2.ZERO # 当前速度向量
|
||||||
|
var _last_direction: int = 1 # 最后面向方向 (1=右, -1=左)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 常量注释
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# 游戏配置常量
|
||||||
|
const GRAVITY: float = 980.0 # 重力加速度 (像素/秒²)
|
||||||
|
const MAX_FALL_SPEED: float = 1000.0 # 最大下落速度
|
||||||
|
const COYOTE_TIME: float = 0.1 # 土狼时间 (离开平台后仍可跳跃的时间)
|
||||||
|
|
||||||
|
# 输入动作名称
|
||||||
|
const ACTION_MOVE_LEFT: String = "move_left"
|
||||||
|
const ACTION_MOVE_RIGHT: String = "move_right"
|
||||||
|
const ACTION_JUMP: String = "jump"
|
||||||
|
|
||||||
|
# 动画名称常量
|
||||||
|
const ANIM_IDLE: String = "idle"
|
||||||
|
const ANIM_WALK: String = "walk"
|
||||||
|
const ANIM_JUMP: String = "jump"
|
||||||
|
const ANIM_FALL: String = "fall"
|
||||||
|
```
|
||||||
|
|
||||||
|
## 行内注释
|
||||||
|
|
||||||
|
### 复杂逻辑注释
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
func update_movement(delta: float):
|
||||||
|
# 处理水平移动输入
|
||||||
|
var input_direction = Input.get_axis("move_left", "move_right")
|
||||||
|
|
||||||
|
if input_direction != 0:
|
||||||
|
velocity.x = input_direction * move_speed
|
||||||
|
_last_direction = sign(input_direction) # 记录面向方向
|
||||||
|
else:
|
||||||
|
# 应用摩擦力，逐渐停止
|
||||||
|
velocity.x = move_toward(velocity.x, 0, friction * delta)
|
||||||
|
|
||||||
|
# 应用重力 (只在空中时)
|
||||||
|
if not is_on_floor():
|
||||||
|
velocity.y += gravity * delta
|
||||||
|
velocity.y = min(velocity.y, max_fall_speed) # 限制最大下落速度
|
||||||
|
|
||||||
|
# 处理跳跃输入
|
||||||
|
if Input.is_action_just_pressed("jump"):
|
||||||
|
if is_on_floor():
|
||||||
|
velocity.y = jump_force # 普通跳跃
|
||||||
|
elif can_double_jump:
|
||||||
|
velocity.y = jump_force * 0.8 # 二段跳 (力度稍小)
|
||||||
|
can_double_jump = false
|
||||||
|
|
||||||
|
# 重置二段跳能力
|
||||||
|
if is_on_floor() and not can_double_jump:
|
||||||
|
can_double_jump = true
|
||||||
|
```
|
||||||
|
|
||||||
|
### 临时解决方案注释
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
func handle_collision(body: Node2D):
|
||||||
|
# TODO: 重构碰撞处理逻辑，当前实现过于复杂
|
||||||
|
# FIXME: 在某些情况下会出现重复碰撞检测
|
||||||
|
# HACK: 临时解决方案，等待 Godot 4.6 修复相关 bug
|
||||||
|
|
||||||
|
if body.has_method("take_damage"):
|
||||||
|
# NOTE: 伤害计算需要考虑护甲和抗性
|
||||||
|
var damage = calculate_damage(base_damage)
|
||||||
|
body.take_damage(damage)
|
||||||
|
```
|
||||||
|
## 特殊注释标记
|
||||||
|
|
||||||
|
使用标准化的标记来标识不同类型的注释：
|
||||||
|
|
||||||
|
### 标记类型
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# TODO: 待实现的功能
|
||||||
|
# TODO: 添加音效播放功能
|
||||||
|
# TODO: 实现存档系统
|
||||||
|
|
||||||
|
# FIXME: 需要修复的问题
|
||||||
|
# FIXME: 内存泄漏问题，需要及时释放资源
|
||||||
|
# FIXME: 在低帧率下移动不流畅
|
||||||
|
|
||||||
|
# HACK: 临时解决方案
|
||||||
|
# HACK: 绕过 Godot 引擎的已知 bug
|
||||||
|
# HACK: 临时方案，等待更好的实现
|
||||||
|
|
||||||
|
# NOTE: 重要说明
|
||||||
|
# NOTE: 此函数会修改全局状态，谨慎使用
|
||||||
|
# NOTE: 性能敏感代码，避免频繁调用
|
||||||
|
|
||||||
|
# WARNING: 警告信息
|
||||||
|
# WARNING: 不要在 _ready() 之前调用此函数
|
||||||
|
# WARNING: 此操作不可逆，请确认后执行
|
||||||
|
|
||||||
|
# OPTIMIZE: 性能优化点
|
||||||
|
# OPTIMIZE: 可以使用对象池优化内存分配
|
||||||
|
# OPTIMIZE: 考虑使用缓存提高查询效率
|
||||||
|
```
|
||||||
|
|
||||||
|
### 版本和兼容性标记
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# @since 1.0.0 - 添加基础移动功能
|
||||||
|
# @deprecated 使用 new_movement_system() 替代
|
||||||
|
# @godot_version 4.5+ - 需要 Godot 4.5 或更高版本
|
||||||
|
# @platform_specific Windows/Linux - 仅在桌面平台可用
|
||||||
|
```
|
||||||
|
|
||||||
|
## AI辅助注释指南
|
||||||
|
|
||||||
|
### 为AI提供的注释模板
|
||||||
|
|
||||||
|
当需要AI帮助补充注释时，请使用以下模板：
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# [AI_COMMENT_REQUEST]
|
||||||
|
# 请为以下函数添加详细注释，包括：
|
||||||
|
# - 功能描述
|
||||||
|
# - 参数说明
|
||||||
|
# - 返回值说明
|
||||||
|
# - 使用示例
|
||||||
|
# - 注意事项
|
||||||
|
func complex_function(param1: String, param2: int) -> Dictionary:
|
||||||
|
# 复杂的业务逻辑...
|
||||||
|
pass
|
||||||
|
```
|
||||||
|
|
||||||
|
### AI注释补充规则
|
||||||
|
|
||||||
|
1. **保持一致性** - 遵循项目现有的注释风格
|
||||||
|
2. **关注业务逻辑** - 重点解释业务含义，而非语法
|
||||||
|
3. **提供上下文** - 说明函数在整个系统中的作用
|
||||||
|
4. **标注复杂度** - 对复杂算法提供额外说明
|
||||||
|
|
||||||
|
### 示例：AI补充前后对比
|
||||||
|
|
||||||
|
**补充前：**
|
||||||
|
```gdscript
|
||||||
|
func calculate_damage(base_damage: int, armor: int, resistance: float) -> int:
|
||||||
|
var final_damage = base_damage
|
||||||
|
final_damage -= armor
|
||||||
|
final_damage *= (1.0 - resistance)
|
||||||
|
return max(1, final_damage)
|
||||||
|
```
|
||||||
|
|
||||||
|
**AI补充后：**
|
||||||
|
```gdscript
|
||||||
|
# 计算最终伤害值
|
||||||
|
#
|
||||||
|
# 根据基础伤害、护甲值和抗性计算实际造成的伤害
|
||||||
|
# 伤害计算公式: (基础伤害 - 护甲) × (1 - 抗性)
|
||||||
|
#
|
||||||
|
# 参数:
|
||||||
|
# base_damage: int - 基础伤害值
|
||||||
|
# armor: int - 目标护甲值 (减少固定伤害)
|
||||||
|
# resistance: float - 目标抗性 (0.0-1.0, 减少百分比伤害)
|
||||||
|
#
|
||||||
|
# 返回值:
|
||||||
|
# int - 最终伤害值 (最小为1，确保至少造成1点伤害)
|
||||||
|
#
|
||||||
|
# 使用示例:
|
||||||
|
# var damage = calculate_damage(100, 20, 0.3) # 结果: 56
|
||||||
|
#
|
||||||
|
# 注意事项:
|
||||||
|
# - 护甲为负值时会增加伤害
|
||||||
|
# - 抗性超过1.0时可能导致负伤害，但会被限制为1
|
||||||
|
func calculate_damage(base_damage: int, armor: int, resistance: float) -> int:
|
||||||
|
var final_damage = base_damage
|
||||||
|
final_damage -= armor # 减去护甲值
|
||||||
|
final_damage *= (1.0 - resistance) # 应用抗性
|
||||||
|
return max(1, final_damage) # 确保最小伤害为1
|
||||||
|
```
|
||||||
|
## 注释最佳实践
|
||||||
|
|
||||||
|
### 什么时候需要注释
|
||||||
|
|
||||||
|
**必须添加注释的情况：**
|
||||||
|
- 复杂的算法和业务逻辑
|
||||||
|
- 非显而易见的设计决策
|
||||||
|
- 临时解决方案和已知问题
|
||||||
|
- 公共API和接口函数
|
||||||
|
- 性能敏感的代码段
|
||||||
|
- 平台特定或版本特定的代码
|
||||||
|
|
||||||
|
**不需要注释的情况：**
|
||||||
|
- 显而易见的代码 (`var count = 0 # 计数器` ❌)
|
||||||
|
- 重复函数名的注释 (`func get_name() -> String: # 获取名称` ❌)
|
||||||
|
- 过时或错误的注释
|
||||||
|
|
||||||
|
### 注释维护原则
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# ✅ 好的注释 - 解释为什么这样做
|
||||||
|
# 使用二分查找提高大数组的查询效率
|
||||||
|
# 当数组长度超过100时，线性查找性能会显著下降
|
||||||
|
func binary_search(array: Array, target: Variant) -> int:
|
||||||
|
|
||||||
|
# ❌ 坏的注释 - 重复代码内容
|
||||||
|
# 遍历数组查找目标值
|
||||||
|
func linear_search(array: Array, target: Variant) -> int:
|
||||||
|
```
|
||||||
|
|
||||||
|
### 团队协作注释
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# 多人协作时的注释规范
|
||||||
|
class_name NetworkManager
|
||||||
|
|
||||||
|
# @author: 张三 - 网络连接模块
|
||||||
|
# @author: 李四 - 数据同步模块
|
||||||
|
# @reviewer: 王五 - 代码审查
|
||||||
|
# @last_modified: 2024-12-24
|
||||||
|
|
||||||
|
# 网络连接状态枚举
|
||||||
|
#
|
||||||
|
# 定义了客户端与服务器的连接状态
|
||||||
|
# 状态转换: DISCONNECTED -> CONNECTING -> CONNECTED -> DISCONNECTED
|
||||||
|
enum ConnectionState {
|
||||||
|
DISCONNECTED, # 未连接
|
||||||
|
CONNECTING, # 连接中
|
||||||
|
CONNECTED, # 已连接
|
||||||
|
RECONNECTING # 重连中 - @added by 李四 2024-12-20
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注释检查清单
|
||||||
|
|
||||||
|
在提交代码前，请检查以下项目：
|
||||||
|
|
||||||
|
### 文件级别检查
|
||||||
|
- [ ] 文件头注释完整（文件名、作用、主要功能）
|
||||||
|
- [ ] 依赖关系说明清楚
|
||||||
|
- [ ] 作者和创建时间已填写
|
||||||
|
|
||||||
|
### 函数级别检查
|
||||||
|
- [ ] 公共函数有完整的参数和返回值说明
|
||||||
|
- [ ] 复杂函数有使用示例
|
||||||
|
- [ ] 特殊情况和注意事项已标注
|
||||||
|
|
||||||
|
### 代码级别检查
|
||||||
|
- [ ] 复杂逻辑有行内注释说明
|
||||||
|
- [ ] 魔法数字有常量定义和注释
|
||||||
|
- [ ] TODO/FIXME 标记有明确的处理计划
|
||||||
|
|
||||||
|
### 质量检查
|
||||||
|
- [ ] 注释内容准确，与代码一致
|
||||||
|
- [ ] 中文表达清晰，无错别字
|
||||||
|
- [ ] 注释格式符合项目规范
|
||||||
|
|
||||||
|
## 注释工具和插件
|
||||||
|
|
||||||
|
### Godot编辑器设置
|
||||||
|
```
|
||||||
|
# 在 Godot 编辑器中设置注释快捷键
|
||||||
|
# 编辑器设置 -> 快捷键 -> 注释/取消注释: Ctrl+/
|
||||||
|
```
|
||||||
|
|
||||||
|
### 推荐的注释插件
|
||||||
|
- **GDScript Language Server** - 提供注释语法高亮
|
||||||
|
- **Code Formatter** - 自动格式化注释
|
||||||
|
- **Documentation Generator** - 自动生成API文档
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 总结
|
||||||
|
|
||||||
|
良好的注释是代码质量的重要组成部分。遵循本规范可以：
|
||||||
|
|
||||||
|
1. **提高代码可读性** - 帮助团队成员快速理解代码
|
||||||
|
2. **降低维护成本** - 减少后期修改和调试时间
|
||||||
|
3. **促进知识传承** - 保留设计思路和业务逻辑
|
||||||
|
4. **支持AI辅助开发** - 为AI提供更好的上下文信息
|
||||||
|
|
||||||
|
记住：**好的注释解释为什么，而不是做什么。**
|
||||||
@@ -404,6 +404,37 @@ FONT_MAIN.ttf
|
|||||||
- 全部使用小写字母
|
- 全部使用小写字母
|
||||||
- 同系列资源使用数字后缀，如 `tile_01.png`、`tile_02.png`
|
- 同系列资源使用数字后缀，如 `tile_01.png`、`tile_02.png`
|
||||||
|
|
||||||
|
### 扩展资源类型
|
||||||
|
|
||||||
|
```
|
||||||
|
✅ 正确
|
||||||
|
# 材质资源
|
||||||
|
material_metal.tres # 金属材质
|
||||||
|
material_wood.tres # 木材材质
|
||||||
|
material_water.tres # 水材质
|
||||||
|
|
||||||
|
# 着色器资源
|
||||||
|
shader_water.gdshader # 水着色器
|
||||||
|
shader_fire.gdshader # 火焰着色器
|
||||||
|
shader_outline.gdshader # 轮廓着色器
|
||||||
|
|
||||||
|
# 特效资源
|
||||||
|
fx_explosion.png # 爆炸特效
|
||||||
|
fx_magic_circle.png # 魔法阵特效
|
||||||
|
fx_damage_numbers.png # 伤害数字特效
|
||||||
|
|
||||||
|
# 环境资源
|
||||||
|
obj_tree.png # 树木对象
|
||||||
|
obj_rock.png # 岩石对象
|
||||||
|
tile_grass_01.png # 草地瓦片
|
||||||
|
tile_stone_01.png # 石头瓦片
|
||||||
|
|
||||||
|
❌ 错误
|
||||||
|
MetalMaterial.tres # 不使用大驼峰
|
||||||
|
material-wood.tres # 不使用连字符
|
||||||
|
SHADER_WATER.gdshader # 不使用全大写
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 目录结构
|
## 目录结构
|
||||||
@@ -421,11 +452,33 @@ assets/ # 资源目录
|
|||||||
sounds/ # 音效
|
sounds/ # 音效
|
||||||
music/ # 音乐
|
music/ # 音乐
|
||||||
fonts/ # 字体
|
fonts/ # 字体
|
||||||
|
materials/ # 材质
|
||||||
|
shaders/ # 着色器
|
||||||
data/ # 数据目录
|
data/ # 数据目录
|
||||||
levels/ # 关卡数据
|
levels/ # 关卡数据
|
||||||
configs/ # 配置文件
|
configs/ # 配置文件
|
||||||
|
dialogues/ # 对话数据
|
||||||
|
localization/ # 本地化数据
|
||||||
|
core/ # 核心系统目录
|
||||||
|
managers/ # 管理器
|
||||||
|
systems/ # 系统组件
|
||||||
|
utils/ # 工具类
|
||||||
|
components/ # 通用组件
|
||||||
|
interfaces/ # 接口定义
|
||||||
|
module/ # 模块目录
|
||||||
|
UI/ # UI模块
|
||||||
|
Character/ # 角色模块
|
||||||
|
Inventory/ # 背包模块
|
||||||
|
Combat/ # 战斗模块
|
||||||
|
Dialogue/ # 对话模块
|
||||||
addons/ # 插件目录
|
addons/ # 插件目录
|
||||||
tests/ # 测试目录
|
tests/ # 测试目录
|
||||||
|
unit/ # 单元测试
|
||||||
|
integration/ # 集成测试
|
||||||
|
ui/ # UI测试
|
||||||
|
performance/ # 性能测试
|
||||||
|
docs/ # 文档目录
|
||||||
|
auth/ # 认证相关文档
|
||||||
|
|
||||||
❌ 错误
|
❌ 错误
|
||||||
Scenes/ # 不使用大写
|
Scenes/ # 不使用大写
|
||||||
|
|||||||
505
docs/project_structure.md
Normal file
505
docs/project_structure.md
Normal file
@@ -0,0 +1,505 @@
|
|||||||
|
# Godot 项目结构说明
|
||||||
|
|
||||||
|
本文档详细说明了 whaleTown 项目的文件结构设计，采用"场景+通用工具+其他"的架构模式，确保每个场景清晰独立且高度解耦。
|
||||||
|
|
||||||
|
## 设计理念
|
||||||
|
|
||||||
|
### 核心原则
|
||||||
|
- **场景独立性**：每个场景都是独立的功能模块，可以单独开发和测试
|
||||||
|
- **高度解耦**：场景之间通过事件系统和管理器进行通信，避免直接依赖
|
||||||
|
- **组件复用**：可复用的组件放在通用模块中，提高开发效率
|
||||||
|
- **资源管理**：统一的资源管理和命名规范，便于维护
|
||||||
|
|
||||||
|
## 项目架构概览
|
||||||
|
|
||||||
|
```
|
||||||
|
whaleTown/
|
||||||
|
├── 🎬 scenes/ # 场景层：独立的游戏场景
|
||||||
|
├── 🔧 core/ # 核心层：通用工具和系统
|
||||||
|
├── 🎨 assets/ # 资源层：静态资源文件
|
||||||
|
├── 📊 data/ # 数据层：配置和游戏数据
|
||||||
|
├── 📝 scripts/ # 脚本层：业务逻辑代码
|
||||||
|
├── 🧩 module/ # 模块层：可复用组件
|
||||||
|
├── 🧪 tests/ # 测试层：单元测试和集成测试
|
||||||
|
└── 📚 docs/ # 文档层：项目文档
|
||||||
|
```
|
||||||
|
|
||||||
|
## 1. 场景层 (scenes/)
|
||||||
|
|
||||||
|
场景层包含所有独立的游戏场景，每个场景都是完整的功能模块。
|
||||||
|
|
||||||
|
### 1.1 场景分类
|
||||||
|
|
||||||
|
#### 主要场景 (Main Scenes)
|
||||||
|
```
|
||||||
|
scenes/
|
||||||
|
├── main_scene.tscn # 主场景：游戏入口
|
||||||
|
├── auth_scene.tscn # 认证场景：登录注册
|
||||||
|
├── menu_scene.tscn # 菜单场景：主菜单界面
|
||||||
|
├── game_scene.tscn # 游戏场景：主要游戏玩法
|
||||||
|
├── battle_scene.tscn # 战斗场景：战斗系统
|
||||||
|
├── inventory_scene.tscn # 背包场景：物品管理
|
||||||
|
├── shop_scene.tscn # 商店场景：购买系统
|
||||||
|
└── settings_scene.tscn # 设置场景：游戏设置
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 预制体场景 (Prefabs)
|
||||||
|
```
|
||||||
|
scenes/prefabs/
|
||||||
|
├── ui/
|
||||||
|
│ ├── dialog_prefab.tscn # 对话框预制体
|
||||||
|
│ ├── button_prefab.tscn # 按钮预制体
|
||||||
|
│ ├── health_bar_prefab.tscn # 血条预制体
|
||||||
|
│ └── notification_prefab.tscn # 通知预制体
|
||||||
|
├── characters/
|
||||||
|
│ ├── player_prefab.tscn # 玩家角色预制体
|
||||||
|
│ ├── npc_prefab.tscn # NPC预制体
|
||||||
|
│ └── enemy_prefab.tscn # 敌人预制体
|
||||||
|
├── items/
|
||||||
|
│ ├── weapon_prefab.tscn # 武器预制体
|
||||||
|
│ ├── consumable_prefab.tscn # 消耗品预制体
|
||||||
|
│ └── collectible_prefab.tscn # 收集品预制体
|
||||||
|
└── effects/
|
||||||
|
├── explosion_prefab.tscn # 爆炸特效预制体
|
||||||
|
├── particle_prefab.tscn # 粒子特效预制体
|
||||||
|
└── damage_text_prefab.tscn # 伤害数字预制体
|
||||||
|
```
|
||||||
|
|
||||||
|
### 1.2 场景设计原则
|
||||||
|
|
||||||
|
- **单一职责**：每个场景只负责一个主要功能
|
||||||
|
- **独立运行**：场景可以独立启动和测试
|
||||||
|
- **标准接口**：场景间通过标准化接口通信
|
||||||
|
- **资源隔离**：场景相关资源放在对应子目录
|
||||||
|
## 2. 核心层 (core/)
|
||||||
|
|
||||||
|
核心层提供通用的工具类、管理器和系统组件，为整个项目提供基础服务。
|
||||||
|
|
||||||
|
### 2.1 核心系统结构
|
||||||
|
|
||||||
|
```
|
||||||
|
core/
|
||||||
|
├── managers/ # 管理器系统
|
||||||
|
│ ├── GameManager.gd # 游戏管理器：全局游戏状态
|
||||||
|
│ ├── SceneManager.gd # 场景管理器：场景切换
|
||||||
|
│ ├── AudioManager.gd # 音频管理器：音效音乐
|
||||||
|
│ ├── InputManager.gd # 输入管理器：输入处理
|
||||||
|
│ ├── SaveManager.gd # 存档管理器：数据存储
|
||||||
|
│ ├── UIManager.gd # UI管理器：界面管理
|
||||||
|
│ └── NetworkManager.gd # 网络管理器：网络通信
|
||||||
|
├── systems/ # 系统组件
|
||||||
|
│ ├── EventSystem.gd # 事件系统：全局事件
|
||||||
|
│ ├── StateMachine.gd # 状态机系统
|
||||||
|
│ ├── ObjectPool.gd # 对象池系统
|
||||||
|
│ ├── ResourceLoader.gd # 资源加载系统
|
||||||
|
│ └── LocalizationSystem.gd # 本地化系统
|
||||||
|
├── utils/ # 工具类
|
||||||
|
│ ├── MathUtils.gd # 数学工具
|
||||||
|
│ ├── StringUtils.gd # 字符串工具
|
||||||
|
│ ├── FileUtils.gd # 文件工具
|
||||||
|
│ ├── TimeUtils.gd # 时间工具
|
||||||
|
│ └── DebugUtils.gd # 调试工具
|
||||||
|
├── components/ # 通用组件
|
||||||
|
│ ├── HealthComponent.gd # 生命值组件
|
||||||
|
│ ├── MovementComponent.gd # 移动组件
|
||||||
|
│ ├── AnimationComponent.gd # 动画组件
|
||||||
|
│ └── CollisionComponent.gd # 碰撞组件
|
||||||
|
└── interfaces/ # 接口定义
|
||||||
|
├── IInteractable.gd # 可交互接口
|
||||||
|
├── IDamageable.gd # 可受伤接口
|
||||||
|
├── ICollectable.gd # 可收集接口
|
||||||
|
└── ISaveable.gd # 可存储接口
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.2 核心系统职责
|
||||||
|
|
||||||
|
#### 管理器 (Managers)
|
||||||
|
- **单例模式**：全局唯一实例
|
||||||
|
- **生命周期管理**：负责系统初始化和清理
|
||||||
|
- **状态维护**：维护全局状态信息
|
||||||
|
- **服务提供**：为其他模块提供服务
|
||||||
|
|
||||||
|
#### 系统组件 (Systems)
|
||||||
|
- **功能封装**：封装特定功能逻辑
|
||||||
|
- **可插拔设计**：可以独立启用或禁用
|
||||||
|
- **事件驱动**：通过事件系统通信
|
||||||
|
- **性能优化**：提供高效的实现方案
|
||||||
|
## 3. 模块层 (module/)
|
||||||
|
|
||||||
|
模块层包含可复用的功能模块，这些模块可以在不同场景中重复使用。
|
||||||
|
|
||||||
|
### 3.1 模块分类
|
||||||
|
|
||||||
|
```
|
||||||
|
module/
|
||||||
|
├── UI/ # UI模块
|
||||||
|
│ ├── components/ # UI组件
|
||||||
|
│ │ ├── Button/ # 按钮组件
|
||||||
|
│ │ │ ├── CustomButton.gd
|
||||||
|
│ │ │ └── custom_button.tscn
|
||||||
|
│ │ ├── Dialog/ # 对话框组件
|
||||||
|
│ │ │ ├── DialogBox.gd
|
||||||
|
│ │ │ └── dialog_box.tscn
|
||||||
|
│ │ ├── ProgressBar/ # 进度条组件
|
||||||
|
│ │ │ ├── CustomProgressBar.gd
|
||||||
|
│ │ │ └── custom_progress_bar.tscn
|
||||||
|
│ │ └── InputField/ # 输入框组件
|
||||||
|
│ │ ├── CustomInputField.gd
|
||||||
|
│ │ └── custom_input_field.tscn
|
||||||
|
│ ├── layouts/ # 布局组件
|
||||||
|
│ │ ├── GridLayout.gd
|
||||||
|
│ │ ├── FlexLayout.gd
|
||||||
|
│ │ └── ResponsiveLayout.gd
|
||||||
|
│ └── animations/ # UI动画
|
||||||
|
│ ├── FadeTransition.gd
|
||||||
|
│ ├── SlideTransition.gd
|
||||||
|
│ └── ScaleTransition.gd
|
||||||
|
├── Character/ # 角色模块
|
||||||
|
│ ├── Player/ # 玩家角色
|
||||||
|
│ │ ├── PlayerController.gd
|
||||||
|
│ │ ├── PlayerStats.gd
|
||||||
|
│ │ └── PlayerAnimator.gd
|
||||||
|
│ ├── NPC/ # NPC角色
|
||||||
|
│ │ ├── NPCController.gd
|
||||||
|
│ │ ├── NPCDialogue.gd
|
||||||
|
│ │ └── NPCBehavior.gd
|
||||||
|
│ └── Enemy/ # 敌人角色
|
||||||
|
│ ├── EnemyAI.gd
|
||||||
|
│ ├── EnemyStats.gd
|
||||||
|
│ └── EnemyBehavior.gd
|
||||||
|
├── Inventory/ # 背包模块
|
||||||
|
│ ├── InventorySystem.gd
|
||||||
|
│ ├── Item.gd
|
||||||
|
│ ├── ItemSlot.gd
|
||||||
|
│ └── ItemDatabase.gd
|
||||||
|
├── Combat/ # 战斗模块
|
||||||
|
│ ├── CombatSystem.gd
|
||||||
|
│ ├── Weapon.gd
|
||||||
|
│ ├── Skill.gd
|
||||||
|
│ └── DamageCalculator.gd
|
||||||
|
└── Dialogue/ # 对话模块
|
||||||
|
├── DialogueSystem.gd
|
||||||
|
├── DialogueNode.gd
|
||||||
|
├── DialogueParser.gd
|
||||||
|
└── DialogueUI.gd
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 模块设计原则
|
||||||
|
|
||||||
|
- **高内聚**：模块内部功能紧密相关
|
||||||
|
- **低耦合**：模块间依赖最小化
|
||||||
|
- **可配置**：通过配置文件自定义行为
|
||||||
|
- **可扩展**：支持功能扩展和定制
|
||||||
|
## 4. 资源层 (assets/)
|
||||||
|
|
||||||
|
资源层统一管理所有静态资源文件，采用分类存储和标准化命名。
|
||||||
|
|
||||||
|
### 4.1 资源目录结构
|
||||||
|
|
||||||
|
```
|
||||||
|
assets/
|
||||||
|
├── sprites/ # 精灵图资源
|
||||||
|
│ ├── characters/ # 角色精灵
|
||||||
|
│ │ ├── player/
|
||||||
|
│ │ │ ├── sprite_player_idle.png
|
||||||
|
│ │ │ ├── sprite_player_walk.png
|
||||||
|
│ │ │ └── sprite_player_attack.png
|
||||||
|
│ │ ├── enemies/
|
||||||
|
│ │ │ ├── sprite_enemy_goblin_idle.png
|
||||||
|
│ │ │ └── sprite_enemy_orc_walk.png
|
||||||
|
│ │ └── npcs/
|
||||||
|
│ │ ├── sprite_npc_merchant.png
|
||||||
|
│ │ └── sprite_npc_guard.png
|
||||||
|
│ ├── ui/ # UI精灵
|
||||||
|
│ │ ├── buttons/
|
||||||
|
│ │ │ ├── ui_button_normal.png
|
||||||
|
│ │ │ ├── ui_button_hover.png
|
||||||
|
│ │ │ └── ui_button_pressed.png
|
||||||
|
│ │ ├── icons/
|
||||||
|
│ │ │ ├── icon_sword.png
|
||||||
|
│ │ │ ├── icon_shield.png
|
||||||
|
│ │ │ └── icon_potion.png
|
||||||
|
│ │ └── panels/
|
||||||
|
│ │ ├── ui_panel_main.png
|
||||||
|
│ │ └── ui_panel_dialog.png
|
||||||
|
│ ├── environment/ # 环境精灵
|
||||||
|
│ │ ├── backgrounds/
|
||||||
|
│ │ │ ├── bg_forest.png
|
||||||
|
│ │ │ └── bg_dungeon.png
|
||||||
|
│ │ ├── tiles/
|
||||||
|
│ │ │ ├── tile_grass_01.png
|
||||||
|
│ │ │ └── tile_stone_01.png
|
||||||
|
│ │ └── objects/
|
||||||
|
│ │ ├── obj_tree.png
|
||||||
|
│ │ └── obj_rock.png
|
||||||
|
│ └── effects/ # 特效精灵
|
||||||
|
│ ├── fx_explosion.png
|
||||||
|
│ ├── fx_magic_circle.png
|
||||||
|
│ └── fx_damage_numbers.png
|
||||||
|
├── audio/ # 音频资源
|
||||||
|
│ ├── music/ # 背景音乐
|
||||||
|
│ │ ├── music_main_menu.ogg
|
||||||
|
│ │ ├── music_battle.ogg
|
||||||
|
│ │ └── music_peaceful.ogg
|
||||||
|
│ ├── sounds/ # 音效
|
||||||
|
│ │ ├── ui/
|
||||||
|
│ │ │ ├── sound_button_click.wav
|
||||||
|
│ │ │ └── sound_menu_open.wav
|
||||||
|
│ │ ├── combat/
|
||||||
|
│ │ │ ├── sound_sword_hit.wav
|
||||||
|
│ │ │ └── sound_explosion.wav
|
||||||
|
│ │ └── ambient/
|
||||||
|
│ │ ├── sound_footsteps.wav
|
||||||
|
│ │ └── sound_wind.wav
|
||||||
|
│ └── voice/ # 语音
|
||||||
|
│ ├── voice_npc_greeting.wav
|
||||||
|
│ └── voice_player_hurt.wav
|
||||||
|
├── fonts/ # 字体资源
|
||||||
|
│ ├── font_main.ttf # 主要字体
|
||||||
|
│ ├── font_title.ttf # 标题字体
|
||||||
|
│ └── font_ui.ttf # UI字体
|
||||||
|
├── materials/ # 材质资源
|
||||||
|
│ ├── material_metal.tres
|
||||||
|
│ ├── material_wood.tres
|
||||||
|
│ └── material_water.tres
|
||||||
|
└── shaders/ # 着色器资源
|
||||||
|
├── shader_water.gdshader
|
||||||
|
├── shader_fire.gdshader
|
||||||
|
└── shader_outline.gdshader
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 资源命名规范
|
||||||
|
|
||||||
|
#### 图片资源命名
|
||||||
|
- **精灵图**：`sprite_[类别]_[名称]_[状态].png`
|
||||||
|
- 示例：`sprite_player_idle.png`、`sprite_enemy_goblin_walk.png`
|
||||||
|
- **UI图片**：`ui_[类型]_[名称]_[状态].png`
|
||||||
|
- 示例：`ui_button_normal.png`、`ui_panel_main.png`
|
||||||
|
- **图标**：`icon_[名称].png`
|
||||||
|
- 示例：`icon_sword.png`、`icon_health.png`
|
||||||
|
- **背景**：`bg_[场景名称].png`
|
||||||
|
- 示例：`bg_forest.png`、`bg_dungeon.png`
|
||||||
|
- **瓦片**：`tile_[材质]_[编号].png`
|
||||||
|
- 示例：`tile_grass_01.png`、`tile_stone_02.png`
|
||||||
|
|
||||||
|
#### 音频资源命名
|
||||||
|
- **音乐**：`music_[场景/情境].ogg`
|
||||||
|
- 示例：`music_battle.ogg`、`music_peaceful.ogg`
|
||||||
|
- **音效**：`sound_[动作/事件].wav`
|
||||||
|
- 示例：`sound_jump.wav`、`sound_explosion.wav`
|
||||||
|
- **语音**：`voice_[角色]_[内容].wav`
|
||||||
|
- 示例：`voice_npc_greeting.wav`、`voice_player_hurt.wav`
|
||||||
|
|
||||||
|
#### 其他资源命名
|
||||||
|
- **字体**：`font_[用途].ttf`
|
||||||
|
- 示例：`font_main.ttf`、`font_title.ttf`
|
||||||
|
- **材质**：`material_[材质名].tres`
|
||||||
|
- 示例：`material_metal.tres`、`material_wood.tres`
|
||||||
|
- **着色器**：`shader_[效果名].gdshader`
|
||||||
|
- 示例：`shader_water.gdshader`、`shader_fire.gdshader`
|
||||||
|
## 5. 脚本层 (scripts/)
|
||||||
|
|
||||||
|
脚本层包含所有业务逻辑代码，按功能模块组织。
|
||||||
|
|
||||||
|
### 5.1 脚本目录结构
|
||||||
|
|
||||||
|
```
|
||||||
|
scripts/
|
||||||
|
├── scenes/ # 场景脚本
|
||||||
|
│ ├── MainScene.gd # 主场景脚本
|
||||||
|
│ ├── AuthScene.gd # 认证场景脚本
|
||||||
|
│ ├── GameScene.gd # 游戏场景脚本
|
||||||
|
│ └── BattleScene.gd # 战斗场景脚本
|
||||||
|
├── ui/ # UI脚本
|
||||||
|
│ ├── MainMenu.gd # 主菜单脚本
|
||||||
|
│ ├── SettingsPanel.gd # 设置面板脚本
|
||||||
|
│ ├── InventoryUI.gd # 背包界面脚本
|
||||||
|
│ └── DialogueUI.gd # 对话界面脚本
|
||||||
|
├── characters/ # 角色脚本
|
||||||
|
│ ├── PlayerController.gd # 玩家控制器
|
||||||
|
│ ├── EnemyAI.gd # 敌人AI
|
||||||
|
│ └── NPCBehavior.gd # NPC行为
|
||||||
|
├── gameplay/ # 游戏玩法脚本
|
||||||
|
│ ├── CombatSystem.gd # 战斗系统
|
||||||
|
│ ├── QuestSystem.gd # 任务系统
|
||||||
|
│ ├── InventorySystem.gd # 背包系统
|
||||||
|
│ └── DialogueSystem.gd # 对话系统
|
||||||
|
├── network/ # 网络脚本
|
||||||
|
│ ├── NetworkClient.gd # 网络客户端
|
||||||
|
│ ├── NetworkServer.gd # 网络服务器
|
||||||
|
│ └── NetworkProtocol.gd # 网络协议
|
||||||
|
└── data/ # 数据脚本
|
||||||
|
├── GameData.gd # 游戏数据
|
||||||
|
├── PlayerData.gd # 玩家数据
|
||||||
|
├── ItemData.gd # 物品数据
|
||||||
|
└── ConfigData.gd # 配置数据
|
||||||
|
```
|
||||||
|
|
||||||
|
## 6. 数据层 (data/)
|
||||||
|
|
||||||
|
数据层存储游戏配置、关卡数据和其他静态数据文件。
|
||||||
|
|
||||||
|
### 6.1 数据目录结构
|
||||||
|
|
||||||
|
```
|
||||||
|
data/
|
||||||
|
├── configs/ # 配置文件
|
||||||
|
│ ├── game_config.json # 游戏配置
|
||||||
|
│ ├── audio_config.json # 音频配置
|
||||||
|
│ ├── input_config.json # 输入配置
|
||||||
|
│ └── graphics_config.json # 图形配置
|
||||||
|
├── levels/ # 关卡数据
|
||||||
|
│ ├── level_01.json # 第一关数据
|
||||||
|
│ ├── level_02.json # 第二关数据
|
||||||
|
│ └── level_boss.json # Boss关数据
|
||||||
|
├── items/ # 物品数据
|
||||||
|
│ ├── weapons.json # 武器数据
|
||||||
|
│ ├── armor.json # 装备数据
|
||||||
|
│ └── consumables.json # 消耗品数据
|
||||||
|
├── characters/ # 角色数据
|
||||||
|
│ ├── player_stats.json # 玩家属性
|
||||||
|
│ ├── enemy_stats.json # 敌人属性
|
||||||
|
│ └── npc_data.json # NPC数据
|
||||||
|
├── dialogues/ # 对话数据
|
||||||
|
│ ├── main_story.json # 主线对话
|
||||||
|
│ ├── side_quests.json # 支线对话
|
||||||
|
│ └── npc_dialogues.json # NPC对话
|
||||||
|
└── localization/ # 本地化数据
|
||||||
|
├── en.json # 英文文本
|
||||||
|
├── zh_CN.json # 简体中文文本
|
||||||
|
└── zh_TW.json # 繁体中文文本
|
||||||
|
```
|
||||||
|
|
||||||
|
## 7. 测试层 (tests/)
|
||||||
|
|
||||||
|
测试层包含单元测试、集成测试和功能测试。
|
||||||
|
|
||||||
|
### 7.1 测试目录结构
|
||||||
|
|
||||||
|
```
|
||||||
|
tests/
|
||||||
|
├── unit/ # 单元测试
|
||||||
|
│ ├── test_player_controller.gd
|
||||||
|
│ ├── test_inventory_system.gd
|
||||||
|
│ └── test_combat_system.gd
|
||||||
|
├── integration/ # 集成测试
|
||||||
|
│ ├── test_scene_transitions.gd
|
||||||
|
│ ├── test_save_load.gd
|
||||||
|
│ └── test_network_sync.gd
|
||||||
|
├── ui/ # UI测试
|
||||||
|
│ ├── test_main_menu.gd
|
||||||
|
│ ├── test_inventory_ui.gd
|
||||||
|
│ └── test_dialogue_ui.gd
|
||||||
|
└── performance/ # 性能测试
|
||||||
|
├── test_memory_usage.gd
|
||||||
|
├── test_frame_rate.gd
|
||||||
|
└── test_loading_times.gd
|
||||||
|
```
|
||||||
|
## 8. 场景间通信机制
|
||||||
|
|
||||||
|
### 8.1 事件系统
|
||||||
|
|
||||||
|
使用全局事件系统实现场景间的松耦合通信：
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# 事件定义示例
|
||||||
|
signal player_health_changed(new_health: int)
|
||||||
|
signal scene_transition_requested(scene_name: String)
|
||||||
|
signal item_collected(item_id: String)
|
||||||
|
signal quest_completed(quest_id: String)
|
||||||
|
|
||||||
|
# 事件发送
|
||||||
|
EventSystem.emit_signal("player_health_changed", 80)
|
||||||
|
|
||||||
|
# 事件监听
|
||||||
|
EventSystem.connect("player_health_changed", _on_player_health_changed)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 8.2 管理器模式
|
||||||
|
|
||||||
|
通过单例管理器实现全局状态管理：
|
||||||
|
|
||||||
|
```gdscript
|
||||||
|
# 场景切换
|
||||||
|
SceneManager.change_scene("battle_scene")
|
||||||
|
|
||||||
|
# 音频播放
|
||||||
|
AudioManager.play_sound("sound_button_click")
|
||||||
|
|
||||||
|
# 数据保存
|
||||||
|
SaveManager.save_game_data(player_data)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 9. 开发工作流
|
||||||
|
|
||||||
|
### 9.1 新场景开发流程
|
||||||
|
|
||||||
|
1. **创建场景文件**：在 `scenes/` 目录创建 `.tscn` 文件
|
||||||
|
2. **编写场景脚本**：在 `scripts/scenes/` 创建对应脚本
|
||||||
|
3. **添加UI组件**：使用 `module/UI/` 中的可复用组件
|
||||||
|
4. **配置场景数据**：在 `data/` 目录添加相关配置
|
||||||
|
5. **编写测试用例**：在 `tests/` 目录添加测试
|
||||||
|
6. **更新文档**：更新相关文档说明
|
||||||
|
|
||||||
|
### 9.2 新功能模块开发流程
|
||||||
|
|
||||||
|
1. **设计模块接口**：定义模块的公共接口
|
||||||
|
2. **实现核心逻辑**：在 `module/` 目录实现功能
|
||||||
|
3. **添加管理器支持**：在 `core/managers/` 添加管理器
|
||||||
|
4. **创建测试场景**：创建独立的测试场景
|
||||||
|
5. **集成到主项目**：将模块集成到现有场景
|
||||||
|
6. **性能优化**：进行性能测试和优化
|
||||||
|
|
||||||
|
## 10. 最佳实践
|
||||||
|
|
||||||
|
### 10.1 代码组织
|
||||||
|
|
||||||
|
- **单一职责**：每个类只负责一个功能
|
||||||
|
- **依赖注入**：通过构造函数或属性注入依赖
|
||||||
|
- **接口隔离**：使用接口定义模块间的契约
|
||||||
|
- **配置外置**：将配置信息放在数据文件中
|
||||||
|
|
||||||
|
### 10.2 性能优化
|
||||||
|
|
||||||
|
- **对象池**：复用频繁创建的对象
|
||||||
|
- **延迟加载**：按需加载资源和场景
|
||||||
|
- **批量处理**：合并相似的操作
|
||||||
|
- **内存管理**：及时释放不需要的资源
|
||||||
|
|
||||||
|
### 10.3 调试和测试
|
||||||
|
|
||||||
|
- **单元测试**：为核心逻辑编写单元测试
|
||||||
|
- **集成测试**：测试模块间的交互
|
||||||
|
- **性能监控**：监控内存和CPU使用情况
|
||||||
|
- **日志记录**：记录关键操作和错误信息
|
||||||
|
|
||||||
|
## 11. 扩展指南
|
||||||
|
|
||||||
|
### 11.1 添加新场景
|
||||||
|
|
||||||
|
1. 在 `scenes/` 目录创建场景文件
|
||||||
|
2. 在 `scripts/scenes/` 创建场景脚本
|
||||||
|
3. 在 `SceneManager` 中注册新场景
|
||||||
|
4. 添加场景切换逻辑
|
||||||
|
|
||||||
|
### 11.2 添加新模块
|
||||||
|
|
||||||
|
1. 在 `module/` 目录创建模块文件夹
|
||||||
|
2. 实现模块的核心功能
|
||||||
|
3. 创建模块管理器（如需要）
|
||||||
|
4. 编写模块文档和示例
|
||||||
|
|
||||||
|
### 11.3 添加新资源类型
|
||||||
|
|
||||||
|
1. 在 `assets/` 目录创建对应分类
|
||||||
|
2. 更新命名规范文档
|
||||||
|
3. 在资源加载器中添加支持
|
||||||
|
4. 更新导入设置
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 总结
|
||||||
|
|
||||||
|
这个项目结构设计遵循了模块化、可扩展、易维护的原则。通过清晰的分层架构和标准化的命名规范，确保了项目的可读性和可维护性。每个开发者都应该遵循这个结构进行开发，以保持项目的一致性和质量。
|
||||||
|
|
||||||
|
如有任何疑问或建议，请参考相关文档或联系项目维护者。
|
||||||
1
module/Character/.gitkeep
Normal file
1
module/Character/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 角色模块目录
|
||||||
1
module/Combat/.gitkeep
Normal file
1
module/Combat/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 战斗模块目录
|
||||||
1
module/Dialogue/.gitkeep
Normal file
1
module/Dialogue/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 对话模块目录
|
||||||
1
module/Inventory/.gitkeep
Normal file
1
module/Inventory/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 背包模块目录
|
||||||
1
module/UI/animations/.gitkeep
Normal file
1
module/UI/animations/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - UI动画目录
|
||||||
1
module/UI/components/.gitkeep
Normal file
1
module/UI/components/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - UI组件目录
|
||||||
1
module/UI/layouts/.gitkeep
Normal file
1
module/UI/layouts/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - UI布局目录
|
||||||
@@ -11,5 +11,20 @@ config_version=5
|
|||||||
[application]
|
[application]
|
||||||
|
|
||||||
config/name="whaleTown"
|
config/name="whaleTown"
|
||||||
|
run/main_scene="res://scenes/main_scene.tscn"
|
||||||
config/features=PackedStringArray("4.5", "Forward Plus")
|
config/features=PackedStringArray("4.5", "Forward Plus")
|
||||||
config/icon="res://icon.svg"
|
config/icon="res://icon.svg"
|
||||||
|
|
||||||
|
[autoload]
|
||||||
|
|
||||||
|
GameManager="*res://core/managers/GameManager.gd"
|
||||||
|
SceneManager="*res://core/managers/SceneManager.gd"
|
||||||
|
EventSystem="*res://core/systems/EventSystem.gd"
|
||||||
|
|
||||||
|
[display]
|
||||||
|
|
||||||
|
window/size/viewport_width=1376
|
||||||
|
window/size/viewport_height=768
|
||||||
|
window/size/mode=2
|
||||||
|
window/stretch/mode="canvas_items"
|
||||||
|
window/stretch/aspect="expand"
|
||||||
|
|||||||
523
scenes/auth_scene.tscn
Normal file
523
scenes/auth_scene.tscn
Normal file
@@ -0,0 +1,523 @@
|
|||||||
|
[gd_scene load_steps=10 format=3 uid="uid://by7m8snb4xllf"]
|
||||||
|
|
||||||
|
[ext_resource type="Texture2D" uid="uid://bx17oy8lvaca4" path="res://assets/ui/auth/bg_auth_scene.png" id="1_background"]
|
||||||
|
[ext_resource type="Texture2D" uid="uid://de4q4s1gxivtf" path="res://assets/ui/auth/login_frame_smart_transparent.png" id="2_frame"]
|
||||||
|
[ext_resource type="Script" uid="uid://nv8eitxieqtm" path="res://scripts/scenes/AuthScene.gd" id="3_script"]
|
||||||
|
|
||||||
|
[sub_resource type="StyleBoxEmpty" id="StyleBoxEmpty_1"]
|
||||||
|
|
||||||
|
[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_hover"]
|
||||||
|
bg_color = Color(0.3, 0.6, 0.9, 1)
|
||||||
|
border_width_left = 2
|
||||||
|
border_width_top = 2
|
||||||
|
border_width_right = 2
|
||||||
|
border_width_bottom = 2
|
||||||
|
border_color = Color(0.2, 0.5, 0.8, 1)
|
||||||
|
corner_radius_top_left = 8
|
||||||
|
corner_radius_top_right = 8
|
||||||
|
corner_radius_bottom_right = 8
|
||||||
|
corner_radius_bottom_left = 8
|
||||||
|
|
||||||
|
[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_normal"]
|
||||||
|
bg_color = Color(0.2, 0.5, 0.8, 1)
|
||||||
|
border_width_left = 2
|
||||||
|
border_width_top = 2
|
||||||
|
border_width_right = 2
|
||||||
|
border_width_bottom = 2
|
||||||
|
border_color = Color(0.15, 0.4, 0.7, 1)
|
||||||
|
corner_radius_top_left = 8
|
||||||
|
corner_radius_top_right = 8
|
||||||
|
corner_radius_bottom_right = 8
|
||||||
|
corner_radius_bottom_left = 8
|
||||||
|
|
||||||
|
[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_pressed"]
|
||||||
|
bg_color = Color(0.4, 0.7, 1, 1)
|
||||||
|
border_width_left = 2
|
||||||
|
border_width_top = 2
|
||||||
|
border_width_right = 2
|
||||||
|
border_width_bottom = 2
|
||||||
|
border_color = Color(0.3, 0.6, 0.9, 1)
|
||||||
|
corner_radius_top_left = 8
|
||||||
|
corner_radius_top_right = 8
|
||||||
|
corner_radius_bottom_right = 8
|
||||||
|
corner_radius_bottom_left = 8
|
||||||
|
|
||||||
|
[sub_resource type="Theme" id="Theme_main_button"]
|
||||||
|
Button/colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
Button/colors/font_hover_color = Color(1, 1, 1, 1)
|
||||||
|
Button/colors/font_pressed_color = Color(1, 1, 1, 1)
|
||||||
|
Button/font_sizes/font_size = 18
|
||||||
|
Button/styles/hover = SubResource("StyleBoxFlat_hover")
|
||||||
|
Button/styles/normal = SubResource("StyleBoxFlat_normal")
|
||||||
|
Button/styles/pressed = SubResource("StyleBoxFlat_pressed")
|
||||||
|
|
||||||
|
[sub_resource type="Theme" id="Theme_button"]
|
||||||
|
Button/colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
Button/colors/font_hover_color = Color(1, 1, 1, 1)
|
||||||
|
Button/colors/font_pressed_color = Color(1, 1, 1, 1)
|
||||||
|
Button/styles/hover = SubResource("StyleBoxFlat_hover")
|
||||||
|
Button/styles/normal = SubResource("StyleBoxFlat_normal")
|
||||||
|
Button/styles/pressed = SubResource("StyleBoxFlat_pressed")
|
||||||
|
|
||||||
|
[node name="AuthScene" type="Control"]
|
||||||
|
layout_mode = 3
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
script = ExtResource("3_script")
|
||||||
|
|
||||||
|
[node name="HTTPRequest" type="HTTPRequest" parent="."]
|
||||||
|
|
||||||
|
[node name="BackgroundImage" type="TextureRect" parent="."]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
texture = ExtResource("1_background")
|
||||||
|
expand_mode = 1
|
||||||
|
stretch_mode = 6
|
||||||
|
|
||||||
|
[node name="WhaleFrame" type="TextureRect" parent="."]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 8
|
||||||
|
anchor_left = 0.5
|
||||||
|
anchor_top = 0.5
|
||||||
|
anchor_right = 0.5
|
||||||
|
anchor_bottom = 0.5
|
||||||
|
offset_left = -300.0
|
||||||
|
offset_top = -300.0
|
||||||
|
offset_right = 300.0
|
||||||
|
offset_bottom = 300.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
texture = ExtResource("2_frame")
|
||||||
|
expand_mode = 1
|
||||||
|
stretch_mode = 5
|
||||||
|
|
||||||
|
[node name="CenterContainer" type="CenterContainer" parent="."]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 8
|
||||||
|
anchor_left = 0.5
|
||||||
|
anchor_top = 0.5
|
||||||
|
anchor_right = 0.5
|
||||||
|
anchor_bottom = 0.5
|
||||||
|
offset_left = -175.0
|
||||||
|
offset_top = -184.0
|
||||||
|
offset_right = 175.0
|
||||||
|
offset_bottom = 236.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
|
||||||
|
[node name="LoginPanel" type="Panel" parent="CenterContainer"]
|
||||||
|
custom_minimum_size = Vector2(350, 400)
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_styles/panel = SubResource("StyleBoxEmpty_1")
|
||||||
|
|
||||||
|
[node name="VBoxContainer" type="VBoxContainer" parent="CenterContainer/LoginPanel"]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
offset_left = 30.0
|
||||||
|
offset_top = 30.0
|
||||||
|
offset_right = -30.0
|
||||||
|
offset_bottom = -30.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
|
||||||
|
[node name="TitleLabel" type="Label" parent="CenterContainer/LoginPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
theme_override_font_sizes/font_size = 24
|
||||||
|
text = "Whaletown"
|
||||||
|
horizontal_alignment = 1
|
||||||
|
vertical_alignment = 1
|
||||||
|
|
||||||
|
[node name="SubtitleLabel" type="Label" parent="CenterContainer/LoginPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
theme_override_font_sizes/font_size = 14
|
||||||
|
text = "开始你的小镇之旅！"
|
||||||
|
horizontal_alignment = 1
|
||||||
|
vertical_alignment = 1
|
||||||
|
|
||||||
|
[node name="HSeparator" type="HSeparator" parent="CenterContainer/LoginPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="LoginForm" type="VBoxContainer" parent="CenterContainer/LoginPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_vertical = 3
|
||||||
|
|
||||||
|
[node name="UsernameContainer" type="VBoxContainer" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="UsernameLabelContainer" type="HBoxContainer" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/UsernameContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="UsernameLabel" type="Label" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/UsernameContainer/UsernameLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "用户名/手机/邮箱"
|
||||||
|
|
||||||
|
[node name="RequiredStar" type="Label" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/UsernameContainer/UsernameLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
text = " *"
|
||||||
|
|
||||||
|
[node name="Spacer" type="Control" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/UsernameContainer/UsernameLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
|
|
||||||
|
[node name="UsernameError" type="Label" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/UsernameContainer/UsernameLabelContainer"]
|
||||||
|
visible = false
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
theme_override_font_sizes/font_size = 12
|
||||||
|
text = "用户名不能为空"
|
||||||
|
horizontal_alignment = 2
|
||||||
|
|
||||||
|
[node name="UsernameInput" type="LineEdit" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/UsernameContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
theme_override_colors/font_placeholder_color = Color(0.5, 0.5, 0.5, 1)
|
||||||
|
placeholder_text = "用户名/手机/邮箱"
|
||||||
|
|
||||||
|
[node name="PasswordContainer" type="VBoxContainer" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="PasswordLabelContainer" type="HBoxContainer" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/PasswordContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="PasswordLabel" type="Label" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/PasswordContainer/PasswordLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "密码"
|
||||||
|
|
||||||
|
[node name="RequiredStar" type="Label" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/PasswordContainer/PasswordLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
text = " *"
|
||||||
|
|
||||||
|
[node name="Spacer" type="Control" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/PasswordContainer/PasswordLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
|
|
||||||
|
[node name="PasswordError" type="Label" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/PasswordContainer/PasswordLabelContainer"]
|
||||||
|
visible = false
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
theme_override_font_sizes/font_size = 12
|
||||||
|
text = "密码不能为空"
|
||||||
|
horizontal_alignment = 2
|
||||||
|
|
||||||
|
[node name="PasswordInput" type="LineEdit" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/PasswordContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
theme_override_colors/font_placeholder_color = Color(0.5, 0.5, 0.5, 1)
|
||||||
|
placeholder_text = "请输入密码"
|
||||||
|
secret = true
|
||||||
|
|
||||||
|
[node name="CheckboxContainer" type="HBoxContainer" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="RememberPassword" type="CheckBox" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/CheckboxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "记住密码"
|
||||||
|
|
||||||
|
[node name="AutoLogin" type="CheckBox" parent="CenterContainer/LoginPanel/VBoxContainer/LoginForm/CheckboxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "自动登录"
|
||||||
|
|
||||||
|
[node name="HSeparator2" type="HSeparator" parent="CenterContainer/LoginPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="MainButton" type="Button" parent="CenterContainer/LoginPanel/VBoxContainer"]
|
||||||
|
custom_minimum_size = Vector2(280, 50)
|
||||||
|
layout_mode = 2
|
||||||
|
theme = SubResource("Theme_main_button")
|
||||||
|
text = "进入小镇"
|
||||||
|
|
||||||
|
[node name="HSeparator3" type="HSeparator" parent="CenterContainer/LoginPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="ButtonContainer" type="HBoxContainer" parent="CenterContainer/LoginPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
alignment = 1
|
||||||
|
|
||||||
|
[node name="LoginBtn" type="Button" parent="CenterContainer/LoginPanel/VBoxContainer/ButtonContainer"]
|
||||||
|
custom_minimum_size = Vector2(100, 35)
|
||||||
|
layout_mode = 2
|
||||||
|
theme = SubResource("Theme_button")
|
||||||
|
text = "密码登录"
|
||||||
|
|
||||||
|
[node name="ToRegisterBtn" type="Button" parent="CenterContainer/LoginPanel/VBoxContainer/ButtonContainer"]
|
||||||
|
custom_minimum_size = Vector2(100, 35)
|
||||||
|
layout_mode = 2
|
||||||
|
theme = SubResource("Theme_button")
|
||||||
|
text = "验证码登录"
|
||||||
|
|
||||||
|
[node name="BottomLinks" type="HBoxContainer" parent="CenterContainer/LoginPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
alignment = 1
|
||||||
|
|
||||||
|
[node name="ForgotPassword" type="Button" parent="CenterContainer/LoginPanel/VBoxContainer/BottomLinks"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "忘记密码?"
|
||||||
|
flat = true
|
||||||
|
|
||||||
|
[node name="RegisterLink" type="Button" parent="CenterContainer/LoginPanel/VBoxContainer/BottomLinks"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "注册居民身份"
|
||||||
|
flat = true
|
||||||
|
|
||||||
|
[node name="RegisterPanel" type="Panel" parent="CenterContainer"]
|
||||||
|
visible = false
|
||||||
|
custom_minimum_size = Vector2(400, 570)
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_styles/panel = SubResource("StyleBoxEmpty_1")
|
||||||
|
|
||||||
|
[node name="VBoxContainer" type="VBoxContainer" parent="CenterContainer/RegisterPanel"]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
offset_left = 30.0
|
||||||
|
offset_top = 75.0
|
||||||
|
offset_right = -30.0
|
||||||
|
offset_bottom = -72.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
alignment = 1
|
||||||
|
|
||||||
|
[node name="TitleLabel" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
theme_override_font_sizes/font_size = 20
|
||||||
|
text = "注册新居民"
|
||||||
|
horizontal_alignment = 1
|
||||||
|
vertical_alignment = 1
|
||||||
|
|
||||||
|
[node name="HSeparator" type="HSeparator" parent="CenterContainer/RegisterPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="RegisterForm" type="VBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_vertical = 3
|
||||||
|
alignment = 1
|
||||||
|
|
||||||
|
[node name="UsernameContainer" type="VBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="UsernameLabelContainer" type="HBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/UsernameContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="UsernameLabel" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/UsernameContainer/UsernameLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "用户名"
|
||||||
|
|
||||||
|
[node name="RequiredStar" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/UsernameContainer/UsernameLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
text = " *"
|
||||||
|
|
||||||
|
[node name="Spacer" type="Control" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/UsernameContainer/UsernameLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
|
|
||||||
|
[node name="UsernameError" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/UsernameContainer/UsernameLabelContainer"]
|
||||||
|
visible = false
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
theme_override_font_sizes/font_size = 12
|
||||||
|
text = "用户名不能为空"
|
||||||
|
horizontal_alignment = 2
|
||||||
|
|
||||||
|
[node name="UsernameInput" type="LineEdit" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/UsernameContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
theme_override_colors/font_placeholder_color = Color(0.5, 0.5, 0.5, 1)
|
||||||
|
placeholder_text = "请输入用户名"
|
||||||
|
|
||||||
|
[node name="EmailContainer" type="VBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="EmailLabelContainer" type="HBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/EmailContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="EmailLabel" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/EmailContainer/EmailLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "邮箱"
|
||||||
|
|
||||||
|
[node name="RequiredStar" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/EmailContainer/EmailLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
text = " *"
|
||||||
|
|
||||||
|
[node name="Spacer" type="Control" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/EmailContainer/EmailLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
|
|
||||||
|
[node name="EmailError" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/EmailContainer/EmailLabelContainer"]
|
||||||
|
visible = false
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
theme_override_font_sizes/font_size = 12
|
||||||
|
text = "邮箱不能为空"
|
||||||
|
horizontal_alignment = 2
|
||||||
|
|
||||||
|
[node name="EmailInput" type="LineEdit" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/EmailContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
theme_override_colors/font_placeholder_color = Color(0.5, 0.5, 0.5, 1)
|
||||||
|
placeholder_text = "请输入邮箱地址"
|
||||||
|
|
||||||
|
[node name="PasswordContainer" type="VBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="PasswordLabelContainer" type="HBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/PasswordContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="PasswordLabel" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/PasswordContainer/PasswordLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "密码"
|
||||||
|
|
||||||
|
[node name="RequiredStar" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/PasswordContainer/PasswordLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
text = " *"
|
||||||
|
|
||||||
|
[node name="Spacer" type="Control" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/PasswordContainer/PasswordLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
|
|
||||||
|
[node name="PasswordError" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/PasswordContainer/PasswordLabelContainer"]
|
||||||
|
visible = false
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
theme_override_font_sizes/font_size = 12
|
||||||
|
text = "密码不能为空"
|
||||||
|
horizontal_alignment = 2
|
||||||
|
|
||||||
|
[node name="PasswordInput" type="LineEdit" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/PasswordContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
theme_override_colors/font_placeholder_color = Color(0.5, 0.5, 0.5, 1)
|
||||||
|
placeholder_text = "请输入密码(至少8位)"
|
||||||
|
secret = true
|
||||||
|
|
||||||
|
[node name="ConfirmContainer" type="VBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="ConfirmLabelContainer" type="HBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/ConfirmContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="ConfirmLabel" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/ConfirmContainer/ConfirmLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "确认密码"
|
||||||
|
|
||||||
|
[node name="RequiredStar" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/ConfirmContainer/ConfirmLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
text = " *"
|
||||||
|
|
||||||
|
[node name="Spacer" type="Control" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/ConfirmContainer/ConfirmLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
|
|
||||||
|
[node name="ConfirmError" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/ConfirmContainer/ConfirmLabelContainer"]
|
||||||
|
visible = false
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
theme_override_font_sizes/font_size = 12
|
||||||
|
text = "确认密码不能为空"
|
||||||
|
horizontal_alignment = 2
|
||||||
|
|
||||||
|
[node name="ConfirmInput" type="LineEdit" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/ConfirmContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
theme_override_colors/font_placeholder_color = Color(0.5, 0.5, 0.5, 1)
|
||||||
|
placeholder_text = "请再次输入密码"
|
||||||
|
secret = true
|
||||||
|
|
||||||
|
[node name="VerificationContainer" type="VBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="VerificationLabelContainer" type="HBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/VerificationContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="VerificationLabel" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/VerificationContainer/VerificationLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
text = "邮箱验证码"
|
||||||
|
|
||||||
|
[node name="RequiredStar" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/VerificationContainer/VerificationLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
text = " *"
|
||||||
|
|
||||||
|
[node name="Spacer" type="Control" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/VerificationContainer/VerificationLabelContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
|
|
||||||
|
[node name="VerificationError" type="Label" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/VerificationContainer/VerificationLabelContainer"]
|
||||||
|
visible = false
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 0.2, 0.2, 1)
|
||||||
|
theme_override_font_sizes/font_size = 12
|
||||||
|
text = "验证码不能为空"
|
||||||
|
horizontal_alignment = 2
|
||||||
|
|
||||||
|
[node name="VerificationInputContainer" type="HBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/VerificationContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="VerificationInput" type="LineEdit" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/VerificationContainer/VerificationInputContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
|
theme_override_colors/font_color = Color(0, 0, 0, 1)
|
||||||
|
theme_override_colors/font_placeholder_color = Color(0.5, 0.5, 0.5, 1)
|
||||||
|
placeholder_text = "请输入6位验证码"
|
||||||
|
max_length = 6
|
||||||
|
|
||||||
|
[node name="SendCodeBtn" type="Button" parent="CenterContainer/RegisterPanel/VBoxContainer/RegisterForm/VerificationContainer/VerificationInputContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
text = "发送验证码"
|
||||||
|
|
||||||
|
[node name="HSeparator2" type="HSeparator" parent="CenterContainer/RegisterPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="ButtonContainer" type="HBoxContainer" parent="CenterContainer/RegisterPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
alignment = 1
|
||||||
|
|
||||||
|
[node name="RegisterBtn" type="Button" parent="CenterContainer/RegisterPanel/VBoxContainer/ButtonContainer"]
|
||||||
|
custom_minimum_size = Vector2(120, 45)
|
||||||
|
layout_mode = 2
|
||||||
|
theme = SubResource("Theme_button")
|
||||||
|
text = "注册"
|
||||||
|
|
||||||
|
[node name="ToLoginBtn" type="Button" parent="CenterContainer/RegisterPanel/VBoxContainer/ButtonContainer"]
|
||||||
|
custom_minimum_size = Vector2(120, 45)
|
||||||
|
layout_mode = 2
|
||||||
|
theme = SubResource("Theme_button")
|
||||||
|
text = "返回登录"
|
||||||
|
|
||||||
|
[node name="ToastContainer" type="Control" parent="."]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
mouse_filter = 2
|
||||||
@@ -1,8 +1,188 @@
|
|||||||
[gd_scene load_steps=2 format=3 uid="uid://4ptgx76y83mx"]
|
[gd_scene load_steps=4 format=3 uid="uid://4ptgx76y83mx"]
|
||||||
|
|
||||||
[sub_resource type="AudioStream" id="AudioStream_o3jxj"]
|
[ext_resource type="Texture2D" uid="uid://bx17oy8lvaca4" path="res://assets/ui/auth/bg_auth_scene.png" id="1_background"]
|
||||||
|
[ext_resource type="PackedScene" uid="uid://by7m8snb4xllf" path="res://scenes/auth_scene.tscn" id="2_main"]
|
||||||
|
[ext_resource type="Script" uid="uid://cejrxy23ldhug" path="res://scripts/scenes/MainScene.gd" id="3_script"]
|
||||||
|
|
||||||
[node name="Node2D" type="Node2D"]
|
[node name="Main" type="Control"]
|
||||||
|
layout_mode = 3
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
script = ExtResource("3_script")
|
||||||
|
|
||||||
[node name="AudioStreamPlayer" type="AudioStreamPlayer" parent="."]
|
[node name="BackgroundImage" type="TextureRect" parent="."]
|
||||||
stream = SubResource("AudioStream_o3jxj")
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
texture = ExtResource("1_background")
|
||||||
|
expand_mode = 1
|
||||||
|
stretch_mode = 6
|
||||||
|
|
||||||
|
[node name="AuthScene" parent="." instance=ExtResource("2_main")]
|
||||||
|
layout_mode = 1
|
||||||
|
|
||||||
|
[node name="MainGameUI" type="Control" parent="."]
|
||||||
|
visible = false
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
|
||||||
|
[node name="UIOverlay" type="ColorRect" parent="MainGameUI"]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
color = Color(0, 0, 0, 0.3)
|
||||||
|
|
||||||
|
[node name="TopBar" type="Panel" parent="MainGameUI"]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 10
|
||||||
|
anchor_right = 1.0
|
||||||
|
offset_bottom = 60.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
|
||||||
|
[node name="HBoxContainer" type="HBoxContainer" parent="MainGameUI/TopBar"]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
offset_left = 20.0
|
||||||
|
offset_top = 10.0
|
||||||
|
offset_right = -20.0
|
||||||
|
offset_bottom = -10.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
|
||||||
|
[node name="WelcomeLabel" type="Label" parent="MainGameUI/TopBar/HBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
|
theme_override_colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
text = "🐋 欢迎来到鲸鱼镇！"
|
||||||
|
vertical_alignment = 1
|
||||||
|
|
||||||
|
[node name="UserLabel" type="Label" parent="MainGameUI/TopBar/HBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
text = "当前用户: [用户名]"
|
||||||
|
horizontal_alignment = 2
|
||||||
|
vertical_alignment = 1
|
||||||
|
|
||||||
|
[node name="LogoutButton" type="Button" parent="MainGameUI/TopBar/HBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
text = "退出"
|
||||||
|
|
||||||
|
[node name="MainContent" type="Control" parent="MainGameUI"]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
offset_top = 60.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
|
||||||
|
[node name="CenterContainer" type="CenterContainer" parent="MainGameUI/MainContent"]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
|
||||||
|
[node name="VBoxContainer" type="VBoxContainer" parent="MainGameUI/MainContent/CenterContainer"]
|
||||||
|
custom_minimum_size = Vector2(600, 400)
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="GameTitle" type="Label" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
theme_override_font_sizes/font_size = 24
|
||||||
|
text = "🏘️ 鲸鱼镇主界面"
|
||||||
|
horizontal_alignment = 1
|
||||||
|
|
||||||
|
[node name="HSeparator" type="HSeparator" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="GameMenuGrid" type="GridContainer" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_vertical = 3
|
||||||
|
columns = 2
|
||||||
|
|
||||||
|
[node name="ExploreButton" type="Button" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/GameMenuGrid"]
|
||||||
|
custom_minimum_size = Vector2(280, 80)
|
||||||
|
layout_mode = 2
|
||||||
|
text = "🗺️ 探索小镇"
|
||||||
|
|
||||||
|
[node name="InventoryButton" type="Button" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/GameMenuGrid"]
|
||||||
|
custom_minimum_size = Vector2(280, 80)
|
||||||
|
layout_mode = 2
|
||||||
|
text = "🎒 背包物品"
|
||||||
|
|
||||||
|
[node name="ShopButton" type="Button" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/GameMenuGrid"]
|
||||||
|
custom_minimum_size = Vector2(280, 80)
|
||||||
|
layout_mode = 2
|
||||||
|
text = "🏪 商店购物"
|
||||||
|
|
||||||
|
[node name="FriendsButton" type="Button" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/GameMenuGrid"]
|
||||||
|
custom_minimum_size = Vector2(280, 80)
|
||||||
|
layout_mode = 2
|
||||||
|
text = "👥 好友列表"
|
||||||
|
|
||||||
|
[node name="HSeparator2" type="HSeparator" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="StatusPanel" type="Panel" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer"]
|
||||||
|
custom_minimum_size = Vector2(0, 120)
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="StatusContainer" type="VBoxContainer" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel"]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
offset_left = 20.0
|
||||||
|
offset_top = 10.0
|
||||||
|
offset_right = -20.0
|
||||||
|
offset_bottom = -10.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
|
||||||
|
[node name="StatusTitle" type="Label" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel/StatusContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
text = "📊 玩家状态"
|
||||||
|
horizontal_alignment = 1
|
||||||
|
|
||||||
|
[node name="StatusGrid" type="GridContainer" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel/StatusContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
columns = 2
|
||||||
|
|
||||||
|
[node name="LevelLabel" type="Label" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel/StatusContainer/StatusGrid"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
text = "等级: 1"
|
||||||
|
|
||||||
|
[node name="CoinsLabel" type="Label" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel/StatusContainer/StatusGrid"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
text = "金币: 100"
|
||||||
|
|
||||||
|
[node name="ExpLabel" type="Label" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel/StatusContainer/StatusGrid"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
text = "经验: 0/100"
|
||||||
|
|
||||||
|
[node name="EnergyLabel" type="Label" parent="MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel/StatusContainer/StatusGrid"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
text = "体力: 100/100"
|
||||||
|
|||||||
1
scenes/prefabs/characters/.gitkeep
Normal file
1
scenes/prefabs/characters/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 角色预制体目录
|
||||||
1
scenes/prefabs/effects/.gitkeep
Normal file
1
scenes/prefabs/effects/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 特效预制体目录
|
||||||
1
scenes/prefabs/items/.gitkeep
Normal file
1
scenes/prefabs/items/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 物品预制体目录
|
||||||
1
scenes/prefabs/ui/.gitkeep
Normal file
1
scenes/prefabs/ui/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - UI预制体目录
|
||||||
1
scripts/characters/.gitkeep
Normal file
1
scripts/characters/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 角色脚本目录
|
||||||
1
scripts/data/.gitkeep
Normal file
1
scripts/data/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 数据脚本目录
|
||||||
1
scripts/gameplay/.gitkeep
Normal file
1
scripts/gameplay/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 游戏玩法脚本目录
|
||||||
31
scripts/network/NetworkTest.gd
Normal file
31
scripts/network/NetworkTest.gd
Normal file
@@ -0,0 +1,31 @@
|
|||||||
|
extends Node
|
||||||
|
|
||||||
|
# 简单的API测试脚本
|
||||||
|
const API_BASE_URL = "https://whaletownend.xinghangee.icu"
|
||||||
|
|
||||||
|
func _ready():
|
||||||
|
print("API测试脚本已加载")
|
||||||
|
print("服务器地址: ", API_BASE_URL)
|
||||||
|
|
||||||
|
# 测试服务器连接
|
||||||
|
test_server_status()
|
||||||
|
|
||||||
|
func test_server_status():
|
||||||
|
var http_request = HTTPRequest.new()
|
||||||
|
add_child(http_request)
|
||||||
|
http_request.request_completed.connect(_on_status_request_completed)
|
||||||
|
|
||||||
|
print("正在测试服务器连接...")
|
||||||
|
var error = http_request.request(API_BASE_URL)
|
||||||
|
if error != OK:
|
||||||
|
print("请求失败: ", error)
|
||||||
|
|
||||||
|
func _on_status_request_completed(result: int, response_code: int, headers: PackedStringArray, body: PackedByteArray):
|
||||||
|
var response_text = body.get_string_from_utf8()
|
||||||
|
print("服务器状态响应: ", response_code)
|
||||||
|
print("响应内容: ", response_text)
|
||||||
|
|
||||||
|
if response_code == 200:
|
||||||
|
print("✅ 服务器连接正常")
|
||||||
|
else:
|
||||||
|
print("❌ 服务器连接失败")
|
||||||
1
scripts/network/NetworkTest.gd.uid
Normal file
1
scripts/network/NetworkTest.gd.uid
Normal file
@@ -0,0 +1 @@
|
|||||||
|
uid://bsfrdqpsvwgtb
|
||||||
1098
scripts/scenes/AuthScene.gd
Normal file
1098
scripts/scenes/AuthScene.gd
Normal file
File diff suppressed because it is too large
Load Diff
1
scripts/scenes/AuthScene.gd.uid
Normal file
1
scripts/scenes/AuthScene.gd.uid
Normal file
@@ -0,0 +1 @@
|
|||||||
|
uid://nv8eitxieqtm
|
||||||
116
scripts/scenes/MainScene.gd
Normal file
116
scripts/scenes/MainScene.gd
Normal file
@@ -0,0 +1,116 @@
|
|||||||
|
extends Control
|
||||||
|
|
||||||
|
# 场景节点引用
|
||||||
|
@onready var auth_scene: Control = $AuthScene
|
||||||
|
@onready var main_game_ui: Control = $MainGameUI
|
||||||
|
@onready var user_label: Label = $MainGameUI/TopBar/HBoxContainer/UserLabel
|
||||||
|
@onready var logout_button: Button = $MainGameUI/TopBar/HBoxContainer/LogoutButton
|
||||||
|
|
||||||
|
# 游戏功能按钮
|
||||||
|
@onready var explore_button: Button = $MainGameUI/MainContent/CenterContainer/VBoxContainer/GameMenuGrid/ExploreButton
|
||||||
|
@onready var inventory_button: Button = $MainGameUI/MainContent/CenterContainer/VBoxContainer/GameMenuGrid/InventoryButton
|
||||||
|
@onready var shop_button: Button = $MainGameUI/MainContent/CenterContainer/VBoxContainer/GameMenuGrid/ShopButton
|
||||||
|
@onready var friends_button: Button = $MainGameUI/MainContent/CenterContainer/VBoxContainer/GameMenuGrid/FriendsButton
|
||||||
|
|
||||||
|
# 状态标签
|
||||||
|
@onready var level_label: Label = $MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel/StatusContainer/StatusGrid/LevelLabel
|
||||||
|
@onready var coins_label: Label = $MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel/StatusContainer/StatusGrid/CoinsLabel
|
||||||
|
@onready var exp_label: Label = $MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel/StatusContainer/StatusGrid/ExpLabel
|
||||||
|
@onready var energy_label: Label = $MainGameUI/MainContent/CenterContainer/VBoxContainer/StatusPanel/StatusContainer/StatusGrid/EnergyLabel
|
||||||
|
|
||||||
|
# 游戏状态
|
||||||
|
enum GameState {
|
||||||
|
AUTH, # 登录/注册状态
|
||||||
|
MAIN_GAME # 主游戏状态
|
||||||
|
}
|
||||||
|
|
||||||
|
var current_state: GameState = GameState.AUTH
|
||||||
|
var current_user: String = ""
|
||||||
|
|
||||||
|
# 玩家数据
|
||||||
|
var player_level: int = 1
|
||||||
|
var player_coins: int = 100
|
||||||
|
var player_exp: int = 0
|
||||||
|
var player_max_exp: int = 100
|
||||||
|
var player_energy: int = 100
|
||||||
|
var player_max_energy: int = 100
|
||||||
|
|
||||||
|
func _ready():
|
||||||
|
# 初始化游戏状态
|
||||||
|
setup_game()
|
||||||
|
|
||||||
|
# 连接登录成功信号
|
||||||
|
auth_scene.login_success.connect(_on_login_success)
|
||||||
|
|
||||||
|
# 连接按钮信号
|
||||||
|
logout_button.pressed.connect(_on_logout_pressed)
|
||||||
|
explore_button.pressed.connect(_on_explore_pressed)
|
||||||
|
inventory_button.pressed.connect(_on_inventory_pressed)
|
||||||
|
shop_button.pressed.connect(_on_shop_pressed)
|
||||||
|
friends_button.pressed.connect(_on_friends_pressed)
|
||||||
|
|
||||||
|
func setup_game():
|
||||||
|
# 设置初始状态为登录界面
|
||||||
|
show_auth_scene()
|
||||||
|
|
||||||
|
func show_auth_scene():
|
||||||
|
current_state = GameState.AUTH
|
||||||
|
auth_scene.visible = true
|
||||||
|
main_game_ui.visible = false
|
||||||
|
|
||||||
|
func show_main_game():
|
||||||
|
current_state = GameState.MAIN_GAME
|
||||||
|
auth_scene.visible = false
|
||||||
|
main_game_ui.visible = true
|
||||||
|
user_label.text = "当前用户: " + current_user
|
||||||
|
update_player_status()
|
||||||
|
print("进入主游戏界面")
|
||||||
|
|
||||||
|
func update_player_status():
|
||||||
|
level_label.text = "等级: " + str(player_level)
|
||||||
|
coins_label.text = "金币: " + str(player_coins)
|
||||||
|
exp_label.text = "经验: " + str(player_exp) + "/" + str(player_max_exp)
|
||||||
|
energy_label.text = "体力: " + str(player_energy) + "/" + str(player_max_energy)
|
||||||
|
|
||||||
|
func _on_login_success(username: String):
|
||||||
|
# 登录成功后的处理
|
||||||
|
current_user = username
|
||||||
|
print("用户 ", username, " 登录成功！")
|
||||||
|
show_main_game()
|
||||||
|
|
||||||
|
func _on_logout_pressed():
|
||||||
|
# 登出处理
|
||||||
|
current_user = ""
|
||||||
|
show_auth_scene()
|
||||||
|
|
||||||
|
# 游戏功能按钮处理
|
||||||
|
func _on_explore_pressed():
|
||||||
|
print("探索小镇功能")
|
||||||
|
show_game_message("🗺️ 探索功能开发中...")
|
||||||
|
|
||||||
|
func _on_inventory_pressed():
|
||||||
|
print("背包功能")
|
||||||
|
show_game_message("🎒 背包功能开发中...")
|
||||||
|
|
||||||
|
func _on_shop_pressed():
|
||||||
|
print("商店功能")
|
||||||
|
show_game_message("🏪 商店功能开发中...")
|
||||||
|
|
||||||
|
func _on_friends_pressed():
|
||||||
|
print("好友功能")
|
||||||
|
show_game_message("👥 好友功能开发中...")
|
||||||
|
|
||||||
|
func show_game_message(message: String):
|
||||||
|
print("游戏消息: ", message)
|
||||||
|
# 这里可以添加UI提示框显示消息
|
||||||
|
|
||||||
|
# 处理全局输入
|
||||||
|
func _input(event):
|
||||||
|
if event.is_action_pressed("ui_cancel"):
|
||||||
|
match current_state:
|
||||||
|
GameState.AUTH:
|
||||||
|
# 在登录界面按ESC退出游戏
|
||||||
|
get_tree().quit()
|
||||||
|
GameState.MAIN_GAME:
|
||||||
|
# 在游戏中按ESC可能显示菜单或返回登录
|
||||||
|
show_auth_scene()
|
||||||
1
scripts/scenes/MainScene.gd.uid
Normal file
1
scripts/scenes/MainScene.gd.uid
Normal file
@@ -0,0 +1 @@
|
|||||||
|
uid://cejrxy23ldhug
|
||||||
1
scripts/ui/.gitkeep
Normal file
1
scripts/ui/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - UI脚本目录
|
||||||
150
tests/api/README.md
Normal file
150
tests/api/README.md
Normal file
@@ -0,0 +1,150 @@
|
|||||||
|
# API接口测试
|
||||||
|
|
||||||
|
本目录包含用于测试whaleTown项目API接口的测试脚本。
|
||||||
|
|
||||||
|
## 测试脚本说明
|
||||||
|
|
||||||
|
### 1. `simple_api_test.py` - 简化版测试
|
||||||
|
快速验证API接口的基本连通性和功能。
|
||||||
|
|
||||||
|
**使用方法：**
|
||||||
|
```bash
|
||||||
|
# 使用默认服务器地址
|
||||||
|
python tests/api/simple_api_test.py
|
||||||
|
|
||||||
|
# 使用自定义服务器地址
|
||||||
|
python tests/api/simple_api_test.py http://localhost:3000
|
||||||
|
```
|
||||||
|
|
||||||
|
**测试内容：**
|
||||||
|
- ✅ 应用状态检查 (`GET /`)
|
||||||
|
- ✅ 发送邮箱验证码 (`POST /auth/send-email-verification`)
|
||||||
|
- ✅ 用户注册 (`POST /auth/register`)
|
||||||
|
- ✅ 用户登录 (`POST /auth/login`)
|
||||||
|
- ✅ 无效登录测试
|
||||||
|
- ✅ 管理员登录测试
|
||||||
|
|
||||||
|
### 2. `api_test.py` - 完整版测试
|
||||||
|
全面的API接口测试，包括边界条件和错误处理。
|
||||||
|
|
||||||
|
**使用方法：**
|
||||||
|
```bash
|
||||||
|
# 基础测试
|
||||||
|
python tests/api/api_test.py
|
||||||
|
|
||||||
|
# 详细日志
|
||||||
|
python tests/api/api_test.py --verbose
|
||||||
|
|
||||||
|
# 自定义参数
|
||||||
|
python tests/api/api_test.py --base-url http://localhost:3000 --test-email custom@example.com
|
||||||
|
```
|
||||||
|
|
||||||
|
**测试内容：**
|
||||||
|
- 应用状态接口测试
|
||||||
|
- 用户认证功能测试
|
||||||
|
- 管理员功能测试
|
||||||
|
- 用户状态管理测试
|
||||||
|
- 错误处理测试
|
||||||
|
- 频率限制测试
|
||||||
|
|
||||||
|
## 测试结果示例
|
||||||
|
|
||||||
|
### 成功的测试输出
|
||||||
|
```
|
||||||
|
[18:28:55] 🚀 开始基础API测试...
|
||||||
|
[18:28:55] 测试目标: https://whaletownend.xinghangee.icu
|
||||||
|
[18:28:55] ✅ 应用状态检查
|
||||||
|
[18:28:55] 状态码: 200
|
||||||
|
[18:28:55] 响应: Pixel Game Server is running!
|
||||||
|
[18:28:55] ✅ 发送邮箱验证码
|
||||||
|
[18:28:55] 状态码: 200
|
||||||
|
[18:28:55] 📧 获取到验证码: 046189
|
||||||
|
[18:28:55] ✅ 用户注册
|
||||||
|
[18:28:55] 状态码: 201
|
||||||
|
[18:28:55] 🎯 基础测试完成！
|
||||||
|
```
|
||||||
|
|
||||||
|
### API接口验证结果
|
||||||
|
|
||||||
|
根据测试结果，以下接口已验证可用：
|
||||||
|
|
||||||
|
#### ✅ 可用接口
|
||||||
|
1. **应用状态** - `GET /`
|
||||||
|
- 状态码: 200
|
||||||
|
- 响应: "Pixel Game Server is running!"
|
||||||
|
|
||||||
|
2. **发送邮箱验证码** - `POST /auth/send-email-verification`
|
||||||
|
- 状态码: 200
|
||||||
|
- 功能: 正常发送验证码
|
||||||
|
- 频率限制: 1分钟内限制重复发送
|
||||||
|
|
||||||
|
3. **用户注册** - `POST /auth/register`
|
||||||
|
- 状态码: 201 (成功) / 400 (参数错误)
|
||||||
|
- 需要邮箱验证码
|
||||||
|
- 支持完整的参数验证
|
||||||
|
|
||||||
|
4. **用户登录** - `POST /auth/login`
|
||||||
|
- 状态码: 200
|
||||||
|
- 支持用户名/邮箱登录
|
||||||
|
- 正确的错误处理
|
||||||
|
|
||||||
|
#### ❌ 不可用接口
|
||||||
|
1. **管理员登录** - `POST /admin/auth/login`
|
||||||
|
- 状态码: 404
|
||||||
|
- 错误: "Cannot POST /admin/auth/login"
|
||||||
|
- 可能的原因: 路径不正确或功能未实现
|
||||||
|
|
||||||
|
## 测试发现的问题
|
||||||
|
|
||||||
|
### 1. 管理员接口路径问题
|
||||||
|
- 文档中的 `/admin/auth/login` 返回404
|
||||||
|
- 需要确认正确的管理员登录路径
|
||||||
|
|
||||||
|
### 2. 频率限制功能正常
|
||||||
|
- 验证码发送有1分钟的频率限制
|
||||||
|
- 错误消息清晰："请等待 XX 秒后再试"
|
||||||
|
|
||||||
|
### 3. 参数验证严格
|
||||||
|
- 注册时必须提供邮箱验证码
|
||||||
|
- 错误消息准确："提供邮箱时必须提供邮箱验证码"
|
||||||
|
|
||||||
|
## 建议的测试流程
|
||||||
|
|
||||||
|
### 开发环境测试
|
||||||
|
1. 运行简化版测试验证基本功能
|
||||||
|
2. 检查所有接口的连通性
|
||||||
|
3. 验证错误处理是否正确
|
||||||
|
|
||||||
|
### 生产环境测试
|
||||||
|
1. 使用完整版测试进行全面验证
|
||||||
|
2. 测试所有边界条件
|
||||||
|
3. 验证安全功能（频率限制、权限控制）
|
||||||
|
|
||||||
|
## 扩展测试
|
||||||
|
|
||||||
|
### 添加新的测试用例
|
||||||
|
1. 在对应的测试脚本中添加新的测试方法
|
||||||
|
2. 遵循现有的测试模式
|
||||||
|
3. 添加适当的错误处理
|
||||||
|
|
||||||
|
### 自定义测试参数
|
||||||
|
```python
|
||||||
|
# 修改测试配置
|
||||||
|
tester = SimpleAPITester("http://your-server.com")
|
||||||
|
tester.run_basic_tests()
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **频率限制**: 测试时注意API的频率限制，避免被限制
|
||||||
|
2. **测试数据**: 使用时间戳生成唯一的测试数据
|
||||||
|
3. **网络超时**: 设置合适的请求超时时间
|
||||||
|
4. **错误处理**: 测试脚本包含完整的错误处理逻辑
|
||||||
|
|
||||||
|
## 依赖要求
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install requests
|
||||||
|
```
|
||||||
|
|
||||||
|
测试脚本使用Python标准库和requests库，无需额外依赖。
|
||||||
506
tests/api/api_test.py
Normal file
506
tests/api/api_test.py
Normal file
@@ -0,0 +1,506 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
"""
|
||||||
|
API接口测试脚本
|
||||||
|
|
||||||
|
根据 docs/api-documentation.md 文档自动测试所有API接口
|
||||||
|
支持完整的功能测试、边界条件测试和错误处理测试
|
||||||
|
|
||||||
|
使用方法:
|
||||||
|
python tests/api/api_test.py
|
||||||
|
python tests/api/api_test.py --base-url http://localhost:3000
|
||||||
|
python tests/api/api_test.py --verbose --test-email custom@example.com
|
||||||
|
"""
|
||||||
|
|
||||||
|
import requests
|
||||||
|
import json
|
||||||
|
import time
|
||||||
|
import argparse
|
||||||
|
import sys
|
||||||
|
from datetime import datetime
|
||||||
|
from typing import Dict, Any, Optional, List
|
||||||
|
import uuid
|
||||||
|
|
||||||
|
|
||||||
|
class APITester:
|
||||||
|
"""API接口测试类"""
|
||||||
|
|
||||||
|
def __init__(self, base_url: str = "https://whaletownend.xinghangee.icu",
|
||||||
|
test_email: str = "test@example.com", verbose: bool = False):
|
||||||
|
self.base_url = base_url.rstrip('/')
|
||||||
|
self.test_email = test_email
|
||||||
|
self.verbose = verbose
|
||||||
|
self.session = requests.Session()
|
||||||
|
self.session.headers.update({
|
||||||
|
'Content-Type': 'application/json',
|
||||||
|
'User-Agent': 'whaleTown-API-Tester/1.0'
|
||||||
|
})
|
||||||
|
|
||||||
|
# 测试数据存储
|
||||||
|
self.test_data = {
|
||||||
|
'admin_token': None,
|
||||||
|
'user_token': None,
|
||||||
|
'test_user_id': None,
|
||||||
|
'verification_code': None
|
||||||
|
}
|
||||||
|
|
||||||
|
# 测试结果统计
|
||||||
|
self.stats = {
|
||||||
|
'total': 0,
|
||||||
|
'passed': 0,
|
||||||
|
'failed': 0,
|
||||||
|
'errors': []
|
||||||
|
}
|
||||||
|
|
||||||
|
def log(self, message: str, level: str = "INFO"):
|
||||||
|
"""日志输出"""
|
||||||
|
timestamp = datetime.now().strftime("%H:%M:%S")
|
||||||
|
if level == "ERROR" or self.verbose:
|
||||||
|
print(f"[{timestamp}] {level}: {message}")
|
||||||
|
|
||||||
|
def make_request(self, method: str, endpoint: str, data: Dict = None,
|
||||||
|
headers: Dict = None, expected_status: int = None) -> Dict:
|
||||||
|
"""发送HTTP请求"""
|
||||||
|
url = f"{self.base_url}{endpoint}"
|
||||||
|
request_headers = self.session.headers.copy()
|
||||||
|
if headers:
|
||||||
|
request_headers.update(headers)
|
||||||
|
|
||||||
|
try:
|
||||||
|
if method.upper() == 'GET':
|
||||||
|
response = self.session.get(url, headers=request_headers, timeout=30)
|
||||||
|
elif method.upper() == 'POST':
|
||||||
|
response = self.session.post(url, json=data, headers=request_headers, timeout=30)
|
||||||
|
elif method.upper() == 'PUT':
|
||||||
|
response = self.session.put(url, json=data, headers=request_headers, timeout=30)
|
||||||
|
else:
|
||||||
|
raise ValueError(f"不支持的HTTP方法: {method}")
|
||||||
|
|
||||||
|
# 检查状态码
|
||||||
|
if expected_status and response.status_code != expected_status:
|
||||||
|
self.log(f"状态码不匹配: 期望 {expected_status}, 实际 {response.status_code}", "ERROR")
|
||||||
|
|
||||||
|
# 尝试解析JSON
|
||||||
|
try:
|
||||||
|
result = response.json()
|
||||||
|
except json.JSONDecodeError:
|
||||||
|
result = {"raw_response": response.text, "status_code": response.status_code}
|
||||||
|
|
||||||
|
result['status_code'] = response.status_code
|
||||||
|
return result
|
||||||
|
|
||||||
|
except requests.exceptions.RequestException as e:
|
||||||
|
self.log(f"请求失败: {str(e)}", "ERROR")
|
||||||
|
return {"error": str(e), "status_code": 0}
|
||||||
|
|
||||||
|
def assert_response(self, response: Dict, expected_success: bool = True,
|
||||||
|
expected_fields: List[str] = None, test_name: str = ""):
|
||||||
|
"""验证响应结果"""
|
||||||
|
self.stats['total'] += 1
|
||||||
|
|
||||||
|
try:
|
||||||
|
# 检查基本结构
|
||||||
|
if 'error' in response:
|
||||||
|
raise AssertionError(f"请求错误: {response['error']}")
|
||||||
|
|
||||||
|
# 检查success字段
|
||||||
|
if 'success' in response:
|
||||||
|
if response['success'] != expected_success:
|
||||||
|
raise AssertionError(f"success字段不匹配: 期望 {expected_success}, 实际 {response['success']}")
|
||||||
|
|
||||||
|
# 检查必需字段
|
||||||
|
if expected_fields:
|
||||||
|
for field in expected_fields:
|
||||||
|
if field not in response:
|
||||||
|
raise AssertionError(f"缺少必需字段: {field}")
|
||||||
|
|
||||||
|
self.stats['passed'] += 1
|
||||||
|
self.log(f"✅ {test_name} - 通过")
|
||||||
|
return True
|
||||||
|
|
||||||
|
except AssertionError as e:
|
||||||
|
self.stats['failed'] += 1
|
||||||
|
error_msg = f"❌ {test_name} - 失败: {str(e)}"
|
||||||
|
self.log(error_msg, "ERROR")
|
||||||
|
self.stats['errors'].append(error_msg)
|
||||||
|
return False
|
||||||
|
|
||||||
|
def test_app_status(self):
|
||||||
|
"""测试应用状态接口"""
|
||||||
|
self.log("开始测试应用状态接口...")
|
||||||
|
|
||||||
|
response = self.make_request('GET', '/')
|
||||||
|
|
||||||
|
# 应用状态接口可能返回不同的字段结构
|
||||||
|
if response.get('status_code') == 200:
|
||||||
|
# 检查是否有基本的状态信息
|
||||||
|
has_status_info = any(key in response for key in ['service', 'status', 'version', 'timestamp'])
|
||||||
|
if has_status_info:
|
||||||
|
self.stats['total'] += 1
|
||||||
|
self.stats['passed'] += 1
|
||||||
|
self.log(f"✅ 获取应用状态 - 通过")
|
||||||
|
else:
|
||||||
|
self.stats['total'] += 1
|
||||||
|
self.stats['failed'] += 1
|
||||||
|
error_msg = f"❌ 获取应用状态 - 失败: 响应格式不正确"
|
||||||
|
self.log(error_msg, "ERROR")
|
||||||
|
self.stats['errors'].append(error_msg)
|
||||||
|
else:
|
||||||
|
self.stats['total'] += 1
|
||||||
|
self.stats['failed'] += 1
|
||||||
|
error_msg = f"❌ 获取应用状态 - 失败: HTTP状态码 {response.get('status_code')}"
|
||||||
|
self.log(error_msg, "ERROR")
|
||||||
|
self.stats['errors'].append(error_msg)
|
||||||
|
|
||||||
|
def test_send_verification_code(self) -> Optional[str]:
|
||||||
|
"""测试发送邮箱验证码"""
|
||||||
|
self.log("开始测试发送邮箱验证码...")
|
||||||
|
|
||||||
|
response = self.make_request('POST', '/auth/send-email-verification', {
|
||||||
|
'email': self.test_email
|
||||||
|
})
|
||||||
|
|
||||||
|
# 测试模式下返回206状态码，success为false但有验证码
|
||||||
|
if response.get('status_code') == 206:
|
||||||
|
if 'data' in response and 'verification_code' in response['data']:
|
||||||
|
verification_code = response['data']['verification_code']
|
||||||
|
self.test_data['verification_code'] = verification_code
|
||||||
|
self.log(f"获取到验证码: {verification_code}")
|
||||||
|
self.stats['total'] += 1
|
||||||
|
self.stats['passed'] += 1
|
||||||
|
self.log(f"✅ 发送邮箱验证码(测试模式) - 通过")
|
||||||
|
return verification_code
|
||||||
|
elif response.get('success') == True:
|
||||||
|
# 正常模式
|
||||||
|
self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=True,
|
||||||
|
expected_fields=['data'],
|
||||||
|
test_name="发送邮箱验证码"
|
||||||
|
)
|
||||||
|
if 'data' in response and 'verification_code' in response['data']:
|
||||||
|
return response['data']['verification_code']
|
||||||
|
|
||||||
|
# 测试失败
|
||||||
|
self.stats['total'] += 1
|
||||||
|
self.stats['failed'] += 1
|
||||||
|
error_msg = f"❌ 发送邮箱验证码 - 失败: 无法获取验证码"
|
||||||
|
self.log(error_msg, "ERROR")
|
||||||
|
self.stats['errors'].append(error_msg)
|
||||||
|
return None
|
||||||
|
|
||||||
|
def test_user_register(self) -> Optional[str]:
|
||||||
|
"""测试用户注册"""
|
||||||
|
self.log("开始测试用户注册...")
|
||||||
|
|
||||||
|
# 先获取验证码
|
||||||
|
verification_code = self.test_send_verification_code()
|
||||||
|
if not verification_code:
|
||||||
|
self.log("无法获取验证码，跳过注册测试", "ERROR")
|
||||||
|
return None
|
||||||
|
|
||||||
|
# 生成唯一用户名
|
||||||
|
username = f"testuser_{int(time.time())}"
|
||||||
|
|
||||||
|
response = self.make_request('POST', '/auth/register', {
|
||||||
|
'username': username,
|
||||||
|
'password': 'Test123456',
|
||||||
|
'nickname': '测试用户',
|
||||||
|
'email': self.test_email
|
||||||
|
})
|
||||||
|
|
||||||
|
if self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=True,
|
||||||
|
expected_fields=['data'],
|
||||||
|
test_name="用户注册"
|
||||||
|
):
|
||||||
|
if 'data' in response and 'user' in response['data']:
|
||||||
|
user_id = response['data']['user'].get('id')
|
||||||
|
self.test_data['test_user_id'] = user_id
|
||||||
|
self.log(f"注册成功，用户ID: {user_id}")
|
||||||
|
|
||||||
|
# 保存用户token
|
||||||
|
if 'access_token' in response['data']:
|
||||||
|
self.test_data['user_token'] = response['data']['access_token']
|
||||||
|
|
||||||
|
return user_id
|
||||||
|
|
||||||
|
return None
|
||||||
|
|
||||||
|
def test_user_login(self):
|
||||||
|
"""测试用户登录"""
|
||||||
|
self.log("开始测试用户登录...")
|
||||||
|
|
||||||
|
# 使用已注册的用户登录
|
||||||
|
username = f"testuser_{int(time.time() - 1)}" # 使用之前的用户名
|
||||||
|
|
||||||
|
response = self.make_request('POST', '/auth/login', {
|
||||||
|
'identifier': username,
|
||||||
|
'password': 'Test123456'
|
||||||
|
})
|
||||||
|
|
||||||
|
# 如果用户不存在，尝试注册后登录
|
||||||
|
if not response.get('success'):
|
||||||
|
self.log("用户不存在，先注册用户...")
|
||||||
|
self.test_user_register()
|
||||||
|
|
||||||
|
# 重新尝试登录
|
||||||
|
response = self.make_request('POST', '/auth/login', {
|
||||||
|
'identifier': username,
|
||||||
|
'password': 'Test123456'
|
||||||
|
})
|
||||||
|
|
||||||
|
self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=True,
|
||||||
|
expected_fields=['data'],
|
||||||
|
test_name="用户登录"
|
||||||
|
)
|
||||||
|
|
||||||
|
def test_admin_login(self) -> Optional[str]:
|
||||||
|
"""测试管理员登录"""
|
||||||
|
self.log("开始测试管理员登录...")
|
||||||
|
|
||||||
|
# 尝试不同的管理员登录路径
|
||||||
|
admin_endpoints = ['/admin/auth/login', '/admin/login']
|
||||||
|
|
||||||
|
for endpoint in admin_endpoints:
|
||||||
|
response = self.make_request('POST', endpoint, {
|
||||||
|
'identifier': 'admin',
|
||||||
|
'password': 'Admin123456'
|
||||||
|
})
|
||||||
|
|
||||||
|
if response.get('status_code') != 404:
|
||||||
|
if self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=True,
|
||||||
|
expected_fields=['data'],
|
||||||
|
test_name=f"管理员登录({endpoint})"
|
||||||
|
):
|
||||||
|
if 'data' in response and 'access_token' in response['data']:
|
||||||
|
admin_token = response['data']['access_token']
|
||||||
|
self.test_data['admin_token'] = admin_token
|
||||||
|
self.log("管理员登录成功")
|
||||||
|
return admin_token
|
||||||
|
break
|
||||||
|
|
||||||
|
# 如果所有端点都失败
|
||||||
|
self.stats['total'] += 1
|
||||||
|
self.stats['failed'] += 1
|
||||||
|
error_msg = f"❌ 管理员登录 - 失败: 所有管理员登录端点都不可用"
|
||||||
|
self.log(error_msg, "ERROR")
|
||||||
|
self.stats['errors'].append(error_msg)
|
||||||
|
return None
|
||||||
|
|
||||||
|
def test_admin_get_users(self):
|
||||||
|
"""测试获取用户列表"""
|
||||||
|
self.log("开始测试获取用户列表...")
|
||||||
|
|
||||||
|
admin_token = self.test_data.get('admin_token')
|
||||||
|
if not admin_token:
|
||||||
|
admin_token = self.test_admin_login()
|
||||||
|
|
||||||
|
if not admin_token:
|
||||||
|
self.log("无管理员token，跳过用户列表测试", "ERROR")
|
||||||
|
return
|
||||||
|
|
||||||
|
response = self.make_request('GET', '/admin/users?limit=10&offset=0',
|
||||||
|
headers={'Authorization': f'Bearer {admin_token}'})
|
||||||
|
|
||||||
|
self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=True,
|
||||||
|
expected_fields=['data'],
|
||||||
|
test_name="获取用户列表"
|
||||||
|
)
|
||||||
|
|
||||||
|
def test_user_status_management(self):
|
||||||
|
"""测试用户状态管理"""
|
||||||
|
self.log("开始测试用户状态管理...")
|
||||||
|
|
||||||
|
admin_token = self.test_data.get('admin_token')
|
||||||
|
user_id = self.test_data.get('test_user_id')
|
||||||
|
|
||||||
|
if not admin_token:
|
||||||
|
admin_token = self.test_admin_login()
|
||||||
|
|
||||||
|
if not user_id:
|
||||||
|
user_id = self.test_user_register()
|
||||||
|
|
||||||
|
if not admin_token or not user_id:
|
||||||
|
self.log("缺少必要数据，跳过用户状态管理测试", "ERROR")
|
||||||
|
return
|
||||||
|
|
||||||
|
# 测试修改用户状态
|
||||||
|
response = self.make_request('PUT', f'/admin/users/{user_id}/status',
|
||||||
|
data={
|
||||||
|
'status': 'locked',
|
||||||
|
'reason': '测试锁定'
|
||||||
|
},
|
||||||
|
headers={'Authorization': f'Bearer {admin_token}'})
|
||||||
|
|
||||||
|
self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=True,
|
||||||
|
expected_fields=['data'],
|
||||||
|
test_name="修改用户状态"
|
||||||
|
)
|
||||||
|
|
||||||
|
# 测试用户状态统计
|
||||||
|
response = self.make_request('GET', '/admin/users/status-stats',
|
||||||
|
headers={'Authorization': f'Bearer {admin_token}'})
|
||||||
|
|
||||||
|
self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=True,
|
||||||
|
expected_fields=['data'],
|
||||||
|
test_name="用户状态统计"
|
||||||
|
)
|
||||||
|
|
||||||
|
def test_error_cases(self):
|
||||||
|
"""测试错误情况"""
|
||||||
|
self.log("开始测试错误情况...")
|
||||||
|
|
||||||
|
# 测试无效登录
|
||||||
|
response = self.make_request('POST', '/auth/login', {
|
||||||
|
'identifier': 'nonexistent',
|
||||||
|
'password': 'wrongpassword'
|
||||||
|
})
|
||||||
|
|
||||||
|
self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=False,
|
||||||
|
expected_fields=['error_code'],
|
||||||
|
test_name="无效用户登录"
|
||||||
|
)
|
||||||
|
|
||||||
|
# 测试无效验证码
|
||||||
|
response = self.make_request('POST', '/auth/verify-email', {
|
||||||
|
'email': self.test_email,
|
||||||
|
'verification_code': '000000'
|
||||||
|
})
|
||||||
|
|
||||||
|
self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=False,
|
||||||
|
test_name="无效验证码验证"
|
||||||
|
)
|
||||||
|
|
||||||
|
# 测试无权限访问管理员接口
|
||||||
|
response = self.make_request('GET', '/admin/users')
|
||||||
|
|
||||||
|
# 应该返回401或403
|
||||||
|
if response.get('status_code') in [401, 403]:
|
||||||
|
self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=False,
|
||||||
|
test_name="无权限访问管理员接口"
|
||||||
|
)
|
||||||
|
|
||||||
|
def test_rate_limiting(self):
|
||||||
|
"""测试频率限制"""
|
||||||
|
self.log("开始测试频率限制...")
|
||||||
|
|
||||||
|
# 快速连续发送验证码请求
|
||||||
|
for i in range(3):
|
||||||
|
response = self.make_request('POST', '/auth/send-email-verification', {
|
||||||
|
'email': f'ratelimit{i}@example.com'
|
||||||
|
})
|
||||||
|
|
||||||
|
if response.get('status_code') == 429:
|
||||||
|
self.assert_response(
|
||||||
|
response,
|
||||||
|
expected_success=False,
|
||||||
|
test_name="频率限制触发"
|
||||||
|
)
|
||||||
|
break
|
||||||
|
|
||||||
|
time.sleep(0.1) # 短暂延迟
|
||||||
|
|
||||||
|
def run_all_tests(self):
|
||||||
|
"""运行所有测试"""
|
||||||
|
self.log("🚀 开始API接口测试...")
|
||||||
|
self.log(f"测试目标: {self.base_url}")
|
||||||
|
self.log(f"测试邮箱: {self.test_email}")
|
||||||
|
|
||||||
|
start_time = time.time()
|
||||||
|
|
||||||
|
try:
|
||||||
|
# 基础功能测试
|
||||||
|
self.test_app_status()
|
||||||
|
|
||||||
|
# 认证相关测试
|
||||||
|
self.test_send_verification_code()
|
||||||
|
self.test_user_register()
|
||||||
|
self.test_user_login()
|
||||||
|
|
||||||
|
# 管理员功能测试
|
||||||
|
self.test_admin_login()
|
||||||
|
self.test_admin_get_users()
|
||||||
|
self.test_user_status_management()
|
||||||
|
|
||||||
|
# 错误处理测试
|
||||||
|
self.test_error_cases()
|
||||||
|
|
||||||
|
# 安全功能测试
|
||||||
|
self.test_rate_limiting()
|
||||||
|
|
||||||
|
except KeyboardInterrupt:
|
||||||
|
self.log("测试被用户中断", "ERROR")
|
||||||
|
except Exception as e:
|
||||||
|
self.log(f"测试过程中发生异常: {str(e)}", "ERROR")
|
||||||
|
|
||||||
|
# 输出测试结果
|
||||||
|
end_time = time.time()
|
||||||
|
duration = end_time - start_time
|
||||||
|
|
||||||
|
print("\n" + "="*60)
|
||||||
|
print("📊 测试结果统计")
|
||||||
|
print("="*60)
|
||||||
|
print(f"总测试数: {self.stats['total']}")
|
||||||
|
print(f"通过数量: {self.stats['passed']}")
|
||||||
|
print(f"失败数量: {self.stats['failed']}")
|
||||||
|
print(f"成功率: {(self.stats['passed']/self.stats['total']*100):.1f}%" if self.stats['total'] > 0 else "0%")
|
||||||
|
print(f"测试耗时: {duration:.2f}秒")
|
||||||
|
|
||||||
|
if self.stats['errors']:
|
||||||
|
print("\n❌ 失败的测试:")
|
||||||
|
for error in self.stats['errors']:
|
||||||
|
print(f" {error}")
|
||||||
|
|
||||||
|
if self.stats['failed'] == 0:
|
||||||
|
print("\n🎉 所有测试通过！")
|
||||||
|
return True
|
||||||
|
else:
|
||||||
|
print(f"\n⚠️ 有 {self.stats['failed']} 个测试失败")
|
||||||
|
return False
|
||||||
|
|
||||||
|
|
||||||
|
def main():
|
||||||
|
"""主函数"""
|
||||||
|
parser = argparse.ArgumentParser(description='whaleTown API接口测试工具')
|
||||||
|
parser.add_argument('--base-url', default='https://whaletownend.xinghangee.icu',
|
||||||
|
help='API服务器地址 (默认: https://whaletownend.xinghangee.icu)')
|
||||||
|
parser.add_argument('--test-email', default='test@example.com',
|
||||||
|
help='测试邮箱地址 (默认: test@example.com)')
|
||||||
|
parser.add_argument('--verbose', '-v', action='store_true',
|
||||||
|
help='显示详细日志')
|
||||||
|
|
||||||
|
args = parser.parse_args()
|
||||||
|
|
||||||
|
# 创建测试器并运行测试
|
||||||
|
tester = APITester(
|
||||||
|
base_url=args.base_url,
|
||||||
|
test_email=args.test_email,
|
||||||
|
verbose=args.verbose
|
||||||
|
)
|
||||||
|
|
||||||
|
success = tester.run_all_tests()
|
||||||
|
|
||||||
|
# 根据测试结果设置退出码
|
||||||
|
sys.exit(0 if success else 1)
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == '__main__':
|
||||||
|
main()
|
||||||
108
tests/api/simple_api_test.py
Normal file
108
tests/api/simple_api_test.py
Normal file
@@ -0,0 +1,108 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
"""
|
||||||
|
简化版API接口测试脚本
|
||||||
|
|
||||||
|
快速验证API接口的基本连通性和功能
|
||||||
|
"""
|
||||||
|
|
||||||
|
import requests
|
||||||
|
import json
|
||||||
|
import time
|
||||||
|
from datetime import datetime
|
||||||
|
|
||||||
|
|
||||||
|
class SimpleAPITester:
|
||||||
|
def __init__(self, base_url="https://whaletownend.xinghangee.icu"):
|
||||||
|
self.base_url = base_url.rstrip('/')
|
||||||
|
self.session = requests.Session()
|
||||||
|
self.session.headers.update({
|
||||||
|
'Content-Type': 'application/json',
|
||||||
|
'User-Agent': 'whaleTown-Simple-Tester/1.0'
|
||||||
|
})
|
||||||
|
|
||||||
|
def log(self, message):
|
||||||
|
timestamp = datetime.now().strftime("%H:%M:%S")
|
||||||
|
print(f"[{timestamp}] {message}")
|
||||||
|
|
||||||
|
def test_endpoint(self, method, endpoint, data=None, description=""):
|
||||||
|
"""测试单个端点"""
|
||||||
|
url = f"{self.base_url}{endpoint}"
|
||||||
|
|
||||||
|
try:
|
||||||
|
if method.upper() == 'GET':
|
||||||
|
response = self.session.get(url, timeout=10)
|
||||||
|
elif method.upper() == 'POST':
|
||||||
|
response = self.session.post(url, json=data, timeout=10)
|
||||||
|
|
||||||
|
self.log(f"✅ {description}")
|
||||||
|
self.log(f" 状态码: {response.status_code}")
|
||||||
|
|
||||||
|
try:
|
||||||
|
result = response.json()
|
||||||
|
self.log(f" 响应: {json.dumps(result, ensure_ascii=False, indent=2)[:200]}...")
|
||||||
|
return result
|
||||||
|
except:
|
||||||
|
self.log(f" 响应: {response.text[:100]}...")
|
||||||
|
return {"status_code": response.status_code, "text": response.text}
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
self.log(f"❌ {description} - 错误: {str(e)}")
|
||||||
|
return None
|
||||||
|
|
||||||
|
def run_basic_tests(self):
|
||||||
|
"""运行基础测试"""
|
||||||
|
self.log("🚀 开始基础API测试...")
|
||||||
|
self.log(f"测试目标: {self.base_url}")
|
||||||
|
|
||||||
|
# 1. 测试应用状态
|
||||||
|
self.test_endpoint('GET', '/', description="应用状态检查")
|
||||||
|
|
||||||
|
# 2. 测试发送验证码
|
||||||
|
result = self.test_endpoint('POST', '/auth/send-email-verification',
|
||||||
|
{'email': 'test@example.com'},
|
||||||
|
"发送邮箱验证码")
|
||||||
|
|
||||||
|
# 3. 如果获取到验证码，测试注册
|
||||||
|
if result and 'data' in result and 'verification_code' in result['data']:
|
||||||
|
verification_code = result['data']['verification_code']
|
||||||
|
self.log(f"📧 获取到验证码: {verification_code}")
|
||||||
|
|
||||||
|
# 测试用户注册（需要验证码）
|
||||||
|
username = f"testuser_{int(time.time())}"
|
||||||
|
self.test_endpoint('POST', '/auth/register', {
|
||||||
|
'username': username,
|
||||||
|
'password': 'Test123456',
|
||||||
|
'nickname': '测试用户',
|
||||||
|
'email': 'test@example.com',
|
||||||
|
'email_verification_code': verification_code # 添加验证码
|
||||||
|
}, "用户注册")
|
||||||
|
|
||||||
|
# 测试用户登录
|
||||||
|
self.test_endpoint('POST', '/auth/login', {
|
||||||
|
'identifier': username,
|
||||||
|
'password': 'Test123456'
|
||||||
|
}, "用户登录")
|
||||||
|
|
||||||
|
# 4. 测试错误情况
|
||||||
|
self.test_endpoint('POST', '/auth/login', {
|
||||||
|
'identifier': 'nonexistent',
|
||||||
|
'password': 'wrongpassword'
|
||||||
|
}, "无效登录测试")
|
||||||
|
|
||||||
|
# 5. 测试管理员登录（可能失败）
|
||||||
|
self.test_endpoint('POST', '/admin/auth/login', {
|
||||||
|
'identifier': 'admin',
|
||||||
|
'password': 'Admin123456'
|
||||||
|
}, "管理员登录测试")
|
||||||
|
|
||||||
|
self.log("🎯 基础测试完成！")
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == '__main__':
|
||||||
|
import sys
|
||||||
|
|
||||||
|
base_url = sys.argv[1] if len(sys.argv) > 1 else "https://whaletownend.xinghangee.icu"
|
||||||
|
|
||||||
|
tester = SimpleAPITester(base_url)
|
||||||
|
tester.run_basic_tests()
|
||||||
165
tests/auth/README.md
Normal file
165
tests/auth/README.md
Normal file
@@ -0,0 +1,165 @@
|
|||||||
|
# 认证UI测试
|
||||||
|
|
||||||
|
这个文件夹包含了登录和注册界面的UI响应测试，具有美观优雅的反馈系统。
|
||||||
|
|
||||||
|
## 文件说明
|
||||||
|
|
||||||
|
- `auth_ui_test.tscn` - 测试场景文件
|
||||||
|
- `auth_ui_test.gd` - 测试脚本
|
||||||
|
- `README.md` - 本说明文件
|
||||||
|
|
||||||
|
## 如何运行测试
|
||||||
|
|
||||||
|
### 方法1：在Godot编辑器中运行
|
||||||
|
1. 在Godot编辑器中打开 `tests/auth/auth_ui_test.tscn` 文件
|
||||||
|
2. 点击编辑器右上角的"播放场景"按钮（或按F6键）
|
||||||
|
3. 如果仍然跳转到主场景，请尝试以下步骤：
|
||||||
|
- 确保当前打开的是测试场景文件
|
||||||
|
- 在场景面板中右键点击根节点，选择"Change Scene"
|
||||||
|
- 或者在项目设置中临时更改主场景为测试场景
|
||||||
|
|
||||||
|
### 方法2：通过代码运行
|
||||||
|
在任何脚本中添加以下代码来切换到测试场景：
|
||||||
|
```gdscript
|
||||||
|
get_tree().change_scene_to_file("res://tests/auth/auth_ui_test.tscn")
|
||||||
|
```
|
||||||
|
|
||||||
|
## 界面布局
|
||||||
|
|
||||||
|
### 左侧：认证界面
|
||||||
|
- 完整的登录和注册界面
|
||||||
|
- 实时表单验证
|
||||||
|
- Toast消息显示
|
||||||
|
- 字段错误提示
|
||||||
|
|
||||||
|
### 右侧：测试控制面板
|
||||||
|
#### 🧪 UI响应测试标题
|
||||||
|
#### 📋 测试反馈面板
|
||||||
|
- **智能反馈系统**：实时显示测试执行状态
|
||||||
|
- **颜色编码**：
|
||||||
|
- 🔵 蓝色：信息提示
|
||||||
|
- 🟢 绿色：成功响应
|
||||||
|
- 🔴 红色：错误响应
|
||||||
|
- **详细信息**：
|
||||||
|
- 测试名称和类型
|
||||||
|
- HTTP状态码
|
||||||
|
- 响应消息和错误代码
|
||||||
|
- 预期的UI反馈效果
|
||||||
|
- **自动滚动**：新消息自动滚动到可见区域
|
||||||
|
|
||||||
|
#### 🎯 测试用例按钮
|
||||||
|
16个精美设计的测试按钮，按功能分组：
|
||||||
|
|
||||||
|
## 测试功能
|
||||||
|
|
||||||
|
### 登录测试（4个）
|
||||||
|
- ✅ **登录成功**（状态码200）
|
||||||
|
- 预期：绿色Toast "登录成功！正在进入鲸鱼镇..."，跳转到主场景
|
||||||
|
- ❌ **用户名或密码错误**（状态码401）
|
||||||
|
- 预期：红色Toast "用户名或密码错误，请检查后重试"
|
||||||
|
- ❌ **用户不存在**（状态码404）
|
||||||
|
- 预期：红色Toast "用户不存在，请先注册"
|
||||||
|
- ❌ **参数错误**（状态码400）
|
||||||
|
- 预期：红色Toast，根据具体错误显示
|
||||||
|
|
||||||
|
### 发送验证码测试（5个）
|
||||||
|
- ✅ **发送成功**（状态码200）
|
||||||
|
- 预期：绿色Toast "验证码已发送到您的邮箱"
|
||||||
|
- ❌ **邮箱格式错误**（状态码400）
|
||||||
|
- 预期：红色Toast "请输入有效的邮箱地址"
|
||||||
|
- ❌ **请求过频**（状态码429）
|
||||||
|
- 预期：红色Toast "请求过于频繁，请稍后再试"
|
||||||
|
- ❌ **服务器错误**（状态码500）
|
||||||
|
- 预期：红色Toast "服务器繁忙，请稍后再试"
|
||||||
|
- ❌ **网络错误**（状态码0）
|
||||||
|
- 预期：红色Toast "网络连接失败，请检查网络连接"
|
||||||
|
|
||||||
|
### 邮箱验证测试（3个）
|
||||||
|
- ✅ **验证成功**（状态码200）
|
||||||
|
- 预期：绿色Toast "邮箱验证成功，正在注册..."
|
||||||
|
- ❌ **验证码错误**（状态码400）
|
||||||
|
- 预期：红色Toast "验证码错误或已过期"
|
||||||
|
- ❌ **验证码不存在**（状态码404）
|
||||||
|
- 预期：红色Toast "请先获取验证码"
|
||||||
|
|
||||||
|
### 注册测试（6个）
|
||||||
|
- ✅ **注册成功**（状态码201）
|
||||||
|
- 预期：绿色Toast "注册成功！欢迎加入鲸鱼镇"，切换到登录界面
|
||||||
|
- ❌ **参数错误**（状态码400）
|
||||||
|
- 预期：红色Toast，根据具体错误显示
|
||||||
|
- ❌ **缺少验证码**（状态码400）
|
||||||
|
- 预期：红色Toast "请先获取并输入邮箱验证码"
|
||||||
|
- ❌ **用户已存在**（状态码409）
|
||||||
|
- 预期：红色Toast "用户名或邮箱已被使用，请换一个"
|
||||||
|
- ❌ **请求过频**（状态码429）
|
||||||
|
- 预期：红色Toast "注册请求过于频繁，请稍后再试"
|
||||||
|
- ❌ **服务器错误**（状态码500）
|
||||||
|
- 预期：红色Toast "注册失败，请稍后再试"
|
||||||
|
|
||||||
|
## 测试步骤
|
||||||
|
|
||||||
|
1. **启动测试场景**
|
||||||
|
- 运行测试场景后，右侧反馈面板会显示欢迎信息和使用说明
|
||||||
|
|
||||||
|
2. **准备测试数据**
|
||||||
|
- 在左侧认证界面切换到注册界面
|
||||||
|
- 填写测试数据：
|
||||||
|
- 用户名：testuser
|
||||||
|
- 邮箱：test@example.com
|
||||||
|
- 密码：password123
|
||||||
|
- 确认密码：password123
|
||||||
|
- 验证码：123456
|
||||||
|
|
||||||
|
3. **执行测试**
|
||||||
|
- 点击右侧对应的测试按钮
|
||||||
|
- 观察反馈面板中的详细信息：
|
||||||
|
- 🚀 测试开始提示
|
||||||
|
- 📡 请求类型和状态码
|
||||||
|
- ⚡ HTTP响应模拟
|
||||||
|
- 🎯 预期UI反馈说明
|
||||||
|
- ✅/❌ 测试完成状态
|
||||||
|
|
||||||
|
4. **观察UI反馈**
|
||||||
|
- 左侧界面的实际反馈效果
|
||||||
|
- Toast消息的颜色和内容
|
||||||
|
- 字段错误提示的显示
|
||||||
|
- 按钮状态的变化
|
||||||
|
|
||||||
|
## 反馈系统特色
|
||||||
|
|
||||||
|
### 🎨 美观设计
|
||||||
|
- 使用Emoji图标增强视觉效果
|
||||||
|
- 颜色编码区分不同状态
|
||||||
|
- 圆角边框和阴影效果
|
||||||
|
- 按钮分组和分隔符
|
||||||
|
|
||||||
|
### 📊 详细分析
|
||||||
|
- 实时显示测试执行过程
|
||||||
|
- 预期vs实际效果对比
|
||||||
|
- HTTP响应详细解析
|
||||||
|
- 错误代码和消息说明
|
||||||
|
|
||||||
|
### 🔄 交互体验
|
||||||
|
- 自动滚动到最新消息
|
||||||
|
- 按钮悬停效果
|
||||||
|
- 平滑的颜色过渡
|
||||||
|
- 响应式布局
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
- 测试场景会自动断开`login_success`信号，避免跳转到主场景
|
||||||
|
- 按ESC键可以优雅退出测试（显示退出提示）
|
||||||
|
- 所有测试都是模拟的，不会发送真实的网络请求
|
||||||
|
- 反馈面板会保留测试历史，便于对比分析
|
||||||
|
- 测试按钮按功能分组，每组之间有分隔符
|
||||||
|
|
||||||
|
## 预期行为验证
|
||||||
|
|
||||||
|
这个测试系统不仅模拟后端响应，还会告诉你每种情况下应该看到什么UI反馈，帮助你验证：
|
||||||
|
|
||||||
|
1. **Toast消息系统**是否正常工作
|
||||||
|
2. **字段验证错误**是否正确显示
|
||||||
|
3. **按钮状态管理**是否符合预期
|
||||||
|
4. **用户体验流程**是否顺畅
|
||||||
|
|
||||||
|
通过对比预期效果和实际效果，可以快速发现UI反馈系统中的问题并进行修复。
|
||||||
464
tests/auth/auth_ui_test.gd
Normal file
464
tests/auth/auth_ui_test.gd
Normal file
@@ -0,0 +1,464 @@
|
|||||||
|
extends Control
|
||||||
|
|
||||||
|
# 认证UI测试场景
|
||||||
|
# 用于测试登录和注册界面的各种响应情况
|
||||||
|
|
||||||
|
@onready var auth_scene: Control = $AuthScene
|
||||||
|
@onready var test_panel: Panel = $TestPanel
|
||||||
|
@onready var test_buttons: VBoxContainer = $TestPanel/VBoxContainer/ScrollContainer/TestButtons
|
||||||
|
@onready var feedback_panel: Panel = $TestPanel/VBoxContainer/FeedbackPanel
|
||||||
|
@onready var feedback_text: RichTextLabel = $TestPanel/VBoxContainer/FeedbackPanel/FeedbackContainer/FeedbackScroll/FeedbackText
|
||||||
|
|
||||||
|
# 反馈样式 - 动态创建
|
||||||
|
var feedback_styles = {}
|
||||||
|
|
||||||
|
var test_scenarios = [
|
||||||
|
{
|
||||||
|
"name": "✅ 登录成功",
|
||||||
|
"type": "login",
|
||||||
|
"response_code": 200,
|
||||||
|
"response_data": {
|
||||||
|
"success": true,
|
||||||
|
"data": {
|
||||||
|
"user": {
|
||||||
|
"id": "123",
|
||||||
|
"username": "testuser",
|
||||||
|
"email": "test@example.com"
|
||||||
|
},
|
||||||
|
"token": "jwt_token_here"
|
||||||
|
},
|
||||||
|
"message": "登录成功"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 登录失败-用户名或密码错误",
|
||||||
|
"type": "login",
|
||||||
|
"response_code": 401,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "用户名或密码错误",
|
||||||
|
"error_code": "INVALID_CREDENTIALS"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 登录失败-用户不存在",
|
||||||
|
"type": "login",
|
||||||
|
"response_code": 404,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "用户不存在",
|
||||||
|
"error_code": "USER_NOT_FOUND"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 登录失败-参数错误",
|
||||||
|
"type": "login",
|
||||||
|
"response_code": 400,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "用户名格式错误",
|
||||||
|
"error_code": "INVALID_PARAMETERS"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "✅ 发送验证码成功",
|
||||||
|
"type": "send_code",
|
||||||
|
"response_code": 200,
|
||||||
|
"response_data": {
|
||||||
|
"success": true,
|
||||||
|
"data": {"verification_code": "123456"},
|
||||||
|
"message": "验证码已发送"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 发送验证码-邮箱格式错误",
|
||||||
|
"type": "send_code",
|
||||||
|
"response_code": 400,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "邮箱格式错误",
|
||||||
|
"error_code": "INVALID_EMAIL"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 发送验证码-请求过频",
|
||||||
|
"type": "send_code",
|
||||||
|
"response_code": 429,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "请求过于频繁",
|
||||||
|
"error_code": "TOO_MANY_REQUESTS"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 发送验证码-服务器错误",
|
||||||
|
"type": "send_code",
|
||||||
|
"response_code": 500,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "服务器内部错误",
|
||||||
|
"error_code": "INTERNAL_ERROR"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 发送验证码-网络错误",
|
||||||
|
"type": "send_code",
|
||||||
|
"response_code": 0,
|
||||||
|
"response_data": {}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "✅ 邮箱验证成功",
|
||||||
|
"type": "verify_email",
|
||||||
|
"response_code": 200,
|
||||||
|
"response_data": {
|
||||||
|
"success": true,
|
||||||
|
"message": "邮箱验证成功"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 邮箱验证-验证码错误",
|
||||||
|
"type": "verify_email",
|
||||||
|
"response_code": 400,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "验证码错误或已过期",
|
||||||
|
"error_code": "INVALID_CODE"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 邮箱验证-验证码不存在",
|
||||||
|
"type": "verify_email",
|
||||||
|
"response_code": 404,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "验证码不存在",
|
||||||
|
"error_code": "CODE_NOT_FOUND"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "✅ 注册成功",
|
||||||
|
"type": "register",
|
||||||
|
"response_code": 201,
|
||||||
|
"response_data": {
|
||||||
|
"success": true,
|
||||||
|
"data": {
|
||||||
|
"user": {
|
||||||
|
"id": "123",
|
||||||
|
"username": "testuser",
|
||||||
|
"email": "test@example.com"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"message": "注册成功"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 注册失败-参数错误",
|
||||||
|
"type": "register",
|
||||||
|
"response_code": 400,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "用户名格式错误",
|
||||||
|
"error_code": "INVALID_USERNAME"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 注册失败-缺少验证码",
|
||||||
|
"type": "register",
|
||||||
|
"response_code": 400,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "提供邮箱时必须提供邮箱验证码",
|
||||||
|
"error_code": "REGISTER_FAILED"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 注册失败-用户已存在",
|
||||||
|
"type": "register",
|
||||||
|
"response_code": 409,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "用户名已存在",
|
||||||
|
"error_code": "USER_EXISTS"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 注册失败-请求过频",
|
||||||
|
"type": "register",
|
||||||
|
"response_code": 429,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "注册请求过于频繁，请5分钟后再试",
|
||||||
|
"error_code": "TOO_MANY_REQUESTS",
|
||||||
|
"throttle_info": {
|
||||||
|
"limit": 3,
|
||||||
|
"window_seconds": 300,
|
||||||
|
"current_requests": 3,
|
||||||
|
"reset_time": "2025-12-24T11:26:41.136Z"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "❌ 注册失败-服务器错误",
|
||||||
|
"type": "register",
|
||||||
|
"response_code": 500,
|
||||||
|
"response_data": {
|
||||||
|
"success": false,
|
||||||
|
"message": "服务器内部错误",
|
||||||
|
"error_code": "INTERNAL_ERROR"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
|
||||||
|
func _ready():
|
||||||
|
print("🧪 认证UI测试场景已加载")
|
||||||
|
|
||||||
|
# 初始化反馈样式
|
||||||
|
create_feedback_styles()
|
||||||
|
|
||||||
|
# 初始化反馈面板
|
||||||
|
show_feedback("🎯 测试场景已准备就绪", "info")
|
||||||
|
add_feedback_line("💡 使用说明：")
|
||||||
|
add_feedback_line("1️⃣ 点击下方测试按钮模拟后端响应")
|
||||||
|
add_feedback_line("2️⃣ 观察左侧认证界面的UI反馈")
|
||||||
|
add_feedback_line("3️⃣ 按ESC键退出测试")
|
||||||
|
add_feedback_line("")
|
||||||
|
|
||||||
|
# 确保auth_scene已准备好
|
||||||
|
if auth_scene == null:
|
||||||
|
show_feedback("❌ 错误：无法找到AuthScene节点", "error")
|
||||||
|
return
|
||||||
|
|
||||||
|
# 等待一帧确保所有节点都已初始化
|
||||||
|
await get_tree().process_frame
|
||||||
|
setup_test_buttons()
|
||||||
|
|
||||||
|
# 断开auth_scene的login_success信号，避免跳转到主场景
|
||||||
|
if auth_scene.has_signal("login_success"):
|
||||||
|
var connections = auth_scene.get_signal_connection_list("login_success")
|
||||||
|
for connection in connections:
|
||||||
|
auth_scene.disconnect("login_success", connection.callable)
|
||||||
|
add_feedback_line("🔗 已断开login_success信号连接")
|
||||||
|
|
||||||
|
# 创建反馈样式
|
||||||
|
func create_feedback_styles():
|
||||||
|
# 成功样式 - 绿色
|
||||||
|
var success_style = StyleBoxFlat.new()
|
||||||
|
success_style.bg_color = Color(0.2, 0.8, 0.3, 0.9)
|
||||||
|
success_style.border_color = Color(0.1, 0.6, 0.2, 1)
|
||||||
|
success_style.border_width_left = 2
|
||||||
|
success_style.border_width_top = 2
|
||||||
|
success_style.border_width_right = 2
|
||||||
|
success_style.border_width_bottom = 2
|
||||||
|
success_style.corner_radius_top_left = 8
|
||||||
|
success_style.corner_radius_top_right = 8
|
||||||
|
success_style.corner_radius_bottom_left = 8
|
||||||
|
success_style.corner_radius_bottom_right = 8
|
||||||
|
|
||||||
|
# 错误样式 - 红色
|
||||||
|
var error_style = StyleBoxFlat.new()
|
||||||
|
error_style.bg_color = Color(0.8, 0.2, 0.2, 0.9)
|
||||||
|
error_style.border_color = Color(0.6, 0.1, 0.1, 1)
|
||||||
|
error_style.border_width_left = 2
|
||||||
|
error_style.border_width_top = 2
|
||||||
|
error_style.border_width_right = 2
|
||||||
|
error_style.border_width_bottom = 2
|
||||||
|
error_style.corner_radius_top_left = 8
|
||||||
|
error_style.corner_radius_top_right = 8
|
||||||
|
error_style.corner_radius_bottom_left = 8
|
||||||
|
error_style.corner_radius_bottom_right = 8
|
||||||
|
|
||||||
|
# 信息样式 - 蓝色
|
||||||
|
var info_style = StyleBoxFlat.new()
|
||||||
|
info_style.bg_color = Color(0.2, 0.5, 0.8, 0.9)
|
||||||
|
info_style.border_color = Color(0.1, 0.4, 0.6, 1)
|
||||||
|
info_style.border_width_left = 2
|
||||||
|
info_style.border_width_top = 2
|
||||||
|
info_style.border_width_right = 2
|
||||||
|
info_style.border_width_bottom = 2
|
||||||
|
info_style.corner_radius_top_left = 8
|
||||||
|
info_style.corner_radius_top_right = 8
|
||||||
|
info_style.corner_radius_bottom_left = 8
|
||||||
|
info_style.corner_radius_bottom_right = 8
|
||||||
|
|
||||||
|
feedback_styles = {
|
||||||
|
"success": success_style,
|
||||||
|
"error": error_style,
|
||||||
|
"info": info_style
|
||||||
|
}
|
||||||
|
|
||||||
|
func setup_test_buttons():
|
||||||
|
# 创建测试按钮
|
||||||
|
for i in range(test_scenarios.size()):
|
||||||
|
var scenario = test_scenarios[i]
|
||||||
|
var button = Button.new()
|
||||||
|
button.text = scenario.name
|
||||||
|
button.custom_minimum_size.y = 35
|
||||||
|
button.pressed.connect(_on_test_button_pressed.bind(scenario))
|
||||||
|
|
||||||
|
# 为按钮添加样式
|
||||||
|
var style_normal = StyleBoxFlat.new()
|
||||||
|
style_normal.bg_color = Color(0.9, 0.9, 0.9, 1)
|
||||||
|
style_normal.border_color = Color(0.7, 0.7, 0.7, 1)
|
||||||
|
style_normal.border_width_left = 1
|
||||||
|
style_normal.border_width_top = 1
|
||||||
|
style_normal.border_width_right = 1
|
||||||
|
style_normal.border_width_bottom = 1
|
||||||
|
style_normal.corner_radius_top_left = 4
|
||||||
|
style_normal.corner_radius_top_right = 4
|
||||||
|
style_normal.corner_radius_bottom_left = 4
|
||||||
|
style_normal.corner_radius_bottom_right = 4
|
||||||
|
|
||||||
|
var style_hover = style_normal.duplicate()
|
||||||
|
style_hover.bg_color = Color(0.8, 0.8, 0.8, 1)
|
||||||
|
|
||||||
|
button.add_theme_stylebox_override("normal", style_normal)
|
||||||
|
button.add_theme_stylebox_override("hover", style_hover)
|
||||||
|
button.add_theme_color_override("font_color", Color(0.2, 0.2, 0.2, 1))
|
||||||
|
|
||||||
|
test_buttons.add_child(button)
|
||||||
|
|
||||||
|
# 添加分隔符（每4个按钮一组）
|
||||||
|
if (i + 1) % 4 == 0 and i < test_scenarios.size() - 1:
|
||||||
|
var separator = HSeparator.new()
|
||||||
|
separator.custom_minimum_size.y = 10
|
||||||
|
test_buttons.add_child(separator)
|
||||||
|
|
||||||
|
add_feedback_line("✨ 已创建 %d 个测试按钮" % test_scenarios.size())
|
||||||
|
|
||||||
|
func _on_test_button_pressed(scenario: Dictionary):
|
||||||
|
# 显示测试开始信息
|
||||||
|
show_feedback("🚀 执行测试: %s" % scenario.name, "info")
|
||||||
|
add_feedback_line("📡 请求类型: %s" % scenario.type)
|
||||||
|
add_feedback_line("📊 状态码: %d" % scenario.response_code)
|
||||||
|
|
||||||
|
# 确保auth_scene存在
|
||||||
|
if auth_scene == null:
|
||||||
|
show_feedback("❌ 错误：AuthScene节点不存在", "error")
|
||||||
|
return
|
||||||
|
|
||||||
|
# 模拟HTTP响应
|
||||||
|
simulate_http_response(scenario)
|
||||||
|
|
||||||
|
func simulate_http_response(scenario: Dictionary):
|
||||||
|
# 设置当前请求类型
|
||||||
|
auth_scene.current_request_type = scenario.type
|
||||||
|
|
||||||
|
# 准备模拟数据
|
||||||
|
var response_code = scenario.response_code
|
||||||
|
var response_data = scenario.response_data
|
||||||
|
var response_text = JSON.stringify(response_data)
|
||||||
|
var response_body = response_text.to_utf8_buffer()
|
||||||
|
var headers = PackedStringArray()
|
||||||
|
|
||||||
|
add_feedback_line("⚡ 模拟HTTP响应...")
|
||||||
|
|
||||||
|
# 模拟HTTP请求完成
|
||||||
|
auth_scene._on_http_request_completed(0, response_code, headers, response_body)
|
||||||
|
|
||||||
|
# 分析响应结果
|
||||||
|
analyze_response(scenario, response_data)
|
||||||
|
|
||||||
|
func analyze_response(scenario: Dictionary, response_data: Dictionary):
|
||||||
|
var response_code = scenario.response_code
|
||||||
|
var is_success = response_code >= 200 and response_code < 300
|
||||||
|
|
||||||
|
# 显示响应分析
|
||||||
|
if is_success:
|
||||||
|
show_feedback("✅ 测试完成 - 成功响应", "success")
|
||||||
|
else:
|
||||||
|
show_feedback("❌ 测试完成 - 错误响应", "error")
|
||||||
|
|
||||||
|
# 显示详细信息
|
||||||
|
if response_data.has("message"):
|
||||||
|
add_feedback_line("💬 响应消息: %s" % response_data.message)
|
||||||
|
|
||||||
|
if response_data.has("error_code"):
|
||||||
|
add_feedback_line("🏷️ 错误代码: %s" % response_data.error_code)
|
||||||
|
|
||||||
|
if response_data.has("data"):
|
||||||
|
add_feedback_line("📦 响应数据: %s" % str(response_data.data))
|
||||||
|
|
||||||
|
# 预期的UI反馈
|
||||||
|
var expected_feedback = get_expected_ui_feedback(scenario)
|
||||||
|
add_feedback_line("🎯 预期UI反馈: %s" % expected_feedback)
|
||||||
|
|
||||||
|
add_feedback_line("─────────────────────")
|
||||||
|
|
||||||
|
func get_expected_ui_feedback(scenario: Dictionary) -> String:
|
||||||
|
var response_code = scenario.response_code
|
||||||
|
var type = scenario.type
|
||||||
|
|
||||||
|
match type:
|
||||||
|
"login":
|
||||||
|
match response_code:
|
||||||
|
200:
|
||||||
|
return "绿色Toast: 登录成功，跳转到主场景"
|
||||||
|
400:
|
||||||
|
return "红色Toast: 登录信息格式错误"
|
||||||
|
401:
|
||||||
|
return "红色Toast: 用户名或密码错误"
|
||||||
|
404:
|
||||||
|
return "红色Toast: 用户不存在"
|
||||||
|
429:
|
||||||
|
return "红色Toast: 登录请求过于频繁"
|
||||||
|
500:
|
||||||
|
return "红色Toast: 服务器繁忙"
|
||||||
|
"send_code":
|
||||||
|
match response_code:
|
||||||
|
200, 206:
|
||||||
|
return "绿色Toast: 验证码已发送"
|
||||||
|
400:
|
||||||
|
return "红色Toast: 邮箱格式错误"
|
||||||
|
429:
|
||||||
|
return "红色Toast: 请求过于频繁"
|
||||||
|
500:
|
||||||
|
return "红色Toast: 服务器繁忙"
|
||||||
|
0:
|
||||||
|
return "红色Toast: 网络连接失败"
|
||||||
|
"verify_email":
|
||||||
|
match response_code:
|
||||||
|
200:
|
||||||
|
return "绿色Toast: 邮箱验证成功"
|
||||||
|
400:
|
||||||
|
return "红色Toast: 验证码错误"
|
||||||
|
404:
|
||||||
|
return "红色Toast: 请先获取验证码"
|
||||||
|
500:
|
||||||
|
return "红色Toast: 验证失败"
|
||||||
|
"register":
|
||||||
|
match response_code:
|
||||||
|
201:
|
||||||
|
return "绿色Toast: 注册成功，切换到登录界面"
|
||||||
|
400:
|
||||||
|
return "红色Toast: 根据具体错误显示（验证码缺失、格式错误等）"
|
||||||
|
409:
|
||||||
|
return "红色Toast: 用户名或邮箱已存在"
|
||||||
|
429:
|
||||||
|
return "红色Toast: 注册请求过于频繁，请稍后再试"
|
||||||
|
500:
|
||||||
|
return "红色Toast: 注册失败"
|
||||||
|
|
||||||
|
return "未知响应"
|
||||||
|
|
||||||
|
# 反馈面板功能
|
||||||
|
func show_feedback(message: String, type: String = "info"):
|
||||||
|
# 更改面板样式
|
||||||
|
if feedback_styles.has(type):
|
||||||
|
feedback_panel.add_theme_stylebox_override("panel", feedback_styles[type])
|
||||||
|
|
||||||
|
# 清空并显示新消息
|
||||||
|
feedback_text.text = "[b]%s[/b]" % message
|
||||||
|
|
||||||
|
func add_feedback_line(message: String):
|
||||||
|
feedback_text.text += "\n" + message
|
||||||
|
# 自动滚动到底部
|
||||||
|
await get_tree().process_frame
|
||||||
|
var scroll = feedback_text.get_parent()
|
||||||
|
if scroll is ScrollContainer:
|
||||||
|
scroll.scroll_vertical = scroll.get_v_scroll_bar().max_value
|
||||||
|
|
||||||
|
func _input(event):
|
||||||
|
if event.is_action_pressed("ui_cancel"):
|
||||||
|
show_feedback("👋 退出测试场景", "info")
|
||||||
|
await get_tree().create_timer(0.5).timeout
|
||||||
|
get_tree().quit()
|
||||||
1
tests/auth/auth_ui_test.gd.uid
Normal file
1
tests/auth/auth_ui_test.gd.uid
Normal file
@@ -0,0 +1 @@
|
|||||||
|
uid://ddb8v5c6aeqe7
|
||||||
117
tests/auth/auth_ui_test.tscn
Normal file
117
tests/auth/auth_ui_test.tscn
Normal file
@@ -0,0 +1,117 @@
|
|||||||
|
[gd_scene load_steps=4 format=3 uid="uid://bvn8y7x2qkqxe"]
|
||||||
|
|
||||||
|
[ext_resource type="Script" uid="uid://ddb8v5c6aeqe7" path="res://tests/auth/auth_ui_test.gd" id="1_test_script"]
|
||||||
|
[ext_resource type="PackedScene" uid="uid://by7m8snb4xllf" path="res://scenes/auth_scene.tscn" id="2_auth_scene"]
|
||||||
|
|
||||||
|
[sub_resource type="StyleBoxFlat" id="StyleBoxFlat_feedback_info"]
|
||||||
|
bg_color = Color(0.2, 0.5, 0.8, 0.9)
|
||||||
|
border_width_left = 2
|
||||||
|
border_width_top = 2
|
||||||
|
border_width_right = 2
|
||||||
|
border_width_bottom = 2
|
||||||
|
border_color = Color(0.1, 0.4, 0.6, 1)
|
||||||
|
corner_radius_top_left = 8
|
||||||
|
corner_radius_top_right = 8
|
||||||
|
corner_radius_bottom_right = 8
|
||||||
|
corner_radius_bottom_left = 8
|
||||||
|
|
||||||
|
[node name="AuthUITest" type="Control"]
|
||||||
|
layout_mode = 3
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
script = ExtResource("1_test_script")
|
||||||
|
|
||||||
|
[node name="AuthScene" parent="." instance=ExtResource("2_auth_scene")]
|
||||||
|
layout_mode = 1
|
||||||
|
|
||||||
|
[node name="TestPanel" type="Panel" parent="."]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 1
|
||||||
|
anchor_left = 1.0
|
||||||
|
anchor_right = 1.0
|
||||||
|
offset_left = -350.0
|
||||||
|
offset_top = 20.0
|
||||||
|
offset_right = -20.0
|
||||||
|
offset_bottom = 620.0
|
||||||
|
grow_horizontal = 0
|
||||||
|
|
||||||
|
[node name="VBoxContainer" type="VBoxContainer" parent="TestPanel"]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
offset_left = 10.0
|
||||||
|
offset_top = 10.0
|
||||||
|
offset_right = -10.0
|
||||||
|
offset_bottom = -10.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
|
||||||
|
[node name="TitleLabel" type="Label" parent="TestPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0.2, 0.2, 0.2, 1)
|
||||||
|
theme_override_font_sizes/font_size = 18
|
||||||
|
text = "🧪 UI响应测试"
|
||||||
|
horizontal_alignment = 1
|
||||||
|
|
||||||
|
[node name="HSeparator" type="HSeparator" parent="TestPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="FeedbackPanel" type="Panel" parent="TestPanel/VBoxContainer"]
|
||||||
|
custom_minimum_size = Vector2(0, 120)
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_styles/panel = SubResource("StyleBoxFlat_feedback_info")
|
||||||
|
|
||||||
|
[node name="FeedbackContainer" type="VBoxContainer" parent="TestPanel/VBoxContainer/FeedbackPanel"]
|
||||||
|
layout_mode = 1
|
||||||
|
anchors_preset = 15
|
||||||
|
anchor_right = 1.0
|
||||||
|
anchor_bottom = 1.0
|
||||||
|
offset_left = 10.0
|
||||||
|
offset_top = 8.0
|
||||||
|
offset_right = -10.0
|
||||||
|
offset_bottom = -8.0
|
||||||
|
grow_horizontal = 2
|
||||||
|
grow_vertical = 2
|
||||||
|
|
||||||
|
[node name="FeedbackTitle" type="Label" parent="TestPanel/VBoxContainer/FeedbackPanel/FeedbackContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(1, 1, 1, 1)
|
||||||
|
theme_override_font_sizes/font_size = 14
|
||||||
|
text = "📋 测试反馈"
|
||||||
|
|
||||||
|
[node name="FeedbackScroll" type="ScrollContainer" parent="TestPanel/VBoxContainer/FeedbackPanel/FeedbackContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_vertical = 3
|
||||||
|
|
||||||
|
[node name="FeedbackText" type="RichTextLabel" parent="TestPanel/VBoxContainer/FeedbackPanel/FeedbackContainer/FeedbackScroll"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
|
size_flags_vertical = 3
|
||||||
|
theme_override_colors/default_color = Color(1, 1, 1, 1)
|
||||||
|
theme_override_font_sizes/normal_font_size = 12
|
||||||
|
bbcode_enabled = true
|
||||||
|
text = "点击下方测试按钮开始测试..."
|
||||||
|
fit_content = true
|
||||||
|
scroll_following = true
|
||||||
|
|
||||||
|
[node name="HSeparator2" type="HSeparator" parent="TestPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
|
||||||
|
[node name="ButtonsLabel" type="Label" parent="TestPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
theme_override_colors/font_color = Color(0.2, 0.2, 0.2, 1)
|
||||||
|
theme_override_font_sizes/font_size = 14
|
||||||
|
text = "🎯 测试用例"
|
||||||
|
horizontal_alignment = 1
|
||||||
|
|
||||||
|
[node name="ScrollContainer" type="ScrollContainer" parent="TestPanel/VBoxContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_vertical = 3
|
||||||
|
|
||||||
|
[node name="TestButtons" type="VBoxContainer" parent="TestPanel/VBoxContainer/ScrollContainer"]
|
||||||
|
layout_mode = 2
|
||||||
|
size_flags_horizontal = 3
|
||||||
1
tests/integration/.gitkeep
Normal file
1
tests/integration/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 集成测试目录
|
||||||
1
tests/performance/.gitkeep
Normal file
1
tests/performance/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 性能测试目录
|
||||||
1
tests/unit/.gitkeep
Normal file
1
tests/unit/.gitkeep
Normal file
@@ -0,0 +1 @@
|
|||||||
|
# 保持目录结构 - 单元测试目录
|
||||||
Reference in New Issue
Block a user