generator-mico-cli 0.1.28 → 0.2.1

package/generators/micro-react/templates/.cursor/rules/layout-app.mdc

@@ -206,7 +206,7 @@ const { isAuthenticated, user, logout } = useAuth();
 ### 主题变量引入
 ```less
 // 在组件样式中使用
-@import '@/styles/variables.less';
+@import '<%= packageScope %>/shared-styles/variables-only';
 
 .my-component {
   background: @color-fill-1;

package/generators/micro-react/templates/.cursor/rules/request-auth.mdc

@@ -24,7 +24,7 @@ globs: ["**/request/**", "**/auth/**", "**/services/**"]
 | 文件 | 说明 |
 |------|------|
 | `src/common/request/index.ts` | 统一请求封装 |
-| `src/common/auth/cs-auth-manager.ts` | Token 存储管理 |
+| `src/common/auth/auth-manager.ts` | Token 存储管理 |
 | `src/common/auth/index.ts` | 认证入口 |
 | `src/common/auth/tool.ts` | 认证工具函数 |
 | `src/requestErrorConfig.ts` | 错误处理配置 |
@@ -151,7 +151,7 @@ import {
   getStoredRefreshToken,
   setStoredRefreshToken,
   clearStoredTokens,
-} from '@/common/auth/cs-auth-manager';
+} from '@/common/auth/auth-manager';
 
 // 获取 token
 const token = getStoredAuthToken();

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

@@ -178,7 +178,7 @@ const getStoredTheme = (): Theme => {
 
 ```less
 // global.less - 仅导入 Less 变量（不打包 CSS 变量）
-@import '@<%= projectName %>/shared-styles/variables-only';
+@import '<%= packageScope %>/shared-styles/variables-only';
 ```
 
 ```typescript
@@ -203,4 +203,4 @@ if (process.env.NODE_ENV === 'development') {
 3. **优先 Less 变量**: 使用 Less 变量有编辑器提示和类型检查
 4. **避免硬编码颜色**: 所有颜色都应使用主题变量
 5. **系统跟随**: 未手动设置主题时会跟随系统偏好变化
-6. **子应用共享**: 子应用使用 `@<%= projectName %>/shared-styles` 包复用主题
+6. **子应用共享**: 子应用使用 `<%= packageScope %>/shared-styles` 包复用主题

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

@@ -47,23 +47,24 @@ mico create subapp-react
 ## 架构
 
 ```
-apps/                         # Workspace 应用目录
-├── layout/                   # 主应用（qiankun master）
+apps/                         # Workspace 应用目录（微前端子应用）
+├── layout/                   # 主布局应用（qiankun 主应用容器）
 │   ├── src/
 │   │   ├── app.tsx          # Umi 运行时配置
 │   │   ├── layouts/         # 布局组件
 │   │   ├── pages/           # 路由页面
 │   │   ├── components/      # 公共组件
-│   │   ├── common/          # 工具模块
+│   │   ├── common/          # 工具模块（auth、request、upload、menu）
 │   │   ├── hooks/           # 自定义 Hooks
 │   │   ├── services/        # API 服务层
-│   │   ├── models/          # Umi model
-│   │   ├── locales/         # 国际化
-│   │   └── styles/          # 主题变量
+│   │   ├── models/          # Umi model（全局状态）
+│   │   ├── locales/         # 国际化文件（zh-CN、en-US）
+│   │   └── styles/          # 主题变量与样式覆盖
 │   └── config/              # Umi 配置
 packages/                     # 共享包
 ├── shared-styles/           # 共享样式
-scripts/                      # 构建脚本
+scripts/                      # 构建与开发脚本
+CICD/                         # 部署资源
 ```
 
 ## TypeScript 命名规范
@@ -94,13 +95,28 @@ refactor(auth): 重构认证服务
 ## 核心模块
 
 ### 请求层
-API 请求配置在 `apps/layout/src/common/request/`。
+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)。
 
 ### 认证模块
