generator-mico-cli 0.2.21 → 0.2.23

package/README.md

@@ -9,6 +9,7 @@
 | [docs/mico-cli.md](docs/mico-cli.md) | Mico CLI 功能概述与技术方案 |
 | [docs/micro-react-generator.md](docs/micro-react-generator.md) | Monorepo 项目生成器说明 |
 | [docs/subapp-react-generator.md](docs/subapp-react-generator.md) | React 子应用生成器说明 |
+| [docs/subapp-umd-generator.md](docs/subapp-umd-generator.md) | UMD 组件包生成器说明 |
 
 ## 要求
 
@@ -97,6 +98,7 @@ mico create micro-react
 - @mico-platform/ui、@mico-platform/theme
 - Turborepo + pnpm Workspace
 - Husky + Commitlint
+- @common-web/sentry 错误监控与 SourceMap 上传
 
 ## React 子应用生成器
 
@@ -108,6 +110,34 @@ cd <monorepo-root>
 mico create subapp-react
 ```
 
+## UMD 组件包生成器
+
+在 Monorepo 的 `packages/` 目录下创建 UMD 格式的组件包，使用 Webpack 构建。适用于通过 `<script>` 标签加载的场景（如主应用菜单挂载组件、第三方系统嵌入 Widget 等）。
+
+```bash
+cd <monorepo-root>
+mico create subapp-umd
+```
+
+生成器会提示输入：
+- **Package name** — 包名（如 `my-widget`）
+- **UMD global variable name** — 全局变量名（如 `MyWidget`）
+- **Package scope** — 包作用域（自动从根 `package.json` 检测）
+- **Dev server port** — 开发端口（默认 `9100`）
+
+生成的包支持：
+- `pnpm dev` — 启动 webpack-dev-server，同时提供 HTML 预览页和 UMD JS 文件
+- `pnpm build` — 构建生产环境 UMD 产物到 `dist/`
+
+开发模式下：
+
+| URL | 用途 |
+|---|---|
+| `http://localhost:<port>/` | HTML 预览页，独立调试 |
+| `http://localhost:<port>/<name>.umd.js` | UMD JS 文件，供主应用通过 `jsUrls` 联调 |
+
+DevTools Sources 面板中可在 `webpack://<name>/src/` 下定位原始 TypeScript 源码进行断点调试。
+
 ## 本地调试
 
 克隆项目后，执行以下步骤进行本地开发和调试：
@@ -133,6 +163,9 @@ mico create micro-react
 
 # 测试 subapp-react 生成器（需在已有 monorepo 中执行）
 mico create subapp-react
