fix: download release SDK directly from Microsoft Blob

.gitea/workflows/publish-nuget.yml

@@ -0,0 +1,124 @@
+name: Publish NuGet packages
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    env:
+      NUGET_AUTH_TOKEN: ${{ secrets.SHRINKSDK_PACKAGE_TOKEN }}
+      DOTNET_SYSTEM_GLOBALIZATION_INVARIANT: '1'
+      DOTNET_CLI_TELEMETRY_OPTOUT: '1'
+      LD_LIBRARY_PATH: /opt/dotnet-libs/usr/lib/x86_64-linux-gnu
+      SSL_CERT_FILE: /opt/ca-certificates.crt
+    steps:
+      - name: Fetch exact tagged source
+        env:
+          GITEA_REF: ${{ gitea.ref }}
+          GITEA_REPOSITORY: ${{ gitea.repository }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          tag="${GITEA_REF#refs/tags/}"
+          case "$tag" in
+            v[0-9]*) ;;
+            *) echo "Expected a version tag ref, got: $GITEA_REF" >&2; exit 1 ;;
+          esac
+          export SHRINKSDK_ARCHIVE_URL="https://git.crash.work/${GITEA_REPOSITORY}/archive/${tag}.tar.gz"
+          node --input-type=module <<'NODE'
+          import { writeFile } from 'node:fs/promises';
+
+          const response = await fetch(process.env.SHRINKSDK_ARCHIVE_URL);
+          if (!response.ok) {
+            throw new Error(`Release archive download failed: ${response.status} ${response.statusText}`);
+          }
+          await writeFile('release.tar.gz', new Uint8Array(await response.arrayBuffer()));
+          NODE
+          mkdir release
+          tar -xzf release.tar.gz --strip-components=1 -C release
+          rm -f release.tar.gz
+          printf '%s' "$tag" > release/.shrink-sdk-release-tag
+
+      - name: Install .NET 8 SDK
+        shell: bash
+        run: |
+          set -euo pipefail
+          node --input-type=module <<'NODE'
+          import { writeFile } from 'node:fs/promises';
+          import { rootCertificates } from 'node:tls';
+
+          await writeFile('/opt/ca-certificates.crt', rootCertificates.join('\n'));
+
+          const metadataResponse = await fetch('https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/8.0/releases.json');
+          if (!metadataResponse.ok) throw new Error(`Release metadata download failed: ${metadataResponse.status}`);
+          const metadata = await metadataResponse.json();
+          const sdkVersion = metadata['latest-sdk'];
+          const release = metadata.releases.find(item => item.sdk?.version === sdkVersion);
+          const file = release?.sdk?.files?.find(item => item.rid === 'linux-x64' && item.name.endsWith('.tar.gz'));
+          if (!file) throw new Error(`Linux x64 SDK archive not found for ${sdkVersion}`);
+          const archiveUrl = `https://dotnetcli.blob.core.windows.net/dotnet/Sdk/${sdkVersion}/dotnet-sdk-${sdkVersion}-linux-x64.tar.gz`;
+          const archiveResponse = await fetch(archiveUrl);
+          if (!archiveResponse.ok) throw new Error(`SDK download failed: ${archiveResponse.status}`);
+          await writeFile('/tmp/dotnet-sdk.tar.gz', new Uint8Array(await archiveResponse.arrayBuffer()));
+
+          const poolUrl = 'https://deb.debian.org/debian-security/pool/updates/main/o/openssl/';
+          const poolResponse = await fetch(poolUrl);
+          if (!poolResponse.ok) throw new Error(`OpenSSL package index download failed: ${poolResponse.status}`);
+          const poolIndex = await poolResponse.text();
+          const packages = [...poolIndex.matchAll(/href="(libssl3_[^"]+_amd64\.deb)"/g)].map(match => match[1]).sort();
+          const packageName = packages.at(-1);
+          if (!packageName) throw new Error('Debian libssl3 package was not found');
+          const packageResponse = await fetch(poolUrl + packageName);
+          if (!packageResponse.ok) throw new Error(`OpenSSL package download failed: ${packageResponse.status}`);
+          await writeFile('/tmp/libssl3.deb', new Uint8Array(await packageResponse.arrayBuffer()));
+          NODE
+          mkdir -p /opt/dotnet
+          tar -xzf /tmp/dotnet-sdk.tar.gz -C /opt/dotnet
+          mkdir -p /opt/dotnet-libs
+          dpkg-deb -x /tmp/libssl3.deb /opt/dotnet-libs
+          rm -f /tmp/dotnet-sdk.tar.gz
+          rm -f /tmp/libssl3.deb
+          /opt/dotnet/dotnet --info
+
+      - name: Validate, pack and publish
+        shell: bash
+        run: |
+          set -euo pipefail
+          : "${NUGET_AUTH_TOKEN:?SHRINKSDK_PACKAGE_TOKEN is required}"
+          export PATH="/opt/dotnet:$PATH"
+          cd release
+          tag="$(cat .shrink-sdk-release-tag)"
+          projects=()
+          if [[ -d DotNet~ ]]; then
+            while IFS= read -r -d '' project; do projects+=("$project"); done < <(find DotNet~ -type f -name '*.csproj' -print0)
+          fi
+          if [[ -d Godot~ ]]; then
+            while IFS= read -r -d '' project; do projects+=("$project"); done < <(find Godot~ -type f -name '*.csproj' -print0)
+          fi
+          if [[ "${#projects[@]}" -eq 0 ]]; then
+            while IFS= read -r -d '' project; do projects+=("$project"); done < <(find . -maxdepth 1 -type f -name '*.csproj' -print0)
+          fi
+          test "${#projects[@]}" -gt 0
+          if [[ -f package.json ]]; then
+            version="$(node -p "require('./package.json').version")"
+          else
+            version="$(dotnet msbuild "${projects[0]}" -getProperty:Version -nologo)"
+          fi
+          test "$tag" = "v$version"
+          mkdir -p packages
+          for project in "${projects[@]}"; do
+            dotnet restore "$project" --configfile NuGet.Config
+            dotnet pack "$project" --configuration Release --no-restore --output "$PWD/packages" --include-symbols --include-source
+          done
+          find packages -maxdepth 1 -name '*.nupkg' -type f | grep -q .
+          dotnet nuget push 'packages/*.nupkg' --api-key "$NUGET_AUTH_TOKEN" --source https://git.crash.work/api/packages/ShrinkSDK/nuget/index.json --skip-duplicate
+          if compgen -G 'packages/*.snupkg' > /dev/null; then
+            dotnet nuget push 'packages/*.snupkg' --api-key "$NUGET_AUTH_TOKEN" --source https://git.crash.work/api/packages/ShrinkSDK/nuget/index.json --skip-duplicate
+          fi

