依赖注入引入DI容器

packages/core/src/Core/ServiceContainer.ts

@@ -1,4 +1,5 @@
 import { createLogger } from '../Utils/Logger';
+import { isUpdatable as checkUpdatable, getUpdatableMetadata } from './DI';
 
 const logger = createLogger('ServiceContainer');
 
@@ -16,8 +17,10 @@ export interface IService {
 
 /**
  * 服务类型
+ *
+ * 支持任意构造函数签名，以便与依赖注入装饰器配合使用
  */
-export type ServiceType<T extends IService> = new (...args: unknown[]) => T;
+export type ServiceType<T extends IService> = new (...args: any[]) => T;
 
 /**
  * 服务生命周期
@@ -99,6 +102,14 @@ export class ServiceContainer {
      */
     private _resolving: Set<ServiceType<IService>> = new Set();
 
+    /**
+     * 可更新的服务列表
+     *
+     * 自动收集所有使用@Updatable装饰器标记的服务，供Core统一更新
+     * 按优先级排序（数值越小越先执行）
+     */
+    private _updatableServices: Array<{ instance: any; priority: number }> = [];
+
     /**
      * 注册单例服务
      *
@@ -192,6 +203,18 @@ export class ServiceContainer {
             lifetime: ServiceLifetime.Singleton
         });
 
+        // 如果使用了@Updatable装饰器，添加到可更新列表
+        if (checkUpdatable(type)) {
+            const metadata = getUpdatableMetadata(type);
+            const priority = metadata?.priority ?? 0;
+            this._updatableServices.push({ instance, priority });
+
+            // 按优先级排序（数值越小越先执行）
+            this._updatableServices.sort((a, b) => a.priority - b.priority);
+
+            logger.debug(`Service ${type.name} is updatable (priority: ${priority}), added to update list`);
+        }
+
         logger.debug(`Registered service instance: ${type.name}`);
     }
 
@@ -243,6 +266,18 @@ export class ServiceContainer {
             // 如果是单例，缓存实例
             if (registration.lifetime === ServiceLifetime.Singleton) {
                 registration.instance = instance;
+
+                // 如果使用了@Updatable装饰器，添加到可更新列表
+                if (checkUpdatable(registration.type)) {
+                    const metadata = getUpdatableMetadata(registration.type);
+                    const priority = metadata?.priority ?? 0;
+                    this._updatableServices.push({ instance, priority });
+
+                    // 按优先级排序（数值越小越先执行）
+                    this._updatableServices.sort((a, b) => a.priority - b.priority);
+
+                    logger.debug(`Service ${type.name} is updatable (priority: ${priority}), added to update list`);
+                }
             }
 
             return instance as T;
@@ -300,6 +335,12 @@ export class ServiceContainer {
 
         // 如果有单例实例，调用 dispose
         if (registration.instance) {
+            // 从可更新列表中移除
+            const index = this._updatableServices.findIndex(item => item.instance === registration.instance);
+            if (index !== -1) {
+                this._updatableServices.splice(index, 1);
+            }
+
             registration.instance.dispose();
         }
 
@@ -320,6 +361,7 @@ export class ServiceContainer {
         }
 
         this._services.clear();
+        this._updatableServices = [];
         logger.debug('Cleared all services');
     }
 
@@ -331,4 +373,51 @@ export class ServiceContainer {
     public getRegisteredServices(): ServiceType<IService>[] {
         return Array.from(this._services.keys());
     }
+
+    /**
+     * 更新所有使用@Updatable装饰器标记的服务
+     *
+     * 此方法会按优先级顺序遍历所有可更新的服务并调用它们的update方法。
+     * 所有服务在注册时已经由@Updatable装饰器验证过必须实现IUpdatable接口。
+     * 通常在Core的主更新循环中调用。
+     *
+     * @param deltaTime - 可选的帧时间间隔（秒）
+     *
+     * @example
+     * ```typescript
+     * // 在Core的update方法中
+     * this._serviceContainer.updateAll(deltaTime);
+     * ```
+     */
+    public updateAll(deltaTime?: number): void {
+        for (const { instance } of this._updatableServices) {
+            instance.update(deltaTime);
+        }
+    }
+
+    /**
+     * 获取所有可更新的服务数量
+     *
+     * @returns 可更新服务的数量
+     */
+    public getUpdatableCount(): number {
+        return this._updatableServices.length;
+    }
+
+    /**
+     * 获取所有已实例化的服务实例
+     *
+     * @returns 所有服务实例的数组
+     */
+    public getAll(): IService[] {
+        const instances: IService[] = [];
+
+        for (const descriptor of this._services.values()) {
+            if (descriptor.instance) {
+                instances.push(descriptor.instance);
+            }
+        }
+
+        return instances;
+    }
 }