+
+# 测试 subapp-umd 生成器（需在已有 monorepo 中执行）
+mico create subapp-umd
 ```
 
 调试完成后，可以取消全局链接：

package/bin/mico.js

@@ -29,12 +29,14 @@ Options:
   --version, -v         Show version number
   --verbose             Show detailed output during generation
   --dry-run             Preview files without creating them
+  --force               Overwrite all existing files without confirmation
   --no-update-check     Skip update check
 
 Examples:
   mico create subapp-react
   mico create micro-react --verbose
   mico create micro-react --dry-run
+  mico create micro-react --force
   mico list
   mico update
   mico doctor
@@ -350,6 +352,7 @@ function performUpdate(latestVersion) {
  * @param {object} options - 选项
  * @param {boolean} options.verbose - 是否启用详细输出
  * @param {boolean} options.dryRun - 是否启用 dry-run 模式
+ * @param {boolean} options.force - 是否强制覆盖已有文件
  */
 function runGenerator(generator, rest, passthroughArgs, options = {}) {
   const localGeneratorEntry = path.join(
@@ -374,6 +377,10 @@ function runGenerator(generator, rest, passthroughArgs, options = {}) {
     yoArgs.push('--dry-run');
   }
 
+  if (options.force) {
+    yoArgs.push('--force');
+  }
+
   if (passthroughArgs.length > 0) {
     yoArgs.push('--', ...passthroughArgs);
   }
@@ -394,6 +401,9 @@ function runGenerator(generator, rest, passthroughArgs, options = {}) {
     if (options.dryRun) {
       console.log('  \x1b[2m[verbose] Dry-run mode enabled\x1b[0m');
     }
+    if (options.force) {
+      console.log('  \x1b[2m[verbose] Force mode enabled\x1b[0m');
+    }
     console.log('');
   }
 
@@ -432,6 +442,7 @@ async function main() {
   const skipUpdateCheck = mainArgs.includes('--no-update-check');
   const isVerbose = mainArgs.includes('--verbose');
   const isDryRun = mainArgs.includes('--dry-run');
+  const isForce = mainArgs.includes('--force');
 
   // 过滤掉标志参数
   const filteredArgs = mainArgs.filter(
@@ -442,7 +453,8 @@ async function main() {
       arg !== '-v' &&
       arg !== '--no-update-check' &&
       arg !== '--verbose' &&
-      arg !== '--dry-run'
+      arg !== '--dry-run' &&
+      arg !== '--force'
   );
 
   // 处理 --version
@@ -514,7 +526,8 @@ async function main() {
     // 运行生成器
     runGenerator(generator, rest.slice(1), passthroughArgs, {
       verbose: isVerbose,
-      dryRun: isDryRun
+      dryRun: isDryRun,
+      force: isForce
     });
     return;
   }

package/generators/micro-react/index.js

@@ -36,9 +36,9 @@ module.exports = class extends Generator {
       this.logger.verbose('Config:', JSON.stringify(rcConfig, null, 2));
     }
 
-    // 检查当前目录是否已是一个 monorepo
+    // 检查当前目录是否已是一个 monorepo（--force 跳过此检查）
     const workspaceFile = path.join(this.projectRoot, 'pnpm-workspace.yaml');
-    if (fs.existsSync(workspaceFile)) {
+    if (fs.existsSync(workspaceFile) && !this.options.force) {
       console.error('');
       console.error('❌ Error: Current directory is already a monorepo.');
       console.error('');
@@ -51,6 +51,9 @@ module.exports = class extends Generator {
       console.error('     mkdir my-project && cd my-project');
       console.error('     mico create micro-react');
       console.error('');
+      console.error('   To regenerate in an existing monorepo, use --force:');
+      console.error('     mico create micro-react --force');
+      console.error('');
       process.exit(1);
     }
   }
@@ -278,9 +281,31 @@ module.exports = class extends Generator {
 
     this.log('');
     this.log('📦 正在安装依赖...');
-    this.spawnCommandSync('pnpm', ['install'], {
-      cwd: this.destDir,
-    });
+    try {
+      this.spawnCommandSync('pnpm', ['install'], {
+        cwd: this.destDir,
+      });
+    } catch (e) {
+      this._installFailed = true;
+      this.log('');
+      this.log('⚠️  依赖安装失败，但项目文件已全部生成。');
+      this.logger.verbose('Install error:', e.message);
+      return;
+    }
+
+    // 依赖安装成功后，格式化生成的文件以消除风格差异
+    const layoutDir = path.join(this.destDir, 'apps/layout');
+    if (fs.existsSync(path.join(layoutDir, '.prettierrc'))) {
+      this.log('');
+      this.log('🎨 格式化生成的文件...');
+      try {
+        this.spawnCommandSync('pnpm', ['-C', 'apps/layout', 'format'], {
+          cwd: this.destDir,
+        });
+      } catch (e) {
+        this.logger.verbose('Formatting failed (non-critical):', e.message);
+      }
+    }
   }
 
   end() {
@@ -288,7 +313,20 @@ module.exports = class extends Generator {
     if (this._skipInstall) return;
 
     this.log('');
-    this.log('✅ 项目创建成功！');
+
+    if (this._installFailed) {
+      this.log('⚠️  项目文件已创建，但依赖安装未完成。');
+      this.log('');
+      this.log('   请手动安装依赖:');
+      this.log('');
+      this.log('   pnpm install');
+      this.log('');
+      this.log('   如果安装仍然失败，可尝试:');
+      this.log('   pnpm install --network-concurrency 4');
+    } else {
+      this.log('✅ 项目创建成功！');
+    }
+
     this.log('');
     this.log('   后续步骤:');
     this.log('');

package/generators/micro-react/meta.json

@@ -7,6 +7,7 @@
     "qiankun 微前端架构",
     "Arco Design + Tailwind CSS",
     "主题切换、国际化、认证模块",
-    "可配置 CDN 路径前缀（支持多业务线隔离）"
+    "可配置 CDN 路径前缀（支持多业务线隔离）",
+    "Sentry 错误监控与 SourceMap 上传"
   ]
 }

package/generators/micro-react/templates/.cursor/rules/always-read-docs.mdc

@@ -20,8 +20,15 @@ docs/
 ### 2. Layout 应用文档 (`/apps/layout/docs/`)
 ```
 apps/layout/docs/
