b3fe03f229
- 修复 GameController._trigger_ai 中AI决策递归调用问题，增加 _is_processing 锁 - 修复 TrainingController 未加入场景树导致信号无法触发的问题 - 主菜单添加"游戏说明"按钮和详细指引对话框 - 训练室添加引导提示标签和操作状态反馈 - 优化提示功能显示中文牌型名称（单张、对子、顺子等） - 优化错误信息显示，提供更具体的失败原因 - 清除调试 print 语句 🤖 Generated with [Qoder][https://qoder.com]
掼蛋卡牌游戏 (Guandan Card Game)
基于 Godot 4.x 开发的掼蛋卡牌游戏。目前处于训练模式开发阶段。
环境要求
- Godot 4.x (开发使用 4.6.3)
- 安装方式:
winget install GodotEngine.GodotEngine - 或从 godotengine.org 下载
项目结构
game-cards/
├── src/
│ ├── core/ # 业务逻辑层（纯 GDScript，零依赖）
│ ├── ai/ # AI 模块（L1 基础 / L2 规则 / L3 策略）
│ ├── game/ # 游戏控制器（训练/对战/回放）
│ ├── network/ # 联机层（后期）
│ ├── ui/ # UI 场景和组件
│ │ ├── scenes/ # 主菜单、训练室、牌桌、大厅、观战
│ │ └── components/ # 卡牌、手牌区、出牌区等组件
│ └── autoload/ # 全局单例（配置、事件总线、音频）
├── tests/ # GUT 单元测试
├── docs/ # 设计文档和实施计划
└── assets/ # 卡牌图片、UI 素材、音频、字体
运行
1. 打开项目
用 Godot 编辑器打开项目根目录 game-cards/。
2. 配置 Autoload（首次运行）
进入 项目 → 项目设置 → 自动加载 (Autoload)，依次添加：
| 名称 | 路径 |
|---|---|
| Config | res://src/autoload/config.gd |
| EventBus | res://src/autoload/event_bus.gd |
| AudioManager | res://src/autoload/audio_manager.gd |
3. 设置主场景
项目 → 项目设置 → 运行 → 主场景 设为 res://src/ui/scenes/main_menu.tscn
4. 启动
按 F5 或点击右上角 运行项目。
运行测试
通过 GUT 运行（推荐）
- 在 Godot AssetLib 中安装 GUT 插件并启用
- 点击 GUT 面板 → 设置测试目录为
res://tests - 点击 Run
通过命令行
godot --headless -s addons/gut/gut_cmdln.gd -gdir=res://tests
开发计划
| 阶段 | 内容 | 状态 |
|---|---|---|
| 训练模式 | 核心逻辑 + L1/L2 AI + 牌型提示 | 进行中 |
| 单机对战 | 完整四人局 + L3 AI | 待开发 |
| 联机 | Action 同步 + 匹配 + 房间 | 待开发 |
| 观战 | Action 流回放 | 待开发 |