generator-mico-cli 0.2.21 → 0.2.22

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

@@ -1,15 +1,82 @@
-import { getIntl } from '@umijs/max';
-import { isAuthDisabled, isNoPermissionRoute } from '@/constants';
-import type { MenuItem, ParsedMenuItem, ParsedRoute } from './types';
 import { getCurrentLocale, LOCALE } from '@/common/locale';
+import { getMenuPage, getPages } from '@/common/portal-data';
+import { isAuthDisabled, isNoPermissionRoute } from '@/constants';
+import { getIntl } from '@umijs/max';
+import type {
+  MenuItem,
+  ParsedMenuItem,
+  ParsedRoute,
+  PublicPageItem,
+} from './types';
+
+/**
+ * 从页面数据提取路由配置
+ */
+export const extractRoutesFromPages = (
+  pages: PublicPageItem[],
+): ParsedRoute[] => {
+  return pages
+    .filter((page) => page.enabled)
+    .map((page) => {
+      const hasEntry = page.htmlUrl || (page.jsUrls && page.jsUrls.length > 0);
+      return {
+        path: page.route,
+        name: page.name,
+        icon: '',
+        loadType: (hasEntry ? 'microapp' : 'internal') as
+          | 'internal'
+          | 'microapp',
+        entry: page.htmlUrl || page.jsUrls?.[0] || undefined,
+      };
+    });
+};
 
 /**
- * 获取 window 上挂载的菜单数据
+ * 获取动态路由（从 __MICO_PAGES__）
  */
