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

package/generators/micro-react/templates/.cursor/rules/theme-system.mdc

@@ -18,7 +18,7 @@ globs: ["**/themes/**", "**/useTheme**", "**/*.less"]
 │  └─────────────────────────────────────────────────────────┘│
 │                           ↓                                  │
 │  ┌─────────────────────────────────────────────────────────┐│
-│  │  body[arco-theme="dark"]  → Arco Design 组件            ││
+│  │  body[arco-theme="dark"]  → @mico-platform/ui 组件       ││
 │  │  body[data-theme="dark"]  → 自定义 CSS 变量             ││
 │  └─────────────────────────────────────────────────────────┘│
 └─────────────────────────────────────────────────────────────┘
@@ -28,12 +28,10 @@ globs: ["**/themes/**", "**/useTheme**", "**/*.less"]
 
 | 文件 | 说明 |
 |------|------|
-| `packages/shared-styles/` | **共享样式包（主应用和子应用共用）** |
-| `packages/shared-styles/index.less` | 入口文件，导入全部样式 |
-| `packages/shared-styles/variables.less` | Less 变量定义 |
-| `packages/shared-styles/themes/normal/custom-var.less` | 亮色主题变量 |
-| `packages/shared-styles/themes/dark/custom-var.less` | 暗黑主题变量 |
-| `packages/shared-styles/arco-override.less` | Arco Design 变量覆盖 |
+| `@mico-platform/theme` | **主题包（主应用和子应用共用）** |
+| `@mico-platform/theme` | 主入口，CSS 变量 + Less 变量 |
+| `@mico-platform/theme/variables` | 仅 Less 变量（子应用用） |
+| `@mico-platform/theme/theme-inject` | 子应用独立运行时注入主题 |
 | `apps/layout/src/hooks/useTheme.ts` | 主题管理 Hook |
 | `apps/layout/src/common/theme.ts` | 主题初始化 |
 
