datawhale/whale-town-front
3
2
Fork 2
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
44 Commits 4 Branches 0 Tags
fca3eb79ddf844cae2f2f0984b00c2805640a033
Commit Graph

44 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
moyin
fca3eb79dd chore：清理临时文档文件 
- 删除迁移完成标记文件 MIGRATION_COMPLETE.md
- 删除重构说明文件 REFACTORING.md
- 删除结构对比文件 STRUCTURE_COMPARISON.md
- 删除临时文档 cloude.md
 2026-01-02 00:57:53 +08:00
moyin
fdedb21cbd fix: 修复GDScript警告和UID冲突问题 
代码修复:
- NetworkManager.gd: 修复参数名冲突和未使用变量警告
- StringUtils.gd: 修复变量名与内置函数char冲突
- ResponseHandler.gd: 移除static关键字，改为实例方法
- AuthScene.gd: 恢复正确的ResponseHandler调用方式

 资源清理:
- 删除assets/sprites/icon/下的重复图标文件
- 删除UI/Theme/下的重复字体和主题文件
- 统一使用assets/路径下的资源文件

 配置修复:
- 修复LoginWindow.tscn和main_scene.tscn中的UID引用
- 更新chinese_theme.tres中的字体路径引用
- 添加project.godot调试设置以减少渲染器警告

 文档更新:
- 更新项目设置指南中的主题和字体路径引用

解决问题:
-  修复所有GDScript编译警告
-  解决UID重复冲突警告
-  统一资源文件路径结构
-  保持Web部署兼容性
 2025-12-31 19:35:20 +08:00