-├── feature-微前端模式.md   # qiankun 微前端架构
-└── feature-主题色切换.md   # 主题系统实现
+├── feature-微前端模式.md        # qiankun 微前端架构
+├── feature-路由与菜单解耦.md    # PAGES/MENUS 数据源分离、双层权限
+├── feature-菜单权限控制.md      # sideMenus 白名单、认证与授权分离
+├── feature-主题色切换.md        # 主题系统实现
+├── feature-404页面.md           # 404 页面
+├── arch-请求模块.md             # HTTP 请求层模块化设计
+├── arch-日志与常量.md           # Logger 工具与常量管理
+├── common-intl.md               # 国际化公共包
+└── utils-timezone.md            # 时区工具
 ```
 
 ### 3. 其他应用文档
@@ -33,8 +40,9 @@ apps/layout/docs/
 
 ### Step 1: 确认需求涉及的模块
 - 微前端相关 → 阅读 `apps/layout/docs/feature-微前端模式.md`
+- 路由/菜单/权限相关 → 阅读 `apps/layout/docs/feature-路由与菜单解耦.md` 和 `apps/layout/docs/feature-菜单权限控制.md`
 - 主题/样式相关 → 阅读 `apps/layout/docs/feature-主题色切换.md`
-- 请求/认证相关 → 阅读 `src/common/request/` 和 `src/common/auth/` 源码
+- 请求/认证相关 → 阅读 `apps/layout/docs/arch-请求模块.md` 和 `src/common/auth/` 源码
 - 菜单相关 → 阅读 `src/common/menu/` 源码
 
 ### Step 2: 查找相关文档
@@ -54,9 +62,11 @@ find . -name "*.md" -type f | grep -v node_modules
 | 需求类型 | 必读文档 |
 |---------|---------|
 | 新建子应用 | `apps/layout/docs/feature-微前端模式.md` |
+| 路由/页面配置 | `apps/layout/docs/feature-路由与菜单解耦.md` |
+| 权限控制 | `apps/layout/docs/feature-菜单权限控制.md` |
 | 主题适配 | `apps/layout/docs/feature-主题色切换.md` |
 | 提交代码 | `docs/commit-message.md` |
-| API 请求 | `src/common/request/index.ts` 源码注释 |
+| API 请求 | `apps/layout/docs/arch-请求模块.md` |
 | 认证登录 | `src/common/auth/` 目录源码 |
 | 菜单配置 | `src/common/menu/types.ts` 类型定义 |
 

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

@@ -63,24 +63,27 @@ apps/layout/
 const BasicLayout: React.FC = () => {
   const location = useLocation();
 
-  // 解析路由配置
-  const routes = useMemo(() => {
-    const menus = getWindowMenus();
-    return extractRoutes(menus);
+  // 所有页面路由（优先 PAGES，降级 MENUS）— 用于路由匹配和渲染
+  const allPageRoutes = useMemo(() => {
+    return getDynamicRoutes();
   }, []);
 
-  // 查找当前路由配置
+  // 菜单路由（从 MENUS）— 用于权限交叉引用
+  const allMenuRoutes = useMemo(() => {
+    return extractRoutes(getMenus());
+  }, []);
+
+  // 当前路由配置（从所有页面路由中查找）
   const currentRoute = useMemo(() => {
-    return findRouteByPath(routes, location.pathname);
-  }, [routes, location.pathname]);
+    return findRouteByPath(allPageRoutes, location.pathname);
+  }, [allPageRoutes, location.pathname]);
 
   // 渲染页面内容
   const renderContent = () => {
-    // 微应用类型使用 MicroAppLoader
     if (currentRoute?.loadType === 'microapp' && currentRoute.entry) {
-      return <MicroAppLoader entry={currentRoute.entry} name={currentRoute.path} />;
+      const appName = getAppNameFromEntry(currentRoute.entry);
+      return <MicroAppLoader entry={currentRoute.entry} name={appName} />;
     }
-    // 内部路由使用 Outlet
     return <Outlet />;
   };
 
@@ -98,28 +101,36 @@ const BasicLayout: React.FC = () => {
 };
 ```
 