.gitea/workflows/publish.yml

@@ -15,22 +15,39 @@ jobs:
     env:
       NODE_AUTH_TOKEN: ${{ secrets.SHRINKSDK_PACKAGE_TOKEN }}
     steps:
-      - name: Fetch tagged revision
+      - name: Fetch exact tagged release archive
+        env:
+          GITEA_REF: ${{ gitea.ref }}
         shell: bash
         run: |
           set -eu
-          ref="${{ gitea.sha }}"
+          tag="${GITEA_REF#refs/tags/}"
-          test -n "$ref"
+          case "$tag" in
-          git init .
+            v[0-9]*) ;;
-          git remote add origin "https://git.crash.work/ShrinkSDK/ShrinkDataSaver.Integration.App.git"
+            *) echo "Expected a version tag ref, got: $GITEA_REF" >&2; exit 1 ;;
-          git fetch --depth=1 origin "$ref"
+          esac
-          git checkout --detach FETCH_HEAD
+          export SHRINKSDK_ARCHIVE_URL="https://git.crash.work/ShrinkSDK/ShrinkDataSaver.Integration.App/archive/${tag}.tar.gz"
+          node --input-type=module <<'NODE'
+          import { writeFile } from 'node:fs/promises';
+
+          const response = await fetch(process.env.SHRINKSDK_ARCHIVE_URL);
+          if (!response.ok) {
+            throw new Error(`Release archive download failed: ${response.status} ${response.statusText}`);
+          }
+
+          await writeFile('release.tar.gz', new Uint8Array(await response.arrayBuffer()));
+          NODE
+          mkdir release
+          tar -xzf release.tar.gz --strip-components=1 -C release
+          rm -f release.tar.gz
+          printf '%s' "$tag" > release/.shrink-sdk-release-tag
 
       - name: Validate immutable release version
         shell: bash
         run: |
           set -eu
-          tag="$(git describe --exact-match --tags HEAD)"
+          cd release
+          tag="$(cat .shrink-sdk-release-tag)"
           version="$(node -p "require('./package.json').version")"
           test "$tag" = "v$version"
           npm pack --dry-run
@@ -40,10 +57,11 @@ jobs:
         run: |
           set -eu
           : "${NODE_AUTH_TOKEN:?SHRINKSDK_PACKAGE_TOKEN is required}"
