generator-mico-cli 0.2.19 → 0.2.21

package/generators/micro-react/templates/apps/layout/docs/common-intl.md

@@ -2,7 +2,7 @@
 
 ## 概述
 
-`@portal-web/common-intl` 是 Portal 项目的通用国际化（i18n）库，用于管理多语言文案，支持从多语言中台拉取翻译数据。
+`<%= packageScope %>/common-intl` 是 Portal 项目的通用国际化（i18n）库，用于管理多语言文案，支持从多语言中台拉取翻译数据。
 
 ## 适用场景
 
@@ -10,6 +10,8 @@
 - 需要从多语言中台动态获取翻译文案
 - 希望统一管理国际化逻辑，减少重复代码
 
+> **注意**：本文档描述的是 `@payment-portal/common-intl` 包的完整使用方式，涵盖了所有使用该包的应用（包括本仓库外的应用如 conversation-v2、session、workorder 等）。当前仓库仅包含 `layout` 和 `basis` 两个应用。
+
 ## 核心特性
 
 | 特性       | 说明                                             |
@@ -22,7 +24,7 @@
 
 ## 两种使用模式
 
-根据应用架构的不同，`@portal-web/common-intl` 支持两种使用模式：
+根据应用架构的不同，`<%= packageScope %>/common-intl` 支持两种使用模式：
 
 | 模式         | 适用场景                                         | 示例应用                                                     |
 | ------------ | ------------------------------------------------ | ------------------------------------------------------------ |
@@ -64,7 +66,7 @@ import {
   getCurrentLocale,
   initIntl,
   type ILang,
-} from "@portal-web/common-intl";
+} from "<%= packageScope %>/common-intl";
 import { Message } from "@mico-platform/ui";
 import { request } from "@umijs/max";
 
