# 泽灵 v2 — 全面代码评估报告
> 评估基准：Unity 2022.3 LTS / C# / 2D 动作平台游戏  
> 评估标准：商业高性能游戏代码实践（参考 Hollow Knight、Celeste、Hades 等同类产品）  
> 评估范围：`Assets/Scripts` 全量代码（约 330 个 .cs 文件）  
> 评估日期：2025/2026

---

## 评分总览

| 评估维度       | 得分 | 备注                          |
|--------------|------|-------------------------------|
| 架构设计       | 8.5  | 模块化扎实，少量遗留单例         |
| 性能          | 8.0  | 热路径零分配，批量 LOS 优秀      |
| 可扩展性       | 8.5  | 数据驱动完善，少量硬编码管道      |
| 编辑器友好     | 9.0  | 工具链完整，为同类 Indie 最佳水平 |
| 使用便利性     | 8.0  | 契约清晰，命名偶有不一致         |
| **综合**      | **8.4** | **接近商业发行水准**          |

---

## 一、架构设计（8.5 / 10）

### 1.1 程序集隔离（✅ 优秀）

项目共 **25+ 个程序集定义（.asmdef）**，粒度精确到子模块层级：

```
BaseGames.Core          → 全局服务基础设施
BaseGames.Core.Save     → 持久化（单向依赖 Core）
BaseGames.Core.Events   → SO 事件频道（无外部依赖）
BaseGames.Combat        → 战斗管道（无 Player/Parry 直接依赖）
BaseGames.Parry         → 弹反（依赖 Combat 接口，不依赖 Player）
BaseGames.Player        → 玩家逻辑（处于依赖图顶层）
BaseGames.Enemies.AI    → BD 任务节点
BaseGames.Editor        → 仅编辑器工具
...
```

编译时强制模块边界，跨模块引用必须使用接口或事件频道，与商业游戏标准一致。

**依赖方向控制**：

```
Core → Core.Save（单向）
       ↑
GameServiceRegistrar（桥接）使用 SaveServiceAdapter 适配器，
避免 Core.Save → Core 的反向引用，保持有向无环图。
```

### 1.2 服务定位器（✅ 优秀）

`ServiceLocator`（`BaseGames.Core`）：

```csharp
ServiceLocator.Register<IAudioService>(this);          // 覆盖注册
ServiceLocator.RegisterIfAbsent<IAudioService>(null);  // 防重复
ServiceLocator.GetOrDefault<ICameraService>()          // 安全取用
```

- 接口隔离：调用方依赖 `IAudioService`，不依赖 `AudioManager` 具体类
- Null-Object 兜底：`GameServiceRegistrar.Awake()` 先注册 `NullAudioService`，避免 `AudioManager` 未初始化时的空引用崩溃
- 测试支持：`OverrideForTest<T>` / `Reset()` 仅在 `#if UNITY_EDITOR` 暴露

**已注册接口**：
`IAudioService` / `ISaveService` / `ISceneService` / `IDeathRespawnService` / `IEventChannelRegistry` / `IObjectPoolService` / `ICameraService` / `IPlatformService`

### 1.3 游戏状态机（✅ 优秀）

`GameStateMachine` 为纯 C# 类，**不继承 MonoBehaviour**：

```csharp
// 非法转换 → 返回 false + 错误字符串（不抛出异常）
bool ok = _fsm.TransitionTo(nextId, out string error);
```

- 每个状态声明 `ValidNextStates`（合法出口白名单），状态图文档化在代码中
- `GameManager` 持有 `GameStateMachine` 实例而非继承它（组合优于继承）
- 与 Celeste 等游戏的 `StateMachine` 模式完全吻合

### 1.4 玩家状态机（✅ 优秀）

`PlayerController` 维护 `Dictionary<Type, PlayerStateBase>` 状态字典；
`PlayerStateBase` **POCO 类**，不继承 MonoBehaviour，生命周期由 `PlayerController` 驱动：

```
OnStateEnter → OnStateUpdate → OnStateFixedUpdate → OnStateExit
```