moyin
d49983079a Merge pull request 'fix/verification-code-button-state' (#5) from fix/verification-code-button-state into main 
Reviewed-on: #5
 2025-12-31 19:00:19 +08:00
moyin
51e79c6c6d Merge branch 'main' into fix/verification-code-button-state 2025-12-31 19:00:09 +08:00
moyin
0edd1c740b docs: 完善项目文档和README，修复字符显示问题 
- 修复README.md中的emoji字符显示问题
- 移除文档质量评级系统
- 添加贡献者致谢部分，创建详细的CONTRIBUTORS.md
- 创建核心系统文件EventNames.gd和ProjectPaths.gd
- 更新项目配置文件project.godot，添加输入映射
- 完善各模块文档，修正路径引用问题
- 创建文档更新日志CHANGELOG.md
- 优化文档结构和导航系统
 2025-12-31 18:58:38 +08:00
moyin
a85a7b4d0e docs: 完善项目入门README，强调输入映射配置的重要性 
发现的关键问题:
- 项目代码中使用了输入映射，但project.godot中未配置
- 缺少输入映射会导致游戏无法正常运行

 主要改进:
- 强调输入映射配置为必需步骤
- 添加重要提醒和警告标识
- 新增常见启动问题排查指南
- 明确列出必需的6个输入动作
- 完善完成检查清单

 问题排查:
- 游戏无法响应输入  输入映射未配置
- Invalid action错误  缺少必需输入动作
- AutoLoad单例报错  配置验证问题

 确保新人成功:
- 明确标注必需步骤的优先级
- 提供具体的错误解决方案
- 强调验证配置的重要性
 2025-12-31 18:17:58 +08:00
moyin
51d2ad1629 docs: 修正项目设置指南，确保信息准确 
修正的问题:
- 路径错误: core/managers/  _Core/managers/
- 补充完整的AutoLoad配置列表 (5个单例)
- 修正NetworkManager.login()方法调用方式
- 添加实际的project.godot配置验证

 新增内容:
- 完整的AutoLoad配置表格
- 其他重要项目设置 (主题、渲染、窗口)
- 详细的验证测试代码
- 常见问题排查指南
- 配置检查清单

 确保准确性:
- 所有路径基于实际项目结构验证
- 代码示例基于实际API接口
- 配置信息与project.godot文件一致
 2025-12-31 18:13:08 +08:00
moyin
6f545b04e9 docs: 更新项目结构说明，匹配实际项目结构 
主要更新:
- 根据实际项目目录结构重写文档
- 明确三类团队协作模式：开发、美术、策划
- 详细说明每个目录的职责和使用方式
- 添加团队协作指南和工作流程
- 提供实际的代码示例和配置示例

 新增内容:
- 团队协作模式说明 (开发/美术/策划)
- 详细的目录结构和文件说明
- 开发工作流和版本发布流程
- 最佳实践和规范要求

 确保准确性:
- 所有目录结构都基于实际项目检查
- 文件路径和命名完全匹配当前状态
- 团队职责划分清晰明确
 2025-12-31 18:08:31 +08:00
moyin
1ff677b3b2 docs: 重新组织文档结构，按开发阶段分类 
新的目录结构:
  01-项目入门/     # 新人必读，项目基础
  02-开发规范/     # 编码标准和规范
  03-技术实现/     # 具体开发指导
  04-高级开发/     # 进阶开发技巧
  05-部署运维/     # 发布和部署
  06-功能模块/     # 特定功能文档

 新增导航文档:
- docs/README.md - 完整的文档导航和使用指南
- 各目录下的README.md - 分类说明和使用指导

 优化效果:
- 开发者可以按阶段快速定位需要的文档
- 新人有清晰的学习路径
- 不同角色有针对性的文档推荐
- 提供了问题导向的快速查找功能
 2025-12-31 18:02:16 +08:00
moyin
2998fd2d11 docs: 补充开发规范相关文档 
新增文档:
- docs/输入映射配置.md - 游戏输入配置指南
- docs/架构与通信规范.md - 项目架构和组件通信规范
- docs/实现细节规范.md - 游戏对象具体实现要求
- docs/开发哲学与最佳实践.md - 开发理念和编程最佳实践

 覆盖内容:
- 输入映射的配置方法和验证
- EventSystem事件系统使用规范
- 玩家、NPC、TileMap的实现标准
- 代码质量标准和审查清单
- 性能优化和资源管理指导

这些文档补充了开发规范.md中提到但在docs目录中缺失的内容
 2025-12-31 17:50:19 +08:00
moyin
60edcc9868 docs: 文档中文化和清理 
新增:
- 开发规范.md (翻译自CLAUDE.md)

 重命名为中文:
- project_structure.md  项目结构说明.md
- naming_convention.md  命名规范.md
- code_comment_guide.md  代码注释规范.md
- git_commit_guide.md  Git提交规范.md
- api-documentation.md  API接口文档.md
- network_manager_setup.md  网络管理器设置.md
- setup.md  项目设置指南.md
- testing_guide.md  测试指南.md
- web_deployment_guide.md  Web部署指南.md
- module_development.md  模块开发指南.md
- performance_optimization.md  性能优化指南.md
- scene_design.md  场景设计规范.md
- auth/form_validation.md  auth/表单验证规范.md
- auth/testing_guide.md  auth/认证测试指南.md

 删除总结性文档:
- final_update_summary.md
- web_deployment_changelog.md
- CLAUDE.md
 2025-12-31 17:45:04 +08:00
moyin
d25d8d4dd3 Merge pull request 'fix/verification-code-button-state' (#4) from fix/verification-code-button-state into main 
Reviewed-on: #4
 2025-12-31 17:28:45 +08:00
moyin
190b6c9a66 docs: 清理总结性文档，保留规范类文档 
- 删除 docs/CONTRIBUTORS.md (总结性文档)
- 删除 docs/api_update_log.md (已不存在)
- 删除 docs/cleanup_summary.md (已不存在)
- 保留 docs/module_development.md (开发规范)
- 保留 docs/performance_optimization.md (性能规范)
- 保留 docs/scene_design.md (设计规范)
 2025-12-31 17:27:13 +08:00
moyin
899bc5d5d0 merge: 解决README.md合并冲突，保留main分支内容并整合当前分支特性 2025-12-31 17:21:53 +08:00
moyin
e657cfce0e Merge pull request 'refactor：重构项目架构为分层结构' (#3) from qbb0530/whale-town-front:refactor/项目结构重构 into main 
Reviewed-on: #3
 2025-12-31 16:35:24 +08:00
王浩
b9182bbc2e docs：完善 CLAUDE.md 为 AI 开发规范文档 
## 🎯 主要改进

### 1. 明确项目定位
- 清晰定义 "WhaleTown" 为 2D 俯视像素风 RPG
- 指定 Godot 4.2+ 引擎（禁止 3.x 语法）
- 强调分层架构：`_Core`（框架）、`Scenes`（玩法）、`UI`（界面）

### 2. 完善开发规范
- ✅ 添加 Input Map 配置（WASD、交互键、暂停键）
- ✅ 明确文件路径规则（STRICT LOWERCASE）
- ✅ 添加 EventNames.gd 示例代码
- ✅ 完善测试代码示例（GUT 框架）
- ✅ 优化代码模板（分区注释）

### 3. 强化技术约束
- 📋 严格类型系统（强制静态类型）
- 🏛 事件驱动架构（EventSystem 解耦）
- 🚫 禁止模式列表（yield、Linear Filter 等）
- ✅ 必须测试覆盖（所有 Core 管理器）

### 4. 代码模板改进
- 添加结构化注释（Exports、References、Lifecycle、Methods）
- 展示最佳实践（@onready、%UniqueName、私有方法前缀）
- 包含完整的玩家移动示例

### 5. AI 指令优化
- 直接对 AI 说话（"Claude: Root folders MUST be lowercase"）
- 明确的优先级（STRICT、The Law、MANDATORY）
- 提供决策指南（Area2D vs Body、Enum vs StateChart）

## 📊 文档结构
- 90 行，精炼完整
- Emoji 视觉层级（🛠 命令、📂 文件、📋 标准、🏛 架构）
- 覆盖：文件组织、编码标准、架构设计、测试要求、代码模板

## ✨ 质量提升
- 统一路径大小写（tests/ 而非 Tests/）
- 添加 EventNames.gd 完整示例
- 完善测试代码（watch_signals、assert_signal_emitted）
- 明确 Godot 版本约束（4.2+）

## 🎯 目标
为 AI 提供清晰、严格、可执行的开发规范，
确保代码质量和架构一致性。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-31 16:32:54 +08:00
王浩
642a99970c docs：添加项目开发规范文档 CLAUDE.md 
## 📋 新增内容

添加了完整的 Claude Code 开发规范文档，包括：

### 核心规范
- **项目概述**: 2D 俯视像素风 RPG 游戏架构
- **编码标准**:
  - 严格类型系统
  - 统一命名规范（PascalCase, snake_case, SCREAMING_SNAKE_CASE）
  - 节点访问规范（@onready, %UniqueName）
  - 最佳实践（await, Callable, Signal Up/Call Down）

### 架构规则
- **解耦原则**: 低层级实体通过 EventSystem 通信
- **场景管理**: 统一使用 SceneManager.change_scene()
- **组件化**: 可复用逻辑封装到 Scenes/Components/

### 实现规范
- **实体结构**:
  - Player: CharacterBody2D + Camera2D
  - NPC: StaticBody2D/CharacterBody2D + InteractionArea
  - Interactables: 共享 InteractableComponent
- **交互系统**: 通过 EventSystem.notify_interaction_triggered()
- **TileMap 规则**: 分层设计（地面、障碍、装饰）

### 文件组织
- 地图: Scenes/Maps/[map_name].tscn
- 实体: Scenes/Entities/[entity_name]/[entity_name].tscn
- 脚本: 与场景文件同目录
- 资源: res://Assets/Sprites/

### 测试标准
- 使用 GUT 测试框架
- 测试文件位置: res://test/unit/ 或 res://test/integration/
- 文件命名: test_*.gd
- 核心逻辑必须有单元测试
- 玩家移动和 NPC 交互需要集成测试

### 开发理念
- 简约至上：函数单一职责
- "栅栏后规则": 即使不可见的代码也要干净优美
- 反馈循环：每个交互都要有特效/音效占位
- 零硬编码：所有路径和配置使用常量或 @export
- "自动工作"的相机：自动检测 TileMap 边界

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-31 16:07:54 +08:00
王浩
0b533189ec refactor：重构项目架构为分层结构 
## 🏗️ 主要变更

### 目录结构重构
- 将 core/ 迁移到 _Core/（框架层）
- 将 scenes/ 重构为 Scenes/（玩法层）和 UI/（界面层）
- 将 data/ 迁移到 Config/（配置层）
- 添加 Assets/ 资源层和 Utils/ 工具层
- 将 scripts/ 迁移到 tools/（开发工具）

### 架构分层
- **_Core/**: 框架层 - 全局单例和管理器
- **Scenes/**: 玩法层 - 游戏场景和实体
- **UI/**: 界面层 - HUD、窗口、对话系统
- **Assets/**: 资源层 - 精灵图、音频、字体
- **Config/**: 配置层 - 游戏配置和本地化
- **Utils/**: 工具层 - 通用辅助脚本

### 文件更新
- 更新 project.godot 中的所有路径引用
- 更新自动加载脚本路径
- 更新测试文件的引用路径
- 添加 REFACTORING.md 详细说明
- 添加 MIGRATION_COMPLETE.md 迁移完成标记
- 更新 README.md 反映新架构

### 设计原则
- ✅ 清晰的分层（框架/玩法/界面）
- ✅ 场景内聚（脚本紧邻场景文件）
- ✅ 组件化设计（可复用组件）
- ✅ 职责单一（每个目录职责明确）

## 📋 详细信息
查看 REFACTORING.md 了解完整的重构说明和迁移映射表

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-31 11:36:01 +08:00
moyin
b1f3c0feff Merge pull request 'feature/网络管理和Web部署系统' (#2) from feature/网络管理和Web部署系统 into main 
Reviewed-on: #2
 2025-12-25 23:17:30 +08:00
moyin
021c8623f8 docs：更新主要项目文档 
- 更新README添加Web部署说明
- 精简API文档，移除冗余内容
- 添加新功能使用指南
- 完善项目架构说明
 2025-12-25 23:14:29 +08:00
moyin
a1b867dfd7 chore：清理废弃的网络测试文件 
- 删除旧的NetworkTest.gd测试文件
- 移除对应的UID文件
- 统一使用新的ApiTestScript替代
 2025-12-25 23:14:09 +08:00
moyin
d17c766246 test：增强认证模块测试覆盖 
- 添加认证UI自动化测试
- 实现增强型Toast消息测试
- 完善用户交互测试用例
- 提高测试代码覆盖率
 2025-12-25 23:13:49 +08:00
moyin
92c4eaed07 refactor：重构认证场景和网络集成 
- 重构AuthScene脚本，集成新的NetworkManager
- 优化用户界面布局和交互逻辑
- 改进错误处理和用户反馈机制
- 统一网络请求处理流程
 2025-12-25 23:12:49 +08:00
moyin
abd683c766 config：更新项目配置支持Web导出 
- 启用Web导出功能
- 配置中文字体支持
- 更新项目设置和资源路径
- 优化Web版本性能配置
 2025-12-25 23:10:28 +08:00
moyin
a05bac6f05 docs：添加完整的项目文档体系 
- 添加Web部署完整指南和更新日志
- 创建网络管理器配置文档
- 完善项目设置和测试指南
- 添加API更新日志和清理总结
- 更新脚本使用说明文档
 2025-12-25 23:09:59 +08:00
moyin
77af0bda39 test：完善API测试框架 
- 添加Godot内置API测试脚本
- 实现Python API客户端测试套件
- 添加快速测试和完整测试脚本
- 支持跨平台测试运行(Windows/Linux)
- 更新测试文档和使用指南
 2025-12-25 23:09:12 +08:00
moyin
8980e3d558 feat：添加字符串工具类 
- 实现邮箱格式验证功能
- 添加密码强度检查
- 提供字符串清理和格式化方法
- 支持中文字符处理
 2025-12-25 23:07:47 +08:00
moyin
1294529d13 asset：添加UI资源和中文字体支持 
- 添加微软雅黑字体文件支持中文显示
- 导入Datawhale官方Logo图标
- 创建中文主题配置文件
- 完善游戏图标资源目录
 2025-12-25 23:06:50 +08:00
moyin
0935c5fd76 feat：添加Web版本自动化部署系统 
- 实现跨平台Web导出脚本(Windows/Linux/macOS)
- 添加本地测试服务器启动脚本
- 配置Godot Web导出预设
- 创建Web资源目录结构
- 支持一键导出和本地测试
 2025-12-25 23:06:29 +08:00
moyin
405710bdde feat：实现统一网络请求管理系统 
- 添加NetworkManager核心网络管理器
- 实现ResponseHandler统一响应处理
- 支持GET、POST、PUT、DELETE、PATCH请求类型
- 完善错误处理和超时机制
- 提供统一的信号回调接口
 2025-12-25 23:05:49 +08:00
moyin
7413574672 Merge pull request 'fix/verification-code-button-state' (#1) from fix/verification-code-button-state into main 
Reviewed-on: #1
 2025-12-24 20:58:43 +08:00
moyin
c0f5d6a537 docs：添加性能优化指南 
- 创建全面的性能优化文档
- 涵盖渲染、内存、脚本、网络等各方面优化
- 提供具体的代码示例和最佳实践
- 包含性能监控和调试工具使用方法
- 为开发者提供系统的性能优化指导
 2025-12-24 20:51:45 +08:00
moyin
0b6b1c2040 docs：完善前端项目文档体系 
- 重构README文档，参考后端结构优化内容组织
- 添加模块开发指南，详细说明模块化开发流程
- 创建场景设计规范，规范场景架构和最佳实践
- 建立贡献者名单，记录团队成员和贡献统计
- 完善技术栈介绍和功能特性说明
- 优化文档结构和导航，提升开发者体验
 2025-12-24 20:50:31 +08:00
moyin
8d071cb2ed chore：清理空目录占位文件 
- 删除不再需要的.gitkeep文件
- 目录结构已通过实际文件维护，无需占位符
 2025-12-24 20:40:26 +08:00
moyin
370cffbdd8 config：更新项目配置和文档 
- 更新Godot项目配置，添加自动加载脚本
- 完善.gitignore文件，排除不必要的文件
- 更新README文档，添加项目介绍和使用说明
- 更新主场景配置，集成认证系统
- 添加开发规范文档和项目结构说明
 2025-12-24 20:39:33 +08:00
moyin
5b67771bbc asset：添加游戏资源目录和测试框架 
- 创建音频、字体、材质、着色器等资源目录
- 添加精灵图片资源管理结构
- 建立集成测试、性能测试、单元测试框架
- 为后续资源导入和测试开发做准备
 2025-12-24 20:39:14 +08:00
moyin
73478c0500 chore：完善项目目录结构和基础框架 
- 添加核心系统框架目录结构
- 创建游戏模块化组织架构
- 添加数据配置和本地化支持
- 建立脚本分类管理体系
- 创建场景预制件管理目录
 2025-12-24 20:38:57 +08:00
moyin
15548ebb52 docs：添加API接口文档 
- 详细记录认证相关API接口规范
- 包含请求参数、响应格式和错误代码说明
- 提供完整的使用示例和测试用例
- 涵盖登录、注册、验证码等核心功能接口
 2025-12-24 20:38:40 +08:00
moyin
47cfc14f68 test：添加认证系统测试套件 
- 添加UI测试场景，支持模拟各种认证场景
- 实现API测试脚本，覆盖登录、注册、验证码等接口
- 添加测试文档，说明测试用例和预期结果
- 支持自动化测试和手动测试验证
 2025-12-24 20:37:33 +08:00
moyin
c6bcca4e7f feat：实现用户认证系统核心功能 
- 实现用户登录和注册的完整流程
- 添加邮箱验证码发送和验证功能
- 实现基于邮箱地址的验证码冷却机制
- 添加表单验证和错误提示系统
- 集成Toast消息提示系统
- 支持网络请求处理和错误处理
- 实现按钮状态管理和加载状态显示
 2025-12-24 20:37:00 +08:00
moyin
f11479f2cc scene：创建用户认证场景和UI资源 
- 添加认证场景 auth_scene.tscn，包含登录和注册界面
- 添加认证相关的UI背景图片和框架素材
- 实现响应式布局，支持登录/注册界面切换
- 包含完整的表单输入控件和验证码输入区域
 2025-12-24 20:36:35 +08:00
moyin
8ed260b413 docs：补充git提交发生多类型改动的处理流程 2025-12-08 16:28:03 +08:00
moyin
4285b25323 docs：创建git提交指导文档与命名规则指导文档，更新readme内容 2025-12-08 16:14:15 +08:00
moyin
5acfa7f42b init：项目初始化，搭建Godot文件结构 2025-12-08 16:03:47 +08:00