fix: download release SDK directly from Microsoft Blob

.gitea/workflows/publish-nuget.yml

@@ -14,38 +14,110 @@ jobs:
       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: Checkout tagged source
+      - name: Fetch exact tagged source
-        uses: actions/checkout@v4
-
-      - name: Set up .NET
-        uses: actions/setup-dotnet@v4
-        with:
-          dotnet-version: '8.0.x'
-
-      - name: Validate tag and pack projects
         env:
           GITEA_REF: ${{ gitea.ref }}
+          GITEA_REPOSITORY: ${{ gitea.repository }}
         shell: bash
         run: |
           set -euo pipefail
           tag="${GITEA_REF#refs/tags/}"
-          version="$(node -p "require('./package.json').version")"
+          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
-          mapfile -d '' projects < <(find DotNet~ Godot~ -type f -name '*.csproj' -print0 2>/dev/null || true)
-          test "${#projects[@]}" -gt 0
           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 .
-
-      - name: Publish packages
-        shell: bash
-        run: |
-          set -euo pipefail
-          : "${NUGET_AUTH_TOKEN:?SHRINKSDK_PACKAGE_TOKEN is required}"
           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

.npmignore

@@ -10,3 +10,5 @@ DotNet~/
 Godot~/
 NuGet.Config
 Directory.Build.props
+NuGet.Config.meta
+Directory.Build.props.meta

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 本文件记录 `ShrinkApp.Starter.Basic` 的包内变更。
 
+## [0.4.0] - 2026-11-06
+
+### Added
+
+- `ShrinkBasicComposition.CreateEntries(...)` 接受 `ShrinkDataSaverAppModuleConfig`，可把自定义存储或运行时配置传入默认组合。
+- `ShrinkAppBasicContextComposition.Configure(host, ShrinkDataSaverRuntimeConfig)` 支持在 Context 组合中覆盖 DataSaver 配置。
+
+### Changed
+
+- 默认组合升级到 `ShrinkDataSaver 2.5.0` 与 `ShrinkDataSaver.Integration.App 0.3.0`。
+
 ## [0.2.2] - 2026-08-28
 
 ### Changed

Directory.Build.props.meta

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

DotNet~/Runtime/ShrinkBasicComposition.cs