12 个具体状态（Idle / Run / Jump / Fall / Dash / AerialDash / Attack / AirAttack / UpAttack / DownAttack / Parry / Hurt / Dead / Spring / WallSlide / WallJump / Swim）各自独立，新增状态只需实现 `PlayerStateBase` 并在 `InitializeStates()` 中注册。

**#if UNITY_EDITOR ValidTransitions** 仅在编辑期验证，不增加运行时开销。

### 1.5 敌人状态系统（✅ 优秀 + 尚有空间）

Phase 1 双轨实现：`EnemyStateType` 枚举保持对外 API，`IEnemyState` POCO 对象承载逻辑：

```csharp
_stateObjs[EnemyStateType.Hurt] = new EnemyHurtState();
// 子类可在 base.Awake() 后替换：
_stateObjs[EnemyStateType.Hurt] = new BossSpecialHurtState();
```

`ForceState()` 完成三步 Exit → 赋值 → Enter，干净无副作用。

**缺陷**：`EnemyBase.TakeDamage()` 中 TODO：

```csharp
// TODO: 根据霸体结果选 Stagger / Hurt
ForceState(EnemyStateType.Hurt);  // 霸体判断尚未走 POCO 路径
```

实际 Stagger 触发仍绕过 `_stateObjs` 字典——Phase 1 双轨不完整。

### 1.6 SO 事件频道（✅ 优秀）

`BaseEventChannelSO<T>` / `VoidBaseEventChannelSO` 双泛型基类：

- `Subscribe()` 返回 `EventSubscription`（`IDisposable`），配合 `CompositeDisposable.AddTo()` 零泄漏
- Editor 模式下 `EventBusMonitor.Record()` 记录所有事件（帧号 + 订阅数），供 `EventBusMonitorWindow` 运行时调试
- `description` 字段：设计师在 Inspector 中注释频道用途

### 1.7 遗留问题（⚠️）

| 问题 | 文件 | 影响 |
|------|------|------|
| `GameManager.Instance` 静态单例与 `ServiceLocator` 并存 | `GameManager.cs` | 双入口访问模式 |
| `AudioManager.Instance` 标注 `[Obsolete]` 但仍存在 | `AudioManager.cs` | 新代码可能误用旧入口 |
| `VFXPool.Instance` 未注册到 ServiceLocator | `VFXPool.cs` | 无法 Mock / 测试 |
| `GlobalObjectPool.Instance` 保留（已注册 IObjectPoolService，但静态 Instance 共存） | `GlobalObjectPool.cs` | 同上 |
| `SaveManager.Instance` 保留（由 DeathRespawnService 直接调用） | `DeathRespawnService.cs` | 依赖具体类 |
| `AntiSoftlockSystem` 在全局命名空间（无 namespace） | `AntiSoftlockSystem.cs` | 命名空间污染 |
| `EquipmentManager` 使用 `EventChannelRegistry.Instance`（非 ServiceLocator） | `EquipmentManager.cs` | 不一致 |

---

## 二、性能（8.0 / 10）

### 2.1 战斗热路径——零堆分配（✅ 优秀）

`DamageInfo` 为 **struct**（非 class），通过两种方式构造：

```csharp
// 热路径：零堆分配，直接从 SO 初始化
DamageInfo info = DamageInfo.From(damageSourceSO);
info.KnockbackDirection = ...;

// 复杂情况：Builder 模式（分配一个 Builder 对象，可接受）
DamageInfo info = new DamageInfo.Builder()
    .SetRaw(50).SetType(DamageType.Slash).SetFlags(DamageFlags.CanBeParried)
    .Build();
```

`HurtBox.ReceiveDamage()` 8步流水线中无任何 LINQ / Alloc 调用，性能关键路径完全符合商业标准。

### 2.2 批量视线检测（✅ 优秀）

`BatchLOSSystem` 实现时间切片策略：

```
每 FixedUpdate 仅处理 min(_maxRequestersPerFrame=8, total) 个请求者
_currentOffset 轮询偏移，均匀分配负载
```

