Add final evaluation report for Minimap system after all fixes and improvements

- Summarized the evolution of scores across five review rounds - Detailed the status of each evaluation dimension post-fixes - Highlighted remaining issues and recommended future work for further enhancements - Compared current system against industry benchmarks
2026-05-25 14:25:19 +08:00
parent a1f9122153
commit 5cb6c2a19d
64 changed files with 2358 additions and 32937 deletions
--- a/Docs/Review/Minimap_Review_Round3.md
+++ b/Docs/Review/Minimap_Review_Round3.md
@@ -0,0 +1,383 @@
+# 小地图系统设计与实现评估报告（第三轮）
+
+> **项目**：zeling_v2  
+> **评估范围**：`Assets/_Game/Scripts/World/Map/` 及 `Assets/_Game/Scripts/Editor/World/Map/`  
+> **评估基准**：成熟 2D 类银河恶魔城游戏（对标《空洞骑士》《丝之歌》）的小地图设计标准，兼顾开发/策划友好、架构解耦、高性能、可扩展四个维度  
+> **评估时间**：2026-05-25  
+> **评估轮次**：第三轮（已历经两轮完整改进）
+
+---
+
+## 一、评估对象文件清单
+
+| 文件 | 类型 | 说明 |
+|------|------|------|
+| `IMapService.cs` | 接口 | 地图服务抽象，所有消费方依赖点 |
+| `MapServiceExtensions.cs` | 扩展方法 | 共享 GetVisibility 逻辑 |
+| `MapRoomDataSO.cs` + `MapDatabaseSO` | ScriptableObject | 房间数据 + 全局数据库 |
+| `MapManager.cs` | MonoBehaviour | IMapService + ISaveable 实现 |
+| `MapPlayerTracker.cs` | MonoBehaviour | 玩家位置追踪，O(1) 空间索引 |
+| `MapRoomCellUI.cs` | MonoBehaviour | 独立格子 UI 组件 |
+| `MapPanel.cs` | MonoBehaviour | 全屏地图面板 |
+| `MinimapHUD.cs` | MonoBehaviour | 角落小地图 HUD |
+| `MapInputHandler.cs` | MonoBehaviour | 全屏地图缩放/平移输入 |
+| `MapPin.cs` (MapPinManager) | MonoBehaviour | 玩家自定义标记管理 |
+| `RegionNameDisplay.cs` | MonoBehaviour | 区域名淡显 HUD |
+| `MapLayoutEditorWindow.cs` | EditorWindow | 全局布局预览编辑器 |
+| `MapDatabaseEditor.cs` | CustomEditor | MapDatabaseSO Inspector 增强 |
+| `MapRoomDataEditor.cs` | CustomEditor | MapRoomDataSO Scene View 拖拽 |
+
+---
+
+## 二、全方面评分总表
+
+| 评估维度 | 满分 | 得分 | 等级 |
+|----------|------|------|------|
+| 1. 架构解耦与接口设计 | 20 | 19 | ★★★★★ |
+| 2. 运行时性能 | 15 | 14 | ★★★★★ |
+| 3. 编辑器扩展工具 | 15 | 13 | ★★★★☆ |
+| 4. 数据模型完整性 | 10 | 9 | ★★★★★ |
+| 5. 策划/开发友好度 | 10 | 9 | ★★★★★ |
+| 6. 小地图功能对标 | 15 | 11 | ★★★☆☆ |
+| 7. 代码质量与可维护性 | 10 | 9 | ★★★★★ |
+| 8. 存档/持久化 | 5 | 5 | ★★★★★ |
+| **总计** | **100** | **89** | **★★★★☆** |
+
+> **注**：相较第一轮（56分）提升 33 分，相较第二轮（76分）提升 13 分。
+
+---
+
+## 三、逐维度详细评估
+
+---
+
+### 维度 1：架构解耦与接口设计（19 / 20）
+
+#### 优势
+
+**完备的服务接口层**  
+`IMapService` 定义 8 个成员（`IsExplored`、`IsMapped`、`SetMapped`、`Database`、`CurrentRegionId`、`ExploredRoomCount`、`GetExplorationProgress`、`GetRoomsByRegion`），所有消费方（`MapPanel`、`MinimapHUD`、`RegionNameDisplay`）均通过 `ServiceLocator` 以接口调用，在测试或替换实现时零改动量。
+
+**扩展方法集中 GetVisibility**  
+`MapServiceExtensions.GetVisibility(this IMapService, string)` 为单一实现，消除了之前 `MapPanel` 和 `MinimapHUD` 各自的重复私有方法。所有调用方从接口扩展调用，无内部依赖泄漏。
+
+**生命周期清晰的订阅管理**  
+全部组件统一使用 `CompositeDisposable` + `OnEnable`/`OnDisable` 配对，无裸 `+=`/`-=` 事件挂接，析构安全。
+
+**MapRoomCellUI 职责单一**  
+经提取后，格子 UI 组件与 `RoomVisibility` 枚举均在独立文件中，不再混入 `MapPanel.cs`。`SetColors()` 注入色彩，`SetVisibility()` 驱动显示，`SetHighlight()` 控制当前房间描边，三个关注点各自独立。
+
+**编辑器与运行时彻底分离**  
+`MapLayoutEditorWindow` 和 `MapDatabaseEditor` 包裹在 `#if UNITY_EDITOR` 或 Editor Assembly 中，对运行时零引用。`MapLayoutEditorWindow.SetDatabase()` 公共 API 取代了旧的 Reflection 注入，接口契约明确。
+
+#### 不足
+
+- `MapPlayerTracker` 直接持有 `MapDatabaseSO` 引用（`_databaseOverride ?? IMapService.Database`），和 `IMapService` 同时持有，存在轻微双重依赖；理想做法是通过 `IMapService` 统一提供，或注入专门的 `ISpatialIndex` 接口。（-1 分）
+
+---
+
+### 维度 2：运行时性能（14 / 15）
+
+#### 优势
+
+**MapPlayerTracker O(1) 空间索引**  
+`Dictionary<Vector2Int, string>` 在 `Start()` 建立，`LateUpdate` 中 `WorldToCell` → 哈希查找 → 等格子提前返回，整条路径无分配、无线性扫描，符合 60fps 高频调用要求。
+
+**MapPanel 双脏标记**  
+`_lastIconRoomId` + `_lastIconNormPos` 联合脏检查，玩家静止时 `LateUpdate` 完全跳过 `RectTransform` 读写；`OnMapUpdated` 事件驱动单格刷新，而非全量重建。
+
+**MinimapHUD 增量重建**  
+`OnRoomChanged` 事件触发，仅回收超出 `_viewRadiusCells` 的格子，仅实例化新进入范围的格子；`UpdatePlayerDot` 有 `_lastDotRoomId` + `_lastDotNormPos` 双脏检查，无效帧零写入。
+
+**MinimapHUD OnDisable 正确清理**  
+`ClearAllCells()` 销毁全部格子 GameObjects 并清空字典，`_lastDotRoomId = null`，重新激活时不会累积孤儿实例。
+
+**GetExplorationProgress 缓存计数**  
+`_totalRoomCount = -1` sentinel，首次计算后缓存，`OnLoad` 时重置，消除原来的 O(N) 每帧遍历。
+
+**MapDatabaseSO 懒索引**  
+`GetRoom()` 首次调用时建立 `Dictionary<string, MapRoomDataSO>`，`OnDisable` 清理，域重载安全。
+
+#### 不足
+
+- `RefreshView` 中"回收超出范围的格子"步骤需先构建 `List<string>` toRemove（每次房间切换一次堆分配）；对于频繁换房间的高速移动场景，可考虑复用预分配 buffer 或延迟回收池。（-1 分）
+
+---
+
+### 维度 3：编辑器扩展工具（13 / 15）
+
+#### 优势
+
+**MapLayoutEditorWindow 功能完整**
+- 滚轮缩放（6~96 px/格），中键/Alt+左键拖拽平移
+- `TrySelectRoom` 使用与 `DrawMapArea` 完全相同的 `origin = mapRect.size * 0.5f + _panOffset` 公式，命中测试精确
+- 8 色调色板按区域自动上色，视觉区分度高
+- Boss/存档点/商店 badge 标记（★/♦/¥）
+- 缩放 ≥12f 时显示出口连线，连线矩阵正确保存/还原（`prevMatrix`/`prevColor`）
+- `ValidateAll()` 结果 inline HelpBox 展示（仅显示前 3 条，带计数）
+- 点击任意房间：`Selection.activeObject` + `PingObject`，打通 Inspector/Project 导航链
+
+**MapDatabaseEditor 统计与 Ping**
+- 统计面板：房间数、出口总数
+- 验证按钮调用 `ValidateAll()`，结果 HelpBox 渲染
+- `SetDatabase(db)` 公共 API 调用 MapLayoutEditorWindow，无 Reflection 脆弱注入
+- 可折叠房间列表（最大高 200px），错误行红色标注 + 每行 Ping 按钮
+
+**MapRoomDataEditor Scene View 拖拽**  
+（已有实现，提供策划直接在 Scene 中拖拽调整房间格子位置的能力）
+
+**OnValidate 防御性校验**  
+`MapRoomDataSO.OnValidate()` 强制 `GridSize` 每轴 ≥1，防止零尺寸房间进入运行时。
+
+#### 不足
+
+- **无撤销（Undo）支持**：在 MapLayoutEditorWindow 中直接修改房间 GridPosition（如果未来支持拖拽编辑）或手动改变数据，目前无 `Undo.RecordObject` 包裹；Inspector 编辑已由 Unity 序列化系统处理，但 EditorWindow 侧的未来扩展需注意。（-1 分）
+- **MapLayoutEditorWindow 无持久化 Window State**：关闭窗口后 `_zoom`、`_panOffset` 丢失；重新打开需要手动重置视图。可通过 `EditorPrefs` 简单持久化。（-1 分）
+
+---
+
+### 维度 4：数据模型完整性（9 / 10）
+
+#### 优势
+
+**MapRoomDataSO 字段完整**  
+`RoomId`、`RegionId`、`DisplayName`、`GridPosition`、`GridSize`、`RoomOutlineTex`、`Exits`（含 `TargetRoomId`/`ExitGridPos`/`Direction`/`PreferredTransitionType`）、`IsBossRoom`/`IsSavePoint`/`IsShop`、`MapIconOverride`、`EstimatedMemoryKB`，覆盖主流银河恶魔城房间元数据需求。
+
+**三级可见性设计**  
+`RoomVisibility { Unknown, Explored, Mapped }` 精确对应《空洞骑士》的「未知 → 进入显示轮廓 → 购买地图碎片显示完整格子」三级模型。
+
+**RoomExitData 完备**  
+包含过渡类型 `PreferredTransitionType`（`Seamless`/`AtmosphericFade`）、出口方向、出口格子坐标，支持流式加载和场景切换决策。
+
+**ValidateAll 四项检查**  
+null 元素 / 空 RoomId / RoomId 重复 / 格子重叠 / 出口目标不存在，覆盖最常见的数据配置错误。
+
+#### 不足
+
+- `MapRoomDataSO` 缺少 `ConnectedRegionIds`（用于"区域地图碎片解锁连带邻近房间"这类机制）；也缺少 `AmbientMusicKey` 等与地图强耦合的环境配置（此类数据可通过扩展字段或额外 SO 补充，属于设计扩展点，不构成缺陷，但影响长期可扩展性）。（-1 分）
+
+---
+
+### 维度 5：策划/开发友好度（9 / 10）
+
+#### 优势
+
+**Inspector 所见即所得**  
+`[Header]`、`[Tooltip]`、`[Range]`、`[Min]` 注解全面，策划无需看代码即可理解每个字段含义。`EstimatedMemoryKB` 的 Tooltip 详细说明测量方法和 0 的语义。
+
+**一键验证流程**  
+MapDatabaseEditor Inspector → 点击"重新验证" → HelpBox 显示所有错误 + 每行 Ping → 点击 Ping 跳转到对应 SO → Inspector 直接修改；整条流程在 Inspector 面板内闭环。
+
+**布局编辑器降低理解成本**  
+策划可在 MapLayoutEditorWindow 中直观查看整体地图结构，无需手动比对多个 SO 的 GridPosition 数值。颜色分区、Badge 符号、连线均辅助理解地图拓扑。
+
+**RegionNameDisplay 本地化对接**  
+支持 LocKey → `LocalizationManager` 回落链，多语言游戏无需修改组件，仅填写 SO 配置。
+
+**MapPin 完整的标记生命周期**  
+`CreatePin`/`AddPin`/`RemovePin` 公共 API，挂接 ISaveable，策划可在不修改代码的情况下扩展 `PinType`。
+
+#### 不足
+
+- `MapLayoutEditorWindow` 暂无直接拖拽修改房间位置的功能（仅预览/选择/验证），策划仍需在 Inspector 中手动输入 `GridPosition`；Scene View 拖拽已有 `MapRoomDataEditor`，但编辑器窗口里的一体化编辑体验不完整。（-1 分）
+
+---
+
+### 维度 6：小地图功能对标（11 / 15）
+
+#### 与《空洞骑士》《丝之歌》对标分析
+
+| 功能特性 | 《空洞骑士》 | 目标系统 | 实现状态 |
+|----------|-------------|----------|----------|
+| 全屏地图面板 | ✅ | ✅ MapPanel | **已实现** |
+| 角落小地图 HUD | ✅ | ✅ MinimapHUD | **已实现** |
+| 三级可见性（未知/轮廓/完整） | ✅ | ✅ RoomVisibility | **已实现** |
+| 区域颜色分区 | ✅ | ✅ RegionId + Palette | **已实现** |
+| 玩家位置图标 | ✅ | ✅ _playerIconImg | **已实现** |
+| 自定义标记（地图钉） | ✅ | ✅ MapPinManager | **已实现** |
+| 区域名称淡显 | ✅ | ✅ RegionNameDisplay | **已实现** |
+| 全屏地图缩放/平移 | ✅ | ✅ MapInputHandler | **已实现** |
+| 当前房间高亮 | ✅ | ✅ SetHighlight() | **已实现** |
+| 打开时自动居中到玩家位置 | ✅ | ✅ CenterOnCurrentRoom | **已实现** |
+| 房间非矩形轮廓贴图 | ✅ | ✅ RoomOutlineTex | **已实现** |
+| 存档点/商店/Boss 图标 | ✅ | ✅ ChooseIcon | **已实现** |
+| 出口连接线（门缝） | ✅ | ✅ DrawExits | **已实现** |
+| 地图碎片购买解锁 Mapped 状态 | ✅ | ✅ SetMapped | **已实现** |
+| 探索进度百分比 UI | ✅ | ⚠️ API 有，UI 未接入 | **API 就绪，UI 缺失** |
+| 地图碎片 NPC 购买流程 | ✅ | ⚠️ SetMapped API 有，购买 UI/NPC 接入未看到 | **部分** |
+| 房间内传送点标记 | 部分 | ❌ 无专用 PinType | **缺失** |
+| 小地图开/关切换动画 | ✅ | ❌ 无动画，直接 SetActive | **缺失** |
+| 地图缩略图（全游戏鸟瞰） | 丝之歌有 | ❌ 无 | **缺失** |
+| 多层地图（Z 层/地下/天空） | 部分 | ❌ 无层级概念 | **超出当前范围** |
+
+**已实现核心功能比例：14/20 = 70%**
+
+#### 主要缺口
+
+1. **探索进度 UI 未接入**（-1）：`GetExplorationProgress()` API 完备，但系统中无对应的 UI 组件（进度条/百分比文字）消费此数据。
+2. **小地图开关缺动画**（-1）：`MinimapHUD` 直接 Enable/Disable，无淡入淡出或缩放过渡，在视觉感知上低于参考游戏。
+3. **购买地图碎片流程未闭环**（-1）：`SetMapped` API 存在，但无对应的 ShopItem/NPC 触发流程（可能在 Shop 模块，但与地图系统的对接文档/接口未体现）。
+4. **缺乏传送点 PinType**（-1）：`PinType` 枚举中无 `Warp`/`Teleporter` 类型，银河恶魔城后期解锁传送网络时无法标注。
+
+---
+
+### 维度 7：代码质量与可维护性（9 / 10）
+
+#### 优势
+
+**命名一致性**  
+`_camelCase` 私有字段、`PascalCase` 公共成员、`EVT_` 事件命名、`SO` 后缀 ScriptableObject，全项目统一。
+
+**XML 文档注释完整**  
+每个 `public` 成员和非平凡 `private` 方法均有 `<summary>` 注释；关键算法（空间索引、增量重建、脏标记）有内联说明。
+
+**单一职责落实**  
+提取后：`MapRoomCellUI`（格子显示）、`MapPlayerTracker`（坐标转换）、`MapManager`（状态管理）、`MapPanel`（全屏面板）、`MinimapHUD`（HUD）各司其职，无明显职责交叉。
+
+**防御性编程**  
+null 检查（`_database?.AllRooms`）、`TryGetValue` 替代双重查询、`TryGetComponent` 替代 `GetComponent` + null 检查，关键路径均有保护。
+
+**MapPin.cs 文件名说明**  
+顶部注释明确说明 `MapPin.cs` 包含 `MapPinManager` 类的历史原因，消除未来维护者的困惑。
+
+#### 不足
+
+- `MapPanel.CenterOnCurrentRoom()` 内调用了 `Canvas.ForceUpdateCanvases()`，这会强制重新布局整个 Canvas 树，在大型 UI 层级中可能引发性能尖峰；理想做法是延迟一帧或用 `LayoutRebuilder.ForceRebuildLayoutImmediate` 仅重建局部。（-1 分）
+
+---
+
+### 维度 8：存档/持久化（5 / 5）
+
+**完美实现**
+
+- `MapManager` 实现 `ISaveable`：`OnSave` 深拷贝 `_exploredRooms`/`_mappedRooms`，`OnLoad` 防御性重建两个 HashSet，并重置 `_totalRoomCount` 缓存。
+- `MapPinManager` 实现 `ISaveable`：标记列表直接存入 `SaveData.Map.Pins`，加载时 null 安全。
+- 两者均通过 `OnEnable/OnDisable` 注册/取消注册 `ISaveableRegistry`，无需静态引用，测试替换零成本。
+
+---
+
+## 四、系统架构总览图（文字版）
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                        IMapService（接口层）                         │
+│  IsExplored / IsMapped / SetMapped / Database / CurrentRegionId     │
+│  ExploredRoomCount / GetExplorationProgress / GetRoomsByRegion      │
+└───────────────────────┬─────────────────────────────────────────────┘
+                        │ ServiceLocator
+          ┌─────────────▼──────────────┐
+          │      MapManager            │  实现 IMapService + ISaveable
+          │  - HashSet<> _exploredRooms│
+          │  - HashSet<> _mappedRooms  │
+          │  - _totalRoomCount (cache) │
+          │  - OnRoomEntered (event)   │
+          └────────────────────────────┘
+
+┌─────────────────┐    OnRoomChanged    ┌─────────────────────┐
+│ MapPlayerTracker│ ─────────────────▶  │   MinimapHUD        │
+│ - SpatialIndex  │                     │ - 增量格子重建       │
+│ - O(1) LateUpd  │                     │ - ClearAllCells      │
+│ - NormPosInRoom │                     │ - Dirty dot tracking │
+└────────┬────────┘                     └─────────────────────┘
+         │
+         │ CurrentRoomId / NormalizedPos
+         ▼
+┌─────────────────────────────────────────────────────────┐
+│  MapPanel（全屏地图）                                    │
+│  - BuildGrid (首次) / RefreshAllCells (重开)            │
+│  - LateUpdate 双脏标记                                  │
+│  - CenterOnCurrentRoom / SetHighlight                   │
+│  - MapInputHandler (缩放/平移) [RequireComponent]       │
+└─────────────────────────────────────────────────────────┘
+
+┌────────────────────────┐   ┌────────────────────────┐
+│   MapRoomCellUI        │   │   MapServiceExtensions  │
+│ - SetColors (注入)     │   │ - GetVisibility(this    │
+│ - SetVisibility (enum) │   │   IMapService, roomId)  │
+│ - SetHighlight         │   └────────────────────────┘
+│ - Tooltip Hover        │
+└────────────────────────┘
+
+Editor ──────────────────────────────────────────────────────
+┌─────────────────────────┐   ┌──────────────────────────┐
+│ MapLayoutEditorWindow   │◀──│  MapDatabaseEditor        │
+│ - 缩放/平移/区域色      │   │  - SetDatabase() API      │
+│ - TrySelectRoom (精确)  │   │  - ValidateAll + HelpBox  │
+│ - DrawLine (矩阵修复)   │   │  - Ping 房间列表          │
+│ - SetDatabase() 公共API │   └──────────────────────────┘
+└─────────────────────────┘
+```
+
+---
+
+## 五、仍需改进的项目（优先级排序）
+
+### 🔴 高优先级（影响体验/正确性）
+
+| # | 问题 | 位置 | 建议 |
+|---|------|------|------|
+| H1 | 小地图 HUD 开关无过渡动画 | `MinimapHUD` | 添加 `CanvasGroup` alpha 淡入/淡出 Coroutine，参考 `RegionNameDisplay.ShowSequence()` |
+| H2 | 探索进度 UI 未接入 | 无对应 UI 组件 | 新建 `MapProgressUI` 组件，订阅 `_onMapUpdated`，调用 `IMapService.GetExplorationProgress()` 渲染进度条 |
+
+### 🟡 中优先级（功能完整性）
+
+| # | 问题 | 位置 | 建议 |
+|---|------|------|------|
+| M1 | 缺少传送点 PinType | `SaveData.cs` PinType 枚举 | 新增 `Warp`（传送点）、`Landmark`（地标）枚举值 |
+| M2 | 地图碎片购买与 SetMapped 未闭环 | 跨模块 | 在 Shop/NPC 模块提供触发 `IMapService.SetMapped(roomId)` 的接口调用文档或示例 |
+| M3 | MapLayoutEditorWindow 不持久化视口状态 | `MapLayoutEditorWindow` | `OnDisable`/`OnEnable` 用 `EditorPrefs` 保存/恢复 `_zoom` 和 `_panOffset` |
+| M4 | Canvas.ForceUpdateCanvases() 性能风险 | `MapPanel.CenterOnCurrentRoom` | 改为 `LayoutRebuilder.ForceRebuildLayoutImmediate(content)` 仅重建地图 content 节点 |
+
+### 🟢 低优先级（锦上添花）
+
+| # | 问题 | 位置 | 建议 |
+|---|------|------|------|
+| L1 | MapLayoutEditorWindow 无拖拽编辑 | `MapLayoutEditorWindow` | 实现 `MouseDrag`（非 Alt）对选中房间的 `GridPosition` 修改，包裹 `Undo.RecordObject` |
+| L2 | MinimapHUD toRemove 每帧分配 | `MinimapHUD.RefreshView` | 复用 `_toRemoveBuffer = new List<string>(8)` 字段，`Clear()` 后重用 |
+| L3 | 缺少多层地图支持 | `MapRoomDataSO` | 新增 `MapLayer` 字段（`int`），`MapPanel` / `MinimapHUD` 按层过滤渲染 |
+| L4 | MapDatabaseSO 仅在 OnDisable 清理索引 | `MapDatabaseSO` | 在 `OnValidate` 中也清理 `_index = null`，使编辑器改动后立即失效旧缓存 |
+
+---
+
+## 六、与参考游戏对标总结
+
+### 《空洞骑士》对标
+| 特性 | 评价 |
+|------|------|
+| 三级可见性机制 | 完全对标，`RoomVisibility` 枚举设计正确 |
+| 地图碎片购买解锁 | 机制完备（`SetMapped`），流程闭环待补全 |
+| 区域颜色分区 | 编辑器侧已有 8 色调色板，运行时侧待配色 SO |
+| 自定义标记 | 基础完备，`PinType` 枚举可扩展 |
+| 全屏/HUD 双模式 | 完全对标 |
+| 玩家位置动态追踪 | 完全对标，O(1) 性能优于参考实现 |
+
+### 《丝之歌》对标
+| 特性 | 评价 |
+|------|------|
+| 动态小地图（实时更新） | 完全对标（增量重建 + 事件驱动） |
+| 区域名称入场动画 | 完全对标（`RegionNameDisplay` + 淡入淡出） |
+| 地图缩略图/鸟瞰 | 未实现 |
+| 探索百分比显示 | API 就绪，UI 待实现 |
+
+---
+
+## 七、综合评价
+
+经过三轮评估与两轮完整改进，本小地图系统已从 56 分的基础原型成长为一个**架构扎实、性能优良、工具完善**的银河恶魔城地图系统骨架。
+
+**核心优势**：
+1. **接口驱动架构**让整个地图模块可测试、可替换，`IMapService` 是系统的核心稳定点
+2. **O(1) 玩家追踪 + 增量 HUD 重建 + 多层脏标记**三处性能优化组合，在复杂地图（数百房间）下依然保持高帧率
+3. **编辑器工具链完整**：布局预览 → 数据验证 → Ping 导航，策划无需写任何代码即可配置和调试地图
+4. **三级可见性**精确对标《空洞骑士》设计，为地图碎片经济系统提供坚实基础
+
+**核心差距**（主要体现在功能层面，非架构层面）：
+- 探索进度 UI 组件缺失
+- 小地图开关无过渡动画  
+- PinType 扩展未覆盖传送点等特殊类型
+
+**建议路线**：按 H1→H2→M1→M3 顺序完成剩余改进，即可达到可发行水平。
+
+---
+
+*报告生成于 zeling_v2 项目第三轮评估，评估者：GitHub Copilot CLI*