-认证逻辑在 `apps/layout/src/common/auth/`。
+认证逻辑在 `src/common/auth/`，核心文件 `auth-manager.ts` 管理 Token 存储和用户信息。SSO 登录在 `getInitialState()` 中完成，确保 UI 渲染前认证已就绪。
 
 ### 菜单系统
-菜单解析与类型定义在 `apps/layout/src/common/menu/`。
+菜单解析与类型定义在 `src/common/menu/`。
 
 ### 微前端
-layout 应用作为 qiankun 主应用，子应用通过 qiankun 配置注册。
+layout 应用作为 qiankun 主应用，子应用通过 Umi 配置中的 qiankun 配置注册。详见 [微前端模式](./apps/layout/docs/feature-微前端模式.md)。
+
+## 相关文档
+
+| 文档 | 说明 |
+|------|------|
+| [README.md](./README.md) | 项目入口、技术栈、常用命令 |
+| [提交规范](./docs/commit-message.md) | Git Commit 详细规范 |
+| [微前端模式](./apps/layout/docs/feature-微前端模式.md) | qiankun 架构、MicroAppLoader、子应用配置 |
+| [主题色切换](./apps/layout/docs/feature-主题色切换.md) | useTheme Hook、CSS 变量系统 |
+| [请求模块架构](./apps/layout/docs/arch-请求模块.md) | HTTP 请求层模块化设计 |
+| [日志与常量](./apps/layout/docs/arch-日志与常量.md) | Logger 工具与常量管理 |
+| [部署说明](./deployDesc.md) | CI/CD 构建与部署流程 |

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

@@ -34,6 +34,8 @@ pnpm install
 | `pnpm lint` | 运行 ESLint + Turborepo lint 校验 |
 | `pnpm lint:fix` | 自动修复 lint 问题 |
 
+> **提示**：也可以使用 `pnpm -C apps/<app-name> dev` 直接启动指定应用，例如 `pnpm -C apps/layout dev`。
+
 ## 新建子应用
 
 使用 Mico CLI 快速创建新的 React 子应用：

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

