generator-mico-cli 0.1.18

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

@@ -0,0 +1,206 @@
+---
+description: 主题系统 - 亮色/暗黑主题切换实现
+globs: ["**/themes/**", "**/useTheme**", "**/*.less"]
+---
+
+# 主题系统
+
+## 架构概览
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     useTheme Hook                            │
+│  ┌─────────────────────────────────────────────────────────┐│
+│  │  theme: 'light' | 'dark'                                ││
+│  │  toggleTheme(): 切换主题                                 ││
+│  │  setTheme(theme): 设置指定主题                           ││
+│  │  isDark: boolean                                        ││
+│  └─────────────────────────────────────────────────────────┘│
+│                           ↓                                  │
+│  ┌─────────────────────────────────────────────────────────┐│
+│  │  body[arco-theme="dark"]  → Arco Design 组件            ││
+│  │  body[data-theme="dark"]  → 自定义 CSS 变量             ││
+│  └─────────────────────────────────────────────────────────┘│
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 核心文件
+
+| 文件 | 说明 |
+|------|------|
+| `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 变量覆盖 |
+| `apps/layout/src/hooks/useTheme.ts` | 主题管理 Hook |
+| `apps/layout/src/common/theme.ts` | 主题初始化 |
+
+## useTheme Hook
+
+### 接口
+```typescript
+type Theme = 'light' | 'dark';
+
+interface UseThemeReturn {
+  theme: Theme;              // 当前主题
+  isDark: boolean;           // 是否暗黑模式
+  toggleTheme: () => void;   // 切换主题
+  setTheme: (theme: Theme) => void;  // 设置指定主题
+}
+```
+
+### 使用示例
+```tsx
+import { useTheme } from '@/hooks/useTheme';
+import { IconSun, IconMoon } from '@arco-design/web-react/icon';
+
+const ThemeToggle: React.FC = () => {
+  const { isDark, toggleTheme } = useTheme();
+
+  return (
+    <Button onClick={toggleTheme}>
+      {isDark ? <IconSun /> : <IconMoon />}
+    </Button>
+  );
+};
+```
+
+## CSS 变量定义
+
+### 亮色主题 (normal/custom-var.less)
+```less
+body[data-theme='normal'] {
+  --Brand1-1: #E8F3FF;
+  --Brand1-6: #165DFF;
+  --color-text-1: #1D2129;
+  --color-text-5: #FFFFFF;
+  --color-fill-1: #F7F8FA;
+  --color-border-1: #F2F3F5;
+  // ...
+}
+```
+
+### 暗黑主题 (dark/custom-var.less)
+```less
+body[data-theme='dark'] {
+  --Brand1-1: #001935;
+  --Brand1-6: #3C7EFF;
+  --color-text-1: #FFFFFF;
+  --color-text-5: #1D2129;
+  --color-fill-1: #232324;
+  --color-border-1: #3A3A3C;
+  // ...
+}
+```
+
+## Less 变量使用
+
+### variables.less
+```less
+// Less 变量引用 CSS 变量，提供编辑器类型提示
+@Brand1-1: var(--Brand1-1);
+@Brand1-6: var(--Brand1-6);
+@color-text-1: var(--color-text-1);
+@color-fill-1: var(--color-fill-1);
+@color-border-1: var(--color-border-1);
+```
+
+### 在组件样式中使用
+```less
+// ✅ 推荐：使用 Less 变量（有编辑器提示）
+.my-card {
+  background-color: @color-fill-1;
+  color: @color-text-2;
+  border: 1px solid @color-border-2;
+}
+
+// ⚠️ 可用：直接使用 CSS 变量
+.my-card {
+  background-color: var(--color-fill-1);
+}
+```
+
+## 主要颜色变量
+
+> 完整列表见：[shared-styles 包](packages/shared-styles/README.md#主要变量)
+
+| 分类 | 变量 | 说明 |
+|------|------|------|
+| 品牌色 | `@Brand1-1` ~ `@Brand1-7` | 由浅到深 |
+| 文字色 | `@color-text-1` ~ `@color-text-5` | 强调 → 纯白 |
+| 填充色 | `@color-fill-1` ~ `@color-fill-5` | 浅 → 深 |
+| 边框色 | `@color-border-1` ~ `@color-border-4` | 浅 → 深 |
+| 状态色 | `@Success-*`, `@Warning-*`, `@Danger-*` | 成功/警告/危险 |
+
+## 主题切换原理
+
+```typescript
+const applyTheme = (theme: Theme) => {
+  if (theme === 'dark') {
+    // Arco Design 暗黑模式
+    document.body.setAttribute('arco-theme', 'dark');
+    // 自定义 CSS 变量
+    document.body.setAttribute('data-theme', 'dark');
+  } else {
+    document.body.removeAttribute('arco-theme');
+    document.body.setAttribute('data-theme', 'normal');
+  }
+};
+```
+
+## 持久化
+
+- **存储 Key**: `<%= projectName %>-theme`
+- **存储位置**: localStorage
+- **默认行为**: 未手动设置时跟随系统偏好
+
+```typescript
+// 获取存储的主题或系统主题
+const getStoredTheme = (): Theme => {
+  const stored = localStorage.getItem('<%= projectName %>-theme');
+  if (stored === 'light' || stored === 'dark') {
+    return stored;
+  }
+  // 跟随系统偏好
+  return window.matchMedia('(prefers-color-scheme: dark)').matches
+    ? 'dark'
+    : 'light';
+};
+```
+
+## 子应用主题复用
+
+> 详细配置请参考：[主题色切换文档](apps/layout/docs/feature-主题色切换.md#微前端子应用主题适配)
+
+### 快速配置
+
+```less
+// global.less - 仅导入 Less 变量（不打包 CSS 变量）
+@import '@<%= projectName %>/shared-styles/variables-only';
+```
+
+```typescript
+// app.tsx - 开发环境条件注入（生产环境被 tree-shake）
+if (process.env.NODE_ENV === 'development') {
+  if (typeof window !== 'undefined' && !window.__POWERED_BY_QIANKUN__) {
+    import('./styles/theme.less');
+  }
+}
+```
+
+### ⚠️ 关键点
+
+- **必须用 `process.env.NODE_ENV === 'development'`** 包裹主题导入
+- 运行时判断 `window.__POWERED_BY_QIANKUN__` 无法被 tree-shake
+- 生产构建后 CSS 应 < 500 字节（不含主题变量）
+
+## 注意事项
+
+1. **双属性设置**: `arco-theme` 和 `data-theme` 必须都设置在 `body` 元素上
+2. **选择器格式**: 自定义变量选择器使用 `body[data-theme='dark']`
+3. **优先 Less 变量**: 使用 Less 变量有编辑器提示和类型检查
+4. **避免硬编码颜色**: 所有颜色都应使用主题变量
+5. **系统跟随**: 未手动设置主题时会跟随系统偏好变化
+6. **子应用共享**: 子应用使用 `@<%= projectName %>/shared-styles` 包复用主题

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

@@ -0,0 +1,16 @@
+# http://editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

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

@@ -0,0 +1,3 @@
+# Default: 5
+CHECK_TIMEOUT=10
+DID_YOU_KNOW=none

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

@@ -0,0 +1,30 @@
+/* eslint-env node */
+module.exports = {
+  root: true,
+  env: {
+    node: true,
+    es2022: true,
+  },
+  extends: ['eslint:recommended'],
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+  },
+  rules: {
+    'no-unused-vars': [
+      'warn',
+      {
+        argsIgnorePattern: '^_',
+        varsIgnorePattern: '^_',
+      },
+    ],
+  },
+  // 忽略 apps/ 子包和 scripts/
+  ignorePatterns: [
+    'node_modules/',
+    'dist/',
+    'apps/',
+    'scripts/',
+  ],
+};
+

package/generators/micro-react/templates/.husky/commit-msg

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+pnpm exec commitlint --edit "$1"

package/generators/micro-react/templates/.husky/pre-commit

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+pnpm exec lint-staged --quiet

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

@@ -0,0 +1,5 @@
+{
+  "*.{js,jsx,tsx,ts}": [
+    "eslint --fix"
+  ]
+}

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

@@ -0,0 +1,25 @@
+const extendsConfig = [];
+
+try {
+  extendsConfig.push(require.resolve('@umijs/max/stylelint'));
+} catch (_error) {
+  // 如果依赖不存在则跳过，避免 Stylelint 报错
+}
+
+module.exports = {
+  extends: extendsConfig,
+  rules: {
+    'at-rule-no-unknown': [
+      true,
+      {
+        ignoreAtRules: [
+          'tailwind',
+          'apply',
+          'variants',
+          'responsive',
+          'screen',
+        ],
+      },
+    ],
+  },
+};

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

@@ -0,0 +1,39 @@
+# 仓库指南
+
+## 项目结构与模块组织
+- `apps/` 存放应用包。当前应用：`apps/[???]/`。
+- 应用源码位于 `apps/[???]/src/`，包含 `pages/`（Vue SFCs）、`layouts/`、`styles/`、`utils/` 和 `assets/`。
+- `scripts/` 包含仓库工具脚本（如 `scripts/dev.js`、`scripts/collect-dist.js`）。
+- `docs/` 存放工作流文档；`CICD/` 包含部署相关资源。
+- `dist/` 是生成的构建产物（收集于仓库根目录）。
+
+## 构建、测试和开发命令
+- `pnpm install` 安装 workspace 依赖。
+- `pnpm dev` 运行交互式开发启动器（选择应用）。
+- `pnpm -C apps/[???] dev` 直接运行指定应用。
+- `pnpm build` 构建所有应用用于生产环境；`pnpm build:development|testing|production|local` 设置不同环境模式。
+- `pnpm lint` 运行 Biome + Turbo lint 检查；`pnpm lint:fix` 自动修复。
+- `pnpm test` 跨 packages 运行 Turbo test。
+- `pnpm create:umi-app <name>` 在 `apps/` 下创建新的 Umi 应用脚手架。
+
+## 代码风格与命名规范
+- 缩进：2 个空格，LF 换行，去除行尾空白（参见 `.editorconfig`）。
+- 格式化/检查：Biome 处理 JS/TS/JSON；Stylelint 处理 Less/CSS。
+- TypeScript 命名：接口使用 `I` 前缀，枚举使用 `E` 前缀，类型/类别名可用 `T`/`C` 前缀。
+- 保持 Vue SFCs 专注；将复杂视图拆分到页面文件夹下的 `components/` 目录中。
+
+## 测试指南
+- 仓库级测试由 `pnpm test`（Turbo）驱动。
+- 如果在应用中添加测试，确保该应用暴露 `test` 脚本以便 Turbo 识别。
+- 建议命名：`*.test.ts` 或 `*.spec.ts`，与模块放在一起或放在 `__tests__/` 目录中。
+
+## Commit 与 Pull Request 指南
+- Commit 消息遵循 Conventional Commits 规范（通过 Commitlint）：`type(scope): subject`。
+- Subject 长度应为 1-50 个字符。示例：`feat(resource-center): add kol filter`。
+- 常用类型：`feat`、`fix`、`docs`、`refactor`、`perf`、`test`、`chore`、`build`、`ci`。
+- PR 应包含：清晰的摘要、关联的 issue（如有）、已运行的测试命令，以及 UI 变更的截图。
+
+## 环境与配置
+- 根目录的环境文件：`.env`、`.env.local`、`.env.[mode][.local]` 通过 `dotenv-cli` 注入。
+- 应用特定的配置覆盖放在 `apps/<app>/.env.local`。
+- 将影响缓存的环境变量添加到 `turbo.json` 的 `globalEnv` 中。

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

@@ -0,0 +1,30 @@
+#!/bin/bash
+source ~/.bashrc
+node -v
+nvm -v
+nvm install 22.20.0
+nvm use 22.20.0
+npm i -g pnpm@10.18.2 --registry=https://registry.npmmirror.com
+pnpm install
+
+# 获取当前脚本所在目录
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# 获取项目根目录（假设脚本在 CICD 目录下，所以向上一层）
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# 用 node 命令读取 package.json 里的 version 字段
+VERSION=$(node -p "require('$PROJECT_ROOT/package.json').version")
+# 输出项目版本号
+echo "项目版本: $VERSION"
+
+# 切换到项目根目录，确保后续命令在根目录下运行
+cd "$PROJECT_ROOT"
+
+# 设置子应用的 CDN 公共路径（开发环境）
+export CDN_PUBLIC_PATH="https://cdn-portal-dev.micoplatform.com/<%= projectName %>/${VERSION}/"
+echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"
+
+pnpm run build:development
+
+echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+

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

@@ -0,0 +1,30 @@
+#!/bin/bash
+source ~/.bashrc
+node -v
+nvm -v
+nvm install 22.20.0
+nvm use 22.20.0
+npm i -g pnpm@10.18.2 --registry=https://registry.npmmirror.com
+pnpm install
+
+# 获取当前脚本所在目录
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# 获取项目根目录（假设脚本在 CICD 目录下，所以向上一层）
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# 用 node 命令读取 package.json 里的 version 字段
+VERSION=$(node -p "require('$PROJECT_ROOT/package.json').version")
+# 输出项目版本号
+echo "项目版本: $VERSION"
+
+# 切换到项目根目录，确保后续命令在根目录下运行
+cd "$PROJECT_ROOT"
+
+# 设置子应用的 CDN 公共路径（本地环境使用相对路径）
+export CDN_PUBLIC_PATH="./"
+echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"
+
+pnpm run build:local
+
+echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+

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

@@ -0,0 +1,30 @@
+#!/bin/bash
+source ~/.bashrc
+node -v
+nvm -v
+nvm install 22.20.0
+nvm use 22.20.0
+npm i -g pnpm@10.18.2 --registry=https://registry.npmmirror.com
+pnpm install
+
+# 获取当前脚本所在目录
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# 获取项目根目录（假设脚本在 CICD 目录下，所以向上一层）
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# 用 node 命令读取 package.json 里的 version 字段
+VERSION=$(node -p "require('$PROJECT_ROOT/package.json').version")
+# 输出项目版本号
+echo "项目版本: $VERSION"
+
+# 切换到项目根目录，确保后续命令在根目录下运行
+cd "$PROJECT_ROOT"
+
+# 设置子应用的 CDN 公共路径（生产环境）
+export CDN_PUBLIC_PATH="https://cdn-portal.micoplatform.com/<%= projectName %>/${VERSION}/"
+echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"
+
+pnpm run build:production
+
+echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+

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

@@ -0,0 +1,30 @@
+#!/bin/bash
+source ~/.bashrc
+node -v
+nvm -v
+nvm install 22.20.0
+nvm use 22.20.0
+npm i -g pnpm@10.18.2 --registry=https://registry.npmmirror.com
+pnpm install
+
+# 获取当前脚本所在目录
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# 获取项目根目录（假设脚本在 CICD 目录下，所以向上一层）
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# 用 node 命令读取 package.json 里的 version 字段
+VERSION=$(node -p "require('$PROJECT_ROOT/package.json').version")
+# 输出项目版本号
+echo "项目版本: $VERSION"
+
+# 切换到项目根目录，确保后续命令在根目录下运行
+cd "$PROJECT_ROOT"
+
+# 设置子应用的 CDN 公共路径（测试环境）
+export CDN_PUBLIC_PATH="https://cdn-portal-test.micoplatform.com/<%= projectName %>/${VERSION}/"
+echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"
+
+pnpm run build:testing
+
+echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+

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

@@ -0,0 +1,19 @@
+#!/bin/bash
+version=$1
+username="mico_fresh"
+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/"
+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"
+  ],
+  "dirAction":"expire"
+}
+EOF
+

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

@@ -0,0 +1,19 @@
+#!/bin/bash
+version=$1
+username="mico_fresh"
+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/"
+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"
+  ],
+  "dirAction":"expire"
+}
+EOF
+

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

@@ -0,0 +1,19 @@
+#!/bin/bash
+version=$1
+username="mico_fresh"
+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/"
+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"
+  ],
+  "dirAction":"expire"
+}
+EOF
+

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

@@ -0,0 +1,106 @@
+# CLAUDE.md
+
+本文件为 Claude Code (claude.ai/code) 在此仓库中工作提供指导。
+
+## 项目概述
+
+<%= ProjectName %> - 基于 qiankun 微前端架构的 Monorepo 项目。
+
+## 技术栈
+
+- **Monorepo**: Turborepo + pnpm Workspace
+- **前端框架**: UmiJS 4 (@umijs/max)、React 18、TypeScript
+- **微前端**: qiankun
+- **UI 组件**: Arco Design Web
+- **样式方案**: Tailwind CSS + Less
+- **代码规范**: ESLint、Stylelint、Husky、Commitlint
+
+## 常用命令
+
+```bash
+# 安装依赖
+pnpm install
+
+# 开发（交互式选择应用）
+pnpm dev
+
+# 直接启动指定应用
+pnpm -C apps/layout dev
+
+# 构建
+pnpm build                    # 生产环境构建
+pnpm build:development        # 开发环境
+pnpm build:testing            # 测试环境
+pnpm build:production         # 生产环境
+
+# 代码检查
+pnpm lint                     # 运行 ESLint + Turbo lint
+pnpm lint:fix                 # 自动修复 lint 问题
+
+# 测试
+pnpm test
+
+# 创建新子应用
+mico create subapp-react
+```
+
+## 架构
+
+```
+apps/                         # Workspace 应用目录
+├── layout/                   # 主应用（qiankun master）
+│   ├── src/
+│   │   ├── app.tsx          # Umi 运行时配置
+│   │   ├── layouts/         # 布局组件
+│   │   ├── pages/           # 路由页面
+│   │   ├── components/      # 公共组件
+│   │   ├── common/          # 工具模块
+│   │   ├── hooks/           # 自定义 Hooks
+│   │   ├── services/        # API 服务层
+│   │   ├── models/          # Umi model
+│   │   ├── locales/         # 国际化
+│   │   └── styles/          # 主题变量
+│   └── config/              # Umi 配置
+packages/                     # 共享包
+├── shared-styles/           # 共享样式
+scripts/                      # 构建脚本
+```
+
+## TypeScript 命名规范
+
+- 接口使用 `I` 前缀：`IUserInfo`、`IMenuItem`
+- 枚举使用 `E` 前缀：`EStatus`、`EUserRole`
+- 类型别名可用 `T` 前缀：`TCallback`
+
+## 提交信息格式
+
+格式：`type(scope): subject`（subject 不超过 50 字符）
+
+类型：`feat`、`fix`、`docs`、`style`、`refactor`、`perf`、`test`、`chore`、`build`、`ci`、`wip`、`release`、`deps`
+
+示例：
+```
+feat(用户): 添加用户注册功能
+fix(表格): 修复分页显示问题
+refactor(auth): 重构认证服务
+```
+
+## 环境变量
+
+- 根目录 `.env` 文件通过 `dotenv-cli` 注入所有应用
+- 应用专属变量放在 `apps/<app>/.env.local`
+- 影响缓存的变量需在 `turbo.json` 的 `globalEnv` 中登记
+
+## 核心模块
+
+### 请求层
+API 请求配置在 `apps/layout/src/common/request/`。
+
+### 认证模块
+认证逻辑在 `apps/layout/src/common/auth/`。
+
+### 菜单系统
+菜单解析与类型定义在 `apps/layout/src/common/menu/`。
+
+### 微前端
+layout 应用作为 qiankun 主应用，子应用通过 qiankun 配置注册。