generator-mico-cli 0.2.27 → 0.2.28

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

@@ -33,6 +33,9 @@ const config: ReturnType<typeof defineConfig> = {
           // noLayoutRouteList: [],
           // 关闭权限控制（调试用）
           disableAuth: false,
+          // SSO 外跳地址（与 resolveExternalLoginPath 读取的 externalLoginPath 一致；生产由注入的 __MICO_CONFIG__ 提供）
+          externalLoginPath:
+            'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
         };
       `,
     },
@@ -68,8 +71,6 @@ const config: ReturnType<typeof defineConfig> = {
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/refresh/',
-    'process.env.EXTERNAL_LOGIN_PATH':
-      'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
   },
 };
 

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

@@ -33,8 +33,6 @@ const config: ReturnType<typeof defineConfig> = {
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/refresh/',
-    'process.env.EXTERNAL_LOGIN_PATH':
-      'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
   },
 };
 

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

@@ -33,8 +33,6 @@ const config: ReturnType<typeof defineConfig> = {
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/refresh/',
-    'process.env.EXTERNAL_LOGIN_PATH':
-      'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
   },
 };
 

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

@@ -21,8 +21,6 @@ const config: ReturnType<typeof defineConfig> = {
       'https://dashboard-api.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api.micoplatform.com/api/yufu_login/refresh/',
-    'process.env.EXTERNAL_LOGIN_PATH':
-      'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
   },
   externals: {
     react: 'React',
@@ -33,7 +31,7 @@ const config: ReturnType<typeof defineConfig> = {
   extraBabelPlugins: ['babel-plugin-dynamic-import-node'],
 
   // 禁用代码分割，只输出一个 JS 和一个 CSS
-  chainWebpack(memo) {
+  chainWebpack(memo: any) {
     // 禁用 splitChunks
     memo.optimization.splitChunks(false);
     // 禁用 runtimeChunk

package/generators/micro-react/templates/apps/layout/docs/feat-/346/236/204/345/273/272define/344/270/216/345/205/215/350/256/244/350/257/201/345/210/235/345/247/213/346/200/201.md

@@ -0,0 +1,44 @@
+# 构建 define 精简与免认证页初始态
+
+> 创建时间：2026-03-24
+
+## 功能概述
+
+1. **Umi `define`**：不再通过构建期注入 `process.env.EXTERNAL_LOGIN_PATH`（本模板从未注入 `APP_ID`）；SSO 外跳等依赖运行时 `window.__MICO_CONFIG__`。
+2. **`getInitialState`**：免认证路由下即使本地仍有 token，也不请求用户信息接口，减少无效调用。
+
+## 技术方案
+
+### 开发环境
+
+`config/config.dev.ts` 的 `headScripts` 中 `window.__MICO_CONFIG__` 增加 **`externalLoginPath`**（模板默认为占位 URL，生成项目后请按实际 IdP 修改）。
+
+`define` 仅保留 `NODE_ENV`、`API_BASE_URL`、`LOGIN_ENDPOINT`、`REFRESH_ENDPOINT`。
+
+### 生产 / 测试构建
+
+`config.prod.ts`、`config.prod.development.ts`、`config.prod.testing.ts` 的 `define` 中同样**不包含** `EXTERNAL_LOGIN_PATH`，由部署时注入的 `__MICO_CONFIG__.externalLoginPath`（或 `__MICO_WORKSPACE__.casServerLoginUrl`）提供。
+
+### 初始态
+
+`src/app.tsx` 中仅在 `getStoredAuthToken() && !skipAuth` 时调用 `fetchUserInfoFn()`；`skipAuth = isNoAuthRoute || isPageAuthFree`。
+
+## 文件清单
+
+| 文件路径 | 说明 |
+| --- | --- |
+| `config/config.dev.ts` | `__MICO_CONFIG__.externalLoginPath`；移除 `EXTERNAL_LOGIN_PATH` define |
+| `config/config.prod.ts` | 移除 `EXTERNAL_LOGIN_PATH` define |
+| `config/config.prod.development.ts` | 同上 |
+| `config/config.prod.testing.ts` | 同上 |
+| `src/app.tsx` | `fetchUserInfo` 条件增加 `!skipAuth` |
+
+## 部署注意
+
+- 生产 HTML 或网关需保证 `window.__MICO_CONFIG__` 含 **`appId`**、**`externalLoginPath`**（或与现有网关字段对齐），否则代理前缀、SSO 外跳可能异常。
+- 详见 `src/common/request/config.ts` 中 `buildDefaultClientOptions` 的解析顺序。
+
+## 相关文档
+
+- [fix-SSO无限重定向](./fix-SSO无限重定向.md)
+- [arch-请求模块](./arch-请求模块.md)

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

@@ -45,7 +45,7 @@
 
 ```typescript
 interface MicroAppLoaderProps {
-  /** 微应用在主应用中的挂载路径前缀（通常与当前页面 route.path 一致），经 normalizeMicroAppBase 后传给子应用 */
+  /** 微应用在主应用中的挂载路径前缀（来自 ParsedRoute.base / 页面配置 base），经 normalizeMicroAppBase 后传给子应用 */
   base: string;
   /** 微应用入口 URL */
   entry: string;
@@ -76,10 +76,10 @@ interface MicroAppLoaderProps {
 
 | 字段 | 含义 |
 | --- | --- |
-| **base** | 该微应用在主应用中的**根路径前缀**，一般等于菜单/动态路由里的 `path`。 |
+| **base** | 该微应用在主应用中的**挂载前缀**，来自中台 **`page.base`**，解析为 **`ParsedRoute.base`**（缺省时解析为 **`'/'`**）；可与动态路由 **`path`** 不同（如 `path` 为 `/subapp/*` 时 `base` 可为 `/subapp`）。 |
 | **routePath** | 当前激活的**完整路由路径**，随浏览器 URL 变化，用于通知子应用做**内部路由同步**。 |
 
-二者在 `layouts/index.tsx` 中常同为 `currentRoute.path`；在 `app.tsx` 的 `patchClientRoutes` 里与动态路由项一致，传入 **`base: route.path`**、**`name: route.path`**（`name` 另在布局侧可能改为基于 `entry` 的 `getAppNameFromEntry`，与 `base` 来源不同，需注意）。
+`routePath` 在布局内为 **`currentRoute.path`**。`base` 在 **`patchClientRoutes`** 与布局内均为 **`route.base` / `currentRoute.base`**。**`name`** 在布局侧常为基于 **`entry`** 的 **`getAppNameFromEntry`**，与 **`base`** 来源不同，需注意。
 
 #### `normalizeMicroAppBase`
 
@@ -96,8 +96,8 @@ export const normalizeMicroAppBase = (path: string): string =>
 
 | 位置 | 说明 |
 | --- | --- |
-| `src/app.tsx` `patchClientRoutes` | 动态注册微应用路由时：`React.createElement(MicroAppLoader, { entry, name: route.path, base: route.path, ... })` |
-| `src/layouts/index.tsx` | 布局内渲染：`<MicroAppLoader base={currentRoute.path} routePath={currentRoute.path} ... />` |
+| `src/app.tsx` `patchClientRoutes` | 动态注册微应用路由时：`React.createElement(MicroAppLoader, { entry, name: route.path, base: route.base, ... })` |
+| `src/layouts/index.tsx` | 布局内渲染：`<MicroAppLoader base={currentRoute.base} routePath={currentRoute.path} ... />` |
 
 #### 加载门控（认证）
 
@@ -165,6 +165,8 @@ export async function update(props: MicroAppProps) {
 ```typescript
 interface ParsedRoute {
   path: string;
+  /** 微应用挂载前缀（来自 page.base，解析缺省为 '/'） */
+  base: string;
   name: string;
   icon: string;
   /** 加载类型: internal(内部路由) | microapp(qiankun微应用) */
@@ -182,6 +184,8 @@ interface PageConfig {
   id: number;
   name: string;
   route: string;
+  /** 微应用挂载前缀（可与 route 不同） */
+  base: string;
   enabled: boolean;
   /** 微应用 HTML 入口 URL (优先使用) */
   htmlUrl: string | null;
@@ -254,7 +258,8 @@ const renderContent = () => {
       <MicroAppLoader
         entry={currentRoute.entry}
         name={currentRoute.name}
-        base={currentRoute.path}
+        base={currentRoute.base}
+        routePath={currentRoute.path}
       />
     );
   }

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

@@ -138,7 +138,8 @@ export async function getInitialState(): Promise<{
   }
 
   // 有 token 就获取用户信息（无论在哪个页面，支持登录后 refresh 场景）
-  if (getStoredAuthToken()) {
+  // 当页面免认证时，不获取用户信息
+  if (getStoredAuthToken() && !skipAuth) {
     const userInfo = await fetchUserInfoFn();
     if (userInfo) {
       clearRedirectCount();

package/generators/micro-react/templates/packages/common-intl/src/intl.ts

@@ -37,7 +37,13 @@ const intlProxy = new Proxy(intl, {
     }
     // 不存在的 key，返回一个兜底函数
     console.warn(`[common-intl] Missing intl key: ${prop}`);
-    return () => prop; // 返回 key 本身作为兜底文案
+    // 未预定义的 key：仍从缓存（接口拉取的多语言数据）中查找，支持动态 key
+    return (...interpolations: Array<string | number | undefined>) =>
+      i18n({
+        key: prop,
+        interpolations,
+        defaultMessage: prop, // 缓存无值时用 key 兜底
+    });
   },
 });
 

package/package.json

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