-### 2. 菜单系统 (common/menu/)
+### 2. 全局数据源 (common/portal-data.ts) + 菜单系统 (common/menu/)
 
 ```typescript
-// 获取菜单数据
-const menus = getWindowMenus();
+// 获取页面列表 (window.__MICO_PAGES__)
+const pages = getPages();
+
+// 获取菜单树 (window.__MICO_MENUS__)
+const menus = getMenus();
 
-// 提取路由配置
-const routes = extractRoutes(menus);
+// 从页面列表提取动态路由（优先数据源）
+const routes = getDynamicRoutes();
 
-// 解析菜单项
+// 从菜单树提取路由（用于权限交叉引用）
+const menuRoutes = extractRoutes(menus);
+
+// 解析菜单项（用于侧边栏渲染）
 const menuItems = parseMenuItems(menus);
 
 // 查找当前路由
 const currentRoute = findRouteByPath(routes, pathname);
+
+// 通过 pageId 查找页面（O(1)）
+const page = getPageById(pageId);
 ```
 
 ### 3. 动态路由 (app.tsx)
 
 ```typescript
 export function patchClientRoutes({ routes }: { routes: any[] }) {
-  const menus = getWindowMenus();
-  const dynamicRoutes = extractRoutes(menus);
+  const dynamicRoutes = getDynamicRoutes(); // 从 __MICO_PAGES__ 获取
 
   const rootRoute = routes.find((r) => r.path === '/');
   dynamicRoutes.forEach((route) => {
@@ -128,9 +139,7 @@ export function patchClientRoutes({ routes }: { routes: any[] }) {
       name: route.name,
       meta: {
         loadType: route.loadType,
-        htmlUrl: route.htmlUrl,
-        jsUrls: route.jsUrls,
-        cssUrls: route.cssUrls,
+        entry: route.entry,
       },
     });
   });
@@ -265,8 +274,9 @@ const { collapsed } = useModel('global');
 
 ## 注意事项
 
-1. **菜单数据来源**: 通过 `window.__MICO_MENUS__` 注入
-2. **路由动态生成**: 在 `patchClientRoutes` 中根据菜单生成路由
-3. **微应用判断**: 根据 `htmlUrl` 或 `jsUrls` 判断是否为微应用
-4. **主题初始化**: 在 `app.tsx` 中调用 `initTheme()` 避免闪烁
-5. **认证共享**: 子应用使用主应用传递的 `request` 实例
+1. **数据来源**: 页面列表通过 `window.__MICO_PAGES__` 注入，菜单树通过 `window.__MICO_MENUS__` 注入
+2. **路由动态生成**: 在 `patchClientRoutes` 中优先从 `__MICO_PAGES__` 生成路由
+3. **权限交叉引用**: 菜单路由（`__MICO_MENUS__`）用于权限判断，页面路由（`__MICO_PAGES__`）用于渲染
+4. **微应用判断**: 根据 `htmlUrl` 或 `jsUrls` 判断是否为微应用
+5. **主题初始化**: 在 `app.tsx` 中调用 `initTheme()` 避免闪烁
+6. **认证共享**: 子应用使用主应用传递的 `request` 实例

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

@@ -61,15 +61,16 @@ alwaysApply: true
 - **关键文件**:
   - `src/layouts/index.tsx` - 主布局组件
   - `src/components/MicroAppLoader/` - 微应用加载器
-  - `src/common/menu/parser.ts` - 菜单解析与路由提取
+  - `src/common/menu/parser.ts` - 菜单解析、页面数据提取与路由生成
   - `src/common/request/index.ts` - 统一请求封装
   - `src/hooks/useTheme.ts` - 主题管理 Hook
 
 ### 2. 微前端架构
-- 菜单数据通过 `window.__MICO_MENUS__` 注入
+- 路由注册优先使用 `window.__MICO_PAGES__`（页面列表），无数据时降级到 `window.__MICO_MENUS__`（菜单树）
 - 根据 `htmlUrl` 或 `jsUrls` 判断是否为微应用
 - 使用 `loadMicroApp` API 动态挂载子应用
 - 子应用共享主应用的 `request` 实例
+- 权限通过菜单交叉引用 + 页面级兜底的双层策略控制
 
 ### 3. 主题系统
 - 支持亮色/暗黑主题切换
@@ -123,6 +124,8 @@ Jenkins 根据环境执行 `CICD/` 下的构建脚本：
 ## 相关文档
 
 - [微前端模式](mdc:apps/layout/docs/feature-微前端模式.md)
+- [路由与菜单解耦](mdc:apps/layout/docs/feature-路由与菜单解耦.md)
+- [菜单权限控制](mdc:apps/layout/docs/feature-菜单权限控制.md)
 - [主题色切换](mdc:apps/layout/docs/feature-主题色切换.md)
 - [提交规范](mdc:docs/commit-message.md)
 - [部署说明](mdc:deployDesc.md)

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

@@ -108,8 +108,8 @@ Logger 工具在 `src/common/logger.ts`，常量定义在 `src/constants/index.t
 ### 认证模块
 认证逻辑在 `src/common/auth/`，核心文件 `auth-manager.ts` 管理 Token 存储和用户信息。SSO 登录在 `getInitialState()` 中完成，确保 UI 渲染前认证已就绪。
 