@@ -22,9 +22,15 @@ public static class ShrinkBasicComposition
     }
 
     public static IReadOnlyList<ShrinkLoaderEntry> CreateEntries(ShrinkAppServices services,
-        ShrinkNetworkAppModuleConfig? network = null) => new[]
+        ShrinkNetworkAppModuleConfig? network = null) => CreateEntries(services,
+            network, new ShrinkDataSaverAppModuleConfig(services));
+
+    public static IReadOnlyList<ShrinkLoaderEntry> CreateEntries(ShrinkAppServices services,
+        ShrinkNetworkAppModuleConfig? network,
+        ShrinkDataSaverAppModuleConfig dataSaver) => new[]
     {
-        new ShrinkLoaderEntry("datasaver", "shrink.datasaver", services),
+        new ShrinkLoaderEntry("datasaver", "shrink.datasaver",
+            dataSaver ?? new ShrinkDataSaverAppModuleConfig(services)),
         new ShrinkLoaderEntry("command", "shrink.command", services),
         new ShrinkLoaderEntry("network", "shrink.network", network ?? new ShrinkNetworkAppModuleConfig
         {

DotNet~/ShrinkSDK.App.Starter.Basic.csproj

@@ -5,17 +5,17 @@
     <AssemblyName>ShrinkApp.Starter.Basic</AssemblyName>
     <RootNamespace>ShrinkApp.Starter.Basic</RootNamespace>
     <PackageId>ShrinkSDK.App.Starter.Basic</PackageId>
-    <Version>0.3.0</Version>
+    <Version>0.4.1</Version>
     <Description>Engine-neutral basic ShrinkApp composition.</Description>
     <ShrinkCodeGenEnabled>false</ShrinkCodeGenEnabled>
   </PropertyGroup>
   <ItemGroup>
     <Compile Include="Runtime\*.cs" />
-    <PackageReference Include="ShrinkSDK.App.Core" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.App.Core" Version="0.2.4" />
-    <PackageReference Include="ShrinkSDK.Context.Core" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.Context.Core" Version="0.3.1" />
-    <PackageReference Include="ShrinkSDK.Context.AppAdapter" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.Context.AppAdapter" Version="0.2.5" />
-    <PackageReference Include="ShrinkSDK.Command.Integration.App" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.Command.Integration.App" Version="0.2.6" />
-    <PackageReference Include="ShrinkSDK.DataSaver.Integration.App" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.DataSaver.Integration.App" Version="0.3.1" />
-    <PackageReference Include="ShrinkSDK.Network.Integration.App" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.Network.Integration.App" Version="0.2.6" />
   </ItemGroup>
 </Project>

NuGet.Config.meta

@@ -0,0 +1,32 @@
+fileFormatVersion: 2
+guid: 2d2841b519d2ca74d81604457c6e9742
+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

@@ -47,3 +47,13 @@ Godot 和普通 .NET 项目安装 `ShrinkSDK.App.Starter.Basic`；可打包源
 - 是否把命令输出打印到控制台
 - 启动时是否自动执行默认命令
 - 命令输出区最多保留多少行
+
+## 可复用能力
+
+<!-- shrink:capabilities -->
+Capability: 组合 Command、DataSaver、Network，提供最小启动与调试样例
+Aliases: 起盘 启动应用 starter 样例 演示
+Limits: 不预置背包、战斗或任务系统；场景对象属于宿主主线程
+Extension: Starter settings 和 Context 组合条目
+Evidence: [ShrinkAppBasicSampleController](Runtime/ShrinkAppBasicSampleController.cs)
+<!-- /shrink:capabilities -->

Runtime/ShrinkAppBasicContextComposition.cs

@@ -5,6 +5,7 @@ using System.Linq;
 using ShrinkCommand.Integration.App;
 using ShrinkCommand.Integration;
 using ShrinkContext.AppAdapter;
+using ShrinkDataSaver;
 using ShrinkDataSaver.Integration.App;
 using ShrinkDataSaver.Integration;
 using ShrinkNetwork.Integration.App;
@@ -39,13 +40,20 @@ namespace ShrinkApp.Starter.Basic
         }
 
         public static void Configure(ShrinkAppLoaderHost host)
+        {
+            Configure(host, null);
+        }
+
+        public static void Configure(ShrinkAppLoaderHost host,
+            ShrinkDataSaverRuntimeConfig? dataSaverRuntimeConfig)
         {
             if (host == null)
                 throw new System.ArgumentNullException(nameof(host));
 
             RegisterOrReplace(host, "shrink.network", static () => new ShrinkNetworkAppComponent());
             RegisterOrReplace(host, "shrink.command", static () => new ShrinkCommandAppComponent());
-            RegisterOrReplace(host, "shrink.datasaver", static () => new ShrinkDataSaverAppComponent());
+            RegisterOrReplace(host, "shrink.datasaver",
+                () => new ShrinkDataSaverAppComponent(dataSaverRuntimeConfig));
             host.AddModuleComponent("shrink.integration.command-network",
                 static () => new ShrinkCommandNetworkIntegrationComponent());
             host.AddModuleComponent("shrink.integration.command-eventbus",

package.json

@@ -1,23 +1,23 @@
 {
   "name": "com.cneicy.shrink-app-starter-basic",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "displayName": "ShrinkApp Starter Basic",
   "description": "ShrinkApp 最小起盘 Starter，提供向导、入口场景和 DataSaver 示例。",
   "unity": "2022.3",
   "dependencies": {
-    "com.cneicy.shrink-app-core": "0.2.0",
+    "com.cneicy.shrink-app-core": "0.2.4",
-    "com.cneicy.shrink-context-core": "0.2.0",
+    "com.cneicy.shrink-context-core": "0.3.1",
-    "com.cneicy.shrink-context-app-adapter": "0.2.0",
+    "com.cneicy.shrink-context-app-adapter": "0.2.5",
-    "com.cneicy.shrink-command": "0.3.0",
+    "com.cneicy.shrink-command": "0.4.3",
-    "com.cneicy.shrink-command-integration-app": "0.2.0",
+    "com.cneicy.shrink-command-integration-app": "0.2.6",
-    "com.cneicy.shrink-datasaver": "2.3.0",
+    "com.cneicy.shrink-datasaver": "2.5.0",
-    "com.cneicy.shrink-datasaver-integration-app": "0.2.0",
+    "com.cneicy.shrink-datasaver-integration-app": "0.3.1",
-    "com.cneicy.shrink-network": "0.3.0",
+    "com.cneicy.shrink-network": "0.4.3",
-    "com.cneicy.shrink-network-integration-app": "0.2.0",
+    "com.cneicy.shrink-network-integration-app": "0.2.6",
-    "com.cneicy.shrink-command-integration-eventbus": "0.2.0",
+    "com.cneicy.shrink-command-integration-eventbus": "0.2.6",
-    "com.cneicy.shrink-datasaver-integration-eventbus": "2.2.0",
+    "com.cneicy.shrink-datasaver-integration-eventbus": "2.2.6",
-    "com.cneicy.shrink-network-integration-eventbus": "0.2.0",
+    "com.cneicy.shrink-network-integration-eventbus": "0.2.6",
-    "com.cneicy.shrink-command-integration-network": "0.2.0",
+    "com.cneicy.shrink-command-integration-network": "0.2.6",
     "com.unity.ugui": "1.0.0",
     "com.cysharp.unitask": "2.5.10"
   },