generator-mico-cli 0.1.29 → 0.2.2-8.beta.1

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,82 @@
 /**
  * 请求客户端配置管理
+ * appId 优先从 window.__MICO_WORKSPACE__ 获取，其次从 window.__MICO_CONFIG__ 获取；
+ * externalLoginPath 优先从 window.__MICO_WORKSPACE__.casServerLoginUrl 获取；
+ * 其余 apiBaseUrl / proxySuffix / loginEndpoint / refreshEndpoint 优先从 window.__MICO_CONFIG__ 同名字段获取，兜底取 process.env 环境变量。
+ * proxySuffix：若 __MICO_CONFIG__.proxySuffix 与 process.env.PROXY_SUFFIX 均未配置，则按已解析的 appId 推导为 /proxy/${appId}_svr。
  */
 
 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;
+}
+
+/** 显式 proxySuffix 优先；否则在有 appId 时使用 /proxy/${appId}_svr */
+function resolveProxySuffixWithFallback(
+  explicit: string,
+  appId: string,
+): string {
+  if (explicit) return explicit;
+  return appId ? `/proxy/${appId}_svr` : '';
+}
+
+function buildDefaultClientOptions(): RequestClientOptions {
+  const envDefaults: RequestClientOptions = {
+    appId: '',
+    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,
+      proxySuffix: resolveProxySuffixWithFallback(
+        envDefaults.proxySuffix,
+        envDefaults.appId,
+      ),
+    };
+  }
+  const resolvedAppId =
+    appIdFromWorkspace ?? mico?.appId ?? envDefaults.appId;
+  const explicitProxy = mico?.proxySuffix ?? envDefaults.proxySuffix;
+  return {
+    ...envDefaults,
+    ...(mico?.defaultClientOptions ?? {}),
+    appId: resolvedAppId,
+    apiBaseUrl: mico?.apiBaseUrl ?? envDefaults.apiBaseUrl,
+    proxySuffix: resolveProxySuffixWithFallback(
+      explicitProxy,
+      resolvedAppId,
+    ),
+    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/index.ts

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

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

@@ -3,7 +3,7 @@
  */
 
 import { getFromStorage, safeParseJSON } from '@/common/helpers';
-import { Message } from '@arco-design/web-react';
+import { Message } from '@mico-platform/ui';
 import { maybePersistTokens } from '@/common/auth/auth-manager';
 import { UID } from '@/common/auth/type';
 import { getClientOptions, resolveAuthToken } from './config';
@@ -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;
 };
@@ -164,7 +164,7 @@ export const initDefaultInterceptors = (
     return data;
   });
 
-  // 处理业务错误码
+  // 处理业务错误码（{ result: { code, desc } } 格式）
   addResponseInterceptor(async (data: unknown) => {
     if (data && typeof data === 'object' && 'result' in data) {
       const typedData = data as { result?: { code?: number; desc?: string } };
@@ -183,4 +183,32 @@ export const initDefaultInterceptors = (
     }
     return data;
   });
+
+  // 处理业务错误码（{ code, msg, data } 格式）
+  addResponseInterceptor(async (data: unknown) => {
+    if (
+      data &&
+      typeof data === 'object' &&
+      'code' in data &&
+      !('result' in data) &&
+      !('success' in data)
+    ) {
+      const typedData = data as { code?: number | string; msg?: string };
+      const code = Number(typedData.code);
+      if (!isNaN(code) && code !== 200 && code !== 0) {
+        const error = new Error(
+          typedData.msg || `请求失败 (${code})`,
+        ) as Error & {
+          code: number;
+          msg: string;
+          response: unknown;
+        };
+        error.code = code;
+        error.msg = typedData.msg || '';
+        error.response = data;
+        throw error;
+      }
+    }
+    return data;
+  });
 };

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

@@ -7,7 +7,8 @@ import {
   maybePersistTokens,
   setStoredAuthToken,
 } from '@/common/auth/auth-manager';
