generator-mico-cli 0.2.29 → 0.2.30

package/generators/micro-react/templates/packages/shared/timezone/index.ts

@@ -0,0 +1,228 @@
+/**
+ * 时区工具
+ *
+ * 设计：
+ * - 时区**读写**（如 localStorage 存储）由消费方（主应用）负责
+ * - 本模块通过 `configureTimezone({ getTimezone })` 注入器拿到「当前 IANA 时区」
+ * - 包内业务函数（解析、格式化、范围）统一调用注入函数，避免与具体存储耦合
+ *
+ * 外部依赖：dayjs + utc/timezone/customParseFormat 插件，需消费方在入口预先调用
+ *   dayjs.extend(utc); dayjs.extend(timezone); dayjs.extend(customParseFormat);
+ */
+
+import dayjs, { type Dayjs } from 'dayjs';
+
+// ==================== 常量与类型 ====================
+
+/**
+ * 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;
+
+/**
+ * 地理上 24 个时区，但实际上有约 38 个不同的偏移时区，行政上则有上百个不同的时区规则地区。
+ * 24 个理论时区基于经度划分，每 15° 一时区，整数小时 UTC 偏移。
+ * 大部分时区可能有多个可用的城市/地区标识，此处仅使用一个常用标识。
+ */
+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',
+};
+
+/** 默认 IANA 时区，所有注入未就绪 / 未匹配时的兜底 */
+const DEFAULT_IANA = TIMEZONE_HASH[TIMEZONE['UTC+8']];
+
+// ==================== 纯转换函数 ====================
+
+/**
+ * 将 UTC offset 数字转换为 UTC+N 格式的时区字符串
+ * @example utcOffsetToTimezone(8)  => 'UTC+8'
+ * @example utcOffsetToTimezone(-5) => 'UTC-5'
+ */
+export const utcOffsetToTimezone = (utcOffset: number): string => {
+  if (utcOffset >= 0) {
+    return `UTC+${utcOffset}`;
+  }
+  return `UTC${utcOffset}`;
+};
+
+/**
+ * 将 UTC 偏移量转换为 IANA 时区标识（带兜底）
+ * 回退顺序：TIMEZONE_HASH → dayjs.tz.guess() → Asia/Shanghai
+ */
+export const utcOffsetToTimeZoneStr = (utcOffset: number): string => {
+  const key = utcOffsetToTimezone(utcOffset) as TTimezone;
+  return TIMEZONE_HASH[key] ?? dayjs.tz?.guess?.() ?? DEFAULT_IANA;
+};
+
+// ==================== 注入器 ====================
+
+/**
+ * 时区注入函数：返回当前 IANA 时区标识（如 'Asia/Shanghai'）
+ * 由消费方在应用入口注入，通常代理到主应用的时区管理模块
+ */
+export type TimezoneGetter = () => string;
+
+let _getTimezone: TimezoneGetter | null = null;
+
+/**
+ * 注入时区获取器
+ *
+ * @example
+ * import { configureTimezone } from '<%= packageScope %>/shared/timezone';
+ * import { getTimezone } from '@/common/helpers';
+ *
+ * configureTimezone({ getTimezone });
+ */
+export function configureTimezone(options: { getTimezone: TimezoneGetter }): void {
+  _getTimezone = options.getTimezone;
+}
+
+/**
+ * 获取当前 IANA 时区
+ * - 已注入：调用注入器
+ * - 未注入：尝试 `dayjs.tz.guess()`，最终兜底到 'Asia/Shanghai'
+ *
+ * 包内所有格式化函数都通过此函数取时区，避免直接耦合 storage 实现
+ */
+export function getCurrentTimezoneIANA(): string {
+  if (_getTimezone) {
+    try {
+      const tz = _getTimezone();
+      if (tz) return tz;
+    } catch {
+      // 注入器异常时走兜底
+    }
+  }
+  return dayjs.tz?.guess?.() ?? DEFAULT_IANA;
+}
+
+// ==================== 时间解析与格式化 ====================
+
+const BUSINESS_TIME_PARSE_FORMAT = 'YYYY-MM-DD HH:mm:ss';
+const BUSINESS_MINUTE_PARSE_FORMAT = 'YYYY-MM-DD HH:mm';
+const BUSINESS_DATE_PARSE_FORMAT = 'YYYY-MM-DD';
+
+const getBusinessTimeParseFormat = (value: string): string => {
+  if (/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/.test(value)) {
+    return BUSINESS_TIME_PARSE_FORMAT;
+  }
+  if (/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/.test(value)) {
+    return BUSINESS_MINUTE_PARSE_FORMAT;
+  }
+  return BUSINESS_DATE_PARSE_FORMAT;
+};
+
+/**
+ * 按当前业务时区解析日期字符串，避免回退到浏览器本机时区
+ */
+export const parseDateInTimezone = (value: string): Dayjs => {
+  return dayjs.tz(value, getBusinessTimeParseFormat(value), getCurrentTimezoneIANA());
+};
+
+export type TShortcutDateRangeUnit = 'day' | 'week';
+
+/**
+ * 生成当前业务时区下的快捷日期范围
+ * - day: 当天开始与结束
+ * - week: 当周开始与结束
+ * - undefined: 当前时刻
+ */
+export const getShortcutDateRange = (
+  unit?: TShortcutDateRangeUnit,
+): [Dayjs, Dayjs] => {
+  const now = dayjs().tz(getCurrentTimezoneIANA());
+  if (!unit) {
+    return [now, now];
+  }
+  return [now.startOf(unit), now.endOf(unit)];
+};
+
+/**
+ * 格式化时间戳为用户时区的标准日期时间字符串
+ * @returns YYYY.MM.DD HH:mm:ss；非法输入原样返回
+ *
+ * @example
+ * formatTimestampToDateTime(1730721621000) // => '2025.11.04 16:20:21' (UTC+8)
+ */
+export const formatTimestampToDateTime = (timestamp: number): string | number => {
+  if (!Number.isFinite(timestamp)) {
+    return timestamp;
+  }
+  return dayjs.utc(timestamp).tz(getCurrentTimezoneIANA()).format('YYYY.MM.DD HH:mm:ss');
+};
+
+/**
+ * 格式化时间戳为指定时区的标准日期时间字符串（带时区后缀）
+ * @returns YYYY.MM.DD HH:mm:ss(UTC+n)；非法输入或未知时区原样返回
+ *
+ * @example
+ * formatTimestampToDateTimeWithTimezone(1730721621000, 'UTC+8') // => '2025.11.04 16:20:21(UTC+8)'
+ */
+export const formatTimestampToDateTimeWithTimezone = (
+  timestamp: number,
+  timezone: TTimezone,
+): string | number => {
+  if (!Number.isFinite(timestamp) || !TIMEZONE[timezone]) {
+    return timestamp;
+  }
+  return dayjs
+    .utc(timestamp)
+    .tz(TIMEZONE_HASH[timezone])
+    .format(`YYYY.MM.DD HH:mm:ss(${timezone})`);
+};

