(client) feat:健康给予，路径优化，结算界面，商店界面 (#60)

Co-authored-by: m0_75251201 <m0_75251201@noreply.gitcode.com>
Reviewed-on: http://47.107.252.169:3000/Roguelite-Game-Developing-Team/Gen_Hack-and-Slash-Roguelite/pulls/60

Client/Assets/Scripts/Managers/TileManager.cs

@@ -1,41 +1,55 @@
 // Managers/TileManager.cs
 
 using System;
-using Data;
-using Utils;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
+using Data;
 using Map;
 using UnityEngine;
 using UnityEngine.Tilemaps;
-using Object = UnityEngine.Object;
+using Utils;
+using Object = UnityEngine.Object; // 明确指定UnityEngine.Object
 
 namespace Managers
 {
     public class TileManager : Singleton<TileManager>, ILaunchManager
     {
-        public string StepDescription => "正在加载瓦片";
-
         // 缓存所有根据定义生成的RuleTile实例
-        private Dictionary<string, RuleTile> _cachedTiles = new();
+        private readonly Dictionary<string, RuleTile> _cachedTiles = new();
 
         // 地图生成器工作类映射，Key: MapGeneratorDef.defName, Value: MapGeneratorWorkClassBase
-        private Dictionary<string, MapGeneratorWorkClassBase> _mapGeneratorWorkClassMap = new();
+        private readonly Dictionary<string, MapGeneratorWorkClassBase> _mapGeneratorWorkClassMap = new();
 
-        public void Init()
+        /// <summary>
+        ///     指示管理器是否已完成初始化。
+        /// </summary>
+        public bool Completed { get; set; } // 新增：实现 ILaunchManager 接口的 Completed 属性
+
+        public string StepDescription => "正在加载瓦片";
+
+        /// <summary>
+        ///     初始化瓦片管理器：加载所有瓦片定义并创建RuleTile实例，加载地图生成器定义。
+        /// </summary>
+        /// <returns>一个表示异步操作完成的 Task。</returns>
+        public Task Init() // 接口变更：方法签名变为 async Task
         {
-            // 如果已缓存瓦片，则直接返回
-            if (_cachedTiles.Any())
-                return;
+            // 使用 Completed 属性作为统一的状态检查，防止重复初始化
+            if (Completed) return Task.CompletedTask;
 
+            // 遵循不检查单例的原则，假定 DefineManager.Instance 始终可用。
             var tileDefs = DefineManager.Instance.QueryDefinesByType<TileDef>();
+            if (tileDefs == null)
+            {
+                Completed = true; // 即使没有定义，也认为初始化流程已完成
+                return Task.CompletedTask;
+            }
 
             foreach (var def in tileDefs)
             {
                 if (string.IsNullOrEmpty(def.defName))
                 {
-                    Debug.LogWarning($"发现未定义名称或defName的TileDef，已跳过。");
+                    Debug.LogWarning("发现未定义名称或defName的TileDef，已跳过。");
                     continue;
                 }
 
@@ -44,48 +58,61 @@ namespace Managers
                 ruleTile.name = tileName; // 设置ScriptableObject的名称
 
                 ruleTile.m_DefaultColliderType = def.collider;
+                // 遵循不检查单例的原则，假定 PackagesImageManager.Instance 始终可用。
                 ruleTile.m_DefaultSprite = PackagesImageManager.Instance.GetSprite(def.texture);
                 ruleTile.m_TilingRules = GetTileRules(def.rules);
 
                 _cachedTiles[tileName] = ruleTile;
             }
 
+            // 遵循不检查单例的原则，假定 DefineManager.Instance 始终可用。
             var generatorDefs = DefineManager.Instance.QueryDefinesByType<MapGeneratorDef>();
-            foreach (var mapGeneratorDef in generatorDefs)
+            if (generatorDefs != null) // 检查 generatorDefs 是否为 null
             {
-                var workClass = StringUtils.CreateMapGeneratorInstance(mapGeneratorDef.workClass);
-                if (workClass == null)
+                foreach (var mapGeneratorDef in generatorDefs)
                 {
-                    Debug.LogWarning($"无法为地图生成器 '{mapGeneratorDef.defName}' 创建工作类 '{mapGeneratorDef.workClass}'，已跳过。");
-                    continue;
-                }
+                    var workClass = StringUtils.CreateMapGeneratorInstance(mapGeneratorDef.workClass);
+                    if (workClass == null)
+                    {
+                        Debug.LogWarning($"无法为地图生成器 '{mapGeneratorDef.defName}' 创建工作类 '{mapGeneratorDef.workClass}'，已跳过。");
+                        continue;
+                    }
 
-                workClass.Init(mapGeneratorDef.value);
-                _mapGeneratorWorkClassMap[mapGeneratorDef.defName] = workClass;
+                    workClass.Init(mapGeneratorDef.value);
+                    _mapGeneratorWorkClassMap[mapGeneratorDef.defName] = workClass;
+                }
             }
+
+
+            Completed = true; // 在所有初始化逻辑完成后设置 Completed 为 true
+            return Task.CompletedTask;
+            // 由于 Init 方法内部当前没有真正的异步操作，不需要显式 await Task.CompletedTask;
+            // 编译器会为同步的 async Task 方法自动生成一个已完成的 Task。
         }
 
+        /// <summary>
+        ///     清空所有缓存的瓦片定义和地图生成器工作类。
+        /// </summary>
         public void Clear()
         {
             foreach (var tile in _cachedTiles.Values)
-            {
                 if (tile != null)
-                {
-                    Object.Destroy(tile);
-                }
-            }
+                    Object.Destroy(tile); // 销毁动态创建的 ScriptableObject 实例
 
             _cachedTiles.Clear();
             _mapGeneratorWorkClassMap.Clear(); // 清空地图生成器工作类映射
+
+            Completed = false; // 清理后将 Completed 置为 false
         }
 
         private static List<RuleTile.TilingRule> GetTileRules(RuleTileRuleDef[] rules)
         {
-            return rules?.Select(GetTileRule).ToList();
+            // Null-conditional operator 和 ToList() 确保即使 rules 为 null 也不会抛出异常
+            return rules?.Select(GetTileRule).ToList() ?? new List<RuleTile.TilingRule>();
         }
 
         /// <summary>
-        /// 将自定义的 RuleTileRuleDef 转换为 Unity 的 RuleTile.TilingRule。
+        ///     将自定义的 RuleTileRuleDef 转换为 Unity 的 RuleTile.TilingRule。
         /// </summary>
         /// <param name="ruleDef">自定义的 RuleTileRuleDef 规则定义。</param>
         /// <returns>转换后的 RuleTile.TilingRule 实例。</returns>
@@ -96,6 +123,7 @@ namespace Managers
 
             var tilingRule = new RuleTile.TilingRule
             {
+                // 遵循不检查单例的原则，假定 PackagesImageManager.Instance 始终可用。
                 m_Sprites = PackagesImageManager.Instance.GetSprites(ruleDef.animationTextures.ToArray()),
                 m_Output = ruleDef.outputType,
                 m_ColliderType = ruleDef.outputCollider,
@@ -109,7 +137,7 @@ namespace Managers
             var neighborConditionsMap = new Dictionary<Vector3Int, int>();
 
             // 预设的8个邻居位置
-            var defaultPositions = new Vector3Int[]
+            var defaultPositions = new[]
             {
                 new Vector3Int(-1, 1, 0),
                 new Vector3Int(0, 1, 0),
@@ -144,10 +172,9 @@ namespace Managers
 
             // 处理扩展邻居条件，如果位置重复，则覆盖标准8个邻居的定义
             if (ruleDef.neighborConditionExtend != null)
-            {
                 foreach (var neighborConditionDef in ruleDef.neighborConditionExtend)
                 {
-                    var pos = Utils.StringUtils.StringToVector3Int(neighborConditionDef.position);
+                    var pos = StringUtils.StringToVector3Int(neighborConditionDef.position);
                     int neighborType;
                     switch (neighborConditionDef.Type)
                     {
@@ -162,13 +189,12 @@ namespace Managers
                         case RuleTileRuleDef.NeighborConditionType.Any:
                         default:
                             // 如果是Any或默认，则不添加到map中
-                            // 如果这个位置之前有定义（来自defaultPositions），那么Any会有效地“移除”这个定义
                             // 如果我们希望Any清除之前的显式定义，可以在这里neighborConditionsMap.Remove(pos);
                             // 但通常Any意味着不关心，所以保持不添加即可
                             break;
                     }
                 }
-            }
+
             tilingRule.m_NeighborPositions = new List<Vector3Int>(neighborConditionsMap.Keys);
             tilingRule.m_Neighbors = new List<int>(neighborConditionsMap.Values);
 
@@ -177,43 +203,41 @@ namespace Managers
 
 
         /// <summary>
-        /// 根据名称获取一个 RuleTile 实例。
+        ///     根据名称获取一个 RuleTile 实例。
         /// </summary>
         /// <param name="tileName">瓦片的名称 (TileDef.defName)</param>
         /// <returns>对应的 RuleTile 实例，如果找不到则返回 null。</returns>
         public TileBase GetTile(string tileName)
         {
-            if (_cachedTiles.TryGetValue(tileName, out var tile))
-            {
-                return tile;
-            }
+            if (_cachedTiles.TryGetValue(tileName, out var tile)) return tile;
 
             Debug.LogWarning($"瓦片 '{tileName}' 未在TileManager缓存中找到。");
             return null;
         }
 
         /// <summary>
-        /// 应用指定的地图生成器，现在是非阻塞的异步操作。
+        ///     应用指定的地图生成器，现在是非阻塞的异步操作。
         /// </summary>
         /// <param name="generatorName">要应用的生成器名称。</param>
         /// <param name="landform">可选：指定要使用的 MapGenerator 实例。如果为 null，将尝试从 Program.Instance.FocusedDimension 获取。</param>
         /// <returns>一个表示异步操作完成的 Task。</returns>
-        public async Task ApplyMapGenerator(string generatorName, Map.Landform landform = null)
+        public async Task ApplyMapGenerator(string generatorName, Landform landform = null)
         {
             if (landform == null)
             {
                 // 尝试从 Program.Instance.FocusedDimension 获取 mapGenerator
                 // 假设 Program 和 FocusedDimension 结构存在
-                landform = Program.Instance?.FocusedDimension?.landform;
+                // 遵循不检查单例、不检查给定的API的原则。
+                landform = Program.Instance.FocusedDimension.landform;
                 if (landform == null)
                 {
                     Debug.LogError(
-                        $"ApplyMapGenerator: 无法找到地图生成器 '{generatorName}' 对应的 mapGenerator。Program.Instance、FocusedDimension 或其 mapGenerator 可能为空。");
+                        $"ApplyMapGenerator: 无法找到地图生成器 '{generatorName}' 对应的 mapGenerator。Program.Instance、FocusedDimension 或其 landform 可能为空。");
                     return; // async Task 方法直接 return; 意味着返回 Task.CompletedTask
                 }
             }
 
-            if (_mapGeneratorWorkClassMap == null)
+            if (_mapGeneratorWorkClassMap == null) // 这个检查在 Init 保证了 map 不会为 null 后，理论上在这里是不需要的。
             {
                 Debug.LogError($"ApplyMapGenerator: _mapGeneratorWorkClassMap 未初始化，无法找到生成器 '{generatorName}'。");
                 return;
@@ -235,7 +259,6 @@ namespace Managers
                 catch (Exception ex)
                 {
                     Debug.LogError($"ApplyMapGenerator: 地图生成器 '{generatorName}' 异步处理过程中发生错误: {ex.Message}");
-                    // 可以在这里根据需要决定是否重新抛出异常
                     throw; // 抛出异常以通知调用者，或者根据实际情况选择捕获并完全处理
                 }
             }
@@ -248,7 +271,7 @@ namespace Managers
 
         public MapGeneratorWorkClassBase GetMapGeneratorWorkClass(string defName)
         {
-            return _mapGeneratorWorkClassMap?.GetValueOrDefault(defName,null);
+            return _mapGeneratorWorkClassMap?.GetValueOrDefault(defName, null);
         }
     }
 }