# 09 · 编辑器扩展

> **命名空间** `BaseGames.Editor`  
> **所属文档集** [← 返回索引](./README.md) · [总览](./00_Overview.md)  
> **程序集** `BaseGames.Editor.asmdef`（Editor-only，不打包进 Runtime）

---

## 目录

1. [设计原则](#1-设计原则)
2. [自定义 Inspector 列表](#2-自定义-inspector-列表)
3. [EditorWindow 工具列表](#3-editorwindow-工具列表)
4. [Scene 视图 Gizmos 汇总](#4-scene-视图-gizmos-汇总)
5. [Play Mode 调试叠加层](#5-play-mode-调试叠加层)
6. [ContextMenu 工具](#6-contextmenu-工具)
7. [编辑器菜单结构](#7-编辑器菜单结构)
8. [自动化检查工具](#8-自动化检查工具)
9. [高级工具集（补充）](#9-高级工具集补充)

---

## 1. 设计原则

- **编辑器扩展与运行时代码完全分离**：所有编辑器扩展代码置于 `Editor/` 文件夹，使用独立 `.asmdef`
- **工具服务于制作流程**：每个工具针对具体的制作痛点，不做泛用性过度设计
- **视觉化优先**：Gizmos 和自定义 Inspector 的目标是"**看一眼就知道配置是否正确**"
- **不破坏运行时行为**：所有 Inspector 修改通过 `SerializedObject.ApplyModifiedProperties()` 标准流程，支持撤销（Undo）
- **UI 技术选型**：所有编辑器扩展统一使用 **Unity UI Toolkit（UIElements）**，不使用 IMGUI（`OnGUI` / `EditorGUILayout`）

### UI Toolkit 统一规范

**自定义 Inspector** — 使用 `CreateInspectorGUI()` + `BindProperty()`：

```csharp
[CustomEditor(typeof(PlayerController))]
public class PlayerControllerEditor : Editor
{
    public override VisualElement CreateInspectorGUI()
    {
        var root = new VisualElement();

        // 默认字段绑定（替代 DrawDefaultInspector）
        InspectorElement.FillDefaultInspector(root, serializedObject, this);

        // 自定义运行时状态区
        var statusFoldout = new Foldout { text = "运行时状态（Play Mode）" };
        var stateLabel    = new Label();
        stateLabel.schedule.Execute(() =>
        {
            if (!EditorApplication.isPlaying) return;
            var t = target as PlayerController;
            stateLabel.text = $"State: {t.CurrentStateName}  HP: {t.HP}/{t.MaxHP}";
        }).Every(100);  // 100ms 轮询
        statusFoldout.Add(stateLabel);

        // 调试按钮（Play Mode only）
        var debugGroup = new VisualElement();
        debugGroup.SetEnabled(false);
        EditorApplication.playModeStateChanged += state =>
            debugGroup.SetEnabled(state == PlayModeStateChange.EnteredPlayMode);
        var hurtBtn = new Button(() => (target as PlayerController)?.TakeDamage(2)) { text = "Hurt 2" };
        debugGroup.Add(hurtBtn);

        root.Add(statusFoldout);
        root.Add(debugGroup);
        return root;
    }
}
```

**EditorWindow** — 使用 `CreateGUI()` + 内置控件：

```csharp
public class MyTool : EditorWindow
{
    [MenuItem("BaseGames/My Tool")]
    public static void Open() => GetWindow<MyTool>("My Tool");

    public void CreateGUI()
    {
        var splitView = new TwoPaneSplitView(0, 260f, TwoPaneSplitViewOrientation.Horizontal);
        var left  = new ScrollView();
        var right = new VisualElement();
        splitView.Add(left);
        splitView.Add(right);
        rootVisualElement.Add(splitView);
    }
}
```

**§2–§9 各工具使用的关键 UI Toolkit 控件**：

| 工具 | 关键控件 | 说明 |
|------|---------|------|
| §2.x 自定义 Inspector | `ProgressBar`、`Foldout`、`Button`、`Label` | `CreateInspectorGUI()` 替代 `OnInspectorGUI()` |
| §2.3 ParrySystem（时间轴）| 自绘 `VisualElement`（`generateVisualContent` + `Painter2D`）| 替代 `GUI.Box` 手绘条 |
| §3.1–3.4 简单 EditorWindow | `ListView`、`Button`、`TextField` | `CreateGUI()` 替代 `OnGUI()` |
| §9.1 BT 验证器 | `TreeView` | 原生树形控件 |
| §9.2 进程流程图 | `GraphView`（`UnityEditor.Experimental.GraphView`）| 节点图；见注意事项 |
| §9.3 GameState 分析器 | `MultiColumnListView` | 矩阵视图 |
| §9.4 伤害模拟器 | `TwoPaneSplitView` + 自绘直方图（`Painter2D`）| 参数面板 + 分布图 |
| §9.7 装备预览 | `TwoPaneSplitView` + `DropdownField` | 响应式分栏 |
| §9.8 构建验证器 | `MultiColumnListView` + 可点击 `Label` | 多列结果 + 跳转 |

> **GraphView 注意**：`UnityEditor.Experimental.GraphView` 标注为 Experimental，API 可能在 Unity 版本间变动。如遇稳定性问题，9.2 进程流程图可改为 `VisualElement` 手绘节点（`generateVisualContent` + `Painter2D.DrawBezierCurve`），无需依赖 Experimental API。

**USS 样式文件存放**：`Assets/Editor/UI/USS/` — 统一样式变量（颜色、间距、字体大小），通过 `styleSheets.Add()` 挂载。

---

## 2. 自定义 Inspector 列表

### 2.1 PlayerController Inspector

**目标**：Play Mode 下直观监控玩家状态，快速触发测试。

**布局规划**：

```
┌─ PlayerController ─────────────────────────────────┐
│  ◈ 状态信息                                         │
│  ┌──────────────────────────────────────────────┐  │
│  │ Current State  RunState                      │  │
│  │ HP             ████████████░░  8 / 10        │  │
│  │ Soul           ███████░░░░░░░  66 / 99       │  │
│  │ Geo            340                           │  │
│  │ IsGrounded     ✓   FacingDir  → (+1)         │  │
│  │ Invincible     ░░░░░░░░░░ (0.00s remaining)  │  │
│  └──────────────────────────────────────────────┘  │
│  ◈ 已解锁能力                                       │
│  ┌──────────────────────────────────────────────┐  │
│  │ [✓ Parry] [✓ DoubleJump] [✗ WallJump]       │  │
│  │ [✗ AerialDash] [✗ Swim]                      │  │
│  └──────────────────────────────────────────────┘  │
│  ◈ 调试工具（Play Mode Only）                       │
│  [Force Idle] [Force Run] [Force Air]              │
│  [Deal Damage: 2] [Deal Damage: 10] [Instant Kill] │
│  [Add Soul: 33] [Add Geo: 100]                     │
│  [Unlock All Abilities] [Lock All Abilities]       │
└────────────────────────────────────────────────────┘
```

**实现方式**：继承 `Editor`，重写 `CreateInspectorGUI()` 返回 `VisualElement` 树。进度条使用 UI Toolkit `ProgressBar` 控件；Play Mode 限定区域通过 `debugGroup.SetEnabled(EditorApplication.isPlaying)` + `EditorApplication.playModeStateChanged` 回调控制显隐。

---

### 2.2 EnemyBase Inspector

**目标**：快速查看敌人 AI 状态，测试战斗参数。

```
┌─ EnemyBase ──────────────────────────────────────┐
│  ◈ 运行时状态（Play Mode）                        │
│  State: Controlled  HP: █████████░  90/100       │
│  BD Node: BD_MoveToPlayer (Running)              │
│  Nav Status: Moving → (12.5, -3.0) [0.8m left]  │
│  ◈ 属性配置                                      │
│  Stats SO: [ES_GruntWarrior ▼]                   │
│  AnimCfg : [EA_GruntWarrior ▼]                   │
│  ◈ 调试工具（Play Mode Only）                    │
│  [Force Stagger] [Force Death] [Reset HP]        │
│  [Disable BD] [Enable BD] [Reload BD Tree]       │
└──────────────────────────────────────────────────┘
```

---

### 2.3 ParrySystem Inspector

**目标**：可视化弹反时间轴，测试弹反参数。

```
┌─ ParrySystem ────────────────────────────────────┐
│  ◈ 时间轴预览                                    │
│  [▌ Startup ▌▌▌▌▌▌▌ Active Window ▌▌ Endlag ▌] │
│     0.05s              0.28s           0.10s     │
│  ◈ 运行时状态（Play Mode）                       │
│  State: Active  Timer: 0.19s / 0.28s            │
│  Window:   ████████████░░░  68%                 │
│  CounterW: ──────────────  (Inactive)            │
│  ◈ 调试工具                                     │
│  [Trigger Parry Success] [Trigger Parry Fail]   │
│  [Open Counter Window]   [Reset]                 │
└──────────────────────────────────────────────────┘
```

**时间轴预览** 在 Edit Mode 下也可显示（根据 `ParryConfigSO` 参数计算比例），方便策划调整数值时直观预览窗口比例。

---

### 2.4 RoomCameraBounds Inspector

**目标**：防止镜头边界配置错误。

```
┌─ RoomCameraBounds ───────────────────────────────┐
│  ◈ 边界检查                                      │
│  Bounds Size: (32.0, 18.0)                       │
│  Camera View (4.22 OrthoSize): (29.9, 16.8)     │
│  Status: ✓ 边界大于镜头视野                       │
│  ─────────────────────────────────────────────── │
│  [Preview Camera View in Scene]                  │
│  [自动调整 PolygonCollider2D 至最小安全尺寸]      │
└──────────────────────────────────────────────────┘
```

---

### 2.5 DamageSourceSO Inspector

**目标**：策划配置攻击参数时，即时预览伤害计算和属性。

```
┌─ DamageSourceSO ─────────────────────────────────┐
│  ◈ 伤害预览                                      │
│  BaseDamage × Multiplier = Final                 │
│       5     ×    1.0     =   5                  │
│  ◈ 击退预览                                      │
│  KnockbackForce: 8.0  Direction: →               │
│  HitStun: 0.30s                                  │
│  ◈ 属性标记                                      │
│  [CanBeParried ✓] [Unblockable ✗] [IgnoreIFrame ✗]│
│  ◈ 伤害类型                                      │
│  Type: Normal (物理)                             │
│  HitFxType: Slash                                │
└──────────────────────────────────────────────────┘
```

---

## 3. EditorWindow 工具列表

### 3.1 房间连接验证工具

**菜单路径**：`BaseGames > World > Room Connection Validator`

**功能**：

```
┌─ Room Connection Validator ──────────────────────────────────────┐
│  扫描所有 Room_*.unity 场景中的 RoomTransition 组件              │
│                                                                  │
│  房间                     出口ID           目标场景             │
│  ──────────────────────────────────────────────────────────────  │
│  Room_Forest_01       Door_To_Forest_02  ✓ Room_Forest_02 存在  │
│  Room_Forest_02       Door_To_Cave_01    ✓ Room_Cave_01 存在    │
│  Room_Cave_01         Door_To_Boss       ✗ Boss_Cave 不存在 ⚠  │
│                                                                  │
│  SpawnPoint 检查:                                                │
│  Room_Forest_02 缺少 SpawnPoint "SP_From_Forest_01_Door" ⚠     │
│                                                                  │
│  [重新扫描]   [选中有错误的场景]   [导出验证报告.md]             │
└──────────────────────────────────────────────────────────────────┘
```

---

### 3.2 SO 事件频道监视器

**菜单路径**：`BaseGames > Core > Event Channel Monitor`

**功能**：Play Mode 下实时监听所有 SO 事件频道的触发情况。

```
┌─ Event Channel Monitor ──────────────────────────────────────────┐
│  [▶ Play Mode Only]   [清除日志]   [暂停记录]                    │
│                                                                  │
│  时间      事件频道               数据                          │
│  ──────────────────────────────────────────────────────────────  │
│  0.012s    OnPlayerHPChanged      value: 8                      │
│  0.013s    OnHitConfirmed         DMG:5, Knockback:8.0          │
│  1.245s    OnParrySuccess         DMG:5, Flags: CanBeParried    │
│  1.248s    OnPlayerHPChanged      value: 8 (no change)          │
│  2.001s    OnRoomEntered          Transform: Room_Forest_01     │
│                                                                  │
│  [筛选频道: ___________]  [仅显示Player]  [仅显示Combat]        │
└──────────────────────────────────────────────────────────────────┘
```

---

### 3.3 NavSurface 快速烘焙工具

**菜单路径**：`BaseGames > Navigation > Quick Bake All Rooms`

一键遍历所有场景中的 `NavSurface`，按顺序烘焙 PathBerserker2d 导航网格并保存场景：

```
┌─ NavSurface Bake Tool ──────────────────────────────────────────┐
│  扫描到 NavSurface 数量: 12                                     │
│                                                                  │
│  Room_Forest_01: ✓ 已烘焙 (2024-01-01 12:00)                   │
│  Room_Forest_02: ⚠ 需要重新烘焙（场景已修改）                   │
│  Room_Cave_01:   ✓ 已烘焙                                      │
│                                                                  │
│  [烘焙全部]  [仅烘焙已修改]  [验证所有路径连通性]               │
└─────────────────────────────────────────────────────────────────┘
```

---

### 3.4 SaveData 查看器

**菜单路径**：`BaseGames > World > SaveData Viewer`

```
┌─ SaveData Viewer ───────────────────────────────────────────────┐
│  Slot 0  |  Slot 1  |  Slot 2                                  │
│  ─────────────────────────────────────────────────────────────  │
│  Player: HP 5/5 | Geo 340 | Soul 66/99                        │
│  Scene: Room_Forest_01 @ SP_Forest_01_Entry                    │
│  Abilities: Parry✓ DoubleJump✓ WallJump✗ Dash✗ Swim✗         │
│  Discovered: 3 rooms | Cleared: 1 | Bosses Defeated: 0        │
│  ─────────────────────────────────────────────────────────────  │
│  [JSON 原始视图]  [编辑并保存]  [删除此存档]                    │
└─────────────────────────────────────────────────────────────────┘
```

---

## 4. Scene 视图 Gizmos 汇总

| 组件 | Gizmo 形状 | 颜色 | 说明 |
|------|-----------|------|------|
| `HitBox` | BoxWire | 橙色（激活：实心50%透明）| 攻击判定区域 |
| `HurtBox` | BoxWire | 绿色（受击中：红色闪烁）| 受击区域 |
| `SpawnPoint` | 旗帜Icon + 文字 | 绿色 | 玩家出生点标识 |
| `RoomTransition` | 箭头 → 目标场景文字 | 蓝色 | 房间出口方向 |
| `RoomCameraBounds` | Polygon + 内层相机视野矩形 | 青色 | 镜头约束范围 |
| `EnemyBase` 检测范围 | 圆圈 | 黄色 | 玩家检测半径 |
| `EnemyBase` 攻击范围 | 圆圈 | 红色（实线）| 攻击触发范围 |
| `EnemyBase` 巡逻路径 | 线段 + 端点 | 蓝色虚线 | 巡逻 A~B 路径 |
| `EnemyBase` 寻路目标 | 箭头 | 绿色 | 当前导航目标 |
| `EnemyBase` 视线检测 | 射线 | 青色（遮挡：红色）| Raycast 视线 |
| `NavLink` | 弧形箭头 | 紫色 | 导航跳跃链接 |
| `HazardZone` | BoxWire | 红色（实心30%透明）| 危险区域范围 |
| `AbilityUnlock` | 星形Icon | 金色 | 能力解锁物件标识 |
| `SavePoint` | 旗帜Icon（已激活/未激活）| 蓝色/灰色 | 存档点状态 |
| `ParrySystem`（窗口中）| 圆圈动画 | 黄色 | 弹反窗口激活指示 |

---

## 5. Play Mode 调试叠加层

`DebugOverlayWindow`：按 F1 键（仅 Development Build 和 Editor 中）显示调试叠加层。

### 叠加层布局

```
┌─────────────────────────────────────────────────────────────────┐
│  [F1 关闭]                                   FPS: 144          │
│                                                                  │
│  Player State: RunState       HP: 8/10  Soul: 66  Geo: 340     │
│  IsGrounded: ✓   Facing: →   Invincible: ✗                     │
│                                                                  │
│  Active Camera: VCam_Explore  Blend: Complete                  │
│  Current Room: Room_Forest_01                                   │
│                                                                  │
│  Enemies in Scene: 2   Alive: 1   Dead: 1                      │
│                                                                  │
│  ─────────── 快捷键 ───────────────────────────────────────     │
│  F2 切换无敌  F3 加满 Soul  F4 下一检查点  F5 重新加载场景      │
│  F6 切换 Gizmos  F7 切换碰撞体显示  F8 切换 AI 暂停            │
└─────────────────────────────────────────────────────────────────┘
```

---

## 6. ContextMenu 工具

通过 Inspector 右键菜单（`[ContextMenu]`）调用，无需进入 Play Mode：

| 组件 | 右键菜单项 | 说明 |
|------|----------|------|
| `EnemyStatsSO` | `Print Stats Summary` | Console 打印该敌人完整属性表 |
| `DamageSourceSO` | `Calculate DPS` | Console 打印理论 DPS（BaseDamage / AttackCooldown）|
| `RoomCameraBounds` | `Fit to Room Tilemap` | 自动调整 PolygonCollider2D 以包裹 Tilemap 边界 |
| `NavSurface` | `Bake NavMesh` | 立即烘焙此 NavSurface |
| `SavePoint` | `Mark As Activated` | 设置 SavePoint 为已激活状态（用于测试继续游戏场景）|
| `RoomTransition` | `Validate Target Scene` | 检查目标场景是否存在于 BuildSettings |

---

## 7. 编辑器菜单结构

Unity 菜单栏 `BaseGames/` 下的所有工具入口：

```
BaseGames/
├── Core/
│   └── Event Channel Monitor          → EventChannelMonitorWindow
│
├── World/
│   ├── Room Connection Validator      → RoomConnectionValidatorWindow
│   ├── SaveData Viewer                → SaveDataViewerWindow
│   └── Rebuild All Spawn Points       → 扫描并重新生成 SpawnPoint ID 索引
│
├── Navigation/
│   ├── Quick Bake All Rooms           → NavSurfaceBakeTool
│   └── Validate Path Connectivity     → 检查所有房间 NavLink 连通性
│
├── Combat/
│   └── DPS Calculator                 → 输入 DamageSourceSO + AttackCooldown，输出 DPS 表格
│
└── Settings/
    ├── Open Project Layer Matrix      → 快速跳转到 ProjectSettings > Physics2D Layer Matrix
    └── Validate Assembly Definitions  → 检查 .asmdef 依赖关系是否符合零耦合原则
```

---

## 8. 自动化检查工具

### 场景验证检查（保存场景时自动运行）

`SceneValidationProcessor`（继承 `AssetModificationProcessor`），在保存场景时自动检查：

| 检查项 | 错误级别 | 说明 |
|--------|---------|------|
| 场景是否有 `RoomCameraBounds` | Warning | 遗漏镜头约束 |
| 场景是否有 `NavSurface` | Warning | 有敌人的场景必须有 NavSurface |
| 所有 `RoomTransition` 目标场景是否在 BuildSettings | Error | 目标场景不存在 |
| 所有 `HitBox` 是否有对应 `DamageSourceSO` | Error | 攻击参数未配置 |
| 所有 `EnemyBase` 是否有 `EnemyStatsSO` | Error | 敌人属性未配置 |

检查结果在 Console 窗口输出，并在 `Scene Validation` 浮窗中汇总。

### Assembly Definition 依赖校验

`BaseGames > Settings > Validate Assembly Definitions` 检查 `.asmdef` 是否遵循零耦合原则（如 `BaseGames.Player` 不应直接依赖 `BaseGames.Enemies`），输出依赖图 Mermaid 格式并在 Console 报警。

---

## 9. 高级工具集（补充）

### 9.1 Behavior Tree 验证器

`Tools > Zeling > BT Validator`（`BaseGames.Editor.BehaviorTreeValidator`）：

扫描 `Assets/` 下所有 Behavior Designer `.asset` 文件，检测：

| 检查项 | 级别 | 说明 |
|--------|------|------|
| 孤立节点（无父节点且非根）| Warning | 表示悬空的设计草稿节点 |
| 缺失 TaskName 的 Action/Condition | Error | 会导致 BD 无法编译 |
| SharedVariable 引用为空 | Warning | 运行时会 NullRef |
| Action 节点最大深度 > 12 | Warning | 过深 BT 建议拆分子树 |
| 同一 Agent 上同时存在多个 BehaviorTree 组件 | Error | 会互相覆盖 |

输出到 Console，双击跳转到对应 BD 资产。

### 9.2 进程流程图（Progression Flow Graph）

`Tools > Zeling > Progression Flow Graph`（EditorWindow）：

```
┌─ Progression Flow Graph ─────────────────────────────────────┐
│  [刷新]   [导出为 PNG]   [高亮未实现节点]                     │
│                                                               │
│  ┌Forest──────┐  ─击败SpiderGuard→  ┌Cave───────────────┐   │
│  │SP_Forest_01│                     │SP_Cave_01         │   │
│  │HP+2 Heart  │                     │WallJump Unlock    │   │
│  └────────────┘                     └───────────────────┘   │
│          │                                    │              │
│          └──────── 需要 Dash ─────────────────┘              │
└──────────────────────────────────────────────────────────────┘
```

- 自动读取所有 `ProgressLock`/`AbilityGate` SO 及 `BossProgressTracker` 配置
- 用 Bezier 曲线绘制依赖关系（红色=未解锁，绿色=已解锁）
- 右键节点 → "模拟解锁" → 在 Editor 中测试后续节点是否变绿

### 9.3 GameState 转换分析器

`Tools > Zeling > GameState Analyzer`（EditorWindow）：

- 列出 `GameManager` 中所有 `GameState` 枚举值
- 显示每个状态下：允许的输入 Action Map、哪些 SO 频道被监听
- 矩阵视图：行 = 事件频道，列 = 当前状态；标注"会触发"/"被忽略"
- 辅助排查"暂停状态下攻击事件仍被响应"等逻辑漏洞

### 9.4 伤害模拟器（Damage Simulator）

`DamageSourceSO` 右键菜单 → `Simulate Damage`，弹出快速面板：

```
┌─ Damage Simulator: DamageSource_PlayerAttack1 ──┐
│  目标防御:    0  [ ] 格  受伤类型: Normal       │
│  CharmBonus: × 1.5  + 12（剑尖魅力）           │
│  弱点:        × 1.0  [✓] 骑士弱点（十字架）    │
│  ─────────────────────────────────────────────  │
│  最终伤害:   14（基础 9 × 1.5 + 1 向上取整）   │
│  [运行 1000 次随机伤害分布图]                   │
└─────────────────────────────────────────────────┘
```

不需要进入 Play Mode 即可快速验证伤害数值设计。

### 9.5 地图贴图验证器（Map Texture Validator）

`Tools > Zeling > Map Texture Validator`：

- 读取 `MapRoomDataSO.roomOutlineTexture` 与对应场景的实际 Tilemap 边界
- 对比边界框是否对齐（允许 ± 1 tile 误差）
- 检测 Texture 是否以 `Read/Write` 导入（SetPixels 需要）
- 批量输出不匹配的房间列表 + 截图预览

### 9.6 音频导入预处理器（Audio Import Preprocessor）

`BaseGames.Editor.AudioImportPreprocessor`（继承 `AssetPostprocessor`）：

规则表（`AudioImportRulesSO`，可在 Inspector 配置）：

| 文件名前缀 | 平台 | 采样率 | 压缩格式 | Load Type |
|-----------|------|--------|---------|-----------|
| `BGM_`    | All  | 44100  | Vorbis（q=0.4）| Streaming |
| `SFX_`    | All  | 22050  | ADPCM  | CompressedInMemory |
| `AMB_`    | All  | 22050  | Vorbis（q=0.3）| Streaming |
| `Voice_`  | All  | 22050  | Vorbis（q=0.6）| CompressedInMemory |

导入音频时自动按文件名前缀应用对应设置，Console 输出 `[AudioPreprocessor] Applied: SFX rule → SFX_Player_Hurt.wav`。

### 9.7 装备预览工具（Equip Preview）

`Tools > Zeling > Equip Preview`（EditorWindow）：

```
┌─ Equip Preview ──────────────────────────────────────────────┐
│  选择魅力组合（最多 4 个槽位）:                               │
│  槽1: [剑之力量魅力  ▼]  槽2: [灵魂强化魅力  ▼]              │
│  槽3: [无             ]  槽4: [无             ]              │
│  ─────────────────────────────────────────────────────────  │
│  最终属性:                                                    │
│  攻击力:  9 × 1.5 = 13   法术消耗: 33 × 0.67 = 22           │
│  弹反 Soul: 10 → 10       法术弹数: 3 → 3                   │
│  路径成本: 4 个通知（EquipmentManager.Apply × 4）            │
│  [复制配置 JSON]   [应用到 Player（Play Mode）]              │
└──────────────────────────────────────────────────────────────┘
```

### 9.8 构建验证器（Build Validator）

`Tools > Zeling > Validate Build`，在正式打包前执行完整检测：

| 检测项 | 级别 |
|--------|------|
| 所有场景已加入 Build Settings | Error |
| 所有 `AudioImportRulesSO` 规则已应用 | Warning |
| 所有 `AnimationEventConfigSO` 无超出范围的事件时间 | Error |
| 所有 `AbilityGate` 引用的能力 ID 存在于 `AbilityType` 枚举 | Error |
| 所有 `LocalizationKeys` 常量在 zh-CN StringTable 中有对应条目 | Warning |
| Player Prefab 已注册为 Addressable（address = `"Player"`，不使用 `Resources/`）| Error |
| 所有 Addressable Group 无缺失引用（Missing Reference）| Error |
| `SaveData` JSON Schema 与当前字段一致（版本检查）| Warning |
| 构建目标平台 Build Target 与发布目标匹配 | Warning |

输出结果为 Build Validation Report（Text + 每项跳转链接），只有零 Error 才允许继续打包。