generator-mico-cli 0.2.27 → 0.2.29

package/generators/micro-react/templates/apps/layout/mock/api.mock.ts

@@ -5,38 +5,30 @@
  */
 
 export default {
-  // 获取用户信息
-  'GET /api/user/info': {
-    "code": 200,
-    "data": {
-        "id": 381,
-        "last_login": "2026-03-06T02:37:10.050735Z",
-        "is_superuser": true,
-        "username": "本地测试mock用户",
-        "first_name": "",
-        "last_name": "",
-        "email": "本地测试mock用户@micous.com",
-        "is_staff": true,
-        "is_active": true,
-        "type": 1,
-        "phone": "",
-        "agency_id": 0,
-        "avatar": "https://gw.alipayobjects.com/zos/antfincdn/XAosXuNZyF/BiazfanxmamNRoxxVxka.png",
-        "user_name": "Easton",
-        "permission_tree": [
-        ],
-        "miss_permissions": [],
-        "side_menus": [
-          '首页',
-          '示例模块.示例页面',
-          '微应用示例.子应用页面',
-          '外部链接',
-          '权限管理',
-        ],
-        "region_permissions": []
+  // 获取用户信息（OpenAPI 8 GET /user/info/，与 fetchUserInfo 一致）
+  'GET /user/info/': {
+    code: 200,
+    data: {
+      id: 381,
+      avatar:
+        'https://gw.alipayobjects.com/zos/antfincdn/XAosXuNZyF/BiazfanxmamNRoxxVxka.png',
+      email: '本地测试mock用户@micous.com',
+      name: 'Easton',
+      app_perms: [],
+      region_perms: [],
+      menu_perms: [
+        'cs_web_menu_home',
+        'cs_web_menu_example_page',
+        'cs_web_menu_subapp_page',
+        'cs_web_menu_external_link',
+        'cs_web_menu_permission_management',
+        'cs_web_menu_group_management',
+      ],
+      button_perms: ['cs_web_btn_subapp_demo', 'cs_web_btn_home_demo'],
+      is_superuser: false,
     },
-    "msg": "ok"
-},
+    msg: 'ok',
+  },
 
   // 获取统计数据
   // 'GET /api/dashboard/stats': {

package/generators/micro-react/templates/apps/layout/mock/pages.ts

@@ -6,6 +6,7 @@
  * - id: 页面唯一标识
  * - name: 页面名称
  * - route: 路由路径
+ * - base: 微应用挂载前缀（可与 route 不同）
  * - htmlUrl: 微应用 HTML 入口 URL
  * - jsUrls: 额外 JS 资源
  * - cssUrls: 额外 CSS 资源
@@ -25,10 +26,10 @@ const mockPages: PublicPageItem[] = [
   {
     id: 125,
     name: '登录页',
-    nameEn: 'Login',
-    nameKey: 'page.user.login',
     route: '/user/login',
     base: '/user/login',
+    // htmlUrl:
+    //   'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.2/login/index.html',
     htmlUrl:
       'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.4/login/index.html',
     jsUrls: [],
@@ -45,10 +46,10 @@ const mockPages: PublicPageItem[] = [
   {
     id: 124,
     name: '权限管理',
-    nameEn: 'Permission Management',
-    nameKey: 'page.permission',
     route: '/permission',
     base: '/',
+    // htmlUrl:
+    //   'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.3/permission/index.html',
     htmlUrl:
       'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.4/permission/index.html',
     jsUrls: [],
@@ -65,8 +66,6 @@ const mockPages: PublicPageItem[] = [
   {
     id: 115,
     name: '兜底',
-    nameEn: 'Fallback',
-    nameKey: 'page.fallback',
     route: '/*',
     base: '/',
     htmlUrl: '',

package/generators/micro-react/templates/apps/layout/package.json

@@ -29,7 +29,8 @@
     "qiankun": "^2.10.16",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "spark-md5": "^3.0.2"
+    "spark-md5": "^3.0.2",
+    "<%= packageScope %>/common-intl": "workspace:*"
   },
   "devDependencies": {
     "@types/react": "^18.0.33",

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

@@ -7,6 +7,13 @@ import * as micoUI from '@mico-platform/ui';
 import React from 'react';
 import ReactDOM from 'react-dom';
 
+import { request as commonRequest } from './common/request';
+import {
+  fetchMultilingualData,
+  getCurrentLocale as getIntlLocale,
+  type ILang,
+} from '<%= packageScope %>/common-intl';
+import * as CommonIntl from '<%= packageScope %>/common-intl';
 import { getStoredAuthToken } from './common/auth/auth-manager';
 import type { IUserInfo } from './common/auth/type';
 import { fetchUserInfo } from './services/user';
@@ -90,6 +97,7 @@ if (typeof window !== 'undefined') {
   win.React = React;
   win.ReactDOM = ReactDOM;
   win.micoUI = micoUI;
+  win.CommonIntl = CommonIntl;
 }
 
 // 初始化主题（在页面加载时立即执行，避免闪烁）
@@ -107,6 +115,26 @@ export const locale = {
   },
 };
 
+// ==================== 国际化数据预加载 ====================
+
+/** @see https://umijs.org/docs/api/runtime-config#render */
+export function render(oldRender: () => void): void {
+  fetchMultilingualData({
+    requestInstance: commonRequest,
+    messageInstance: {
+      error: micoUI.Message.error,
+      warning: micoUI.Message.warning,
+    },
+    lang: getIntlLocale() as ILang,
+    localeRequestUrl: process.env.LOCALE_REQUEST_URL,
+  })
+    .then(oldRender)
+    .catch((error: Error) => {
+      console.error('获取多语言文案失败', error);
+      oldRender();
+    });
+}
+
 /**
  * @see https://umijs.org/docs/api/runtime-config#getinitialstate
  */
@@ -137,8 +165,9 @@ export async function getInitialState(): Promise<{
     await ensureSsoSession();
   }
 
-  // 有 token 就获取用户信息（无论在哪个页面，支持登录后 refresh 场景）
-  if (getStoredAuthToken()) {
+  // 有 token 就获取用户信息（登录后 refresh、免认证页同样需要 currentUser：
+  // 如 PermissionFilter / MicroAppLoader 注入子应用的 button_perms）
+  if (getStoredAuthToken() && !skipAuth) {
     const userInfo = await fetchUserInfoFn();
     if (userInfo) {
       clearRedirectCount();

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

@@ -9,39 +9,27 @@ export const UID = 'uid';
 export const MICRO_ENV_KEY = 'micro_env';
 
 /**
- * 权限树节点
+ * OpenAPI 8 — GET /user/info/ 响应 `data`（与 Apifox 导出 8 一致）
  */
-export interface IPermissionNode {
+export interface IUserInfoApiData {
   id: number;
+  avatar: string;
+  email: string;
   name: string;
-  sort: number;
-  level: number;
-  parent: number | null;
-  codename: string;
-  sub_menu?: IPermissionNode[];
+  app_perms: string[];
+  region_perms: string[];
+  menu_perms: string[];
+  button_perms: string[];
+  is_superuser: boolean;
 }
 
 /**
- * 完整用户信息（/api/user/info 接口返回的 data 字段）
+ * 应用内用户信息（initialState.currentUser）
+ * 在 `IUserInfoApiData` 基础上补充展示用字段（由 fetchUserInfo normalize）
  */
-export interface IUserInfo {
-  id: number;
-  username: string;
-  email: string;
+export interface IUserInfo extends IUserInfoApiData {
+  /** 展示名，通常来自接口 `name` */
   user_name: string;
-  avatar: string;
-  phone: string;
-  first_name: string;
-  last_name: string;
-  is_superuser: boolean;
-  is_staff: boolean;
-  is_active: boolean;
-  type: number;
-  agency_id: number;
-  last_login: string;
-  permission_tree: IPermissionNode[];
-  miss_permissions: string[];
-  side_menus: string[];
-  app_permissions: string[];
-  groups: string[];
+  /** 登录名/账号展示，可与 `name` 或 `email` 一致 */
+  username: string;
 }

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

@@ -1,5 +1,12 @@
+import { layoutLogger } from '@/common/logger';
 import { getCurrentLocale, LOCALE } from '@/common/locale';
-import { getMenuPage, getPages } from '@/common/portal-data';
+import {
+  findPageByPath,
+  getMenuPage,
+  getPages,
+} from '@/common/portal-data';
+
+export { findPageByPath };
 import { isAuthDisabled, isNoPermissionRoute } from '@/constants';
 import { getIntl } from '@umijs/max';
 import type {
@@ -28,6 +35,7 @@ export const extractRoutesFromPages = (
           | 'internal'
           | 'microapp',
         entry: page.htmlUrl || page.jsUrls?.[0] || undefined,
+        pageConfig: page,
       };
     });
 };
@@ -39,54 +47,54 @@ export const getDynamicRoutes = (): ParsedRoute[] => {
   return extractRoutesFromPages(getPages());
 };
 
-/**
- * 根据路径查找对应的页面配置
- * 匹配逻辑与 findRouteByPath 一致（精确匹配 + 通配符匹配）
- */
 /**
  * 判断指定路径的页面是否为免认证页面
  * 当 accessControlEnabled === false 时，跳过 SSO 认证和权限校验
+ * （页面解析与 `findPageByPath` 一致：精确匹配 + `/*` 通配）
  */
 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 {
   /** 是否是超级用户 */
   isSuperuser?: boolean | number;
-  /** 允许访问的菜单路径列表（白名单） */
-  sideMenus?: string[];
+  /** 用户拥有的菜单权限 code（与页面 `routeKey`、菜单项一致） */
+  menuPerms?: string[];
 }
 
+/**
+ * 菜单关联页是否需要走 `menu_perms` 校验
+ * - 未开启访问控制：否（菜单始终可展示，由路由侧处理公开页）
+ * - 已开启访问控制但未配置 `routeKey`：否（无 code 可验，菜单展示）
+ * - 已开启访问控制且配置了 `routeKey`：是
+ */
+export const isMenuPageRequiringPermCode = (
+  page: PublicPageItem | undefined,
+): boolean => {
+  if (!page) return false;
+  if (page.accessControlEnabled === false) return false;
+  const rk = page.routeKey;
+  if (rk === null || rk === undefined || rk === '') return false;
+  return true;
+};
+
+/**
+ * 用于 `menu_perms` 匹配的权限 code（仅当 `isMenuPageRequiringPermCode(page)` 为真时有效）
+ */
+export const getMenuItemPermCode = (item: MenuItem): string | null => {
+  if (item.type === 'page') {
+    const page = getMenuPage(item);
+    if (!page || !isMenuPageRequiringPermCode(page)) return null;
+    return page.routeKey;
+  }
+  if (item.type === 'link') {
+    return item.nameKey || null;
+  }
+  return null;
+};
+
 export const isSuperuserUser = (value?: boolean | number): boolean => {
   return value === true || value === 1;
 };
@@ -107,11 +115,9 @@ export const isChineseLocale = (): boolean => {
 };
 
 /**
- * 获取菜单标识符（用于构建权限路径）
- * - 中文格式：优先使用 name，兜底使用 nameKey
- * - 英文格式：优先使用 nameEn，兜底使用 nameKey
- * @param item 菜单项
- * @param isChinese 是否中文格式
+ * 获取菜单标识符（用于内部路径拼接等，非侧栏展示）
+ * - 中文：优先 `name`，兜底 `nameKey`
+ * - 英文：优先 `nameEn`，兜底 `nameKey`
  */
 export const getMenuIdentifier = (
   item: MenuItem,
@@ -123,45 +129,96 @@ export const getMenuIdentifier = (
   return item.nameEn || item.nameKey || '';
 };
 
+/** 菜单项被过滤时的原因（用于开发日志） */
+export type MenuFilterDenyReason =
+  | 'adminOnly'
+  | 'groupContainer'
+  | 'missingPermCode'
+  | 'menuPermsEmpty'
+  | 'permCodeNotInMenuPerms'
+  | 'groupNoVisibleChildren'
+  | 'allChildrenFilteredOut';
+
+export interface IMenuFilterOutcome {
+  allowed: boolean;
+  /** 当 allowed === false 时，单项校验的拒绝原因（不含容器类、子项被滤空等结构原因） */
+  denyReason?: MenuFilterDenyReason;
+}
+
 /**
- * 检查菜单路径是否允许访问（白名单逻辑）
- * - 免权限校验路由，始终允许访问
- * - 超级用户可以访问所有菜单
- * - 非超级用户不能访问 adminOnly 菜单
- * - 菜单路径在 sideMenus 中，或是 sideMenus 中某项的前缀（父级菜单）
+ * 单项是否允许展示（不含「子项全被过滤」等结构判断）
+ * - 免权限校验路由、超管、关闭权限：允许
+ * - `group`：自身不作为叶子展示，allowed 恒为 false，`denyReason` 为 `groupContainer`
+ * - `page` 且关联页未要求 `menu_perms`（`accessControlEnabled === false`，或已开启但未配置 `routeKey`）：允许
+ * - `page` / `link` 需 code 时：权限 code 须在 `menu_perms` 中
  */
-const isMenuAllowed = (
-  menuPath: string,
+export const getMenuItemFilterOutcome = (
   item: MenuItem,
   options: MenuFilterOptions,
-): boolean => {
-  // 关闭权限控制时，所有菜单都允许访问
-  if (isAuthDisabled()) return true;
+): IMenuFilterOutcome => {
+  if (isAuthDisabled()) return { allowed: true };
 
-  // 免权限校验路由，始终允许访问
   const itemRoute = item.path ?? getMenuPage(item)?.route;
   if (itemRoute && isNoPermissionRoute(itemRoute)) {
-    return true;
+    return { allowed: true };
   }
 
-  // 超级用户可以访问所有菜单
-  if (isSuperuserUser(options.isSuperuser)) return true;
+  if (isSuperuserUser(options.isSuperuser)) return { allowed: true };
 
-  // 非超级用户不能访问 adminOnly 菜单
-  if (item.adminOnly) return false;
+  if (item.adminOnly) {
+    return { allowed: false, denyReason: 'adminOnly' };
+  }
 
-  const sideMenus = options.sideMenus || [];
+  if (item.type === 'group') {
+    return { allowed: false, denyReason: 'groupContainer' };
+  }
 
-  // 如果没有配置 sideMenus，非超级用户没有任何菜单权限
-  if (sideMenus.length === 0) return false;
+  if (item.type === 'page') {
+    const page = getMenuPage(item);
+    if (page && !isMenuPageRequiringPermCode(page)) {
+      return { allowed: true };
+    }
+  }
 
-  // 检查是否在白名单中（精确匹配或前缀匹配）
-  return sideMenus.some((allowedPath) => {
-    // 精确匹配：菜单路径完全等于白名单中的路径
-    if (menuPath === allowedPath) return true;
-    // 前缀匹配：白名单路径以菜单路径开头（说明菜单是父级）
-    if (allowedPath.startsWith(menuPath + '.')) return true;
-    return false;
+  const menuPerms = options.menuPerms || [];
+  const code = getMenuItemPermCode(item);
+
+  if (!code) {
+    return { allowed: false, denyReason: 'missingPermCode' };
+  }
+  if (menuPerms.length === 0) {
+    return { allowed: false, denyReason: 'menuPermsEmpty' };
+  }
+  if (!menuPerms.includes(code)) {
+    return { allowed: false, denyReason: 'permCodeNotInMenuPerms' };
+  }
+  return { allowed: true };
+};
+
+const shouldLogMenuFilter = (options: MenuFilterOptions): boolean => {
+  if (isAuthDisabled()) return false;
+  if (isSuperuserUser(options.isSuperuser)) return false;
+  return true;
+};
+
+const logMenuItemHidden = (
+  item: MenuItem,
+  options: MenuFilterOptions,
+  reason: MenuFilterDenyReason,
+): void => {
+  if (!shouldLogMenuFilter(options)) return;
+
+  const permCode = getMenuItemPermCode(item);
+  layoutLogger.log('menuFilter', {
+    verdict: 'hidden',
+    reason,
+    menuId: item.id,
+    menuType: item.type,
+    name: item.name,
+    nameKey: item.nameKey,
+    permCode,
+    menuPermsCount: options.menuPerms?.length ?? 0,
+    path: item.path ?? getMenuPage(item)?.route ?? null,
   });
 };
 
@@ -171,26 +228,20 @@ const isMenuAllowed = (
 export const filterMenuItems = (
   items: MenuItem[],
   options: MenuFilterOptions = {},
-  parentPath = '',
 ): MenuItem[] => {
-  // 根据当前语言环境判断菜单标识符格式
-  const isChinese = isChineseLocale();
   return items
     .filter((item) => item.enabled)
     .map((item) => {
-      const menuPath = buildMenuPath(
-        parentPath,
-        getMenuIdentifier(item, isChinese),
-      );
-      const isAllowed = isMenuAllowed(menuPath, item, options);
+      const outcome = getMenuItemFilterOutcome(item, options);
+      const isAllowed = outcome.allowed;
 
-      // 递归处理子菜单
       const nextChildren = item.children?.length
-        ? filterMenuItems(item.children, options, menuPath)
+        ? filterMenuItems(item.children, options)
         : [];
 
       // 分组类型：如果没有子菜单，不显示
       if (item.type === 'group' && nextChildren.length === 0) {
+        logMenuItemHidden(item, options, 'groupNoVisibleChildren');
         return null;
       }
 
@@ -200,6 +251,9 @@ export const filterMenuItems = (
         if (nextChildren.length > 0) {
           return { ...item, children: nextChildren };
         }
+        if (outcome.denyReason) {
+          logMenuItemHidden(item, options, outcome.denyReason);
+        }
         return null;
       }
 
@@ -211,6 +265,7 @@ export const filterMenuItems = (
 
       // 有子菜单但过滤后为空，不显示
       if (nextChildren.length === 0) {
+        logMenuItemHidden(item, options, 'allChildrenFilteredOut');
         return null;
       }
 
@@ -265,7 +320,7 @@ export const extractRoutes = (
 
     const menuPath = buildMenuPath(parentPath, getMenuIdentifierDefault(item));
 
-    if (item.type === 'page' && item.pageId) {
+    if (item.type === 'page') {
       const page = getMenuPage(item);
       if (page && page.enabled) {
         routes.push({
@@ -273,6 +328,7 @@ export const extractRoutes = (
           base: page.base || '/',
           name: item.name,
           nameEn: item.nameEn,
+          nameKey: item.nameKey,
           icon: item.icon,
           loadType: getLoadType(page),
           entry: getEntry(page),
@@ -290,24 +346,28 @@ export const extractRoutes = (
 };
 
 /**
- * 获取菜单项的显示名称
- * 优先级：name/nameEn > nameKey（走 intl 国际化） > 兜底 name
+ * 获取菜单项的显示名称（侧栏、Tab 等）
+ * - 有 `nameKey` 时优先走 intl，**`defaultMessage` 使用 `name`（中文）或 `nameEn`/`name`（英文）作为兜底文案**
+ * - 无 `nameKey` 时直接使用 `name` / `nameEn`
  */
 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();
+    const defaultMessage = isChinese
+      ? fields.name || fields.nameKey
+      : fields.nameEn || fields.name || fields.nameKey;
     return intl.formatMessage({
       id: fields.nameKey,
-      defaultMessage: fields.nameKey,
+      defaultMessage,
     });
   }
 
+  const directName = isChinese ? fields.name : fields.nameEn;
+  if (directName) return directName;
+
   return fields.name || '';
 };
 
@@ -354,8 +414,8 @@ export const findRouteByPath = (
   routes: ParsedRoute[],
   pathname: string,
 ): ParsedRoute | undefined => {
-  const normalizedPathname = stripTrailingSlash(pathname);
   let exact: ParsedRoute | undefined;
+  const normalizedPathname = stripTrailingSlash(pathname);
   let bestWildcard: { route: ParsedRoute; basePath: string } | undefined;
 
   for (const route of routes) {
@@ -366,7 +426,10 @@ export const findRouteByPath = (
 
     if (route.path.endsWith('/*')) {
       const basePath = route.path.slice(0, -2);
-      if (normalizedPathname === basePath || normalizedPathname.startsWith(`${basePath}/`)) {
+      if (
+        normalizedPathname === basePath ||
+        normalizedPathname.startsWith(`${basePath}/`)
+      ) {
         if (!bestWildcard || basePath.length > bestWildcard.basePath.length) {
           bestWildcard = { route, basePath };
         }

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

@@ -10,13 +10,9 @@ export interface PageConfig {
   id: number;
   /** 页面名称 */
   name: string;
-  /** 英文名称（用于英文环境权限匹配） */
-  nameEn?: string;
-  /** 菜单唯一标识符（用于权限匹配的兜底） */
-  nameKey?: string;
   /** 路由路径 */
   route: string;
-  /** 路由前缀路径 */
+  /** 路由前缀路径（微应用在主应用中的挂载前缀，可与 route 不同） */
   base: string;
   /** 是否启用 */
   enabled: boolean;
@@ -34,7 +30,7 @@ export interface PageConfig {
   adminOnly?: boolean;
   /** 是否开启权限控制 */
   accessControlEnabled: boolean;
-  /** 路由权限标识（用于匹配 sideMenus） */
+  /** 路由权限标识（与用户信息 `menu_perms`、菜单项 code 一致） */
   routeKey: string | null;
   /** 关联的主文档 ID */
   mainDocumentId: number;

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

@@ -7,6 +7,37 @@
  */
 import type { MenuItem, PublicPageItem } from './menu/types';
 
+/**
+ * 根据路径查找对应的页面配置（与路由侧 `findRouteByPath` 规则一致：精确匹配 + 最长前缀通配 `/*`）
+ */
+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;
+};
+
 /** 获取页面列表 (window.__MICO_PAGES__) */
 export const getPages = (): PublicPageItem[] => {
   if (typeof window === 'undefined') return [];
@@ -39,7 +70,20 @@ export const getPageById = (pageId: number): PublicPageItem | undefined => {
   return getPageIdIndex().get(pageId);
 };
 
-/** 获取菜单项关联的页面 */
+/**
+ * 获取菜单项关联的页面
+ * - 优先按 `pageId` 在页面列表中查找
+ * - 无匹配时再用菜单跳转路径 `path` 与页面 `route` 匹配（同 `findPageByPath`）
+ */
 export const getMenuPage = (item: MenuItem): PublicPageItem | undefined => {
-  return item.pageId ? getPageById(item.pageId) : undefined;
+  if (item.type !== 'page') return undefined;
+  if (item.pageId) {
+    const byId = getPageById(item.pageId);
+    if (byId) return byId;
+  }
+  const path = item.path;
+  if (path) {
+    return findPageByPath(getPages(), path);
+  }
+  return undefined;
 };