@vlian/framework 1.1.1 → 1.2.16

package/dist/core/startup/renderApp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/startup/renderApp.tsx"],"sourcesContent":["/**\n * 应用渲染模块\n * 负责渲染React应用\n */\n\nimport { createRoot } from 'react-dom/client';\nimport type { Root } from 'react-dom/client';\nimport { StrictMode } from 'react';\nimport type { Container, RootOptions } from 'react-dom/client';\nimport { BasicLayout, DefaultApp, AppContextProvider } from '../app';\nimport type { LangType } from '../../library/locale/types';\nimport { ErrorBoundary } from '../error';\nimport { InitializationErrorThrower } from '../initialization';\nimport type { StartOptions } from '../types';\nimport type { InitializationContext } from '../initialization';\nimport type { MonitoringService } from '../../utils/monitoring';\nimport type { StateManager } from '../../state';\nimport { SplashScreen } from '../splash';\nimport { SecurityUtils } from '../../utils/security';\nimport { getRouterManager } from '../router/RouterManager';\nimport { RouterProvider } from \"react-router-dom\";\n\n/**\n * 应用渲染器\n */\nexport class AppRenderer {\n  private root: Root | null = null;\n  private container: Container | null = null;\n\n  /**\n   * 初始化渲染器\n   * \n   * @param container - React应用的挂载容器\n   * @param rootOptions - React根节点配置选项\n   */\n  initialize(container: Container, rootOptions?: RootOptions): void {\n    this.container = container;\n    if (!this.root) {\n      this.root = createRoot(container, rootOptions);\n    }\n  }\n\n  /**\n   * 渲染应用\n   * \n   * 优化：\n   * 1. 默认启用安全防护（XSS防护）\n   * 2. 优化组件渲染性能\n   * 3. 缓存计算结果，避免重复计算\n   * \n   * @param options - 启动配置选项\n   * @param services - 服务实例\n   * @param context - 初始化上下文（可选）\n   */\n  async renderApp(\n    options: StartOptions,\n    services: {\n      monitoring: MonitoringService;\n      stateManager: StateManager;\n    },\n    context?: InitializationContext\n  ): Promise<void> {\n    if (!this.root) {\n      throw new Error('渲染器未初始化，请先调用 initialize()');\n    }\n\n    // 获取初始语言（从 locale 配置中推断，或使用默认值）\n    const initialLocale: LangType = options.locale\n      ? (Object.keys(options.locale)[0] as LangType) || 'zh-CN'\n      : 'zh-CN';\n\n    // 检查路由是否已启用\n    // 路由启用的条件：配置了 router 且 enabled !== false 且 enabled !== 'disabled'\n    const routerEnabled = options.router\n      ? options.router.enabled !== false && options.router.enabled !== 'disabled'\n      : false;\n    \n    // 检查路由管理器是否已初始化（运行时状态）\n    const routerManager = getRouterManager();\n    const router = routerManager.getRouter();\n    // const isRouterInitialized = routerManager.isRouterEnabled();\n\n    // 如果路由已启用且已初始化，使用 RouterProvider（路由系统接管渲染）\n    // 否则直接渲染应用内容（不使用路由系统）\n    const shouldUseRouter = routerEnabled && router !== null;\n\n    // 安全性增强：应用默认安全策略\n    // 默认启用 XSS 防护、配置验证和用户输入清理\n    const securityConfig = {\n      enableXSSProtection: options.security?.enableXSSProtection ?? true,\n      validateConfig: options.security?.validateConfig ?? true,\n      sanitizeUserInput: options.security?.sanitizeUserInput ?? true,\n      csrf: options.security?.csrf,\n    };\n\n    // 如果启用了安全模式（默认启用），对配置进行验证\n    if (securityConfig.enableXSSProtection) {\n      if (securityConfig.validateConfig) {\n        // 验证配置项中可能包含的字符串内容\n        try {\n          const configStr = JSON.stringify(options);\n          const validation = SecurityUtils.validateInput(configStr);\n          if (!validation.safe) {\n            services.monitoring.captureError(\n              new Error('配置项包含不安全内容'),\n              { reason: validation.reason }\n            );\n          }\n        } catch (error) {\n          // 忽略序列化错误（某些配置项可能包含不可序列化的内容）\n        }\n      }\n\n      // 初始化 CSRF 防护（如果启用）\n      if (securityConfig.csrf?.enabled !== false) {\n        // 异步初始化 CSRF，但不阻塞渲染\n        import('../../utils/csrf').then(({ initCSRFManager }) => {\n          initCSRFManager({\n            headerName: securityConfig.csrf?.headerName,\n            cookieName: securityConfig.csrf?.cookieName,\n            getToken: securityConfig.csrf?.getToken,\n            validateToken: securityConfig.csrf?.validateToken,\n          });\n        }).catch((error) => {\n          // CSRF 初始化失败不影响应用启动，但记录警告\n          if (process.env.NODE_ENV === 'development') {\n            console.warn('CSRF 防护初始化失败:', error);\n          }\n        });\n      }\n    }\n\n    // 优化：缓存错误处理函数，避免每次渲染都创建新函数\n    const handleError = (error: unknown) => {\n      services.monitoring.captureError(error);\n    };\n\n    this.root.render(\n      <StrictMode>\n        <ErrorBoundary\n          fallback={options.errorFallback}\n          onError={handleError}\n        >\n          <InitializationErrorThrower />\n          <AppContextProvider\n            initialTheme={options.theme}\n            initialLocale={initialLocale}\n            initialAntdConfig={options.antd}\n            initialInitializationContext={context}\n            stateManager={services.stateManager}\n            antdApp={options.antdApp}\n          >\n            <BasicLayout>\n              {shouldUseRouter ? (\n                // 启用路由时，使用 RouterProvider（路由内容由路由配置决定）\n                <RouterProvider router={router} />\n              ) : (\n                // 未启用路由时，直接渲染应用内容\n                options.app || <DefaultApp />\n              )}\n            </BasicLayout>\n          </AppContextProvider>\n        </ErrorBoundary>\n      </StrictMode>\n    );\n  }\n\n  /**\n   * 渲染启动页\n   * \n   * 注意：启动页不使用 RouterWrapper，因为启动页应该在路由系统之前渲染\n   * \n   * @param options - 启动配置选项\n   * @param services - 服务实例\n   * @param onComplete - 启动页完成回调\n   */\n  renderSplashScreen(\n    options: StartOptions,\n    services: {\n      monitoring: MonitoringService;\n      stateManager: StateManager;\n    },\n    onComplete: (context: InitializationContext) => void\n  ): void {\n    if (!this.root) {\n      throw new Error('渲染器未初始化，请先调用 initialize()');\n    }\n\n    // 获取初始语言（从 locale 配置中推断，或使用默认值）\n    const initialLocale: LangType = options.locale\n      ? (Object.keys(options.locale)[0] as LangType) || 'zh-CN'\n      : 'zh-CN';\n\n    this.root.render(\n      <StrictMode>\n        <ErrorBoundary\n          fallback={options.errorFallback}\n          onError={(error) => {\n            services.monitoring.captureError(error);\n          }}\n        >\n          <InitializationErrorThrower />\n          <AppContextProvider\n            initialTheme={options.theme}\n            initialLocale={initialLocale}\n            initialAntdConfig={options.antd}\n            stateManager={services.stateManager}\n            antdApp={options.antdApp}\n          >\n            {/* \n              启动页不使用 RouterWrapper，因为：\n              1. 启动页应该在路由系统初始化之前渲染\n              2. 启动页完成后才会渲染主应用，此时路由系统已经初始化完成\n            */}\n            <BasicLayout>\n              <SplashScreen options={options} onComplete={onComplete} />\n            </BasicLayout>\n          </AppContextProvider>\n        </ErrorBoundary>\n      </StrictMode>\n    );\n  }\n\n  /**\n   * 渲染错误页面\n   * \n   * @param options - 启动配置选项\n   * @param services - 服务实例\n   * @param error - 错误信息\n   */\n  renderError(\n    options: StartOptions,\n    services: {\n      monitoring: MonitoringService;\n    }\n  ): void {\n    if (!this.root) {\n      throw new Error('渲染器未初始化，请先调用 initialize()');\n    }\n\n    this.root.render(\n      <StrictMode>\n        <ErrorBoundary\n          fallback={options.errorFallback}\n          onError={(err) => {\n            services.monitoring.captureError(err);\n            if (options.errorMonitor?.onError) {\n              options.errorMonitor.onError(err);\n            }\n          }}\n        >\n          <InitializationErrorThrower />\n          <div>框架启动失败</div>\n        </ErrorBoundary>\n      </StrictMode>\n    );\n  }\n\n  /**\n   * 销毁渲染器\n   */\n  destroy(): void {\n    if (this.root) {\n      this.root.unmount();\n      this.root = null;\n    }\n    this.container = null;\n  }\n\n  /**\n   * 获取容器\n   */\n  getContainer(): Container | null {\n    return this.container;\n  }\n}\n"],"names":["createRoot","StrictMode","BasicLayout","DefaultApp","AppContextProvider","ErrorBoundary","InitializationErrorThrower","SplashScreen","SecurityUtils","getRouterManager","RouterProvider","AppRenderer","initialize","container","rootOptions","root","renderApp","options","services","context","Error","initialLocale","locale","Object","keys","routerEnabled","router","enabled","routerManager","getRouter","shouldUseRouter","securityConfig","enableXSSProtection","security","validateConfig","sanitizeUserInput","csrf","configStr","JSON","stringify","validation","validateInput","safe","monitoring","captureError","reason","error","then","initCSRFManager","headerName","cookieName","getToken","validateToken","catch","process","env","NODE_ENV","console","warn","handleError","render","fallback","errorFallback","onError","initialTheme","theme","initialAntdConfig","antd","initialInitializationContext","stateManager","antdApp","app","renderSplashScreen","onComplete","renderError","err","errorMonitor","div","destroy","unmount","getContainer"],"mappings":";;;;;;;;;;;;;;AAAA;;;CAGC,GAED,SAASA,UAAU,QAAQ,mBAAmB;AAE9C,SAASC,UAAU,QAAQ,QAAQ;AAEnC,SAASC,WAAW,EAAEC,UAAU,EAAEC,kBAAkB,QAAQ,SAAS;AAErE,SAASC,aAAa,QAAQ,WAAW;AACzC,SAASC,0BAA0B,QAAQ,oBAAoB;AAK/D,SAASC,YAAY,QAAQ,YAAY;AACzC,SAASC,aAAa,QAAQ,uBAAuB;AACrD,SAASC,gBAAgB,QAAQ,0BAA0B;AAC3D,SAASC,cAAc,QAAQ,mBAAmB;AAElD;;CAEC,GACD,OAAO,MAAMC;IAIX;;;;;GAKC,GACDC,WAAWC,SAAoB,EAAEC,WAAyB,EAAQ;QAChE,IAAI,CAACD,SAAS,GAAGA;QACjB,IAAI,CAAC,IAAI,CAACE,IAAI,EAAE;YACd,IAAI,CAACA,IAAI,GAAGf,WAAWa,WAAWC;QACpC;IACF;IAEA;;;;;;;;;;;GAWC,GACD,MAAME,UACJC,OAAqB,EACrBC,QAGC,EACDC,OAA+B,EAChB;QACf,IAAI,CAAC,IAAI,CAACJ,IAAI,EAAE;YACd,MAAM,IAAIK,MAAM;QAClB;QAEA,gCAAgC;QAChC,MAAMC,gBAA0BJ,QAAQK,MAAM,GAC1C,AAACC,OAAOC,IAAI,CAACP,QAAQK,MAAM,CAAC,CAAC,EAAE,IAAiB,UAChD;QAEJ,YAAY;QACZ,kEAAkE;QAClE,MAAMG,gBAAgBR,QAAQS,MAAM,GAChCT,QAAQS,MAAM,CAACC,OAAO,KAAK,SAASV,QAAQS,MAAM,CAACC,OAAO,KAAK,aAC/D;QAEJ,uBAAuB;QACvB,MAAMC,gBAAgBnB;QACtB,MAAMiB,SAASE,cAAcC,SAAS;QACtC,+DAA+D;QAE/D,2CAA2C;QAC3C,sBAAsB;QACtB,MAAMC,kBAAkBL,iBAAiBC,WAAW;QAEpD,iBAAiB;QACjB,0BAA0B;QAC1B,MAAMK,iBAAiB;YACrBC,qBAAqBf,QAAQgB,QAAQ,EAAED,uBAAuB;YAC9DE,gBAAgBjB,QAAQgB,QAAQ,EAAEC,kBAAkB;YACpDC,mBAAmBlB,QAAQgB,QAAQ,EAAEE,qBAAqB;YAC1DC,MAAMnB,QAAQgB,QAAQ,EAAEG;QAC1B;QAEA,0BAA0B;QAC1B,IAAIL,eAAeC,mBAAmB,EAAE;YACtC,IAAID,eAAeG,cAAc,EAAE;gBACjC,mBAAmB;gBACnB,IAAI;oBACF,MAAMG,YAAYC,KAAKC,SAAS,CAACtB;oBACjC,MAAMuB,aAAahC,cAAciC,aAAa,CAACJ;oBAC/C,IAAI,CAACG,WAAWE,IAAI,EAAE;wBACpBxB,SAASyB,UAAU,CAACC,YAAY,CAC9B,IAAIxB,MAAM,eACV;4BAAEyB,QAAQL,WAAWK,MAAM;wBAAC;oBAEhC;gBACF,EAAE,OAAOC,OAAO;gBACd,6BAA6B;gBAC/B;YACF;YAEA,oBAAoB;YACpB,IAAIf,eAAeK,IAAI,EAAET,YAAY,OAAO;gBAC1C,oBAAoB;gBACpB,MAAM,CAAC,oBAAoBoB,IAAI,CAAC,CAAC,EAAEC,eAAe,EAAE;oBAClDA,gBAAgB;wBACdC,YAAYlB,eAAeK,IAAI,EAAEa;wBACjCC,YAAYnB,eAAeK,IAAI,EAAEc;wBACjCC,UAAUpB,eAAeK,IAAI,EAAEe;wBAC/BC,eAAerB,eAAeK,IAAI,EAAEgB;oBACtC;gBACF,GAAGC,KAAK,CAAC,CAACP;oBACR,0BAA0B;oBAC1B,IAAIQ,QAAQC,GAAG,CAACC,QAAQ,KAAK,eAAe;wBAC1CC,QAAQC,IAAI,CAAC,iBAAiBZ;oBAChC;gBACF;YACF;QACF;QAEA,2BAA2B;QAC3B,MAAMa,cAAc,CAACb;YACnB5B,SAASyB,UAAU,CAACC,YAAY,CAACE;QACnC;QAEA,IAAI,CAAC/B,IAAI,CAAC6C,MAAM,eACd,KAAC3D;sBACC,cAAA,MAACI;gBACCwD,UAAU5C,QAAQ6C,aAAa;gBAC/BC,SAASJ;;kCAET,KAACrD;kCACD,KAACF;wBACC4D,cAAc/C,QAAQgD,KAAK;wBAC3B5C,eAAeA;wBACf6C,mBAAmBjD,QAAQkD,IAAI;wBAC/BC,8BAA8BjD;wBAC9BkD,cAAcnD,SAASmD,YAAY;wBACnCC,SAASrD,QAAQqD,OAAO;kCAExB,cAAA,KAACpE;sCACE4B,kBACC,uCAAuC;0CACvC,KAACpB;gCAAegB,QAAQA;iCAExB,kBAAkB;4BAClBT,QAAQsD,GAAG,kBAAI,KAACpE;;;;;;IAO9B;IAEA;;;;;;;;GAQC,GACDqE,mBACEvD,OAAqB,EACrBC,QAGC,EACDuD,UAAoD,EAC9C;QACN,IAAI,CAAC,IAAI,CAAC1D,IAAI,EAAE;YACd,MAAM,IAAIK,MAAM;QAClB;QAEA,gCAAgC;QAChC,MAAMC,gBAA0BJ,QAAQK,MAAM,GAC1C,AAACC,OAAOC,IAAI,CAACP,QAAQK,MAAM,CAAC,CAAC,EAAE,IAAiB,UAChD;QAEJ,IAAI,CAACP,IAAI,CAAC6C,MAAM,eACd,KAAC3D;sBACC,cAAA,MAACI;gBACCwD,UAAU5C,QAAQ6C,aAAa;gBAC/BC,SAAS,CAACjB;oBACR5B,SAASyB,UAAU,CAACC,YAAY,CAACE;gBACnC;;kCAEA,KAACxC;kCACD,KAACF;wBACC4D,cAAc/C,QAAQgD,KAAK;wBAC3B5C,eAAeA;wBACf6C,mBAAmBjD,QAAQkD,IAAI;wBAC/BE,cAAcnD,SAASmD,YAAY;wBACnCC,SAASrD,QAAQqD,OAAO;kCAOxB,cAAA,KAACpE;sCACC,cAAA,KAACK;gCAAaU,SAASA;gCAASwD,YAAYA;;;;;;;IAMxD;IAEA;;;;;;GAMC,GACDC,YACEzD,OAAqB,EACrBC,QAEC,EACK;QACN,IAAI,CAAC,IAAI,CAACH,IAAI,EAAE;YACd,MAAM,IAAIK,MAAM;QAClB;QAEA,IAAI,CAACL,IAAI,CAAC6C,MAAM,eACd,KAAC3D;sBACC,cAAA,MAACI;gBACCwD,UAAU5C,QAAQ6C,aAAa;gBAC/BC,SAAS,CAACY;oBACRzD,SAASyB,UAAU,CAACC,YAAY,CAAC+B;oBACjC,IAAI1D,QAAQ2D,YAAY,EAAEb,SAAS;wBACjC9C,QAAQ2D,YAAY,CAACb,OAAO,CAACY;oBAC/B;gBACF;;kCAEA,KAACrE;kCACD,KAACuE;kCAAI;;;;;IAIb;IAEA;;GAEC,GACDC,UAAgB;QACd,IAAI,IAAI,CAAC/D,IAAI,EAAE;YACb,IAAI,CAACA,IAAI,CAACgE,OAAO;YACjB,IAAI,CAAChE,IAAI,GAAG;QACd;QACA,IAAI,CAACF,SAAS,GAAG;IACnB;IAEA;;GAEC,GACDmE,eAAiC;QAC/B,OAAO,IAAI,CAACnE,SAAS;IACvB;;QAxPA,uBAAQE,QAAoB;QAC5B,uBAAQF,aAA8B;;AAwPxC"}
+{"version":3,"sources":["../../../src/core/startup/renderApp.tsx"],"sourcesContent":["/**\n * 应用渲染模块\n * 负责渲染React应用\n */\n\nimport { createRoot } from 'react-dom/client';\nimport type { Root } from 'react-dom/client';\nimport { StrictMode, useMemo, useCallback, memo } from 'react';\nimport type { Container, RootOptions } from 'react-dom/client';\nimport { BasicLayout, DefaultApp, AppContextProvider } from '../app';\nimport type { LangType } from '../../library/locale/types';\nimport { ErrorBoundary } from '../error';\nimport { InitializationErrorThrower } from '../initialization';\nimport type { StartOptions } from '../types';\nimport type { InitializationContext } from '../initialization';\nimport type { MonitoringService } from '../../utils/monitoring';\nimport type { StateManager } from '../../state';\nimport { SplashScreen } from '../splash';\nimport { SecurityUtils } from '../../utils/security';\nimport { getRouterManager } from '../router/RouterManager';\nimport { RouterProvider } from \"react-router-dom\";\n\n/**\n * 安全配置类型\n */\ninterface SecurityConfig {\n  enableXSSProtection: boolean;\n  validateConfig: boolean;\n  sanitizeUserInput: boolean;\n  csrf?: StartOptions['security'] extends infer S\n    ? S extends { csrf?: infer C }\n      ? C\n      : never\n    : never;\n}\n\n/**\n * 优化的应用内容组件\n * 使用 useMemo 缓存计算结果，提升渲染性能\n */\ninterface OptimizedAppContentProps {\n  options: StartOptions;\n  services: {\n    monitoring: MonitoringService;\n    stateManager: StateManager;\n  };\n  context?: InitializationContext;\n  securityConfig: SecurityConfig;\n}\n\nconst OptimizedAppContent = memo<OptimizedAppContentProps>(({\n  options,\n  services,\n  context,\n  // securityConfig 用于未来扩展，当前暂不使用\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  securityConfig: _securityConfig,\n}) => {\n  // 优化：使用 useMemo 缓存初始语言计算\n  const initialLocale = useMemo<LangType>(() => {\n    return options.locale\n      ? (Object.keys(options.locale)[0] as LangType) || 'zh-CN'\n      : 'zh-CN';\n  }, [options.locale]);\n\n  // 优化：使用 useMemo 缓存路由判断结果\n  const shouldUseRouter = useMemo(() => {\n    const routerEnabled = options.router\n      ? options.router.enabled !== false && options.router.enabled !== 'disabled'\n      : false;\n\n    if (!routerEnabled) {\n      return false;\n    }\n\n    const routerManager = getRouterManager();\n    const router = routerManager.getRouter();\n    return router !== null;\n  }, [options.router]);\n\n  // 优化：使用 useMemo 缓存路由实例\n  const router = useMemo(() => {\n    if (!shouldUseRouter) {\n      return null;\n    }\n    const routerManager = getRouterManager();\n    return routerManager.getRouter();\n  }, [shouldUseRouter]);\n\n  // 优化：使用 useCallback 缓存错误处理函数\n  const handleError = useCallback((error: unknown) => {\n    services.monitoring.captureError(error);\n  }, [services.monitoring]);\n\n  // 优化：使用 useMemo 缓存应用内容\n  const appContent = useMemo(() => {\n    if (shouldUseRouter && router) {\n      return <RouterProvider router={router} />;\n    }\n    return options.app || <DefaultApp />;\n  }, [shouldUseRouter, router, options.app]);\n\n  return (\n    <ErrorBoundary\n      fallback={options.errorFallback}\n      onError={handleError}\n    >\n      <InitializationErrorThrower />\n      <AppContextProvider\n        initialTheme={options.theme}\n        initialLocale={initialLocale}\n        initialAntdConfig={options.uiProvider || options.antd}\n        initialInitializationContext={context}\n        stateManager={services.stateManager}\n        antdApp={options.uiApp || options.antdApp}\n      >\n        <BasicLayout globalProvider={options.globalProvider}>\n          {appContent}\n        </BasicLayout>\n      </AppContextProvider>\n    </ErrorBoundary>\n  );\n});\n\nOptimizedAppContent.displayName = 'OptimizedAppContent';\n\n/**\n * 应用渲染器\n */\nexport class AppRenderer {\n  private root: Root | null = null;\n  private container: Container | null = null;\n\n  /**\n   * 初始化渲染器\n   *\n   * @param container - React应用的挂载容器\n   * @param rootOptions - React根节点配置选项\n   */\n  initialize(container: Container, rootOptions?: RootOptions): void {\n    this.container = container;\n    if (!this.root) {\n      this.root = createRoot(container, rootOptions);\n    }\n  }\n\n  /**\n   * 渲染应用\n   *\n   * 优化：\n   * 1. 默认启用安全防护（XSS防护）\n   * 2. 优化组件渲染性能，使用 useMemo 缓存计算结果\n   * 3. 将安全配置计算提取到初始化阶段\n   *\n   * @param options - 启动配置选项\n   * @param services - 服务实例\n   * @param context - 初始化上下文（可选）\n   */\n  async renderApp(\n    options: StartOptions,\n    services: {\n      monitoring: MonitoringService;\n      stateManager: StateManager;\n    },\n    context?: InitializationContext\n  ): Promise<void> {\n    if (!this.root) {\n      throw new Error('渲染器未初始化，请先调用 initialize()');\n    }\n\n    // 优化：安全配置在初始化阶段计算（在 startApp 中预计算）\n    // 这里只使用预计算的值，避免在渲染时重复计算\n    const securityConfig: SecurityConfig = {\n      enableXSSProtection: options.security?.enableXSSProtection ?? true,\n      validateConfig: options.security?.validateConfig ?? true,\n      sanitizeUserInput: options.security?.sanitizeUserInput ?? true,\n      csrf: options.security?.csrf,\n    };\n\n    // 优化：安全验证在初始化阶段完成，这里只进行必要的运行时检查\n    // 如果启用了安全模式（默认启用），对配置进行验证\n    if (securityConfig.enableXSSProtection && securityConfig.validateConfig) {\n      // 异步验证配置，不阻塞渲染\n      Promise.resolve().then(() => {\n        try {\n          const configStr = JSON.stringify(options);\n          const validation = SecurityUtils.validateInput(configStr);\n          if (!validation.safe) {\n            services.monitoring.captureError(\n              new Error('配置项包含不安全内容'),\n              { reason: validation.reason }\n            );\n          }\n        } catch (error) {\n          // 忽略序列化错误（某些配置项可能包含不可序列化的内容）\n        }\n      });\n    }\n\n    // 初始化 CSRF 防护（如果启用，异步执行，不阻塞渲染）\n    if (securityConfig.enableXSSProtection && securityConfig.csrf?.enabled !== false) {\n      import('../../utils/csrf').then(({ initCSRFManager }) => {\n        initCSRFManager({\n          headerName: securityConfig.csrf?.headerName,\n          cookieName: securityConfig.csrf?.cookieName,\n          getToken: securityConfig.csrf?.getToken,\n          validateToken: securityConfig.csrf?.validateToken,\n        });\n      }).catch((error) => {\n        // CSRF 初始化失败不影响应用启动，但记录警告\n        if (process.env.NODE_ENV === 'development') {\n          console.warn('CSRF 防护初始化失败:', error);\n        }\n      });\n    }\n\n    // 使用优化的应用内容组件，内部使用 useMemo 缓存计算结果\n    this.root.render(\n      <StrictMode>\n        <OptimizedAppContent\n          options={options}\n          services={services}\n          context={context}\n          securityConfig={securityConfig}\n        />\n      </StrictMode>\n    );\n  }\n\n  /**\n   * 渲染启动页\n   *\n   * 注意：启动页不使用 RouterWrapper，因为启动页应该在路由系统之前渲染\n   *\n   * @param options - 启动配置选项\n   * @param services - 服务实例\n   * @param onComplete - 启动页完成回调\n   */\n  renderSplashScreen(\n    options: StartOptions,\n    services: {\n      monitoring: MonitoringService;\n      stateManager: StateManager;\n    },\n    onComplete: (context: InitializationContext) => void\n  ): void {\n    if (!this.root) {\n      throw new Error('渲染器未初始化，请先调用 initialize()');\n    }\n\n    // 获取初始语言（从 locale 配置中推断，或使用默认值）\n    const initialLocale: LangType = options.locale\n      ? (Object.keys(options.locale)[0] as LangType) || 'zh-CN'\n      : 'zh-CN';\n\n    this.root.render(\n      <StrictMode>\n        <ErrorBoundary\n          fallback={options.errorFallback}\n          onError={(error) => {\n            services.monitoring.captureError(error);\n          }}\n        >\n          <InitializationErrorThrower />\n          <AppContextProvider\n            initialTheme={options.theme}\n            initialLocale={initialLocale}\n            initialAntdConfig={options.uiProvider || options.antd}\n            stateManager={services.stateManager}\n            antdApp={options.uiApp || options.antdApp}\n          >\n            {/*\n              启动页不使用 RouterWrapper，因为：\n              1. 启动页应该在路由系统初始化之前渲染\n              2. 启动页完成后才会渲染主应用，此时路由系统已经初始化完成\n            */}\n            <BasicLayout globalProvider={options.globalProvider}>\n              <SplashScreen options={options} onComplete={onComplete} />\n            </BasicLayout>\n          </AppContextProvider>\n        </ErrorBoundary>\n      </StrictMode>\n    );\n  }\n\n  /**\n   * 渲染错误页面\n   *\n   * @param options - 启动配置选项\n   * @param services - 服务实例\n   * @param error - 错误信息\n   */\n  renderError(\n    options: StartOptions,\n    services: {\n      monitoring: MonitoringService;\n    }\n  ): void {\n    if (!this.root) {\n      throw new Error('渲染器未初始化，请先调用 initialize()');\n    }\n\n    this.root.render(\n      <StrictMode>\n        <ErrorBoundary\n          fallback={options.errorFallback}\n          onError={(err) => {\n            services.monitoring.captureError(err);\n            if (options.errorMonitor?.onError) {\n              options.errorMonitor.onError(err);\n            }\n          }}\n        >\n          <InitializationErrorThrower />\n          <div>框架启动失败</div>\n        </ErrorBoundary>\n      </StrictMode>\n    );\n  }\n\n  /**\n   * 销毁渲染器\n   */\n  destroy(): void {\n    if (this.root) {\n      this.root.unmount();\n      this.root = null;\n    }\n    this.container = null;\n  }\n\n  /**\n   * 获取容器\n   */\n  getContainer(): Container | null {\n    return this.container;\n  }\n}\n"],"names":["createRoot","StrictMode","useMemo","useCallback","memo","BasicLayout","DefaultApp","AppContextProvider","ErrorBoundary","InitializationErrorThrower","SplashScreen","SecurityUtils","getRouterManager","RouterProvider","OptimizedAppContent","options","services","context","securityConfig","_securityConfig","initialLocale","locale","Object","keys","shouldUseRouter","routerEnabled","router","enabled","routerManager","getRouter","handleError","error","monitoring","captureError","appContent","app","fallback","errorFallback","onError","initialTheme","theme","initialAntdConfig","uiProvider","antd","initialInitializationContext","stateManager","antdApp","uiApp","globalProvider","displayName","AppRenderer","initialize","container","rootOptions","root","renderApp","Error","enableXSSProtection","security","validateConfig","sanitizeUserInput","csrf","Promise","resolve","then","configStr","JSON","stringify","validation","validateInput","safe","reason","initCSRFManager","headerName","cookieName","getToken","validateToken","catch","process","env","NODE_ENV","console","warn","render","renderSplashScreen","onComplete","renderError","err","errorMonitor","div","destroy","unmount","getContainer"],"mappings":"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"}

