chore: initialize standalone UPM package

Runtime/ShrinkDataSaver.Integration.App.asmdef

@@ -0,0 +1,18 @@
+{
+  "name": "ShrinkDataSaver.Integration.App",
+  "rootNamespace": "ShrinkDataSaver.Integration.App",
+  "references": [
+    "ShrinkDataSaver.Runtime",
+    "ShrinkApp.Core.Runtime",
+    "ShrinkContext.Core.Runtime",
+        "UniTask"
+  ],
+  "includePlatforms": [],
+  "excludePlatforms": [],
+  "allowUnsafeCode": false,
+  "overrideReferences": false,
+  "autoReferenced": true,
+  "defineConstraints": [],
+  "versionDefines": [],
+  "noEngineReferences": false
+}

Runtime/ShrinkDataSaver.Integration.App.asmdef.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: b6cfc65e2b6dc8942866f0f374874564
+AssemblyDefinitionImporter:
+  externalObjects: {}
+  userData:
+  assetBundleName:
+  assetBundleVariant:

Runtime/ShrinkDataSaverAppComponent.cs

@@ -0,0 +1,65 @@
+#nullable enable
+using System;
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using ShrinkApp;
+using ShrinkContext;
+using ShrinkDataSaver;
+
+namespace ShrinkDataSaver.Integration.App
+{
+    /// <summary>
+    /// ShrinkDataSaver 的原生 Cordis 组件（阶段 3）：
+    /// - 提供 <c>shrink.service.datasaver</c> 余效应键（门面服务）；
+    /// - 初始化为前向；停用时的终止动作为最终落盘设置（补偿式收尾：
+    ///   存档写入本身跨会话持久，不可严格求逆，以 flush 保证一致性，见论文 6.1 扣留与补偿）；
+    /// - 与经典 ShrinkDataSaverAppInstaller（ModuleId "shrink.datasaver"）二选一使用。
+    /// </summary>
+    public sealed class ShrinkDataSaverAppComponent : IShrinkComponent
+    {
+        public const string ServiceKey = "shrink.service.datasaver";
+        public const string ModuleKey = "app.module.shrink.datasaver";
+
+        private static readonly string[] ProvideKeys = { ModuleKey, ServiceKey };
+
+        public string Name => "shrink.datasaver";
+
+        public IReadOnlyList<string> Inject => Array.Empty<string>();
+
+        public IReadOnlyList<string> Provide => ProvideKeys;
+
+        public async UniTask ApplyAsync(ShrinkCtx ctx, object? config)
+        {
+            // 编辑器/EditMode 环境下 DontDestroyOnLoad 会抛异常，驱动只在播放模式常驻
+            ShrinkDataSaverRuntime.Initialize(new ShrinkDataSaverRuntimeConfig
+            {
+                DontDestroyOnLoadDriver = UnityEngine.Application.isPlaying
+            });
+            var facade = new ShrinkDataSaverService();
+            ctx.Set(ServiceKey, facade, new ShrinkDataSaverAccessPolicy(facade));
+            ctx.Set(ModuleKey, Name);
+
+            if (config is ShrinkAppServices appServices)
+            {
+                appServices.Register(facade);
+                ctx.EffectInverse(() =>
+                {
+                    appServices.TryUnregister(facade);
+                    return UniTask.CompletedTask;
+                });
+            }
+
+            await ctx.EffectAsync(async () =>
+            {
+                await UniTask.CompletedTask;
+                return () =>
+                {
+                    // 终止动作（触发式）：停用时把防抖中的设置写盘。
+                    // 磁盘 IO 在线程池完成，不阻塞停用链；未初始化环境安全跳过（SaveAsync 守卫）。
+                    ShrinkSettings.SaveAsync().Forget();
+                    return UniTask.CompletedTask;
+                };
+            });
+        }
+    }
+}

Runtime/ShrinkDataSaverAppComponent.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0ce2260a6cfecb349abe6119fdf37c12
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData:
+  assetBundleName:
+  assetBundleVariant:

Runtime/ShrinkDataSaverAppInstaller.cs