+          cd release
           npmrc="$HOME/.npmrc"
           cleanup() { rm -f "$npmrc"; }
           trap cleanup EXIT
           printf '%s\n' \
             'registry=https://git.crash.work/api/packages/ShrinkSDK/npm/' \
             '//git.crash.work/api/packages/ShrinkSDK/npm/:_authToken=${NODE_AUTH_TOKEN}' > "$npmrc"
-          npm publish --registry=https://git.crash.work/api/packages/ShrinkSDK/npm/
+          npm publish --registry=https://git.crash.work/api/packages/ShrinkSDK/npm/

.gitea/workflows/unity-verify.yml

@@ -26,12 +26,17 @@ jobs:
         shell: bash
         run: |
           set -eu
+          machine_id_file="/root/.local/share/unity3d/Unity/.machine-id"
+          if test -s "$machine_id_file"; then
+            cat "$machine_id_file" > /etc/machine-id
+            echo "Unity machine identity restored"
+          fi
+          git config --global url."https://ghfast.top/https://github.com/".insteadOf "https://github.com/"
           unity_bin="$(command -v unity-editor || command -v unity || command -v Unity || true)"
           test -n "$unity_bin"
           "$unity_bin" \
             -batchmode \
             -nographics \
-            -quit \
             -projectPath "$PWD/Development~/UnityProject" \
             -runTests \
             -testPlatform EditMode \

.gitignore

@@ -8,3 +8,11 @@
 /Tools~/**/[Oo]bj/
 *.user
 *.DotSettings.user
+/DotNet~/**/[Bb]in/
+/DotNet~/**/[Oo]bj/
+/Godot~/**/[Bb]in/
+/Godot~/**/[Oo]bj/
+/artifacts/
+/packages/
+!DotNet~/**/*.csproj
+!Godot~/**/*.csproj

.npmignore

@@ -6,3 +6,9 @@ Tools~/
 *.sln
 *.user
 *.DotSettings.user
+DotNet~/
+Godot~/
+NuGet.Config
+Directory.Build.props
+NuGet.Config.meta
+Directory.Build.props.meta

CHANGELOG.md

@@ -2,13 +2,35 @@
 
 本文件记录 `ShrinkDataSaver.Integration.App` 的包内变更。
 
-## [Unreleased]
+## [0.3.0] - 2026-11-06
+
+### Added
+
+- 新增 `ShrinkDataSaverAppModuleConfig`，可同时传入 `ShrinkAppServices` 和自定义 `ShrinkDataSaverRuntimeConfig`。
+- `ShrinkDataSaverAppComponent` 新增接收运行时配置的构造函数。
+
+### Changed
+
+- App 停止时等待 `ShrinkSettings.SaveAsync()` 完成，并把写入失败传播到停用链，不再 fire-and-forget。
+- 精确依赖 `ShrinkDataSaver 2.5.0`、`ShrinkSDK.Runtime.Abstractions 0.2.0`。
+
+## [0.1.3] - 2026-08-28
+
+### Changed
+
+- 精确依赖 `ShrinkApp.Core 0.1.4`。
+
+## [0.1.2] - 2026-08-28
 
 ### Added
 
 - 拆分 `IShrinkDataSaverReader` / `IShrinkDataSaverWriter` 能力契约。
 - 支持通过 ShrinkContext intercept 向派生上下文提供只读 DataSaver 视图。
 
+### Changed
+
+- 精确依赖 `ShrinkDataSaver 2.2.2` 与 `ShrinkApp.Core 0.1.3`。
+
 ## [0.1.0] - 2026-05-18
 
 ### Added

Development~/UnityProject/Packages/manifest.json

@@ -10,6 +10,10 @@
   ],
   "dependencies": {
     "com.unity.test-framework": "1.1.33",
-    "com.cneicy.shrink-datasaver-integration-app": "file:../../.."
+    "com.cneicy.shrink-datasaver-integration-app": "file:../../..",
-  }
+    "com.cysharp.unitask": "https://github.com/Cysharp/UniTask.git?path=src/UniTask/Assets/Plugins/UniTask#7c0f199fe0d3fc528024488ccd671e6c7b27745b"
+  },
+  "testables": [
+    "com.cneicy.shrink-datasaver-integration-app"
+  ]
 }

Directory.Build.props

@@ -0,0 +1,13 @@
+<Project>
+  <PropertyGroup>
+    <LangVersion>latest</LangVersion>
+    <Nullable>enable</Nullable>
+    <Deterministic>true</Deterministic>
+    <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
+    <Authors>ShrinkSDK</Authors>
+    <Company>ShrinkSDK</Company>
+    <RepositoryUrl>https://git.crash.work/ShrinkSDK</RepositoryUrl>
+    <IncludeSymbols>true</IncludeSymbols>
+    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
+  </PropertyGroup>
+</Project>

