存档重构，游戏内容解锁机制；教程完善（未完成）

Assets/Scripts/Saving/BeatmapSave.cs

@@ -4,12 +4,27 @@ using UnityEngine;
 
 namespace Ichni.RhythmGame
 {
+    /// <summary>
+    /// 单个歌曲难度的最佳成绩。
+    /// 这里只保存当前 Chart Revision 下可比较的最佳记录，不保存逐局历史、判定时间线或 Replay。
+    /// </summary>
     public class BeatmapSave
     {
+        /// <summary>历史最高 Accuracy，固定使用 0 到 1；显示时由 UI 乘以 100。</summary>
         public float accuracy;
+
+        /// <summary>当前 Revision 下是否曾达成 Full Combo。</summary>
         public bool isFullCombo;
+
+        /// <summary>当前 Revision 下是否曾达成 All Perfect。</summary>
         public bool isAllPerfect;
 
+        /// <summary>成绩对应的谱面修订号；0 表示尚未绑定 Revision 的新建或异常记录。</summary>
+        public int chartRevision;
+
+        /// <summary>当前 Revision 下的历史最高连击数。</summary>
+        public int maxCombo;
+
         public BeatmapSave()
         {
             
@@ -21,10 +36,83 @@ namespace Ichni.RhythmGame
             this.isFullCombo = isFullCombo;
             this.isAllPerfect = isAllPerfect;
         }
+
+        /// <summary>
+        /// 令存档成绩匹配当前谱面 Revision。
+        /// <para>仅当 Note、Timing 或判定规则改变、导致成绩不再可比较时才递增 Revision。</para>
+        /// <para>未绑定 Revision 的记录会保留已有成绩并绑定到当前 Revision；之后出现真正的 Revision
+        /// 变化时，才仅重置该谱面的可比成绩。</para>
+        /// </summary>
+        public bool EnsureChartRevision(int currentChartRevision)
+        {
+            currentChartRevision = Mathf.Max(1, currentChartRevision);
+
+            if (chartRevision <= 0)
+            {
+                chartRevision = currentChartRevision;
+                return true;
+            }
+
+            if (chartRevision == currentChartRevision)
+            {
+                return false;
+            }
+
+            accuracy = 0f;
+            isFullCombo = false;
+            isAllPerfect = false;
+            maxCombo = 0;
+            chartRevision = currentChartRevision;
+            return true;
+        }
+
+        /// <summary>
+        /// 合并一次完整演奏的成绩。
+        /// <see cref="accuracy"/> 在持久化记录中始终使用 0 到 1 的归一化值，
+        /// 而 <see cref="PlayingRecorder.accuracy"/> 的运行时显示值为 0 到 100。
+        /// 写入规则是“最高 Accuracy / 最高 Max Combo / FC 与 AP 成就粘性保留”，而不是保存最近一次成绩。
+        /// </summary>
+        public bool ApplyPlayResult(PlayingRecorder recorder, int currentChartRevision)
+        {
+            if (recorder == null || recorder.totalCount <= 0)
+            {
+                return false;
+            }
+
+            bool changed = EnsureChartRevision(currentChartRevision);
+            float normalizedAccuracy = Mathf.Clamp01(recorder.accuracy / 100f);
+            if (normalizedAccuracy > accuracy)
+            {
+                accuracy = normalizedAccuracy;
+                changed = true;
+            }
+
+            bool achievedFullCombo = recorder.isFullCombo || recorder.isAllPerfect;
+            if (achievedFullCombo && !isFullCombo)
+            {
+                isFullCombo = true;
+                changed = true;
+            }
+
+            if (recorder.isAllPerfect && !isAllPerfect)
+            {
+                isAllPerfect = true;
+                changed = true;
+            }
+
+            if (recorder.maxCombo > maxCombo)
+            {
+                maxCombo = recorder.maxCombo;
+                changed = true;
+            }
+
+            return changed;
+        }
         
+        /// <summary>用于章节完成度统计；Revision 本身不代表玩家已经游玩过该谱面。</summary>
         public bool IsEmpty()
         {
-            return accuracy == 0f && !isFullCombo && !isAllPerfect;
+            return accuracy == 0f && !isFullCombo && !isAllPerfect && maxCombo == 0;
         }
     }
 }