Function App

packages/editor-app/src/App.tsx:96–1540

()

const isFrameDebuggerMode = new URLSearchParams(window.location.search).get('mode') === 'frame-debugger';

function App() {
    const initRef = useRef(false);
    const layoutContainerRef = useRef<FlexLayoutDockContainerHandle>(null);
    const [pluginLoader] = useState(() => new PluginLoader());
    const { showToast, hideToast } = useToast();

    // 如果是独立调试窗口模式，只渲染调试面板 | If standalone debugger mode, only render debug panel
    if (isFrameDebuggerMode) {
        return (
            <div style={{ width: '100vw', height: '100vh', overflow: 'hidden' }}>
                <RenderDebugPanel visible={true} onClose={() => window.close()} standalone />
            </div>
        );
    }

    // ===== 本地初始化状态（只用于初始化阶段）| Local init state (only for initialization) =====
    const [initialized, setInitialized] = useState(false);

    // ===== 从 EditorStore 获取状态 | Get state from EditorStore =====
    const {
        projectLoaded, setProjectLoaded,
        currentProjectPath, setCurrentProjectPath,
        availableScenes, setAvailableScenes,
        isLoading, setIsLoading,
        loadingMessage,
        panels, setPanels,
        activeDynamicPanels, addDynamicPanel, removeDynamicPanel, clearDynamicPanels,
        dynamicPanelTitles, setDynamicPanelTitle,
        activePanelId, setActivePanelId,
        pluginUpdateTrigger, triggerPluginUpdate,
        isRemoteConnected, setIsRemoteConnected,
        isContentBrowserDocked, setIsContentBrowserDocked,
        isEditorFullscreen, setIsEditorFullscreen,
        status, setStatus,
        showProjectWizard, setShowProjectWizard,
        settingsInitialCategory, setSettingsInitialCategory,
        compilerDialog, openCompilerDialog, closeCompilerDialog,
    } = useEditorStore();

    // ===== 服务实例用 useRef（不触发重渲染）| Service instances use useRef (no re-renders) =====
    const pluginManagerRef = useRef<PluginManager | null>(null);
    const entityStoreRef = useRef<EntityStoreService | null>(null);
    const messageHubRef = useRef<MessageHub | null>(null);
    const inspectorRegistryRef = useRef<InspectorRegistry | null>(null);
    const logServiceRef = useRef<LogService | null>(null);
    const uiRegistryRef = useRef<UIRegistry | null>(null);
    const settingsRegistryRef = useRef<SettingsRegistry | null>(null);
    const sceneManagerRef = useRef<SceneManagerService | null>(null);
    const notificationRef = useRef<INotification | null>(null);
    const dialogRef = useRef<IDialogExtended | null>(null);
    const buildServiceRef = useRef<BuildService | null>(null);
    const projectServiceRef = useRef<ProjectService | null>(null);

    // 兼容层：提供 getter 访问服务 | Compatibility layer: provide getter access to services
    const pluginManager = pluginManagerRef.current;
    const entityStore = entityStoreRef.current;
    const messageHub = messageHubRef.current;
    const inspectorRegistry = inspectorRegistryRef.current;