东方杀 Godot 游戏框架

这是根据《东方杀要求.md》以及现有 DOCX/PPTX 规则稿搭建的 Godot 4.7.x 原型框架。当前交付重点不是完整卡牌与最终美术，而是一个能长期承载角色、符卡、状态、天气、召唤物、回合改写、PVE 和车轮战的规则内核。

当前包含

• 权威命令入口：所有玩家操作先校验，再进入规则系统。
• 可修改/取消的领域事件：支持伤害前减免、反伤、效果替换等机制。
• 组合式原子效果：伤害、治疗、摸牌、资源、状态、标记、召唤、换位、控制下回合。
• 数据驱动内容包：角色、技能、卡牌、状态、天气、模式均为 JSON。
• 红/蓝 P 点规则：主动技能消耗红 P 并积累蓝 P；终极技能由玩家自选红蓝支付比例。
• 回合与大轮次：回合恢复红 P，天气在大轮次开始结算。
• 车轮战协调器：7 人自动分为 2/2/3，胜者带奖励进入人数最少的未结束房间。
• 可序列化决策队列：为闪、抉择、选牌、重新分配手牌和联网响应预留统一入口。
• 灵梦 10 技能示例内容及一个可点击的双人演示场景。
• 完整主菜单：首页包含单人、多人、图鉴和设置四个模块。
• 单人流程：电脑对战、训练和教程均可进入房间设置，再开始对局。
• 多人 P2P 房间：支持六位房间号、密码、模式、人数、回合时间、准备、邀请、房主开局。
• 多人三入口：在线匹配、创建房间、加入房间各自独立；匹配暂为占位。
• 分级房间规则：模式形式分为 PVP、PVE、活动、其他，具体模式随分类动态变化。
• 自定义数值：支持人数上限、选择技能数、生命上限 ±2、P 点上限 ±2、天气和回合时限。
• 开局构筑阶段：大厅开始后先选择角色与技能，全员确认后才进入正式对局。
• 主机权威同步：客户端只提交操作，房主校验后再向所有玩家广播确定性命令。
• 完整内容图鉴：收录 PPT 中 13 名正式角色、3 个空卡位占位角色、160 项符卡、69 张卡牌/衍生物与 7 种天气。
• 两步式角色构筑：先点击角色进入其技能池，再按房间上限选择技能；选中卡绿色发光，再次点击取消。
• 联机准备阶段：玩家可取消准备并返回重选；全员完成构筑后由房主端自动进入对局。
• 不依赖第三方测试插件的无头测试脚本。

运行

1. 安装 Godot 4.7.1（标准版即可，不需要 .NET 版）。
2. 在 Godot 项目管理器中导入本目录的 project.godot。
3. 按 F6/F5 运行演示。

命令行测试：

godot --headless --path . --editor --quit
godot --headless --path . --script res://tests/run_tests.gd

第一条命令先让 Godot 建立全局脚本类缓存，第二条执行规则回归测试。

阅读顺序

1. 架构说明
2. 内容扩展指南
3. 需求追踪与路线图
4. 菜单与 P2P 联机说明
5. 项目结构速查
6. PPT 内容来源核对
7. content/characters.json、content/cards.json 与 content/skills/<角色 id>.json：分类内容数据
8. src/application/game_session.gd：命令与回合入口
9. src/application/effect_resolver.gd：原子效果执行器

设计边界

src/domain 不应依赖场景树或 UI。表现层只读公开快照并提交命令，不能直接修改血量、P 点、手牌或胜负状态。联网时房主持有 GameSession，客户端只发送命令并消费权威命令、事件或快照。