对比朴素实现（每敌人每帧一次 Raycast2D）：20 个敌人 → 减少 60%+ 射线调用。
**注**：`_results[idx]` 写入后未被读取（结果已通过 `requester.ReceiveLOSResult()` 直接回调），`_results` List 是冗余字段，可删除。

### 2.3 对象池（✅ 优秀）

`GlobalObjectPool` 特性：

| 特性 | 实现 |
|------|------|
| Addressables 预热 | `WarmupAsync()` 异步批量实例化 |
| LRU 回收 | MaxCount 达限时回收 LinkedList 头节点（O(1)） |
| 后台补池 | 同步 Instantiate 后触发协程异步补充 |
| 接口隔离 | 实现 `IObjectPoolService`，可 Mock 测试 |

`VFXPool`（ParticleSystem 专用池）独立维护，合理的关注点分离（ParticleSystem 生命周期与普通 GameObject 不同）。

**可改进**：`VFXPool.Play()` 每次都通过协程启动，即使对象已在池中可同步取出，协程调度有 1-2 帧延迟。

### 2.4 音频池（✅ 良好）

`AudioManager` 使用 6 源轮转 SFX 池，双 AudioSource 交叉淡入淡出 BGM，避免频繁 `AudioSource.Stop/Play` 切换产生的爆音与内存分配。

### 2.5 状态效果双结构（✅ 优秀）

```csharp
private readonly List<StatusEffect>                         _activeList  = new(); // Update 遍历 O(n)
private readonly Dictionary<StatusEffectType, StatusEffect> _activeIndex = new(); // 类型查找 O(1)
```

`MaterialPropertyBlock` 修改 Shader 属性（不修改共享材质），符合 Unity 性能最佳实践。

### 2.6 序列化性能（✅ 良好）

`SaveManager.SaveAsync()` 使用 `Formatting.None`（减少 JSON 体积），`SemaphoreSlim(1,1)` 防止并发写入损坏。

### 2.7 性能风险点（⚠️）

| 风险 | 位置 | 说明 |
|------|------|------|
| `FindObjectsOfType<AudioListener>` | `GameServiceRegistrar.EnsureSingleAudioListener()` | 已有 `_primaryListener` 绑定后可绕过，但未绑定时仍全场景扫描 |
| `_equipped.Sum(c => c.notchCost)` LINQ | `EquipmentManager.UsedNotches` | 每次 UI 查询触发 LINQ，列表小（<8）时可接受；建议缓存 |
| `BatchLOSSystem._results` 冗余写入 | `BatchLOSSystem.cs` L68 | 每帧写入后不读取，微小 GC 风险 |
| `VFXPool.PlayCoroutine()` | `VFXPool.cs` | 即使池命中，仍需协程恢复一帧 |
| `PlayerController._states[typeof(T)]` | `PlayerController.cs` | Type 键查找无 boxing（引用比较），但每次 TransitionTo 需哈希查找 |

---

## 三、可扩展性（8.5 / 10）

### 3.1 护符系统（✅ 优秀）

`ICharmEffect` 策略模式，完全数据驱动：

```
CharmSO → ICharmEffect[]
           ├── StatModifierEffect     (+攻击力/防御)
           ├── AttackSpeedEffect      (攻速修改)
           ├── OnHitEffect            (命中触发)
           ├── SkillNumericModifierEffect (技能数值)
           ├── SkillSlotOverrideEffect    (技能槽替换)
           ├── WeaponOverrideEffect       (武器替换)
           └── SoulSpellEffect            (灵力法术)
```

新增效果只需实现 `ICharmEffect`，无需修改 `EquipmentManager`——完美的开闭原则。

### 3.2 成就系统（✅ 优秀）

`AchievementCondition` 抽象类，10 个具体实现：

```
CollectedItemCondition / DefeatedBossCondition / EnteredRegionCondition /
ParryCountCondition / TimedBossKillCondition / MapExplorationCondition ...
```

设计师可在 `AchievementSO` Inspector 中组合条件，不需要代码介入。