@@ -21,7 +21,7 @@ const config: ReturnType<typeof defineConfig> = {
       content: `
         window.__MICO_MENUS__ = ${JSON.stringify(mockMenus)};
         window.__MICO_CONFIG__ = {
-          appName: 'Audit Center',
+          appName: 'Mico Center',
           apiBaseUrl: '',
         };
       `,
@@ -29,9 +29,16 @@ const config: ReturnType<typeof defineConfig> = {
   ],
 
   proxy: {
-    '/api/': {
+    '/api': {
       // 要代理的地址
-      target: 'https://preview.pro.ant.design',
+      target: 'https://dashboard-api-test.micoplatform.comn',
+      // 配置了这个可以从 http 代理到 https
+      // 依赖 origin 的功能可能需要这个，比如 cookie
+      changeOrigin: true,
+    },
+    '/proxy/audit_svr': {
+      // 要代理的地址
+      target: 'https://dashboard-api-test.micoplatform.comn',
       // 配置了这个可以从 http 代理到 https
       // 依赖 origin 的功能可能需要这个，比如 cookie
       changeOrigin: true,
@@ -40,7 +47,7 @@ const config: ReturnType<typeof defineConfig> = {
   define: {
     'process.env.NODE_ENV': 'development',
     'process.env.APP_ID': 'mibot_dev',
-    'process.env.API_BASE_URL': 'https://dashboard-api-test.micoplatform.com',
+    'process.env.API_BASE_URL': '',
     'process.env.PROXY_SUFFIX': '/',
     'process.env.LOGIN_ENDPOINT':
       '',

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

@@ -21,22 +21,12 @@ const config: ReturnType<typeof defineConfig> = {
       content: `
         window.__MICO_MENUS__ = ${JSON.stringify(mockMenus)};
         window.__MICO_CONFIG__ = {
-          appName: 'Audit Center',
+          appName: 'Mico Center',
           apiBaseUrl: '',
         };
       `,
     },
   ],
-
-  proxy: {
-    '/api/': {
-      // 要代理的地址
-      target: 'https://preview.pro.ant.design',
-      // 配置了这个可以从 http 代理到 https
-      // 依赖 origin 的功能可能需要这个，比如 cookie
-      changeOrigin: true,
-    },
-  },
   define: {
     'process.env.NODE_ENV': 'development',
     'process.env.APP_ID': 'mibot_dev',

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

@@ -3,13 +3,6 @@
 import { defineConfig } from '@umijs/max';
 
 const config: ReturnType<typeof defineConfig> = {
-  proxy: {
-    '/api/': {
-      target: 'https://proapi.azurewebsites.net',
-      changeOrigin: true,
-      pathRewrite: { '^': '' },
-    },
-  },
   define: {
     'process.env.NODE_ENV': 'testing',
     'process.env.APP_ID': 'mibot',

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

@@ -5,9 +5,19 @@
  * @note Umi Max 会自动使用 src/layouts/index.tsx 作为全局布局，无需显式配置
  */
 export default [
+  {
+    path: '/user/login',
+    component: './User/Login',
+    name: '登录',
+  },
   {
     path: '/',
     component: './Home',
     name: '首页',
   },
+  {
+    path: '/403',
+    component: './403',
+    name: '无权限',
+  },
 ];

package/generators/micro-react/templates/apps/layout/docs/arch-/346/227/245/345/277/227/344/270/216/345/270/270/351/207/217.md

@@ -0,0 +1,105 @@
+# 日志与常量
+
+> 创建时间：2025-12-27
+
+## Logger 工具
+
+生产环境静默的日志工具，使用 `bind` 保持正确的调用栈位置。
+
+### 使用
+
+```typescript
+import { layoutLogger, microAppLogger, authLogger } from '@/common/logger';
+
+layoutLogger.log('message'); // [Layout] message
+layoutLogger.error('error'); // 保持原始调用栈位置
+```
+
+### 实现原理
+
+```typescript
+// 使用 bind 而非 wrapper，保持控制台显示正确的调用位置
+const createLogger = (prefix: string) => ({
+  log: console.log.bind(console, `[${prefix}]`),
+  error: console.error.bind(console, `[${prefix}]`),
+  // ...
+});
+```
+
+### 预定义 Logger
+
+| Logger           | 用途         |
+| ---------------- | ------------ |
+| `layoutLogger`   | 主布局相关   |
+| `microAppLogger` | 微应用加载器 |
+| `authLogger`     | 认证模块     |
+| `requestLogger`  | 请求模块     |
+
+## 常量定义
+
+集中管理魔法字符串，位于 `src/common/constants.ts`。
+
+### ROUTES
+
+```typescript
+export const ROUTES = {
+  LOGIN: '/user/login',
+  REGISTER: '/user/register',
+  REGISTER_RESULT: '/user/register-result',
+  NO_AUTH_ROUTES: ['/user/login', '/user/register', '/user/register-result'],
+} as const;
+```
+
+### THEME
+
+```typescript
+export const THEME = {
+  STORAGE_KEY: '<%= ProjectName %>-theme',
+  DEFAULT: 'light' as const,
+  VALUES: ['light', 'dark'] as const,
+} as const;
+```
+
+### TIMEZONE
+
+```typescript
+export const TIMEZONE = {
+  /** localStorage 存储键（IANA 时区，如 Asia/Shanghai） */
+  STORAGE_KEY: '<%= ProjectName %>-timezone',
+  /** localStorage 存储键（用于展示的地区/名称，可选） */
+  REGION_STORAGE_KEY: '<%= ProjectName %>-timezone-region',
+} as const;
+```
+
+### PRESENCE
+
+```typescript
+export const PRESENCE = {
+  /** localStorage 存储键 */
+  STORAGE_KEY: '<%= ProjectName %>-presence-status',
+} as const;
+```
+
+### STORAGE_KEYS
+
+```typescript
+export const STORAGE_KEYS = {
+  APP_INFO: 'appInfo',
+  IS_SUPERUSER: 'is_superuser',
+  GROUPS: 'groups',
+} as const;
+```
+
+## 文件清单
+
+| 文件                                 | 说明          |
+| ------------------------------------ | ------------- |
+| `src/common/logger.ts`               | Logger 工具   |
+| `src/common/constants.ts`            | 常量定义      |
+| `apps/homepage/src/common/logger.ts` | 子应用 Logger |
+
+## 注意事项
+
+- Logger 仅在开发环境输出，生产环境静默
+- 使用 `bind` 实现，DevTools 显示实际调用位置而非 logger.ts
+- 新增路由常量应添加到 `ROUTES` 对象

package/generators/micro-react/templates/apps/layout/docs/arch-/350/257/267/346/261/202/346/250/241/345/235/227.md

@@ -1,8 +1,10 @@
 # 请求模块架构
 
+> 创建时间：2025-12-27
+
 ## 功能概述
 
-HTTP 请求层模块化架构，将请求逻辑拆分为 6 个职责单一的模块，遵循 SRP 原则。
+HTTP 请求层模块化架构，将原 599 行单文件拆分为 7 个文件（1 个入口 + 6 个功能模块），遵循 SRP 原则。
 
 ## 模块结构
 
@@ -43,11 +45,11 @@ const data = await request<UserInfo>('/api/user');
 
 ### 配置选项
 
-| 选项 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `skipProxy` | `boolean` | `false` | 跳过 proxySuffix 拼接 |
-| `baseURL` | `string` | 全局配置 | 自定义 baseURL，覆盖全局配置 |
-| `rawUrl` | `boolean` | `false` | 使用原始 URL，跳过所有 URL 处理 |
+| 选项        | 类型      | 默认值   | 说明                            |
+| ----------- | --------- | -------- | ------------------------------- |
+| `skipProxy` | `boolean` | `false`  | 跳过 proxySuffix 拼接           |
+| `baseURL`   | `string`  | 全局配置 | 自定义 baseURL，覆盖全局配置    |
+| `rawUrl`    | `boolean` | `false`  | 使用原始 URL，跳过所有 URL 处理 |
 
 ### 配置优先级
 
@@ -81,7 +83,7 @@ request('/api/data', { baseURL: 'https://other-service.com' });
 // 4. 自定义 baseURL + 跳过 proxy（请求第三方 API）
 request('/api/data', {
   baseURL: 'https://third-party.com',
-  skipProxy: true
+  skipProxy: true,
 });
 // 生产环境 => https://third-party.com/api/data
 
@@ -96,13 +98,13 @@ request('/api/users', { proxySuffix: '/other-proxy' });
 
 ### 典型场景
 
-| 场景 | 配置 |
-|------|------|
-| 请求主后端 API | 默认，无需额外配置 |
-| 绕过网关直连后端 | `{ skipProxy: true }` |
-| 请求其他微服务 | `{ baseURL: 'https://xxx' }` |
-| 请求第三方 API | `{ baseURL: 'https://xxx', skipProxy: true }` |
-| 微应用已处理 URL | `{ rawUrl: true }` |
+| 场景             | 配置                                          |
+| ---------------- | --------------------------------------------- |
+| 请求主后端 API   | 默认，无需额外配置                            |
+| 绕过网关直连后端 | `{ skipProxy: true }`                         |
+| 请求其他微服务   | `{ baseURL: 'https://xxx' }`                  |
+| 请求第三方 API   | `{ baseURL: 'https://xxx', skipProxy: true }` |
+| 微应用已处理 URL | `{ rawUrl: true }`                            |
 
 ## 错误处理
 
@@ -124,7 +126,7 @@ const isAxiosLikeError = (error: unknown): error is AxiosLikeError => {
 | 文件                                 | 说明           |
 | ------------------------------------ | -------------- |
 | `src/requestErrorConfig.ts`          | 错误处理配置   |
-| `src/common/auth/cs-auth-manager.ts` | Token 存储管理 |
+| `src/common/auth/auth-manager.ts` | Token 存储管理 |
 
 ## 注意事项
 

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

@@ -0,0 +1,234 @@
+# 主题色切换
+
+> 创建时间：2025-12-26
+
+## 功能概述
+
+Layout 应用支持亮色/暗黑主题切换，通过 CSS 变量实现运行时动态切换，所有组件自动适配主题变化。
+
+## 技术方案
+
+### 技术栈
+
+- 框架：React 18 + UmiJS 4
+- UI 组件：Arco Design
+- 样式：Less + CSS Variables
+- 状态管理：React Hooks + localStorage
+
+### 核心实现
+
+采用双属性主题系统：
+
+1. `arco-theme` 属性控制 Arco Design 组件主题
+2. `data-theme` 属性控制自定义 CSS 变量
+
+两个属性都设置在 `body` 元素上，确保选择器正确匹配。Less 变量引用 CSS 变量，实现编译时类型安全和运行时动态切换。
+
+## 文件清单
+
+### 主题系统核心文件
+
+主题变量统一定义在 `packages/shared-styles/` 共享包中：
+
+| 文件路径                                              | 说明                           |
+| ----------------------------------------------------- | ------------------------------ |
+| `packages/shared-styles/themes/normal/custom-var.less` | 亮色主题 CSS 变量定义          |
+| `packages/shared-styles/themes/dark/custom-var.less`   | 暗黑主题 CSS 变量定义          |
+| `packages/shared-styles/arco-override.less`            | Arco Design 变量覆盖映射       |
+| `packages/shared-styles/variables.less`                | Less 变量定义（引用 CSS 变量） |
+| `packages/shared-styles/index.less`                    | 入口文件，导入全部（主应用用） |
+| `packages/shared-styles/variables-only.less`           | 仅 Less 变量（子应用用）       |
+
+### Layout 应用文件
+
+| 文件路径                     | 说明                                      |
+| ---------------------------- | ----------------------------------------- |
+| `src/global.less`            | 导入 `<%= packageScope %>/shared-styles` 共享包 |
+| `src/common/theme.ts`        | 主题切换逻辑（`applyTheme`、`initTheme`） |
+| `src/hooks/useTheme.ts`      | 主题管理 Hook                             |
+
+## API / 组件接口
+
+### useTheme Hook
+
+```typescript
+type Theme = 'light' | 'dark';
+
+interface UseThemeReturn {
+  theme: Theme; // 当前主题
+  isDark: boolean; // 是否暗黑模式
+  toggleTheme: () => void; // 切换主题
+  setTheme: (theme: Theme) => void; // 设置指定主题
+}
+
+const { theme, isDark, toggleTheme, setTheme } = useTheme();
+```
+
+### CSS 变量使用
+
+```less
+// 在 Less 中使用 Less 变量（推荐，有类型提示）
+.my-component {
+  background-color: @color-fill-1;
+  color: @color-text-2;
+  border-color: @color-border-2;
+}
+
+// 或直接使用 CSS 变量
+.my-component {
+  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-*` |
+
+## 使用示例
+
+```tsx
+import { useTheme } from '@/hooks/useTheme';
+
+const ThemeToggle: React.FC = () => {
+  const { isDark, toggleTheme } = useTheme();
+
+  return (
+    <Button onClick={toggleTheme}>{isDark ? <IconSun /> : <IconMoon />}</Button>
+  );
+};
+```
+
+```less
+// 组件样式自动适配主题
+.my-card {
+  background-color: @color-text-5; // 亮色: 白色, 暗色: 深色
+  color: @color-text-1; // 亮色: 深色, 暗色: 白色
+  border: 1px solid @color-border-2;
+}
+```
+
+## 注意事项
+
+- `data-theme` 和 `arco-theme` 必须都设置在 `body` 元素上
+- 主题 CSS 变量选择器格式：
+  - 暗色主题：`body[data-theme='dark']`
+  - 亮色主题：`body[data-theme='normal']`（注意：使用 `'normal'` 而非 `'light'`）
+- Less 变量已封装 CSS 变量引用，优先使用 Less 变量（有编辑器提示）
+- 主题状态持久化在 localStorage，key 通过 `THEME.STORAGE_KEY` 常量统一管理
+- 未手动设置主题时，默认跟随系统偏好
+- `useTheme` 使用 `useSyncExternalStore` 实现跨组件状态同步，确保所有调用 `useTheme` 的组件共享同一个主题状态
+
+### 常量定义
+
+```typescript
+// src/common/constants.ts
+export const THEME = {
+  STORAGE_KEY: '<%= ProjectName %>-theme',
+  DEFAULT: 'light' as const,
+  VALUES: ['light', 'dark'] as const,
+} as const;
+```
+
+## 微前端子应用主题适配
+
+### 设计原则
+
+- **主应用（layout）** 负责定义和注入主题 CSS 变量到 `body`
+- **子应用** 只使用 Less 变量引用 CSS 变量，不重复定义
+- 子应用的 Less 变量通过 `var(--xxx)` 自动适配主题切换
+
+### 子应用配置
+
+#### 1. global.less - 仅导入 Less 变量
+
+```less
+// apps/[子应用]/src/global.less
+@import '<%= packageScope %>/shared-styles/variables-only';
+// 不要使用 @import '<%= packageScope %>/shared-styles'（会包含 CSS 变量定义）
+```
+
+#### 2. app.tsx - 开发环境条件注入
+
+```typescript
+// apps/[子应用]/src/app.tsx
+
+// 仅开发环境 + 独立运行时加载主题
+if (process.env.NODE_ENV === 'development') {
+  if (typeof window !== 'undefined' && !window.__POWERED_BY_QIANKUN__) {
+    import('./styles/theme.less');
+  }
+}
+```
+
+> **关键点**：使用 `process.env.NODE_ENV === 'development'` 而不是运行时判断，确保生产构建时主题代码被 tree-shake 移除。
+
+### 打包体积对比
+
+| 配置方式             | 生产 CSS 体积         | 是否推荐 |
+| -------------------- | --------------------- | -------- |
+| 直接导入主题         | ~9KB（含主题）        | ❌       |
+| 运行时条件导入       | ~9KB（含主题）        | ❌       |
+| **开发环境条件导入** | **~200B（不含主题）** | ✅       |
+
+### 验证方法
+
+构建后检查 CSS 是否包含主题变量：
+
+```bash
+# 构建子应用
+pnpm -C apps/[子应用] build
+
+# 检查 CSS 内容（不应包含 --Brand1-6 等变量定义）
+grep "Brand1-6" apps/[子应用]/dist/umi.css
+# 期望：无输出
+
+# 检查 CSS 体积
+wc -c apps/[子应用]/dist/umi.css
+# 期望：< 500 字节
+```
+
+### Arco Design 组件主题适配
+
+子应用使用 Arco Design 组件时，组件样式会自动跟随主应用的主题切换。
+
+#### 原理
+
+1. 主应用加载 Arco Design 并暴露到 `window.arco`
+2. 主应用的 `arco.css` 包含 `arco-theme` 属性选择器
+3. 主应用切换主题时设置 `body[arco-theme="dark"]`
+4. 子应用的 Arco 组件（来自 window.arco）自动应用暗色样式
+
+#### 子应用使用 Arco Design
+
+> 详细配置请参考 [微前端模式 - 依赖共享机制](./feature-微前端模式.md#依赖共享机制)
+
+```tsx
+// 子应用可以直接使用 Arco Design 组件
+import { Button, Card, Message, Tag } from '@arco-design/web-react';
+
+export default function Page() {
+  return (
+    <Card title="示例卡片">
+      <Button type="primary">主要按钮</Button>
+      <Tag color="arcoblue">标签</Tag>
+    </Card>
+  );
+}
+```
+
+**注意**：子应用需要配置 `externals` 将 Arco Design 排除打包，详见 [微前端模式文档](./feature-微前端模式.md#依赖共享机制)。
+
+## 相关文档
+
+- [微前端模式](./feature-微前端模式.md) - qiankun 微前端架构与依赖共享
+- [日志与常量](./arch-日志与常量.md) - Logger 工具与常量管理（含 THEME 常量）
+- [shared-styles 包](../../../packages/shared-styles/README.md) - 共享样式包使用指南
+- [提交规范](../../../docs/commit-message.md) - Git Commit 规范