From daff1fa12b6e55aa003066af4efb3878f8667eba Mon Sep 17 00:00:00 2001
From: GeWuYou <95328647+GeWuYou@users.noreply.github.com>
Date: Mon, 23 Feb 2026 08:51:48 +0800
Subject: [PATCH] =?UTF-8?q?feat(architecture):=20=E9=9B=86=E6=88=90Arch=20?=
 =?UTF-8?q?ECS=E6=A1=86=E6=9E=B6=E5=B9=B6=E5=8D=87=E7=BA=A7=E7=9B=AE?=
 =?UTF-8?q?=E6=A0=87=E6=A1=86=E6=9E=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在ArchitectureContext中添加ECS世界和系统调度器支持
- 添加IEcsWorld和IEcsSystem接口定义
- 实现EcsWorld、EcsSystemBase和EcsSystemRunner核心类
- 添加Position和Velocity示例组件及MovementSystem示例
- 创建ECS使用示例代码
- 将多个项目的TargetFramework从netstandard2.0升级到netstandard2.1
- 添加Arch和Arch.System包依赖到核心项目
- 在测试项目中添加ECS相关接口的模拟实现
---
 .../Directory.Build.props                     |  4 +-
 .../GFramework.Core.Abstractions.csproj       |  3 +-
 .../architecture/IArchitectureContext.cs      | 15 +++++
 .../ecs/IEcsSystem.cs                         | 20 ++++++
 GFramework.Core.Abstractions/ecs/IEcsWorld.cs | 44 ++++++++++++
 .../architecture/ArchitectureServicesTests.cs | 11 +++
 .../architecture/GameContextTests.cs          | 11 +++
 GFramework.Core/GFramework.Core.csproj        |  2 +
 .../architecture/ArchitectureContext.cs       | 59 ++++++++++++++++
 GFramework.Core/ecs/EcsSystemBase.cs          | 62 +++++++++++++++++
 GFramework.Core/ecs/EcsSystemRunner.cs        | 66 ++++++++++++++++++
 GFramework.Core/ecs/EcsWorld.cs               | 66 ++++++++++++++++++
 GFramework.Core/ecs/components/Position.cs    | 16 +++++
 GFramework.Core/ecs/components/Velocity.cs    | 16 +++++
 .../ecs/examples/EcsUsageExample.cs           | 67 +++++++++++++++++++
 GFramework.Core/ecs/systems/MovementSystem.cs | 31 +++++++++
 .../Directory.Build.props                     |  2 +-
 .../GFramework.Game.Abstractions.csproj       |  2 +-
 .../internals/IsExternalInit.cs               |  2 +-
 .../Directory.Build.props                     |  2 +-
 ...Godot.SourceGenerators.Abstractions.csproj |  2 +-
 .../GFramework.Godot.SourceGenerators.csproj  |  2 +-
 .../Directory.Build.props                     |  2 +-
 ...ework.SourceGenerators.Abstractions.csproj |  2 +-
 .../Directory.Build.props                     |  2 +-
 .../GFramework.SourceGenerators.Common.csproj |  2 +-
 .../GFramework.SourceGenerators.csproj        |  2 +-
 27 files changed, 501 insertions(+), 14 deletions(-)
 create mode 100644 GFramework.Core.Abstractions/ecs/IEcsSystem.cs
 create mode 100644 GFramework.Core.Abstractions/ecs/IEcsWorld.cs
 create mode 100644 GFramework.Core/ecs/EcsSystemBase.cs
 create mode 100644 GFramework.Core/ecs/EcsSystemRunner.cs
 create mode 100644 GFramework.Core/ecs/EcsWorld.cs
 create mode 100644 GFramework.Core/ecs/components/Position.cs
 create mode 100644 GFramework.Core/ecs/components/Velocity.cs
 create mode 100644 GFramework.Core/ecs/examples/EcsUsageExample.cs
 create mode 100644 GFramework.Core/ecs/systems/MovementSystem.cs

diff --git a/GFramework.Core.Abstractions/Directory.Build.props b/GFramework.Core.Abstractions/Directory.Build.props
index 1e6c3bf..7417131 100644
--- a/GFramework.Core.Abstractions/Directory.Build.props
+++ b/GFramework.Core.Abstractions/Directory.Build.props
@@ -1,7 +1,7 @@
-<Project>
+<Project>
     <!-- import parent: https://docs.microsoft.com/en-us/visualstudio/msbuild/customize-your-build -->
     <PropertyGroup>
