Archive

.codexignore

@@ -0,0 +1,39 @@
+# Unity generated folders
+Library/
+Temp/
+Obj/
+Logs/
+Build/
+Builds/
+UserSettings/
+MemoryCaptures/
+Recordings/
+
+# IDE / tool caches
+.vs/
+.idea/
+.gradle/
+.cache/
+
+# OS / misc
+.DS_Store
+Thumbs.db
+
+# Node / frontend caches if present
+node_modules/
+
+# Test / coverage outputs
+coverage/
+TestResults/
+
+# Large binary assets that usually don't help code editing
+*.apk
+*.aab
+*.unitypackage
+*.zip
+*.7z
+*.rar
+
+# Optional: generated csproj/sln if you mainly use Unity-generated ones
+# *.csproj
+# *.sln

docs/CodeX-TODO.md

@@ -0,0 +1,201 @@
+# CodeX TODO
+
+最后更新：2026-03-07
+
+## 当前目标
+
+按 `docs/CombatNodeArchitecture.md` 收敛 `CombatNode` 域职责，重点是：
+- `CombatScheduler` 收敛为“状态机管理器”，不再继续堆业务细节。
+- 局内 `Coin / Gold / BaseHp / Loot Backpack / BuildTowerSnapshots` 由 `CombatInRunResourceManager` 作为唯一真值来源。
+- `EnemyManager` 只上报敌人事件，不直接决定资源入账或状态切换。
+- `PhaseEndType` 退出条件从 `PhaseLoopRuntime` 中抽离到 `IPhaseEndCondition` 实现类。
+- 结束链、加载链、奖励选择链逐步从 `CombatScheduler.cs` 本体挪到状态类或专用服务。
+
+## 已完成
+
+### 1. 状态类拆分完成
+- `CombatScheduler.cs` 内部的嵌套状态类已经迁移到 `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatStates/`。
+- 保留了 `partial class CombatScheduler + 嵌套类` 的结构。
+- 旧 `CombatState` 已统一替换为 `CombatStateBase`。
+
+关键文件：
+- `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatScheduler.cs`
+- `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatStates/CombatStateBase.cs`
+- `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatStates/*.cs`
+
+### 2. 第一轮目标命名和骨架已建立
+- `CombatResourceManager` 已重命名为 `CombatInRunResourceManager`。
+- 已新增掉落解析骨架：
+  - `EnemyDropResolveContext`
+  - `EnemyDropResolveResult`
+  - `EnemyDropResolver`
+- 已新增 phase end 骨架：
+  - `IPhaseEndCondition`
+  - `PhaseEndConditionContext`
+  - `PhaseEndConditionFactory`
+  - `NonePhaseEndCondition`
+  - `TimeElapsedPhaseEndCondition`
+  - `EnemiesClearedPhaseEndCondition`
+  - `BossDeadPhaseEndCondition`
+
+关键文件：
+- `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatInRunResourceManager.cs`
+- `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/EnemyDropResolver.cs`
+- `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/PhaseEndConditions/`
+
+### 3. 局内资源真值已迁到 CombatInRunResourceManager
+目前 `CombatInRunResourceManager` 已经接管：
+- `CurrentCoin`
+- `CurrentBaseHp`
+- `MaxBaseHp`
+- `GainedCoin`
+- `GainedGold`
+- 本局 `BuildTowerStats` 快照
+- 奖励背包快照
+
+已实现的资源接口：
+- `InitializeForCombat(DRLevel level)`
+- `MarkCombatEnded()`
+- `Reset()`
+- `TryConsumeCoin(int coin)`
+- `AddCoin(int coin)`
+- `ApplyBaseDamage(int damage)`
+- `TryGetBuildTowerStats(int buildIndex, out TowerStatsData stats)`
+- `AddEnemyDefeatedReward(int gainedCoin, int gainedGold)`
+- `AddSettlementGold(int gainedGold)`
+- `GetRewardInventorySnapshot()`
+
+附带完成：
+- `CombatCoinChangedEventArgs` 增加了 `DeltaCoin`
+- `CombatBaseHpChangedEventArgs` 增加了 `DeltaBaseHp`
+- coin/baseHp 变化事件现在由 `CombatInRunResourceManager` 发布，而不是 `CombatNodeComponent`
+- `Reset()` 现在会清理 `ParticipantTowerInstanceIds`
+
+关键文件：
+- `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatInRunResourceManager.cs`
+- `Assets/GameMain/Scripts/Event/Combat/CombatCoinChangedEventArgs.cs`
+- `Assets/GameMain/Scripts/Event/Combat/CombatBaseHpChangedEventArgs.cs`
+
+### 4. CombatScheduler / CombatNodeComponent 已做一轮收口
+#### CombatScheduler
+- 启动时会先初始化 `CombatInRunResourceManager`
+- 提供资源转发属性：
+  - `CurrentCoin`
+  - `CurrentGold`
+  - `CurrentBaseHp`
+  - `CurrentBuildTowerCount`
+- 提供资源转发方法：
+  - `TryConsumeCoin(...)`
+  - `AddCoin(...)`
+  - `TryGetBuildTowerStats(...)`
+- 不再通过 `CombatNodeComponent` 读写 baseHp/coin 真值
+
+#### CombatNodeComponent
+- 不再持有这些字段：
+  - `_currentCoin`
+  - `_currentGold`
+  - `_currentBaseHp`
+  - `_currentBuildTowerStats`
+- 当前只保留：
+  - 关卡数据缓存
+  - `CurrentLevel / CurrentThemeType`
+  - 战斗启动/结束协调
+  - 最终结算摘要字段（`LastDefeatedEnemyCount / LastGainedCoin / LastGainedGold`）
+  - 对 `CombatScheduler` 的只读/操作转发
+
+关键文件：
+- `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatScheduler.cs`
+- `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatNodeComponent.cs`
+
+## 还没完成
+
+### 1. EnemyManager 事件边界还没改干净
+当前仍然存在的问题：
+- `EnemyManager` 还在自己计算 `droppedCoin / droppedGold / baseDamage`
+- 然后把这些原始数值直接传给 `CombatScheduler`
+
+目标状态：
+- `EnemyManager` 只上报：
+  - `OnEnemyDefeated(DREnemy enemy)`
+  - `OnEnemyReachedBase(DREnemy enemy)`
+- `CombatScheduler` 统一调用：
+  - `EnemyDropResolver`
+  - `CombatInRunResourceManager`
+
+下一步建议：
+- 先改 `EnemyManager` 上报签名
+- 再把 coin/gold/baseDamage 的公共副作用挪到 `CombatScheduler`
+
+### 2. PhaseEndCondition 骨架已建，但还没接入
+当前仍然是旧逻辑：
+- `PhaseLoopRuntime.ShouldEndCurrentPhase(...)` 还在使用
+- `CombatWaitingForPhaseEndState` 还没有改成通过 `IPhaseEndCondition` 判定
+
+目标状态：
+- `PhaseLoopRuntime` 只保留 phase runtime 数据
+- `CombatWaitingForPhaseEndState` 通过 `PhaseEndConditionFactory.Create(...)` 获取当前判定器
+- `PhaseEndType` 的规则不再写在 `PhaseLoopRuntime` 里
+
+### 3. CombatScheduler 本体仍然过重
+当前仍然还在 `CombatScheduler.cs` 里的业务：
+- 结算上下文构建
+- 基地血量结算修正
+- 奖励选择 UI 准备
+- FinishForm 打开逻辑
+- 一部分加载和清理编排
+
+目标状态：
+- `Loading` 负责加载和 `MapData` 组装
+- `Settlement` 负责结算上下文和奖励准入判断
+- `RewardSelection` 只处理选择流程
+- `FinishForm` 只处理展示
+- `WaitingForReturn` 只处理回退和最终清理
+
+### 4. MapData + Event 解耦还没开始
+当前：
+- `MapData` 只有 `LevelId`
+- `MapEntity` 仍通过 `GameEntry.CombatNode` 反查 coin / build stats
+
+目标状态：
+- `CombatLoadingState` 从 `CombatInRunResourceManager` 读取快照
+- `CombatLoadingState` 组装更完整的 `MapData`
+- `MapEntity` 后续通过 `MapData + Event` 获取上下文，而不是反查 `CombatNode`
+
+## 推荐的后续执行顺序
+
+1. 改 `EnemyManager` 上报边界，接入 `EnemyDropResolver`
+2. 接入 `IPhaseEndCondition`，移除 `PhaseLoopRuntime.ShouldEndCurrentPhase(...)`
+3. 把结算链逻辑从 `CombatScheduler.cs` 继续剥离到状态类
+4. 开始做 `MapData + Event` 解耦
+
+## 当前做变更时要记住的约束
+
+- 状态切换只能通过 `CombatScheduler.ChangeState(...)`
+- 不要把新业务继续堆回 `CombatScheduler.cs`
+- `CombatNodeComponent` 现在应该保持轻量 facade，不要再把 coin/baseHp/build snapshot 回流到它
+- coin/baseHp 变化事件应继续由 `CombatInRunResourceManager` 发布
+- `Failed` 只处理异常失败，不处理“基地血量归零”的正常失败路径
+
+## 当前关键入口文件速查
+
+- 状态机宿主：
+  - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatScheduler.cs`
+- 局内资源真值：
+  - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatInRunResourceManager.cs`
+- 状态类：
+  - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatStates/`
+- 加载服务：
+  - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/CombatLoadSession.cs`
+- phase runtime：
+  - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/PhaseLoopRuntime.cs`
+- phase end 条件骨架：
+  - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatScheduler/PhaseEndConditions/`
+- 敌人域 facade：
+  - `Assets/GameMain/Scripts/CustomComponent/CombatNode/EnemyManager/EnemyManager.cs`
+- CombatNode 入口 facade：
+  - `Assets/GameMain/Scripts/CustomComponent/CombatNode/CombatNodeComponent.cs`
+
+## 备注
+
+- 当前环境没有可用的本地 C# 编译器（`dotnet / mcs / csc / msbuild / xbuild` 都不可用），所以本轮改动主要依赖文本级检查。
+- 仓库目前有一些与本任务无关的脏文件，继续改动时只聚焦 `CombatNode` 相关文件即可，不要顺手回滚无关改动。

