aibis-dream/Assets/Scripts/SaveSystem/SaveRestoreOrchestrator.cs

using System.Collections;
using System.Collections.Generic;
using AibisDream.Framework;
using AibisDream.Kit;
using AibisDream.UI;
using Newtonsoft.Json.Linq;
using UnityEngine;

namespace AibisDream.SaveSystem
{
    /// <summary>
    /// 存读档流程编排层：连接 UI、<see cref="SnapshotService"/> 与槽位系统。
    /// <para>
    /// 对外入口：<see cref="SaveToAutoSlot"/>（&lt;&lt;auto_save&gt;&gt;）、
    /// <see cref="CreateManualSlot"/>（手动存档）、
    /// <see cref="RestoreFromSlot"/>（读档）、
    /// <see cref="RestoreFromFile"/>（旧档/调试）。
    /// </para>
    /// </summary>
    public static class SaveRestoreOrchestrator
    {
        /// <summary>捕获快照并写入自动档（slot 0）；含保存 Loading UI。</summary>
        public static void SaveToAutoSlot()
        {
            var host = YarnVariableStorage.Instance;
            if (host == null)
            {
                Debug.LogError("[SaveRestoreOrchestrator] YarnVariableStorage 未初始化");
                return;
            }

            ActionKit.Sequence()
                .Callback(() => UIManager.Instance.GetPanel<InfoPanel>().ShowSaveLoading())
                .Delay(1f)
                .Callback(() => UIManager.Instance.GetPanel<InfoPanel>().HideSaveLoading())
                .Start(host);

            using (new CodeTimer("SaveSnapshot"))
            {
                var snapshot = SnapshotService.Capture();
                var thumbnail = SlotThumbnailCapture.CapturePng();
                SlotManager.SaveToAutoSlot(snapshot, thumbnail);
            }
        }

        /// <summary>将当前自动档复制到指定手动档。</summary>
        public static void CreateManualSlot(int slotIndex)
        {
            SlotManager.CopyAutoToManual(slotIndex);
        }

        /// <summary>从指定槽位读档并还原。</summary>
        public static IEnumerator RestoreFromSlot(int slotIndex)
        {
            var snapshot = SlotManager.LoadSnapshot(slotIndex);
            if (snapshot == null)
            {
                Debug.LogError($"[SaveRestoreOrchestrator] 槽位 {slotIndex} 不存在或读取失败");
                yield break;
            }

            yield return RestoreSnapshot(snapshot);
        }

        /// <summary>从文件读档并还原；自动区分新快照格式与 legacy 格式。</summary>
        public static IEnumerator RestoreFromFile(string savePath)
        {
            if (SnapshotPersistence.IsLegacyFormat(savePath))
            {
                Debug.LogWarning("[SaveRestoreOrchestrator] 检测到旧格式存档，请使用新快照格式重新保存。");
                yield return RestoreLegacy(savePath);
                yield break;
            }

            SaveSnapshot snapshot;
            using (new CodeTimer("LoadSnapshot"))
            {
                snapshot = SnapshotPersistence.Load(savePath);
            }

            yield return RestoreSnapshot(snapshot);
        }

        /// <summary>旧档：Yarn 变量 + DeepRepairDataRegistry systemData。</summary>
        private static IEnumerator RestoreLegacy(string savePath)
        {
            var saveData = SnapshotPersistence.ReadLegacySaveRoot(savePath);
            var floatDict = saveData["floatDict"]?.ToObject<Dictionary<string, float>>();
            var stringDict = saveData["stringDict"]?.ToObject<Dictionary<string, string>>();
            var boolDict = saveData["boolDict"]?.ToObject<Dictionary<string, bool>>();
            YarnVariableStorage.Instance.SetAllVariables(floatDict, stringDict, boolDict);

            if (saveData["systemData"] is JObject systemDataJson)
            {
                yield return DeepRepairDataRegistry.LoadByJson(systemDataJson);
            }

            // 旧档还原后自动固化为新格式，方便后续使用槽位系统
            var snapshot = SnapshotService.Capture();
            SlotManager.SaveToAutoSlot(snapshot, null);
        }

        private static IEnumerator RestoreSnapshot(SaveSnapshot snapshot)
        {
            yield return SnapshotService.Restore(snapshot);
        }
    }
}