-        <TargetFramework>netstandard2.0</TargetFramework>
+        <TargetFramework>netstandard2.1</TargetFramework>
         <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
         <EmbedUntrackedSources>true</EmbedUntrackedSources>
         <!--
diff --git a/GFramework.Core.Abstractions/GFramework.Core.Abstractions.csproj b/GFramework.Core.Abstractions/GFramework.Core.Abstractions.csproj
index c4ade71..b6f3b06 100644
--- a/GFramework.Core.Abstractions/GFramework.Core.Abstractions.csproj
+++ b/GFramework.Core.Abstractions/GFramework.Core.Abstractions.csproj
@@ -17,7 +17,7 @@
         <Using Include="GFramework.Core.Abstractions"/>
     </ItemGroup>
     <ItemGroup>
-        <PackageReference Update="Meziantou.Analyzer" Version="3.0.9">
+        <PackageReference Update="Meziantou.Analyzer" Version="3.0.12">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
         </PackageReference>
@@ -25,6 +25,7 @@
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
         </PackageReference>
+        <PackageReference Include="Arch" Version="2.1.0"/>
         <PackageReference Include="Mediator.Abstractions" Version="3.0.1"/>
     </ItemGroup>
 </Project>
diff --git a/GFramework.Core.Abstractions/architecture/IArchitectureContext.cs b/GFramework.Core.Abstractions/architecture/IArchitectureContext.cs
index 496d228..38f5a43 100644
--- a/GFramework.Core.Abstractions/architecture/IArchitectureContext.cs
+++ b/GFramework.Core.Abstractions/architecture/IArchitectureContext.cs
@@ -1,4 +1,5 @@
 using GFramework.Core.Abstractions.command;
+using GFramework.Core.Abstractions.ecs;
 using GFramework.Core.Abstractions.environment;
 using GFramework.Core.Abstractions.events;
 using GFramework.Core.Abstractions.model;
@@ -205,4 +206,18 @@ public interface IArchitectureContext
     /// </summary>
     /// <returns>环境对象实例</returns>
     IEnvironment GetEnvironment();
+
+    // === ECS 支持 ===
+
+    /// <summary>
+    ///     获取ECS世界实例
+    /// </summary>
+    /// <returns>ECS世界实例</returns>
+    IEcsWorld GetEcsWorld();
+
+    /// <summary>
+    ///     注册ECS系统
+    /// </summary>
+    /// <typeparam name="T">ECS系统类型</typeparam>
+    void RegisterEcsSystem<T>() where T : class, IEcsSystem;
 }
\ No newline at end of file
diff --git a/GFramework.Core.Abstractions/ecs/IEcsSystem.cs b/GFramework.Core.Abstractions/ecs/IEcsSystem.cs
new file mode 100644
index 0000000..ca94bff
--- /dev/null
+++ b/GFramework.Core.Abstractions/ecs/IEcsSystem.cs
@@ -0,0 +1,20 @@
+using GFramework.Core.Abstractions.system;
+
+namespace GFramework.Core.Abstractions.ecs;
+
+/// <summary>
+///     ECS系统接口，继承自ISystem以集成到现有架构
+/// </summary>
+public interface IEcsSystem : ISystem
+{
+    /// <summary>
+    ///     系统优先级，数值越小越先执行
+    /// </summary>
+    int Priority { get; }
+
+    /// <summary>
+    ///     每帧更新
+    /// </summary>
+    /// <param name="deltaTime">帧间隔时间（秒）</param>
+    void Update(float deltaTime);
+}
\ No newline at end of file
diff --git a/GFramework.Core.Abstractions/ecs/IEcsWorld.cs b/GFramework.Core.Abstractions/ecs/IEcsWorld.cs
new file mode 100644
index 0000000..e271ed6
--- /dev/null
+++ b/GFramework.Core.Abstractions/ecs/IEcsWorld.cs
@@ -0,0 +1,44 @@
+using Arch.Core;
+
+namespace GFramework.Core.Abstractions.ecs;
+
+/// <summary>
+///     ECS世界接口，封装Arch的World实例
+/// </summary>
+public interface IEcsWorld : IDisposable
+{
+    /// <summary>
+    ///     当前实体数量
+    /// </summary>
+    int EntityCount { get; }
+
+    /// <summary>
+    ///     获取内部的Arch World实例（用于高级操作）
+    /// </summary>
+    World InternalWorld { get; }
+
+    /// <summary>
+    ///     创建一个新实体
+    /// </summary>
+    /// <param name="types">组件类型数组</param>
+    /// <returns>创建的实体</returns>
+    Entity CreateEntity(params ComponentType[] types);
+
+    /// <summary>
+    ///     销毁指定实体
+    /// </summary>
+    /// <param name="entity">要销毁的实体</param>
+    void DestroyEntity(Entity entity);
+
+    /// <summary>
+    ///     检查实体是否存活
+    /// </summary>
+    /// <param name="entity">要检查的实体</param>
+    /// <returns>实体是否存活</returns>
+    bool IsAlive(Entity entity);
+
+    /// <summary>
+    ///     清空所有实体
+    /// </summary>
+    void Clear();
+}
\ No newline at end of file
diff --git a/GFramework.Core.Tests/architecture/ArchitectureServicesTests.cs b/GFramework.Core.Tests/architecture/ArchitectureServicesTests.cs
index 110bcfe..fcce9a4 100644
--- a/GFramework.Core.Tests/architecture/ArchitectureServicesTests.cs
+++ b/GFramework.Core.Tests/architecture/ArchitectureServicesTests.cs
@@ -1,5 +1,6 @@
 using GFramework.Core.Abstractions.architecture;
 using GFramework.Core.Abstractions.command;