-### 菜单系统
-菜单解析与类型定义在 `src/common/menu/`。
+### 菜单与路由系统
+菜单解析与类型定义在 `src/common/menu/`。路由注册消费 `window.__MICO_PAGES__`（页面列表），菜单栏消费 `window.__MICO_MENUS__`（菜单树），两者解耦运作。权限通过菜单交叉引用 + 页面级兜底的双层策略控制。详见 [路由与菜单解耦](./apps/layout/docs/feature-路由与菜单解耦.md) 和 [菜单权限控制](./apps/layout/docs/feature-菜单权限控制.md)。
 
 ### 微前端
 layout 应用作为 qiankun 主应用，子应用通过 Umi 配置中的 qiankun 配置注册。详见 [微前端模式](./apps/layout/docs/feature-微前端模式.md)。
@@ -121,6 +121,8 @@ layout 应用作为 qiankun 主应用，子应用通过 Umi 配置中的 qiankun
 | [README.md](./README.md) | 项目入口、技术栈、常用命令 |
 | [提交规范](./docs/commit-message.md) | Git Commit 详细规范 |
 | [微前端模式](./apps/layout/docs/feature-微前端模式.md) | qiankun 架构、MicroAppLoader、子应用配置 |
+| [路由与菜单解耦](./apps/layout/docs/feature-路由与菜单解耦.md) | PAGES/MENUS 数据源分离、双层权限控制 |
+| [菜单权限控制](./apps/layout/docs/feature-菜单权限控制.md) | sideMenus 白名单、认证与授权分离 |
 | [主题色切换](./apps/layout/docs/feature-主题色切换.md) | useTheme Hook、CSS 变量系统 |
 | [请求模块架构](./apps/layout/docs/arch-请求模块.md) | HTTP 请求层模块化设计 |
 | [日志与常量](./apps/layout/docs/arch-日志与常量.md) | Logger 工具与常量管理 |

package/generators/micro-react/templates/_gitignore

