generator-mico-cli 0.1.29 → 0.2.2-8.beta.1

package/generators/micro-react/templates/apps/layout/package.json

@@ -3,6 +3,7 @@
   "private": true,
   "author": "Easton <easton@micous.com>",
   "scripts": {
+    "check-types": "tsc --noEmit",
     "build": "npm run build:production",
     "build:development": "cross-env UMI_ENV=development max build",
     "build:production": "cross-env UMI_ENV=production max build",
@@ -21,11 +22,9 @@
     "test": "cross-env UMI_ENV=test max dev"
   },
   "dependencies": {
-    "@arco-design/web-react": "^2.66.6",
-    "<%= packageScope %>/shared-styles": "workspace:*",
+    "@mico-platform/ui": "<%= micoUiVersion %>",
+    "@mico-platform/theme": "<%= themeVersion %>",
     "@umijs/max": "^4.6.15",
-    "babel-plugin-dynamic-import-node": "^2.3.3",
-    "cross-env": "^10.1.0",
     "dayjs": "^1.11.19",
     "qiankun": "^2.10.16",
     "react": "^18.2.0",
@@ -35,6 +34,10 @@
   "devDependencies": {
     "@types/react": "^18.0.33",
     "@types/react-dom": "^18.0.11",
+    "@types/spark-md5": "^3.0.5",
+    "babel-plugin-dynamic-import-node": "^2.3.3",
+    "babel-plugin-import": "^1.13.8",
+    "cross-env": "^10.1.0",
     "lint-staged": "^13.2.0",
     "prettier": "^2.8.7",
     "prettier-plugin-organize-imports": "^3.2.2",

package/generators/micro-react/templates/apps/layout/src/app.tsx

@@ -1,93 +1,85 @@
 import { history, type RequestConfig } from '@umijs/max';
-import { prefetchApps } from 'qiankun';
+import { addGlobalUncaughtErrorHandler } from 'qiankun';
+import { SentryErrorBoundary } from '@common-web/sentry';
 import { errorConfig } from './requestErrorConfig';
-// 解决「React19 中无法使用 Message/Notification」的问题。 @see https://github.com/arco-design/arco-design/issues/2900#issuecomment-2796571653
-import * as arco from '@arco-design/web-react';
-import '@arco-design/web-react/dist/css/arco.css';
-import '@arco-design/web-react/es/_util/react-19-adapter';
+// 将 @mico-platform/ui 暴露到 window，供子应用 externals 使用
+import * as micoUI from '@mico-platform/ui';
 import React from 'react';
-import ReactDOM from 'react-dom/client';
+import ReactDOM from 'react-dom';
 
 import { getStoredAuthToken } from './common/auth/auth-manager';
 import type { IUserInfo } from './common/auth/type';
 import { fetchUserInfo } from './services/user';
-import { extractRoutes, getWindowMenus } from './common/menu';
-import { ensureSsoSession } from './common/request/sso';
+import { getDynamicRoutes, isPageAuthFree } from './common/menu';
 import {
   clearMicroAppProps,
   type IMicroAppProps,
   setMicroAppProps,
 } from './common/micro';
+import {
+  clearRedirectCount,
+  ensureSsoSession,
+  handleAuthFailureRedirect,
+} from './common/request/sso';
 import { initTheme } from './common/theme';
 import MicroAppLoader from './components/MicroAppLoader';
-import { NO_AUTH_ROUTE_LIST } from './constants';
+import { isNoAuthRoute } from '@/constants';
+import { getCurrentLocale } from '@/common/locale';
+import '@mico-platform/theme/dist/css/theme.css';
 import './global.less';
 
-// ==================== 微应用预加载 ====================
-// 预加载所有微应用资源，避免快速切换时的竞态条件
-// 当资源已预加载时，loadMicroApp 的异步加载会快速完成，减少容器不存在的错误
+// ==================== qiankun 全局错误处理 ====================
+// 捕获子应用运行时未捕获的异常，防止页面崩溃
 
 /**
- * 是否启用微应用预加载
- * - 可通过 URL 参数 ?prefetch=false 禁用（方便调试加载时序问题）
- * - 可通过 localStorage.setItem('DISABLE_MICRO_APP_PREFETCH', 'true') 禁用
- * - 默认启用
+ * 注册 qiankun 全局未捕获错误处理器
+ * 处理以下场景：
+ * 1. 子应用 JS 运行时错误
+ * 2. 子应用生命周期钩子抛出的异常
+ * 3. 子应用资源加载失败
  */
-const isPrefetchEnabled = (): boolean => {
-  if (typeof window === 'undefined') return false;
-
-  // URL 参数优先级最高
-  const urlParams = new URLSearchParams(window.location.search);
-  const prefetchParam = urlParams.get('prefetch');
-  if (prefetchParam === 'false') {
-    console.log('[App] Prefetch disabled via URL parameter');
-    return false;
-  }
+if (typeof window !== 'undefined') {
+  addGlobalUncaughtErrorHandler((event: Event | string) => {
+    // 提取错误信息
+    const error =
+      event instanceof ErrorEvent
+        ? event.error
+        : event instanceof PromiseRejectionEvent
+          ? event.reason
+          : event;
 
-  // localStorage 开关
-  if (localStorage.getItem('DISABLE_MICRO_APP_PREFETCH') === 'true') {
-    console.log('[App] Prefetch disabled via localStorage');
-    return false;
-  }
+    const errorMessage =
+      error instanceof Error
+        ? error.message
+        : typeof error === 'string'
+          ? error
+          : 'Unknown micro-app error';
 
-  return true;
-};
+    console.error('[qiankun] Global uncaught error:', {
+      error,
+      message: errorMessage,
+      type: event instanceof Event ? event.type : 'unknown',
+    });
 
-const prefetchMicroApps = () => {
-  if (!isPrefetchEnabled()) {
-    return;
-  }
+    // 检查是否是子应用加载失败（资源 404 等）
+    // 只匹配明确的关键词，避免误判业务错误（如 "upload failed"）
+    const isLoadError =
+      errorMessage.includes('Failed to fetch') ||
+      errorMessage.includes('Loading chunk') ||
+      errorMessage.includes('ChunkLoadError') ||
+      errorMessage.includes('Script error') ||
+      errorMessage.includes('Loading CSS chunk') ||
+      (event instanceof ErrorEvent && event.type === 'error');
 
-  try {
-    const menus = getWindowMenus();
-    const routes = extractRoutes(menus);
-
-    // 筛选出所有微应用路由
-    const microApps = routes
-      .filter((route) => route.loadType === 'microapp' && route.entry)
-      .map((route) => ({
-        name: route.path,
-        entry: route.entry!,
-      }));
-
-    if (microApps.length > 0) {
-      console.log('[App] Prefetching micro apps:', microApps);
-      prefetchApps(microApps);
+    if (isLoadError) {
+      console.error(
+        '[qiankun] Micro-app resource loading failed. Please check if the micro-app server is running.',
+      );
     }
-  } catch (error) {
-    console.warn('[App] Failed to prefetch micro apps:', error);
-  }
-};
 
-// 在页面加载后预加载微应用
-if (typeof window !== 'undefined') {
-  // 使用 requestIdleCallback 在浏览器空闲时预加载，避免影响首屏渲染
-  if ('requestIdleCallback' in window) {
-    window.requestIdleCallback(() => prefetchMicroApps(), { timeout: 3000 });
-  } else {
-    // 降级方案：延迟 1 秒后预加载
-    setTimeout(prefetchMicroApps, 1000);
-  }
+    // 注意：这里不阻止错误冒泡，让控制台仍能显示原始错误
+    // 如果需要阻止，可以 return true
+  });
 }
 
 // ==================== 微前端共享依赖 ====================
@@ -97,12 +89,24 @@ if (typeof window !== 'undefined') {
   const win = window as unknown as Record<string, unknown>;
   win.React = React;
   win.ReactDOM = ReactDOM;
-  win.arco = arco;
+  win.micoUI = micoUI;
 }
 
 // 初始化主题（在页面加载时立即执行，避免闪烁）
 initTheme();
 
+// ==================== 国际化运行时配置 ====================
+
+/**
+ * 运行时国际化配置
+ * @see https://umijs.org/docs/max/i18n#%E8%BF%90%E8%A1%8C%E6%97%B6%E9%85%8D%E7%BD%AE
+ */
+export const locale = {
+  getLocale() {
+    return getCurrentLocale();
+  },
+};
+
 /**
  * @see https://umijs.org/docs/api/runtime-config#getinitialstate
  */
@@ -124,29 +128,41 @@ export async function getInitialState(): Promise<{
     }
   };
 
-  // 如果不是登录页面，执行
   const { location } = history;
-  if (!NO_AUTH_ROUTE_LIST.includes(location.pathname)) {
-    // 先确保 SSO 会话完成（如果 URL 中有 ticket 参数，会换取 token 并存储用户信息）
+  const noAuthRoute = isNoAuthRoute(location.pathname);
+  const skipAuth = noAuthRoute || isPageAuthFree(location.pathname);
+
+  // 非免认证路由：走 SSO 流程
+  if (!skipAuth) {
     await ensureSsoSession();
+  }
 
-    // 有 token 时，获取用户信息
-    if (getStoredAuthToken()) {
-      const userInfo = await fetchUserInfoFn();
-      if (userInfo) {
-        return {
-          fetchUserInfo: fetchUserInfoFn,
-          currentUser: userInfo,
-        };
-      }
+  // 有 token 就获取用户信息（无论在哪个页面，支持登录后 refresh 场景）
+  // 当页面免认证时，不获取用户信息
+  if (getStoredAuthToken() && !skipAuth) {
+    const userInfo = await fetchUserInfoFn();
+    if (userInfo) {
+      clearRedirectCount();
+      return {
+        fetchUserInfo: fetchUserInfoFn,
+        currentUser: userInfo,
+      };
     }
   }
 
+  // 非免认证路由且没有 token，跳转到 SSO 登录
+  if (!skipAuth) {
+    handleAuthFailureRedirect();
+    // 返回空状态，页面会被重定向
+    return {
+      fetchUserInfo: fetchUserInfoFn,
+    };
+  }
+
   return {
     fetchUserInfo: fetchUserInfoFn,
   };
 }
-
 /**
  * @name request 配置，可以配置错误处理
  * 它基于 axios 和 ahooks 的 useRequest 提供了一套统一的网络请求和错误处理方案。
@@ -158,6 +174,10 @@ export const request: RequestConfig = {
   ...errorConfig,
 };
 
+export function rootContainer(container: React.ReactNode) {
+  return <SentryErrorBoundary>{container}</SentryErrorBoundary>;
+}
+
 /**
  * Umi 路由类型定义
  */
@@ -172,14 +192,16 @@ interface UmiRoute {
 
 /**
  * @name 动态路由配置
- * 从 window.__MICO_MENUS__ 获取菜单数据，生成动态路由
+ * 优先从 window.__MICO_PAGES__ 获取页面数据，无数据时降级到 window.__MICO_MENUS__
  * @doc https://umijs.org/docs/max/router#%E5%8A%A8%E6%80%81%E8%B7%AF%E7%94%B1
  */
 export function patchClientRoutes({ routes }: { routes: UmiRoute[] }) {
-  const menus = getWindowMenus();
-  const dynamicRoutes = extractRoutes(menus);
+  const dynamicRoutes = getDynamicRoutes();
 
-  console.log('[app.tsx] patchClientRoutes:', { menus, dynamicRoutes, routes });
+  console.log('[app.tsx] patchClientRoutes:', {
+    dynamicRoutes,
+    routes,
+  });
 
   // 找到根路由（全局布局）
   const rootRoute = routes.find((r) => r.path === '/');
@@ -205,6 +227,7 @@ export function patchClientRoutes({ routes }: { routes: UmiRoute[] }) {
         ? React.createElement(MicroAppLoader, {
             entry: route.entry,
             name: route.path,
+            base: route.base,
             displayName: route.name,
           })
         : undefined;
@@ -222,6 +245,22 @@ export function patchClientRoutes({ routes }: { routes: UmiRoute[] }) {
   });
 }
 
+/**
+ * @name 路由变化处理
+ * @description 处理 defaultPath 重定向：访问 "/" 时自动跳转到配置的默认路径
+ * @doc https://umijs.org/docs/api/runtime-config#onroutechange
+ */
+export function onRouteChange({
+  location,
+}: {
+  location: { pathname: string };
+}) {
+  const defaultPath = window.__MICO_CONFIG__?.defaultPath;
+  if (location.pathname === '/' && defaultPath && defaultPath !== '/') {
+    history.replace(defaultPath);
+  }
+}
+
 /**
  * @name qiankun 微前端子应用生命周期
  * @description 当应用作为 qiankun 子应用运行时，这些生命周期会被调用

package/generators/micro-react/templates/apps/layout/src/common/auth/index.ts

@@ -3,6 +3,9 @@ import { checkStaffAuth } from '@/services/auth';
 import { handleAuthFailureRedirect } from '../request';
 import { clearStoredTokens, getAuthInfo } from './auth-manager';
 
+// 导出 STORAGE_KEYS 常量
+export { STORAGE_KEYS } from '../../constants';
+
 export function logout(): void {
   clearStoredTokens();
 }

package/generators/micro-react/templates/apps/layout/src/common/helpers.ts

@@ -1,11 +1,188 @@
 import dayjs from 'dayjs';
 import timezone from 'dayjs/plugin/timezone';
 import utc from 'dayjs/plugin/utc';
+import { STORAGE_KEYS } from '../constants';
 
 // 扩展 dayjs
 dayjs.extend(utc);
 dayjs.extend(timezone);
 
+// ==================== 时区常量 ====================
+
+/**
+ * UTC 偏移量键的枚举映射，覆盖 UTC-12 到 UTC+14
+ */
+export const TIMEZONE = {
+  'UTC-12': 'UTC-12',
+  'UTC-11': 'UTC-11',
+  'UTC-10': 'UTC-10',
+  'UTC-9': 'UTC-9',
+  'UTC-8': 'UTC-8',
+  'UTC-7': 'UTC-7',
+  'UTC-6': 'UTC-6',
+  'UTC-5': 'UTC-5',
+  'UTC-4': 'UTC-4',
+  'UTC-3': 'UTC-3',
+  'UTC-2': 'UTC-2',
+  'UTC-1': 'UTC-1',
+  'UTC+0': 'UTC+0',
+  'UTC+1': 'UTC+1',
+  'UTC+2': 'UTC+2',
+  'UTC+3': 'UTC+3',
+  'UTC+4': 'UTC+4',
+  'UTC+5': 'UTC+5',
+  'UTC+6': 'UTC+6',
+  'UTC+7': 'UTC+7',
+  'UTC+8': 'UTC+8',
+  'UTC+9': 'UTC+9',
+  'UTC+10': 'UTC+10',
+  'UTC+11': 'UTC+11',
+  'UTC+12': 'UTC+12',
+  'UTC+13': 'UTC+13',
+  'UTC+14': 'UTC+14',
+} as const;
+
+export type TTimezone = keyof typeof TIMEZONE;
+
+/**
+ * UTC 偏移量到 IANA 时区标识的映射表
+ * 每个整数偏移值对应一个具有常住人口的代表性城市/地区
+ */
+export const TIMEZONE_HASH: Record<TTimezone, string> = {
+  [TIMEZONE['UTC-12']]: 'Etc/GMT+12', // 无居住区（公海/无人岛）
+  [TIMEZONE['UTC-11']]: 'Pacific/Pago_Pago', // 帕果帕果，美属萨摩亚
+  [TIMEZONE['UTC-10']]: 'Pacific/Honolulu', // 檀香山，夏威夷州
+  [TIMEZONE['UTC-9']]: 'America/Anchorage', // 安克雷奇，阿拉斯加州
+  [TIMEZONE['UTC-8']]: 'America/Los_Angeles', // 洛杉矶，加利福尼亚州
+  [TIMEZONE['UTC-7']]: 'America/Denver', // 丹佛，科罗拉多州
+  [TIMEZONE['UTC-6']]: 'America/Chicago', // 芝加哥，伊利诺伊州
+  [TIMEZONE['UTC-5']]: 'America/New_York', // 纽约，纽约州
+  [TIMEZONE['UTC-4']]: 'America/Puerto_Rico', // 圣胡安，波多黎各
+  [TIMEZONE['UTC-3']]: 'America/Sao_Paulo', // 圣保罗，巴西
+  [TIMEZONE['UTC-2']]: 'America/Noronha', // 费尔南多岛，巴西
+  [TIMEZONE['UTC-1']]: 'Atlantic/Azores', // 亚速尔群岛，葡萄牙
+  [TIMEZONE['UTC+0']]: 'Europe/London', // 伦敦，英国
+  [TIMEZONE['UTC+1']]: 'Europe/Paris', // 巴黎，法国
+  [TIMEZONE['UTC+2']]: 'Europe/Kyiv', // 基辅，乌克兰
+  [TIMEZONE['UTC+3']]: 'Europe/Moscow', // 莫斯科，俄罗斯
+  [TIMEZONE['UTC+4']]: 'Asia/Dubai', // 迪拜，阿联酋
+  [TIMEZONE['UTC+5']]: 'Asia/Tashkent', // 塔什干，乌兹别克斯坦
+  [TIMEZONE['UTC+6']]: 'Asia/Dhaka', // 达卡，孟加拉国
+  [TIMEZONE['UTC+7']]: 'Asia/Bangkok', // 曼谷，泰国
+  [TIMEZONE['UTC+8']]: 'Asia/Shanghai', // 上海，中国（默认）
+  [TIMEZONE['UTC+9']]: 'Asia/Tokyo', // 东京，日本
+  [TIMEZONE['UTC+10']]: 'Australia/Sydney', // 悉尼，澳大利亚
+  [TIMEZONE['UTC+11']]: 'Pacific/Noumea', // 努美阿，新喀里多尼亚
+  [TIMEZONE['UTC+12']]: 'Pacific/Auckland', // 奥克兰，新西兰
+  [TIMEZONE['UTC+13']]: 'Pacific/Tongatapu', // 努库阿洛法，汤加
+  [TIMEZONE['UTC+14']]: 'Pacific/Kiritimati', // 圣诞岛，基里巴斯
+};
+
+// ==================== 时区工具函数 ====================
+
+/**
+ * 将 UTC offset 数字转换为 UTC+N 格式的时区字符串
+ * @param utcOffset UTC 偏移量（数字），如 8 表示 UTC+8，-5 表示 UTC-5
+ * @returns 时区字符串，如 'UTC+8' 或 'UTC-5'
+ */
+export const utcOffsetToTimezone = (utcOffset: number): string => {
+  if (utcOffset >= 0) {
+    return `UTC+${utcOffset}`;
+  }
+  return `UTC${utcOffset}`; // 负数会自动包含负号
+};
+
+/**
+ * 将 UTC 偏移量转换为 IANA 时区标识
+ * @param utcOffset UTC 偏移量
+ * @returns IANA 时区标识（如 'Asia/Shanghai'）
+ */
+export const utcOffsetToTimeZoneStr = (utcOffset: number): string => {
+  const timezoneKey = utcOffsetToTimezone(utcOffset) as TTimezone;
+  return (
+    TIMEZONE_HASH[timezoneKey] ??
+    dayjs.tz.guess() ??
+    TIMEZONE_HASH[TIMEZONE['UTC+8']]
+  );
+};
+
+/**
+ * 从 localStorage 获取时区偏移量数字
+ * @returns 偏移量数字，默认 8（UTC+8）
+ */
+export const getTimezoneOffset = (): number => {
+  return Number(getFromStorage(STORAGE_KEYS.TIMEZONE)) || 8;
+};
+
+/**
+ * 获取当前时区的 IANA 标识
+ * @returns IANA 时区标识（如 'Asia/Shanghai'）
+ */
+export const getTimezone = (): string => {
+  const storedTimezone = getFromStorage(STORAGE_KEYS.TIMEZONE);
+  let timezoneKey: TTimezone | undefined;
+
+  if (storedTimezone) {
+    // 如果存储的是数字字符串（UTC offset），转换为 UTC+N 格式
+    const offsetNum = Number(storedTimezone);
+    if (!Number.isNaN(offsetNum) && storedTimezone.trim() !== '') {
+      timezoneKey = utcOffsetToTimezone(offsetNum) as TTimezone;
+    } else {
+      // 如果已经是 UTC+N 格式，直接使用
+      timezoneKey = storedTimezone as TTimezone;
+    }
+  }
+
+  return (
+    (timezoneKey && TIMEZONE_HASH[timezoneKey]) ??
+    dayjs.tz.guess() ??
+    TIMEZONE_HASH[TIMEZONE['UTC+8']]
+  );
+};
+
+/**
+ * 获取当前时区（从 localStorage 读取）
+ * @returns 时区字符串，如 'UTC+8'，如果未设置则返回 'UTC+8'
+ */
+export const getCurrentTimezone = (): string => {
+  const stored = getFromStorage(STORAGE_KEYS.TIMEZONE);
+  if (stored) {
+    // 如果存储的是数字字符串（UTC offset），转换为 UTC+N 格式
+    const offsetNum = Number(stored);
+    if (!Number.isNaN(offsetNum) && stored.trim() !== '') {
+      return utcOffsetToTimezone(offsetNum);
+    }
+    // 如果已经是 UTC+N 格式，直接返回
+    return stored;
+  }
+  // 默认返回 UTC+8
+  return TIMEZONE['UTC+8'];
+};
+
+/**
+ * 设置时区到 localStorage
+ * @param timezone 时区字符串，如 'UTC+8' 或偏移量数字字符串如 '8'
+ */
+export const setTimezone = (timezone: string): void => {
+  setStorage(STORAGE_KEYS.TIMEZONE, timezone);
+};
+
+/**
+ * 获取时区地区（IANA 标识）
+ * @returns 时区地区字符串，如 'Asia/Shanghai'，如果未设置则返回空字符串
+ */
+export const getTimezoneRegion = (): string => {
+  return getFromStorage(STORAGE_KEYS.TIMEZONE_REGION) || '';
+};
+
+/**
+ * 设置时区地区到 localStorage
+ * @param region 时区地区字符串，如 'Asia/Shanghai'
+ */
+export const setTimezoneRegion = (region: string): void => {
+  setStorage(STORAGE_KEYS.TIMEZONE_REGION, region);
+};
+
 /**
  * 获取静态资源的完整 URL
  * 用于 public 目录下的静态资源，自动拼接 publicPath 前缀

package/generators/micro-react/templates/apps/layout/src/common/locale.ts

@@ -12,11 +12,19 @@ const LOCALE_STORAGE_KEY = 'umi_locale';
 const URL_PARAM_KEY = 'lang';
 
 /**
- * 支持的语言列表
+ * 支持的语言列表（umi 格式）
  */
-export const SUPPORTED_LOCALES = ['zh-CN', 'en-US', 'ar-SA'] as const;
+export const SUPPORTED_LOCALES = ['zh-CN', 'en-US'] as const;
 export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
 
+/**
+ * 语言枚举常量
+ */
+export const LOCALE = {
+  ZH_CN: 'zh-CN',
+  EN_US: 'en-US',
+} as const;
+
 /**
  * 默认语言
  */
@@ -50,20 +58,19 @@ function getLocaleFromStorage(): string | null {
 /**
  * 获取浏览器默认语言
  */
-function getBrowserLocale(): string {
+function getBrowserLocale(): SupportedLocale {
   if (typeof window === 'undefined') {
     return DEFAULT_LOCALE;
   }
   const browserLang = navigator.language || (navigator as any).userLanguage;
-  // 检查是否支持该语言
-  if (SUPPORTED_LOCALES.includes(browserLang as SupportedLocale)) {
-    return browserLang;
+  const locales = [...SUPPORTED_LOCALES];
+  // 检查是否直接支持该语言
+  if (locales.includes(browserLang as SupportedLocale)) {
+    return browserLang as SupportedLocale;
   }
-  // 检查语言前缀（如 zh-TW -> zh-CN）
+  // 检查语言前缀（如 zh-TW -> zh-CN, en-GB -> en-US）
   const langPrefix = browserLang.split('-')[0];
-  const matchedLocale = SUPPORTED_LOCALES.find((locale) =>
-    locale.startsWith(langPrefix),
-  );
+  const matchedLocale = locales.find((locale) => locale.startsWith(langPrefix));
   return matchedLocale || DEFAULT_LOCALE;
 }
 
@@ -74,7 +81,7 @@ function isValidLocale(locale: string | null): locale is SupportedLocale {
   if (!locale) {
     return false;
   }
-  return SUPPORTED_LOCALES.includes(locale as SupportedLocale);
+  return ([...SUPPORTED_LOCALES] as string[]).includes(locale);
 }
 
 /**
@@ -95,7 +102,7 @@ export function getCurrentLocale(): SupportedLocale {
   }
 
   // 3. 使用浏览器默认语言
-  return getBrowserLocale() as SupportedLocale;
+  return getBrowserLocale();
 }
 
 /**
@@ -115,9 +122,7 @@ export function setLocaleToStorage(locale: SupportedLocale): void {
 /**
  * 根据语言获取图标库路径
  */
-export function getIconFontPath(locale: SupportedLocale): string {
-  if (locale === 'ar-SA') {
-    return withPublicPath('/font/ar-SA.js');
-  }
-  return withPublicPath('/font/default.js');
+export function getIconFontPath(/* locale: SupportedLocale */): string {
+	// 如果后续需要支持 RTL 语言（如阿拉伯语），可在此扩展
+	return withPublicPath("/font/default.js");
 }