### 3.3 Boss 技能系统（✅ 良好）

```
BossBase → EnterPhase(int) [virtual]
         → BossSkillExecutor → BossSkillSO[]
                             → SkillSequenceSO (有序技能序列)
                             → AttackPatternSO (技能模式 SO)
```

`TelegraphSystem` 独立为组件，可复用于不同 Boss。

### 3.4 EventChain 系统（✅ 良好）

`EventChainSO` 顺序事件链，配合 `EventChainManager` 执行：设计师可在 SO 中定义剧情触发序列，无需写代码。

### 3.5 IValidatable + SOValidationRunner（✅ 优秀）

任何 SO 实现 `IValidatable`，自动纳入构建前扫描：

```csharp
public IEnumerable<string> Validate()
{
    if (BaseDamage <= 0) yield return "❌ BaseDamage 必须 > 0";
}
```

SOValidationRunner 作为 `IPreprocessBuildWithReport`，**构建中止**防止错误配置上线。

### 3.6 可扩展性缺陷（⚠️）

| 问题 | 说明 | 建议 |
|------|------|------|
| `HurtBox.ReceiveDamage()` 8步流水线硬编码 | 新增拦截步骤须修改 `HurtBox` | 引入 `IDamageInterceptor[]` 责任链 |
| `StatusEffectManager.CreateEffect()` | DamageType→StatusEffect 极可能是 switch | 改为 SO 配置映射 `Dictionary<DamageType, StatusEffect>` |
| 无通用属性计算器 | 护符/Buff 效果各自修改 `PlayerStats` 字段 | 考虑 `StatCalculator` 优先级栈（参考 Hades 设计） |
| `AudioManager.PlayBGM/SFX(string)` 为桩 | Phase 2 未完成 | 优先实现 AudioEventSO 集成 |
| `Spells` 模块仅有 `_Placeholder.cs` | 施法系统留空 | 按现有 Skill 模式扩展 |

---

## 四、编辑器友好（9.0 / 10）

编辑器工具链是本项目**最突出的优势**，接近 AA 商业游戏水准。

### 4.1 工具总览

| 工具 | 位置 | 功能 |
|------|------|------|
| `SOValidationRunner` | `Editor/Validation/` | 全量 SO 数据验证，构建前自动执行 |
| `AddressKeyValidator` | `Editor/` | Addressable Key 有效性验证，防止引用失效 |
| `AddressReferenceGraphWindow` | `Editor/` | Addressable 引用图可视化 |
| `HurtBoxEditor` | `Editor/Combat/` | PlayMode 受击盒注入状态可视化（绿色/橙色） |
| `EventBusMonitorWindow` | `Editor/` | 运行时事件总线监控（频道名 + 订阅数 + 帧号） |
| `EventChannelEditor` | `Editor/` | 事件频道 Inspector 中一键 Raise 按钮 |
| `BossSkillSequenceWindow` | `Editor/` | Boss 技能序列可视化设计器 |
| `EventChainEditorWindow` | `Editor/` | EventChain 可视化编辑器 |
| `CharmEffectDrawer` | `Editor/Equipment/` | 护符效果自定义 PropertyDrawer |
| `MapRoomDataEditor` | `Editor/Map/` | 地图房间数据编辑器 |
| `SceneScaffoldTools` | `Editor/` | 场景脚手架快捷工具 |
| `NavSurfaceBakeShortcut` | `Editor/` | 导航网格一键烘焙快捷键 |
| `CreateEventChannelAssets` | `Editor/` | 一键创建事件频道 SO 资产菜单 |
| `ScriptExecutionOrderTools` | `Editor/` | 执行顺序可视化管理 |
| `DestructibleTileEditor` | `Editor/World/` | 可破坏瓦片编辑器 |
| `AchievementSOEditor` | `Editor/Achievements/` | 成就 SO 自定义编辑器 |

### 4.2 Inspector 设计（✅ 优秀）