-import { ROUTES } from '@/common/constants';
+import { isPageAuthFree } from '@/common/menu';
+import { isNoAuthRoute, ROUTES } from '@/constants';
 import {
   getTicketParam,
   resolveAuthToken,
@@ -31,6 +32,17 @@ let ticketPromise: Promise<void> | null = null;
 export const handleAuthFailureRedirect = (): void => {
   if (typeof window === 'undefined') return;
 
+  // 如果当前路由在免认证列表中，不触发 SSO 重定向
+  if (isNoAuthRoute(window.location.pathname)) {
+    console.log('[SSO] 当前路由在免认证列表中，跳过 SSO 重定向');
+    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');
@@ -101,16 +113,6 @@ export const ensureSsoSession = async (): Promise<void> => {
         setFetchingToken(false);
 
         if (resolveAuthToken()) {
-          // SSO 认证成功，删除 URL 中的 redirect_count 参数
-          if (typeof window !== 'undefined') {
-            const current = new URL(window.location.href);
-            current.searchParams.delete('redirect_count');
-            const nextUrl = `${current.pathname}${
-              current.search ? `?${current.searchParams}` : ''
-            }${current.hash}`;
-            window.history.replaceState(null, '', nextUrl);
-          }
-
           processPendingRequests();
         } else {
           throw new Error('SSO 认证失败');
@@ -131,3 +133,19 @@ export const ensureSsoSession = async (): Promise<void> => {
 
   await ticketPromise;
 };
+
+/**
+ * 清除 URL 中的 redirect_count 参数
+ * 仅在整个认证流程（SSO + fetchUserInfo）完全成功后调用，
+ * 避免过早清除导致无限重定向循环
+ */
+export const clearRedirectCount = (): void => {
+  if (typeof window === 'undefined') return;
+  const current = new URL(window.location.href);
+  if (!current.searchParams.has('redirect_count')) return;
+  current.searchParams.delete('redirect_count');
+  const nextUrl = `${current.pathname}${
+    current.search ? `?${current.searchParams}` : ''
+  }${current.hash}`;
+  window.history.replaceState(null, '', nextUrl);
+};

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

@@ -2,7 +2,7 @@
  * URL 解析与拼接工具
  */
 
-import { resolveProxySuffix } from './config';
+import { resolveApiBaseUrl, resolveProxySuffix } from './config';
 import type { UnifiedRequestOptions } from './types';
 
 /**
@@ -33,8 +33,12 @@ const joinProxyAndPath = (proxySuffix: string, path: string): string => {
  * 配置优先级：
  * 1. rawUrl: true → 直接返回原始 url
  * 2. 绝对 URL → 直接返回
- * 3. skipProxy: true → 返回相对路径，不拼接代理前缀
- * 4. 其他情况 → 拼接 proxySuffix + url
+ * 3. skipProxy: true → 拼接 apiBaseUrl + url（跳过 proxySuffix）
+ * 4. 其他情况 → 拼接 apiBaseUrl + proxySuffix + url
+ *
+ * 示例（testing 环境，apiBaseUrl = https://dashboard-api-test.micoplatform.com）：
+ * - 默认: /api/user/info → https://dashboard-api-test.micoplatform.com/proxy/<%= projectName %>_svr/api/user/info
+ * - skipProxy: /api/user/info → https://dashboard-api-test.micoplatform.com/api/user/info
  */
 export const resolveRequestUrl = (
   url: string,
@@ -50,13 +54,24 @@ export const resolveRequestUrl = (
     return url;
   }
 
-  // skipProxy: true 时不拼接代理前缀
-  if (options?.skipProxy) {
-    return url;
+  // 拼接 apiBaseUrl + proxySuffix + url
+  const apiBaseUrl = resolveApiBaseUrl();
+  // skipProxy: true 时不拼接 proxySuffix
+  const proxySuffix = options?.skipProxy
+    ? ''
+    : resolveProxySuffix(options?.proxySuffix);
+
+  if (apiBaseUrl) {
+    // 有 apiBaseUrl 时，拼接完整的绝对路径
+    const pathPart = proxySuffix ? joinProxyAndPath(proxySuffix, url) : url;
+    const normalizedBase = apiBaseUrl.endsWith('/')
+      ? apiBaseUrl.slice(0, -1)
+      : apiBaseUrl;
+    const normalizedPath = pathPart.startsWith('/') ? pathPart : `/${pathPart}`;
+    return `${normalizedBase}${normalizedPath}`;
   }
 
-  // 拼接 proxySuffix
-  const proxySuffix = resolveProxySuffix(options?.proxySuffix);
+  // 没有 apiBaseUrl 时，仅拼接 proxySuffix（相对路径）
   if (proxySuffix) {
     return joinProxyAndPath(proxySuffix, url);
   }

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

@@ -0,0 +1,345 @@
+/**
+ * 路由守卫 - 自动检测用户意图
+ *
+ * 核心问题：
+ * 当用户快速切换微应用（A→B→A）时，子应用 B 的代码可能在后台继续执行，
+ * 并调用 history.pushState('/route-b') 试图修改路由，导致用户界面混乱。
+ *
+ * 解决方案：
+ * 自动检测"用户触发的导航"和"程序触发的导航"：
+ * - 用户触发：在 click/keydown 等交互事件的同步调用栈中
+ * - 程序触发：在异步回调、定时器、微应用生命周期中
+ *
+ * 对于程序触发的导航，如果目标路径与当前用户意图不匹配，则拦截。
+ *
+ * 使用方式：
+ * 1. 在应用入口处导入此文件（import '@/common/route-guard'）
+ * 2. 业务代码无需任何改动，正常使用 history.push、react-router、<a> 标签等
+ */
+
+import { microAppLogger } from './logger';
+
+// ============================================================================
+// 类型定义
+// ============================================================================
+
+interface UserIntent {
+  /** 用户意图的目标路径 */
+  path: string;
+  /** 意图设置时间 */
+  timestamp: number;
+  /** 是否来自用户交互（点击/键盘） */
+  fromInteraction: boolean;
+}
+
+// ============================================================================
+// 配置常量
+// ============================================================================
+
+/** 用户意图有效期（毫秒） */
+const INTENT_TTL = 5000;
+
+/** 交互事件结束后的保护窗口期（毫秒）
+ * 用于处理 click → setTimeout(() => navigate(), 0) 这种微延迟情况
+ */
+const INTERACTION_GRACE_PERIOD = 100;
+
+// ============================================================================
+// 状态
+// ============================================================================
+
+/** 当前用户意图 */
+let currentIntent: UserIntent | null = null;
+
+/** 是否正在用户交互中（click/keydown 事件处理期间） */
+let isInUserInteraction = false;
+
+/** 交互结束时间（用于 grace period） */
+let interactionEndTime = 0;
+
+/** 当前用户交互开始时间（用于判断意图是否在当前交互期间设置的） */
+let currentInteractionStartTime = 0;
+
+/** 调试模式 */
+const DEBUG = true;
+
+// ============================================================================
+// 工具函数
+// ============================================================================
+
+function log(...args: unknown[]): void {
+  if (DEBUG) {
+    console.log('🛡️[RouteGuard]', ...args);
+  }
+}
+
+function warn(...args: unknown[]): void {
+  console.warn('🛡️[RouteGuard]', ...args);
+}
+
+/**
+ * 获取路径的基础部分（第一级路径）
+ * /lineup/list → /lineup
+ * /permission/role → /permission
+ */
+function getBasePath(path: string): string {
+  const normalized = path.startsWith('/') ? path : '/' + path;
+  const segments = normalized.split('/').filter(Boolean);
+  return '/' + (segments[0] || '');
+}
+
+/**
+ * 解析 URL 获取 pathname
+ */
+function parsePathname(url: string | URL | null | undefined): string | null {
+  if (!url) return null;
+
+  if (typeof url === 'string') {
+    // 相对路径
+    if (url.startsWith('/')) return url.split('?')[0].split('#')[0];
+    // 绝对 URL
+    try {
+      return new URL(url, window.location.origin).pathname;
+    } catch {
+      return null;
+    }
+  }
+
+  return url.pathname;
+}
+
+/**
+ * 检查意图是否有效
+ */
+function isIntentValid(): boolean {
+  if (!currentIntent) return false;
+  return Date.now() - currentIntent.timestamp < INTENT_TTL;
+}
+
+/**
+ * 是否在用户交互上下文中
+ * 包括：正在交互 或 刚刚结束交互（grace period 内）
+ */
+function isInInteractionContext(): boolean {
+  if (isInUserInteraction) return true;
+  if (Date.now() - interactionEndTime < INTERACTION_GRACE_PERIOD) return true;
+  return false;
+}
+
+// ============================================================================
+// 公开 API
+// ============================================================================
+
+/**
+ * 设置用户意图（供 MicroAppManager 内部调用）
+ * 业务代码不需要调用此函数，路由守卫会自动检测用户交互
+ */
+export function setUserIntent(path: string): void {
+  log('设置意图:', path);
+  currentIntent = {
+    path,
+    timestamp: Date.now(),
+    fromInteraction: false,
+  };
+}
+
+/**
+ * 刷新意图时间戳（供 MicroAppManager 内部调用）
+ * 在长时间操作（如加载微应用）过程中保持意图有效
+ */
+export function refreshUserIntent(): void {
+  if (currentIntent) {
+    currentIntent.timestamp = Date.now();
+    log('刷新意图:', currentIntent.path);
+  }
+}
+
+/**
+ * 清除用户意图
+ */
+export function clearUserIntent(): void {
+  log('清除意图');
+  currentIntent = null;
+}
+
+/**
+ * 获取当前意图信息（调试用）
+ */
+export function getIntentDebugInfo(): object {
+  return {
+    intent: currentIntent,
+    isValid: isIntentValid(),
+    isInInteraction: isInUserInteraction,
+    interactionEndTime,
+    isInContext: isInInteractionContext(),
+  };
+}
+
+// ============================================================================
+// 路由守卫核心逻辑
+// ============================================================================
+
+/**
+ * 判断是否应该拦截此次导航
+ */
+function shouldIntercept(targetPath: string): boolean {
+  const targetBase = getBasePath(targetPath);
+
+  // 1. 在用户交互上下文中
+  if (isInInteractionContext()) {
+    // 检查是否有有效意图，且意图是在当前用户交互期间由 setUserIntent 设置的
+    // 只有这种情况才需要检查匹配，以防止微应用在 mount 过程中推送错误的路由
+    //
+    // 关键区分：
+    // - 意图在当前交互之前设置（如页面加载时）：允许用户的新导航覆盖旧意图
+    // - 意图在当前交互期间由 setUserIntent 设置：正在进行微应用切换，需要保护
+    if (isIntentValid() && !currentIntent!.fromInteraction) {
+      // 检查意图是否在当前交互期间设置的
+      const isIntentFromCurrentInteraction = currentIntent!.timestamp >= currentInteractionStartTime;
+      if (isIntentFromCurrentInteraction) {
+        const intentBase = getBasePath(currentIntent!.path);
+        if (targetBase !== intentBase) {
+          warn('❌ 拦截不匹配意图的导航（交互上下文中）:', {
+            targetPath,
+            targetBase,
+            intentPath: currentIntent!.path,
+            intentBase,
+          });
+          return true;
+        }
+      }
+    }
+    // 目标匹配意图、无有效意图、或意图是旧的，允许导航并更新意图
+    log('用户交互触发导航:', targetPath);
+    currentIntent = {
+      path: targetPath,
+      timestamp: Date.now(),
+      fromInteraction: true,
+    };
+    return false;
+  }
+
+  // 2. 没有有效意图，允许导航
+  if (!isIntentValid()) {
+    log('无有效意图，允许导航:', targetPath);
+    return false;
+  }
+
+  // 3. 有有效意图，检查目标路径是否匹配
+  const intentBase = getBasePath(currentIntent!.path);
+
+  if (targetBase === intentBase) {
+    log('目标匹配意图，允许导航:', { targetPath, intentPath: currentIntent!.path });
+    return false;
+  }
+
+  // 4. 不匹配，拦截
+  warn('❌ 拦截程序触发的导航:', {
+    targetPath,
+    targetBase,
+    intentPath: currentIntent!.path,
+    intentBase,
+    intentAge: Date.now() - currentIntent!.timestamp + 'ms',
+  });
+  return true;
+}
+
+// ============================================================================
+// 初始化
+// ============================================================================
+
+if (typeof window !== 'undefined') {
+  // 保存原始方法
+  const originalPushState = window.history.pushState.bind(window.history);
+  const originalReplaceState = window.history.replaceState.bind(window.history);
+
+  // 拦截 pushState
+  window.history.pushState = function (
+    state: unknown,
+    unused: string,
+    url?: string | URL | null,
+  ) {
+    const targetPath = parsePathname(url);
+    log('pushState 被调用:', { url, targetPath, isInInteraction: isInUserInteraction });
+
+    if (targetPath && shouldIntercept(targetPath)) {
+      // 拦截，不执行导航
+      return;
+    }
+
+    return originalPushState(state, unused, url);
+  };
+
+  // 拦截 replaceState
+  window.history.replaceState = function (
+    state: unknown,
+    unused: string,
+    url?: string | URL | null,
+  ) {
+    const targetPath = parsePathname(url);
+    log('replaceState 被调用:', { url, targetPath, isInInteraction: isInUserInteraction });
+
+    if (targetPath && shouldIntercept(targetPath)) {
+      // 拦截，不执行导航
+      return;
+    }
+
+    return originalReplaceState(state, unused, url);
+  };
+
+  // 监听用户交互事件
+  // 使用 capture 阶段确保在任何其他处理器之前执行
+  const markInteractionStart = (event: Event) => {
+    // 只处理可能触发导航的交互
+    if (event.type === 'click' || event.type === 'keydown') {
+      const keyEvent = event as KeyboardEvent;
+      // 只有 Enter 键可能触发导航
+      if (event.type === 'keydown' && keyEvent.key !== 'Enter') {
+        return;
+      }
+
+      // log('用户交互开始:', event.type);
+      isInUserInteraction = true;
+      // 记录交互开始时间，用于判断意图是否在当前交互期间设置的
+      currentInteractionStartTime = Date.now();
+
+      // 在当前事件循环结束后重置标记
+      // 使用 setTimeout 0 确保同步代码执行完毕
+      setTimeout(() => {
+        isInUserInteraction = false;
+        interactionEndTime = Date.now();
+        // log('用户交互结束');
+      }, 0);
+    }
+  };
+
+  document.addEventListener('click', markInteractionStart, { capture: true });
+  document.addEventListener('keydown', markInteractionStart, { capture: true });
+
+  // 监听 popstate 事件（浏览器前进/后退）
+  window.addEventListener('popstate', () => {
+    // 浏览器前进后退是用户行为，更新意图
+    const newPath = window.location.pathname;
+    log('popstate 事件:', newPath);
+    currentIntent = {
+      path: newPath,
+      timestamp: Date.now(),
+      fromInteraction: true,
+    };
+  });
+
+  microAppLogger.log('RouteGuard initialized');
+
+  // 暴露调试接口
+  (window as unknown as Record<string, unknown>).__ROUTE_GUARD__ = {
+    getDebugInfo: getIntentDebugInfo,
+    setIntent: setUserIntent,
+    clearIntent: clearUserIntent,
+  };
+}
+
+export default {
+  setUserIntent,
+  clearUserIntent,
+  getIntentDebugInfo,
+};