@@ -54,7 +52,7 @@ interface UseThemeReturn {
 ### 使用示例
 ```tsx
 import { useTheme } from '@/hooks/useTheme';
-import { IconSun, IconMoon } from '@arco-design/web-react/icon';
+import { IconSun, IconMoon } from '@mico-platform/ui/ic';
 
 const ThemeToggle: React.FC = () => {
   const { isDark, toggleTheme } = useTheme();
@@ -124,7 +122,7 @@ body[data-theme='dark'] {
 
 ## 主要颜色变量
 
-> 完整列表见：[shared-styles 包](packages/shared-styles/README.md#主要变量)
+> 完整列表见：@mico-platform/theme 包文档
 
 | 分类 | 变量 | 说明 |
 |------|------|------|
@@ -139,7 +137,7 @@ body[data-theme='dark'] {
 ```typescript
 const applyTheme = (theme: Theme) => {
   if (theme === 'dark') {
-    // Arco Design 暗黑模式
+    // @mico-platform/ui 暗黑模式（arco-theme）
     document.body.setAttribute('arco-theme', 'dark');
     // 自定义 CSS 变量
     document.body.setAttribute('data-theme', 'dark');
@@ -178,7 +176,7 @@ const getStoredTheme = (): Theme => {
 
 ```less
 // global.less - 仅导入 Less 变量（不打包 CSS 变量）
-@import '<%= packageScope %>/shared-styles/variables-only';
+@import '@mico-platform/theme/variables';
 ```
 
 ```typescript
@@ -203,4 +201,4 @@ if (process.env.NODE_ENV === 'development') {
 3. **优先 Less 变量**: 使用 Less 变量有编辑器提示和类型检查
 4. **避免硬编码颜色**: 所有颜色都应使用主题变量
 5. **系统跟随**: 未手动设置主题时会跟随系统偏好变化
-6. **子应用共享**: 子应用使用 `<%= packageScope %>/shared-styles` 包复用主题
+6. **子应用共享**: 子应用使用 `@mico-platform/theme` 包复用主题

package/generators/micro-react/templates/.eslintrc.js

@@ -19,12 +19,36 @@ module.exports = {
       },
     ],
   },
-  // 忽略 apps/ 子包和 scripts/
+	// TypeScript 文件使用专门的 parser
+	overrides: [
+		{
+			files: ["*.ts", "*.tsx"],
+			parser: "@typescript-eslint/parser",
+			plugins: ["@typescript-eslint"],
+			extends: [
+				"eslint:recommended",
+				"plugin:@typescript-eslint/recommended",
+			],
+			rules: {
+				// 使用 TS 版本的 no-unused-vars
+				"no-unused-vars": "off",
+				"@typescript-eslint/no-unused-vars": [
+					"warn",
+					{
+						argsIgnorePattern: "^_",
+						varsIgnorePattern: "^_",
+					},
+				],
+			},
+		},
+	],
+  // 忽略 apps/ 子包和 scripts/，apps由内部的eslint规则处理
   ignorePatterns: [
     'node_modules/',
     'dist/',
     'apps/',
     'scripts/',
+    '**/*.d.ts',
   ],
 };
 

package/generators/micro-react/templates/AGENTS.md

@@ -4,7 +4,7 @@
 
 - `apps/` 存放业务应用。当前应用：`apps/layout/`（主应用）、`apps/subapp/`（子应用）。
 - 应用源码位于 `apps/<app>/src/`，包含 `pages/`、`layouts/`、`components/`、`common/`、`hooks/`、`styles/` 等目录。
-- `packages/` 存放共享包，如 `packages/shared-styles/`（共享样式）。
+- `packages/` 可存放其他共享包。
 - `scripts/` 包含仓库工具脚本（如 `scripts/dev.js`、`scripts/collect-dist.js`）。
 - `docs/` 存放工作流文档；`CICD/` 包含部署相关资源。
 - `dist/` 是生成的构建产物（收集于仓库根目录）。
@@ -14,7 +14,7 @@
 - **Monorepo**：Turborepo + pnpm Workspace
 - **前端框架**：UmiJS 4 / @umijs/max、React 18、TypeScript
 - **微前端**：qiankun
-- **UI 组件**：Arco Design Web
+- **UI 组件**：@mico-platform/ui
 - **样式方案**：Tailwind CSS + Less
 - **代码规范**：ESLint、Stylelint、Husky、Commitlint
 
@@ -22,6 +22,9 @@
 
 - `pnpm install` 安装 workspace 依赖。
 - `pnpm dev` 运行交互式开发启动器（选择应用）。
+- `pnpm dev:preset` 根据 `dev.preset.json` 配置，一次性并行启动多个应用。
+- `pnpm dev:preset <preset>` 使用指定预设启动多应用。
+- `pnpm list:preset` 列出所有可用的启动预设。
 - `pnpm -C apps/<app> dev` 直接运行指定应用。
 - `pnpm build` 构建所有应用用于生产环境；`pnpm build:development|testing|production|local` 设置不同环境模式。
 - `pnpm lint` 运行 ESLint + Turbo lint 检查；`pnpm lint:fix` 自动修复。

package/generators/micro-react/templates/CICD/before_build.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+
+# 计算当前构建分支的 BASE_REF，并为 Turbo 增量构建准备 TURBO_FILTER
+# 该脚本会被其他脚本 source 调用，不要在这里直接 exit 1
+
+set -e
+
+# 获取项目根目录（如果调用方已设置 PROJECT_ROOT，则使用；否则使用当前工作目录）
+PROJECT_ROOT="${PROJECT_ROOT:-$(pwd)}"
+
+# 获取当前构建的分支（去掉 origin/ 前缀，用于比较）
+# 优先使用环境变量 CURRENT_BRANCH（Jenkins 传入，格式可能是 origin/main、origin/feat/xxx）
+# 其次使用 BRANCH_OR_TAG，最后从 git 获取
+if [ -n "${CURRENT_BRANCH}" ]; then
+  CURRENT_BRANCH_NAME="${CURRENT_BRANCH#origin/}"  # 去掉 origin/ 前缀
+elif [ -n "${BRANCH_OR_TAG}" ]; then
+  CURRENT_BRANCH_NAME="${BRANCH_OR_TAG#origin/}"  # 去掉 origin/ 前缀
+else
+  CURRENT_BRANCH_NAME="$(git rev-parse --abbrev-ref HEAD)"
+fi
+
+echo "[before_build] Current branch (without origin/): ${CURRENT_BRANCH_NAME}"
+
+# 比较当前分支和上次成功构建的分支是否一致
+# LAST_SUCCESS_BRANCH 由 Jenkins 在构建时设置（从上次构建的结果中获取，格式可能是 origin/main、origin/feat/xxx）
+if [ -n "${LAST_SUCCESS_BRANCH}" ]; then
+  # 去掉 LAST_SUCCESS_BRANCH 的 origin/ 前缀，用于比较
+  LAST_SUCCESS_BRANCH_NAME="${LAST_SUCCESS_BRANCH#origin/}"
+  echo "[before_build] Last success branch (without origin/): ${LAST_SUCCESS_BRANCH_NAME}"
+  
+  if [ "${CURRENT_BRANCH_NAME}" != "${LAST_SUCCESS_BRANCH_NAME}" ]; then
+    # 分支不一致，需要全量构建
+    echo "[before_build] Branch changed: ${LAST_SUCCESS_BRANCH_NAME} -> ${CURRENT_BRANCH_NAME}, will perform full build (no filter)"
+    unset TURBO_FILTER
+  else
+    # 分支一致，尝试使用 PREVIOUS_COMMIT 进行增量构建
+    echo "[before_build] Branch unchanged: ${CURRENT_BRANCH_NAME}, checking PREVIOUS_COMMIT for incremental build"
+    if [ -n "${PREVIOUS_COMMIT}" ]; then
+      # 验证 commit 是否存在且有效
+      if git rev-parse --verify "${PREVIOUS_COMMIT}" >/dev/null 2>&1; then
+        # 关键检查：验证 PREVIOUS_COMMIT 是否是当前 HEAD 的祖先
+        # 这可以避免以下问题：
+        # 1. Rebase/Force push：PREVIOUS_COMMIT 不再是当前分支的祖先
+        # 2. Tag 被其他分支更新：PREVIOUS_COMMIT 不是当前分支的祖先
+        CURRENT_HEAD="$(git rev-parse HEAD)"
+        if git merge-base --is-ancestor "${PREVIOUS_COMMIT}" "${CURRENT_HEAD}" 2>/dev/null; then
+          # PREVIOUS_COMMIT 是当前 HEAD 的祖先，可以安全使用
+          BASE_REF="${PREVIOUS_COMMIT}"
+          echo "[before_build] Use PREVIOUS_COMMIT as BASE_REF: ${BASE_REF} (ancestor check passed)"
+          # 为 turbo --filter 准备语法形如 ...[<BASE_REF>]
+          TURBO_FILTER="...[${BASE_REF}]"
+          export TURBO_FILTER
+          echo "[before_build] TURBO_FILTER=${TURBO_FILTER} (incremental build)"
+        else
+          # PREVIOUS_COMMIT 不是当前 HEAD 的祖先，降级为全量构建
+          echo "[before_build] Warning: PREVIOUS_COMMIT=${PREVIOUS_COMMIT} is not an ancestor of HEAD=${CURRENT_HEAD}"
+          echo "[before_build] Possible reasons: rebase/force-push, tag updated by another branch, or shallow clone issue"
+          echo "[before_build] Falling back to full build (no filter)"
+          unset TURBO_FILTER
+        fi
+      else
+        echo "[before_build] Warning: PREVIOUS_COMMIT=${PREVIOUS_COMMIT} is not a valid commit, will perform full build"
+        unset TURBO_FILTER
+      fi
+    else
+      # PREVIOUS_COMMIT 未设置，进行全量构建
+      echo "[before_build] PREVIOUS_COMMIT not set, will perform full build (no filter)"
+      unset TURBO_FILTER
+    fi
+  fi
+else
+  # LAST_SUCCESS_BRANCH 未设置，说明是第一次构建或 Jenkins 未配置该环境变量
+  echo "[before_build] LAST_SUCCESS_BRANCH not set, will perform full build (no filter)"
+  # 不设置 TURBO_FILTER，这样 package.json 中的 ${TURBO_FILTER:+--filter=${TURBO_FILTER}} 不会生效
+  unset TURBO_FILTER
+fi

package/generators/micro-react/templates/CICD/start_dev.sh

@@ -20,11 +20,35 @@ echo "项目版本: $VERSION"
 # 切换到项目根目录，确保后续命令在根目录下运行
 cd "$PROJECT_ROOT"
 
+# 导出 PROJECT_ROOT 供 before_build.sh 使用
+export PROJECT_ROOT
+
+# 在执行构建前，计算 BASE_REF / TURBO_FILTER 等增量构建信息
+if [ -f "$PROJECT_ROOT/CICD/before_build.sh" ]; then
+  # shellcheck disable=SC1090
+  source "$PROJECT_ROOT/CICD/before_build.sh"
+fi
+
 # 设置子应用的 CDN 公共路径（开发环境）
-export CDN_PUBLIC_PATH="https://cdn-portal-dev.micoplatform.com/<%= projectName %>/${VERSION}/"
+# 路径格式: https://cdn-xxx.com/<prefix>/<projectName>/<version>/
+export CDN_PUBLIC_PATH="https://cdn-portal-dev.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/${VERSION}/"
 echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"
 
-pnpm run build:development
+# 开发环境，不上传 sourcemap。调试时如有需要再解开
+# # ========== Sentry Auth Token ==========
+# # SENTRY_AUTH_TOKEN 从 Jenkins 服务器文件读取（敏感信息，不写在脚本中）
+# SENTRY_TOKEN_FILE="/var/lib/jenkins/.portal_sentry_auth_token"
+# if [ -f "$SENTRY_TOKEN_FILE" ]; then
+#   export SENTRY_AUTH_TOKEN=$(cat "$SENTRY_TOKEN_FILE")
+# fi
 
-echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+# if [ -z "$SENTRY_AUTH_TOKEN" ]; then
+#   echo "警告：SENTRY_AUTH_TOKEN 未设置（文件 $SENTRY_TOKEN_FILE 不存在），跳过 sourcemap 上传"
+# fi
+
+pnpm run build:development
 
+# 只有在 CI 环境时才写入版本号文件（覆盖写入）
+if [ "${CI}" = "true" ]; then
+  echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+fi

package/generators/micro-react/templates/CICD/start_prod.sh

@@ -20,11 +20,34 @@ echo "项目版本: $VERSION"
 # 切换到项目根目录，确保后续命令在根目录下运行
 cd "$PROJECT_ROOT"
 
+# 导出 PROJECT_ROOT 供 before_build.sh 使用
+export PROJECT_ROOT
+
+# 在执行构建前，计算 BASE_REF / TURBO_FILTER 等增量构建信息（用于增量构建）
+if [ -f "$PROJECT_ROOT/CICD/before_build.sh" ]; then
+  # shellcheck disable=SC1090
+  source "$PROJECT_ROOT/CICD/before_build.sh"
+fi
+
 # 设置子应用的 CDN 公共路径（生产环境）
-export CDN_PUBLIC_PATH="https://cdn-portal.micoplatform.com/<%= projectName %>/${VERSION}/"
+# 路径格式: https://cdn-xxx.com/<prefix>/<projectName>/<version>/
+export CDN_PUBLIC_PATH="https://cdn-portal.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/${VERSION}/"
 echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"
 
-pnpm run build:production
+# ========== Sentry Auth Token ==========
+# SENTRY_AUTH_TOKEN 从 Jenkins 服务器文件读取（敏感信息，不写在脚本中）
+SENTRY_TOKEN_FILE="/var/lib/jenkins/.portal_sentry_auth_token"
+if [ -f "$SENTRY_TOKEN_FILE" ]; then
+  export SENTRY_AUTH_TOKEN=$(cat "$SENTRY_TOKEN_FILE")
+fi
 
-echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+if [ -z "$SENTRY_AUTH_TOKEN" ]; then
+  echo "警告：SENTRY_AUTH_TOKEN 未设置（文件 $SENTRY_TOKEN_FILE 不存在），跳过 sourcemap 上传"
+fi
+
+pnpm run build:production
 
+# 只有在 CI 环境时才写入版本号文件（覆盖写入）
+if [ "${CI}" = "true" ]; then
+  echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+fi

package/generators/micro-react/templates/CICD/start_test.sh

@@ -20,11 +20,36 @@ echo "项目版本: $VERSION"
 # 切换到项目根目录，确保后续命令在根目录下运行
 cd "$PROJECT_ROOT"
 
+# 导出 PROJECT_ROOT 供 before_build.sh 使用
+export PROJECT_ROOT
+
+# 在执行构建前，计算 BASE_REF / TURBO_FILTER 等增量构建信息
+if [ -f "$PROJECT_ROOT/CICD/before_build.sh" ]; then
+  # shellcheck disable=SC1090
+  source "$PROJECT_ROOT/CICD/before_build.sh"
+fi
+
+
 # 设置子应用的 CDN 公共路径（测试环境）
-export CDN_PUBLIC_PATH="https://cdn-portal-test.micoplatform.com/<%= projectName %>/${VERSION}/"
+# 路径格式: https://cdn-xxx.com/<prefix>/<projectName>/<version>/
+export CDN_PUBLIC_PATH="https://cdn-portal-test.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/${VERSION}/"
 echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"
 
-pnpm run build:testing
+# 测试环境，不上传 sourcemap。调试时如有需要再解开
+# # ========== Sentry Auth Token ==========
+# # SENTRY_AUTH_TOKEN 从 Jenkins 服务器文件读取（敏感信息，不写在脚本中）
+# SENTRY_TOKEN_FILE="/var/lib/jenkins/.portal_sentry_auth_token"
+# if [ -f "$SENTRY_TOKEN_FILE" ]; then
+#   export SENTRY_AUTH_TOKEN=$(cat "$SENTRY_TOKEN_FILE")
+# fi
+
+# if [ -z "$SENTRY_AUTH_TOKEN" ]; then
+#   echo "警告：SENTRY_AUTH_TOKEN 未设置（文件 $SENTRY_TOKEN_FILE 不存在），跳过 sourcemap 上传"
+# fi
 
-echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+pnpm run build:testing
 
+# 只有在 CI 环境时才写入版本号文件（覆盖写入）
+if [ "${CI}" = "true" ]; then
+  echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+fi

package/generators/micro-react/templates/CICD/wangsu_fresh_dev.sh

@@ -5,13 +5,13 @@ apiKey=$(cat ~/.wangsu_key)
 date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
 password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
 echo "打印刷新地址"
-echo "dir1：http://cdn-portal-dev.micoplatform.com/<%= projectName %>/$version/"
-echo "dir2：https://cdn-portal-dev.micoplatform.com/<%= projectName %>/$version/"
+echo "dir1：http://cdn-portal-dev.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version/"
+echo "dir2：https://cdn-portal-dev.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version/"
 curl -i --url "https://open.chinanetcenter.com/ccm/purge/ItemIdReceiver" -X "POST" -u "$username:$password" -H "Date:$date" -H "Content-Type: application/json" --data-binary @- <<EOF
 {
   "dirs": [
-    "http://cdn-portal-dev.micoplatform.com/<%= projectName %>/$version",
-    "https://cdn-portal-dev.micoplatform.com/<%= projectName %>/$version"
+    "http://cdn-portal-dev.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version",
+    "https://cdn-portal-dev.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version"
   ],
   "dirAction":"expire"
 }

package/generators/micro-react/templates/CICD/wangsu_fresh_prod.sh

@@ -5,13 +5,13 @@ apiKey=$(cat ~/.wangsu_key)
 date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
 password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
 echo "打印刷新地址"
-echo "dir1：http://cdn-portal.micoplatform.com/<%= projectName %>/$version/"
-echo "dir2：https://cdn-portal.micoplatform.com/<%= projectName %>/$version/"
+echo "dir1：http://cdn-portal.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version/"
+echo "dir2：https://cdn-portal.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version/"
 curl -i --url "https://open.chinanetcenter.com/ccm/purge/ItemIdReceiver" -X "POST" -u "$username:$password" -H "Date:$date" -H "Content-Type: application/json" --data-binary @- <<EOF
 {
   "dirs": [
-    "http://cdn-portal.micoplatform.com/<%= projectName %>/$version",
-    "https://cdn-portal.micoplatform.com/<%= projectName %>/$version"
+    "http://cdn-portal.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version",
+    "https://cdn-portal.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version"
   ],
   "dirAction":"expire"
 }

package/generators/micro-react/templates/CICD/wangsu_fresh_test.sh

@@ -5,13 +5,13 @@ apiKey=$(cat ~/.wangsu_key)
 date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
 password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
 echo "打印刷新地址"
-echo "dir1：http://cdn-portal-test.micoplatform.com/<%= projectName %>/$version/"
-echo "dir2：https://cdn-portal-test.micoplatform.com/<%= projectName %>/$version/"
+echo "dir1：http://cdn-portal-test.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version/"
+echo "dir2：https://cdn-portal-test.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version/"
 curl -i --url "https://open.chinanetcenter.com/ccm/purge/ItemIdReceiver" -X "POST" -u "$username:$password" -H "Date:$date" -H "Content-Type: application/json" --data-binary @- <<EOF
 {
   "dirs": [
-    "http://cdn-portal-test.micoplatform.com/<%= projectName %>/$version",
-    "https://cdn-portal-test.micoplatform.com/<%= projectName %>/$version"
+    "http://cdn-portal-test.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version",
+    "https://cdn-portal-test.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version"
   ],
   "dirAction":"expire"
 }

package/generators/micro-react/templates/CLAUDE.md

@@ -11,7 +11,7 @@
 - **Monorepo**: Turborepo + pnpm Workspace
 - **前端框架**: UmiJS 4 (@umijs/max)、React 18、TypeScript
 - **微前端**: qiankun
-- **UI 组件**: Arco Design Web
+- **UI 组件**: @mico-platform/ui
 - **样式方案**: Tailwind CSS + Less
 - **代码规范**: ESLint、Stylelint、Husky、Commitlint
 
@@ -53,16 +53,21 @@ apps/                         # Workspace 应用目录（微前端子应用）
 │   │   ├── app.tsx          # Umi 运行时配置
 │   │   ├── layouts/         # 布局组件
 │   │   ├── pages/           # 路由页面
-│   │   ├── components/      # 公共组件
+│   │   ├── components/      # 公共组件（MicroAppLoader 等）
 │   │   ├── common/          # 工具模块（auth、request、upload、menu）
+│   │   ├── constants/       # 常量定义（路由、主题、时区等）
 │   │   ├── hooks/           # 自定义 Hooks
 │   │   ├── services/        # API 服务层
 │   │   ├── models/          # Umi model（全局状态）
-│   │   ├── locales/         # 国际化文件（zh-CN、en-US）
-│   │   └── styles/          # 主题变量与样式覆盖
+│   │   └── locales/         # 国际化文件（zh-CN、en-US）
 │   └── config/              # Umi 配置
-packages/                     # 共享包
-├── shared-styles/           # 共享样式
+├── basis/                    # 基础数据子应用（货币管理等）
+│   ├── src/
+│   │   ├── pages/           # 路由页面
+│   │   ├── locales/         # 国际化文件
+│   │   └── common/          # 工具模块
+│   └── config/              # Umi 配置
+packages/                     # 共享包（common-intl 等）
 scripts/                      # 构建与开发脚本
 CICD/                         # 部署资源
 ```
@@ -98,13 +103,13 @@ refactor(auth): 重构认证服务
 API 请求配置在 `src/common/request/`（模块化拆分为 6 个文件），错误处理在 `src/requestErrorConfig.ts`。详见 [请求模块架构](./apps/layout/docs/arch-请求模块.md)。
 
 ### 日志与常量
-Logger 工具在 `src/common/logger.ts`，常量定义在 `src/common/constants.ts`。详见 [日志与常量](./apps/layout/docs/arch-日志与常量.md)。
+Logger 工具在 `src/common/logger.ts`，常量定义在 `src/constants/index.ts`。详见 [日志与常量](./apps/layout/docs/arch-日志与常量.md)。
 
 ### 认证模块
 认证逻辑在 `src/common/auth/`，核心文件 `auth-manager.ts` 管理 Token 存储和用户信息。SSO 登录在 `getInitialState()` 中完成，确保 UI 渲染前认证已就绪。
 
-### 菜单系统
-菜单解析与类型定义在 `src/common/menu/`。
+### 菜单与路由系统
+菜单解析与类型定义在 `src/common/menu/`。路由注册消费 `window.__MICO_PAGES__`（页面列表），菜单栏消费 `window.__MICO_MENUS__`（菜单树），两者解耦运作。权限通过菜单交叉引用 + 页面级兜底的双层策略控制。详见 [路由与菜单解耦](./apps/layout/docs/feature-路由与菜单解耦.md) 和 [菜单权限控制](./apps/layout/docs/feature-菜单权限控制.md)。
 
 ### 微前端
 layout 应用作为 qiankun 主应用，子应用通过 Umi 配置中的 qiankun 配置注册。详见 [微前端模式](./apps/layout/docs/feature-微前端模式.md)。
@@ -116,6 +121,8 @@ layout 应用作为 qiankun 主应用，子应用通过 Umi 配置中的 qiankun
 | [README.md](./README.md) | 项目入口、技术栈、常用命令 |
 | [提交规范](./docs/commit-message.md) | Git Commit 详细规范 |
 | [微前端模式](./apps/layout/docs/feature-微前端模式.md) | qiankun 架构、MicroAppLoader、子应用配置 |
+| [路由与菜单解耦](./apps/layout/docs/feature-路由与菜单解耦.md) | PAGES/MENUS 数据源分离、双层权限控制 |
+| [菜单权限控制](./apps/layout/docs/feature-菜单权限控制.md) | sideMenus 白名单、认证与授权分离 |
 | [主题色切换](./apps/layout/docs/feature-主题色切换.md) | useTheme Hook、CSS 变量系统 |
 | [请求模块架构](./apps/layout/docs/arch-请求模块.md) | HTTP 请求层模块化设计 |
 | [日志与常量](./apps/layout/docs/arch-日志与常量.md) | Logger 工具与常量管理 |

package/generators/micro-react/templates/README.md

@@ -7,7 +7,7 @@
 - **Monorepo**：Turborepo + pnpm Workspace
 - **前端框架**：UmiJS 4 / @umijs/max
 - **微前端**：qiankun
-- **UI 组件**：Arco Design
+- **UI 组件**：@mico-platform/ui
 - **样式方案**：Tailwind CSS + Less
 - **代码规范**：ESLint、Stylelint、lint-staged、Husky、Commitlint
 
@@ -27,22 +27,59 @@ pnpm install
 | 命令 | 说明 |
 |------|------|
 | `pnpm dev` | 交互式选择并启动应用开发服务器 |
+| `pnpm dev:preset` | 根据配置文件并行启动多个应用 |
+| `pnpm dev:preset <preset>` | 使用指定预设启动（如 `pnpm dev:preset full`） |
+| `pnpm list:preset` | 列出所有可用的启动预设 |
 | `pnpm build` | 构建所有应用（生产环境） |
 | `pnpm build:development` | 构建所有应用（开发环境） |
 | `pnpm build:testing` | 构建所有应用（测试环境） |
 | `pnpm build:production` | 构建所有应用（生产环境） |
 | `pnpm lint` | 运行 ESLint + Turborepo lint 校验 |
 | `pnpm lint:fix` | 自动修复 lint 问题 |
+| `pnpm create:umi-app` | 基于 Umi 模板创建新子应用 |
 
 > **提示**：也可以使用 `pnpm -C apps/<app-name> dev` 直接启动指定应用，例如 `pnpm -C apps/layout dev`。
 
+### 多应用并行启动
+
+通过 `dev.preset.json` 配置预设，一条命令并行启动多个应用：
+
+```bash
+# 使用默认预设启动
+pnpm dev:preset
+
+# 使用指定预设
+pnpm dev:preset full
+
+# 查看所有预设
+pnpm list:preset
+```
+
+预设配置文件 `dev.preset.json` 示例：
+
+```json
+{
+  "presets": {
+    "full": {
+      "description": "启动所有应用",
+      "apps": ["layout", "subapp"]
+    }
+  },
+  "default": "full"
+}
+```
+
+每个应用的日志会以不同颜色的前缀区分，按 `Ctrl+C` 同时停止所有应用。
+
+详细说明请参考 [多应用并行启动文档](./docs/dev-preset.md)。
+
 ## 新建子应用
 
 使用 Mico CLI 快速创建新的 React 子应用：
 
 ```bash
 # 全局安装（一次性）
-pnpm add -g yo mico-cli
+pnpm add -g generator-mico-cli
 
 # 在仓库根目录执行
 mico create subapp-react
@@ -55,11 +92,12 @@ mico create subapp-react
 ├── apps/                     # 业务应用目录
 │   └── layout/               # 主应用（qiankun master）
 ├── packages/                 # 共享包目录
-│   └── shared-styles/        # 共享样式
 ├── scripts/                  # 构建与开发脚本
-│   ├── dev.js                # 交互式启动脚本
+│   ├── dev.js                # 交互式启动脚本（单应用）
+│   ├── dev-preset.js         # 多应用并行启动脚本
 │   ├── collect-dist.js       # 构建产物收集
 │   └── create-umi-app.sh     # 创建新应用
+├── dev.preset.json           # 多应用启动预设配置
 ├── turbo.json                # Turborepo 任务管道
 ├── pnpm-workspace.yaml       # Workspace 包含范围
 └── .editorconfig             # 编辑器统一约束

package/generators/micro-react/templates/_gitignore

@@ -55,3 +55,7 @@ build
 /openspec
 
 **/tasks/*
+
+.pnpm-store/**
+
+.worktrees/**

package/generators/micro-react/templates/_npmrc

@@ -1,2 +1,6 @@
 registry=https://registry.npmjs.com/
+@mico-platform:registry=https://nexus-vywrajy.micoworld.net/repository/mico-base-common/
+@common-web:registry=https://nexus-vywrajy.micoworld.net/repository/mico-base-common/
+package-lock=false
+//nexus-vywrajy.micoworld.net/repository/mico-base-common/:_auth=bWljby1ucG06SDR4WUROazdad1NeczltblJMTw==
 

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

@@ -1,13 +1,10 @@
 // https://umijs.org/config/
 
 import { defineConfig } from '@umijs/max';
-import fs from 'fs';
-import path from 'path';
 
-// 使用 fs 读取 JSON 避免成为配置依赖，修改 menus.json 不会触发服务器重启
-const mockMenus = JSON.parse(
-  fs.readFileSync(path.join(__dirname, '../mock/menus.json'), 'utf-8'),
-);
+
+import mockMenus from '../mock/menus';
+import mockPages from '../mock/pages';
 
 const config: ReturnType<typeof defineConfig> = {
   publicPath: '/',
@@ -20,25 +17,48 @@ const config: ReturnType<typeof defineConfig> = {
     {
       content: `
         window.__MICO_MENUS__ = ${JSON.stringify(mockMenus)};
+        window.__MICO_PAGES__ = ${JSON.stringify(mockPages)};
         window.__MICO_CONFIG__ = {
-          appName: 'Mico Center',
+          appId: '<%= projectName %>',
+          appName: '<%= projectName %>',
+          title: '测试样例',
+          logo: '',
           apiBaseUrl: '',
+          defaultPath: '',
+          // 免认证路由（跳过 SSO 登录），支持 /* 前缀匹配
+          // noAuthRouteList: ['/*'],
+          // 免权限校验路由（跳过菜单权限检查）
+          noPermissionRouteList: [],
+          // 不显示布局的路由（全屏页面）
+          // noLayoutRouteList: [],
+          // 关闭权限控制（调试用）
+          disableAuth: false,
+          // SSO 外跳地址（与 resolveExternalLoginPath 读取的 externalLoginPath 一致；生产由注入的 __MICO_CONFIG__ 提供）
+          externalLoginPath:
+            'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
         };
       `,
     },
   ],
 
+  /**
+   * @name Monorepo 重定向
+   * @description 开发时将 workspace 包指向源码，支持热更新
+   * @doc https://umijs.org/docs/api/config#monoreporedirect
+   */
+  monorepoRedirect: {},
+
   proxy: {
     '/api': {
       // 要代理的地址
-      target: 'https://dashboard-api-test.micoplatform.comn',
+      target: 'https://dashboard-api-test.micoplatform.com',
       // 配置了这个可以从 http 代理到 https
       // 依赖 origin 的功能可能需要这个，比如 cookie
       changeOrigin: true,
     },
-    '/proxy/audit_svr': {
+    '/proxy/<%= projectName %>_svr': {
       // 要代理的地址
-      target: 'https://dashboard-api-test.micoplatform.comn',
+      target: 'https://dashboard-api-test.micoplatform.com',
       // 配置了这个可以从 http 代理到 https
       // 依赖 origin 的功能可能需要这个，比如 cookie
       changeOrigin: true,
@@ -46,15 +66,11 @@ const config: ReturnType<typeof defineConfig> = {
   },
   define: {
     'process.env.NODE_ENV': 'development',
-    'process.env.APP_ID': 'mibot_dev',
     'process.env.API_BASE_URL': '',
-    'process.env.PROXY_SUFFIX': '/',
     'process.env.LOGIN_ENDPOINT':
-      '',
+      'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
-      '',
-    'process.env.EXTERNAL_LOGIN_PATH':
-      '',
+      'https://dashboard-api-test.micoplatform.com/api/yufu_login/refresh/',
   },
 };