+using GFramework.Core.Abstractions.ecs;
 using GFramework.Core.Abstractions.environment;
 using GFramework.Core.Abstractions.events;
 using GFramework.Core.Abstractions.ioc;
@@ -356,6 +357,16 @@ public class TestArchitectureContextV3 : IArchitectureContext
     {
         return _environment;
     }
+
+    public IEcsWorld GetEcsWorld()
+    {
+        throw new NotImplementedException("ECS not implemented in test context");
+    }
+
+    public void RegisterEcsSystem<T>() where T : class, IEcsSystem
+    {
+        throw new NotImplementedException("ECS not implemented in test context");
+    }
 }
 
 #endregion
\ No newline at end of file
diff --git a/GFramework.Core.Tests/architecture/GameContextTests.cs b/GFramework.Core.Tests/architecture/GameContextTests.cs
index 90575be..3089ed1 100644
--- a/GFramework.Core.Tests/architecture/GameContextTests.cs
+++ b/GFramework.Core.Tests/architecture/GameContextTests.cs
@@ -1,5 +1,6 @@
 using GFramework.Core.Abstractions.architecture;
 using GFramework.Core.Abstractions.command;
+using GFramework.Core.Abstractions.ecs;
 using GFramework.Core.Abstractions.environment;
 using GFramework.Core.Abstractions.events;
 using GFramework.Core.Abstractions.ioc;
@@ -451,4 +452,14 @@ public class TestArchitectureContext : IArchitectureContext
     {
         return Environment;
     }
+
+    public IEcsWorld GetEcsWorld()
+    {
+        throw new NotImplementedException("ECS not implemented in test context");
+    }
+
+    public void RegisterEcsSystem<T>() where T : class, IEcsSystem
+    {
+        throw new NotImplementedException("ECS not implemented in test context");
+    }
 }
\ No newline at end of file
diff --git a/GFramework.Core/GFramework.Core.csproj b/GFramework.Core/GFramework.Core.csproj
index dbe8741..5433802 100644
--- a/GFramework.Core/GFramework.Core.csproj
+++ b/GFramework.Core/GFramework.Core.csproj
@@ -14,5 +14,7 @@
         <PackageReference Include="LanguageExt.Core" Version="4.4.9"/>
         <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="10.0.3"/>
         <PackageReference Include="Microsoft.Bcl.AsyncInterfaces" Version="8.0.0"/>
+        <PackageReference Include="Arch" Version="2.1.0"/>
+        <PackageReference Include="Arch.System" Version="1.1.0"/>
     </ItemGroup>
 </Project>
diff --git a/GFramework.Core/architecture/ArchitectureContext.cs b/GFramework.Core/architecture/ArchitectureContext.cs
index 0e3a4a3..27a347f 100644
--- a/GFramework.Core/architecture/ArchitectureContext.cs
+++ b/GFramework.Core/architecture/ArchitectureContext.cs
@@ -1,5 +1,6 @@
 using GFramework.Core.Abstractions.architecture;
 using GFramework.Core.Abstractions.command;
+using GFramework.Core.Abstractions.ecs;
 using GFramework.Core.Abstractions.environment;
 using GFramework.Core.Abstractions.events;
 using GFramework.Core.Abstractions.ioc;