Directory.Build.props.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 9471d83c02842e34f8c79ad09bb2ff45
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

DotNet~/ShrinkSDK.DataSaver.Integration.App.csproj

@@ -0,0 +1,20 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>netstandard2.1</TargetFramework>
+    <EnableDefaultCompileItems>false</EnableDefaultCompileItems>
+    <AssemblyName>ShrinkDataSaver.Integration.App</AssemblyName>
+    <RootNamespace>ShrinkDataSaver.Integration.App</RootNamespace>
+    <PackageId>ShrinkSDK.DataSaver.Integration.App</PackageId>
+    <Version>0.3.1</Version>
+    <Description>ShrinkDataSaver and App host integration.</Description>
+    <ShrinkCodeGenEnabled>true</ShrinkCodeGenEnabled>
+  </PropertyGroup>
+  <ItemGroup>
+    <Compile Include="..\Runtime\*.cs" />
+    <PackageReference Include="ShrinkSDK.Runtime.Abstractions" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.Context.Core" Version="0.3.1" />
+    <PackageReference Include="ShrinkSDK.App.Core" Version="0.2.4" />
+    <PackageReference Include="ShrinkSDK.DataSaver" Version="2.5.0" />
+    <PackageReference Include="ShrinkSDK.CodeGen" Version="0.2.0" PrivateAssets="compile;runtime;contentfiles;native" />
+  </ItemGroup>
+</Project>

NuGet.Config

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <packageSources>
+    <clear />
+    <add key="ShrinkSDK" value="https://git.crash.work/api/packages/ShrinkSDK/nuget/index.json" />
+    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
+  </packageSources>
+</configuration>

NuGet.Config.meta

@@ -0,0 +1,32 @@
+fileFormatVersion: 2
+guid: 7f6931dff1cfed04c8d3c789636aaef5
+PluginImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  iconMap: {}
+  executionOrder: {}
+  defineConstraints: []
+  isPreloaded: 0
+  isOverridable: 0
+  isExplicitlyReferenced: 0
+  validateReferences: 1
+  platformData:
+  - first:
+      Any: 
+    second:
+      enabled: 0
+      settings: {}
+  - first:
+      Editor: Editor
+    second:
+      enabled: 0
+      settings:
+        DefaultValueInitialized: true
+  - first:
+      Windows Store Apps: WindowsStoreApps
+    second:
+      enabled: 1
+      settings: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

README.md

@@ -2,6 +2,8 @@
 
 `ShrinkDataSaver.Integration.App` 是 `ShrinkDataSaver` 与 `ShrinkApp.Core` 的桥接层。它的职责不是重新实现存档系统，而是把 `ShrinkDataSaver` 接到统一宿主链里，让项目在接入 `ShrinkApp` 时由宿主接管初始化顺序。
 
+Godot 和普通 .NET 项目安装 `ShrinkSDK.DataSaver.Integration.App`；可打包源码位于 `DotNet~`。
+
 ## 当前能力
 
 - 提供原生 `ShrinkDataSaverAppComponent`，发布 `shrink.service.datasaver`
