(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/Entity/Attributes.cs

@@ -5,14 +5,23 @@ namespace Entity
 {
     public class Attributes
     {
+        public int attack = 1;
+        public float attackRange = 3;
+        public float attackSpeed = 2;
+        public int attackTargetCount = 1;
+        public int defense;
         public int health = 10;
         public float moveSpeed = 1;
-        public int attack = 1;
-        public int defense = 0;
-        public float attackSpeed = 2; 
-        public float attackRange = 3;
-        public int attackTargetCount = 1;
+        public float totalDamageDealtAbsoluteOffset; // 累计造成的伤害绝对值偏移 (原 effectiveDamageOffset 对应)
+        public float totalDamageDealtPercentOffset; // 累计造成的伤害百分比偏移 (原 effectiveDamagePercentOffset 对应)
 
+        public float totalDamageTakenAbsoluteOffset; // 累计受到的伤害绝对值偏移
+        public float totalDamageTakenPercentOffset; // 累计受到的伤害百分比偏移 (例如 0.1 表示 +10%)
+
+        /// <summary>
+        ///     根据属性定义初始化 <see cref="Attributes" /> 类的新实例。
+        /// </summary>
+        /// <param name="def">属性定义。</param>
         public Attributes(AttributesDef def)
         {
             if (def == null)
@@ -21,13 +30,19 @@ namespace Entity
             moveSpeed = def.moveSpeed;
             attack = def.attack;
             defense = def.defense;
-            attackSpeed = MathF.Max(0.0001f,def.attackSpeed);
+            attackSpeed = MathF.Max(0.0001f, def.attackSpeed);
             attackRange = def.attackRange;
             attackTargetCount = def.attackTargetCount;
         }
 
+        /// <summary>
+        ///     从另一个 <see cref="Attributes" /> 实例复制属性，初始化 <see cref="Attributes" /> 类的新实例。
+        /// </summary>
+        /// <param name="other">要复制的 <see cref="Attributes" /> 实例。</param>
         public Attributes(Attributes other)
         {
+            if (other == null)
+                return;
             health = other.health;
             moveSpeed = other.moveSpeed;
             attack = other.attack;
@@ -37,75 +52,73 @@ namespace Entity
             attackTargetCount = other.attackTargetCount;
         }
 
+        /// <summary>
+        ///     初始化 <see cref="Attributes" /> 类的新实例。
+        /// </summary>
         public Attributes()
         {
         }
 
         /// <summary>
-        /// 根据给定的属性偏移，生成一个新的 Attributes 实例。
-        /// 原有的 Attributes 实例保持不变。
+        ///     根据给定的属性偏移，生成一个新的 <see cref="Attributes" /> 实例。
+        ///     原有的 <see cref="Attributes" /> 实例保持不变。
         /// </summary>
         /// <param name="offset">要应用的属性偏移定义。</param>
-        /// <returns>一个新的 Attributes 实例，包含了应用偏移后的值。</returns>
+        /// <returns>一个新的 <see cref="Attributes" /> 实例，包含了应用偏移后的值。</returns>
         public Attributes GetModifiedAttributes(AttributesOffsetDef offset)
         {
-            // 1. 创建当前 Attributes 实例的一个副本
+            // 创建当前 Attributes 实例的一个副本
             var newAttributes = new Attributes(this);
 
             if (offset == null)
-            {
-                return newAttributes; // 如果没有偏移，直接返回副本
-            }
+                // 如果没有偏移，直接返回副本
+                return newAttributes;
 
-            // 2. 在副本上应用绝对值偏移
+            // 在副本上应用绝对值偏移
             newAttributes.health += (int)offset.healthOffset;
             newAttributes.moveSpeed += offset.moveSpeedOffset;
             newAttributes.attack += (int)offset.attackOffset;
             newAttributes.defense += (int)offset.defenseOffset;
-
-            // 修正: attackSpeed 和 attackRange 是 float，不应强制转换为 int
-            newAttributes.attackSpeed += offset.attackSpeedOffset; 
-            newAttributes.attackRange += offset.attackRangeOffset; 
-
+            newAttributes.attackSpeed += offset.attackSpeedOffset;
+            newAttributes.attackRange += offset.attackRangeOffset;
             newAttributes.attackTargetCount += (int)offset.attackTargetCountOffset;
 
-            // 3. 在副本上应用百分比偏移 (基于应用绝对值偏移后的结果)
+            // 在副本上应用百分比偏移 (基于应用绝对值偏移后的结果)
             newAttributes.health = (int)(newAttributes.health * (1 + offset.healthPercentOffset));
-            newAttributes.moveSpeed *= (1 + offset.moveSpeedPercentOffset);
+            newAttributes.moveSpeed *= 1 + offset.moveSpeedPercentOffset;
             newAttributes.attack = (int)(newAttributes.attack * (1 + offset.attackPercentOffset));
             newAttributes.defense = (int)(newAttributes.defense * (1 + offset.defensePercentOffset));
-
-            // 修正: attackSpeed 和 attackRange 是 float，不应强制转换为 int
-            newAttributes.attackSpeed *= (1 + offset.attackSpeedPercentOffset);
-            newAttributes.attackRange *= (1 + offset.attackRangePercentOffset);
-
+            newAttributes.attackSpeed *= 1 + offset.attackSpeedPercentOffset;
+            newAttributes.attackRange *= 1 + offset.attackRangePercentOffset;
             newAttributes.attackTargetCount =
                 (int)(newAttributes.attackTargetCount * (1 + offset.attackTargetCountPercentOffset));
 
-            // 4. 确保属性不低于最小值
+            newAttributes.totalDamageDealtAbsoluteOffset = offset.effectiveDamageOffset;
+            newAttributes.totalDamageDealtPercentOffset = offset.effectiveDamagePercentOffset;
+            newAttributes.totalDamageTakenAbsoluteOffset = offset.damageTakenOffset;
+            newAttributes.totalDamageTakenPercentOffset = offset.damageTakenPercentOffset;
+
+            // 确保属性不低于最小值
             newAttributes.health = Math.Max(0, newAttributes.health);
             newAttributes.moveSpeed = Math.Max(0f, newAttributes.moveSpeed);
             newAttributes.attack = Math.Max(0, newAttributes.attack);
             newAttributes.defense = Math.Max(0, newAttributes.defense);
-            
-            // 修正: Math.Max 期望相同类型，0f 对于 float 类型更准确
-            newAttributes.attackSpeed = Math.Max(0f, newAttributes.attackSpeed); 
+            newAttributes.attackSpeed = Math.Max(0f, newAttributes.attackSpeed);
             newAttributes.attackRange = Math.Max(0f, newAttributes.attackRange);
-
             newAttributes.attackTargetCount = Math.Max(1, newAttributes.attackTargetCount);
 
-            // 5. 返回修改后的新 Attributes 实例
+            // 返回修改后的新 Attributes 实例
             return newAttributes;
         }
-        
+
         /// <summary>
-        /// 合并两个 Attributes 实例，生成一个新的 Attributes 实例，
-        /// 其中每个属性值都取自传入两个实例中对应属性的最小值。
-        /// 这对于应用属性上限或限制非常有用。
+        ///     合并两个 <see cref="Attributes" /> 实例，生成一个新的 <see cref="Attributes" /> 实例，
+        ///     其中每个属性值都取自传入两个实例中对应属性的最小值。
+        ///     这对于应用属性上限或限制非常有用。
         /// </summary>
-        /// <param name="a">第一个 Attributes 实例。</param>
-        /// <param name="b">第二个 Attributes 实例。</param>
-        /// <returns>一个新的 Attributes 实例，其属性是输入实例中对应属性的最小值。</returns>
+        /// <param name="a">第一个 <see cref="Attributes" /> 实例。</param>
+        /// <param name="b">第二个 <see cref="Attributes" /> 实例。</param>
+        /// <returns>一个新的 <see cref="Attributes" /> 实例，其属性是输入实例中对应属性的最小值。</returns>
         public static Attributes Min(Attributes a, Attributes b)
         {
             // 处理 null 情况
@@ -122,11 +135,35 @@ namespace Entity
                 defense = Math.Min(a.defense, b.defense),
                 attackSpeed = Math.Min(a.attackSpeed, b.attackSpeed),
                 attackRange = Math.Min(a.attackRange, b.attackRange),
-                attackTargetCount = Math.Min(a.attackTargetCount, b.attackTargetCount)
+                attackTargetCount = Math.Min(a.attackTargetCount, b.attackTargetCount),
+                totalDamageDealtAbsoluteOffset = a.totalDamageDealtAbsoluteOffset,
+                totalDamageDealtPercentOffset = a.totalDamageDealtPercentOffset,
+                totalDamageTakenAbsoluteOffset = a.totalDamageTakenAbsoluteOffset,
+                totalDamageTakenPercentOffset = a.totalDamageTakenPercentOffset
             };
 
             return result;
         }
 
+        /// <summary>
+        ///     返回当前 <see cref="Attributes" /> 实例的字符串表示形式。
+        /// </summary>
+        /// <returns>包含所有属性名称和值的字符串。</returns>
+        public override string ToString()
+        {
+            return "Attributes {\n" +
+                   $"  Health: {health}\n" +
+                   $"  Move Speed: {moveSpeed:F2}\n" +
+                   $"  Attack: {attack}\n" +
+                   $"  Defense: {defense}\n" +
+                   $"  Attack Speed: {attackSpeed:F2}\n" +
+                   $"  Attack Range: {attackRange:F2}\n" +
+                   $"  Attack Target Count: {attackTargetCount}\n" +
+                   $"  Total Damage Dealt (Absolute Offset): {totalDamageDealtAbsoluteOffset:F2}\n" +
+                   $"  Total Damage Dealt (Percent Offset): {totalDamageDealtPercentOffset:P2}\n" +
+                   $"  Total Damage Taken (Absolute Offset): {totalDamageTakenAbsoluteOffset:F2}\n" +
+                   $"  Total Damage Taken (Percent Offset): {totalDamageTakenPercentOffset:P2}\n" +
+                   "}";
+        }
     }
-}
+}