@@ -7,6 +8,7 @@ using GFramework.Core.Abstractions.model;
 using GFramework.Core.Abstractions.query;
 using GFramework.Core.Abstractions.system;
 using GFramework.Core.Abstractions.utility;
+using GFramework.Core.ecs;
 using Mediator;
 using ICommand = GFramework.Core.Abstractions.command.ICommand;
 
@@ -19,6 +21,8 @@ public class ArchitectureContext(IIocContainer container) : IArchitectureContext
 {
     private readonly IIocContainer _container = container ?? throw new ArgumentNullException(nameof(container));
     private readonly Dictionary<Type, object> _serviceCache = new();
+    private EcsSystemRunner? _ecsRunner;
+    private EcsWorld? _ecsWorld;
 
     #region Mediator Integration (新实现)
 
@@ -412,4 +416,59 @@ public class ArchitectureContext(IIocContainer container) : IArchitectureContext
     }
 
     #endregion
+
+    #region ECS Support
+
+    /// <summary>
+    ///     获取ECS世界实例
+    /// </summary>
+    /// <returns>ECS世界实例</returns>
+    public IEcsWorld GetEcsWorld()
+    {
+        return _ecsWorld ??
+               throw new InvalidOperationException("ECS World not initialized. Call InitializeEcs() first.");
+    }
+
+    /// <summary>
+    ///     注册ECS系统
+    /// </summary>
+    /// <typeparam name="T">ECS系统类型</typeparam>
+    public void RegisterEcsSystem<T>() where T : class, IEcsSystem
+    {
+        // 使用RegisterPlurality注册到所有接口
+        _container.RegisterPlurality<T>();
+    }
+
+    /// <summary>
+    ///     初始化ECS（在架构初始化时调用）
+    /// </summary>
+    public void InitializeEcs()
+    {
+        if (_ecsWorld != null) return;
+
+        // 创建ECS世界
+        _ecsWorld = new EcsWorld();
+        _container.Register(_ecsWorld);
+
+        // 注册系统调度器
+        _container.RegisterPlurality<EcsSystemRunner>();
+        _ecsRunner = _container.Get<EcsSystemRunner>();
+    }
+
+    /// <summary>
+    ///     获取ECS系统调度器
+    /// </summary>
+    internal EcsSystemRunner? GetEcsRunner() => _ecsRunner;
+
+    /// <summary>
+    ///     销毁ECS资源
+    /// </summary>
+    private void DisposeEcs()
+    {
+        _ecsWorld?.Dispose();
+        _ecsWorld = null;
+        _ecsRunner = null;
+    }
+
+    #endregion
 }