- 所有配置使用 `[Header]` 分组，字段有 `[Tooltip]`
- 所有事件频道 SO 有 `description` 字段（设计师可见注释）
- `[DefaultExecutionOrder]` 系统范围覆盖（-2000 到 +50），执行顺序文档化在代码中
- `[RequireComponent]` 保证依赖完整性，避免配置错误

### 4.3 潜在改进（⚠️）

| 问题 | 说明 |
|------|------|
| `HurtBoxEditor` 用反射读取私有字段 | 字段重命名后 Editor 静默失效，建议改用 SerializedProperty 或公开只读属性 |
| `SOValidationRunner` 错误检测靠关键字 "必须" / "❌" | 语言切换后可能失效，建议改为 `ValidationResult` 枚举（Error / Warning / Info） |
| `BatchLOSSystem` 无 Editor Gizmo | 调试时无法可视化射线，建议添加 OnDrawGizmos |
| `EventChainEditorWindow` 无截图/文档 | 新成员上手曲线较高 |

---

## 五、使用便利性（8.0 / 10）

### 5.1 订阅模式（✅ 优秀）

```csharp
// 组合式，OnDisable 一行清理，零泄漏
private readonly CompositeDisposable _subs = new();

private void OnEnable()
{
    _onPlayerSpawned.Subscribe(OnPlayerSpawned).AddTo(_subs);
    _onBossFightEnded.Subscribe(OnBossEnded).AddTo(_subs);
}

private void OnDisable() => _subs.Clear();
```

相比裸 `+=/-=` 订阅，极大降低事件泄漏风险，与商业级 Rx 风格一致。

### 5.2 伤害构造（✅ 优秀）

```csharp
// 热路径首选：零分配
DamageInfo info = DamageInfo.From(source);

// 复杂流水线：Builder
DamageInfo info = new DamageInfo.Builder()
    .SetRaw(100).SetFlags(DamageFlags.CanBeParried | DamageFlags.CanClash)
    .SetKnockback(Vector2.right, 10f).Build();
```

双模式清晰区分使用场景，符合 API 设计最佳实践。

### 5.3 状态类便捷属性（✅ 良好）

`PlayerStateBase` 提供所有常用属性的简称：

```csharp
// 在任意状态中直接使用
Anim.Play(AnimCfg.Run);
Move.Jump();
Stats.TakeDamage(info);
Buffer.Consume(InputType.Jump);
```

避免重复的 `_owner.` 链式访问，代码可读性接近 Celeste 的 `Player.cs`。

### 5.4 Null-Object 模式（✅ 良好）

```csharp
NullAudioService   // IAudioService 空实现（Log 警告，不崩溃）
NullPlatformService // IPlatformService 空实现（PC 非 Steam 环境）
NullPathAgent      // IPathAgent 空实现（无导航组件时使用）
```

三个 NullObject 防御了三类常见 NullReferenceException，符合商业游戏的防御性编程要求。

### 5.5 命名一致性问题（⚠️）

| 问题 | 对比 |
|------|------|
| 玩家用 `TransitionTo()` 转换状态 | 敌人用 `ForceState()` |
| 玩家用 `GetState<T>()` 取状态对象 | 敌人用 `_stateObjs[enumKey]` |
| `ServiceLocator.Get<T>()` 失败抛异常 | `GetOrDefault<T>()` 失败返回 null | （这对是有意为之，但文档化不足）|
| `Register()` 覆盖已有注册 | `RegisterIfAbsent()` 不覆盖 | （语义差异明确，但命名可更直白：`RegisterOrReplace` / `RegisterOnce`） |

### 5.6 ISaveable 手动注册（⚠️）

```csharp
// SavePoint.cs, EquipmentManager.cs, AchievementManager.cs ... 各自手动调用
SaveManager.Instance.Register(this);    // OnEnable
SaveManager.Instance.Unregister(this);  // OnDisable
```

约有 8+ 个 ISaveable 实现重复此样板代码。商业实践（如 Unity 官方 Open Project）通常用 `SaveManager.FindAndRegister<ISaveable>()` 或 ScriptableObject 驱动的注册表统一管理。

