Method addEntity

packages/core/src/ECS/Core/QuerySystem.ts:106–124

* 添加单个实体到查询系统 * * 将新实体添加到查询系统中，并自动更新相关索引。 * 为了提高批量添加性能，可以延迟缓存清理。 * * @param entity 要添加的实体 * @param deferCacheClear 是否延迟缓存清理（用于批量操作）

(entity: Entity, deferCacheClear: boolean = false)

     * @param deferCacheClear 是否延迟缓存清理（用于批量操作）
     */
    public addEntity(entity: Entity, deferCacheClear: boolean = false): void {
        if (!this._entities.includes(entity)) {
            this._entities.push(entity);
            this.addEntityToIndexes(entity);

            this._archetypeSystem.addEntity(entity);

            // 通知响应式查询
            this.notifyReactiveQueriesEntityAdded(entity);

            // 只有在非延迟模式下才立即清理缓存
            if (!deferCacheClear) {
                this.clearQueryCache();
            }

            // 更新版本号
            this._version++;
        }
    }

    /**
     * 批量添加实体