feat: add NuGet and Godot distribution

.gitea/workflows/publish-nuget.yml

@@ -0,0 +1,52 @@
+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 }}
+    steps:
+      - name: Checkout 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 }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          tag="${GITEA_REF#refs/tags/}"
+          version="$(node -p "require('./package.json').version")"
+          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
+          fi

.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,7 @@ Tools~/
 *.sln
 *.user
 *.DotSettings.user
+DotNet~/
+Godot~/
+NuGet.Config
+Directory.Build.props

CHANGELOG.md

@@ -2,6 +2,24 @@
 
 本文件记录 `ShrinkApp.Starter.Basic` 的包内变更。
 
+## [0.2.2] - 2026-08-28
+
+### Changed
+
+- 默认组合精确依赖 `ShrinkEventBus 2.0.1` 对应的 App、Context 与 EventBus 集成版本。
+
+## [0.2.1] - 2026-08-28
+
+### Changed
+
+- 默认组合精确依赖新的 App、Context App Adapter、Command App、DataSaver、DataSaver App/EventBus 与 Network App 稳定版本。
+
+## [0.1.2] - 2026-08-26
+
+### Fixed
+
+- 使用声明 Unity JSON Serialize 模块的 `ShrinkContext.AppAdapter` 版本，保证最小消费者项目可完成解析与编译。
+
 ## [0.1.1] - 2026-08-26
 
 ### Fixed

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>

DotNet~/Runtime/ShrinkBasicComposition.cs

@@ -0,0 +1,34 @@
+#nullable enable
+
+using System.Collections.Generic;
+using ShrinkApp;
+using ShrinkCommand.Integration.App;
+using ShrinkContext;
+using ShrinkContext.AppAdapter;
+using ShrinkDataSaver.Integration.App;
+using ShrinkNetwork.Integration.App;
+
+namespace ShrinkApp.Starter.Basic;
+
+public static class ShrinkBasicComposition
+{
+    public static ShrinkContextAppHost CreateHost(ShrinkAppServices? services = null)
+    {
+        var host = new ShrinkContextAppHost(services);
+        host.Register<ShrinkCommandAppComponent>("shrink.command");
+        host.Register<ShrinkDataSaverAppComponent>("shrink.datasaver");
+        host.Register<ShrinkNetworkAppComponent>("shrink.network");
+        return host;
+    }
+
+    public static IReadOnlyList<ShrinkLoaderEntry> CreateEntries(ShrinkAppServices services,
+        ShrinkNetworkAppModuleConfig? network = null) => new[]
+    {
+        new ShrinkLoaderEntry("datasaver", "shrink.datasaver", services),
+        new ShrinkLoaderEntry("command", "shrink.command", services),
+        new ShrinkLoaderEntry("network", "shrink.network", network ?? new ShrinkNetworkAppModuleConfig
+        {
+            Services = services
+        })
+    };
+}

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

@@ -0,0 +1,21 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>netstandard2.1</TargetFramework>
+    <EnableDefaultCompileItems>false</EnableDefaultCompileItems>
+    <AssemblyName>ShrinkApp.Starter.Basic</AssemblyName>
+    <RootNamespace>ShrinkApp.Starter.Basic</RootNamespace>
+    <PackageId>ShrinkSDK.App.Starter.Basic</PackageId>
+    <Version>0.3.0</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.Context.Core" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.Context.AppAdapter" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.Command.Integration.App" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.DataSaver.Integration.App" Version="0.2.0" />
+    <PackageReference Include="ShrinkSDK.Network.Integration.App" Version="0.2.0" />
+  </ItemGroup>
+</Project>

Editor/ShrinkAppBasicStarterGenerator.cs

@@ -10,8 +10,8 @@ namespace ShrinkApp.Starter.Basic.Editor
 {
     public static class ShrinkAppBasicStarterGenerator
     {
-        private const string MenuPath = "ShrinkApp/Starter/生成 Basic Entry 场景";
-        private const string CompositionMenuPath = "ShrinkApp/Starter/创建默认 Cordis Composition";
+        private const string MenuPath = "ShrinkSDK/应用/基础起步/生成入口场景";
+        private const string CompositionMenuPath = "ShrinkSDK/应用/基础起步/创建默认 Context 组合";
         private const string CompositionPath = "Assets/Resources/ShrinkAppComposition.asset";
 
         [MenuItem(MenuPath)]

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>

README.md

@@ -2,6 +2,8 @@
 
 `ShrinkApp.Starter.Basic` 是 `ShrinkApp` 的最小起盘 Starter。目标不是提供完整游戏模板，而是让项目在导入最小基础包后，能快速得到一个可运行的入口场景、基础配置和最小示例流程。
 
+Godot 和普通 .NET 项目安装 `ShrinkSDK.App.Starter.Basic`；可打包源码位于 `DotNet~`。
+
 在 `ShrinkAppSettings.hostingMode = ContextLoader` 时，Starter 组合根会把 Command、DataSaver、Network 三个已发现模块替换为原生 `IShrinkComponent`，并把兼容用的服务门面作为可逆效应挂回 `ShrinkApp.Services`。因此 Starter 调试台仍可使用原来的服务 API，同时模块 disable/enable 由 `ShrinkContextLoader` 增量协调。
 
 ## 当前能力
@@ -14,7 +16,7 @@
 - 生成最小示例 UI 与 `ShrinkAppBasicSampleController`
 - 演示 `ShrinkApp + ShrinkDataSaver + Command + Network` 的最小闭环
 
-可以单独执行 `ShrinkApp/Starter/创建默认 Cordis Composition` 创建或修复组合资产，不需要重建场景。
+可以单独执行 `ShrinkSDK/应用/基础起步/创建默认 Context 组合` 创建或修复组合资产，不需要重建场景。
 
 当前示例场景内置的最小入口已经扩成一个小型调试台，包括：
 

Runtime/ShrinkAppBasicStarterSettings.cs

@@ -4,7 +4,7 @@ using UnityEngine;
 
 namespace ShrinkApp.Starter.Basic
 {
-    [CreateAssetMenu(fileName = "ShrinkAppBasicStarterSettings", menuName = "ShrinkApp/Starter/Basic Settings")]
+    [CreateAssetMenu(fileName = "ShrinkAppBasicStarterSettings", menuName = "ShrinkSDK/应用/基础起步设置")]
     public class ShrinkAppBasicStarterSettings : ScriptableObject
     {
         public bool autoBindLoopbackTransport;

package.json

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