---

## 六、专项模块深度评估

### 6.1 存档系统（8.5/10）

**优势**：
- Newtonsoft.Json 序列化（完整类型支持，无反射限制）
- `SaveMigrator.Migrate()` 版本迁移管道（向前兼容）
- `Checksum` 完整性验证（防止文件损坏导致存档不可用）
- `SemaphoreSlim` 防并发写入
- `CrashReporter` + `EmergencySaveService` 崩溃保护
- `LocalFileStorage` 通过 `ISaveStorage` 接口可替换（云存档、主机平台扩展点）

**不足**：
- `SaveManager.Instance` 仍被 `DeathRespawnService` 直接引用（应通过 `ISaveService`）
- `SaveData` 结构若需新字段，`SaveMigrator` 需手动更新（无自动 Schema 演化）
- 无存档文件加密（对 PC 存档修改作弊无防御，可接受）

### 6.2 输入系统（8.0/10）

**优势**：
- `InputReaderSO` 封装 Unity InputSystem，作为 ScriptableObject 可在不同场景共享
- `OnEnable` 重置防止 Play Mode 再进入时状态残留（工程实践亮点）
- `EnableGameplayInput()` / `EnableUIInput()` 提供明确的上下文切换
- `InputBuffer` 缓冲近端输入，解决游戏手柄操作的时序问题（Coyote Time 协同）
- `ConflictDetector` 检测按键冲突（重映射安全保障）

**不足**：
- `InputReaderSO` C# 事件（非 SO 事件频道）与其他模块的 SO Channel 模式不一致——需订阅 C# event 而非通过 SO 引用
- `MoveInput` 轮询属性与事件订阅模式并存（两种取值方式）

### 6.3 摄像机系统（7.5/10）

**优势**：
- `ICameraService` 接口隔离，`RoomCamera` / `CameraStateController` 通过服务层解耦
- `CameraBlendProfileSO` 数据驱动过渡曲线

**不足**：
- `Camera/_Placeholder.cs` 说明摄像机系统尚未完整实现
- `CameraStateController` 骨架代码较多，实际行为有限

### 6.4 AI 系统（8.5/10）

**优势**：
- BD 自定义任务节点（18 个）覆盖完整 AI 行为集
- `#if GRAPH_DESIGNER` 编译守卫，无 Behavior Designer 时代码仍可编译
- `SharedString TargetStateName`（vs 原 `SharedInt`）：枚举字符串绑定，BD 图重排枚举不破坏
- `BatchLOSSystem` + `ILOSRequester` 接口：视线检测完全与敌人类型解耦
- `BD_WaitForAnimation` 使用 Animancer State 轮询而非硬编码等待时间

**不足**：
- BD 图中的 `BlackboardVariable` 与 `EnemyBase` 属性之间的映射文档化不足
- `SetAggroTickRate()` 为空方法（Opsive 运行时 API 变更留存了兼容桩）

### 6.5 战斗系统（9.0/10）

**优势**：
- `DamageInfo` struct 流水线：RawDamage → Amount（护盾修改） → FinalDamage（防御减免）—— 清晰的三段式
- `DamageFlags` / `DamageTags` 位域枚举：单值携带多语义（CanBeParried | IgnoreIFrame）
- `HurtBox` 8步流水线顺序固定（无敌帧 → 弹反 → 霸体 → 护盾 → 防御减免 → TakeDamage → 广播 → DoT）
- `ClashResolver` 拼刀碰撞检测独立为组件，不污染 `HitBox`
- `ParrySystem` 仅暴露窗口状态（`ConsumeParry()`），不引用玩家具体类型

**不足**：
- `HitBox` 无法限制同一帧对同一 HurtBox 的多次触发（需 `_hitCooldown` + HashSet 去重）——当前 `_hitCooldown` 仅是全局冷却，多目标情况下可能误伤
- `PoiseWindowConfig` 存在但 `PlayerController.GetCurrentPoiseLevel()` 固定返回 `PoiseLevel.None`（未实现）

