chore: initial commit

Assets/Scripts/Core/ISaveService.cs

@@ -0,0 +1,29 @@
+using System.Threading.Tasks;
+
+namespace BaseGames.Core
+{
+    /// <summary>
+    /// 存档服务接口。对外暴露存档系统的高层操作，供其他模块通过 ServiceLocator 访问。
+    /// 实现由 BaseGames.Core.Save 程序集的 SaveManager 提供。
+    /// </summary>
+    public interface ISaveService
+    {
+        /// <summary>将当前游戏状态写入指定存档槽。</summary>
+        Task SaveAsync(int slot);
+
+        /// <summary>从指定存档槽加载游戏状态。成功返回 true，存档损坏/不存在返回 false。</summary>
+        Task<bool> LoadAsync(int slot);
+
+        /// <summary>快速存档（覆盖当前活跃槽）。</summary>
+        void QuickSave();
+
+        /// <summary>快速读档（从当前活跃槽加载）。</summary>
+        Task QuickLoadAsync();
+
+        /// <summary>指定槽是否存在有效存档。</summary>
+        bool HasSave(int slot);
+
+        /// <summary>当前活跃存档槽（0–2）。</summary>
+        int ActiveSlot { get; }
+    }
+}