-export const getWindowMenus = (): MenuItem[] => {
-  if (typeof window === 'undefined') return [];
-  const menus = window.__MICO_MENUS__;
-  return Array.isArray(menus) ? menus : [];
+export const getDynamicRoutes = (): ParsedRoute[] => {
+  return extractRoutesFromPages(getPages());
+};
+
+/**
+ * 根据路径查找对应的页面配置
+ * 匹配逻辑与 findRouteByPath 一致（精确匹配 + 通配符匹配）
+ */
+/**
+ * 判断指定路径的页面是否为免认证页面
+ * 当 accessControlEnabled === false 时，跳过 SSO 认证和权限校验
+ */
+export const isPageAuthFree = (pathname: string): boolean => {
+  const page = findPageByPath(getPages(), pathname);
+  return page?.accessControlEnabled === false;
+};
+
+export const findPageByPath = (
+  pages: PublicPageItem[],
+  pathname: string,
+): PublicPageItem | undefined => {
+  let exact: PublicPageItem | undefined;
+  let bestWildcard: { page: PublicPageItem; basePath: string } | undefined;
+
+  for (const page of pages) {
+    if (!page.enabled) continue;
+
+    if (page.route === pathname) {
+      exact = page;
+      continue;
+    }
+
+    if (page.route.endsWith('/*')) {
+      const basePath = page.route.slice(0, -2);
+      if (pathname === basePath || pathname.startsWith(`${basePath}/`)) {
+        if (!bestWildcard || basePath.length > bestWildcard.basePath.length) {
+          bestWildcard = { page, basePath };
+        }
+      }
+    }
+  }
+
+  return exact || bestWildcard?.page;
 };
 
 export interface MenuFilterOptions {
@@ -19,7 +86,7 @@ export interface MenuFilterOptions {
   sideMenus?: string[];
 }
 
-const isSuperuserUser = (value?: boolean | number): boolean => {
+export const isSuperuserUser = (value?: boolean | number): boolean => {
   return value === true || value === 1;
 };
 
@@ -67,12 +134,12 @@ const isMenuAllowed = (
   item: MenuItem,
   options: MenuFilterOptions,
 ): boolean => {
-
   // 关闭权限控制时，所有菜单都允许访问
   if (isAuthDisabled()) return true;
 
   // 免权限校验路由，始终允许访问
-  if (item.page?.route && isNoPermissionRoute(item.page.route)) {
+  const itemRoute = item.path ?? getMenuPage(item)?.route;
+  if (itemRoute && isNoPermissionRoute(itemRoute)) {
     return true;
   }
 
@@ -155,15 +222,13 @@ export const filterMenuItems = (
  * 判断页面的加载类型
  * 有 htmlUrl 或 jsUrls 时使用 qiankun 微应用加载
  */
-const getLoadType = (page: MenuItem['page']): 'internal' | 'microapp' => {
+const getLoadType = (
+  page: PublicPageItem | null | undefined,
+): 'internal' | 'microapp' => {
   if (!page) return 'internal';
-
-  // 有 htmlUrl 或 jsUrls 使用 qiankun 微应用加载
   if (page.htmlUrl || (page.jsUrls && page.jsUrls.length > 0)) {
     return 'microapp';
   }
-
-  // 否则使用内部路由
   return 'internal';
 };
 
@@ -171,7 +236,9 @@ const getLoadType = (page: MenuItem['page']): 'internal' | 'microapp' => {
  * 获取微应用入口 URL
  * 优先使用 htmlUrl，其次使用 jsUrls[0]
  */
-const getEntry = (page: MenuItem['page']): string | undefined => {
+const getEntry = (
+  page: PublicPageItem | null | undefined,
+): string | undefined => {
   if (!page) return undefined;
   return page.htmlUrl || page.jsUrls?.[0] || undefined;
 };
@@ -197,17 +264,19 @@ export const extractRoutes = (
 
     const menuPath = buildMenuPath(parentPath, getMenuIdentifierDefault(item));
 
-    if (item.type === 'page' && item.page && item.page.enabled) {
-      const loadType = getLoadType(item.page);
-      routes.push({
-        path: item.page.route,
-        name: item.name,
-        nameEn: item.nameEn,
-        icon: item.icon,
-        loadType,
-        entry: getEntry(item.page),
-        pageConfig: item.page,
-      });
+    if (item.type === 'page' && item.pageId) {
+      const page = getMenuPage(item);
+      if (page && page.enabled) {
+        routes.push({
+          path: page.route,
+          name: item.name,
+          nameEn: item.nameEn,
+          icon: item.icon,
+          loadType: getLoadType(page),
+          entry: getEntry(page),
+          pageConfig: page,
+        });
+      }
     }
 
     if (item.children && item.children.length > 0) {
@@ -219,18 +288,25 @@ export const extractRoutes = (
 };
 
 /**
- * 获取菜单项的国际化名称
- * - 使用 key 作为 intl key 查找翻译
- * - 如果 intl 中没有对应的 key，则使用 fallbackName 作为兜底
- * - 如果没有传入 fallbackName，则使用 key 本身作为兜底
- *
- * @param key 国际化 key
- * @param fallbackName 保底名称（可选，默认使用 key）
- * @returns 翻译后的菜单名称
+ * 获取菜单项的显示名称
+ * 优先级：name/nameEn > nameKey（走 intl 国际化） > 兜底 name
  */
-export const getMenuLabel = (key: string, fallbackName?: string): string => {
-  const intl = getIntl();
-  return intl.formatMessage({ id: key, defaultMessage: fallbackName ?? key });
+export const getMenuLabel = (
+  fields: { name?: string; nameEn?: string; nameKey?: string },
+  isChinese: boolean,
+): string => {
+  const directName = isChinese ? fields.name : fields.nameEn;
+  if (directName) return directName;
+
+  if (fields.nameKey) {
+    const intl = getIntl();
+    return intl.formatMessage({
+      id: fields.nameKey,
+      defaultMessage: fields.nameKey,
+    });
+  }
+
+  return fields.name || '';
 };
 
 /**
@@ -244,18 +320,17 @@ export const parseMenuItems = (items: MenuItem[]): ParsedMenuItem[] => {
     .filter((item) => item.enabled)
     .sort((a, b) => a.sortOrder - b.sortOrder)
     .map((item) => {
-      const name = getMenuIdentifier(item, isChinese);
       const parsed: ParsedMenuItem = {
         key: String(item.id),
-        label: item.nameKey ? getMenuLabel(item.nameKey, name) : name,
+        label: getMenuLabel(item, isChinese),
         icon: item.icon,
         type: item.type,
       };
 
       if (item.type === 'link' && item.path) {
         parsed.path = item.path;
-      } else if (item.type === 'page' && item.page) {
-        parsed.path = item.page.route;
+      } else if (item.type === 'page') {
+        parsed.path = item.path ?? getMenuPage(item)?.route;
       }
 
       if (item.children && item.children.length > 0) {

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

@@ -30,6 +30,10 @@ export interface PageConfig {
   routeMode: PageRouteMode;
   /** 是否仅超级管理员可见 */
   adminOnly?: boolean;
+  /** 是否开启权限控制 */
+  accessControlEnabled: boolean;
+  /** 路由权限标识（用于匹配 sideMenus） */
+  routeKey: string | null;
   /** 关联的主文档 ID */
   mainDocumentId: number;
   /** 所属工作空间子域名 */
@@ -46,6 +50,15 @@ export interface PageConfig {
   updatedAt: string;
 }
 
+/**
+ * 公共页面配置 - 从 window.__MICO_PAGES__ 获取
+ * PageConfig 的子集，用于动态路由注册和页面级权限控制
+ */
+export type PublicPageItem = Omit<
+  PageConfig,
+  'workspaceSubdomain' | 'publishedBy' | 'versions' | 'createdAt' | 'updatedAt'
+>;
+
 /**
  * 菜单项类型
  */
@@ -67,8 +80,6 @@ export interface MenuItem {
   enabled: boolean;
   sortOrder: number;
   pageId: number | null;
-  /** 页面配置（type=page 时存在） */
-  page: PageConfig | null;
   /** 是否仅超级管理员可见 */
   adminOnly?: boolean;
   children: MenuItem[];
@@ -91,7 +102,7 @@ export interface ParsedRoute {
   /** 微应用入口 URL (htmlUrl 或 jsUrls[0]) */
   entry?: string;
   /** 原始页面配置 */
-  pageConfig?: PageConfig;
+  pageConfig?: PublicPageItem;
 }
 
 /**
@@ -111,7 +122,7 @@ export interface ParsedMenuItem {
  */
 export interface MicroAppProps {
   /** 主应用标识 */
-  mainApp: '<%= projectName %>';
+  mainApp: 'common-web';
   /** 共享的 request 实例，子应用可直接使用 */
   request: <T = any>(url: string, options?: any) => Promise<T>;
 }
@@ -132,6 +143,8 @@ export type WorkspaceStatus = 'active' | 'inactive' | 'pending';
 export interface WorkspaceConfig {
   /** 关联的应用 ID（可能为空） */
   appId: number | null;
+  /** CAS 服务端登录 URL，用于 SSO 外部登录跳转 */
+  casServerLoginUrl?: string;
   /** 创建时间 */
   createdAt: string;
   /** 创建者 ID */
@@ -165,10 +178,24 @@ export interface WorkspaceConfig {
  */
 declare global {
   interface Window {
+    __MICO_PAGES__?: PublicPageItem[];
     __MICO_MENUS__?: MenuItem[];
     __MICO_CONFIG__?: {
       appName?: string;
+      /** 站点/产品标题，用于登录页标题文案、logo alt 等 */
+      title?: string;
+      /** 登录页 logo 图片地址，不配置时使用应用内置 logo */
+      logo?: string;
+      appId?: string;
       apiBaseUrl?: string;
+      proxySuffix?: string;
+      loginEndpoint?: string;
+      refreshEndpoint?: string;
+      externalLoginPath?: string;
+      /** 请求客户端配置覆盖，与 config 中 defaultClientOptions 同名字段 */
+      defaultClientOptions?: Partial<
+        import('../request/types').RequestClientOptions
+      >;
       /** 默认重定向路径，访问 "/" 时自动跳转到此路径 */
       defaultPath?: string;
       /**

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

@@ -6,7 +6,8 @@
  */
 
 import { prefetchApps } from 'qiankun';
-import { extractRoutes, getWindowMenus } from './menu';
+import { extractRoutes } from './menu';
+import { getMenus } from './portal-data';
 import { getAppNameFromEntry } from './micro';
 
 /**
@@ -45,7 +46,7 @@ export const getMicroAppsForPrefetch = (
   excludeEntry?: string,
 ): Array<{ name: string; entry: string }> => {
   try {
-    const menus = getWindowMenus();
+    const menus = getMenus();
     const routes = extractRoutes(menus);
 
     return routes

package/generators/micro-react/templates/apps/layout/src/common/portal-data.ts

@@ -0,0 +1,45 @@
+/**
+ * 全局数据源管理
+ *
+ * 统一管理 window.__MICO_PAGES__ 和 window.__MICO_MENUS__ 的访问与索引。
+ * 数据由中台注入，每次直接从 window 读取（避免缓存导致时序问题）。
+ * pageId 索引惰性构建，数据就绪后缓存。
+ */
+import type { MenuItem, PublicPageItem } from './menu/types';
+
+/** 获取页面列表 (window.__MICO_PAGES__) */
+export const getPages = (): PublicPageItem[] => {
+  if (typeof window === 'undefined') return [];
+  return Array.isArray(window.__MICO_PAGES__) ? window.__MICO_PAGES__ : [];
+};
+
+/** 获取菜单树 (window.__MICO_MENUS__) */
+export const getMenus = (): MenuItem[] => {
+  if (typeof window === 'undefined') return [];
+  return Array.isArray(window.__MICO_MENUS__) ? window.__MICO_MENUS__ : [];
+};
+
+/** 是否有页面数据可用 */
+export const hasPages = (): boolean => {
+  return getPages().length > 0;
+};
+
+let _pageIdIndex: Map<number, PublicPageItem> | null = null;
+
+const getPageIdIndex = (): Map<number, PublicPageItem> => {
+  const pages = getPages();
+  if (!_pageIdIndex || (_pageIdIndex.size === 0 && pages.length > 0)) {
+    _pageIdIndex = new Map(pages.map((p) => [p.id, p]));
+  }
+  return _pageIdIndex;
+};
+
+/** 通过 pageId 查找页面（O(1)） */
+export const getPageById = (pageId: number): PublicPageItem | undefined => {
+  return getPageIdIndex().get(pageId);
+};
+
+/** 获取菜单项关联的页面 */
+export const getMenuPage = (item: MenuItem): PublicPageItem | undefined => {
+  return item.pageId ? getPageById(item.pageId) : undefined;
+};

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

@@ -1,20 +1,59 @@
 /**
  * 请求客户端配置管理
+ * appId 优先从 window.__MICO_WORKSPACE__ 获取；
+ * externalLoginPath 优先从 window.__MICO_WORKSPACE__.casServerLoginUrl 获取；
+ * 其余 defaultClientOptions / apiBaseUrl / proxySuffix / loginEndpoint / refreshEndpoint 优先从 window.__MICO_CONFIG__ 同名字段获取。
  */
 
 import { getStoredAuthToken } from '../auth/auth-manager';
 import type { RequestClientOptions, TokenResolver } from './types';
 
-const defaultClientOptions: RequestClientOptions = {
-  appId: process.env.APP_ID ?? '',
-  ticketParam: 'ticket',
-  logoutPath: '/logout',
-  apiBaseUrl: process.env.API_BASE_URL ?? '',
-  proxySuffix: process.env.PROXY_SUFFIX ?? '',
-  loginEndpoint: process.env.LOGIN_ENDPOINT ?? '',
-  refreshEndpoint: process.env.REFRESH_ENDPOINT ?? '',
-  externalLoginPath: process.env.EXTERNAL_LOGIN_PATH ?? '',
-};
+function getMicoConfig(): Window['__MICO_CONFIG__'] {
+  if (typeof window === 'undefined') return undefined;
+  return window.__MICO_CONFIG__;
+}
+
+function getMicoWorkspace(): Window['__MICO_WORKSPACE__'] {
+  if (typeof window === 'undefined') return undefined;
+  return window.__MICO_WORKSPACE__ ?? undefined;
+}
+
+function buildDefaultClientOptions(): RequestClientOptions {
+  const envDefaults: RequestClientOptions = {
+    appId: process.env.APP_ID ?? '',
+    ticketParam: 'ticket',
+    logoutPath: '/logout',
+    apiBaseUrl: process.env.API_BASE_URL ?? '',
+    proxySuffix: process.env.PROXY_SUFFIX ?? '',
+    loginEndpoint: process.env.LOGIN_ENDPOINT ?? '',
+    refreshEndpoint: process.env.REFRESH_ENDPOINT ?? '',
+    externalLoginPath: process.env.EXTERNAL_LOGIN_PATH ?? '',
+  };
+  const mico = getMicoConfig();
+  const workspace = getMicoWorkspace();
+  const appIdFromWorkspace =
+    workspace?.appId !== undefined && workspace?.appId !== null
+      ? String(workspace.appId)
+      : undefined;
+  const externalLoginFromWorkspace = workspace?.casServerLoginUrl;
+  if (!mico && !appIdFromWorkspace && !externalLoginFromWorkspace)
+    return envDefaults;
+  return {
+    ...envDefaults,
+    ...(mico?.defaultClientOptions ?? {}),
+    appId: appIdFromWorkspace ?? mico?.appId ?? envDefaults.appId,
+    apiBaseUrl: mico?.apiBaseUrl ?? envDefaults.apiBaseUrl,
+    proxySuffix: mico?.proxySuffix ?? envDefaults.proxySuffix,
+    loginEndpoint: mico?.loginEndpoint ?? envDefaults.loginEndpoint,
+    refreshEndpoint: mico?.refreshEndpoint ?? envDefaults.refreshEndpoint,
+    externalLoginPath:
+      externalLoginFromWorkspace ??
+      mico?.externalLoginPath ??
+      envDefaults.externalLoginPath,
+  };
+}
+
+const defaultClientOptions: RequestClientOptions = buildDefaultClientOptions();
 
 let clientOptions: RequestClientOptions = { ...defaultClientOptions };
 

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

@@ -68,7 +68,7 @@ export const runResponseInterceptors = async <T>(
 ): Promise<T> => {
   let current = response;
   for (const { handler } of responseInterceptors) {
-    current = await handler(current, ctx);
+    current = await handler(current, ctx) as T;
   }
   return current;
 };

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

@@ -7,6 +7,7 @@ import {
   maybePersistTokens,
   setStoredAuthToken,
 } from '@/common/auth/auth-manager';
+import { isPageAuthFree } from '@/common/menu';
 import { isNoAuthRoute, ROUTES } from '@/constants';
 import {
   getTicketParam,
@@ -37,6 +38,11 @@ export const handleAuthFailureRedirect = (): void => {
     return;
   }
 
+  if (isPageAuthFree(window.location.pathname)) {
+    console.log('[SSO] 页面 accessControlEnabled=false，跳过 SSO 重定向');
+    return;
+  }
+
   // 从 URL 中获取当前 redirect 登录的次数
   const currentUrl = new URL(window.location.href);
   const redirectCountParam = currentUrl.searchParams.get('redirect_count');

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

@@ -50,10 +50,8 @@ export function applyTheme(theme: ThemeMode): void {
   if (typeof document === 'undefined') return;
 
   if (theme === 'dark') {
-    document.body.setAttribute('arco-theme', 'dark');
     document.body.setAttribute('data-theme', 'dark');
   } else {
-    document.body.removeAttribute('arco-theme');
     document.body.setAttribute('data-theme', 'normal');
   }
 }

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

@@ -20,7 +20,6 @@
 
   .arco-tabs-header-title {
     border: none;
-    background-color: transparent;
     border-radius: @border-radius-lg;
 
     &-active {

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

@@ -188,10 +188,10 @@ function AppTabs() {
     >
       {tabs.map((tab) => {
         const isChinese = isChineseLocale();
-        const fallbackName = isChinese ? tab.title : (tab.titleEn || tab.title);
-        const label = tab.nameKey
-          ? getMenuLabel(tab.nameKey, fallbackName)
-          : fallbackName;
+        const label = getMenuLabel(
+          { name: tab.title, nameEn: tab.titleEn, nameKey: tab.nameKey },
+          isChinese,
+        );
         return <TabPane destroyOnHide key={tab.key} title={label} />;
       })}
     </Tabs>

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

@@ -1,4 +1,4 @@
-import { getCurrentLocale, getIconFontPath } from '@/common/locale';
+import { getIconFontPath } from '@/common/locale';
 import { Icon } from '@mico-platform/ui';
 
 // 该组件用于自定义的图标，用法见https://arco.design/react/components/icon#%E6%B7%BB%E5%8A%A0-iconbox-%E9%A1%B9%E7%9B%AE
@@ -7,13 +7,12 @@ import { Icon } from '@mico-platform/ui';
 // 字体库地址：https://arco.design/iconbox/mime/lib/1945/0
 
 /**
- * 根据当前语言加载对应的图标库
+ * 根据当前语言加载对应的图标库(当前只有中文)
  * 语言切换时会重新加载页面，所以这里只需要在初始化时根据当前语言加载
  */
 function createIconFont() {
-  // 获取当前语言（按优先级：URL参数 > localStorage > 浏览器默认）
-  const currentLocale = getCurrentLocale();
-  const iconPath = getIconFontPath(currentLocale);
+  // TODO: 后续支持多语言时，需要根据当前语言加载对应的图标库
+  const iconPath = getIconFontPath();
 
   // 创建 IconFont 实例
   return Icon.addFromIconFontCn({ src: iconPath });

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

@@ -4,8 +4,9 @@
 
 .micro-app-container {
   width: 100%;
-  height: 100%;
   position: relative;
+  display: flex;
+  flex-direction: column;
   overflow: auto;
 }
 
@@ -48,10 +49,28 @@
   // 激活时在文档流中，继承占位元素的尺寸
   width: 100%;
   height: 100%;
+  display: flex;
+  flex: 1;
+  flex-direction: column;
   overflow: auto;
+  min-height: calc(100vh - 134px);
+
 
   > div {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+  }
+
+  > div > div {
     height: 100%;
+    display: flex;
+    flex: 1 1;
+  }
+
+  > div > div > div {
+    width: 100%;
+    flex: 1 1;
   }
 
   // 隐藏状态（在 body 中）

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

@@ -2,7 +2,8 @@ import { getAuthInfo } from '@/common/auth/auth-manager';
 import { EEnv, getEnv } from '@/common/env';
 import { getCurrentLocale } from '@/common/locale';
 import { request } from '@/common/request';
-import { isAuthDisabled, isNoPermissionRoute } from '@/constants';
+import { isPageAuthFree } from '@/common/menu/parser';
+import { isAuthDisabled, isNoAuthRoute, isNoPermissionRoute } from '@/constants';
 import { Spin } from '@mico-platform/ui';
 import { useLocation, useModel } from '@umijs/max';
 import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
@@ -46,12 +47,12 @@ const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
     mounted: false,
   });
 
-  // 获取 initialState，等待用户信息准备好再加载子应用
-  // disableAuth 模式或免权限校验路由下跳过等待
   const { initialState } = useModel('@@initialState');
   const location = useLocation();
   const isAuthReady =
     isAuthDisabled() ||
+    isPageAuthFree(location.pathname) ||
+    isNoAuthRoute(location.pathname) ||
     isNoPermissionRoute(location.pathname) ||
     !!initialState?.currentUser;
 

package/generators/micro-react/templates/apps/layout/src/components/MicroAppLoader/micro-app-manager.ts

@@ -391,6 +391,12 @@ class MicroAppManager {
         activateContainer(container, request.target);
 
         console.log('🔍[路由调试] 调用 loadMicroApp', { name: request.name, qiankunName, entry: request.entry });
+
+        if (process.env.NODE_ENV === 'development') {
+          // 重置标志，使子应用能初始化自己的 react-refresh 运行时以支持 HMR
+          (window as any).__reactRefreshInjected = false;
+        }
+
         const microApp = loadMicroApp(
           {
             name: qiankunName,
@@ -399,7 +405,7 @@ class MicroAppManager {
             props: request.props,
           },
           {
-            sandbox: { strictStyleIsolation: false, experimentalStyleIsolation: true },
+            sandbox: { strictStyleIsolation: false, experimentalStyleIsolation: false, loose: true },
           },
         );
 

package/generators/micro-react/templates/apps/layout/src/global.less

@@ -1,13 +1,26 @@
 
 // 再导入 @mico-platform/theme 主题变量（CSS Variables + Less Variables）
 // 这样项目的变量定义会在 UI 库之后，可以正确覆盖
-@import '@mico-platform/theme';
+@import '@mico-platform/theme/variables';
 
 * {
   box-sizing: border-box;
 }
 
+// 禁用 Mac 触摸板双指左右滑动触发的浏览器前进/后退手势
+html {
+  overscroll-behavior-x: none;
+  height: 100%;
+}
+
+body {
+  overscroll-behavior-x: none;
+  height: 100%;
+  background-color: @color-fill-1;
+}
+
 #root {
-  min-height: 100vh;
+  min-height: max(100%, 800px);
+  // 这里是为了让子容器撑满高度，正常的height: 100%并不能撑满
   display: flex;
 }