\ No newline at end of file
diff --git a/GFramework.Core/ecs/EcsSystemBase.cs b/GFramework.Core/ecs/EcsSystemBase.cs
new file mode 100644
index 0000000..b22ad76
--- /dev/null
+++ b/GFramework.Core/ecs/EcsSystemBase.cs
@@ -0,0 +1,62 @@
+using Arch.Core;
+using GFramework.Core.Abstractions.ecs;
+using GFramework.Core.system;
+
+namespace GFramework.Core.ecs;
+
+/// <summary>
+///     ECS系统基类，继承自AbstractSystem以集成到现有架构
+/// </summary>
+public abstract class EcsSystemBase : AbstractSystem, IEcsSystem
+{
+    /// <summary>
+    ///     ECS世界实例
+    /// </summary>
+    protected EcsWorld EcsWorld { get; private set; } = null!;
+
+    /// <summary>
+    ///     快捷访问内部World
+    /// </summary>
+    protected World World => EcsWorld.InternalWorld;
+
+    /// <summary>
+    ///     系统优先级，默认为0
+    /// </summary>
+    public virtual int Priority => 0;
+
+    /// <summary>
+    ///     每帧更新（子类实现）
+    /// </summary>
+    public abstract void Update(float deltaTime);
+
+    /// <summary>
+    ///     系统初始化
+    /// </summary>
+    protected override void OnInit()
+    {
+        EcsWorld = Context.GetService<EcsWorld>() ?? throw new InvalidOperationException(
+            "EcsWorld not found in context. Make sure ECS is properly initialized.");
+
+        OnEcsInit();
+    }
+
+    /// <summary>
+    ///     系统销毁
+    /// </summary>
+    protected override void OnDestroy()
+    {
+        OnEcsDestroy();
+    }
+
+    /// <summary>
+    ///     ECS系统初始化（子类实现）
+    /// </summary>
+    protected abstract void OnEcsInit();
+
+    /// <summary>
+    ///     ECS系统销毁（子类可选实现）
+    /// </summary>
+    protected virtual void OnEcsDestroy()
+    {
+    }
+}
\ No newline at end of file
diff --git a/GFramework.Core/ecs/EcsSystemRunner.cs b/GFramework.Core/ecs/EcsSystemRunner.cs
new file mode 100644
index 0000000..b08fbc0
--- /dev/null
+++ b/GFramework.Core/ecs/EcsSystemRunner.cs
@@ -0,0 +1,66 @@
+using GFramework.Core.Abstractions.ecs;
+using GFramework.Core.system;
+
+namespace GFramework.Core.ecs;
+
+/// <summary>
+///     ECS系统调度器，负责管理和更新所有ECS系统
+/// </summary>
+public sealed class EcsSystemRunner : AbstractSystem
+{
+    private readonly List<IEcsSystem> _systems = new();
+    private bool _isRunning;
+
+    /// <summary>
+    ///     初始化调度器，从DI容器获取所有ECS系统
+    /// </summary>
+    protected override void OnInit()
+    {
+        // 从容器获取所有已注册的ECS系统
+        var systemsList = Context.GetService<IReadOnlyList<IEcsSystem>>();
+        if (systemsList != null && systemsList.Count > 0)
+        {
+            // 按优先级排序
+            _systems.AddRange(systemsList.OrderBy(s => s.Priority));
+        }
+    }
+
+    /// <summary>
+    ///     更新所有ECS系统
+    /// </summary>
+    /// <param name="deltaTime">帧间隔时间</param>
+    public void Update(float deltaTime)
+    {
+        if (!_isRunning) return;
+
+        foreach (var system in _systems)
+        {
+            system.Update(deltaTime);
+        }
+    }
+
+    /// <summary>
+    ///     启动调度器
+    /// </summary>
+    public void Start()
+    {
+        _isRunning = true;
+    }
+
+    /// <summary>
+    ///     停止调度器
+    /// </summary>
+    public void Stop()
+    {
+        _isRunning = false;
+    }
+
+    /// <summary>
+    ///     销毁调度器
+    /// </summary>
+    protected override void OnDestroy()
+    {
+        Stop();
+        _systems.Clear();
+    }
+}
\ No newline at end of file
diff --git a/GFramework.Core/ecs/EcsWorld.cs b/GFramework.Core/ecs/EcsWorld.cs
new file mode 100644
index 0000000..a0241cf
--- /dev/null
+++ b/GFramework.Core/ecs/EcsWorld.cs
@@ -0,0 +1,66 @@
+using Arch.Core;
+using GFramework.Core.Abstractions.ecs;
+
+namespace GFramework.Core.ecs;
+
+/// <summary>
+///     ECS世界实现，封装Arch的World实例
+/// </summary>
+public sealed class EcsWorld : IEcsWorld
+{
+    private readonly World _world = World.Create();
+    private bool _disposed;
+
+    /// <summary>
+    ///     获取内部的Arch World实例
+    /// </summary>
+    public World InternalWorld => _world;
+
+    /// <summary>
+    ///     当前实体数量
+    /// </summary>
+    public int EntityCount => _world.Size;
+
+    /// <summary>
+    ///     创建一个新实体
+    /// </summary>
+    public Entity CreateEntity(params ComponentType[] types)
+    {
+        return _world.Create(types);
+    }
+
+    /// <summary>
+    ///     销毁指定实体
+    /// </summary>
+    public void DestroyEntity(Entity entity)
+    {
+        _world.Destroy(entity);
+    }
+
+    /// <summary>
+    ///     检查实体是否存活
+    /// </summary>
+    public bool IsAlive(Entity entity)
+    {
+        return _world.IsAlive(entity);
+    }
+
+    /// <summary>
+    ///     清空所有实体
+    /// </summary>
+    public void Clear()
+    {
+        _world.Clear();
+    }
+
+    /// <summary>
+    ///     释放资源
+    /// </summary>
+    public void Dispose()
+    {
+        if (_disposed) return;
+
+        World.Destroy(_world);
+        _disposed = true;
+    }
+}
\ No newline at end of file
diff --git a/GFramework.Core/ecs/components/Position.cs b/GFramework.Core/ecs/components/Position.cs
new file mode 100644
index 0000000..1743454
--- /dev/null
+++ b/GFramework.Core/ecs/components/Position.cs
@@ -0,0 +1,16 @@
+namespace GFramework.Core.ecs.components;
+
+/// <summary>
+///     位置组件
+/// </summary>
+public struct Position
+{
+    public float X;
+    public float Y;
+
+    public Position(float x, float y)
+    {
+        X = x;
+        Y = y;
+    }
+}
\ No newline at end of file
diff --git a/GFramework.Core/ecs/components/Velocity.cs b/GFramework.Core/ecs/components/Velocity.cs
new file mode 100644
index 0000000..c277724
--- /dev/null
+++ b/GFramework.Core/ecs/components/Velocity.cs
@@ -0,0 +1,16 @@
+namespace GFramework.Core.ecs.components;
+
+/// <summary>
+///     速度组件
+/// </summary>
+public struct Velocity
+{
+    public float X;
+    public float Y;
+
+    public Velocity(float x, float y)
+    {
+        X = x;
+        Y = y;
+    }
+}
\ No newline at end of file
diff --git a/GFramework.Core/ecs/examples/EcsUsageExample.cs b/GFramework.Core/ecs/examples/EcsUsageExample.cs
new file mode 100644
index 0000000..9048076
--- /dev/null
+++ b/GFramework.Core/ecs/examples/EcsUsageExample.cs
@@ -0,0 +1,67 @@
+using Arch.Core;
+using GFramework.Core.Abstractions.architecture;
+using GFramework.Core.ecs.components;
+
+namespace GFramework.Core.ecs.examples;
+
+/// <summary>
+///     ECS使用示例 - 演示如何创建和管理实体
+/// </summary>
+public static class EcsUsageExample
+{
+    /// <summary>
+    ///     示例1: 创建移动的敌人实体
+    /// </summary>
+    public static void CreateMovingEnemies(IArchitectureContext context, int count)
+    {
+        var ecsWorld = context.GetEcsWorld();
+        var world = ecsWorld.InternalWorld;
+
+        for (int i = 0; i < count; i++)
+        {
+            // 创建实体
+            var entity = ecsWorld.CreateEntity(
+                new ComponentType[]
+                {
+                    typeof(Position),
+                    typeof(Velocity)
+                }
+            );
+
+            // 设置初始位置和速度
+            world.Set(entity, new Position(i * 10, 0));
+
+            var random = new Random();
+            world.Set(entity, new Velocity(
+                (float)(random.NextDouble() * 100 - 50),
+                (float)(random.NextDouble() * 100 - 50)
+            ));
+        }
+    }
+
+    /// <summary>
+    ///     示例2: 批量清理实体
+    /// </summary>
+    public static void ClearAllEntities(IArchitectureContext context)
+    {
+        var ecsWorld = context.GetEcsWorld();
+        ecsWorld.Clear();
+    }
+
+    /// <summary>
+    ///     示例3: 查询特定实体
+    /// </summary>
+    public static int CountMovingEntities(IArchitectureContext context)
+    {
+        var ecsWorld = context.GetEcsWorld();
+        var world = ecsWorld.InternalWorld;
+
+        int count = 0;
+        var query = new QueryDescription()
+            .WithAll<Position, Velocity>();
+
+        world.Query(in query, (Entity entity) => { count++; });
+
+        return count;
+    }
+}
\ No newline at end of file
diff --git a/GFramework.Core/ecs/systems/MovementSystem.cs b/GFramework.Core/ecs/systems/MovementSystem.cs
new file mode 100644
index 0000000..20206b5
--- /dev/null
+++ b/GFramework.Core/ecs/systems/MovementSystem.cs
@@ -0,0 +1,31 @@
+using Arch.Core;
+using GFramework.Core.ecs.components;
+
+namespace GFramework.Core.ecs.systems;
+
+/// <summary>
+///     移动系统示例 - 根据速度更新位置
+/// </summary>
+public class MovementSystem : EcsSystemBase
+{
+    private QueryDescription _query;
+
+    public override int Priority => 0;
+
+    protected override void OnEcsInit()
+    {
+        // 创建查询：查找所有同时拥有Position和Velocity组件的实体
+        _query = new QueryDescription()
+            .WithAll<Position, Velocity>();
+    }
+
+    public override void Update(float deltaTime)
+    {
+        // 查询并更新所有符合条件的实体
+        World.Query(in _query, (ref Position pos, ref Velocity vel) =>
+        {
+            pos.X += vel.X * deltaTime;
+            pos.Y += vel.Y * deltaTime;
+        });
+    }
+}
\ No newline at end of file
diff --git a/GFramework.Game.Abstractions/Directory.Build.props b/GFramework.Game.Abstractions/Directory.Build.props
index 1e6c3bf..ef6dc3c 100644
--- a/GFramework.Game.Abstractions/Directory.Build.props
+++ b/GFramework.Game.Abstractions/Directory.Build.props
@@ -1,7 +1,7 @@
 <Project>
     <!-- import parent: https://docs.microsoft.com/en-us/visualstudio/msbuild/customize-your-build -->
     <PropertyGroup>