@@ -0,0 +1,108 @@
+#nullable enable
+
+using System;
+using Cysharp.Threading.Tasks;
+using ShrinkApp;
+using ShrinkContext;
+
+namespace ShrinkDataSaver.Integration.App
+{
+    [ShrinkAppModuleInstaller]
+    [Obsolete("ClassicHost compatibility only. ContextLoader projects should use ShrinkDataSaverAppComponent from a composition root.")]
+    public sealed class ShrinkDataSaverAppInstaller : IShrinkAppModuleInstaller
+    {
+        public string ModuleId => "shrink.datasaver";
+        public int Order => -2000;
+        public System.Collections.Generic.IReadOnlyList<string> DependsOn => Array.Empty<string>();
+
+        public void RegisterServices(ShrinkAppContext context)
+        {
+            context.Services.Register(new ShrinkDataSaverService());
+        }
+
+        public UniTask InitializeAsync(ShrinkAppContext context)
+        {
+            ShrinkDataSaverRuntime.Initialize();
+            return UniTask.CompletedTask;
+        }
+    }
+
+    /// <summary>不产生存档写入的读取能力。</summary>
+    public interface IShrinkDataSaverReader
+    {
+        int LoadedSlot { get; }
+        int GetRecentSlotIndex();
+        UniTask<int> GetRecommendedContinueSlotAsync();
+        UniTask<SaveMeta[]> GetAllMetaAsync();
+    }
+
+    /// <summary>完整存档能力；社区模组可通过 intercept 被降权为仅 <see cref="IShrinkDataSaverReader"/>。</summary>
+    public interface IShrinkDataSaverWriter : IShrinkDataSaverReader
+    {
+        UniTask SaveSlotAsync(int slotIndex, SaveOptions? options = null);
+        UniTask LoadSlotAsync(int slotIndex, string? decryptionKey = null);
+    }
+
+    public static class ShrinkDataSaverAccess
+    {
+        public const string MetadataKey = "access";
+        public const string ReadOnly = "read-only";
+    }
+
+    public sealed class ShrinkDataSaverService : IShrinkDataSaverWriter
+    {
+        public int LoadedSlot => ShrinkSave.LoadedSlot;
+        public int GetRecentSlotIndex() => ShrinkSave.GetRecentSlotIndex();
+        public UniTask<int> GetRecommendedContinueSlotAsync() => ShrinkSave.GetRecommendedContinueSlotAsync();
+        public UniTask<SaveMeta[]> GetAllMetaAsync() => ShrinkSave.GetAllMetaAsync();
+        public UniTask SaveSlotAsync(int slotIndex, SaveOptions? options = null) => ShrinkSave.SaveSlotAsync(slotIndex, options);
+        public UniTask LoadSlotAsync(int slotIndex, string? decryptionKey = null) => ShrinkSave.LoadSlotAsync(slotIndex, decryptionKey);
+    }
+
+    internal sealed class ShrinkDataSaverReadOnlyService : IShrinkDataSaverReader
+    {
+        private readonly IShrinkDataSaverReader _inner;
+
+        public ShrinkDataSaverReadOnlyService(IShrinkDataSaverReader inner)
+        {
+            _inner = inner ?? throw new ArgumentNullException(nameof(inner));
+        }
+
+        public int LoadedSlot => _inner.LoadedSlot;
+        public int GetRecentSlotIndex() => _inner.GetRecentSlotIndex();
+        public UniTask<int> GetRecommendedContinueSlotAsync() => _inner.GetRecommendedContinueSlotAsync();
+        public UniTask<SaveMeta[]> GetAllMetaAsync() => _inner.GetAllMetaAsync();
+    }
+
+    /// <summary>DataSaver provider 侧的访问介导；仅约束经 ShrinkCtx.Get 取得的能力。</summary>
+    internal sealed class ShrinkDataSaverAccessPolicy : IShrinkCoeffectAccessPolicy
+    {
+        private readonly ShrinkDataSaverReadOnlyService _readOnly;
+
+        public ShrinkDataSaverAccessPolicy(ShrinkDataSaverService full)
+        {
+            _readOnly = new ShrinkDataSaverReadOnlyService(
+                full ?? throw new ArgumentNullException(nameof(full)));
+        }
+
+        public object? Resolve(ShrinkCoeffectAccessContext context, object? value)
+        {
+            if (!context.TryGetMetadata<string>(ShrinkDataSaverAccess.MetadataKey, out var access) ||
+                !string.Equals(access, ShrinkDataSaverAccess.ReadOnly, StringComparison.Ordinal))
+                return value;
+
+            if (typeof(IShrinkDataSaverWriter).IsAssignableFrom(context.RequestedType) ||
+                context.RequestedType == typeof(ShrinkDataSaverService))
+            {
+                throw new ShrinkCoeffectAccessDeniedException(context.Key,
+                    "the current context grants read-only DataSaver access");
+            }
+
+            if (context.RequestedType == typeof(object) || context.RequestedType.IsInstanceOfType(_readOnly))
+                return _readOnly;
+
+            throw new ShrinkCoeffectAccessDeniedException(context.Key,
+                $"read-only DataSaver view cannot satisfy requested type '{context.RequestedType.FullName}'");
+        }
+    }
+}

Runtime/ShrinkDataSaverAppInstaller.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9eea84dd572634c438c99aef69c51d9f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData:
+  assetBundleName:
+  assetBundleVariant: