generator-mico-cli 0.2.20 → 0.2.21

package/README.md

@@ -48,12 +48,41 @@ mico list
 mico create micro-react --verbose
 ```
 
+预览模式（只显示将创建的文件，不实际创建）：
+
+```bash
+mico create micro-react --dry-run
+```
+
+检查环境依赖：
+
+```bash
+mico doctor
+```
+
 将额外参数传递给生成器：
 
 ```bash
 mico create micro-react -- --help
 ```
 
+## 配置文件
+
+可以在项目目录或用户主目录创建 `.micorc` 或 `.micorc.json` 文件来预设默认值：
+
+```json
+{
+  "packageScope": "@my-company",
+  "cdnPrefix": "portal",
+  "author": "Team <team@example.com>",
+  "defaultSubappName": "subapp"
+}
+```
+
+配置查找顺序：
+1. 当前目录的 `.micorc` 或 `.micorc.json`
+2. 用户主目录的 `.micorc` 或 `.micorc.json`
+
 ## Monorepo 项目生成器 (micro-react)
 
 创建基于 qiankun 微前端架构的完整 Monorepo 项目：

package/bin/mico.js

@@ -22,18 +22,32 @@ Commands:
   create <generator>    Run a generator (e.g., mico create subapp-react)
   list                  List all available generators
   update                Update mico-cli to the latest version
+  doctor                Check environment dependencies
 
 Options:
   --help, -h            Show this help message
   --version, -v         Show version number
   --verbose             Show detailed output during generation
+  --dry-run             Preview files without creating them
   --no-update-check     Skip update check
 
 Examples:
   mico create subapp-react
   mico create micro-react --verbose
+  mico create micro-react --dry-run
   mico list
   mico update
+  mico doctor
+
+Configuration:
+  Create a .micorc or .micorc.json file in your project or home directory
+  to set default values for prompts:
+
+  {
+    "packageScope": "@my-company",
+    "cdnPrefix": "portal",
+    "author": "Team <team@example.com>"
+  }
 
 Notes:
   Requires Yeoman CLI (yo) installed globally.
@@ -118,6 +132,85 @@ function printVersion() {
   console.log(`mico-cli v${pkg.version}`);
 }
 
+/**
+ * 运行 doctor 检查
+ */
+async function runDoctor() {
+  const { runDoctorChecks, loadMicorc } = require('../lib/utils');
+
+  console.log('');
+  console.log(`  \x1b[1mMico CLI Environment Check\x1b[0m (v${pkg.version})`);
+  console.log('');
+
+  const results = await runDoctorChecks();
+
+  // Node.js
+  const nodeIcon = results.node.satisfied ? '\x1b[32m✓\x1b[0m' : '\x1b[31m✗\x1b[0m';
+  const nodeStatus = results.node.satisfied ? 'OK' : `Required: >= ${results.node.required}`;
+  console.log(`  ${nodeIcon} Node.js ${results.node.current} (${nodeStatus})`);
+
+  // pnpm
+  const pnpmIcon = results.pnpm.available ? '\x1b[32m✓\x1b[0m' : '\x1b[31m✗\x1b[0m';
+  if (results.pnpm.available) {
+    console.log(`  ${pnpmIcon} pnpm ${results.pnpm.version}`);
+  } else {
+    console.log(`  ${pnpmIcon} pnpm not found`);
+    console.log('     Install: npm install -g pnpm');
+  }
+
+  // Yeoman
+  const yoIcon = results.yo.available ? '\x1b[32m✓\x1b[0m' : '\x1b[31m✗\x1b[0m';
+  if (results.yo.available) {
+    console.log(`  ${yoIcon} yo ${results.yo.version}`);
+  } else {
+    console.log(`  ${yoIcon} yo not found`);
+    console.log('     Install: npm install -g yo');
+  }
+
+  // Git
+  const gitIcon = results.git.available ? '\x1b[32m✓\x1b[0m' : '\x1b[33m⚠\x1b[0m';
+  if (results.git.available) {
+    console.log(`  ${gitIcon} git ${results.git.version}`);
+  } else {
+    console.log(`  ${gitIcon} git not found (optional)`);
+  }
+
+  // npm registry
+  const npmIcon = results.npm.reachable ? '\x1b[32m✓\x1b[0m' : '\x1b[33m⚠\x1b[0m';
+  if (results.npm.reachable) {
+    console.log(`  ${npmIcon} npm registry reachable`);
+  } else {
+    console.log(`  ${npmIcon} npm registry unreachable (${results.npm.error})`);
+  }
+
+  // .micorc 配置
+  console.log('');
+  const { config, configPath } = loadMicorc();
+  if (configPath) {
+    console.log(`  \x1b[32m✓\x1b[0m Config loaded from: ${configPath}`);
+    const keys = Object.keys(config);
+    if (keys.length > 0) {
+      console.log(`     Keys: ${keys.join(', ')}`);
+    }
+  } else {
+    console.log('  \x1b[2m○\x1b[0m No .micorc config found (optional)');
+  }
+
+  console.log('');
+
+  // 总结
+  const allGood = results.node.satisfied && results.pnpm.available && results.yo.available;
+  if (allGood) {
+    console.log('  \x1b[32m✅ All required dependencies are installed!\x1b[0m');
+  } else {
+    console.log('  \x1b[31m❌ Some required dependencies are missing.\x1b[0m');
+    console.log('     Please install them before using mico-cli.');
+  }
+  console.log('');
+
+  return allGood;
+}
+
 /**
  * 检查是否有新版本
  * @returns {Promise<{current: string, latest: string, hasUpdate: boolean} | null>}
@@ -256,6 +349,7 @@ function performUpdate(latestVersion) {
  * @param {string[]} passthroughArgs - 透传参数
  * @param {object} options - 选项
  * @param {boolean} options.verbose - 是否启用详细输出
+ * @param {boolean} options.dryRun - 是否启用 dry-run 模式
  */
 function runGenerator(generator, rest, passthroughArgs, options = {}) {
   const localGeneratorEntry = path.join(
@@ -275,17 +369,31 @@ function runGenerator(generator, rest, passthroughArgs, options = {}) {
 
   const yoArgs = [yoGenerator, ...rest];
 
+  // 添加 dry-run 参数给 yeoman
+  if (options.dryRun) {
+    yoArgs.push('--dry-run');
+  }
+
   if (passthroughArgs.length > 0) {
     yoArgs.push('--', ...passthroughArgs);
   }
 
-  // 通过环境变量传递 verbose 标志给生成器
+  // 通过环境变量传递标志给生成器
   const env = { ...process.env };
   if (options.verbose) {
     env.MICO_VERBOSE = '1';
+  }
+  if (options.dryRun) {
+    env.MICO_DRY_RUN = '1';
+  }
+
+  if (options.verbose) {
     console.log('');
     console.log('  \x1b[2m[verbose] Running generator:', yoGenerator, '\x1b[0m');
     console.log('  \x1b[2m[verbose] Arguments:', yoArgs.join(' '), '\x1b[0m');
+    if (options.dryRun) {
+      console.log('  \x1b[2m[verbose] Dry-run mode enabled\x1b[0m');
+    }
     console.log('');
   }
 
@@ -323,6 +431,7 @@ async function main() {
   const hasVersion = mainArgs.includes('--version') || mainArgs.includes('-v');
   const skipUpdateCheck = mainArgs.includes('--no-update-check');
   const isVerbose = mainArgs.includes('--verbose');
+  const isDryRun = mainArgs.includes('--dry-run');
 
   // 过滤掉标志参数
   const filteredArgs = mainArgs.filter(
@@ -332,7 +441,8 @@ async function main() {
       arg !== '--version' &&
       arg !== '-v' &&
       arg !== '--no-update-check' &&
-      arg !== '--verbose'
+      arg !== '--verbose' &&
+      arg !== '--dry-run'
   );
 
   // 处理 --version
@@ -355,6 +465,12 @@ async function main() {
     process.exit(0);
   }
 
+  // 处理 doctor 命令
+  if (command === 'doctor') {
+    const success = await runDoctor();
+    process.exit(success ? 0 : 1);
+  }
+
   // 处理 update 命令
   if (command === 'update') {
     const updateInfo = await checkForUpdate();
@@ -376,8 +492,8 @@ async function main() {
       process.exit(1);
     }
 
-    // 检查更新（除非跳过）
-    if (!skipUpdateCheck) {
+    // 检查更新（除非跳过或 dry-run）
+    if (!skipUpdateCheck && !isDryRun) {
       const updateInfo = await checkForUpdate();
       if (updateInfo && updateInfo.hasUpdate) {
         const shouldUpdate = await askForUpdate(
@@ -396,7 +512,10 @@ async function main() {
     }
 
     // 运行生成器
-    runGenerator(generator, rest.slice(1), passthroughArgs, { verbose: isVerbose });
+    runGenerator(generator, rest.slice(1), passthroughArgs, {
+      verbose: isVerbose,
+      dryRun: isDryRun
+    });
     return;
   }
 

package/generators/micro-react/index.js

@@ -9,10 +9,10 @@ const {
   collectFiles,
   transformDestPath,
   isTemplateFile,
-  getLatestNpmVersion,
+  getPackageVersionsParallel,
   setupErrorHandlers,
   createLogger,
-  // isVerbose,
+  loadMicorc,
 } = require('../../lib/utils');
 
 const IGNORE_LIST = require('./ignore-list.json');
@@ -25,6 +25,17 @@ module.exports = class extends Generator {
     this.projectRoot = process.cwd();
     this.logger = createLogger(this);
 
+    // 检查 dry-run 模式
+    this.isDryRun = this.options.dryRun || process.env.MICO_DRY_RUN === '1';
+
+    // 加载 .micorc 配置
+    const { config: rcConfig, configPath } = loadMicorc(this.projectRoot);
+    this.rcConfig = rcConfig;
+    if (configPath) {
+      this.logger.verbose('Loaded config from:', configPath);
+      this.logger.verbose('Config:', JSON.stringify(rcConfig, null, 2));
+    }
+
     // 检查当前目录是否已是一个 monorepo
     const workspaceFile = path.join(this.projectRoot, 'pnpm-workspace.yaml');
     if (fs.existsSync(workspaceFile)) {
@@ -46,12 +57,15 @@ module.exports = class extends Generator {
 
   async prompting() {
     try {
+      // 使用 .micorc 中的值作为默认值
+      const rc = this.rcConfig || {};
+
       this.answers = await this.prompt([
         {
           type: 'input',
           name: 'projectName',
           message: 'Project name',
-          default: path.basename(this.projectRoot),
+          default: rc.projectName || path.basename(this.projectRoot),
           filter: (input) => toKebab(input),
           validate: (input) => {
             const value = toKebab(input);
@@ -63,7 +77,7 @@ module.exports = class extends Generator {
           type: 'input',
           name: 'packageScope',
           message: 'Package scope (e.g., @my-project)',
-          default: (answers) => `@${toKebab(answers.projectName)}`,
+          default: (answers) => rc.packageScope || `@${toKebab(answers.projectName)}`,
           validate: (input) => {
             if (!input) return 'Package scope is required';
             if (!input.startsWith('@'))
@@ -80,7 +94,7 @@ module.exports = class extends Generator {
    - 输入 "portal": https://cdn.example.com/portal/my-project/1.0.0/
    - 输入 "admin/v2": https://cdn.example.com/admin/v2/my-project/1.0.0/
    Prefix`,
-          default: '',
+          default: rc.cdnPrefix || '',
           filter: (input) => {
             // 移除首尾斜杠，规范化路径
             return input.trim().replace(/^\/+|\/+$/g, '');
@@ -90,7 +104,7 @@ module.exports = class extends Generator {
           type: 'input',
           name: 'author',
           message: 'Author',
-          default: 'Your Name <email@example.com>',
+          default: rc.author || 'Your Name <email@example.com>',
         },
       ]);
 
@@ -110,7 +124,7 @@ module.exports = class extends Generator {
     }
   }
 
-  writing() {
+  async writing() {
     try {
       if (!fs.existsSync(this.templateDir)) {
         console.error('');
@@ -125,21 +139,21 @@ module.exports = class extends Generator {
 
       // 在 mico_cli 根目录执行 npm view，以使用该目录 .npmrc 中的 Nexus 认证
       const cliRoot = path.resolve(__dirname, '../..');
-      this.logger.verbose('Fetching latest package versions...');
+      this.logger.verbose('Fetching latest package versions (parallel)...');
 
-      const micoUiVer = getLatestNpmVersion(
-        '@mico-platform/ui',
-        '1.0.0',
-        8000,
-        cliRoot,
-      );
-      const themeVer = getLatestNpmVersion(
-        '@mico-platform/theme',
-        '1.0.0',
+      // 并行获取版本
+      const versions = await getPackageVersionsParallel(
+        [
+          { name: '@mico-platform/ui', fallback: '1.0.0' },
+          { name: '@mico-platform/theme', fallback: '1.0.0' },
+        ],
         8000,
         cliRoot,
       );
 
+      const micoUiVer = versions['@mico-platform/ui'];
+      const themeVer = versions['@mico-platform/theme'];
+
       this.logger.verbose('@mico-platform/ui version:', micoUiVer);
       this.logger.verbose('@mico-platform/theme version:', themeVer);
 
@@ -173,6 +187,45 @@ module.exports = class extends Generator {
         process.exit(1);
       }
 
+      // Dry-run 模式：只列出文件，不实际创建
+      if (this.isDryRun) {
+        this.log('');
+        this.log('\x1b[33m📋 Dry run mode - no files will be created\x1b[0m');
+        this.log('');
+        this.log(`   Project: ${this.projectName}`);
+        this.log(`   Scope: ${this.packageScope}`);
+        this.log(`   Destination: ${this.destDir}`);
+        this.log('');
+        this.log('   Would create the following files:');
+        this.log('');
+
+        let templateCount = 0;
+        let copyCount = 0;
+
+        for (const relPath of files) {
+          const destRelPath = transformDestPath(relPath);
+          const isTemplate = isTemplateFile(relPath);
+          const tag = isTemplate ? '\x1b[32m[tpl]\x1b[0m' : '\x1b[36m[cpy]\x1b[0m';
+          this.log(`   ${tag} ${destRelPath}`);
+
+          if (isTemplate) {
+            templateCount++;
+          } else {
+            copyCount++;
+          }
+        }
+
+        this.log('');
+        this.log(`   Total: ${files.length} files (${templateCount} templates, ${copyCount} static)`);
+        this.log('');
+        this.log('   Run without --dry-run to actually create these files.');
+        this.log('');
+
+        // 设置标记以跳过后续阶段
+        this._skipInstall = true;
+        return;
+      }
+
       this.log('');
       this.log(`📦 Creating project: ${this.projectName}`);
       this.log(`   Scope: ${this.packageScope}`);
@@ -210,6 +263,9 @@ module.exports = class extends Generator {
   }
 
   install() {
+    // 跳过 dry-run 模式
+    if (this._skipInstall) return;
+
     // 检查并初始化 git
     const gitDir = path.join(this.destDir, '.git');
     if (!fs.existsSync(gitDir)) {
@@ -228,6 +284,9 @@ module.exports = class extends Generator {
   }
 
   end() {
+    // 跳过 dry-run 模式
+    if (this._skipInstall) return;
+
     this.log('');
     this.log('✅ 项目创建成功！');
     this.log('');

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

@@ -53,15 +53,21 @@ apps/                         # Workspace 应用目录（微前端子应用）
 │   │   ├── app.tsx          # Umi 运行时配置
 │   │   ├── layouts/         # 布局组件
 │   │   ├── pages/           # 路由页面
-│   │   ├── components/      # 公共组件
+│   │   ├── components/      # 公共组件（MicroAppLoader 等）
 │   │   ├── common/          # 工具模块（auth、request、upload、menu）
+│   │   ├── constants/       # 常量定义（路由、主题、时区等）
 │   │   ├── hooks/           # 自定义 Hooks
 │   │   ├── services/        # API 服务层
 │   │   ├── models/          # Umi model（全局状态）
-│   │   ├── locales/         # 国际化文件（zh-CN、en-US）
-│   │   └── styles/          # 主题变量与样式覆盖
+│   │   └── locales/         # 国际化文件（zh-CN、en-US）
 │   └── config/              # Umi 配置
-packages/                     # 共享包
+├── basis/                    # 基础数据子应用（货币管理等）
+│   ├── src/
+│   │   ├── pages/           # 路由页面
+│   │   ├── locales/         # 国际化文件
+│   │   └── common/          # 工具模块
+│   └── config/              # Umi 配置
+packages/                     # 共享包（common-intl 等）
 scripts/                      # 构建与开发脚本
 CICD/                         # 部署资源
 ```
@@ -97,7 +103,7 @@ refactor(auth): 重构认证服务
 API 请求配置在 `src/common/request/`（模块化拆分为 6 个文件），错误处理在 `src/requestErrorConfig.ts`。详见 [请求模块架构](./apps/layout/docs/arch-请求模块.md)。
 
 ### 日志与常量
-Logger 工具在 `src/common/logger.ts`，常量定义在 `src/common/constants.ts`。详见 [日志与常量](./apps/layout/docs/arch-日志与常量.md)。
+Logger 工具在 `src/common/logger.ts`，常量定义在 `src/constants/index.ts`。详见 [日志与常量](./apps/layout/docs/arch-日志与常量.md)。
 
 ### 认证模块
 认证逻辑在 `src/common/auth/`，核心文件 `auth-manager.ts` 管理 Token 存储和用户信息。SSO 登录在 `getInitialState()` 中完成，确保 UI 渲染前认证已就绪。

package/generators/micro-react/templates/_gitignore

@@ -55,3 +55,5 @@ build
 /openspec
 
 **/tasks/*
+
+.pnpm-store/**

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

@@ -118,6 +118,27 @@ const config: ReturnType<typeof defineConfig> = {
    */
   tailwindcss: {},
 
+  /**
+   * @name 额外 Babel Presets
+   * @description 使用 @mico-platform/ui 的 babel preset，实现组件与图标的按需加载
+   */
+  extraBabelPresets: ['@mico-platform/ui/babel-preset'],
+
+  /**
+   * @name MFSU 配置
+   * @description
+   * - exclude: theme 子路径解析；ui 尽量与主应用一起编译
+   * - shared: React 单例，确保 MFSU 预打包里的组件（如 Layout）与主应用共用同一份 React，否则 useContext 报 null
+   * @doc https://umijs.org/docs/guides/mfsu
+   */
+  mfsu: {
+    exclude: ['@mico-platform/theme', '@mico-platform/ui'],
+    shared: {
+      react: { singleton: true },
+      'react-dom': { singleton: true },
+    },
+  },
+
   /**
    * @name qiankun 微前端配置
    * @description 作为主应用，动态加载子应用

package/generators/micro-react/templates/apps/layout/docs/common-intl.md

@@ -10,6 +10,8 @@
 - 需要从多语言中台动态获取翻译文案
 - 希望统一管理国际化逻辑，减少重复代码
 
+> **注意**：本文档描述的是 `@payment-portal/common-intl` 包的完整使用方式，涵盖了所有使用该包的应用（包括本仓库外的应用如 conversation-v2、session、workorder 等）。当前仓库仅包含 `layout` 和 `basis` 两个应用。
+
 ## 核心特性
 
 | 特性       | 说明                                             |
@@ -311,12 +313,12 @@ console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 
 目前支持以下语言：
 
-| 语言常量     | 值      | 说明     |
-| ------------ | ------- | -------- |
-| `LANG.ZH_CN` | `zh_CN` | 简体中文 |
-| `LANG.EN`    | `en`    | 英语     |
-| `LANG.AR`    | `ar`    | 阿拉伯语 |
-| `LANG.TR`    | `tr`    | 土耳其语 |
+| 语言常量      | 值      | 说明     |
+| ------------- | ------- | -------- |
+| `LANG.ZH_CN`  | `zh_CN` | 简体中文 |
+| `LANG.EN_US`  | `en`    | 英语     |
+| `LANG.AR_SA`  | `ar`    | 阿拉伯语 |
+| `LANG.TR_TR`  | `tr`    | 土耳其语 |
 
 ### Q: 如何在代码中获取当前语言？
 

package/generators/micro-react/templates/apps/layout/docs/feature-/345/276/256/345/211/215/347/253/257/346/250/241/345/274/217.md

@@ -28,16 +28,16 @@
 
 ### 核心文件
 
-| 文件路径                                            | 说明                             |
-| --------------------------------------------------- | -------------------------------- |
-| `src/components/MicroAppLoader/index.tsx`           | qiankun 微应用加载器组件         |
-| `src/components/MicroAppLoader/container-manager.ts`| 容器生命周期管理、会话 ID 机制   |
-| `src/components/MicroAppLoader/index.less`          | 加载器样式                       |
-| `src/common/menu/parser.ts`                         | 菜单解析，包含加载类型判断       |
-| `src/common/menu/types.ts`                          | 类型定义                         |
-| `src/layouts/index.tsx`                             | 主布局，集成微应用渲染           |
-| `src/app.tsx`                                       | qiankun 全局错误处理             |
-| `config/config.ts`                                  | qiankun master 配置              |
+| 文件路径 | 说明 |
+| --- | --- |
+| `src/components/MicroAppLoader/index.tsx` | qiankun 微应用加载器组件 |
+| `src/components/MicroAppLoader/micro-app-manager.ts` | 微应用管理器（单例），稳定容器 + 实例缓存 + 操作序列号 |
+| `src/components/MicroAppLoader/index.less` | 加载器样式 |
+| `src/common/menu/parser.ts` | 菜单解析，包含加载类型判断 |
+| `src/common/menu/types.ts` | 类型定义 |
+| `src/layouts/index.tsx` | 主布局，集成微应用渲染 |
+| `src/app.tsx` | qiankun 全局错误处理 |
+| `config/config.ts` | qiankun master 配置 |
 
 ## API / 组件接口
 
@@ -462,52 +462,77 @@ addGlobalUncaughtErrorHandler((event: Event | string) => {
 });
 ```
 
-### container-manager API
+### MicroAppManager API (micro-app-manager.ts)
 
-容器管理器提供会话 ID 机制防止并发加载冲突：
+`MicroAppManager` 是单例类，管理微应用的加载、缓存、切换和卸载：
 
 ```typescript
-/** 开始加载会话，返回唯一会话 ID */
-function startLoadSession(appName: string): number;
+interface MicroAppConfig {
+  name: string;
+  entry: string;
+  target: HTMLElement;       // 目标挂载位置
+  props: Record<string, unknown>;
+}
+
+interface MicroAppState {
+  loading: boolean;
+  error: string | null;
+  mounted: boolean;
+}
+
+const manager = microAppManager; // 单例，导出即用
 
-/** 检查会话是否仍然有效（被新加载覆盖时返回 false） */
-function isLoadSessionValid(appName: string, sessionId: number): boolean;
+/** 切换到指定微应用（已挂载则仅更新 props） */
+manager.switchTo(config: MicroAppConfig): void;
 
-/** 标记加载完成 */
-function markLoadComplete(appName: string, sessionId: number): boolean;
+/** 更新当前已挂载微应用的 props */
+manager.updateProps(props: Record<string, unknown>): void;
 
-/** 等待当前卸载操作完成（如果有） */
-async function waitForUnmount(appName: string): Promise<void>;
+/** 取消待处理的请求 */
+manager.cancel(): void;
 
-/** 获取当前加载状态 */
-function getLoadingStatus(appName: string): 'idle' | 'loading' | 'mounted' | 'unmounting';
+/** 清除所有缓存实例 */
+manager.clearCache(): Promise<void>;
+
+/** 获取调试信息 */
+manager.getDebugInfo(): object;
+
+/** 设置状态变化回调 */
+manager.setStateCallback(callback: StateChangeCallback | null): void;
 ```
 
+### 核心设计
+
+1. **稳定容器**：容器在 `document.body` 中创建，激活时移到目标元素内，停用时移回 body 隐藏，不受 React 生命周期影响
+2. **实例缓存**：每个 entry 只 `loadMicroApp` 一次，后续切换复用已有实例（mount/unmount）
+3. **操作序列号**：通过递增的 `operationSeq` 检测过期操作，替代旧的会话 ID 机制
+4. **自动路由守卫**：由独立的 `route-guard.ts` 自动检测用户意图，业务代码无需感知
+
 ### 快速切换时序
 
 ```
 场景：A → B → A 快速切换
 
-A1 开始加载 (sessionId=1)
-  ↓
-切换到 B，A1 cleanup 在 queueMicrotask 中执行
+switchTo(A)：operationSeq=1，开始 loadMicroApp
   ↓
-切换回 A，A2 开始加载 (sessionId=2)
+switchTo(B)：operationSeq=2，A 的 pendingRequest 被替换
   ↓
-A2 调用 waitForUnmount()，等待 A1 完全卸载
+A 的 processRequest 在异步步骤中检测 shouldAbort(mySeq=1) → true
   ↓
-A1 卸载完成（带 10 秒超时保护）
+A 等待 mountPromise 完成后执行 safeUnmount，容器移回 body
   ↓
-A2 继续加载，每个异步步骤检查 isLoadSessionValid(sessionId)
+B 开始 processRequest，检查缓存 → 无缓存 → loadMicroApp
   ↓
-加载完成后立即同步最新 Props（locale/timezone 等）
+B 加载完成后同步最新 Props（locale/timezone/routePath 等）
 ```
 
 ### 设计决策
 
 | 决策点 | 选择 | 理由 |
-|--------|------|------|
-| 卸载时机 | `queueMicrotask` | 在当前事件循环末尾执行，比 `requestAnimationFrame` 更快更可靠 |
-| 并发控制 | 会话 ID 机制 | 简单高效，无需复杂的锁机制 |
-| 超时时间 | 10 秒 | 平衡等待时间与异常检测速度 |
-| Props 同步 | 加载后立即同步 | 确保加载期间的变化不丢失 |
+| --- | --- | --- |
+| 容器策略 | 稳定容器（body 中创建，移动挂载） | 不受 React 生命周期影响，避免容器被意外销毁 |
+| 并发控制 | 操作序列号 + pendingRequest 队列 | 简单高效，新请求自动覆盖旧请求 |
+| 实例缓存 | loadPromise 完成后立即缓存 | 即使被 abort 也可复用，避免重复加载 |
+| unmount 安全 | 等待 mountPromise 完成后再 unmount | 避免 single-spa error #32 |
+| 超时保护 | load 30s / mount 30s / unmount 10s | 平衡等待时间与异常检测速度 |
+| Props 同步 | mount 完成后立即 safeUpdate | 确保加载期间的变化不丢失 |