# CodeX TODO 最后更新：2026-03-07 ## 当前目标 按 `docs/TODO.md` 的 M1 现状推进最小可玩闭环。当前代码已经具备： - 基础战斗节点玩法 - 事件节点基础占位 - 仓库/组装 UI 骨架 - 局内掉落与战斗结算的一部分 但离“可从开始游戏一路完成一个大关”的 M1 验收还有明显缺口。后续重点是： - 补真正的单局 Run 流程，而不是继续依赖 `TestMenuForm` 手动点节点。 - 把 10 节点固定大关、节点推进、Boss 终点串成闭环。 - 把组装、品质、Tag、耐久从“有数据结构/有 UI”补成“实际影响战斗结果”的规则闭环。 - 补商店节点真实实现，否则 M1 主流程无法跑通。 ## 已完成 ### 1. 战斗主链路已经能独立跑通一场 - `CombatNodeComponent` 能加载关卡、阶段和出怪表，并启动 `CombatScheduler`。 - `CombatScheduler` 已经具备加载地图、推进 phase、结算与返回的基础流程。 - 战斗内已有基地血量、建塔花费、敌人到家扣血、胜负结束等基础逻辑。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatNodeComponent.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatScheduler.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatStates/` - `Assets/GameMain/Scripts/Entity/EntityLogic/MapEntity.cs` - `Assets/GameMain/Scripts/Scene/Map/` ### 2. 战斗结算、掉落与奖励选择已有基础实现 - 战斗内敌人被击败后，已能发放 coin / gold / 组件掉落。 - `CombatInRunResourceManager` 已维护本场奖励背包快照。 - 结算链已经包含奖励计算、奖励选择 UI、FinishForm 返回等基础骨架。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatInRunResourceManager.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/EnemyDrop/EnemyDropResolver.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatSettlementFlowService.cs` - `Assets/GameMain/Scripts/UI/Combat/` ### 3. 背包与组装基础能力已经存在 - `PlayerInventoryComponent` 已有库存快照、金币读写、参战塔名单、组装塔入口。 - `RepoForm` 已能展示组件、塔、参战区和组装区。 - `CombineArea` 已有三槽约束，只有枪口/轴承/底座齐备时才会发起组合请求。 - `PlayerInventoryTowerAssemblyService` 已能基于三组件生成 `TowerItemData` 与 `TowerStatsData`。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/PlayerInventory/PlayerInventoryComponent.cs` - `Assets/GameMain/Scripts/CustomComponent/PlayerInventory/PlayerInventoryTowerAssemblyService.cs` - `Assets/GameMain/Scripts/UI/Game/View/RepoForm.cs` - `Assets/GameMain/Scripts/UI/Game/View/CombineArea.cs` - `Assets/GameMain/Scripts/UI/Game/Controller/RepoFormController.cs` ### 4. 事件节点有基础占位实现 - `EventNodeComponent` 已能读取 `Event.txt`，解析事件选项并随机打开一个事件。 - 事件完成后会发出 `NodeCompleteEventArgs` 返回上层流程。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/EventNodeComponent.cs` - `Assets/GameMain/Scripts/UI/Game/UseCase/EventFormUseCase.cs` - `Assets/GameMain/Scripts/UI/Game/Controller/EventFormController.cs` ## 还没完成 ### 1. M1 真正的 Run 流程还不存在 - 当前入口仍是 `ProcedureMenu` 里打开 `MainForm + TestMenuForm`。 - 玩家目前是手动点击 `战斗 / 事件 / 商店` 按钮进入节点，不是通过单局大关顺序推进。 - 代码里没有明确的“当前节点 / 节点列表 / 节点索引 / 大关完成”运行时模型。 - `docs/TODO.md` 的 `P0-04 / P0-05 / P0-06` 从验收标准看都还没有完整落地。 直接证据： - `ProcedureMenu` 进入后直接打开测试菜单。 - `TestMenuFormController` 直接转发到 `StartCombat / StartEvent / StartShop`。 关键文件： - `Assets/GameMain/Scripts/Procedure/ProcedureMenu.cs` - `Assets/GameMain/Scripts/UI/Menu/Controller/TestMenuFormController.cs` ### 2. 10 节点地图生成与 Boss 终点未实现 - 当前没有发现“固定 10 节点”或“第 10 节点固定 Boss”的节点生成器。 - `CombatNodeComponent.StartCombat()` 仍是从当前主题关卡池里随机抽一个 `DRLevel` 开战。 - 现有 Boss 相关逻辑只存在于战斗内部的 `EntryType.Boss / BossDead`，不是大关节点层面的第 10 节点约束。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatNodeComponent.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/EnemyManager/EnemySpawnDirector.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/PhaseEndConditions/BossDeadPhaseEndCondition.cs` ### 3. 商店节点基本未实现，当前是主流程硬缺口 - `ShopNodeComponent.StartShop()` 仍然是空方法。 - 旧版 `ShopFormUseCase / ShopFormController / ShopForm` 基本都是整文件注释状态，不能视为可用实现。 - 因此 `战斗 -> 事件 -> 商店 -> 组装 -> 下一节点` 这条 M1 主链路实际上卡在商店节点。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/ShopNodeComponent.cs` - `Assets/GameMain/Scripts/UI/Templates/GameScene/UseCase/ShopFormUseCase.cs` - `Assets/GameMain/Scripts/UI/Templates/GameScene/Controller/ShopFormController.cs` - `Assets/GameMain/Scripts/UI/Templates/GameScene/View/ShopForm.cs` ### 4. 三组件约束只做到了“组装时”，还没做到“出战时” - `CombineArea` 已经要求枪口/轴承/底座三槽都填满才能发起组装。 - 但战斗入口并没有校验“玩家是否拥有可参战的完整塔”。 - 当前可以在没有任何参战塔时直接调用 `StartCombat()`，不符合 `P0-10` 的“未满足三组件时禁止出战”。 关键文件： - `Assets/GameMain/Scripts/UI/Game/View/CombineArea.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatNodeComponent.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatScheduler.cs` ### 5. 品质/槽位/Tag 规则只做了最浅一层 - 塔品质目前只按三组件平均品质四舍五入得到。 - `TowerItemData` 里没有“配件槽位数量”之类的落地字段，槽位规则没有真正实现。 - Tag 当前不是按品质概率、数量、等级生成，而是： - 掉落时直接复制 `PossibleTag` - 组塔时直接把三组件 Tag 做并集 - `DRTag` 虽然存在，但没有看到被用于实际掉落/组装规则计算。 - `RarityType` 仍包含 `Red`，而 `docs/MVP-Scope.md.md` 里写的是 M1 不做红色，这里也还没统一。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/PlayerInventory/PlayerInventoryTowerAssemblyService.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/EnemyDrop/EnemyDropResolver.cs` - `Assets/GameMain/Scripts/DataTable/DRTag.cs` - `Assets/GameMain/Scripts/Definition/DataStruct/TowerItemData.cs` - `Assets/GameMain/Scripts/Definition/Enum/RarityType.cs` ### 6. 耐久只停留在展示和扣数值，没有真正生效 - 当前组件耐久会显示在仓库描述和 UI 颜色上。 - 低血通关后会调用 `ReduceAllTowerEndurance(...)` 扣耐久。 - 但塔的真实战斗属性是组装时固化到 `TowerStatsData` 的，不会随着耐久变化动态衰减。 - 组件耐久归 0 后没有销毁、移除库存、拆塔或失效处理。 - 所以 `P0-12` 的“耐久影响属性，归零后物品移除”目前未完成。 关键文件： - `Assets/GameMain/Scripts/Utility/ItemDescUtility.cs` - `Assets/GameMain/Scripts/CustomComponent/PlayerInventory/PlayerInventoryTowerRosterService.cs` - `Assets/GameMain/Scripts/Definition/DataStruct/TowerItemData.cs` - `Assets/GameMain/Scripts/Definition/DataStruct/TowerCompItemData.cs` ### 7. M1 文档与当前实现还有几处范围不一致 - `docs/MVP-Scope.md.md` 写的是固定 10 节点与固定顺序，但当前代码没有对应系统。 - 文档写的是商店节点可购买/出售组件，但当前商店未实现。 - 文档写的是 M1 不做耐久系统，但 `docs/TODO.md` 又把耐久列在 M1 的 `P0-12`；当前代码只做了半套，需要先统一目标再继续推进。 - 文档写的是 M1 不做红色品质，但数据与枚举仍保留 `Red`。 关键文件： - `docs/TODO.md` - `docs/MVP-Scope.md.md` - `docs/GameDesign.md` ## 推荐的后续执行顺序 1. 先补单局 Run 模型 - 明确 `当前节点索引 / 节点列表 / 当前主题 / 大关完成状态` - 把 `ProcedureMenu + TestMenuForm` 临时入口替换成真实节点推进入口 2. 再补 10 节点固定大关 - 先做最小版本：固定顺序 10 节点 - 最后一个节点固定 Boss 战斗 - 节点完成后推进到下一节点 3. 立刻补商店节点最小实现 - 先只做 3 个随机组件、购买、返回 - 不提前做复杂定价与出售扩展 4. 收口组装到出战闭环 - 没有完整塔时禁止开始战斗 - 只有参战塔列表合法时才允许进入战斗节点 5. 最后补品质/Tag/耐久规则 - 先把 M1 真实要做的规则重新对齐 - 再决定是否保留红色品质、耐久和槽位到本阶段 ## 当前做变更时要记住的约束 - 不要继续把 `TestMenuForm` 当作正式节点流程。 - 优先补“流程闭环”，不要先做 M2 的深度系统。 - 商店、节点推进、出战校验属于当前阻塞项，优先级高于数值打磨。 - 如果 M1 最终决定不做完整耐久/红色品质，要先同步更新文档，再改代码目标。 - 若继续保留 `PlayerInventory` 作为局内外共用库存入口，需要避免把单局 Run 状态也硬塞进去。 ## 当前关键入口文件速查 - 流程入口： - `Assets/GameMain/Scripts/Procedure/ProcedureMenu.cs` - 临时节点菜单： - `Assets/GameMain/Scripts/UI/Menu/Controller/TestMenuFormController.cs` - 战斗节点 facade： - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatNodeComponent.cs` - 战斗状态机： - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatScheduler.cs` - 事件节点： - `Assets/GameMain/Scripts/CustomComponent/EventNodeComponent.cs` - 商店节点： - `Assets/GameMain/Scripts/CustomComponent/ShopNodeComponent.cs` - 背包与组装： - `Assets/GameMain/Scripts/CustomComponent/PlayerInventory/` - 仓库 UI： - `Assets/GameMain/Scripts/UI/Game/` - 战斗 UI： - `Assets/GameMain/Scripts/UI/Combat/` ## 备注 - 这份清单按“当前仓库真实实现状态”整理，不沿用旧版 `CodeX-TODO.md` 的 CombatNode 收口主题。 - 当前判断主要基于代码静态检查，没有跑 Unity Editor / PlayMode。 - 如果下一步要继续推进，最值得先做的是：`RunState + 10 节点流程 + ShopNode 最小可用版`。