Method addEntityProcessor

packages/core/src/ECS/Scene.ts:1081–1145

* 在场景中添加一个EntitySystem处理器 * * 支持两种使用方式： * 1. 传入类型（推荐）：自动使用DI创建实例，支持@Injectable和@InjectProperty装饰器 * 2. 传入实例：直接使用提供的实例 * * @param systemTypeOrInstance 系统类型或系统实例 * @returns 添加的处理器实例 * * @example * ```typescript * // 方式1：传入类型，自动DI（推荐） * @Injec

(systemTypeOrInstance: ServiceType<T> | T)

     * ```
     */
    public addEntityProcessor<T extends EntitySystem>(systemTypeOrInstance: ServiceType<T> | T): T {
        let system: T;
        let constructor: ServiceType<T>;

        if (typeof systemTypeOrInstance === 'function') {
            constructor = systemTypeOrInstance;

            if (this._services.isRegistered(constructor)) {
                const existingSystem = this._services.resolve(constructor) as T;
                this._logger.debug(`System ${constructor.name} already registered, returning existing instance`);
                return existingSystem;
            }

            if (isInjectable(constructor)) {
                system = createInstance(constructor, this._services) as T;
            } else {
                system = new constructor() as T;
            }
        } else {
            system = systemTypeOrInstance;
            constructor = system.constructor as ServiceType<T>;

            if (this._services.isRegistered(constructor)) {
                const existingSystem = this._services.resolve(constructor);
                if (existingSystem === system) {
                    this._logger.debug(`System ${constructor.name} instance already registered, returning it`);
                    return system;
                } else {
                    this._logger.warn(
                        `Attempting to register a different instance of ${constructor.name}, ` +
                            'but type is already registered. Returning existing instance.'
                    );
                    return existingSystem as T;
                }
            }
        }

        system.scene = this;
        system.addOrder = this._systemAddCounter++; // for stable sorting
        system.setPerformanceMonitor(this.performanceMonitor);

        const metadata = getSystemMetadata(constructor);
        if (metadata?.updateOrder !== undefined) {
            system.setUpdateOrder(metadata.updateOrder);
        }
        if (metadata?.enabled !== undefined) {
            system.enabled = metadata.enabled;
        }

        this._services.registerInstance(constructor, system);
        this.markSystemsOrderDirty();
        this.indexSystemByComponents(system);
        injectProperties(system, this._services);

        // Auto-wrap system methods for profiling in debug mode
        if (ProfilerSDK.isEnabled()) {
            AutoProfiler.wrapInstance(system, system.systemName, ProfileCategory.ECS);
        }