generator-mico-cli 0.2.12 → 0.2.14

package/README.md

@@ -53,7 +53,7 @@ mico create micro-react
 
 生成的项目包含：
 - 主应用 (layout) - qiankun master
-- 共享样式包 (shared-styles)
+- @mico-platform/ui、@mico-platform/theme
 - Turborepo + pnpm Workspace
 - Husky + Commitlint
 

package/generators/micro-react/index.js

@@ -9,7 +9,8 @@ const {
   collectFiles,
   transformDestPath,
   isTemplateFile,
-  setupErrorHandlers
+  getLatestNpmVersion,
+  setupErrorHandlers,
 } = require('../../lib/utils');
 
 const IGNORE_LIST = require('./ignore-list.json');
@@ -28,7 +29,9 @@ module.exports = class extends Generator {
       console.error('❌ Error: Current directory is already a monorepo.');
       console.error('');
       console.error('   A pnpm-workspace.yaml file already exists.');
-      console.error('   Please run this command in an empty directory or specify a new project name.');
+      console.error(
+        '   Please run this command in an empty directory or specify a new project name.',
+      );
       console.error('');
       console.error('   Usage:');
       console.error('     mkdir my-project && cd my-project');
@@ -51,7 +54,7 @@ module.exports = class extends Generator {
             const value = toKebab(input);
             if (!value) return 'Project name is required';
             return true;
-          }
+          },
         },
         {
           type: 'input',
@@ -60,16 +63,17 @@ module.exports = class extends Generator {
           default: (answers) => `@${toKebab(answers.projectName)}`,
           validate: (input) => {
             if (!input) return 'Package scope is required';
-            if (!input.startsWith('@')) return 'Package scope must start with @';
+            if (!input.startsWith('@'))
+              return 'Package scope must start with @';
             return true;
-          }
+          },
         },
         {
           type: 'input',
           name: 'author',
           message: 'Author',
-          default: 'Your Name <email@example.com>'
-        }
+          default: 'Your Name <email@example.com>',
+        },
       ]);
 
       this.projectName = toKebab(this.answers.projectName);
@@ -97,14 +101,34 @@ module.exports = class extends Generator {
         process.exit(1);
       }
 
+      // 在 mico_cli 根目录执行 npm view，以使用该目录 .npmrc 中的 Nexus 认证
+      const cliRoot = path.resolve(__dirname, '../..');
+      const micoUiVer = getLatestNpmVersion(
+        '@mico-platform/ui',
+        '1.0.0',
+        8000,
+        cliRoot,
+      );
+      const themeVer = getLatestNpmVersion(
+        '@mico-platform/theme',
+        '1.0.0',
+        8000,
+        cliRoot,
+      );
       const templateData = {
         projectName: this.projectName,
         ProjectName: this.ProjectName,
         packageScope: this.packageScope,
-        author: this.author
+        author: this.author,
+        micoUiVersion: `^${micoUiVer}`,
+        themeVersion: `^${themeVer}`,
       };
 