docs/IconColorDesgin.md

@@ -1,225 +0,0 @@
-使用的 5 个属性：
-- AttackDamage(MuzzleComp)
-- DamageRandomRate(MuzzleComp)
-- RotateSpeed(BearingComp)
-- AttackRange(BearingComp)
-- AttackSpeed(BaseComp)
-
-下面我给你一套专门为这 5 个属性设计的稳定映射方案，目标是：
-
-* 不出现“未使用 RGB 位导致底色聚集”
-* 不出现颜色难以区分
-* 不随数值微调产生大跳变
-* 能一眼看出“偏伤害 / 偏射速 / 偏范围”等方向
-
----
-
-# 一、先定颜色语义（非常关键）
-
-我们先给每个属性一个**语义色相（Hue）**，并且颜色间隔拉开，避免混淆。
-
-| 属性               | 含义倾向   | Hue建议    |
-|------------------|--------|----------|
-| AttackDamage     | 爆发/力量  | 0°（红）    |
-| DamageRandomRate | 波动/暴击感 | 30°（橙）   |
-| RotateSpeed      | 灵活/机动  | 200°（青蓝） |
-| AttackRange      | 空间/覆盖  | 120°（绿）  |
-| AttackSpeed      | 频率/连发  | 270°（紫）  |
-
-解释：
-
-* 伤害 → 红（直觉最强）
-* 范围 → 绿（覆盖感）
-* 攻速 → 紫（科技感/高频）
-* 旋转 → 青蓝（灵活）
-* 随机伤害 → 橙（不稳定爆发）
-
-Hue 间隔 > 60°，视觉上足够区分。
-
----
-
-# 二、不要直接映射到 RGB，而是走 HSV
-
-### Step 1：归一化
-
-对每个属性：
-
-```csharp
-x_i = clamp01((value_i - min_i) / (max_i - min_i))
-```
-
-⚠️ 不要用当前组件的 min/max，要用全局平衡区间。
-
----
-
-# 三、核心算法：主导属性 + 混合属性
-
-## 1️⃣ 找出前两名属性
-
-```csharp
-i1 = argmax(x_i)
-i2 = secondMax(x_i)
-```
-
----
-
-## 2️⃣ Hue 插值
-
-```csharp
-w = x_i2 / (x_i1 + x_i2 + 0.0001f)
-hue = lerp(Hue[i1], Hue[i2], w)
-```
-
-这能避免“单一属性颜色单调”的问题。
-
-例如：
-
-* 高伤害 + 高攻速 → 红紫之间
-* 高范围 + 高旋转 → 绿青之间
-
----
-
-# 四、饱和度（Saturation）
-
-饱和度表达“专精度”。
-
-```csharp
-purity = x_i1 - x_i2
-sat = lerp(0.45f, 0.9f, clamp01(purity * 1.5f))
-```
-
-* 越单一专精 → 越鲜艳
-* 属性均衡 → 稍微偏灰
-
-这样“杂牌组件”会看起来更灰一点，专精流派更亮。
-
----
-
-# 五、明度（Value）
-
-明度表达“整体强度”。
-
-```csharp
-intensity = (x1 + x2 + x3 + x4 + x5) / 5f
-val = lerp(0.55f, 0.95f, intensity)
-```
-
-强度越高越亮。
-
-⚠️ 不要让 val 太低，否则会看起来像“禁用状态”。
-
----
-
-# 六、品质不要改 Hue
-
-品质建议只影响：
-
-* 外描边颜色
-* 发光
-* 明度偏移
-* 图标底板
-
-例如：
-
-| 品质 | 处理方式            |
-|----|-----------------|
-| 白  | val × 0.9       |
-| 绿  | 无变化             |
-| 蓝  | 外发光             |
-| 紫  | val ×1.05 + 外发光 |
-| 红  | 双层发光 + 轻微高对比    |
-
-不要把红品质直接改成红色，那会和 AttackDamage 冲突。
-
----
-
-# 七、避免“颜色基地”的关键
-
-你之前的问题是：
-
-> 某些属性没有值 → RGB 位没用 → 颜色集中
-
-用现在方案：
-
-* 即便某些属性接近 0，Hue 仍由主导属性决定
-* 不会出现“默认黑色/灰色聚集”
-
-另外建议：
-
-```csharp
-sat = max(sat, 0.4f);
-val = max(val, 0.6f);
-```
-
-避免太灰太暗。
-
----
-
-# 八、额外增强：组件类型偏移
-
-你有三类组件（枪口/轴承/底座），可以轻微加一个 hue 偏移：
-
-* 枪口：+0°
-* 轴承：+15°
-* 底座：-15°
-
-这样即便数值类似，也能区分结构类型。
-
----
-
-# 九、完整伪代码（你可以直接用）
-
-```csharp
-Color GenerateColor(float[] normalizedStats, ComponentType type)
-{
-    float[] hueMap = { 0f, 30f, 200f, 120f, 270f };
-
-    int i1 = MaxIndex(normalizedStats);
-    int i2 = SecondMaxIndex(normalizedStats);
-
-    float w = normalizedStats[i2] /
-              (normalizedStats[i1] + normalizedStats[i2] + 0.0001f);
-
-    float hue = Mathf.Lerp(hueMap[i1], hueMap[i2], w);
-
-    float purity = normalizedStats[i1] - normalizedStats[i2];
-    float sat = Mathf.Lerp(0.45f, 0.9f, Mathf.Clamp01(purity * 1.5f));
-
-    float intensity = normalizedStats.Average();
-    float val = Mathf.Lerp(0.55f, 0.95f, intensity);
-
-    if (type == ComponentType.Axis) hue += 15f;
-    if (type == ComponentType.Base) hue -= 15f;
-
-    return Color.HSVToRGB(hue / 360f, sat, val);
-}
-```
-
----
-
-# 十、视觉稳定性测试建议
-
-做一个小测试场景：
-
-* 随机生成 200 个组件
-* 打印颜色到网格
-* 看是否：
-
-  * 有大量颜色过于相似
-  * 有大面积灰色
-  * 是否能一眼区分“偏伤害”“偏范围”等
-
----
-
-# 结论
-
-你不应该：
-
-❌ 把 5 个属性硬塞进 RGB 位
-
-你应该：
-
-✅ 用 Hue 表达方向
-✅ 用 Saturation 表达专精
-✅ 用 Value 表达强度
-✅ 用外观表达品质