Method extractPersistentEntities

packages/core/src/ECS/Scene.ts:928–938

* 提取持久化实体（从场景中分离但不销毁） * * 用于场景切换时收集需要迁移的实体。 * * Extract persistent entities (detach from scene without destroying). * Used during scene transitions to collect entities for migration. * * @returns 被提取的持久化实体数组 | Array of extracted persistent entities * * @i

()

     * @internal
     */
    public extractPersistentEntities(): Entity[] {
        const persistentEntities = this.findPersistentEntities();

        for (const entity of persistentEntities) {
            this.entities.remove(entity);
            this.querySystem.removeEntity(entity);
            entity.scene = null; // detach but preserve component data
        }

        return persistentEntities;
    }

    /**
     * 接收迁移的实体