-      const files = collectFiles(this.templateDir, this.templateDir, IGNORE_LIST);
+      const files = collectFiles(
+        this.templateDir,
+        this.templateDir,
+        IGNORE_LIST,
+      );
 
       if (files.length === 0) {
         console.error('');
@@ -143,7 +167,7 @@ module.exports = class extends Generator {
     this.log('');
     this.log('📦 正在安装依赖...');
     this.spawnCommandSync('pnpm', ['install'], {
-      cwd: this.destDir
+      cwd: this.destDir,
     });
   }
 

package/generators/micro-react/templates/.commitlintrc.js

@@ -2,5 +2,6 @@ module.exports = {
   extends: ['@commitlint/config-conventional'],
   rules: {
     'header-max-length': [0, 'always', 10000],
+    'body-max-line-length': [0, 'always', Infinity],
   },
 };

package/generators/micro-react/templates/.cursor/rules/coding-conventions.mdc

@@ -168,7 +168,7 @@ import React, { useState, useEffect } from 'react';
 import { useLocation } from '@umijs/max';
 
 // 2. 第三方库
-import { Button, Modal } from '@arco-design/web-react';
+import { Button, Modal } from '@mico-platform/ui';
 import dayjs from 'dayjs';
 
 // 3. 项目内部模块（使用 @ 别名）

package/generators/micro-react/templates/.cursor/rules/development-guide.mdc

@@ -289,6 +289,6 @@ cdn-portal[-env].micoplatform.com/<%= projectName %>/{version}/dist/{app}/
 ## 相关链接
 
 - [UmiJS 文档](https://umijs.org/)
-- [Arco Design](https://arco.design/)
+- [@mico-platform/ui](hhttps://mico-ui.micoportal-test.com/react/docs/start)
 - [qiankun 文档](https://qiankun.umijs.org/)
 - [Turborepo 文档](https://turbo.build/repo)

package/generators/micro-react/templates/.cursor/rules/layout-app.mdc

@@ -52,10 +52,7 @@ apps/layout/
     ├── services/              # API 服务
     ├── models/                # Umi Model
     ├── locales/               # 国际化
-    └── styles/                # 主题样式
-        ├── themes/            # 主题变量
-        ├── variables.less     # Less 变量
-        └── arco-override.less # Arco 覆盖
+    └── styles/                # 主题样式（变量来自 @mico-platform/theme）
 ```
 
 ## 核心模块
@@ -206,7 +203,7 @@ const { isAuthenticated, user, logout } = useAuth();
 ### 主题变量引入
 ```less
 // 在组件样式中使用
-@import '<%= packageScope %>/shared-styles/variables-only';
+@import '@mico-platform/theme/variables';
 
 .my-component {
   background: @color-fill-1;

package/generators/micro-react/templates/.cursor/rules/project-overview.mdc

@@ -16,7 +16,7 @@ alwaysApply: true
 | **Monorepo** | Turborepo + pnpm Workspace |
 | **前端框架** | UmiJS 4 (@umijs/max)、React 18、TypeScript |
 | **微前端** | qiankun |
-| **UI 组件** | Arco Design Web |
+| **UI 组件** | @mico-platform/ui |
 | **样式方案** | Tailwind CSS + Less + CSS Variables |
 | **代码规范** | ESLint、Stylelint、Husky、Commitlint |
 
@@ -74,7 +74,7 @@ alwaysApply: true
 ### 3. 主题系统
 - 支持亮色/暗黑主题切换
 - 使用 CSS Variables 实现运行时动态切换
-- `arco-theme` 控制 Arco Design 组件
+- `arco-theme` 控制 @mico-platform/ui 组件
 - `data-theme` 控制自定义样式
 
 ## 常用命令

package/generators/micro-react/templates/.cursor/rules/theme-system.mdc

@@ -18,7 +18,7 @@ globs: ["**/themes/**", "**/useTheme**", "**/*.less"]
 │  └─────────────────────────────────────────────────────────┘│
 │                           ↓                                  │
 │  ┌─────────────────────────────────────────────────────────┐│
-│  │  body[arco-theme="dark"]  → Arco Design 组件            ││
+│  │  body[arco-theme="dark"]  → @mico-platform/ui 组件       ││
 │  │  body[data-theme="dark"]  → 自定义 CSS 变量             ││
 │  └─────────────────────────────────────────────────────────┘│
 └─────────────────────────────────────────────────────────────┘
@@ -28,12 +28,10 @@ globs: ["**/themes/**", "**/useTheme**", "**/*.less"]
 
 | 文件 | 说明 |
 |------|------|
-| `packages/shared-styles/` | **共享样式包（主应用和子应用共用）** |
-| `packages/shared-styles/index.less` | 入口文件，导入全部样式 |
-| `packages/shared-styles/variables.less` | Less 变量定义 |
-| `packages/shared-styles/themes/normal/custom-var.less` | 亮色主题变量 |
-| `packages/shared-styles/themes/dark/custom-var.less` | 暗黑主题变量 |
-| `packages/shared-styles/arco-override.less` | Arco Design 变量覆盖 |
+| `@mico-platform/theme` | **主题包（主应用和子应用共用）** |
+| `@mico-platform/theme` | 主入口，CSS 变量 + Less 变量 |
+| `@mico-platform/theme/variables` | 仅 Less 变量（子应用用） |
+| `@mico-platform/theme/theme-inject` | 子应用独立运行时注入主题 |
 | `apps/layout/src/hooks/useTheme.ts` | 主题管理 Hook |
 | `apps/layout/src/common/theme.ts` | 主题初始化 |
 
@@ -54,7 +52,7 @@ interface UseThemeReturn {
 ### 使用示例
 ```tsx
 import { useTheme } from '@/hooks/useTheme';
-import { IconSun, IconMoon } from '@arco-design/web-react/icon';
+import { IconSun, IconMoon } from '@mico-platform/ui/ic';
 
 const ThemeToggle: React.FC = () => {
   const { isDark, toggleTheme } = useTheme();
@@ -124,7 +122,7 @@ body[data-theme='dark'] {
 
 ## 主要颜色变量
 
-> 完整列表见：[shared-styles 包](packages/shared-styles/README.md#主要变量)
+> 完整列表见：@mico-platform/theme 包文档
 
 | 分类 | 变量 | 说明 |
 |------|------|------|
@@ -139,7 +137,7 @@ body[data-theme='dark'] {
 ```typescript
 const applyTheme = (theme: Theme) => {
   if (theme === 'dark') {
-    // Arco Design 暗黑模式
+    // @mico-platform/ui 暗黑模式（arco-theme）
     document.body.setAttribute('arco-theme', 'dark');
     // 自定义 CSS 变量
     document.body.setAttribute('data-theme', 'dark');
@@ -178,7 +176,7 @@ const getStoredTheme = (): Theme => {
 
 ```less
 // global.less - 仅导入 Less 变量（不打包 CSS 变量）
-@import '<%= packageScope %>/shared-styles/variables-only';
+@import '@mico-platform/theme/variables';
 ```
 
 ```typescript
@@ -203,4 +201,4 @@ if (process.env.NODE_ENV === 'development') {
 3. **优先 Less 变量**: 使用 Less 变量有编辑器提示和类型检查
 4. **避免硬编码颜色**: 所有颜色都应使用主题变量
 5. **系统跟随**: 未手动设置主题时会跟随系统偏好变化
-6. **子应用共享**: 子应用使用 `<%= packageScope %>/shared-styles` 包复用主题
+6. **子应用共享**: 子应用使用 `@mico-platform/theme` 包复用主题

package/generators/micro-react/templates/AGENTS.md

@@ -4,7 +4,7 @@
 
 - `apps/` 存放业务应用。当前应用：`apps/layout/`（主应用）、`apps/subapp/`（子应用）。
 - 应用源码位于 `apps/<app>/src/`，包含 `pages/`、`layouts/`、`components/`、`common/`、`hooks/`、`styles/` 等目录。
-- `packages/` 存放共享包，如 `packages/shared-styles/`（共享样式）。
+- `packages/` 可存放其他共享包。
 - `scripts/` 包含仓库工具脚本（如 `scripts/dev.js`、`scripts/collect-dist.js`）。
 - `docs/` 存放工作流文档；`CICD/` 包含部署相关资源。
 - `dist/` 是生成的构建产物（收集于仓库根目录）。
@@ -14,7 +14,7 @@
 - **Monorepo**：Turborepo + pnpm Workspace
 - **前端框架**：UmiJS 4 / @umijs/max、React 18、TypeScript
 - **微前端**：qiankun
-- **UI 组件**：Arco Design Web
+- **UI 组件**：@mico-platform/ui
 - **样式方案**：Tailwind CSS + Less
 - **代码规范**：ESLint、Stylelint、Husky、Commitlint
 

package/generators/micro-react/templates/CICD/before_build.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+
+# 计算当前构建分支的 BASE_REF，并为 Turbo 增量构建准备 TURBO_FILTER
+# 该脚本会被其他脚本 source 调用，不要在这里直接 exit 1
+
+set -e
+
+# 获取项目根目录（如果调用方已设置 PROJECT_ROOT，则使用；否则使用当前工作目录）
+PROJECT_ROOT="${PROJECT_ROOT:-$(pwd)}"
+
+# 获取当前构建的分支（去掉 origin/ 前缀，用于比较）
+# 优先使用环境变量 CURRENT_BRANCH（Jenkins 传入，格式可能是 origin/main、origin/feat/xxx）
+# 其次使用 BRANCH_OR_TAG，最后从 git 获取
+if [ -n "${CURRENT_BRANCH}" ]; then
+  CURRENT_BRANCH_NAME="${CURRENT_BRANCH#origin/}"  # 去掉 origin/ 前缀
+elif [ -n "${BRANCH_OR_TAG}" ]; then
+  CURRENT_BRANCH_NAME="${BRANCH_OR_TAG#origin/}"  # 去掉 origin/ 前缀
+else
+  CURRENT_BRANCH_NAME="$(git rev-parse --abbrev-ref HEAD)"
+fi
+
+echo "[before_build] Current branch (without origin/): ${CURRENT_BRANCH_NAME}"
+
+# 比较当前分支和上次成功构建的分支是否一致
+# LAST_SUCCESS_BRANCH 由 Jenkins 在构建时设置（从上次构建的结果中获取，格式可能是 origin/main、origin/feat/xxx）
+if [ -n "${LAST_SUCCESS_BRANCH}" ]; then
+  # 去掉 LAST_SUCCESS_BRANCH 的 origin/ 前缀，用于比较
+  LAST_SUCCESS_BRANCH_NAME="${LAST_SUCCESS_BRANCH#origin/}"
+  echo "[before_build] Last success branch (without origin/): ${LAST_SUCCESS_BRANCH_NAME}"
+  
+  if [ "${CURRENT_BRANCH_NAME}" != "${LAST_SUCCESS_BRANCH_NAME}" ]; then
+    # 分支不一致，需要全量构建
+    echo "[before_build] Branch changed: ${LAST_SUCCESS_BRANCH_NAME} -> ${CURRENT_BRANCH_NAME}, will perform full build (no filter)"
+    unset TURBO_FILTER
+  else
+    # 分支一致，尝试使用 PREVIOUS_COMMIT 进行增量构建
+    echo "[before_build] Branch unchanged: ${CURRENT_BRANCH_NAME}, checking PREVIOUS_COMMIT for incremental build"
+    if [ -n "${PREVIOUS_COMMIT}" ]; then
+      # 验证 commit 是否存在且有效
+      if git rev-parse --verify "${PREVIOUS_COMMIT}" >/dev/null 2>&1; then
+        # 关键检查：验证 PREVIOUS_COMMIT 是否是当前 HEAD 的祖先
+        # 这可以避免以下问题：
+        # 1. Rebase/Force push：PREVIOUS_COMMIT 不再是当前分支的祖先
+        # 2. Tag 被其他分支更新：PREVIOUS_COMMIT 不是当前分支的祖先
+        CURRENT_HEAD="$(git rev-parse HEAD)"
+        if git merge-base --is-ancestor "${PREVIOUS_COMMIT}" "${CURRENT_HEAD}" 2>/dev/null; then
+          # PREVIOUS_COMMIT 是当前 HEAD 的祖先，可以安全使用
+          BASE_REF="${PREVIOUS_COMMIT}"
+          echo "[before_build] Use PREVIOUS_COMMIT as BASE_REF: ${BASE_REF} (ancestor check passed)"
+          # 为 turbo --filter 准备语法形如 ...[<BASE_REF>]
+          TURBO_FILTER="...[${BASE_REF}]"
+          export TURBO_FILTER
+          echo "[before_build] TURBO_FILTER=${TURBO_FILTER} (incremental build)"
+        else
+          # PREVIOUS_COMMIT 不是当前 HEAD 的祖先，降级为全量构建
+          echo "[before_build] Warning: PREVIOUS_COMMIT=${PREVIOUS_COMMIT} is not an ancestor of HEAD=${CURRENT_HEAD}"
+          echo "[before_build] Possible reasons: rebase/force-push, tag updated by another branch, or shallow clone issue"
+          echo "[before_build] Falling back to full build (no filter)"
+          unset TURBO_FILTER
+        fi
+      else
+        echo "[before_build] Warning: PREVIOUS_COMMIT=${PREVIOUS_COMMIT} is not a valid commit, will perform full build"
+        unset TURBO_FILTER
+      fi
+    else
+      # PREVIOUS_COMMIT 未设置，进行全量构建
+      echo "[before_build] PREVIOUS_COMMIT not set, will perform full build (no filter)"
+      unset TURBO_FILTER
+    fi
+  fi
+else
+  # LAST_SUCCESS_BRANCH 未设置，说明是第一次构建或 Jenkins 未配置该环境变量
+  echo "[before_build] LAST_SUCCESS_BRANCH not set, will perform full build (no filter)"
+  # 不设置 TURBO_FILTER，这样 package.json 中的 ${TURBO_FILTER:+--filter=${TURBO_FILTER}} 不会生效
+  unset TURBO_FILTER
+fi

package/generators/micro-react/templates/CICD/start_dev.sh

@@ -20,11 +20,24 @@ echo "项目版本: $VERSION"
 # 切换到项目根目录，确保后续命令在根目录下运行
 cd "$PROJECT_ROOT"
 
+# 导出 PROJECT_ROOT 供 before_build.sh 使用
+export PROJECT_ROOT
+
+# 在执行构建前，计算 BASE_REF / TURBO_FILTER 等增量构建信息
+if [ -f "$PROJECT_ROOT/CICD/before_build.sh" ]; then
+  # shellcheck disable=SC1090
+  source "$PROJECT_ROOT/CICD/before_build.sh"
+fi
+
 # 设置子应用的 CDN 公共路径（开发环境）
 export CDN_PUBLIC_PATH="https://cdn-portal-dev.micoplatform.com/<%= projectName %>/${VERSION}/"
 echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"
 
 pnpm run build:development
 
-echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+# 只有在 CI 环境时才写入版本号文件（覆盖写入）
+if [ "${CI}" = "true" ]; then
+  echo "VERSION=$VERSION" > .env_x_portal-web
+fi
+
 

package/generators/micro-react/templates/CICD/start_prod.sh

@@ -20,11 +20,23 @@ echo "项目版本: $VERSION"
 # 切换到项目根目录，确保后续命令在根目录下运行
 cd "$PROJECT_ROOT"
 
+# 导出 PROJECT_ROOT 供 before_build.sh 使用
+export PROJECT_ROOT
+
+# 在执行构建前，计算 BASE_REF / TURBO_FILTER 等增量构建信息（用于增量构建）
+if [ -f "$PROJECT_ROOT/CICD/before_build.sh" ]; then
+  # shellcheck disable=SC1090
+  source "$PROJECT_ROOT/CICD/before_build.sh"
+fi
+
 # 设置子应用的 CDN 公共路径（生产环境）
 export CDN_PUBLIC_PATH="https://cdn-portal.micoplatform.com/<%= projectName %>/${VERSION}/"
 echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"
 
 pnpm run build:production
 
-echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+# 只有在 CI 环境时才写入版本号文件（覆盖写入）
+if [ "${CI}" = "true" ]; then
+  echo "VERSION=$VERSION" > .env_x_portal-web
+fi
 

package/generators/micro-react/templates/CICD/start_test.sh

@@ -20,11 +20,24 @@ echo "项目版本: $VERSION"
 # 切换到项目根目录，确保后续命令在根目录下运行
 cd "$PROJECT_ROOT"
 
+# 导出 PROJECT_ROOT 供 before_build.sh 使用
+export PROJECT_ROOT
+
+# 在执行构建前，计算 BASE_REF / TURBO_FILTER 等增量构建信息
+if [ -f "$PROJECT_ROOT/CICD/before_build.sh" ]; then
+  # shellcheck disable=SC1090
+  source "$PROJECT_ROOT/CICD/before_build.sh"
+fi
+
+
 # 设置子应用的 CDN 公共路径（测试环境）
 export CDN_PUBLIC_PATH="https://cdn-portal-test.micoplatform.com/<%= projectName %>/${VERSION}/"
 echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"
 
 pnpm run build:testing
 
-echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+# 只有在 CI 环境时才写入版本号文件（覆盖写入）
+if [ "${CI}" = "true" ]; then
+  echo "VERSION=$VERSION" > .env_x_portal-web
+fi
 

package/generators/micro-react/templates/CLAUDE.md

@@ -11,7 +11,7 @@
 - **Monorepo**: Turborepo + pnpm Workspace
 - **前端框架**: UmiJS 4 (@umijs/max)、React 18、TypeScript
 - **微前端**: qiankun
-- **UI 组件**: Arco Design Web
+- **UI 组件**: @mico-platform/ui
 - **样式方案**: Tailwind CSS + Less
 - **代码规范**: ESLint、Stylelint、Husky、Commitlint
 
@@ -62,7 +62,6 @@ apps/                         # Workspace 应用目录（微前端子应用）
 │   │   └── styles/          # 主题变量与样式覆盖
 │   └── config/              # Umi 配置
 packages/                     # 共享包
-├── shared-styles/           # 共享样式
 scripts/                      # 构建与开发脚本
 CICD/                         # 部署资源
 ```

package/generators/micro-react/templates/README.md

@@ -7,7 +7,7 @@
 - **Monorepo**：Turborepo + pnpm Workspace
 - **前端框架**：UmiJS 4 / @umijs/max
 - **微前端**：qiankun
-- **UI 组件**：Arco Design
+- **UI 组件**：@mico-platform/ui
 - **样式方案**：Tailwind CSS + Less
 - **代码规范**：ESLint、Stylelint、lint-staged、Husky、Commitlint
 
@@ -33,6 +33,7 @@ pnpm install
 | `pnpm build:production` | 构建所有应用（生产环境） |
 | `pnpm lint` | 运行 ESLint + Turborepo lint 校验 |
 | `pnpm lint:fix` | 自动修复 lint 问题 |
+| `pnpm create:umi-app` | 基于 Umi 模板创建新子应用 |
 
 > **提示**：也可以使用 `pnpm -C apps/<app-name> dev` 直接启动指定应用，例如 `pnpm -C apps/layout dev`。
 
@@ -55,7 +56,6 @@ mico create subapp-react
 ├── apps/                     # 业务应用目录
 │   └── layout/               # 主应用（qiankun master）
 ├── packages/                 # 共享包目录
-│   └── shared-styles/        # 共享样式
 ├── scripts/                  # 构建与开发脚本
 │   ├── dev.js                # 交互式启动脚本
 │   ├── collect-dist.js       # 构建产物收集

package/generators/micro-react/templates/_npmrc

@@ -1,2 +1,5 @@
 registry=https://registry.npmjs.com/
+@mico-platform:registry=https://nexus-vywrajy.micoworld.net/repository/mico-base-common/
+package-lock=false
+//nexus-vywrajy.micoworld.net/repository/mico-base-common/:_auth=bWljby1ucG06SDR4WUROazdad1NeczltblJMTw==
 

package/generators/micro-react/templates/apps/layout/config/config.dev.ts

@@ -20,11 +20,26 @@ const config: ReturnType<typeof defineConfig> = {
           appName: '<%= projectName %>',
           apiBaseUrl: '',
           defaultPath: '',
+          // 免认证路由（跳过 SSO 登录），支持 /* 前缀匹配
+          // noAuthRouteList: ['/*'],
+          // 免权限校验路由（跳过菜单权限检查）
+          // noPermissionRouteList: ['/task-query/*'],
+          // 不显示布局的路由（全屏页面）
+          // noLayoutRouteList: ['/task-query/*'],
+          // 关闭权限控制（调试用）
+          disableAuth: false,
         };
       `,
     },
   ],
 
+  /**
+   * @name Monorepo 重定向
+   * @description 开发时将 workspace 包指向源码，支持热更新
+   * @doc https://umijs.org/docs/api/config#monoreporedirect
+   */
+  monorepoRedirect: {},
+
   proxy: {
     '/api': {
       // 要代理的地址

package/generators/micro-react/templates/apps/layout/config/config.ts

@@ -36,7 +36,7 @@ const config: ReturnType<typeof defineConfig> = {
 
   /**
    * @name Less 配置
-   * @description 全局导入 Arco Design 主题变量
+   * @description 主题变量由 @mico-platform/theme 提供，在 global.less 中导入
    */
   lessLoader: {
     modifyVars: {},
@@ -77,7 +77,7 @@ const config: ReturnType<typeof defineConfig> = {
 
   /**
    * @name layout 插件
-   * @description 禁用内置 layout，使用自定义 Arco Design 布局
+   * @description 禁用内置 layout，使用自定义 @mico-platform/ui 布局
    * @doc https://umijs.org/docs/max/layout-menu
    */
   layout: false,
@@ -89,7 +89,8 @@ const config: ReturnType<typeof defineConfig> = {
   locale: {
     default: 'zh-CN',
     antd: false,
-    baseNavigator: true,
+    // 禁用浏览器语言自动检测，由运行时 getLocale 统一处理
+    baseNavigator: false,
   },
 
   /**