generator-mico-cli 0.2.8 → 0.2.10

package/generators/micro-react/index.js

@@ -139,15 +139,20 @@ module.exports = class extends Generator {
     }
   }
 
+  install() {
+    this.log('');
+    this.log('📦 正在安装依赖...');
+    this.spawnCommandSync('pnpm', ['install'], {
+      cwd: this.destDir
+    });
+  }
+
   end() {
     this.log('');
     this.log('✅ 项目创建成功！');
     this.log('');
     this.log('   后续步骤:');
     this.log('');
-    this.log('   # 安装依赖');
-    this.log('   pnpm install');
-    this.log('');
     this.log('   # 启动开发服务器');
     this.log('   pnpm dev');
     this.log('');

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

@@ -17,7 +17,7 @@ const config: ReturnType<typeof defineConfig> = {
       content: `
         window.__MICO_MENUS__ = ${JSON.stringify(mockMenus)};
         window.__MICO_CONFIG__ = {
-          appName: 'Mico Center',
+          appName: '<%= projectName %>',
           apiBaseUrl: '',
           defaultPath: '',
         };

package/generators/micro-react/templates/apps/layout/docs/feature-/350/217/234/345/215/225/346/235/203/351/231/220/346/216/247/345/210/266.md

@@ -1,11 +1,32 @@
 # 菜单权限控制
 
 > 创建时间：2026-01-24
+> 更新时间：2026-01-26
 
 ## 功能概述
 
 基于用户信息中的 `side_menus` 字段实现菜单和路由的白名单权限控制。非超级用户只能看到和访问 `side_menus` 中配置的菜单项，访问无权限路由时显示 403 页面。
 
+**v2 更新**：支持认证（Authentication）与授权（Authorization）分离配置，可独立控制"跳过 SSO 登录"和"跳过菜单权限校验"。
+
+## 核心概念
+
+### 认证 vs 授权
+
+| 概念 | 英文 | 作用 | 配置项 |
+| --- | --- | --- | --- |
+| 认证 | Authentication | 确认用户身份（是否登录） | `noAuthRouteList` |
+| 授权 | Authorization | 确认用户权限（能否访问） | `noPermissionRouteList` |
+
+### 四种路由场景
+
+| 场景 | noAuthRouteList | noPermissionRouteList | 示例 |
+| --- | --- | --- | --- |
+| 公开页面 | ✅ | ✅ | 首页、活动页 |
+| 登录后公共页面 | ❌ | ✅ | 个人设置、帮助中心 |
+| 需要权限的页面 | ❌ | ❌ | 后台管理、业务功能 |
+| 登录页等特殊页面 | ✅ | ✅ | /user/login、/403 |
+
 ## 技术方案
 
 ### 技术栈
@@ -14,24 +35,68 @@
 - UI 组件：Arco Design (Result 组件)
 - 状态管理：Umi initialState
 
-### 核心实现
+### 权限控制流程
 
-1. 用户信息接口返回 `side_menus` 字段（白名单）
-2. `filterMenuItems` 根据白名单过滤菜单项
-3. Layout 组件对比"所有路由"和"有权限路由"判断 403
-4. 无权限时在 Layout 内直接渲染 403 组件（无跳转）
+```
+用户访问路由
+    │
+    ▼
+┌─────────────────────────────────┐
+│  1. SSO 认证检查 (app.tsx)       │
+│     isNoAuthRoute(pathname)?    │
+│     ├── 是 → 跳过 SSO           │
+│     └── 否 → 执行 ensureSsoSession()
+└─────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────┐
+│  2. 权限校验 (layouts/index.tsx) │
+│     isNoPermissionRoute(pathname)?
+│     ├── 是 → 跳过权限校验        │
+│     └── 否 → 检查 side_menus    │
+│              ├── 有权限 → 正常渲染
+│              └── 无权限 → 显示 403
+└─────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────┐
+│  3. 菜单渲染 (menu/index.tsx)    │
+│     isNoPermissionRoute(pathname)?
+│     ├── 是 → 显示全部菜单        │
+│     └── 否 → 按 side_menus 过滤  │
+└─────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────┐
+│  4. 子应用加载 (MicroAppLoader)  │
+│     isNoPermissionRoute(pathname)?
+│     ├── 是 → 直接加载           │
+│     └── 否 → 等待 currentUser   │
+└─────────────────────────────────┘
+```
 
-### 权限判断逻辑
+### 权限判断逻辑（详细）
 
 ```
 用户访问 /some-path
-    ↓
+    │
+    ▼
+是否 disableAuth === true？
+    ├── 是 → 允许所有访问（调试模式）
+    │
+    ▼
+是否在 noPermissionRouteList 中？
+    ├── 是 → 允许访问，显示全部菜单
+    │
+    ▼
 是否是超级用户？
     ├── 是 → 允许访问所有菜单
-    └── 否 → 检查 side_menus 白名单
-              ├── 精确匹配：menuPath === side_menus[i]
-              ├── 前缀匹配：side_menus[i].startsWith(menuPath + '.')
-              └── 都不匹配 → 禁止访问，显示 403
+    │
+    ▼
+检查 side_menus 白名单
+    ├── 精确匹配：menuPath === side_menus[i]
+    ├── 前缀匹配：side_menus[i].startsWith(menuPath + '.')
+    └── 都不匹配 → 禁止访问，显示 403
 ```
 
 ## 文件清单
@@ -39,20 +104,59 @@
 ### 新增文件
 
 | 文件路径 | 说明 |
-|----------|------|
+| --- | --- |
 | `src/pages/403/index.tsx` | 403 无权限页面组件 |
 
 ### 修改文件
 
 | 文件路径 | 修改内容 |
-|----------|----------|
+| --- | --- |
+| `src/common/menu/types.ts` | 新增 `noPermissionRouteList` 类型定义 |
+| `src/constants/index.ts` | 新增 `isNoPermissionRoute`、`getNoPermissionRouteList` 函数 |
 | `src/common/menu/parser.ts` | 新增 `filterMenuItems`、`isMenuAllowed` 等权限过滤函数 |
-| `src/layouts/index.tsx` | 新增 `isForbidden` 判断和 403 渲染逻辑 |
-| `src/layouts/components/menu/index.tsx` | 集成菜单过滤 |
+| `src/layouts/index.tsx` | 新增 `isForbidden` 判断，集成 `isNoPermissionRoute` |
+| `src/layouts/components/menu/index.tsx` | 集成菜单过滤，支持免权限校验路由 |
+| `src/components/MicroAppLoader/index.tsx` | 集成 `isNoPermissionRoute`，免权限路由直接加载 |
+| `src/app.tsx` | SSO 认证检查，使用 `isNoAuthRoute` |
 | `config/routes.ts` | 新增 `/403` 路由 |
 
 ## API / 组件接口
 
+### Window 配置
+
+```typescript
+interface Window {
+  __MICO_CONFIG__?: {
+    /**
+     * 免认证路由列表（跳过 SSO 登录）
+     * 支持精确匹配和前缀匹配（以 /* 结尾）
+     */
+    noAuthRouteList?: string[];
+    /**
+     * 免权限校验路由列表（跳过菜单权限检查）
+     * 支持精确匹配和前缀匹配（以 /* 结尾）
+     * 注意：如果同时需要跳过 SSO，需同时配置 noAuthRouteList
+     */
+    noPermissionRouteList?: string[];
+    /** 关闭权限控制（菜单全部显示，路由不校验权限） */
+    disableAuth?: boolean;
+  };
+}
+```
+
+### 路由判断函数
+
+```typescript
+// 判断是否为免认证路由（跳过 SSO）
+function isNoAuthRoute(pathname: string): boolean;
+
+// 判断是否为免权限校验路由（跳过菜单权限检查）
+function isNoPermissionRoute(pathname: string): boolean;
+
+// 判断是否关闭权限控制
+function isAuthDisabled(): boolean;
+```
+
 ### MenuFilterOptions
 
 ```typescript
@@ -77,26 +181,6 @@ function filterMenuItems(
 ): MenuItem[];
 ```
 
-**参数说明**：
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| items | MenuItem[] | 是 | 原始菜单数据 |
-| options | MenuFilterOptions | 否 | 过滤选项 |
-| parentPath | string | 否 | 父级路径（递归用） |
-
-### isRouteAllowed
-
-```typescript
-/**
- * 检查路由是否允许访问
- */
-function isRouteAllowed(
-  menuPath: string,
-  options?: MenuFilterOptions,
-): boolean;
-```
-
 ### 用户信息相关字段
 
 ```typescript
@@ -111,14 +195,45 @@ interface IUserInfo {
 
 ## 使用示例
 
-### 用户信息接口返回
+### 配置免认证+免权限路由
+
+```javascript
+// config/config.dev.ts
+window.__MICO_CONFIG__ = {
+  // 免认证路由（跳过 SSO 登录）
+  noAuthRouteList: [
+    '/',
+    '/subapp',
+    '/public/*',  // 前缀匹配
+  ],
+  // 免权限校验路由（跳过菜单权限检查）
+  noPermissionRouteList: [
+    '/',
+    '/subapp',
+    '/settings',  // 登录后的公共页面
+  ],
+  disableAuth: false,
+};
+```
 
-```json
-{
-  "is_superuser": false,
-  "side_menus": ["列队管理.配置队列", "工作台"],
-  "miss_permissions": ["列队管理.配置队列.查看"]
-}
+### 静态配置（代码中）
+
+```typescript
+// src/constants/index.ts
+
+// 静态免认证路由（始终生效）
+export const NO_AUTH_ROUTE_LIST: string[] = [
+  '/user/login',
+  '/user/register',
+  '/403',
+  '/404',
+];
+
+// 静态免权限校验路由（始终生效）
+export const NO_PERMISSION_ROUTE_LIST: string[] = [
+  '/403',
+  '/404',
+];
 ```
 
 ### 菜单过滤结果
@@ -138,38 +253,57 @@ interface IUserInfo {
 ```tsx
 // layouts/index.tsx
 const isForbidden = useMemo(() => {
-  if (currentRoute) return false; // 在有权限的路由中找到了
+  // 关闭权限控制时，不校验权限
+  if (isAuthDisabled()) return false;
+  // 免权限校验路由，不检查菜单权限
+  if (isNoPermissionRoute(location.pathname)) return false;
+  // 如果在有权限的路由中找到了，说明有权限
+  if (currentRoute) return false;
+  // 在所有路由中存在但无权限
   const routeInAll = findRouteByPath(allRoutes, location.pathname);
-  return !!routeInAll; // 在所有路由中存在但无权限
+  return !!routeInAll;
 }, [currentRoute, allRoutes, location.pathname]);
+```
 
-const renderContent = () => {
-  if (isForbidden) {
-    return <ForbiddenPage />;
-  }
-  // ... 正常渲染
-};
+### MicroAppLoader 中的认证判断
+
+```tsx
+// components/MicroAppLoader/index.tsx
+const isAuthReady =
+  isAuthDisabled() ||
+  isNoPermissionRoute(location.pathname) ||
+  !!initialState?.currentUser;
+
+// 未准备好时不加载子应用
+if (!isAuthReady) {
+  return; // 继续等待
+}
 ```
 
 ## 设计决策
 
 | 决策点 | 选择 | 理由 |
-|--------|------|------|
+| --- | --- | --- |
+| 认证与授权分离 | 两个独立配置项 | 不同场景需要不同组合，如"需要登录但不需要权限"的个人设置页 |
 | 权限模型 | 白名单 (`side_menus`) | 后端返回的 `side_menus` 是允许列表，比黑名单更安全 |
 | 403 处理 | 原地渲染组件 | 保持 URL 不变，用户体验更好，便于分享链接 |
 | 父级菜单显示 | 前缀匹配 | 子菜单有权限时，父级菜单需要作为容器显示 |
 | 超级用户 | 跳过所有检查 | 管理员需要完整访问权限 |
-| 权限管理菜单 | 硬编码禁止 | 非超级用户不应看到权限管理入口 |
+| 免权限路由的菜单 | 显示全部 | 用户访问公开页面时应能看到所有导航选项 |
+| 免权限路由的子应用 | 直接加载 | 不等待 currentUser，避免加载卡住 |
 
 ## 注意事项
 
+- `noAuthRouteList` 和 `noPermissionRouteList` 是独立的，需要根据场景分别配置
+- 两个列表都支持 `/*` 后缀进行前缀匹配
 - `side_menus` 为空时，非超级用户没有任何菜单权限
 - `side_menus` 格式为菜单路径，如 `"列队管理.配置队列"`
 - `miss_permissions` 用于按钮级别权限控制，不影响菜单显示
 - 403 页面在 Layout 内渲染，不会触发路由跳转
 - 调试时可在控制台搜索 `isForbidden check` 查看权限判断日志
+- **常见问题**：配置了 `noAuthRouteList` 但页面仍显示 403，需同时配置 `noPermissionRouteList`
 
 ## 相关文档
 
 - [微前端模式](./feature-微前端模式.md) - 路由和菜单解析
-- [用户信息接口](./feature-用户信息接口.md) - 用户数据结构
+- [日志与常量](./arch-日志与常量.md) - 常量管理

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

@@ -10,15 +10,18 @@ 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 {
   clearMicroAppProps,
   type IMicroAppProps,
   setMicroAppProps,
 } from './common/micro';
+import {
+  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 './global.less';
 
 // ==================== qiankun 全局错误处理 ====================
@@ -110,10 +113,10 @@ export async function getInitialState(): Promise<{
   };
 
   const { location } = history;
-  const isNoAuthRoute = NO_AUTH_ROUTE_LIST.includes(location.pathname);
+  const noAuthRoute = isNoAuthRoute(location.pathname);
 
   // 非免认证路由：走 SSO 流程
-  if (!isNoAuthRoute) {
+  if (!noAuthRoute) {
     await ensureSsoSession();
   }
 
@@ -128,6 +131,15 @@ export async function getInitialState(): Promise<{
     }
   }
 
+  // 非免认证路由且没有 token，跳转到 SSO 登录
+  if (!noAuthRoute) {
+    handleAuthFailureRedirect();
+    // 返回空状态，页面会被重定向
+    return {
+      fetchUserInfo: fetchUserInfoFn,
+    };
+  }
+
   return {
     fetchUserInfo: fetchUserInfoFn,
   };

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

@@ -157,6 +157,21 @@ declare global {
       apiBaseUrl?: string;
       /** 默认重定向路径，访问 "/" 时自动跳转到此路径 */
       defaultPath?: string;
+      /**
+       * 免认证路由列表（跳过 SSO 登录）
+       * 支持精确匹配和前缀匹配（以 /* 结尾）
+       */
+      noAuthRouteList?: string[];
+      /**
+       * 免权限校验路由列表（跳过菜单权限检查）
+       * 支持精确匹配和前缀匹配（以 /* 结尾）
+       * 注意：如果同时需要跳过 SSO，需同时配置 noAuthRouteList
+       */
+      noPermissionRouteList?: string[];
+      /** 动态配置的不显示布局路由列表，支持精确匹配和前缀匹配（以 /* 结尾） */
+      noLayoutRouteList?: string[];
+      /** 关闭权限控制（菜单全部显示，路由不校验权限） */
+      disableAuth?: boolean;
       [key: string]: unknown;
     };
     __MICO_WORKSPACE__?: WorkspaceConfig | null;

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

@@ -16,7 +16,7 @@
 
 import { request as rawRequest } from '@umijs/max';
 import { setStoredAuthToken } from '../auth/auth-manager';
-import { NO_AUTH_ROUTE_LIST } from '@/constants';
+import { isNoAuthRoute } from '@/constants';
 
 // 配置相关
 import {
@@ -64,7 +64,7 @@ initDefaultInterceptors(isFetchingToken, addToPendingQueue);
  * 判断当前路由是否跳过认证
  */
 const shouldSkipAuth = (): boolean => {
-  return NO_AUTH_ROUTE_LIST.includes(location.pathname);
+  return isNoAuthRoute(location.pathname);
 };
 
 /**

package/generators/micro-react/templates/apps/layout/src/components/AppTabs/index.tsx

@@ -1,5 +1,5 @@
 import { findRouteByPath } from '@/common/menu';
-import { NO_AUTH_ROUTE_LIST } from '@/constants';
+import { isNoLayoutRoute } from '@/constants';
 import useMenu from '@/hooks/useMenu';
 import { Tabs } from '@arco-design/web-react';
 import { history, useLocation } from '@umijs/max';
@@ -47,7 +47,7 @@ function AppTabs() {
   const [tabs, setTabs] = useState<TabItem[]>([]);
 
   const showTabs = useMemo(() => {
-    return !NO_AUTH_ROUTE_LIST.includes(location.pathname);
+    return !isNoLayoutRoute(location.pathname);
   }, [location.pathname]);
 
   const microAppPrefixes = useMemo(() => {

package/generators/micro-react/templates/apps/layout/src/components/MicroAppLoader/index.tsx

@@ -1,8 +1,9 @@
 import { getAuthInfo } from '@/common/auth/auth-manager';
 import { EEnv, getEnv } from '@/common/env';
 import { request } from '@/common/request';
+import { isAuthDisabled, isNoPermissionRoute } from '@/constants';
 import { Spin } from '@arco-design/web-react';
-import { useModel } from '@umijs/max';
+import { useLocation, useModel } from '@umijs/max';
 import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import './index.less';
 import { microAppManager, type MicroAppState } from './micro-app-manager';
@@ -45,8 +46,13 @@ const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
   });
 
   // 获取 initialState，等待用户信息准备好再加载子应用
+  // disableAuth 模式或免权限校验路由下跳过等待
   const { initialState } = useModel('@@initialState');
-  const isAuthReady = !!initialState?.currentUser;
+  const location = useLocation();
+  const isAuthReady =
+    isAuthDisabled() ||
+    isNoPermissionRoute(location.pathname) ||
+    !!initialState?.currentUser;
 
   const appName = sanitizeId(name);
 

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

@@ -19,7 +19,7 @@ export const ROUTES = {
 } as const;
 
 /**
- * 无需认证的路由列表
+ * 无需认证的路由列表（静态配置）
  */
 export const NO_AUTH_ROUTE_LIST: string[] = [
   ROUTES.LOGIN,
@@ -29,12 +29,115 @@ export const NO_AUTH_ROUTE_LIST: string[] = [
   ROUTES.NOT_FOUND,
 ];
 
+/**
+ * 获取合并后的免鉴权路由列表
+ * 合并静态常量 + window.__MICO_CONFIG__.noAuthRouteList
+ */
+export const getNoAuthRouteList = (): string[] => {
+  const dynamicRoutes = window.__MICO_CONFIG__?.noAuthRouteList ?? [];
+  return [...new Set([...NO_AUTH_ROUTE_LIST, ...dynamicRoutes])];
+};
+
+/**
+ * 判断路径是否匹配路由列表（支持精确匹配和前缀匹配）
+ * @param pathname - 当前路由路径
+ * @param routes - 路由列表
+ * @returns 是否匹配
+ */
+const matchRouteList = (pathname: string, routes: string[]): boolean => {
+  return routes.some((route) => {
+    // 前缀匹配：/public/* 匹配 /public/xxx
+    if (route.endsWith('/*')) {
+      const prefix = route.slice(0, -1); // 去掉末尾的 *，保留 /
+      return pathname.startsWith(prefix) || pathname === prefix.slice(0, -1);
+    }
+    // 精确匹配
+    return pathname === route;
+  });
+};
+
+/**
+ * 判断指定路径是否为免认证路由（跳过 SSO 登录）
+ * 支持精确匹配和前缀匹配（以 /* 结尾的模式）
+ * @param pathname - 当前路由路径
+ * @returns 是否免认证
+ */
+export const isNoAuthRoute = (pathname: string): boolean => {
+  return matchRouteList(pathname, getNoAuthRouteList());
+};
+
+/**
+ * 免权限校验的路由列表（静态配置）
+ * 这些路由不检查菜单权限，但仍可能需要登录
+ */
+export const NO_PERMISSION_ROUTE_LIST: string[] = [
+  ROUTES.FORBIDDEN,
+  ROUTES.NOT_FOUND,
+];
+
+/**
+ * 获取合并后的免权限校验路由列表
+ * 合并静态常量 + window.__MICO_CONFIG__.noPermissionRouteList
+ */
+export const getNoPermissionRouteList = (): string[] => {
+  const dynamicRoutes = window.__MICO_CONFIG__?.noPermissionRouteList ?? [];
+  return [...new Set([...NO_PERMISSION_ROUTE_LIST, ...dynamicRoutes])];
+};
+
+/**
+ * 判断指定路径是否为免权限校验路由（跳过菜单权限检查）
+ * 支持精确匹配和前缀匹配（以 /* 结尾的模式）
+ * @param pathname - 当前路由路径
+ * @returns 是否免权限校验
+ */
+export const isNoPermissionRoute = (pathname: string): boolean => {
+  return matchRouteList(pathname, getNoPermissionRouteList());
+};
+
+/**
+ * 不显示布局的路由列表（静态配置）
+ * 注意：403/404 保留布局，方便用户通过导航返回
+ */
+export const NO_LAYOUT_ROUTE_LIST: string[] = [
+  ROUTES.LOGIN,
+  ROUTES.REGISTER,
+  ROUTES.REGISTER_RESULT,
+];
+
+/**
+ * 获取合并后的不显示布局路由列表
+ * 合并静态常量 + window.__MICO_CONFIG__.noLayoutRouteList
+ */
+export const getNoLayoutRouteList = (): string[] => {
+  const dynamicRoutes = window.__MICO_CONFIG__?.noLayoutRouteList ?? [];
+  return [...new Set([...NO_LAYOUT_ROUTE_LIST, ...dynamicRoutes])];
+};
+
+/**
+ * 判断指定路径是否不显示布局
+ * 支持精确匹配和前缀匹配（以 /* 结尾的模式）
+ * @param pathname - 当前路由路径
+ * @returns 是否不显示布局
+ */
+export const isNoLayoutRoute = (pathname: string): boolean => {
+  return matchRouteList(pathname, getNoLayoutRouteList());
+};
+
+/**
+ * 判断是否关闭权限控制
+ * 关闭后：菜单全部显示，路由不校验权限
+ * @returns 是否关闭权限控制
+ */
+export const isAuthDisabled = (): boolean => {
+  return window.__MICO_CONFIG__?.disableAuth === true;
+};
+
 /**
  * 主题相关常量
  */
 export const THEME = {
   /** localStorage 存储键 */
-  STORAGE_KEY: 'audit-center-theme',
+  STORAGE_KEY: '<%= ProjectName %>-theme',
   /** 默认主题 */
   DEFAULT: 'light' as const,
   /** 可选主题值 */
@@ -46,9 +149,9 @@ export const THEME = {
  */
 export const TIMEZONE = {
   /** localStorage 存储键（IANA 时区，如 Asia/Shanghai） */
-  STORAGE_KEY: 'audit-center-timezone',
+  STORAGE_KEY: '<%= ProjectName %>-timezone',
   /** localStorage 存储键（用于展示的地区/名称，可选） */
-  REGION_STORAGE_KEY: 'audit-center-timezone-region',
+  REGION_STORAGE_KEY: '<%= ProjectName %>-timezone-region',
 } as const;
 
 /**
@@ -56,7 +159,7 @@ export const TIMEZONE = {
  */
 export const PRESENCE = {
   /** localStorage 存储键 */
-  STORAGE_KEY: 'audit-center-presence-status',
+  STORAGE_KEY: '<%= ProjectName %>-presence-status',
 } as const;
 
 /**

package/generators/micro-react/templates/apps/layout/src/hooks/useRoutePermissionRefresh.ts

@@ -1,7 +1,7 @@
 import { useLocation, useModel } from '@umijs/max';
 import { useEffect, useRef, useState } from 'react';
 import { layoutLogger } from '@/common/logger';
-import { NO_AUTH_ROUTE_LIST } from '@/constants';
+import { isNoAuthRoute } from '@/constants';
 
 /**
  * 路由切换时自动刷新用户权限
@@ -39,7 +39,7 @@ export function useRoutePermissionRefresh() {
     prevPathRef.current = location.pathname;
 
     // 免认证路由不需要刷新
-    if (NO_AUTH_ROUTE_LIST.includes(location.pathname)) {
+    if (isNoAuthRoute(location.pathname)) {
       return;
     }
 

package/generators/micro-react/templates/apps/layout/src/layouts/components/header/index.tsx

@@ -57,7 +57,7 @@ const LayoutHeader: React.FC = () => {
       {/* Logo */}
       <div className="layout-header-logo">
         <span className="logo-text">
-          {window.__MICO_MENUS__?.appName || 'Mico CENTER'}
+          {window.__MICO_MENUS__?.appName || '<%= projectName %>'}
         </span>
       </div>
 

package/generators/micro-react/templates/apps/layout/src/layouts/components/menu/index.tsx

@@ -1,11 +1,12 @@
 import type { ParsedMenuItem } from '@/common/menu';
 import { filterMenuItems, getWindowMenus, parseMenuItems } from '@/common/menu';
+import { isAuthDisabled, isNoPermissionRoute } from '@/constants';
 import IconFont from '@/components/IconFont';
 import { useMenuState } from '@/hooks/useMenuState';
 import { useTheme } from '@/hooks/useTheme';
 import { Layout, Menu } from '@arco-design/web-react';
 import * as Icons from '@arco-design/web-react/icon';
-import { useModel } from '@umijs/max';
+import { useLocation, useModel } from '@umijs/max';
 import React, { useEffect, useMemo, useRef } from 'react';
 import './index.less';
 
@@ -103,19 +104,24 @@ interface LayoutMenuProps {
 const LayoutMenu: React.FC<LayoutMenuProps> = () => {
   const siderRef = useRef<HTMLDivElement>(null);
   const { isDark } = useTheme();
+  const location = useLocation();
 
   const { initialState } = useModel('@@initialState');
   const currentUser = initialState?.currentUser;
 
   // Parse menu data
+  // disableAuth 或免权限校验路由时不过滤，显示全部菜单
   const menuItems = useMemo(() => {
     const menus = getWindowMenus();
+    if (isAuthDisabled() || isNoPermissionRoute(location.pathname)) {
+      return parseMenuItems(menus);
+    }
     const filteredMenus = filterMenuItems(menus, {
       isSuperuser: currentUser?.is_superuser,
       sideMenus: (currentUser?.side_menus || []) as string[],
     });
     return parseMenuItems(filteredMenus);
-  }, [currentUser?.is_superuser, currentUser?.side_menus]);
+  }, [currentUser?.is_superuser, currentUser?.side_menus, location.pathname]);
 
   // 使用菜单状态 Hook
   const {

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

@@ -8,7 +8,11 @@ import {
 import { getAppNameFromEntry } from '@/common/micro';
 import AppTabs from '@/components/AppTabs';
 import MicroAppLoader from '@/components/MicroAppLoader';
-import { NO_AUTH_ROUTE_LIST } from '@/constants';
+import {
+  isAuthDisabled,
+  isNoLayoutRoute,
+  isNoPermissionRoute,
+} from '@/constants';
 import { useRoutePermissionRefresh } from '@/hooks/useRoutePermissionRefresh';
 import ForbiddenPage from '@/pages/403';
 import { Layout, Spin } from '@arco-design/web-react';
@@ -48,20 +52,27 @@ const BasicLayout: React.FC = () => {
     return extractRoutes(menus);
   }, []);
 
-  // 有权限的路由
+  // 有权限的路由（disableAuth 时不过滤，显示全部）
   const allowedRoutes = useMemo(() => {
+    if (isAuthDisabled()) {
+      return allRoutes;
+    }
     const menus = getWindowMenus();
     const filteredMenus = filterMenuItems(menus, filterOptions);
     return extractRoutes(filteredMenus);
-  }, [filterOptions]);
+  }, [filterOptions, allRoutes]);
 
   // 查找当前路由配置（优先从有权限的路由中查找）
   const currentRoute = useMemo(() => {
     return findRouteByPath(allowedRoutes, location.pathname);
   }, [allowedRoutes, location.pathname]);
 
-  // 判断是否是动态路由但无权限
+  // 判断是否是动态路由但无权限（disableAuth 时始终返回 false）
   const isForbidden = useMemo(() => {
+    // 关闭权限控制时，不校验权限
+    if (isAuthDisabled()) return false;
+    // 免权限校验路由，不检查菜单权限
+    if (isNoPermissionRoute(location.pathname)) return false;
     // 如果在有权限的路由中找到了，说明有权限
     if (currentRoute) return false;
     // 如果在所有路由中也找不到，说明不是动态路由，交给 Umi 处理
@@ -83,7 +94,7 @@ const BasicLayout: React.FC = () => {
   }, [currentRoute, allRoutes, allowedRoutes, location.pathname, filterOptions]);
 
   // 判断是否需要显示布局
-  const showLayout = !NO_AUTH_ROUTE_LIST.includes(location.pathname);
+  const showLayout = !isNoLayoutRoute(location.pathname);
 
   // 渲染页面内容
   const renderContent = () => {

package/generators/micro-react/templates/apps/layout/src/services/user.ts

@@ -17,6 +17,7 @@ export interface IUserInfoResponse {
 export async function fetchUserInfo(): Promise<IUserInfo> {
   const response = await request<IUserInfoResponse>(USER_INFO_API, {
     method: 'GET',
+    skipProxy: true,
   });
   if (response.code === 200 && response.data) {
     return response.data;

package/generators/subapp-react/index.js

@@ -177,12 +177,21 @@ module.exports = class extends Generator {
     }
   }
 
+  install() {
+    this.log('');
+    this.log('📦 正在安装依赖...');
+    this.spawnCommandSync('pnpm', ['install'], {
+      cwd: this.monorepoRoot
+    });
+  }
+
   end() {
     this.log('');
     this.log('✅ 子应用创建成功！');
     this.log('');
+    this.log('   后续步骤:');
+    this.log('');
     this.log(`   cd apps/${this.appName}`);
-    this.log('   pnpm install');
     this.log('   pnpm dev');
     this.log('');
   }

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

@@ -1,7 +1,6 @@
 // https://umijs.org/config/
 
 import { defineConfig } from '@umijs/max';
-const { CDN_PUBLIC_PATH } = process.env;
 
 
 const config: ReturnType<typeof defineConfig> = {

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

@@ -1,7 +1,6 @@
 // https://umijs.org/config/
 
 import { defineConfig } from '@umijs/max';
-const { CDN_PUBLIC_PATH } = process.env;
 
 
 const config: ReturnType<typeof defineConfig> = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generator-mico-cli",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "Yeoman generator for Mico CLI projects",
   "keywords": [
     "yeoman-generator",