-        <TargetFramework>netstandard2.0</TargetFramework>
+        <TargetFramework>netstandard2.1</TargetFramework>
         <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
         <EmbedUntrackedSources>true</EmbedUntrackedSources>
         <!--
diff --git a/GFramework.Game.Abstractions/GFramework.Game.Abstractions.csproj b/GFramework.Game.Abstractions/GFramework.Game.Abstractions.csproj
index ca26c3d..91ca3f3 100644
--- a/GFramework.Game.Abstractions/GFramework.Game.Abstractions.csproj
+++ b/GFramework.Game.Abstractions/GFramework.Game.Abstractions.csproj
@@ -19,7 +19,7 @@
         <Using Include="GFramework.Game.Abstractions"/>
     </ItemGroup>
     <ItemGroup>
-        <PackageReference Update="Meziantou.Analyzer" Version="3.0.9">
+        <PackageReference Update="Meziantou.Analyzer" Version="3.0.12">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
         </PackageReference>
diff --git a/GFramework.Game.Abstractions/internals/IsExternalInit.cs b/GFramework.Game.Abstractions/internals/IsExternalInit.cs
index b433836..0eb9a6e 100644
--- a/GFramework.Game.Abstractions/internals/IsExternalInit.cs
+++ b/GFramework.Game.Abstractions/internals/IsExternalInit.cs
@@ -2,7 +2,7 @@
 // This type is required to support init-only setters and record types
 // when targeting netstandard2.0 or older frameworks.
 
