# CodeX TODO 最后更新：2026-03-08 ## 当前目标 按 `docs/TODO.md` 的 M1 目标推进最小可玩闭环，并以“能从开始游戏一路推进到 Boss 结算”为准检查当前实现。 和上一版相比，仓库已经把 Run 相关基础件进一步接到了 `ProcedureMain`，因此这份清单不再把重点放在“有没有 Run 模型”，而是聚焦下面这几个真实阻塞项： - 已有 `ProcedureMenu + MenuForm -> ProcedureMain + NodeMapForm` 的主入口链路，正式节点面板骨架已经接入流程。 - 固定 10 节点顺序已经开始驱动战斗 / 事件 / 商店入口，节点事件也已带上基础 Run 上下文字段。 - 出战入口已有“至少有参战塔”的最小校验，但还没收口成严格的最终合法性约束。 - 品质 / Tag / 耐久仍然停留在部分实现状态，尚未和 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` ### 2. 战斗结算、掉落与奖励选择已有基础实现 - 敌人被击败后已能发放 coin / gold / 组件掉落。 - `CombatRunResourceStore` 维护局内资源与奖励背包快照。 - 结算链已包含奖励计算、奖励选择 UI、FinishForm 返回等基础骨架。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatRunResourceStore.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/EnemyDrop/EnemyDropResolver.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatSettlementService.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`，解析事件选项并随机打开事件。 - `EventForm` 的打开 / 关闭现已统一走 `UIRouter`，不再混用私有 controller。 - 事件完成后会关闭 UI 并发出 `NodeCompleteEventArgs`。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/EventNodeComponent.cs` - `Assets/GameMain/Scripts/UI/Game/UseCase/EventFormUseCase.cs` - `Assets/GameMain/Scripts/UI/Game/Controller/EventFormController.cs` ### 5. Run 模型和 10 节点固定序列已经落地到代码与测试 - 已有 `RunNodeType / RunNodeStatus / RunState / RunNodeState` 等运行时模型。 - 已有 `RunStateFactory` 和 `RunStateAdvanceService` 处理节点创建、推进、失败和完成。 - 已有 `FixedRunNodeSequenceBuilder`，Plain 主题下固定生成 10 节点，并且第 10 节点是 `BossCombat`。 - 已有 Editor 测试覆盖 `RunState` 创建、节点推进、Boss 节点和固定 10 节点序列。 关键文件： - `Assets/GameMain/Scripts/Procedure/RunModel.cs` - `Assets/GameMain/Scripts/Procedure/RunStateFactory.cs` - `Assets/GameMain/Scripts/Procedure/RunStateAdvanceService.cs` - `Assets/GameMain/Scripts/Procedure/FixedRunNodeSequenceBuilder.cs` - `Assets/GameMain/Tests/Editor/RunStateTests.cs` ### 6. 商店节点已经有最小可用实现 - `ShopNodeComponent.StartShop()` 已不再是空方法。 - 新版 `ShopFormUseCase` 已能随机生成 4 个组件商品。 - 已支持购买、扣金、把组件写回 `PlayerInventory`、退出商店。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/ShopNodeComponent.cs` - `Assets/GameMain/Scripts/UI/Shop/UseCase/ShopFormUseCase.cs` - `Assets/GameMain/Scripts/UI/Shop/Controller/ShopFormController.cs` - `Assets/GameMain/Scripts/UI/Shop/View/ShopForm.cs` ### 7. `NodeMapForm` 五层 UI 已经接入主流程 - 已新增 `NodeMapFormRawData / UseCase / Controller / Context / View` 和 `NodeItemContext / NodeItem`。 - `ProcedureMain` 已不再打开 `TestMenuForm`，而是打开 `NodeMapForm` 作为 Hub 节点入口。 - `NodeMapFormController` 会把 `NodeItem` 点击转换为 `NodeMapNodeEnterRequestedEventArgs`，再交给流程层决定是否进入节点。 - `NodeItem` 的 `Icon` 已改成通过 `SpriteCacheComponent` 按资源名异步获取，`Bg` 负责表示节点状态。 关键文件： - `Assets/GameMain/Scripts/UI/Game/RawData/NodeMapFormRawData.cs` - `Assets/GameMain/Scripts/UI/Game/UseCase/NodeMapFormUseCase.cs` - `Assets/GameMain/Scripts/UI/Game/Controller/NodeMapFormController.cs` - `Assets/GameMain/Scripts/UI/Game/Context/NodeMapFormContext.cs` - `Assets/GameMain/Scripts/UI/Game/Context/NodeItemContext.cs` - `Assets/GameMain/Scripts/UI/Game/View/NodeMapForm.cs` - `Assets/GameMain/Scripts/UI/Game/View/NodeItem.cs` - `Assets/GameMain/Scripts/Event/Game/NodeMapNodeEnterRequestedEventArgs.cs` ### 8. 菜单入口已切回独立 Menu 流程 - `ProcedureMenu` 当前只负责菜单入口，不再承载主流程 Hub 与节点推进逻辑。 - `MenuForm` 已按五层结构补齐 `RawData / UseCase / Controller / Context / View`。 - `Start` 按钮现在会驱动 `ProcedureMenu` 切场景，并在主场景加载完成后进入 `ProcedureMain`。 - `Settings` 仍保留 `TODO` 占位，`Exit` 会直接退出游戏。 关键文件： - `Assets/GameMain/Scripts/Procedure/ProcedureMenu.cs` - `Assets/GameMain/Scripts/Procedure/Base/ProcedureChangeScene.cs` - `Assets/GameMain/Scripts/UI/Menu/Controller/MenuFormController.cs` - `Assets/GameMain/Scripts/UI/Menu/View/MenuForm.cs` ## 当前未完成 ### 1. Run 主流程已经形成基于 `NodeMapForm` 的临时闭环，但还没完全收口 - `ProcedureMain` 进入后会创建 Run，并打开 `MainForm + NodeMapForm`。 - `NodeMapForm` 已经有五层结构，`NodeItem` 也能按当前 `RunState` 刷出 10 个节点。 - 点击当前节点后，由 `NodeMapFormController` 发出 `NodeMapNodeEnterRequestedEventArgs`，再由 `ProcedureMain` 根据当前 `RunState.CurrentNode` 决定是否允许进入战斗 / 事件 / 商店。 - 节点完成或战斗失败后，`ProcedureMain` 会推进 `RunState`，再重新打开 Hub UI。 - 因此当前已经不是“测试菜单三选一”，而是“节点地图单入口”的临时版本。 当前缺口： - `NodeMapForm` 已接入，但当前仍偏 MVP 骨架，缺节点连线、节点说明、Boss 特效等正式表现。 - `NodeMapFormContext` 当前只提供基础进度和当前节点信息，还没有更完整的地图展示上下文。 - Run 完成后的正式结算 / 收尾表现仍未建立。 关键文件： - `Assets/GameMain/Scripts/Procedure/ProcedureMain.cs` - `Assets/GameMain/Scripts/UI/Game/View/NodeMapForm.cs` - `Assets/GameMain/Scripts/UI/Game/Controller/NodeMapFormController.cs` ### 2. 固定 10 节点序列已开始驱动真实流程，但正式上下文系统仍不完整 - `FixedRunNodeSequenceBuilder` 已定义固定顺序和 Boss 终点。 - `ProcedureMain` 已开始用当前 `RunNodeState.LinkedLevelId` 驱动战斗入口。 - `EventNodeComponent` 和 `ShopNodeComponent` 已能进入并完成当前节点。 - `EventNodeComponent` 的 UI 生命周期也已统一走 `UIRouter`。 - `NodeEnter / NodeComplete` 已带 `runId / nodeId / nodeType / sequenceIndex` 等基础字段，`NodeComplete` 也会回传成功状态与库存快照。 - 当前缺的不是“有没有上下文字段”，而是更系统化的节点追踪、展示与统一收口能力。 关键文件： - `Assets/GameMain/Scripts/Procedure/FixedRunNodeSequenceBuilder.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatNodeComponent.cs` - `Assets/GameMain/Scripts/CustomComponent/EventNodeComponent.cs` - `Assets/GameMain/Scripts/CustomComponent/ShopNodeComponent.cs` - `Assets/GameMain/Scripts/Event/Game/NodeEnterEventArgs.cs` - `Assets/GameMain/Scripts/Event/Game/NodeCompleteEventArgs.cs` ### 3. 商店节点已纳入临时 Run 推进闭环，但回流目标仍是 MVP Hub - 现在可以单独打开商店、随机生成组件、购买并退出。 - 商店结束后已能通过 `ProcedureMain` 推进当前 `RunState`。 - 但退出后当前回流的是 `MainForm + NodeMapForm` 的 MVP 节点面板，而不是完整表现版地图。 关键文件： - `Assets/GameMain/Scripts/CustomComponent/ShopNodeComponent.cs` - `Assets/GameMain/Scripts/UI/Shop/UseCase/ShopFormUseCase.cs` - `Assets/GameMain/Scripts/Procedure/ProcedureMain.cs` ### 4. 出战入口已有最小校验，但离最终验收还差一层 - `CombineArea` 已限制三槽必须齐备才能组塔。 - `ProcedureMain` 已经补上“没有参战塔时禁止进入战斗节点”的最小校验。 - 但这个校验目前仍是“有参战塔即可开战”，还不是“完整三组件合法塔”意义上的最终验收版本。 - 这意味着当前还不满足 `P0-10` 里“未满足三组件时禁止出战”的验收要求。 关键文件： - `Assets/GameMain/Scripts/UI/Game/View/CombineArea.cs` - `Assets/GameMain/Scripts/Procedure/ProcedureMain.cs` - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatNodeComponent.cs` ### 5. 品质 / 槽位 / Tag 规则仍只做了浅层版本 - 塔品质仍主要按三组件品质聚合得到。 - `TowerItemData` 中没有真正落地“配件槽位数量”之类的核心字段。 - Tag 仍主要来自组件自身配置或简单并集，未看到完整概率、数量、等级规则落地。 - `DRTag` 已存在，但尚未形成明确的掉落 / 组装计算主链路。 - `RarityType` 仍保留 `Red`，与部分 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 上。 - 低血通关后已存在扣耐久逻辑。 - 但塔战斗属性是在组装时固化到 `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` ## 当前与 `docs/TODO.md` 的对照判断 结合静态代码检查，当前更接近下面这个状态： - `P0-04`：基础模型已完成，并已接入 `ProcedureMain + NodeMapForm` 的临时 Run 闭环。 - `P0-05`：固定 10 节点序列已由 builder + `ProcedureMain + NodeMapForm` 驱动实际流程，基础事件上下文字段已接入，但缺更完整的地图表现层与正式上下文系统。 - `P0-06`：节点进入、完成、失败后回 `NodeMapForm` 的临时闭环已存在，但正式地图表现与正式结算仍未完成。 - `P0-10`：未完成。 - `P0-11`：未完成。 - `P0-12`：未完成。 换句话说，仓库已经不再是“还没有 Run 模型 / 10 节点 / 商店最小实现”的状态；真正的缺口是“这些能力已经接成 `NodeMapForm` 驱动的临时可跑版本，但还没收口成正式 M1 主流程表现层与上下文系统”。 ## 推荐的后续执行顺序 1. 先把临时 Hub 升级成正式节点面板 - 保留 `ProcedureMain` 持有 Run 的做法 - 继续以 `NodeMapForm` 为基础补正式节点地图表现 - 至少补上节点连线、Boss 视觉强调、当前节点说明和完成态反馈 2. 再补齐节点上下文的消费、追踪与统一推进 - 继续沿用 `NodeEnterEventArgs` 和 `NodeCompleteEventArgs` 现有的 `runId / nodeId / nodeType / sequenceIndex` - 节点完成后统一由流程层调用 `RunStateAdvanceService` - 节点失败时明确是否停局、重试或返回菜单 3. 然后继续收口战斗关卡选择 - 普通战斗和 Boss 战斗继续统一由当前 `RunNodeState.LinkedLevelId` 驱动 - 去掉遗留的随机选关兜底路径，避免偏离 Run 顺序 4. 再补出战合法性校验 - 没有完整参战塔时禁止进入战斗节点 - 在 UI 和流程层都给出明确反馈 5. 最后再处理品质 / Tag / 耐久与文档对齐 - 先确认 M1 是否真的保留红色品质和完整耐久 - 再决定是补全实现，还是先缩范围并同步文档 ## 当前做变更时要记住的约束 - 不要再把 Hub 退回 `TestMenuForm` 语义。 - 不要把菜单入口和主流程 Hub 混回同一个 Procedure；保持 `ProcedureMenu -> ProcedureMain` 的职责边界。 - 优先补“临时闭环 -> 正式节点 UI / 正式上下文”的收口，不要继续只加单点功能。 - 商店已经接入 Run，下一步重点不是继续扩商店，而是把 Hub/UI 做正式。 - 若 M1 最终不做完整耐久 / 红色品质，要先同步文档再改代码目标。 - `PlayerInventory` 可以继续作为库存入口，但不要把整局 Run 状态直接混进库存对象里。 ## 当前关键入口文件速查 - 流程入口： - `Assets/GameMain/Scripts/Procedure/ProcedureMain.cs` - Run 模型： - `Assets/GameMain/Scripts/Procedure/RunModel.cs` - `Assets/GameMain/Scripts/Procedure/RunStateFactory.cs` - `Assets/GameMain/Scripts/Procedure/RunStateAdvanceService.cs` - `Assets/GameMain/Scripts/Procedure/FixedRunNodeSequenceBuilder.cs` - 当前 Hub / 节点入口： - `Assets/GameMain/Scripts/UI/Game/Controller/NodeMapFormController.cs` - `Assets/GameMain/Scripts/UI/Game/View/NodeMapForm.cs` - 战斗节点 facade： - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatNodeComponent.cs` - 事件节点： - `Assets/GameMain/Scripts/CustomComponent/EventNodeComponent.cs` - 商店节点： - `Assets/GameMain/Scripts/CustomComponent/ShopNodeComponent.cs` - 商店 UI： - `Assets/GameMain/Scripts/UI/Shop/` - 背包与组装： - `Assets/GameMain/Scripts/CustomComponent/PlayerInventory/` - `Assets/GameMain/Scripts/UI/Game/` ## 备注 - 这份清单基于 2026-03-08 的静态代码检查更新。 - 本次已修正上一版中“Run 模型不存在”“10 节点未实现”“商店节点基本未实现”等过期判断。 - 当前最值得优先推进的是：`NodeMapForm 继续收口表现层 -> 节点事件带上下文 -> 战斗按节点关卡进入 -> 出战校验`。