@@ -56,4 +56,6 @@ build
 
 **/tasks/*
 
-.pnpm-store/**
+.pnpm-store/**
+
+.worktrees/**

package/generators/micro-react/templates/_npmrc

@@ -1,5 +1,6 @@
 registry=https://registry.npmjs.com/
 @mico-platform:registry=https://nexus-vywrajy.micoworld.net/repository/mico-base-common/
+@common-web: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

@@ -4,6 +4,7 @@ import { defineConfig } from '@umijs/max';
 
 
 import mockMenus from '../mock/menus';
+import mockPages from '../mock/pages';
 
 const config: ReturnType<typeof defineConfig> = {
   publicPath: '/',
@@ -16,18 +17,21 @@ const config: ReturnType<typeof defineConfig> = {
     {
       content: `
         window.__MICO_MENUS__ = ${JSON.stringify(mockMenus)};
+        window.__MICO_PAGES__ = ${JSON.stringify(mockPages)};
         window.__MICO_CONFIG__ = {
           appName: '<%= projectName %>',
+          title: '测试样例',
+          logo: '',
           apiBaseUrl: '',
           defaultPath: '',
           // 免认证路由（跳过 SSO 登录），支持 /* 前缀匹配
           // noAuthRouteList: ['/*'],
           // 免权限校验路由（跳过菜单权限检查）
-          // noPermissionRouteList: ['/task-query/*'],
+          noPermissionRouteList: [],
           // 不显示布局的路由（全屏页面）
-          // noLayoutRouteList: ['/task-query/*'],
+          // noLayoutRouteList: [],
           // 关闭权限控制（调试用）
-          disableAuth: true,
+          disableAuth: false,
         };
       `,
     },

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

@@ -3,6 +3,11 @@
 import { defineConfig } from '@umijs/max';
 
 const config: ReturnType<typeof defineConfig> = {
+  externals: {
+    react: 'React',
+    'react-dom': 'ReactDOM',
+    '@common-web/sentry': 'CommonWebSentry',
+  },
   define: {
     'process.env.NODE_ENV': 'development',
     'process.env.APP_ID': '<%= projectName %>',

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

@@ -3,6 +3,11 @@
 import { defineConfig } from '@umijs/max';
 
 const config: ReturnType<typeof defineConfig> = {
+  externals: {
+    react: 'React',
+    'react-dom': 'ReactDOM',
+    '@common-web/sentry': 'CommonWebSentry',
+  },
   define: {
     'process.env.NODE_ENV': 'testing',
     'process.env.APP_ID': '<%= projectName %>',

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

@@ -1,6 +1,7 @@
 // https://umijs.org/config/
 
 import { defineConfig } from '@umijs/max';
+import { applySentryPlugin } from '../../../scripts/apply-sentry-plugin';
 const { CDN_PUBLIC_PATH } = process.env;
 
 const PUBLIC_PATH: string = CDN_PUBLIC_PATH
@@ -8,6 +9,11 @@ const PUBLIC_PATH: string = CDN_PUBLIC_PATH
   : '/layout/';
 
 const config: ReturnType<typeof defineConfig> = {
+  /**
+   * 启用 Source Map（用于 Sentry 错误追踪）
+   * hidden-source-map 会生成 .map 文件但不在 JS 中添加 sourcemap 注释
+   */
+  devtool: 'hidden-source-map',
   define: {
     'process.env.NODE_ENV': 'production',
     'process.env.APP_ID': '<%= projectName %>',
@@ -20,6 +26,11 @@ const config: ReturnType<typeof defineConfig> = {
     'process.env.EXTERNAL_LOGIN_PATH':
       'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
   },
+  externals: {
+    react: 'React',
+    'react-dom': 'ReactDOM',
+    '@common-web/sentry': 'CommonWebSentry',
+  },
   // 生产环境：将所有代码打包到一个文件
   extraBabelPlugins: ['babel-plugin-dynamic-import-node'],
 
@@ -29,6 +40,7 @@ const config: ReturnType<typeof defineConfig> = {
     memo.optimization.splitChunks(false);
     // 禁用 runtimeChunk
     memo.optimization.runtimeChunk(false);
+    applySentryPlugin({ memo, appName: 'layout' });
     return memo;
   },
   publicPath: PUBLIC_PATH,

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

@@ -5,11 +5,6 @@
  * @note Umi Max 会自动使用 src/layouts/index.tsx 作为全局布局，无需显式配置
  */
 export default [
-  {
-    path: '/user/login',
-    component: './User/Login',
-    name: '登录',
-  },
   {
     path: '/',
     component: './Home',

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

@@ -18,8 +18,8 @@
 
 ### 核心实现
 
-1. 主应用通过 `window.__MICO_MENUS__` 获取菜单配置
-2. 解析菜单时根据 `htmlUrl` 或 `jsUrls` 判断是否为微应用
+1. 主应用优先通过 `window.__MICO_PAGES__` 获取页面配置，无数据时降级到 `window.__MICO_MENUS__`（详见 [路由与菜单解耦](./feature-路由与菜单解耦.md)）
+2. 解析页面时根据 `htmlUrl` 或 `jsUrls` 判断是否为微应用
 3. 路由匹配时，微应用类型使用 `MicroAppLoader` 组件加载
 4. `MicroAppLoader` 使用 qiankun 的 `loadMicroApp` API 动态挂载子应用
 5. 组件卸载时自动调用 `unmount()` 清理子应用
@@ -421,6 +421,8 @@ export default function HomePage() {
 
 ## 相关文档
 
+- [路由与菜单解耦](./feature-路由与菜单解耦.md) - 路由注册与菜单导航数据源分离
+- [菜单权限控制](./feature-菜单权限控制.md) - sideMenus 白名单权限逻辑
 - [主题色切换](./feature-主题色切换.md) - 主题系统实现与子应用适配
 - [请求模块架构](./arch-请求模块.md) - HTTP 请求层模块化设计
 - [日志与常量](./arch-日志与常量.md) - Logger 工具与常量管理