@@ -27,3 +29,13 @@ var reader = communityContext.Get<IShrinkDataSaverReader>(
 ```
 
 这是服务能力的最小化暴露：只约束通过 `ShrinkCtx.Get` 解析该键的调用方。它不会限制代码绕过上下文后直接访问静态 API，也不构成不可信模组沙箱。
+
+## 可复用能力
+
+<!-- shrink:capabilities -->
+Capability: 把存档接到宿主，并区分读取与写入权限
+Aliases: 存档宿主 只读 read only
+Limits: intercept 的只读限制不能绕过；数据由业务模块持有
+Extension: IShrinkDataSaverReader/Writer 和访问策略
+Evidence: [ShrinkDataSaverAppComponent](Runtime/ShrinkDataSaverAppComponent.cs)
+<!-- /shrink:capabilities -->

Runtime/ShrinkDataSaverAppComponent.cs

@@ -21,6 +21,16 @@ namespace ShrinkDataSaver.Integration.App
         public const string ModuleKey = "app.module.shrink.datasaver";
 
         private static readonly string[] ProvideKeys = { ModuleKey, ServiceKey };
+        private readonly ShrinkDataSaverRuntimeConfig? _runtimeConfig;
+
+        public ShrinkDataSaverAppComponent()
+        {
+        }
+
+        public ShrinkDataSaverAppComponent(ShrinkDataSaverRuntimeConfig? runtimeConfig)
+        {
+            _runtimeConfig = runtimeConfig;
+        }
 
         public string Name => "shrink.datasaver";
 
@@ -28,18 +38,27 @@ namespace ShrinkDataSaver.Integration.App
 
         public IReadOnlyList<string> Provide => ProvideKeys;
 
-        public async UniTask ApplyAsync(ShrinkCtx ctx, object? config)
+        public UniTask ApplyAsync(ShrinkCtx ctx, object? config)
         {
-            // 编辑器/EditMode 环境下 DontDestroyOnLoad 会抛异常，驱动只在播放模式常驻
+            ShrinkAppServices? appServices = null;
-            ShrinkDataSaverRuntime.Initialize(new ShrinkDataSaverRuntimeConfig
+            var runtimeConfig = _runtimeConfig ?? CreateDefaultRuntimeConfig();
+            if (config is ShrinkDataSaverAppModuleConfig moduleConfig)
             {
-                DontDestroyOnLoadDriver = UnityEngine.Application.isPlaying
+                appServices = moduleConfig.Services;
-            });
+                if (moduleConfig.RuntimeConfig != null)
+                    runtimeConfig = moduleConfig.RuntimeConfig;
+            }
+            else if (config is ShrinkAppServices services)
+            {
+                appServices = services;
+            }
+
+            ShrinkDataSaverRuntime.Initialize(runtimeConfig);
             var facade = new ShrinkDataSaverService();
             ctx.Set(ServiceKey, facade, new ShrinkDataSaverAccessPolicy(facade));
             ctx.Set(ModuleKey, Name);
 
-            if (config is ShrinkAppServices appServices)
+            if (appServices != null)
             {
                 appServices.Register(facade);
                 ctx.EffectInverse(() =>
@@ -49,17 +68,24 @@ namespace ShrinkDataSaver.Integration.App
                 });
             }
 
-            await ctx.EffectAsync(async () =>
+            ctx.EffectInverse(async () =>
             {
-                await UniTask.CompletedTask;
+                await ShrinkSettings.SaveAsync();
-                return () =>
-                {
-                    // 终止动作（触发式）：停用时把防抖中的设置写盘。
-                    // 磁盘 IO 在线程池完成，不阻塞停用链；未初始化环境安全跳过（SaveAsync 守卫）。
-                    ShrinkSettings.SaveAsync().Forget();
-                    return UniTask.CompletedTask;
-                };
             });
+            return UniTask.CompletedTask;
+        }
+
+        private static ShrinkDataSaverRuntimeConfig CreateDefaultRuntimeConfig()
+        {
+            // 编辑器/EditMode 环境下 DontDestroyOnLoad 会抛异常，驱动只在播放模式常驻
+            return new ShrinkDataSaverRuntimeConfig
+            {
+#if UNITY_5_3_OR_NEWER
+                DontDestroyOnLoadDriver = UnityEngine.Application.isPlaying
+#else
+                DontDestroyOnLoadDriver = false
+#endif
+            };
         }
     }
 }

Runtime/ShrinkDataSaverAppModuleConfig.cs

@@ -0,0 +1,23 @@
+#nullable enable
+
+using ShrinkApp;
+
+namespace ShrinkDataSaver.Integration.App
+{
+    public sealed class ShrinkDataSaverAppModuleConfig
+    {
+        public ShrinkDataSaverAppModuleConfig()
+        {
+        }
+
+        public ShrinkDataSaverAppModuleConfig(ShrinkAppServices? services,
+            ShrinkDataSaverRuntimeConfig? runtimeConfig = null)
+        {
+            Services = services;
+            RuntimeConfig = runtimeConfig;
+        }
+
+        public ShrinkAppServices? Services { get; set; }
+        public ShrinkDataSaverRuntimeConfig? RuntimeConfig { get; set; }
+    }
+}

Runtime/ShrinkDataSaverAppModuleConfig.cs.meta

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

package.json

@@ -1,14 +1,14 @@
 {
   "name": "com.cneicy.shrink-datasaver-integration-app",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "displayName": "ShrinkDataSaver - App Integration",
   "description": "ShrinkDataSaver 与 ShrinkApp 的桥接层，提供宿主接管初始化与服务注册。",
   "unity": "2022.3",
   "dependencies": {
-    "com.cneicy.shrink-datasaver": "2.2.0",
+    "com.cneicy.shrink-datasaver": "2.5.0",
-    "com.cneicy.shrink-app-core": "0.1.1",
+    "com.cneicy.shrink-app-core": "0.2.4",
     "com.cysharp.unitask": "2.5.10",
-    "com.cneicy.shrink-context-core": "0.1.0"
+    "com.cneicy.shrink-context-core": "0.3.1"
   },
   "keywords": [
     "save",