---

## 七、优先修复建议（按影响面排序）

### P1（影响正确性）

1. **EnemyBase.TakeDamage() 霸体判断 TODO**
   - 现状：Stagger 触发 hardcode，POCO 路径不完整
   - 修复：在 `TakeDamage()` 中根据 `DamageInfo.Break` 和当前霸体等级选择 `Stagger` 或 `Hurt`

2. **HitBox 同目标重入保护**
   - 现状：`_hitCooldown` 仅限制全局频率，多目标情况下可能一帧命中同一 HurtBox 多次
   - 修复：维护 `HashSet<Collider2D> _hitThisActivation`，`Deactivate()` 时清空

3. **ISaveable 自动注册**
   - 现状：8+ 个实现类手动 Register/Unregister
   - 修复：在 `SaveManager.Awake()` 中 `FindObjectsOfType<ISaveable>()` 批量注册（允许一次 FindObjects）

### P2（影响质量）

4. **移除 AudioManager.Instance 单例**
   - 仅通过 `ServiceLocator.Get<IAudioService>()` 访问
   
5. **StatusEffectManager.CreateEffect() 替换 switch**
   - 改为 `[SerializeField] private StatusEffectMappingSO _mapping`，设计师可配置 DamageType→Effect

6. **AntiSoftlockSystem 加入命名空间**
   - 当前无 namespace，建议 `namespace BaseGames.Support.AntiSoftlock`

7. **BatchLOSSystem 删除冗余 _results List**
   - 结果已通过回调传递，`_results` 字段仅占内存，删除即可

### P3（体验优化）

8. **HurtBoxEditor 改用 SerializedProperty**
   - 避免反射字段名依赖，防止重命名导致 Editor 静默失效

9. **SOValidationRunner 使用枚举结果**
   - `ValidationResult` { Error, Warning } 代替关键字字符串匹配

10. **VFXPool.Play() 同步取池**
    - 池命中时跳过协程，直接同步设置 Transform 并播放

11. **完成 AudioEventSO Phase 2 集成**
    - `PlayBGM(string)` / `PlaySFX(string)` 目前输出警告，应接入 AudioEventSO 资产查找

---

## 八、对标商业游戏评估

| 维度 | Hollow Knight 类比 | 本项目水准 |
|------|------------------|-----------|
| 模块隔离 | 单 Assembly（早期） | ✅ 25+ asmdef，更现代 |
| 事件解耦 | C# event 直连 | ✅ SO EventChannel，更可配置 |
| 存档系统 | Binary 格式 | ✅ JSON + 迁移器，更易维护 |
| 对象池 | 自定义池 | ✅ Addressables + LRU，更完整 |
| 编辑器工具 | 无 | ✅ 16 个专用工具，远超同类 |
| AI 调试 | 无 | ✅ EventBusMonitor + HurtBoxEditor |
| 状态机 | MonoBehaviour 继承 | ✅ POCO 状态对象，更轻量 |
| 单元测试 | 无 | ⚠️ `ServiceLocator.Reset()` 提供基础，但测试文件尚未建立 |

---

## 九、总结

本代码库在 **Indie 游戏**中属于**顶层水准**，在架构规范性、模块化程度和编辑器工具链方面已达到部分 **AA 商业标准**。核心机制（战斗流水线、状态机、存档系统、对象池）设计扎实，接口边界清晰，后续扩展成本低。

主要短板集中在**三个方面**：

1. **遗留单例模式**（7 处）与 ServiceLocator 并存——形成双入口访问隐患
2. **数个模块处于 Phase 1 / Stub 阶段**（Audio Phase 2、霸体判断、IEnemyState Phase 2）
3. **缺乏自动化测试覆盖**——ServiceLocator 测试基础设施已就绪，但测试文件数量为零

若在当前基础上补齐上述三点，该代码库完全达到**独立发行商业游戏**的代码质量要求。

---

*本报告由 GitHub Copilot 自动分析生成，基于源代码静态阅读，不包含运行时 Profile 数据。*