-#if NETSTANDARD2_0 || NETFRAMEWORK || NETCOREAPP2_0
+#if NETSTANDARD2_1 || NETFRAMEWORK || NETCOREAPP2_1
 using System.ComponentModel;
 
 namespace System.Runtime.CompilerServices;
diff --git a/GFramework.Godot.SourceGenerators.Abstractions/Directory.Build.props b/GFramework.Godot.SourceGenerators.Abstractions/Directory.Build.props
index 82f43af..7417131 100644
--- a/GFramework.Godot.SourceGenerators.Abstractions/Directory.Build.props
+++ b/GFramework.Godot.SourceGenerators.Abstractions/Directory.Build.props
@@ -1,7 +1,7 @@
 <Project>
     <!-- import parent: https://docs.microsoft.com/en-us/visualstudio/msbuild/customize-your-build -->
     <PropertyGroup>
-        <TargetFramework>netstandard2.0</TargetFramework>
+        <TargetFramework>netstandard2.1</TargetFramework>
         <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
         <EmbedUntrackedSources>true</EmbedUntrackedSources>
         <!--
diff --git a/GFramework.Godot.SourceGenerators.Abstractions/GFramework.Godot.SourceGenerators.Abstractions.csproj b/GFramework.Godot.SourceGenerators.Abstractions/GFramework.Godot.SourceGenerators.Abstractions.csproj
index e31e4e3..cd05a9d 100644
--- a/GFramework.Godot.SourceGenerators.Abstractions/GFramework.Godot.SourceGenerators.Abstractions.csproj
+++ b/GFramework.Godot.SourceGenerators.Abstractions/GFramework.Godot.SourceGenerators.Abstractions.csproj
@@ -19,7 +19,7 @@
         <Folder Include="logging\"/>
     </ItemGroup>
     <ItemGroup>
-        <PackageReference Update="Meziantou.Analyzer" Version="3.0.9">
+        <PackageReference Update="Meziantou.Analyzer" Version="3.0.12">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
         </PackageReference>
diff --git a/GFramework.Godot.SourceGenerators/GFramework.Godot.SourceGenerators.csproj b/GFramework.Godot.SourceGenerators/GFramework.Godot.SourceGenerators.csproj
index c62c5dd..eb6dd82 100644
--- a/GFramework.Godot.SourceGenerators/GFramework.Godot.SourceGenerators.csproj
+++ b/GFramework.Godot.SourceGenerators/GFramework.Godot.SourceGenerators.csproj
@@ -2,7 +2,7 @@
 
     <PropertyGroup>
         <PackageId>GeWuYou.$(AssemblyName)</PackageId>
