摄像机区域的架构改动

2026-05-15 14:47:24 +08:00
parent 1b37297585
commit f264329751
3591 changed files with 1687228 additions and 446503 deletions
--- a/Docs/EditorTools/00_EditorToolsPlan.md
+++ b/Docs/EditorTools/00_EditorToolsPlan.md
@@ -0,0 +1,523 @@
+# Editor Tools 规划方案
+
+> **版本**：1.0 · 2026-05  
+> **范围**：`Assets/_Game/Scripts/Editor/` 下所有编辑器扩展的全面规划  
+> **关联架构**：`Docs/Architecture/` 全集，重点 05/06/07/09/23  
+> **目标**：为策划、程序提供一套完整、一致、易维护的 Unity 编辑器工具体系
+
+---
+
+## 目录
+
+1. [技术选型：IMGUI vs UI Toolkit](#1-技术选型imgui-vs-ui-toolkit)
+2. [工具体系总览](#2-工具体系总览)
+3. [现有工具清单与评估](#3-现有工具清单与评估)
+4. [新增工具详细规划](#4-新增工具详细规划)
+5. [目录结构规范](#5-目录结构规范)
+6. [菜单结构规范](#6-菜单结构规范)
+7. [优先级与实施顺序](#7-优先级与实施顺序)
+8. [共用基础设施](#8-共用基础设施)
+
+---
+
+## 1. 技术选型：IMGUI vs UI Toolkit
+
+### 1.1 对比矩阵
+
+| 维度 | IMGUI | UI Toolkit |
+|------|-------|------------|
+| 开发速度（简单工具） | ✅ 快，代码即布局 | 🟡 需 UXML + USS + C# |
+| 性能（大量列表/刷新） | 🔴 每帧重绘全部 | ✅ 虚拟化列表，增量刷新 |
+| 分栏/停靠布局 | 🟡 手动计算 Rect | ✅ `TwoPaneSplitView` 内置 |
+| 运行时数据绑定 | 🔴 不支持 | ✅ `INotifyValueChanged` |
+| 属性绘制（SerializedObject） | ✅ `PropertyField` 直接用 | 🟡 `BindProperty()` 额外步骤 |
+| Play Mode 实时刷新 | 🟡 依赖 `Repaint()` | ✅ 事件驱动 |
+| 现有代码库一致性 | ✅ 全部现有工具使用 | 🟡 新引入 |
+| Unity 版本要求 | 任意 | Unity 2022+ ✅（项目已满足）|
+
+### 1.2 决策结论
+
+**按工具类型分策略**，不做全局迁移：
+
+| 工具类别 | 推荐技术 | 原因 |
+|---------|---------|------|
+| 运行时调试监视器（EventBusMonitor、PlayModeOverlay） | **IMGUI** | 每帧刷新，状态简单，IMGUI 够用且响应快 |
+| 简单属性绘制器（PropertyDrawer、CustomEditor） | **IMGUI** | `PropertyField` + `EditorGUI` 即可，无需 UXML |
+| 验收工具（VerificationHelperWindow） | **IMGUI** | 已有，稳定，无改造价值 |
+| 一次性脚手架工具（SceneScaffoldTools） | **IMGUI MenuItems** | 无窗口 UI，只是菜单触发 |
+| 数据浏览 + 编辑窗口（武器/技能/敌人/护符） | **UI Toolkit** | 分栏布局、可搜索列表、大量字段，UI Toolkit 优势明显 |
+| Dashboard 总入口 | **UI Toolkit** | 模块导航卡片，视觉丰富 |
+| Boss 技能序列可视化 | **IMGUI**（现有保留） | 甘特图自绘，IMGUI Rect 更直接 |
+
+---
+
+## 2. 工具体系总览
+
+按功能分为五大类：
+
+```
+A. 数据管理窗口     — 浏览 / 创建 / 编辑 ScriptableObject 资产
+B. Prefab 配置工具  — 武器 / 技能 / 敌人 HitBox Prefab 结构验证与快速搭建
+C. 场景工具         — 场景脚手架、World 物体快速放置
+D. 运行时调试工具   — Play Mode 下数据监视 / 状态覆写
+E. 验收 / 构建工具  — SO 合法性校验、构建前检查、Physics2D 矩阵
+```
+
+---
+
+## 3. 现有工具清单与评估
+
+### 3.1 保留不变（Stable）
+
+| 文件 | 类型 | 菜单路径 | 状态 |
+|------|------|----------|------|
+| `Verification/VerificationHelperWindow.cs` | IMGUI Window | `BaseGames/Verification/Open Verification Helper` | ✅ 保留 |
+| `Verification/Physics2DLayerReport.cs` | IMGUI MenuItem | `BaseGames/Verification/Check|Fix Physics2D Layer Matrix` | ✅ 保留 |
+| `Verification/ExtraScaffoldExtensions.cs` | IMGUI MenuItems | `BaseGames/Verification/Scaffold/…` | ✅ 保留 |
+| `Verification/PlayModeDebugOverlay.cs` | IMGUI Overlay | Play Mode UI | ✅ 保留 |
+| `EventBusMonitorWindow.cs` | IMGUI Window | `BaseGames/Tools/Event Bus Monitor` | ✅ 保留 |
+| `EventChainEditorWindow.cs` | IMGUI Window | `BaseGames/Tools/Event Chain Viewer` | ✅ 保留 |
+| `BossSkillSequenceWindow.cs` | IMGUI Window | `BaseGames/Tools/Boss Skill Sequence Viewer` | ✅ 保留 |
+| `AddressReferenceGraphWindow.cs` | IMGUI Window | `BaseGames/Tools/Asset Reference Graph` | ✅ 保留 |
+| `AddressableBatchTool.cs` | IMGUI MenuItem | — | ✅ 保留 |
+| `AddressKeyValidator.cs` | Build Preprocessor | — | ✅ 保留 |
+| `NavSurfaceBakeShortcut.cs` | MenuItem | — | ✅ 保留 |
+| `ScriptExecutionOrderTools.cs` | MenuItem | — | ✅ 保留 |
+| `SceneScaffoldTools.cs` | IMGUI MenuItem | `BaseGames/Scene/…` | ✅ 保留（已更新 WeaponSocket）|
+| `Validation/SOValidationRunner.cs` | Build Preprocessor + MenuItem | `Tools/Validate All ScriptableObjects` | ✅ 保留 |
+| `Equipment/CharmEffectDrawer.cs` | IMGUI CustomEditor | Inspector | ✅ 保留 |
+| `Combat/HurtBoxEditor.cs` | IMGUI CustomEditor | Inspector | ✅ 保留 |
+| `Map/MapRoomDataEditor.cs` | IMGUI CustomEditor | Inspector | ✅ 保留 |
+| `World/DestructibleTileEditor.cs` | IMGUI CustomEditor | Inspector | ✅ 保留 |
+| `Achievements/AchievementSOEditor.cs` | IMGUI CustomEditor | Inspector | ✅ 保留 |
+
+### 3.2 待改造（Migrate）
+
+| 文件 | 问题 | 建议 |
+|------|------|------|
+| `CreateTestAssets.cs` | 硬编码文件路径和资产名，缺乏可配置性 | 保留 MenuItem 逻辑，抽取配置到 SO |
+| `CreateEventChannelAssets.cs` | 功能可并入新 Dashboard | 长期合并 |
+| `EventChannelEditor.cs` / `EventConfigEditor.cs` | 独立 Inspector 扩展，无窗口化需求 | 保留但评估是否并入 Dashboard |
+
+---
+
+## 4. 新增工具详细规划
+
+### W-01 · BaseGames Dashboard（总入口）
+
+**文件**：`Editor/Dashboard/EditorDashboardWindow.cs`  
+**技术**：UI Toolkit  
+**菜单**：`BaseGames/Open Dashboard (Ctrl+Shift+D)`  
+**优先级**：P2（其他窗口完成后汇总入口）
+
+**功能**：
+- 模块导航卡片（Combat / Player / Enemy / Equipment / World / Tools）
+- 每个卡片点击打开对应数据管理窗口
+- 快速链接：Scene Scaffold、Validation Runner、Verification Helper
+- 状态摘要：当前场景资产统计、未完成 SO 验证警告数
+
+---
+
+### W-02 · Weapon Editor（武器编辑器）
+
+**文件**：`Editor/Combat/WeaponEditorWindow.cs`  
+**技术**：UI Toolkit（`TwoPaneSplitView`）  
+**菜单**：`BaseGames/Data/Weapon Editor`  
+**优先级**：**P1**（武器 HitBox 动态化后，数据创建频率增高）
+
+**布局**：
+```
+┌────────────────┬──────────────────────────────────────────┐
+│ [搜索框]       │  [WeaponType 标签] Weapon_SkyBlade       │
+│ ──────────     │  ──────────────────────────────────────── │
+│ ■ SkyBlade     │  基础信息     weaponId / displayName …   │
+│ ■ EarthHammer  │  ──────────                              │
+│ ■ LifeScythe   │  连击动画     attack1Clip … downAttackClip│
+│ + [新建]       │  ──────────                              │
+│                │  伤害来源     attack1Source … ×6         │
+│                │  ──────────                              │
+│                │  HitBox Prefab [对象字段]  [定位 Prefab]  │
+│                │  ──────────                              │
+│                │  战斗参数     soulPowerGain / weaponType  │
+│                │  武器特效     VFXConfig 折叠面板          │
+└────────────────┴──────────────────────────────────────────┘
+```
+
+**特有功能**：
+- **HitBox Prefab 验证**：检查引用 Prefab 是否包含 `WeaponHitBoxInstance` 组件，否则显示警告  
+- **伤害来源快速新建**：每个 `DamageSourceSO` 字段旁放 [Create] 按钮，自动命名 `DSrc_{weaponId}_{segment}` 并存入 `Assets/_Game/Data/Combat/DamageSources/`  
+- **连击链预览**：显示 attack1→attack2→attack3 的 Clip 名称 + BaseDamage 数值序列
+
+---
+
+### W-03 · Skill Editor（技能编辑器）
+
+**文件**：`Editor/Skills/SkillEditorWindow.cs`  
+**技术**：UI Toolkit  
+**菜单**：`BaseGames/Data/Skill Editor`  
+**优先级**：**P1**
+
+**布局**：与 W-02 类似的双栏结构
+
+**左栏**：
+- 按 `SkillEffectType` 分组（MeleeAoE / Projectile / BarrierAura / …）
+- 搜索框（按 skillId / displayNameKey 过滤）
+
+**右栏**：
+- Identity / Resource / Animation / Effect / Projectile / Explosion / Feedback 分区折叠面板  
+- `SkillHitBoxPrefab` 字段：若非空，显示 Prefab 结构预览（`SkillHitBoxInstance` 子节点个数 + HitBox 列表）
+
+**特有功能**：
+- **冷却 / 消耗平衡表**：底部浮动 Panel，以表格展示所有技能的 `baseCost` / `cooldown` 对比，辅助策划平衡调整
+- **HitBox Prefab 快速创建向导**：填写 skillId → 自动生成 `SKL_{skillId}_HitBox.prefab` 骨架（含 `SkillHitBoxInstance` + 子节点 HitBox GO）
+
+---
+
+### W-04 · Form & Weapon Assignment（形态-武器-技能关联）
+
+**文件**：`Editor/Player/FormEditorWindow.cs`  
+**技术**：UI Toolkit  
+**菜单**：`BaseGames/Data/Form Editor`  
+**优先级**：P2
+
+**布局**：三列
+```
+[FormSO 列表] → [当前形态详情] → [技能/武器预览面板]
+```
+
+**功能**：
+- 显示所有 `FormSO`，点击进入详情  
+- 详情显示：`defaultWeapon`（链接到 W-02）、`soulSkill` / `spirit1` / `spirit2`（链接到 W-03）  
+- 矩阵视图：所有形态 × 三个技能槽的全局总览（快速发现空槽）
+
+---
+
+### W-05 · Enemy Data Manager（敌人数据管理器）
+
+**文件**：`Editor/Enemies/EnemyDataWindow.cs`  
+**技术**：UI Toolkit  
+**菜单**：`BaseGames/Data/Enemy Data Manager`  
+**优先级**：**P1**（敌人设计是高频迭代内容）
+
+**布局**：双栏，左侧 `ListView`（支持搜索 + 按 EnemyType 过滤）
+
+**右栏分页**：
+- **Stats**：`EnemyStatsSO` 全字段（MaxHP / Attack / Defense / Speed / …）  
+- **Loot**：`LootTableSO` 条目列表（itemId / weight / minCount / maxCount）可增删  
+- **Boss**：若为 Boss，显示关联 `BossSkillSO` 列表（链接 BossSkillSequenceWindow）  
+- **Prefab**：关联 Prefab 路径 + 结构验证（HurtBox Layer、EnemyBase、HitBox 等）
+
+**特有功能**：
+- **数值对比面板**：勾选多个敌人，弹出雷达图（HP / ATK / DEF / SPD）对比
+- **快速克隆**：从选中 `EnemyStatsSO` 克隆变体（命名 `EnemyStats_{name}_Elite`）
+
+---
+
+### W-06 · Charm Catalog Manager（护符目录管理器）
+
+**文件**：`Editor/Equipment/CharmCatalogWindow.cs`  
+**技术**：UI Toolkit  
+**菜单**：`BaseGames/Data/Charm Catalog`  
+**优先级**：P2
+
+**布局**：双栏
+
+**左栏**：护符列表，按 `notchCost` / Effect 类型过滤  
+**右栏**：护符详情
+- `notchCost` / `icon` / `displayNameKey`  
+- Effects 列表（沿用现有 `CharmEffectDrawer` 逻辑，移植为 UI Toolkit `BindableElement`）  
+- 效果描述预览（调用 `GetEffectDescription()`）
+
+**特有功能**：
+- **Notch 平衡面板**：饼图展示当前所有护符 notchCost 分布
+- **效果类型矩阵**：护符 × 效果类型的覆盖矩阵，发现重复/空缺
+
+---
+
+### W-07 · Prefab Structure Validator（Prefab 结构验证器）
+
+**文件**：`Editor/Prefabs/PrefabValidatorWindow.cs`  
+**技术**：IMGUI（简单列表，无复杂布局需求）  
+**菜单**：`BaseGames/Tools/Prefab Structure Validator`  
+**优先级**：P2
+
+**功能**：扫描以下 Prefab 命名规范并验证结构完整性：
+
+| Prefab 类型 | 命名规范 | 必须包含组件 |
+|------------|---------|------------|
+| 武器 HitBox | `WPN_{weaponId}_HitBox` | `WeaponHitBoxInstance` + ≥1 `HitBox` |
+| 技能 HitBox | `SKL_{skillId}_HitBox` | `SkillHitBoxInstance` + ≥1 `HitBox` |
+| 玩家 | `PLY_Player` | `PlayerController` `WeaponManager._weaponSocket` 非空 |
+| 敌人 | `ENM_*` | `EnemyBase` `HurtBox`（Layer=EnemyHurtBox）|
+| 投射物 | `PRJ_*` | `Projectile` `Collider2D`（IsTrigger）|
+
+**输出**：Console 日志 + 窗口内可点击跳转的错误列表
+
+---
+
+### W-08 · Interactable Scene Helper（场景交互物配置助手）
+
+**文件**：`Editor/World/InteractableSceneHelper.cs`  
+**技术**：IMGUI（Scene View 工具栏扩展 + 小窗口）  
+**菜单**：`BaseGames/Scene/Interactable Helper`  
+**优先级**：P3
+
+**功能**：
+- 在 Scene View 工具栏添加快速放置按钮：SavePoint / RoomTransition / HazardZone / Collectible / DestructibleTile / MovingPlatform / AbilityUnlock  
+- 放置时自动设置 Layer、添加必要子节点、绑定默认事件频道  
+- 复用 `SceneScaffoldTools` 中的 `GetOrAddComponent` / `SetLayer` 私有方法（提取为 `EditorScaffoldUtils` 公共静态类）
+
+---
+
+### W-09 · DamageSource Inspector 增强
+
+**文件**：`Editor/Combat/DamageSourceInspector.cs`  
+**技术**：IMGUI CustomEditor  
+**优先级**：P2
+
+**功能**：
+- 在 `DamageSourceSO` Inspector 底部添加**伤害预览区**：
+  - 显示 `FinalDamage ≈ BaseDamage × DamageMultiplier`（含示例防御减免）
+  - `DamageFlags` / `DamageTags` 用枚举 Toggle 组显示，替代默认位掩码数字
+- `BreakLevel` 字段以颜色编码标签显示（None=灰 / Light=绿 / Medium=蓝 / Heavy=橙 / Breaker=红）
+
+---
+
+### W-10 · WeaponHitBox Prefab 快速创建向导
+
+**文件**：`Editor/Combat/WeaponHitBoxWizard.cs`  
+**技术**：IMGUI `ScriptableWizard`  
+**菜单**：`BaseGames/Create/Weapon HitBox Prefab`  
+**优先级**：**P1**（与 WeaponSO 动态化改造配套）
+
+**流程**：
+1. 输入 `weaponId`（如 `SkyBlade`）
+2. 勾选需要的攻击方向（Ground / Up / Down / Air）
+3. 为每个方向选择 Collider 类型（Box / Capsule / Polygon）和初始尺寸
+4. 点击「创建」→ 在 `Assets/Prefabs/Weapons/` 下生成：
+   ```
+   WPN_SkyBlade_HitBox.prefab
+   └── [HitBox_Ground]   BoxCollider2D(IsTrigger) + HitBox.cs  Layer=PlayerHitBox
+   └── [HitBox_Up]       …
+   └── [HitBox_Down]     …
+   └── [HitBox_Air]      …
+       WeaponHitBoxInstance.cs（挂在根节点，SerializeField 自动赋值）
+   ```
+5. 自动 Ping 创建的 Prefab 并选中
+
+---
+
+### W-11 · SkillHitBox Prefab 快速创建向导
+
+**文件**：`Editor/Skills/SkillHitBoxWizard.cs`  
+**技术**：IMGUI `ScriptableWizard`  
+**菜单**：`BaseGames/Create/Skill HitBox Prefab`  
+**优先级**：**P1**
+
+与 W-10 类似，生成：
+```
+SKL_{skillId}_HitBox.prefab
+└── [HitBox_0]  PolygonCollider2D(IsTrigger) + HitBox.cs  Layer=PlayerHitBox
+    SkillHitBoxInstance.cs（根节点，_hitBoxes 自动赋值）
+```
+
+---
+
+## 5. 目录结构规范
+
+```
+Assets/_Game/Scripts/Editor/
+│
+├── BaseGames.Editor.asmdef
+│
+├── Dashboard/
+│   └── EditorDashboardWindow.cs          [新增 W-01] UI Toolkit
+│
+├── Combat/
+│   ├── HurtBoxEditor.cs                  [现有]
+│   ├── DamageSourceInspector.cs          [新增 W-09] IMGUI CustomEditor
+│   ├── WeaponEditorWindow.cs             [新增 W-02] UI Toolkit
+│   └── WeaponHitBoxWizard.cs             [新增 W-10] IMGUI Wizard
+│
+├── Skills/
+│   ├── SkillEditorWindow.cs              [新增 W-03] UI Toolkit
+│   └── SkillHitBoxWizard.cs              [新增 W-11] IMGUI Wizard
+│
+├── Player/
+│   └── FormEditorWindow.cs               [新增 W-04] UI Toolkit
+│
+├── Enemies/
+│   └── EnemyDataWindow.cs                [新增 W-05] UI Toolkit
+│
+├── Equipment/
+│   ├── CharmEffectDrawer.cs              [现有]
+│   └── CharmCatalogWindow.cs             [新增 W-06] UI Toolkit
+│
+├── Prefabs/
+│   └── PrefabValidatorWindow.cs          [新增 W-07] IMGUI
+│
+├── World/
+│   ├── DestructibleTileEditor.cs         [现有]
+│   └── InteractableSceneHelper.cs        [新增 W-08] IMGUI
+│
+├── Map/
+│   └── MapRoomDataEditor.cs              [现有]
+│
+├── Achievements/
+│   └── AchievementSOEditor.cs            [现有]
+│
+├── Validation/
+│   └── SOValidationRunner.cs             [现有]
+│
+├── Verification/
+│   ├── VerificationHelperWindow.cs       [现有]
+│   ├── ExtraScaffoldExtensions.cs        [现有]
+│   ├── Physics2DLayerReport.cs           [现有]
+│   └── PlayModeDebugOverlay.cs           [现有]
+│
+├── Shared/
+│   │   ← 跨窗口复用的基础设施
+│   ├── EditorScaffoldUtils.cs            [新增] SceneScaffoldTools 公共工具提取
+│   └── EditorWindowBase.cs              [新增] 统一 OnEnable/OnGUI 基类（UI Toolkit 窗口）
+│
+└── UIToolkit/
+    ├── Editor.uss                        [新增] 统一样式表
+    └── Layouts/
+        ├── TwoPaneWindow.uxml            [新增] 标准双栏布局模板
+        └── AssetListItem.uxml            [新增] 资产列表行模板
+```
+
+---
+
+## 6. 菜单结构规范
+
+```
+BaseGames/
+├── Open Dashboard     (Ctrl+Shift+D)          W-01
+│
+├── Data/
+│   ├── Weapon Editor                          W-02
+│   ├── Skill Editor                           W-03
+│   ├── Form Editor                            W-04
+│   ├── Enemy Data Manager                     W-05
+│   └── Charm Catalog                          W-06
+│
+├── Create/
+│   ├── Weapon HitBox Prefab                   W-10
+│   └── Skill HitBox Prefab                    W-11
+│
+├── Scene/
+│   ├── Scaffold Persistent Scene              (现有)
+│   ├── Scaffold Test Room                     (现有)
+│   └── Interactable Helper                    W-08
+│
+├── Tools/
+│   ├── Event Bus Monitor  (Ctrl+Shift+E)      (现有)
+│   ├── Event Chain Viewer                     (现有)
+│   ├── Boss Skill Sequence Viewer             (现有)
+│   ├── Asset Reference Graph                  (现有)
+│   ├── Prefab Structure Validator             W-07
+│   └── Create Test Assets                     (现有)
+│
+└── Verification/
+    ├── Open Verification Helper (Ctrl+Shift+V)(现有)
+    ├── Check Physics2D Layer Matrix            (现有)
+    ├── Fix Physics2D Layer Matrix              (现有)
+    └── Scaffold/…                              (现有)
+```
+
+---
+
+## 7. 优先级与实施顺序
+
+### P1 — 配套当前架构改动，立即需要
+
+| ID | 名称 | 关联改动 | 工作量估计 |
+|----|------|---------|----------|
+| W-10 | WeaponHitBox Prefab 向导 | WeaponSO.hitBoxPrefab 动态化 | S（0.5d）|
+| W-11 | SkillHitBox Prefab 向导 | SkillHitBoxPrefab 已有字段 | S（0.5d）|
+| W-02 | Weapon Editor 窗口 | WeaponSO 字段增多 | M（2d）|
+| W-03 | Skill Editor 窗口 | FormSkillSO 字段多 | M（2d）|
+| W-05 | Enemy Data Manager | 高频策划迭代 | M（2d）|
+| W-09 | DamageSource Inspector 增强 | DamageSourceSO 易配错 | S（0.5d）|
+
+### P2 — 生产力提升，下一迭代
+
+| ID | 名称 | 工作量估计 |
+|----|------|----------|
+| W-07 | Prefab 结构验证器 | S（1d）|
+| W-04 | Form Editor | S（1d）|
+| W-06 | Charm Catalog 管理器 | M（1.5d）|
+
+### P3 — 长期完善
+
+| ID | 名称 | 工作量估计 |
+|----|------|----------|
+| W-08 | 场景交互物助手 | M（2d）|
+| W-01 | Dashboard 总入口 | M（2d）|
+
+---
+
+## 8. 共用基础设施
+
+### 8.1 EditorScaffoldUtils（从 SceneScaffoldTools 提取）
+
+将 `SceneScaffoldTools.cs` 中的私有静态方法提取为独立公共类：
+
+```csharp
+// Editor/Shared/EditorScaffoldUtils.cs
+namespace BaseGames.Editor
+{
+    public static class EditorScaffoldUtils
+    {
+        public static Transform    GetOrCreateChild(Transform parent, string name);
+        public static T            GetOrAddComponent<T>(GameObject go) where T : Component;
+        public static void         SetLayer(GameObject go, string layerName, List<string> report);
+        public static void         AssignReference(Object target, string field, Object value, List<string> report = null);
+        public static void         AssignAsset<T>(Object target, string field, List<string> report,
+                                                   bool required, string assetNameHint) where T : Object;
+        public static void         MarkDirtyAndLog(string scaffoldName, Object root, List<string> report);
+    }
+}
+```
+
+> `SceneScaffoldTools` 和 `ExtraScaffoldExtensions` 改为调用此工具类，消除重复代码（当前 `ExtraScaffoldExtensions` 注释"镜像 SceneScaffoldTools 中的 private 静态方法"即为此痛点）。
+
+### 8.2 UI Toolkit 统一样式
+
+`Editor/UIToolkit/Editor.uss`：
+```css
+/* 标准分区标题 */
+.section-header { font-size: 11px; -unity-font-style: bold; margin-top: 8px; }
+
+/* 警告行 */
+.row-warning { background-color: rgba(220, 150, 0, 0.15); }
+.row-error   { background-color: rgba(220, 50,  50, 0.15); }
+
+/* 列表项高亮 */
+.list-item:hover { background-color: rgba(255,255,255,0.05); }
+```
+
+### 8.3 SO 创建辅助
+
+所有数据窗口的「新建」按钮使用统一签名：
+
+```csharp
+// 返回创建的资产路径；已存在时返回 null（不覆盖）
+public static T CreateSOAsset<T>(string folder, string assetName) where T : ScriptableObject
+{
+    string dir  = $"Assets/_Game/Data/{folder}";
+    string path = $"{dir}/{assetName}.asset";
+    if (AssetDatabase.LoadAssetAtPath<T>(path) != null) return null;
+    Directory.CreateDirectory(Path.Combine(Application.dataPath, $"../{dir}"));
+    var asset = ScriptableObject.CreateInstance<T>();
+    AssetDatabase.CreateAsset(asset, path);
+    AssetDatabase.SaveAssets();
+    EditorGUIUtility.PingObject(asset);
+    return asset;
+}
+```
+
+---
+
+*文档维护：每次新增或修改 Editor 工具后，同步更新本文档的「现有工具清单」表格。*