package/generators/micro-react/templates/packages/shared/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "esModuleInterop": true
+  },
+  "include": ["services", "timezone"]
+}

package/generators/micro-react/templates/scripts/apply-sentry-plugin.ts

@@ -16,6 +16,11 @@ export function applySentryPlugin({
   project = '<%= projectName %>',
 }: ApplySentryPluginOptions) {
   const version = require('../package.json').version;
+  const buildNumber = process.env.BUILD_NUMBER?.trim();
+  const releaseName =
+    buildNumber && buildNumber.length > 0
+      ? `${version}+${buildNumber}`
+      : version;
 
   // 使用 Legacy Upload 方式，自托管 Sentry 不支持 Debug ID / Artifact Bundle
   const { sentryWebpackPlugin } = require('@sentry/webpack-plugin');
@@ -29,7 +34,7 @@ export function applySentryPlugin({
           /** @see https://micoworld.feishu.cn/wiki/AmXQwmnEairvQ9k2m9KcgJNcndv#share-OupCdqeeUoESO4x6YKPcrs4nn3c */
           authToken: process.env.SENTRY_AUTH_TOKEN,
           release: {
-            name: version,
+            name: releaseName,
             uploadLegacySourcemaps: {
               paths: ['./dist'],
               urlPrefix: `~/<%= cdnPrefixPath %><%= projectName %>/${version}/${appName}`,

package/generators/micro-react/templates/turbo.json

@@ -1,6 +1,14 @@
 {
   "$schema": "https://turbo.build/schema.json",
-  "globalEnv": ["CDN_PUBLIC_PATH", "SENTRY_AUTH_TOKEN"],
+  "globalEnv": ["CDN_PUBLIC_PATH", "SENTRY_AUTH_TOKEN", "BRANCH_OR_TAG", "GIT_COMMIT", "VERSION"],
+  "globalPassThroughEnv": [
+    "VERSION",
+    "BUILD_NUMBER",
+    "GIT_COMMIT",
+    "BRANCH_OR_TAG",
+    "BUILD_TIME",
+    "GIT_BRANCH"
+  ],
   "tasks": {
     "build": {
       "dependsOn": ["^build"],

package/generators/subapp-react/templates/homepage/config/config.ts

@@ -76,6 +76,16 @@ const config: ReturnType<typeof defineConfig> = {
    */
   layout: false,
 
+  /**
+   * @name 国际化插件（与 layout 一致；intl 未命中 key 时读 src/locales）
+   * @doc https://umijs.org/docs/max/i18n
+   */
+  locale: {
+    default: 'zh-CN',
+    antd: false,
+    baseNavigator: false,
+  },
+
   /**
    * @name 其他配置
    */

package/generators/subapp-react/templates/homepage/docs/feature-/345/233/275/351/231/205/345/214/226.md

@@ -0,0 +1,124 @@
+# 国际化（common-intl 与 Umi 兜底）
+
+> 创建时间：2026-04-07
+
+## 功能概述
+
+子应用通过 **`<%= packageScope %>/common-intl`**（生产环境常与主应用 **externals 共享**）拉取中台文案；**未命中 key** 时回落到 **Umi `src/locales`**。可选在工程内配置 **独立 `initIntl`**（独立 tag / IndexedDB），与主应用默认实例隔离。语言与主应用对齐：qiankun 下优先主应用注入的 `locale`，否则与 layout 相同的 URL / `umi_locale` / 浏览器规则（见 `getSubappCurrentLocale`）。
+
+## 技术方案
+
+### 技术栈
+
+- Umi Max `locale` 插件 + `src/locales/zh-CN.ts`、`en-US.ts`
+- `<%= packageScope %>/common-intl`：`configureLocale`、`i18n`、`fetchMultilingualData`、`initIntl`（独立实例时）
+- 统一入口：`useSubappIntl`（合并逻辑对齐主应用 `useLayoutIntl`）
+
+### 核心实现
+
+1. **`app.tsx`**：最早调用 `configureLocale`，使包内 `getLocale`/`setLocale` 与 `getSubappCurrentLocale` 一致；导出 Umi 运行时 `locale.getLocale`；在 `render` 中按条件调用中台 `fetchMultilingualData`（默认 tag 与可选的独立 intl 实例并行）。
+2. **`useSubappIntl`**：若 `subappIntlConfig` 有效则优先 **独立实例** `i18n`；否则在未启用中台时仅用 Umi，启用时优先包内 **`i18n`**；与 `defaultMessage` 比较后决定是否采用 Umi 译文。
+3. **`subappIntlConfig.ts`**：默认返回 `undefined`；返回含 **`tag`、`app_name`** 的对象即启用独立 intl（见 `subappOwnIntl.ts` 内 `initIntl`）。
+
+## 文件清单
+
+### 新增 / 模块目录
+
+| 文件路径 | 说明 |
+| --- | --- |
+| `src/common/intl/subappIntlConfig.ts` | 独立 intl 配置入口 `getSubappIntlInitOptions()` |
+| `src/common/intl/subappOwnIntl.ts` | 条件 `initIntl`、独立 `fetchMultilingualData` |
+| `src/common/intl/useSubappIntl.ts` | 页面统一 Hook |
+| `src/common/intl/intlRuntime.ts` | `isCommonIntlEnabled`（`window.__MICO_CONFIG__.intl` / `commonIntl`） |
+| `src/common/intl/types.ts` | `IMicoConfigCommonIntl` |
+| `src/common/intl/index.ts` | 对外导出 |
+| `src/common/intl/localeMapping.ts` | Umi locale ↔ `ILang`（模板已存在） |
+| `src/common/intl/subappLocale.ts` | 当前 Umi 风格 locale（模板已存在） |
+| `src/locales/zh-CN.ts` | Umi 兜底文案 |
+| `src/locales/en-US.ts` | Umi 兜底文案 |
+
+### 修改
+
+| 文件路径 | 说明 |
+| --- | --- |
+| `config/config.ts` | 开启 `locale` 插件 |
+| `src/app.tsx` | `configureLocale`、`export const locale`、`render` 预拉取 |
+| `src/pages/index.tsx` | 国际化示例区（可选参考） |
+| `typings.d.ts` | `__MICO_CONFIG__.intl` / `commonIntl` 类型 |
+
+## API / 组件接口
+
+### `useSubappIntl`
+
+```typescript
+const {
+  formatMessage,       // 与 layout useLayoutIntl 相同签名
+  commonIntlEnabled,   // 是否启用中台（有效 tag + app_name）
+  locale,              // 当前 Umi 风格 locale 字符串
+  subappOwnIntl,       // 是否启用子应用独立 initIntl
+  subappOwnIntlTag,    // 独立 tag（未启用时为 undefined）
+} = useSubappIntl();
+```
+
+**参数说明**：无入参；`formatMessage` 第二参数为插值对象，与 `useIntl().formatMessage` 一致。
+
+### `getSubappIntlInitOptions`
+
+返回 `undefined` 表示使用包默认实例；返回 `ISubappIntlInitOptions` 时需至少包含 **`tag`**、**`app_name`**，可选 **`indexedDBParams`**（与 `packages/common-intl` README 一致）。
+
+## 使用示例
+
+```tsx
+import { useSubappIntl } from '@/common/intl';
+
+export default function Page() {
+  const { formatMessage, commonIntlEnabled, locale, subappOwnIntl, subappOwnIntlTag } =
+    useSubappIntl();
+
+  return (
+    <p>
+      {formatMessage(
+        { id: 'page.subapp.home.title', defaultMessage: '标题' },
+      )}
+    </p>
+  );
+}
+```
+
+独立 intl（节选，`subappIntlConfig.ts`）：
+
+```typescript
+export function getSubappIntlInitOptions() {
+  return {
+    tag: 'my_subapp_tag',
+    app_name: 'middle',
+    indexedDBParams: { dbName: 'my_subapp_i18n_db' },
+  };
+}
+```
+
+启用独立 tag 且生产仍使用 `externals` 指向主应用 `CommonIntl` 时，需评估与上游 **多实例 / 单例** 语义是否冲突，详见 **`generators/micro-react/templates/packages/common-intl/README.md`**「不同 tag」。
+
+## 设计决策
+
+| 决策点 | 选择 | 理由 |
+| --- | --- | --- |
+| 统一 Hook | `useSubappIntl` 对齐 `useLayoutIntl` | 与主应用行为一致，intl 与 Umi 兜底规则可维护 |
+| 独立 intl 配置 | 单一入口 `getSubappIntlInitOptions` | 默认关闭，按需开启，避免误初始化 |
+| 预拉取 | `render` 内并行 fetch 默认 tag + 独立实例 | 首屏前尽量拉齐中台数据，失败仍渲染 |
+
+## 已知限制与待改进
+
+- 独立 intl 与 **externals 共享同一 `common-intl` 运行时** 时的边界行为以 **上游包** 为准；若需完全隔离，可能需调整打包策略（见 common-intl README）。
+- `LOCALE_REQUEST_URL` 未配置时，行为依赖上游 `fetchMultilingualData` 实现。
+
+## 注意事项
+
+- 主应用通过 qiankun 注入的 **`locale`** 会参与 `getSubappCurrentLocale`；独立运行依赖本地存储与 URL。
+- 中台未配置时 **`commonIntlEnabled`** 为 `false`，页面仅走 Umi `locales`。
+
+## 相关文档
+
+- [packages/common-intl README](../../../../micro-react/templates/packages/common-intl/README.md)
+- [子应用国际化（CLI 仓库总览）](../../../../../docs/feat-subapp-国际化翻译.md)
+- [Layout 国际化](../../../../../docs/feat-layout-国际化翻译.md)

package/generators/subapp-react/templates/homepage/package.json

@@ -20,7 +20,8 @@
     "@umijs/max": "^4.4.8",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "<%= packageScope %>/common-intl": "workspace:*"
+    "<%= packageScope %>/common-intl": "workspace:*",
+    "<%= packageScope %>/shared": "workspace:*"
   },
   "devDependencies": {
     "@mico-platform/ui": "<%= micoUiVersion %>",

package/generators/subapp-react/templates/homepage/src/app.tsx

@@ -7,18 +7,113 @@
  * 自定义函数请放在 @/common/mainApp.ts 中
  *
  * 国际化使用：
- * 子应用默认共享主应用的 intl，直接导入即可：
+ * 子应用默认共享主应用的 intl（同 tag），直接导入即可：
  *   import { intl } from '<%= packageScope %>/common-intl';
  *   intl.common_hello();
- * 如需独立 tag，直接依赖 @common-web/common-intl 自行调用 initIntl，
- * 参考 packages/common-intl/README.md
+ * 独立 intl：在 `src/common/intl/subappIntlConfig.ts` 填写 `getSubappIntlInitOptions()`；
+ * 页面统一用 `useSubappIntl`（intl 优先，未命中走子应用 Umi locales）。
+ *
+ * common-intl 的 getLocale/setLocale 与 Umi locale / 主应用 props.locale 对齐：入口调用 configureLocale（见下）。
  */
 
-import React from 'react';
+import {
+  configureLocale,
+  fetchMultilingualData,
+  type ILang,
+} from '<%= packageScope %>/common-intl';
+import { Message } from '@mico-platform/ui';
+import type { ReactNode } from 'react';
 import { history } from '@umijs/max';
 import { SentryErrorBoundary } from '@common-web/sentry';
 import { appLogger } from './common/logger';
+import { configureRequest } from '<%= packageScope %>/shared/services';
 import { type IMicroAppProps, setMainAppProps } from './common/mainApp';
+import { request } from './common/request';
+import { setLocaleToStorage } from './common/locale';
+import {
+  getSubappOwnFetchMultilingualData,
+  ilangToUmiLocale,
+  isCommonIntlEnabled,
+  umiLocaleToILang,
+} from './common/intl';
+import { getSubappCurrentLocale } from './common/intl/subappLocale';
+
+// 子应用：将本地 request（自动桥接主应用 / 独立 umi）注入 shared 包，供共享服务层（getRequest）使用
+// 注意：模块顶层注入，request 函数引用稳定；运行期由 request 内部根据是否处于 qiankun 选用 main / umi
+configureRequest(request as <T = unknown>(url: string, options?: Record<string, unknown>) => Promise<T>);
+
+// 子应用：common-intl initIntl 与 Umi `umi_locale` / 主应用注入 locale 对齐（与 layout app.tsx 同理）
+configureLocale({
+  getLocale: () => umiLocaleToILang(getSubappCurrentLocale()),
+  setLocale: (lang: ILang) => {
+    setLocaleToStorage(ilangToUmiLocale(lang));
+  },
+});
+
+/**
+ * @name 运行时国际化（Umi locale 插件）
+ * @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 getSubappCurrentLocale();
+  },
+};
+
+/**
+ * 中台文案预加载：默认 tag 与（可选）子应用独立 intl tag 并行拉取，失败仍渲染。
+ * @see generators/micro-react/templates/apps/layout/src/app.tsx render
+ */
+export function render(oldRender: () => void): void {
+  const ownFetch = getSubappOwnFetchMultilingualData();
+  const tasks: Promise<unknown>[] = [];
+
+  if (isCommonIntlEnabled()) {
+    tasks.push(
+      fetchMultilingualData({
+        requestInstance: request as (
+          url: string,
+          options?: unknown,
+        ) => Promise<unknown>,
+        messageInstance: {
+          error: Message.error,
+          warning: Message.warning,
+        },
+        lang: umiLocaleToILang(getSubappCurrentLocale()) as ILang,
+        localeRequestUrl: process.env.LOCALE_REQUEST_URL,
+      }),
+    );
+  }
+
+  if (ownFetch) {
+    tasks.push(
+      ownFetch({
+        requestInstance: request as (
+          url: string,
+          options?: unknown,
+        ) => Promise<unknown>,
+        messageInstance: {
+          error: Message.error,
+          warning: Message.warning,
+        },
+        lang: umiLocaleToILang(getSubappCurrentLocale()) as ILang,
+        localeRequestUrl: process.env.LOCALE_REQUEST_URL,
+      }),
+    );
+  }
+
+  if (tasks.length === 0) {
+    oldRender();
+    return;
+  }
+
+  Promise.all(tasks)
+    .then(() => oldRender())
+    .catch((error: Error) => {
+      console.error('获取多语言文案失败', error);
+      oldRender();
+    });
+}
 
 /** 与 layout parser.findRouteByPath 一致：根路径 "/" 保持不变 */
 function stripTrailingSlash(path: string): string {
@@ -110,6 +205,6 @@ export async function getInitialState() {
   };
 }
 
-export function rootContainer(container: React.ReactNode) {
+export function rootContainer(container: ReactNode) {
   return <SentryErrorBoundary>{container}</SentryErrorBoundary>;
 }

package/generators/subapp-react/templates/homepage/src/common/intl/index.ts

@@ -0,0 +1,15 @@
+export { isCommonIntlEnabled, getCommonIntlConfig } from './intlRuntime';
+export type { IMicoConfigCommonIntl } from './types';
+export {
+  getSubappIntlInitOptions,
+  type ISubappIntlInitOptions,
+} from './subappIntlConfig';
+export {
+  getSubappOwnFetchMultilingualData,
+  getSubappOwnI18n,
+  getSubappOwnIntlTag,
+  isSubappOwnIntlEnabled,
+} from './subappOwnIntl';
+export { useSubappIntl } from './useSubappIntl';
+export { ilangToUmiLocale, umiLocaleToILang } from './localeMapping';
+export { getSubappCurrentLocale } from './subappLocale';

package/generators/subapp-react/templates/homepage/src/common/intl/intlRuntime.ts

@@ -0,0 +1,14 @@
+import type { IMicoConfigCommonIntl } from './types';
+
+/**
+ * 是否启用多语言中台拉取：以 __MICO_CONFIG__.intl 或 commonIntl 含有效 tag、app_name 为准
+ */
+export function isCommonIntlEnabled(): boolean {
+  const c = getCommonIntlConfig();
+  return !!(c?.tag && c?.app_name);
+}
+
+export function getCommonIntlConfig(): IMicoConfigCommonIntl | undefined {
+  const w = window.__MICO_CONFIG__;
+  return w?.intl ?? w?.commonIntl;
+}

package/generators/subapp-react/templates/homepage/src/common/intl/localeMapping.ts

@@ -0,0 +1,24 @@
+import { LANG, type ILang } from '<%= packageScope %>/common-intl';
+import type { SupportedLocale } from '@/common/locale';
+import { LOCALE } from '@/common/locale';
+
+/** 与 packages/common-intl/src/umiLocaleBridge.ts、layout localeMapping 保持一致 */
+const UMI_TO_ILANG: Record<SupportedLocale, ILang> = {
+  [LOCALE.ZH_CN]: LANG.ZH_CN,
+  [LOCALE.EN_US]: LANG.EN,
+};
+
+export function umiLocaleToILang(locale: SupportedLocale): ILang {
+  return UMI_TO_ILANG[locale] ?? LANG.EN;
+}
+
+const ILANG_TO_UMI: Partial<Record<ILang, SupportedLocale>> = {
+  [LANG.ZH_CN]: LOCALE.ZH_CN,
+  [LANG.EN]: LOCALE.EN_US,
+  [LANG.AR]: LOCALE.EN_US,
+  [LANG.TR]: LOCALE.EN_US,
+};
+
+export function ilangToUmiLocale(lang: ILang): SupportedLocale {
+  return ILANG_TO_UMI[lang] ?? LOCALE.EN_US;
+}

package/generators/subapp-react/templates/homepage/src/common/intl/subappIntlConfig.ts

@@ -0,0 +1,28 @@
+/**
+ * 子应用独立 intl（与主应用不同 tag / 独立 IndexedDB）时，在此返回 initIntl 参数。
+ * 默认 `undefined`：使用 <%= packageScope %>/common-intl 包内默认实例（与主应用 externals 共享）。
+ *
+ * 启用方式：返回含有效 `tag`、`app_name` 的对象（与 packages/common-intl README 一致）。
+ */
+export interface ISubappIntlInitOptions {
+  tag: string;
+  app_name: string;
+  indexedDBParams?: {
+    dbName?: string;
+    dbVersion?: number;
+    storeName?: string;
+    keyPathKey?: string;
+  };
+}
+
+export function getSubappIntlInitOptions():
+  | ISubappIntlInitOptions
+  | undefined {
+  return undefined;
+  // 如果需要启用独立 intl，请取消注释并修改 tag 和 app_name
+  // return {
+  //   tag: 'cs_fe_mobile',
+  //   app_name: 'middle',
+  //   indexedDBParams: { dbName: 'mico_cs_mobile_i18n_db' },
+  // };
+}

package/generators/subapp-react/templates/homepage/src/common/intl/subappLocale.ts

@@ -0,0 +1,18 @@
+import { getCurrentLocale, type SupportedLocale, SUPPORTED_LOCALES } from '@/common/locale';
+import { getMainAppProps } from '@/common/mainApp';
+
+function isSupportedLocale(value: string | undefined): value is SupportedLocale {
+  return !!value && (SUPPORTED_LOCALES as readonly string[]).includes(value);
+}
+
+/**
+ * 子应用当前 Umi 风格 locale：qiankun 下优先主应用 MicroAppLoader 注入的 `locale`，
+ * 否则与主应用相同规则（URL / umi_locale / 浏览器）。
+ */
+export function getSubappCurrentLocale(): SupportedLocale {
+  const fromMain = getMainAppProps()?.locale;
+  if (isSupportedLocale(fromMain)) {
+    return fromMain;
+  }
+  return getCurrentLocale();
+}