-        <TargetFramework>netstandard2.0</TargetFramework>
+        <TargetFramework>netstandard2.1</TargetFramework>
 
         <!-- 这是 Analyzer，不是运行时库 -->
         <IsRoslynAnalyzer>true</IsRoslynAnalyzer>
diff --git a/GFramework.SourceGenerators.Abstractions/Directory.Build.props b/GFramework.SourceGenerators.Abstractions/Directory.Build.props
index 82f43af..7417131 100644
--- a/GFramework.SourceGenerators.Abstractions/Directory.Build.props
+++ b/GFramework.SourceGenerators.Abstractions/Directory.Build.props
@@ -1,7 +1,7 @@
 <Project>
     <!-- import parent: https://docs.microsoft.com/en-us/visualstudio/msbuild/customize-your-build -->
     <PropertyGroup>
-        <TargetFramework>netstandard2.0</TargetFramework>
+        <TargetFramework>netstandard2.1</TargetFramework>
         <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
         <EmbedUntrackedSources>true</EmbedUntrackedSources>
         <!--
diff --git a/GFramework.SourceGenerators.Abstractions/GFramework.SourceGenerators.Abstractions.csproj b/GFramework.SourceGenerators.Abstractions/GFramework.SourceGenerators.Abstractions.csproj
index 485b720..b195c2c 100644
--- a/GFramework.SourceGenerators.Abstractions/GFramework.SourceGenerators.Abstractions.csproj
+++ b/GFramework.SourceGenerators.Abstractions/GFramework.SourceGenerators.Abstractions.csproj
@@ -18,7 +18,7 @@
         <ProjectReference Include="..\GFramework.Core.Abstractions\GFramework.Core.Abstractions.csproj" PrivateAssets="all"/>
     </ItemGroup>
     <ItemGroup>
-        <PackageReference Update="Meziantou.Analyzer" Version="3.0.9">
+        <PackageReference Update="Meziantou.Analyzer" Version="3.0.12">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
         </PackageReference>
diff --git a/GFramework.SourceGenerators.Common/Directory.Build.props b/GFramework.SourceGenerators.Common/Directory.Build.props
index 82f43af..7417131 100644
--- a/GFramework.SourceGenerators.Common/Directory.Build.props
+++ b/GFramework.SourceGenerators.Common/Directory.Build.props
@@ -1,7 +1,7 @@
 <Project>
     <!-- import parent: https://docs.microsoft.com/en-us/visualstudio/msbuild/customize-your-build -->
     <PropertyGroup>
-        <TargetFramework>netstandard2.0</TargetFramework>
+        <TargetFramework>netstandard2.1</TargetFramework>
         <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
         <EmbedUntrackedSources>true</EmbedUntrackedSources>
         <!--
diff --git a/GFramework.SourceGenerators.Common/GFramework.SourceGenerators.Common.csproj b/GFramework.SourceGenerators.Common/GFramework.SourceGenerators.Common.csproj
index 05a40ab..11d9ae4 100644
--- a/GFramework.SourceGenerators.Common/GFramework.SourceGenerators.Common.csproj
+++ b/GFramework.SourceGenerators.Common/GFramework.SourceGenerators.Common.csproj
@@ -22,7 +22,7 @@
             <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
         </PackageReference>
         <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.14.0" PrivateAssets="all"/>
-        <PackageReference Update="Meziantou.Analyzer" Version="3.0.9">
+        <PackageReference Update="Meziantou.Analyzer" Version="3.0.12">
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
         </PackageReference>
diff --git a/GFramework.SourceGenerators/GFramework.SourceGenerators.csproj b/GFramework.SourceGenerators/GFramework.SourceGenerators.csproj
index d02cbdc..3db2499 100644
--- a/GFramework.SourceGenerators/GFramework.SourceGenerators.csproj
+++ b/GFramework.SourceGenerators/GFramework.SourceGenerators.csproj
@@ -2,7 +2,7 @@
 
     <PropertyGroup>
         <PackageId>GeWuYou.$(AssemblyName)</PackageId>
-        <TargetFramework>netstandard2.0</TargetFramework>
+        <TargetFramework>netstandard2.1</TargetFramework>
 
         <!-- 这是 Analyzer，不是运行时库 -->
         <IsRoslynAnalyzer>true</IsRoslynAnalyzer>