@@ -100,7 +102,7 @@ export function render(oldRender: () => void): void {
 
 ```typescript
 // apps/conversation-v2、apps/session、apps/workorder 等子应用
-import { intl } from "@portal-web/common-intl";
+import { intl } from "<%= packageScope %>/common-intl";
 
 // 直接使用，文案来自主应用
 <h1>{intl.cs_web_workbench_conversation_record()}</h1>;
@@ -113,7 +115,7 @@ import { intl } from "@portal-web/common-intl";
 **独立应用配置（apps/mico-cs-mobile/src/app.ts）**：
 
 ```typescript
-import { initIntl } from "@portal-web/common-intl";
+import { initIntl } from "<%= packageScope %>/common-intl";
 import { Toast } from "@arco-design/mobile-react";
 import { request } from "@umijs/max";
 import { convertLocaleToLangParam } from "./locales/utils";
@@ -149,7 +151,7 @@ export function render(oldRender: () => void): void {
 **独立应用的文案文件（apps/mico-cs-mobile/src/locales/index.ts）**：
 
 ```typescript
-import { i18n } from "@portal-web/common-intl";
+import { i18n } from "<%= packageScope %>/common-intl";
 
 const intl = {
   sdk_h5_ticket_record: () =>
@@ -173,7 +175,7 @@ import intl from "@/locales";
 
 ## 导出 API
 
-`@portal-web/common-intl` 提供以下导出：
+`<%= packageScope %>/common-intl` 提供以下导出：
 
 | 导出                 | 类型 | 说明                                                      |
 | -------------------- | ---- | --------------------------------------------------------- |
@@ -192,18 +194,18 @@ import intl from "@/locales";
 
 ```typescript
 // 微前端子应用 - 直接使用共享的 intl 对象
-import { intl } from "@portal-web/common-intl";
+import { intl } from "<%= packageScope %>/common-intl";
 intl.cs_web_common_request_failed();
 
 // 独立应用 - 使用 i18n 函数构建自己的文案对象
-import { i18n, initIntl, LANG } from "@portal-web/common-intl";
+import { i18n, initIntl, LANG } from "<%= packageScope %>/common-intl";
 
 // 获取当前语言环境
-import { getCurrentLocale } from "@portal-web/common-intl";
+import { getCurrentLocale } from "<%= packageScope %>/common-intl";
 const currentLang = getCurrentLocale(); // 'zh_CN' | 'en' | 'ar' | 'tr'
 
 // 获取支持的语言列表
-import { SUPPORTED_LOCALES } from "@portal-web/common-intl";
+import { SUPPORTED_LOCALES } from "<%= packageScope %>/common-intl";
 console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 ```
 
@@ -212,7 +214,7 @@ console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 ### PC 端主子应用
 
 - **文案位置**：[packages/common-intl/src/intl.ts](../packages/common-intl/src/intl.ts)
-- **使用方式**：`import { intl } from '@portal-web/common-intl'`
+- **使用方式**：`import { intl } from '<%= packageScope %>/common-intl'`
 - **适用应用**：
   - apps/layout（主应用）
   - apps/conversation-v2（工作台子应用）
@@ -242,7 +244,7 @@ console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 // apps/your-app/package.json
 {
   "dependencies": {
-    "@portal-web/common-intl": "workspace:*"
+    "<%= packageScope %>/common-intl": "workspace:*"
   }
 }
 ```
@@ -252,7 +254,7 @@ console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 **如果是 layout 的子应用**：
 
 - 无需调用 `initIntl()`
-- 直接使用 `import { intl } from '@portal-web/common-intl'`
+- 直接使用 `import { intl } from '<%= packageScope %>/common-intl'`
 
 **如果是独立应用**：
 
@@ -311,17 +313,17 @@ console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 
 目前支持以下语言：
 
-| 语言常量     | 值      | 说明     |
-| ------------ | ------- | -------- |
-| `LANG.ZH_CN` | `zh_CN` | 简体中文 |
-| `LANG.EN`    | `en`    | 英语     |
-| `LANG.AR`    | `ar`    | 阿拉伯语 |
-| `LANG.TR`    | `tr`    | 土耳其语 |
+| 语言常量      | 值      | 说明     |
+| ------------- | ------- | -------- |
+| `LANG.ZH_CN`  | `zh_CN` | 简体中文 |
+| `LANG.EN_US`  | `en`    | 英语     |
+| `LANG.AR_SA`  | `ar`    | 阿拉伯语 |
+| `LANG.TR_TR`  | `tr`    | 土耳其语 |
 
 ### Q: 如何在代码中获取当前语言？
 
 ```typescript
-import { getCurrentLocale } from "@portal-web/common-intl";
+import { getCurrentLocale } from "<%= packageScope %>/common-intl";
 
 const currentLang = getCurrentLocale();
 if (currentLang === "ar") {

package/generators/micro-react/templates/apps/layout/docs/feature-/344/270/273/351/242/230/350/211/262/345/210/207/346/215/242.md

@@ -201,7 +201,7 @@ wc -c apps/[子应用]/dist/umi.css
 1. 主应用加载 @mico-platform/ui 并暴露到 `window.micoUI`
 2. 主应用的样式包含 `arco-theme` 属性选择器（基于 Arco）
 3. 主应用切换主题时设置 `body[arco-theme="dark"]`
-4. 子应用的 UI 组件（来自 window.micoUi）自动应用暗色样式
+4. 子应用的 UI 组件（来自 window.micoUI）自动应用暗色样式
 
 #### 子应用使用 @mico-platform/ui
 

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

@@ -28,16 +28,16 @@
 
 ### 核心文件
 
-| 文件路径                                            | 说明                             |
-| --------------------------------------------------- | -------------------------------- |
-| `src/components/MicroAppLoader/index.tsx`           | qiankun 微应用加载器组件         |
-| `src/components/MicroAppLoader/container-manager.ts`| 容器生命周期管理、会话 ID 机制   |
-| `src/components/MicroAppLoader/index.less`          | 加载器样式                       |
-| `src/common/menu/parser.ts`                         | 菜单解析，包含加载类型判断       |
-| `src/common/menu/types.ts`                          | 类型定义                         |
-| `src/layouts/index.tsx`                             | 主布局，集成微应用渲染           |
-| `src/app.tsx`                                       | qiankun 全局错误处理             |
-| `config/config.ts`                                  | qiankun master 配置              |
+| 文件路径 | 说明 |
+| --- | --- |
+| `src/components/MicroAppLoader/index.tsx` | qiankun 微应用加载器组件 |
+| `src/components/MicroAppLoader/micro-app-manager.ts` | 微应用管理器（单例），稳定容器 + 实例缓存 + 操作序列号 |
+| `src/components/MicroAppLoader/index.less` | 加载器样式 |
+| `src/common/menu/parser.ts` | 菜单解析，包含加载类型判断 |
+| `src/common/menu/types.ts` | 类型定义 |
+| `src/layouts/index.tsx` | 主布局，集成微应用渲染 |
+| `src/app.tsx` | qiankun 全局错误处理 |
+| `config/config.ts` | qiankun master 配置 |
 
 ## API / 组件接口
 
@@ -70,7 +70,7 @@ interface MicroAppLoaderProps {
 ```typescript
 interface MicroAppProps {
   /** 主应用标识 */
-  mainApp: 'portal-web';
+  mainApp: '<%= projectName %>';
   /** 运行环境 */
   env: 'development' | 'testing' | 'production';
   /** 认证 token */
@@ -462,52 +462,77 @@ addGlobalUncaughtErrorHandler((event: Event | string) => {
 });
 ```
 
-### container-manager API
+### MicroAppManager API (micro-app-manager.ts)
 
-容器管理器提供会话 ID 机制防止并发加载冲突：
+`MicroAppManager` 是单例类，管理微应用的加载、缓存、切换和卸载：
 
 ```typescript
-/** 开始加载会话，返回唯一会话 ID */
-function startLoadSession(appName: string): number;
+interface MicroAppConfig {
+  name: string;
+  entry: string;
+  target: HTMLElement;       // 目标挂载位置
+  props: Record<string, unknown>;
+}
+
+interface MicroAppState {
+  loading: boolean;
+  error: string | null;
+  mounted: boolean;
+}
+
+const manager = microAppManager; // 单例，导出即用
 
-/** 检查会话是否仍然有效（被新加载覆盖时返回 false） */
-function isLoadSessionValid(appName: string, sessionId: number): boolean;
+/** 切换到指定微应用（已挂载则仅更新 props） */
+manager.switchTo(config: MicroAppConfig): void;
 
-/** 标记加载完成 */
-function markLoadComplete(appName: string, sessionId: number): boolean;
+/** 更新当前已挂载微应用的 props */
+manager.updateProps(props: Record<string, unknown>): void;
 
-/** 等待当前卸载操作完成（如果有） */
-async function waitForUnmount(appName: string): Promise<void>;
+/** 取消待处理的请求 */
+manager.cancel(): void;
 
-/** 获取当前加载状态 */
-function getLoadingStatus(appName: string): 'idle' | 'loading' | 'mounted' | 'unmounting';
+/** 清除所有缓存实例 */
+manager.clearCache(): Promise<void>;
+
+/** 获取调试信息 */
+manager.getDebugInfo(): object;
+
+/** 设置状态变化回调 */
+manager.setStateCallback(callback: StateChangeCallback | null): void;
 ```
 
+### 核心设计
+
+1. **稳定容器**：容器在 `document.body` 中创建，激活时移到目标元素内，停用时移回 body 隐藏，不受 React 生命周期影响
+2. **实例缓存**：每个 entry 只 `loadMicroApp` 一次，后续切换复用已有实例（mount/unmount）
+3. **操作序列号**：通过递增的 `operationSeq` 检测过期操作，替代旧的会话 ID 机制
+4. **自动路由守卫**：由独立的 `route-guard.ts` 自动检测用户意图，业务代码无需感知
+
 ### 快速切换时序
 
 ```
 场景：A → B → A 快速切换
 
-A1 开始加载 (sessionId=1)
-  ↓
-切换到 B，A1 cleanup 在 queueMicrotask 中执行
+switchTo(A)：operationSeq=1，开始 loadMicroApp
   ↓
-切换回 A，A2 开始加载 (sessionId=2)
+switchTo(B)：operationSeq=2，A 的 pendingRequest 被替换
   ↓
-A2 调用 waitForUnmount()，等待 A1 完全卸载
+A 的 processRequest 在异步步骤中检测 shouldAbort(mySeq=1) → true
   ↓
-A1 卸载完成（带 10 秒超时保护）
+A 等待 mountPromise 完成后执行 safeUnmount，容器移回 body
   ↓
-A2 继续加载，每个异步步骤检查 isLoadSessionValid(sessionId)
+B 开始 processRequest，检查缓存 → 无缓存 → loadMicroApp
   ↓
-加载完成后立即同步最新 Props（locale/timezone 等）
+B 加载完成后同步最新 Props（locale/timezone/routePath 等）
 ```
 
 ### 设计决策
 
 | 决策点 | 选择 | 理由 |
-|--------|------|------|
-| 卸载时机 | `queueMicrotask` | 在当前事件循环末尾执行，比 `requestAnimationFrame` 更快更可靠 |
-| 并发控制 | 会话 ID 机制 | 简单高效，无需复杂的锁机制 |
-| 超时时间 | 10 秒 | 平衡等待时间与异常检测速度 |
-| Props 同步 | 加载后立即同步 | 确保加载期间的变化不丢失 |
+| --- | --- | --- |
+| 容器策略 | 稳定容器（body 中创建，移动挂载） | 不受 React 生命周期影响，避免容器被意外销毁 |
+| 并发控制 | 操作序列号 + pendingRequest 队列 | 简单高效，新请求自动覆盖旧请求 |
+| 实例缓存 | loadPromise 完成后立即缓存 | 即使被 abort 也可复用，避免重复加载 |
+| unmount 安全 | 等待 mountPromise 完成后再 unmount | 避免 single-spa error #32 |
+| 超时保护 | load 30s / mount 30s / unmount 10s | 平衡等待时间与异常检测速度 |
+| Props 同步 | mount 完成后立即 safeUpdate | 确保加载期间的变化不丢失 |

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,6 +1,6 @@
 # 菜单权限控制
 
-> 创建时间：2026-01-24 更新时间：2026-01-27
+> 创建时间：2026-01-24 更新时间：2026-02-08
 
 ## 功能概述
 
@@ -92,6 +92,10 @@
     ├── 是 → 允许访问所有菜单
     │
     ▼
+菜单项 adminOnly === true？
+    ├── 是 → 禁止访问（仅超级管理员可见）
+    │
+    ▼
 检查 side_menus 白名单
     ├── 精确匹配：menuPath === side_menus[i]
     ├── 前缀匹配：side_menus[i].startsWith(menuPath + '.')
@@ -241,7 +245,7 @@ export const NO_PERMISSION_ROUTE_LIST: string[] = ['/403', '/404'];
 │   └── 配置队列     ✅ 精确匹配 "列队管理.配置队列"
 ├── 质量管理         ❌ 不在白名单
 │   └── 抽样检查     ❌ 不在白名单
-└── 权限管理         ❌ 硬编码禁止（非超级用户）
+└── 权限管理         ❌ adminOnly=true，非超级用户不可见
 ```
 
 ### Layout 中的权限判断
@@ -288,6 +292,7 @@ if (!isAuthReady) {
 | 免权限路由的菜单 | 显示全部 | 用户访问公开页面时应能看到所有导航选项 |
 | 免权限路由的子应用 | 直接加载 | 不等待 currentUser，避免加载卡住 |
 | 静态路由不受权限控制 | 默认允许访问 | 见下方"静态路由与动态路由"说明 |
+| adminOnly 判断 | 读取菜单数据字段 | 替代硬编码菜单名称匹配，由后端数据驱动，支持多语言且无需前端维护 |
 
 ## 静态路由与动态路由
 

package/generators/micro-react/templates/apps/layout/docs/utils-timezone.md

@@ -307,12 +307,13 @@ getCurrentTimezone() / getTimezone()
    }
    ```
 
+
 ## 文件清单
 
 | 文件路径 | 说明 |
-|----------|------|
+| --- | --- |
 | `apps/layout/src/common/helpers.ts` | 时区工具函数实现 |
-| `apps/layout/src/common/auth/type.ts` | 存储键常量定义（`STORAGE_KEYS.TIMEZONE` 等） |
+| `apps/layout/src/constants/index.ts` | 存储键常量定义（`TIMEZONE`、`STORAGE_KEYS` 等） |
 | `apps/layout/src/services/config/index.ts` | 时区列表 API 服务 |
 | `apps/layout/src/services/config/type.ts` | 时区类型定义 |
 | `apps/layout/src/components/RightContent/AvatarDropdown.tsx` | 时区切换 UI 组件 |
@@ -320,3 +321,4 @@ getCurrentTimezone() / getTimezone()
 ## 相关文档
 
 - [AvatarDropdown 组件](../apps/layout/docs/feature-avatar-dropdown.md)
+

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

@@ -21,7 +21,10 @@
 import type { MenuItem, PageConfig } from '@/common/menu/types';
 
 /** Mock 页面配置 - 只需要核心字段 */
-type MockPageConfig = Pick<PageConfig, 'id' | 'name' | 'route' | 'enabled' | 'htmlUrl' | 'jsUrls' | 'cssUrls'>;
+type MockPageConfig = Pick<PageConfig,
+  | 'id' | 'name' | 'route' | 'enabled' | 'htmlUrl' | 'jsUrls' | 'cssUrls'
+  | 'adminOnly'
+>;
 
 /** Mock 菜单项 - page 字段使用简化类型，包含多语言字段 */
 type MockMenuItem = Omit<MenuItem, 'page' | 'children'> & {
@@ -155,12 +158,14 @@ const mockMenus: MockMenuItem[] = [
     "enabled": true,
     "sortOrder": 3,
     "pageId": null,
+    "adminOnly": true,
     "page": {
       "id": 8,
       "name": "permission",
       "route": "/permission",
       "enabled": true,
-      "htmlUrl": "//localhost:8010",
+      "adminOnly": true,
+      "htmlUrl": "https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.1/permission/index.html",
       "jsUrls": [],
       "cssUrls": []
     },

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

@@ -25,8 +25,6 @@
     "@mico-platform/ui": "<%= micoUiVersion %>",
     "@mico-platform/theme": "<%= themeVersion %>",
     "@umijs/max": "^4.6.15",
-    "babel-plugin-dynamic-import-node": "^2.3.3",
-    "cross-env": "^10.1.0",
     "dayjs": "^1.11.19",
     "qiankun": "^2.10.16",
     "react": "^18.2.0",
@@ -37,6 +35,9 @@
     "@types/react": "^18.0.33",
     "@types/react-dom": "^18.0.11",
     "@types/spark-md5": "^3.0.5",
+    "babel-plugin-dynamic-import-node": "^2.3.3",
+    "babel-plugin-import": "^1.13.8",
+    "cross-env": "^10.1.0",
     "lint-staged": "^13.2.0",
     "prettier": "^2.8.7",
     "prettier-plugin-organize-imports": "^3.2.2",

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

@@ -122,7 +122,7 @@ export function setLocaleToStorage(locale: SupportedLocale): void {
 /**
  * 根据语言获取图标库路径
  */
-export function getIconFontPath(locale: SupportedLocale): string {
-  // 如果后续需要支持 RTL 语言（如阿拉伯语），可在此扩展
-  return withPublicPath('/font/default.js');
+export function getIconFontPath(/* locale: SupportedLocale */): string {
+	// 如果后续需要支持 RTL 语言（如阿拉伯语），可在此扩展
+	return withPublicPath("/font/default.js");
 }

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

@@ -55,14 +55,11 @@ export const getMenuIdentifier = (
   return item.nameEn || item.nameKey || '';
 };
 
-// 权限管理菜单的多格式标识符（用于硬编码权限判断）
-const PERMISSION_MENU_IDENTIFIERS = ['权限管理', 'Permission', 'permission'];
-
 /**
  * 检查菜单路径是否允许访问（白名单逻辑）
  * - 免权限校验路由，始终允许访问
  * - 超级用户可以访问所有菜单
- * - 非超级用户不能访问"权限管理"
+ * - 非超级用户不能访问 adminOnly 菜单
  * - 菜单路径在 sideMenus 中，或是 sideMenus 中某项的前缀（父级菜单）
  */
 const isMenuAllowed = (
@@ -82,11 +79,8 @@ const isMenuAllowed = (
   // 超级用户可以访问所有菜单
   if (isSuperuserUser(options.isSuperuser)) return true;
 
-  // 非超级用户不能访问"权限管理"（支持多格式匹配）
-  if (PERMISSION_MENU_IDENTIFIERS.includes(menuPath)) return false;
-
-  // 非超级用户不能访问"权限管理"
-  if (menuPath === '权限管理') return false;
+  // 非超级用户不能访问 adminOnly 菜单
+  if (item.adminOnly) return false;
 
   const sideMenus = options.sideMenus || [];
 
@@ -103,12 +97,6 @@ const isMenuAllowed = (
   });
 };
 
-export const isRouteAllowed = (
-  menuPath: string,
-  options: MenuFilterOptions = {},
-): boolean => {
-  return isMenuAllowed(menuPath, options);
-};
 /**
  * 根据权限过滤菜单项（白名单逻辑）
  */

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

@@ -28,6 +28,8 @@ export interface PageConfig {
   prefixPath: string;
   /** 路由匹配模式 */
   routeMode: PageRouteMode;
+  /** 是否仅超级管理员可见 */
+  adminOnly?: boolean;
   /** 关联的主文档 ID */
   mainDocumentId: number;
   /** 所属工作空间子域名 */
@@ -67,6 +69,8 @@ export interface MenuItem {
   pageId: number | null;
   /** 页面配置（type=page 时存在） */
   page: PageConfig | null;
+  /** 是否仅超级管理员可见 */
+  adminOnly?: boolean;
   children: MenuItem[];
 }
 

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

@@ -70,7 +70,7 @@ const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
   const buildProps = useCallback(() => {
     const authInfo = getAuthInfo();
     return {
-      mainApp: 'portal-web',
+      mainApp: '<%= projectName %>',
       env,
       authToken: authInfo.token,
       uid: authInfo.uid,

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

@@ -7,8 +7,7 @@
   box-sizing: border-box;
 }
 
-#<%= projectName %> {
-  height: 100vh;
-  min-height: 800px;
+#root {
+  min-height: 100vh;
   display: flex;
 }

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

@@ -13,11 +13,9 @@ export interface ITimezone {
 }
 
 /**
- * 获取时区配置请求
+ * 获取时区配置请求（空请求体）
  */
-export interface IGetTimezoneListRequest {
-  // 空请求体
-}
+export type IGetTimezoneListRequest = Record<string, never>;
 
 /**
  * 获取时区配置响应

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

@@ -24,13 +24,16 @@
     "lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --fix && turbo run lint:fix",
     "check-types": "turbo run check-types",
     "lint-staged": "pnpm exec lint-staged --quiet",
-    "prepare": "husky install",
+    "prepare": "husky",
     "test": "dotenv -e .env -e .env.local -- turbo run test",
-    "create:umi-app": "./scripts/create-umi-app.sh"
+    "create:umi-app": "./scripts/create-umi-app.sh",
+    "upgrade:mico": "npx @mico-platform/mico-up"
   },
   "devDependencies": {
     "@commitlint/cli": "^19.5.0",
     "@commitlint/config-conventional": "^19.5.0",
+		"@typescript-eslint/eslint-plugin": "^8.54.0",
+		"@typescript-eslint/parser": "^8.54.0",
     "dotenv-cli": "^7.4.1",
     "eslint": "^8.57.0",
     "husky": "^9.1.7",

package/generators/micro-react/templates/packages/common-intl/README.md

@@ -1,4 +1,4 @@
-# @portal-web/common-intl
+# <%= packageScope %>/common-intl
 
 通用国际化（i18n）库，用于 Portal 多应用间的多语言文案管理。
 
@@ -18,14 +18,14 @@
 ```json
 {
   "dependencies": {
-    "@portal-web/common-intl": "workspace:*"
+    "<%= packageScope %>/common-intl": "workspace:*"
   }
 }
 ```
 
 ## 两种使用模式
 
-根据应用架构的不同，`@portal-web/common-intl` 支持两种使用模式：
+根据应用架构的不同，`<%= packageScope %>/common-intl` 支持两种使用模式：
 
 | 模式         | 适用场景                                         | 示例应用                                                     |
 | ------------ | ------------------------------------------------ | ------------------------------------------------------------ |
@@ -49,7 +49,7 @@ import {
   getCurrentLocale,
   initIntl,
   type ILang,
-} from "@portal-web/common-intl";
+} from "<%= packageScope %>/common-intl";
 import { Message } from "@mico-platform/ui";
 import { request } from "@umijs/max";
 
@@ -85,7 +85,7 @@ export function render(oldRender: () => void): void {
 
 ```typescript
 // apps/conversation-v2、apps/session、apps/workorder 等子应用
-import { intl } from "@portal-web/common-intl";
+import { intl } from "<%= packageScope %>/common-intl";
 
 // 直接使用，文案来自主应用
 <h1>{intl.cs_web_workbench_conversation_record()}</h1>;
@@ -98,7 +98,7 @@ import { intl } from "@portal-web/common-intl";
 **独立应用配置**（参考 `apps/mico-cs-mobile/src/app.ts`）：
 
 ```typescript
-import { initIntl } from "@portal-web/common-intl";
+import { initIntl } from "<%= packageScope %>/common-intl";
 import { request } from "@umijs/max";
 import { convertLocaleToLangParam } from "./locales/utils";
 import { getSearchParams } from "@/common/jsbridge/jsbridge";
@@ -140,7 +140,7 @@ export function render(oldRender: () => void): void {
 **独立应用的文案文件**（`apps/mico-cs-mobile/src/locales/index.ts`）：集中管理所有国际化文案
 
 ```typescript
-import { i18n } from "@portal-web/common-intl";
+import { i18n } from "<%= packageScope %>/common-intl";
 
 const intl = {
   // 无插值示例
@@ -395,7 +395,7 @@ const intl = {
 2. 在业务代码中使用：
 
 ```typescript
-import { intl } from "@portal-web/common-intl";
+import { intl } from "<%= packageScope %>/common-intl";
 
 // 使用新 key
 intl.cs_web_your_new_key();