package/dist/core/startup/startApp.cjs

@@ -22,6 +22,7 @@ const _AppInstance = require("./AppInstance");
 const _environment = require("./environment");
 const _RouterManager = require("../router/RouterManager");
 const _frameworkEvents = require("../event/frameworkEvents");
+const _kernel = require("../kernel");
 async function startApp(options = {}, instanceId) {
     const startTime = performance.now();
     const envDetector = (0, _environment.getEnvironmentDetector)();
@@ -32,6 +33,7 @@ async function startApp(options = {}, instanceId) {
     (0, _traceId.setCurrentTraceId)(traceId);
     // 框架事件管理器（在服务初始化后创建）
     let frameworkEventManager = null;
+    let kernelTraceId = null;
     try {
         // 1. 环境检测和容器获取
         const container = options.container || envDetector.safeGetElement('#root');
@@ -41,27 +43,119 @@ async function startApp(options = {}, instanceId) {
             }, _errors.ErrorCode.CONTAINER_NOT_FOUND);
         }
         _utils.logger.info('框架启动中...');
+        if (options.antd && !options.uiProvider) {
+            _utils.logger.warn('[deprecated] StartOptions.antd 即将废弃，请迁移到 StartOptions.uiProvider');
+        }
+        if (options.antdApp && !options.uiApp) {
+            _utils.logger.warn('[deprecated] StartOptions.antdApp 即将废弃，请迁移到 StartOptions.uiApp');
+        }
         // 2. 创建应用实例
         const appInstance = instanceManager.createInstance(instanceId, options);
         const finalInstanceId = appInstance.id;
-        // 3. 初始化服务（并行）
-        const servicesInitStart = performance.now();
-        const services = await (0, _initializeServices.initializeServices)({
-            ...options,
-            eventBus: {
-                ...options.eventBus,
-                instanceId: finalInstanceId
+        let services = null;
+        // 使用单次 Promise 防止重复初始化，提升加载速度并保证可观测数据一致。
+        let servicesInitPromise = null;
+        const ensureServicesInitialized = async ()=>{
+            if (services) {
+                return services;
             }
+            if (!servicesInitPromise) {
+                servicesInitPromise = (0, _initializeServices.initializeServices)({
+                    ...options,
+                    eventBus: {
+                        ...options.eventBus,
+                        instanceId: finalInstanceId
+                    }
+                });
+            }
+            services = await servicesInitPromise;
+            return services;
+        };
+        // 3. 使用无 UI Kernel 管理启动阶段（配置、主题、i18n、服务注入、统一错误处理）
+        const kernelRuntime = await (0, _kernel.startKernel)({
+            loggerLevel: options.loggerLevel,
+            configLoader: options.configStrategy?.loadCriticalConfig,
+            configFallback: options.configStrategy?.fallbackConfig,
+            locale: {
+                locale: (options.locale ? Object.keys(options.locale)[0] : 'zh-CN') || 'zh-CN',
+                resources: options.locale
+            },
+            theme: {
+                mode: options.theme?.mode || 'light',
+                primaryColor: options.theme?.primaryColor,
+                compatibility: {
+                    antd: options.uiProvider || options.antd
+                }
+            },
+            adapters: {
+                monitoring: {
+                    initialize: async ()=>{
+                        await ensureServicesInitialized();
+                    },
+                    captureError: (error, metadata)=>{
+                        if (services) {
+                            services.monitoring.captureError(error, metadata);
+                        } else {
+                            _utils.logger.error('Kernel 监控上报失败（服务尚未初始化）:', error, metadata);
+                        }
+                    },
+                    reportMetric: (name, value, tags)=>{
+                        _utils.logger.debug(`[kernel.metric] ${name}`, {
+                            value,
+                            tags,
+                            instanceId: finalInstanceId
+                        });
+                    }
+                },
+                state: {
+                    initialize: async ()=>{
+                        await ensureServicesInitialized();
+                    },
+                    getInstance: ()=>services?.stateManager ?? null
+                },
+                eventBus: {
+                    initialize: async ()=>{
+                        await ensureServicesInitialized();
+                    },
+                    emit: (event, payload)=>{
+                        if (services) {
+                            services.eventBus.emit(event, payload);
+                        }
+                    },
+                    on: (event, handler)=>{
+                        if (!services) {
+                            return ()=>{};
+                        }
+                        return services.eventBus.on(event, handler);
+                    }
+                },
+                errorHandler: {
+                    async handle (error) {
+                        _utils.logger.error('Kernel 启动阶段失败:', error);
+                        return {
+                            handled: true,
+                            shouldThrow: true
+                        };
+                    }
+                }
+            },
+            enabledPhases: {
+                init: false
+            },
+            enablePostReady: false
         });
+        kernelTraceId = kernelRuntime.traceId;
+        const servicesInitStart = performance.now();
+        const resolvedServices = await ensureServicesInitialized();
         const servicesInitDuration = performance.now() - servicesInitStart;
         // 创建框架事件管理器
-        frameworkEventManager = new _frameworkEvents.FrameworkEventManager(services.eventBus);
+        frameworkEventManager = new _frameworkEvents.FrameworkEventManager(resolvedServices.eventBus);
         // 触发应用启动事件（使用真实的事件总线）
         frameworkEventManager.emitAppStart(finalInstanceId);
         // 触发实例创建事件
         frameworkEventManager.emitInstanceCreated(finalInstanceId);
         // 4. 初始化应用实例
-        appInstance.initialize(container, services);
+        appInstance.initialize(container, resolvedServices);
         // 5. 初始化路由管理器
         const routerManager = (0, _RouterManager.getRouterManager)();
         if (options.router) {
@@ -82,12 +176,19 @@ async function startApp(options = {}, instanceId) {
             if (frameworkEventManager) {
                 frameworkEventManager.emitAppRenderStart(finalInstanceId);
             }
-            await renderer.renderApp(options, services, context);
+            await renderer.renderApp(options, resolvedServices, context);
             const renderDuration = performance.now() - renderStart;
             // 触发渲染完成事件
             if (frameworkEventManager) {
                 frameworkEventManager.emitAppRenderComplete(finalInstanceId, renderDuration);
             }
+            // 优化：在应用渲染完成后，延迟初始化非关键服务
+            // 使用 requestIdleCallback 在浏览器空闲时初始化，不影响用户体验
+            if (resolvedServices.initializeNonCriticalServices) {
+                resolvedServices.initializeNonCriticalServices().catch((error)=>{
+                    _utils.logger.warn('非关键服务初始化失败（不影响应用运行）:', error);
+                });
+            }
             if (performanceTracker) {
                 performanceTracker.recordFirstRender(renderDuration);
                 const totalDuration = performance.now() - startTime;
@@ -98,6 +199,12 @@ async function startApp(options = {}, instanceId) {
             if (frameworkEventManager) {
                 frameworkEventManager.emitAppStarted(finalInstanceId, performance.now() - startTime);
             }
+            // 统一发出 Kernel post-ready 事件，供可观测系统消费。
+            kernelRuntime.getEventBus().emit('kernel.postReady', {
+                traceId: kernelRuntime.traceId,
+                instanceId: finalInstanceId,
+                startupDuration: performance.now() - startTime
+            });
             // 开发模式下显示开发工具
             if (process.env.NODE_ENV === 'development' && typeof window !== 'undefined') {
                 // 延迟显示开发工具，避免影响首次渲染
@@ -142,7 +249,7 @@ async function startApp(options = {}, instanceId) {
                 frameworkEventManager.emitAppInitStart(finalInstanceId);
             }
             // 渲染启动页
-            renderer.renderSplashScreen(options, services, onSplashComplete);
+            renderer.renderSplashScreen(options, resolvedServices, onSplashComplete);
         } else {
             // 场景2: 不显示启动页，直接执行初始化
             _utils.logger.info('开始执行初始化（无启动页）');
@@ -191,6 +298,11 @@ async function startApp(options = {}, instanceId) {
                 });
             }
         }
+        if (kernelTraceId) {
+            _utils.logger.error('Kernel Trace 失败上下文', {
+                traceId: kernelTraceId
+            });
+        }
         // 如果容器存在，尝试渲染错误页面
         const container = options.container || envDetector.safeGetElement('#root');
         if (container) {

package/dist/core/startup/startApp.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/startup/startApp.ts"],"sourcesContent":["/**\n * 应用启动主函数\n * 重构后的启动逻辑，集成所有新功能\n */\n\nimport { logger } from '../../utils';\nimport { ErrorCode, InitializationError } from '../../utils/errors';\nimport { initTraceIdGenerator, generateTraceId, setCurrentTraceId } from '../../utils/traceId';\nimport type { StartOptions } from '../types';\nimport { shouldShowSplashScreen } from '../splash';\nimport { initialization, initializationErrorState } from '../initialization/index';\nimport { middlewareManager } from '../middleware';\nimport { initializeServices } from './initializeServices';\nimport { AppInstanceManager, getAppInstanceManager } from './AppInstance';\nimport { getEnvironmentDetector } from './environment';\nimport { getRouterManager } from '../router/RouterManager';\nimport { FrameworkEventManager } from '../event/frameworkEvents';\n\n/**\n * 启动应用\n * \n * @param options - 启动配置选项\n * @param instanceId - 应用实例ID（可选，用于多实例场景）\n * @returns 应用实例\n */\nexport async function startApp(\n  options: StartOptions = {},\n  instanceId?: string\n): Promise<AppInstanceManager> {\n  const startTime = performance.now();\n  const envDetector = getEnvironmentDetector();\n  const instanceManager = getAppInstanceManager();\n\n  // 初始化追踪 ID 生成器\n  initTraceIdGenerator('app');\n  const traceId = generateTraceId();\n  setCurrentTraceId(traceId);\n\n  // 框架事件管理器（在服务初始化后创建）\n  let frameworkEventManager: FrameworkEventManager | null = null;\n\n  try {\n    // 1. 环境检测和容器获取\n    const container = options.container || envDetector.safeGetElement('#root');\n    if (!container) {\n      throw new InitializationError(\n        '未找到挂载容器',\n        undefined,\n        { container: options.container },\n        ErrorCode.CONTAINER_NOT_FOUND\n      );\n    }\n\n    logger.info('框架启动中...');\n\n    // 2. 创建应用实例\n    const appInstance = instanceManager.createInstance(instanceId, options);\n    const finalInstanceId = appInstance.id;\n\n    // 3. 初始化服务（并行）\n    const servicesInitStart = performance.now();\n    const services = await initializeServices({\n      ...options,\n      eventBus: {\n        ...options.eventBus,\n        instanceId: finalInstanceId,\n      },\n    });\n    const servicesInitDuration = performance.now() - servicesInitStart;\n\n    // 创建框架事件管理器\n    frameworkEventManager = new FrameworkEventManager(services.eventBus);\n    \n    // 触发应用启动事件（使用真实的事件总线）\n    frameworkEventManager.emitAppStart(finalInstanceId);\n    \n    // 触发实例创建事件\n    frameworkEventManager.emitInstanceCreated(finalInstanceId);\n\n    // 4. 初始化应用实例\n    appInstance.initialize(container, services);\n\n    // 5. 初始化路由管理器\n    const routerManager = getRouterManager();\n    if (options.router) {\n      await routerManager.initialize(options.router);\n    }\n\n    // 6. 性能追踪\n    const performanceTracker = appInstance.getPerformanceTracker();\n    if (performanceTracker) {\n      performanceTracker.recordServiceInit(servicesInitDuration);\n    }\n\n    // 6. 是否显示启动页\n    const shouldShowSplash = shouldShowSplashScreen(options.showSplashScreen);\n\n    const renderer = appInstance.getRenderer();\n\n    // 8. 渲染应用函数\n    const renderApp = async (context?: Awaited<ReturnType<typeof initialization>>) => {\n      const renderStart = performance.now();\n      \n      // 触发渲染开始事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppRenderStart(finalInstanceId);\n      }\n      \n      await renderer.renderApp(options, services, context);\n      const renderDuration = performance.now() - renderStart;\n\n      // 触发渲染完成事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppRenderComplete(finalInstanceId, renderDuration);\n      }\n\n      if (performanceTracker) {\n        performanceTracker.recordFirstRender(renderDuration);\n        const totalDuration = performance.now() - startTime;\n        performanceTracker.recordTotalStartup(totalDuration);\n        performanceTracker.report();\n      }\n      \n      // 触发应用启动完成事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppStarted(finalInstanceId, performance.now() - startTime);\n      }\n\n      // 开发模式下显示开发工具\n      if (process.env.NODE_ENV === 'development' && typeof window !== 'undefined') {\n        // 延迟显示开发工具，避免影响首次渲染\n        setTimeout(() => {\n          const devToolsContainer = document.createElement('div');\n          devToolsContainer.id = '__framework_dev_tools__';\n          document.body.appendChild(devToolsContainer);\n          \n          // 这里需要动态导入React来渲染开发工具\n          // 为了简化，暂时注释掉，后续可以完善\n          // import('react-dom/client').then(({ createRoot }) => {\n          //   const root = createRoot(devToolsContainer);\n          //   root.render(<DevToolsTrigger appInstance={appInstance} />);\n          // });\n        }, 1000);\n      }\n    };\n\n    if (shouldShowSplash) {\n      // 场景1: 显示启动页，初始化在启动页中完成\n      const onSplashComplete = (context: Awaited<ReturnType<typeof initialization>>) => {\n        logger.info('启动页初始化完成');\n\n        // 触发初始化完成事件\n        if (frameworkEventManager) {\n          const initDuration = context.duration || 0;\n          frameworkEventManager.emitAppInitComplete(finalInstanceId, context, initDuration);\n        }\n\n        if (options.onSplashComplete) {\n          Promise.resolve(\n            options.onSplashComplete(() => {\n              logger.info('框架加载完成');\n              renderApp(context);\n            }, context)\n          ).catch((error) => {\n            logger.error('onSplashComplete 回调执行失败:', error);\n            initializationErrorState.setError(error);\n            renderApp(context);\n          });\n        } else {\n          logger.info('框架加载完成');\n          renderApp(context);\n        }\n      };\n\n      // 触发初始化开始事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppInitStart(finalInstanceId);\n      }\n\n      // 渲染启动页\n      renderer.renderSplashScreen(options, services, onSplashComplete);\n    } else {\n      // 场景2: 不显示启动页，直接执行初始化\n      logger.info('开始执行初始化（无启动页）');\n\n      // 触发初始化开始事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppInitStart(finalInstanceId);\n      }\n\n      try {\n        const initStart = performance.now();\n\n        // 使用中间件包装初始化函数\n        const initContext = await middlewareManager.execute(\n          options,\n          async () => {\n            return await initialization(options, (progress, step) => {\n              logger.debug(`初始化进度: ${progress}%${step ? ` - ${step}` : ''}`);\n            });\n          }\n        );\n\n        const initDuration = performance.now() - initStart;\n        \n        // 触发初始化完成事件\n        if (frameworkEventManager) {\n          frameworkEventManager.emitAppInitComplete(finalInstanceId, initContext, initDuration);\n        }\n        \n        if (performanceTracker) {\n          performanceTracker.recordInitialization(initDuration);\n        }\n\n        logger.info('初始化完成（无启动页）', initContext);\n        logger.info('框架加载完成');\n        renderApp(initContext);\n      } catch (error) {\n        logger.error('初始化失败:', error);\n        \n        // 触发初始化错误事件\n        if (frameworkEventManager) {\n          frameworkEventManager.emitAppInitError(\n            finalInstanceId,\n            error instanceof Error ? error : new Error(String(error))\n          );\n        }\n        \n        initializationErrorState.setError(error);\n        renderApp();\n      }\n    }\n\n    return instanceManager;\n  } catch (error) {\n    logger.error('框架启动失败:', error);\n\n    // 触发错误事件\n    if (frameworkEventManager) {\n      const errorInstanceId = instanceId || instanceManager.getInstance()?.id;\n      if (errorInstanceId) {\n        frameworkEventManager.emitErrorOccurred(\n          error instanceof Error ? error : new Error(String(error)),\n          { phase: 'startup' }\n        );\n      }\n    }\n\n    // 如果容器存在，尝试渲染错误页面\n    const container = options.container || envDetector.safeGetElement('#root');\n    if (container) {\n      const errorInstance = instanceManager.getInstance();\n      if (errorInstance && errorInstance.isInitialized()) {\n        const renderer = errorInstance.getRenderer();\n        const services = errorInstance.getServices();\n        initializationErrorState.setError(error);\n        renderer.renderError(options, services);\n      }\n    }\n\n    throw error;\n  }\n}\n"],"names":["startApp","options","instanceId","startTime","performance","now","envDetector","getEnvironmentDetector","instanceManager","getAppInstanceManager","initTraceIdGenerator","traceId","generateTraceId","setCurrentTraceId","frameworkEventManager","container","safeGetElement","InitializationError","undefined","ErrorCode","CONTAINER_NOT_FOUND","logger","info","appInstance","createInstance","finalInstanceId","id","servicesInitStart","services","initializeServices","eventBus","servicesInitDuration","FrameworkEventManager","emitAppStart","emitInstanceCreated","initialize","routerManager","getRouterManager","router","performanceTracker","getPerformanceTracker","recordServiceInit","shouldShowSplash","shouldShowSplashScreen","showSplashScreen","renderer","getRenderer","renderApp","context","renderStart","emitAppRenderStart","renderDuration","emitAppRenderComplete","recordFirstRender","totalDuration","recordTotalStartup","report","emitAppStarted","process","env","NODE_ENV","window","setTimeout","devToolsContainer","document","createElement","body","appendChild","onSplashComplete","initDuration","duration","emitAppInitComplete","Promise","resolve","catch","error","initializationErrorState","setError","emitAppInitStart","renderSplashScreen","initStart","initContext","middlewareManager","execute","initialization","progress","step","debug","recordInitialization","emitAppInitError","Error","String","errorInstanceId","getInstance","emitErrorOccurred","phase","errorInstance","isInitialized","getServices","renderError"],"mappings":"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"}
+{"version":3,"sources":["../../../src/core/startup/startApp.ts"],"sourcesContent":["/**\n * 应用启动主函数\n * 重构后的启动逻辑，集成所有新功能\n */\n\nimport { logger } from '../../utils';\nimport { ErrorCode, InitializationError } from '../../utils/errors';\nimport { initTraceIdGenerator, generateTraceId, setCurrentTraceId } from '../../utils/traceId';\nimport type { StartOptions } from '../types';\nimport { shouldShowSplashScreen } from '../splash';\nimport { initialization, initializationErrorState } from '../initialization/index';\nimport { middlewareManager } from '../middleware';\nimport { initializeServices } from './initializeServices';\nimport type { ServicesInitResult } from './initializeServices';\nimport { AppInstanceManager, getAppInstanceManager } from './AppInstance';\nimport { getEnvironmentDetector } from './environment';\nimport { getRouterManager } from '../router/RouterManager';\nimport { FrameworkEventManager } from '../event/frameworkEvents';\nimport { startKernel } from '../kernel';\n\n/**\n * 启动应用\n * \n * @param options - 启动配置选项\n * @param instanceId - 应用实例ID（可选，用于多实例场景）\n * @returns 应用实例\n */\nexport async function startApp(\n  options: StartOptions = {},\n  instanceId?: string\n): Promise<AppInstanceManager> {\n  const startTime = performance.now();\n  const envDetector = getEnvironmentDetector();\n  const instanceManager = getAppInstanceManager();\n\n  // 初始化追踪 ID 生成器\n  initTraceIdGenerator('app');\n  const traceId = generateTraceId();\n  setCurrentTraceId(traceId);\n\n  // 框架事件管理器（在服务初始化后创建）\n  let frameworkEventManager: FrameworkEventManager | null = null;\n  let kernelTraceId: string | null = null;\n\n  try {\n    // 1. 环境检测和容器获取\n    const container = options.container || envDetector.safeGetElement('#root');\n    if (!container) {\n      throw new InitializationError(\n        '未找到挂载容器',\n        undefined,\n        { container: options.container },\n        ErrorCode.CONTAINER_NOT_FOUND\n      );\n    }\n\n    logger.info('框架启动中...');\n\n    if (options.antd && !options.uiProvider) {\n      logger.warn('[deprecated] StartOptions.antd 即将废弃，请迁移到 StartOptions.uiProvider');\n    }\n    if (options.antdApp && !options.uiApp) {\n      logger.warn('[deprecated] StartOptions.antdApp 即将废弃，请迁移到 StartOptions.uiApp');\n    }\n\n    // 2. 创建应用实例\n    const appInstance = instanceManager.createInstance(instanceId, options);\n    const finalInstanceId = appInstance.id;\n    let services: ServicesInitResult | null = null;\n\n    // 使用单次 Promise 防止重复初始化，提升加载速度并保证可观测数据一致。\n    let servicesInitPromise: Promise<ServicesInitResult> | null = null;\n    const ensureServicesInitialized = async (): Promise<ServicesInitResult> => {\n      if (services) {\n        return services;\n      }\n      if (!servicesInitPromise) {\n        servicesInitPromise = initializeServices({\n          ...options,\n          eventBus: {\n            ...options.eventBus,\n            instanceId: finalInstanceId,\n          },\n        });\n      }\n      services = await servicesInitPromise;\n      return services;\n    };\n\n    // 3. 使用无 UI Kernel 管理启动阶段（配置、主题、i18n、服务注入、统一错误处理）\n    const kernelRuntime = await startKernel({\n      loggerLevel: options.loggerLevel,\n      configLoader: options.configStrategy?.loadCriticalConfig,\n      configFallback: options.configStrategy?.fallbackConfig,\n      locale: {\n        locale: (options.locale ? (Object.keys(options.locale)[0] as any) : 'zh-CN') || 'zh-CN',\n        resources: options.locale as any,\n      },\n      theme: {\n        mode: options.theme?.mode || 'light',\n        primaryColor: options.theme?.primaryColor,\n        compatibility: {\n          antd: (options.uiProvider || options.antd) as unknown as Record<string, unknown> | undefined,\n        },\n      },\n      adapters: {\n        monitoring: {\n          initialize: async () => {\n            await ensureServicesInitialized();\n          },\n          captureError: (error, metadata) => {\n            if (services) {\n              services.monitoring.captureError(error, metadata);\n            } else {\n              logger.error('Kernel 监控上报失败（服务尚未初始化）:', error, metadata);\n            }\n          },\n          reportMetric: (name, value, tags) => {\n            logger.debug(`[kernel.metric] ${name}`, { value, tags, instanceId: finalInstanceId });\n          },\n        },\n        state: {\n          initialize: async () => {\n            await ensureServicesInitialized();\n          },\n          getInstance: () => services?.stateManager ?? null,\n        },\n        eventBus: {\n          initialize: async () => {\n            await ensureServicesInitialized();\n          },\n          emit: (event, payload) => {\n            if (services) {\n              services.eventBus.emit(event as any, payload as any);\n            }\n          },\n          on: (event, handler) => {\n            if (!services) {\n              return () => {};\n            }\n            return services.eventBus.on(event as any, handler as any);\n          },\n        },\n        errorHandler: {\n          async handle(error) {\n            logger.error('Kernel 启动阶段失败:', error);\n            return { handled: true, shouldThrow: true };\n          },\n        },\n      },\n      enabledPhases: {\n        init: false,\n      },\n      enablePostReady: false,\n    });\n    kernelTraceId = kernelRuntime.traceId;\n\n    const servicesInitStart = performance.now();\n    const resolvedServices = await ensureServicesInitialized();\n    const servicesInitDuration = performance.now() - servicesInitStart;\n\n    // 创建框架事件管理器\n    frameworkEventManager = new FrameworkEventManager(resolvedServices.eventBus);\n    \n    // 触发应用启动事件（使用真实的事件总线）\n    frameworkEventManager.emitAppStart(finalInstanceId);\n    \n    // 触发实例创建事件\n    frameworkEventManager.emitInstanceCreated(finalInstanceId);\n\n    // 4. 初始化应用实例\n    appInstance.initialize(container, resolvedServices);\n\n    // 5. 初始化路由管理器\n    const routerManager = getRouterManager();\n    if (options.router) {\n      await routerManager.initialize(options.router);\n    }\n\n    // 6. 性能追踪\n    const performanceTracker = appInstance.getPerformanceTracker();\n    if (performanceTracker) {\n      performanceTracker.recordServiceInit(servicesInitDuration);\n    }\n\n    // 6. 是否显示启动页\n    const shouldShowSplash = shouldShowSplashScreen(options.showSplashScreen);\n\n    const renderer = appInstance.getRenderer();\n\n    // 8. 渲染应用函数\n    const renderApp = async (context?: Awaited<ReturnType<typeof initialization>>) => {\n      const renderStart = performance.now();\n      \n      // 触发渲染开始事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppRenderStart(finalInstanceId);\n      }\n      \n      await renderer.renderApp(options, resolvedServices, context);\n      const renderDuration = performance.now() - renderStart;\n\n      // 触发渲染完成事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppRenderComplete(finalInstanceId, renderDuration);\n      }\n\n      // 优化：在应用渲染完成后，延迟初始化非关键服务\n      // 使用 requestIdleCallback 在浏览器空闲时初始化，不影响用户体验\n      if (resolvedServices.initializeNonCriticalServices) {\n        resolvedServices.initializeNonCriticalServices().catch((error) => {\n          logger.warn('非关键服务初始化失败（不影响应用运行）:', error);\n        });\n      }\n\n      if (performanceTracker) {\n        performanceTracker.recordFirstRender(renderDuration);\n        const totalDuration = performance.now() - startTime;\n        performanceTracker.recordTotalStartup(totalDuration);\n        performanceTracker.report();\n      }\n      \n      // 触发应用启动完成事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppStarted(finalInstanceId, performance.now() - startTime);\n      }\n\n      // 统一发出 Kernel post-ready 事件，供可观测系统消费。\n      kernelRuntime.getEventBus().emit('kernel.postReady', {\n        traceId: kernelRuntime.traceId,\n        instanceId: finalInstanceId,\n        startupDuration: performance.now() - startTime,\n      });\n\n      // 开发模式下显示开发工具\n      if (process.env.NODE_ENV === 'development' && typeof window !== 'undefined') {\n        // 延迟显示开发工具，避免影响首次渲染\n        setTimeout(() => {\n          const devToolsContainer = document.createElement('div');\n          devToolsContainer.id = '__framework_dev_tools__';\n          document.body.appendChild(devToolsContainer);\n          \n          // 这里需要动态导入React来渲染开发工具\n          // 为了简化，暂时注释掉，后续可以完善\n          // import('react-dom/client').then(({ createRoot }) => {\n          //   const root = createRoot(devToolsContainer);\n          //   root.render(<DevToolsTrigger appInstance={appInstance} />);\n          // });\n        }, 1000);\n      }\n    };\n\n    if (shouldShowSplash) {\n      // 场景1: 显示启动页，初始化在启动页中完成\n      const onSplashComplete = (context: Awaited<ReturnType<typeof initialization>>) => {\n        logger.info('启动页初始化完成');\n\n        // 触发初始化完成事件\n        if (frameworkEventManager) {\n          const initDuration = context.duration || 0;\n          frameworkEventManager.emitAppInitComplete(finalInstanceId, context, initDuration);\n        }\n\n        if (options.onSplashComplete) {\n          Promise.resolve(\n            options.onSplashComplete(() => {\n              logger.info('框架加载完成');\n              renderApp(context);\n            }, context)\n          ).catch((error) => {\n            logger.error('onSplashComplete 回调执行失败:', error);\n            initializationErrorState.setError(error);\n            renderApp(context);\n          });\n        } else {\n          logger.info('框架加载完成');\n          renderApp(context);\n        }\n      };\n\n      // 触发初始化开始事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppInitStart(finalInstanceId);\n      }\n\n      // 渲染启动页\n      renderer.renderSplashScreen(options, resolvedServices, onSplashComplete);\n    } else {\n      // 场景2: 不显示启动页，直接执行初始化\n      logger.info('开始执行初始化（无启动页）');\n\n      // 触发初始化开始事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppInitStart(finalInstanceId);\n      }\n\n      try {\n        const initStart = performance.now();\n\n        // 使用中间件包装初始化函数\n        const initContext = await middlewareManager.execute(\n          options,\n          async () => {\n            return await initialization(options, (progress, step) => {\n              logger.debug(`初始化进度: ${progress}%${step ? ` - ${step}` : ''}`);\n            });\n          }\n        );\n\n        const initDuration = performance.now() - initStart;\n        \n        // 触发初始化完成事件\n        if (frameworkEventManager) {\n          frameworkEventManager.emitAppInitComplete(finalInstanceId, initContext, initDuration);\n        }\n        \n        if (performanceTracker) {\n          performanceTracker.recordInitialization(initDuration);\n        }\n\n        logger.info('初始化完成（无启动页）', initContext);\n        logger.info('框架加载完成');\n        renderApp(initContext);\n      } catch (error) {\n        logger.error('初始化失败:', error);\n        \n        // 触发初始化错误事件\n        if (frameworkEventManager) {\n          frameworkEventManager.emitAppInitError(\n            finalInstanceId,\n            error instanceof Error ? error : new Error(String(error))\n          );\n        }\n        \n        initializationErrorState.setError(error);\n        renderApp();\n      }\n    }\n\n    return instanceManager;\n  } catch (error) {\n    logger.error('框架启动失败:', error);\n\n    // 触发错误事件\n    if (frameworkEventManager) {\n      const errorInstanceId = instanceId || instanceManager.getInstance()?.id;\n      if (errorInstanceId) {\n        frameworkEventManager.emitErrorOccurred(\n          error instanceof Error ? error : new Error(String(error)),\n          { phase: 'startup' }\n        );\n      }\n    }\n\n    if (kernelTraceId) {\n      logger.error('Kernel Trace 失败上下文', { traceId: kernelTraceId });\n    }\n\n    // 如果容器存在，尝试渲染错误页面\n    const container = options.container || envDetector.safeGetElement('#root');\n    if (container) {\n      const errorInstance = instanceManager.getInstance();\n      if (errorInstance && errorInstance.isInitialized()) {\n        const renderer = errorInstance.getRenderer();\n        const services = errorInstance.getServices();\n        initializationErrorState.setError(error);\n        renderer.renderError(options, services);\n      }\n    }\n\n    throw error;\n  }\n}\n"],"names":["startApp","options","instanceId","startTime","performance","now","envDetector","getEnvironmentDetector","instanceManager","getAppInstanceManager","initTraceIdGenerator","traceId","generateTraceId","setCurrentTraceId","frameworkEventManager","kernelTraceId","container","safeGetElement","InitializationError","undefined","ErrorCode","CONTAINER_NOT_FOUND","logger","info","antd","uiProvider","warn","antdApp","uiApp","appInstance","createInstance","finalInstanceId","id","services","servicesInitPromise","ensureServicesInitialized","initializeServices","eventBus","kernelRuntime","startKernel","loggerLevel","configLoader","configStrategy","loadCriticalConfig","configFallback","fallbackConfig","locale","Object","keys","resources","theme","mode","primaryColor","compatibility","adapters","monitoring","initialize","captureError","error","metadata","reportMetric","name","value","tags","debug","state","getInstance","stateManager","emit","event","payload","on","handler","errorHandler","handle","handled","shouldThrow","enabledPhases","init","enablePostReady","servicesInitStart","resolvedServices","servicesInitDuration","FrameworkEventManager","emitAppStart","emitInstanceCreated","routerManager","getRouterManager","router","performanceTracker","getPerformanceTracker","recordServiceInit","shouldShowSplash","shouldShowSplashScreen","showSplashScreen","renderer","getRenderer","renderApp","context","renderStart","emitAppRenderStart","renderDuration","emitAppRenderComplete","initializeNonCriticalServices","catch","recordFirstRender","totalDuration","recordTotalStartup","report","emitAppStarted","getEventBus","startupDuration","process","env","NODE_ENV","window","setTimeout","devToolsContainer","document","createElement","body","appendChild","onSplashComplete","initDuration","duration","emitAppInitComplete","Promise","resolve","initializationErrorState","setError","emitAppInitStart","renderSplashScreen","initStart","initContext","middlewareManager","execute","initialization","progress","step","recordInitialization","emitAppInitError","Error","String","errorInstanceId","emitErrorOccurred","phase","errorInstance","isInitialized","getServices","renderError"],"mappings":"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"}

package/dist/core/startup/startApp.d.ts

@@ -12,4 +12,3 @@ import { AppInstanceManager } from './AppInstance';
  * @returns 应用实例
  */
 export declare function startApp(options?: StartOptions, instanceId?: string): Promise<AppInstanceManager>;
-//# sourceMappingURL=startApp.d.ts.map

package/dist/core/startup/startApp.js

@@ -12,6 +12,7 @@ import { getAppInstanceManager } from "./AppInstance";
 import { getEnvironmentDetector } from "./environment";
 import { getRouterManager } from "../router/RouterManager";
 import { FrameworkEventManager } from "../event/frameworkEvents";
+import { startKernel } from "../kernel";
 /**
  * 启动应用
  * 
@@ -28,6 +29,7 @@ import { FrameworkEventManager } from "../event/frameworkEvents";
     setCurrentTraceId(traceId);
     // 框架事件管理器（在服务初始化后创建）
     let frameworkEventManager = null;
+    let kernelTraceId = null;
     try {
         // 1. 环境检测和容器获取
         const container = options.container || envDetector.safeGetElement('#root');
@@ -37,27 +39,119 @@ import { FrameworkEventManager } from "../event/frameworkEvents";
             }, ErrorCode.CONTAINER_NOT_FOUND);
         }
         logger.info('框架启动中...');
+        if (options.antd && !options.uiProvider) {
+            logger.warn('[deprecated] StartOptions.antd 即将废弃，请迁移到 StartOptions.uiProvider');
+        }
+        if (options.antdApp && !options.uiApp) {
+            logger.warn('[deprecated] StartOptions.antdApp 即将废弃，请迁移到 StartOptions.uiApp');
+        }
         // 2. 创建应用实例
         const appInstance = instanceManager.createInstance(instanceId, options);
         const finalInstanceId = appInstance.id;
-        // 3. 初始化服务（并行）
-        const servicesInitStart = performance.now();
-        const services = await initializeServices({
-            ...options,
-            eventBus: {
-                ...options.eventBus,
-                instanceId: finalInstanceId
+        let services = null;
+        // 使用单次 Promise 防止重复初始化，提升加载速度并保证可观测数据一致。
+        let servicesInitPromise = null;
+        const ensureServicesInitialized = async ()=>{
+            if (services) {
+                return services;
             }
+            if (!servicesInitPromise) {
+                servicesInitPromise = initializeServices({
+                    ...options,
+                    eventBus: {
+                        ...options.eventBus,
+                        instanceId: finalInstanceId
+                    }
+                });
+            }
+            services = await servicesInitPromise;
+            return services;
+        };
+        // 3. 使用无 UI Kernel 管理启动阶段（配置、主题、i18n、服务注入、统一错误处理）
+        const kernelRuntime = await startKernel({
+            loggerLevel: options.loggerLevel,
+            configLoader: options.configStrategy?.loadCriticalConfig,
+            configFallback: options.configStrategy?.fallbackConfig,
+            locale: {
+                locale: (options.locale ? Object.keys(options.locale)[0] : 'zh-CN') || 'zh-CN',
+                resources: options.locale
+            },
+            theme: {
+                mode: options.theme?.mode || 'light',
+                primaryColor: options.theme?.primaryColor,
+                compatibility: {
+                    antd: options.uiProvider || options.antd
+                }
+            },
+            adapters: {
+                monitoring: {
+                    initialize: async ()=>{
+                        await ensureServicesInitialized();
+                    },
+                    captureError: (error, metadata)=>{
+                        if (services) {
+                            services.monitoring.captureError(error, metadata);
+                        } else {
+                            logger.error('Kernel 监控上报失败（服务尚未初始化）:', error, metadata);
+                        }
+                    },
+                    reportMetric: (name, value, tags)=>{
+                        logger.debug(`[kernel.metric] ${name}`, {
+                            value,
+                            tags,
+                            instanceId: finalInstanceId
+                        });
+                    }
+                },
+                state: {
+                    initialize: async ()=>{
+                        await ensureServicesInitialized();
+                    },
+                    getInstance: ()=>services?.stateManager ?? null
+                },
+                eventBus: {
+                    initialize: async ()=>{
+                        await ensureServicesInitialized();
+                    },
+                    emit: (event, payload)=>{
+                        if (services) {
+                            services.eventBus.emit(event, payload);
+                        }
+                    },
+                    on: (event, handler)=>{
+                        if (!services) {
+                            return ()=>{};
+                        }
+                        return services.eventBus.on(event, handler);
+                    }
+                },
+                errorHandler: {
+                    async handle (error) {
+                        logger.error('Kernel 启动阶段失败:', error);
+                        return {
+                            handled: true,
+                            shouldThrow: true
+                        };
+                    }
+                }
+            },
+            enabledPhases: {
+                init: false
+            },
+            enablePostReady: false
         });
+        kernelTraceId = kernelRuntime.traceId;
+        const servicesInitStart = performance.now();
+        const resolvedServices = await ensureServicesInitialized();
         const servicesInitDuration = performance.now() - servicesInitStart;
         // 创建框架事件管理器
-        frameworkEventManager = new FrameworkEventManager(services.eventBus);
+        frameworkEventManager = new FrameworkEventManager(resolvedServices.eventBus);
         // 触发应用启动事件（使用真实的事件总线）
         frameworkEventManager.emitAppStart(finalInstanceId);
         // 触发实例创建事件
         frameworkEventManager.emitInstanceCreated(finalInstanceId);
         // 4. 初始化应用实例
-        appInstance.initialize(container, services);
+        appInstance.initialize(container, resolvedServices);
         // 5. 初始化路由管理器
         const routerManager = getRouterManager();
         if (options.router) {
@@ -78,12 +172,19 @@ import { FrameworkEventManager } from "../event/frameworkEvents";
             if (frameworkEventManager) {
                 frameworkEventManager.emitAppRenderStart(finalInstanceId);
             }
-            await renderer.renderApp(options, services, context);
+            await renderer.renderApp(options, resolvedServices, context);
             const renderDuration = performance.now() - renderStart;
             // 触发渲染完成事件
             if (frameworkEventManager) {
                 frameworkEventManager.emitAppRenderComplete(finalInstanceId, renderDuration);
             }
+            // 优化：在应用渲染完成后，延迟初始化非关键服务
+            // 使用 requestIdleCallback 在浏览器空闲时初始化，不影响用户体验
+            if (resolvedServices.initializeNonCriticalServices) {
+                resolvedServices.initializeNonCriticalServices().catch((error)=>{
+                    logger.warn('非关键服务初始化失败（不影响应用运行）:', error);
+                });
+            }
             if (performanceTracker) {
                 performanceTracker.recordFirstRender(renderDuration);
                 const totalDuration = performance.now() - startTime;
@@ -94,6 +195,12 @@ import { FrameworkEventManager } from "../event/frameworkEvents";
             if (frameworkEventManager) {
                 frameworkEventManager.emitAppStarted(finalInstanceId, performance.now() - startTime);
             }
+            // 统一发出 Kernel post-ready 事件，供可观测系统消费。
+            kernelRuntime.getEventBus().emit('kernel.postReady', {
+                traceId: kernelRuntime.traceId,
+                instanceId: finalInstanceId,
+                startupDuration: performance.now() - startTime
+            });
             // 开发模式下显示开发工具
             if (process.env.NODE_ENV === 'development' && typeof window !== 'undefined') {
                 // 延迟显示开发工具，避免影响首次渲染
@@ -138,7 +245,7 @@ import { FrameworkEventManager } from "../event/frameworkEvents";
                 frameworkEventManager.emitAppInitStart(finalInstanceId);
             }
             // 渲染启动页
-            renderer.renderSplashScreen(options, services, onSplashComplete);
+            renderer.renderSplashScreen(options, resolvedServices, onSplashComplete);
         } else {
             // 场景2: 不显示启动页，直接执行初始化
             logger.info('开始执行初始化（无启动页）');
@@ -187,6 +294,11 @@ import { FrameworkEventManager } from "../event/frameworkEvents";
                 });
             }
         }
+        if (kernelTraceId) {
+            logger.error('Kernel Trace 失败上下文', {
+                traceId: kernelTraceId
+            });
+        }
         // 如果容器存在，尝试渲染错误页面
         const container = options.container || envDetector.safeGetElement('#root');
         if (container) {