generator-mico-cli 0.2.30 → 0.2.32

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

@@ -0,0 +1,54 @@
+#!/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"
+
+# 导出 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 公共路径（开发环境）
+# 路径格式: 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"
+
+# 开发环境，不上传 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
+
+pnpm run build:development
+
+# 只有在 CI 环境时才写入版本号文件（覆盖写入）
+if [ "${CI}" = "true" ]; then
+  echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+fi

package/generators/h5-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/h5-react/templates/CICD/start_prod.sh

@@ -0,0 +1,53 @@
+#!/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"
+
+# 导出 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 公共路径（生产环境）
+# 路径格式: 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"
+
+# ========== 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
+
+pnpm run build:production
+
+# 只有在 CI 环境时才写入版本号文件（覆盖写入）
+if [ "${CI}" = "true" ]; then
+  echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+fi

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

@@ -0,0 +1,55 @@
+#!/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"
+
+# 导出 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 公共路径（测试环境）
+# 路径格式: 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"
+
+# 测试环境，不上传 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
+
+pnpm run build:testing
+
+# 只有在 CI 环境时才写入版本号文件（覆盖写入）
+if [ "${CI}" = "true" ]; then
+  echo "VERSION=$VERSION" > .env_x_<%= projectName %>
+fi

package/generators/h5-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/<%= 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/<%= cdnPrefixPath %><%= projectName %>/$version",
+    "https://cdn-portal-dev.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version"
+  ],
+  "dirAction":"expire"
+}
+EOF
+

package/generators/h5-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/<%= 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/<%= cdnPrefixPath %><%= projectName %>/$version",
+    "https://cdn-portal.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version"
+  ],
+  "dirAction":"expire"
+}
+EOF
+

package/generators/h5-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/<%= 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/<%= cdnPrefixPath %><%= projectName %>/$version",
+    "https://cdn-portal-test.micoplatform.com/<%= cdnPrefixPath %><%= projectName %>/$version"
+  ],
+  "dirAction":"expire"
+}
+EOF
+

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

@@ -0,0 +1,301 @@
+# <%= ProjectName %>（<%= projectName %>）
+
+基于 **pnpm workspace** 与 **Turborepo** 的 **H5 Monorepo**：多个 [Umi 4](https://umijs.org/) 子应用、共享内部包与 ESLint 配置；根目录提供**开发网关**（按 `page.config.ts` 并行启动子应用并由单一端口反向代理）、**dev 预设**（并行启动预设列表中的应用），以及 **`pnpm dev`**（`scripts/dev.js`：在仓库根**交互式**只启动**一个**子应用，见下文）。
+
+## 脚手架与子应用
+
+| 场景 | 命令 |
+|------|------|
+| 新建本 Monorepo，并生成**首个**子应用 | 在空目录执行 **`mico create h5-react`**；交互中会询问 **CDN 路径前缀**（可选，用于 `CICD/` 中 `CDN_PUBLIC_PATH` 等，与 `micro-react` 语义一致）、首个子应用目录名（默认 `app`）及本地 dev 端口。基座生成后会**联动** **`subapp-h5`**，不在 h5-react 模板中重复维护子应用目录。 |
+| 已有本仓库，再增加子应用 | 在**仓库根目录**执行 **`mico create subapp-h5`**，可多次执行；生成器会创建 `apps/<名>/`，并更新根目录 **`page.config.ts`**、**`dev.preset.json`**（`presets.full.apps`）。 |
+
+约定：子应用目录名为 **kebab-case**，且 **`apps/<目录>/package.json` 的 `name` 与目录名一致**，以便 `pnpm dev:preset` 与 `pnpm --filter` 行为一致。
+
+## 技术栈
+
+| 类别 | 技术 |
+|------|------|
+| 包管理 | [pnpm](https://pnpm.io/) workspace（根目录 `packageManager` 钉扎 **pnpm@10.18.2**，可用 [Corepack](https://nodejs.org/api/corepack.html) 对齐版本） |
+| 构建编排 | [Turborepo](https://turbo.build/)（根目录 `build` / `build:development` / `build:testing` / `build:production` 与 `lint` 等走 `turbo run`；`turbo.json` 中 `dev` 任务供各包声明；根 **`pnpm dev`** 为 `scripts/dev.js`，见「根脚本说明」） |
+| 应用框架 | [Umi](https://umijs.org/) **4.x**（`catalog` 见 `pnpm-workspace.yaml`） |
+| 子应用配置 | **`<%= packageScope %>/umi-config`** 工厂（`createBaseConfig` / `createProConfig` / `createProductionConfig` 等）：所有子应用 `config/*.ts` 都委托到此包，避免重抄基础字段（详见下文与 **`.cursor/rules/umi-config.mdc`**） |
+| UI | React **18**（catalog）；**`<%= packageScope %>/components`** 提供项目级 `Layout` / `ImmersiveHeader` / `LayoutFooter` 等 |
+| 客户端通信 | **`<%= packageScope %>/js-bridge`**：iOS `MCAIJsBridge.post` / Android `Omigo.post`，统一 `callJSBridgeMethods<D, T>`、`getUserInfo`、`closeH5Page` 等 |
+| 样式 | [Tailwind CSS](https://tailwindcss.com/) **3.x** + **`tailwindcss-safe-area`** 安全区工具类（**`subapp-h5` 模板默认接入** `@umijs/plugins`；与 Less 等可并存） |
+| HTTP / 开发联调 | Umi **`@umijs/plugins/dist/request`** + **`<%= packageScope %>/request`**（统一 URL 与拦截器）；开发期 **`defineMock`** + **`mock/`**，公共逻辑（**`baseUrl`** / **`tryProxy`** 远程透传 / **`validateBody`** zod 校验）来自 **`<%= packageScope %>/utils/mock`**；请求/响应类型就近定义在 **`src/services/`** 下对应模块中（约定见 **`.cursor/rules/umi-mock.mdc`**、**`.cursor/rules/workspace-request.mdc`**） |
+| 监控与 Source Map | 子应用依赖 **`@common-web/sentry`**（布局 **`SentryErrorBoundary`**、生产 **`externals`**）；**`<%= packageScope %>/umi-config`** 中的 `createProductionConfig` 自动注入 **`@sentry/webpack-plugin`**，在生产构建时上传 Legacy Sourcemap（需 **`SENTRY_AUTH_TOKEN`**，见下文） |
+| 语言 | TypeScript 5 |
+| 代码质量 | ESLint **9**（扁平 **`eslint.config.*`**、**`typescript-eslint`** + **`<%= packageScope %>/eslint`** + Prettier）、Stylelint **14**、Husky、lint-staged（**仓库根 `.lintstagedrc.js` 集中维护**）、[commitlint](https://commitlint.js.org/) |
+| 格式化 | 根目录 `.prettierrc.json`；子应用通过 ESLint 的 `eslint-plugin-prettier` / `eslint-config-prettier` 与 Prettier 对齐 |
+| 环境变量 | [dotenv-cli](https://github.com/entropitor/dotenv-cli)；**仓库根**集中维护 `.env`、`.env.development`、`.env.testing`、`.env.production` |
+
+## 环境要求
+
+- **Node.js**：建议 **22 LTS 及以上**。
+- **pnpm**：与根 **`packageManager`** 一致。
+
+## 环境变量文件
+
+`.env*` 集中在仓库**根目录**维护（**不要**在每个子应用下重复放）。根 `package.json` 中各脚本通过 `dotenv-cli` 按以下顺序加载（后者存在才生效）：
+
+| 命令 | 加载链 |
+|------|------|
+| `pnpm dev:gateway` | `.env` → `.env.local` → `.env.development` → `.env.development.local` |
+| `pnpm build` / `pnpm build:production` | `.env` → `.env.local` → `.env.production` → `.env.production.local` |
+| `pnpm build:development` | `.env` → `.env.local` → `.env.development` → `.env.development.local` |
+| `pnpm build:testing` | `.env` → `.env.local` → `.env.testing` → `.env.testing.local` |
+
+模板默认提供：
+
+- **`.env.development`**：本地开发；`UMI_APP_API_BASE_URL=/api`（配合 `createDevConfig` 的默认 `/api` 代理到测试环境）
+- **`.env.testing`**：测试环境
+- **`.env.production`**：生产环境
+
+四个环境内含 `CHECK_TIMEOUT`、`UMI_APP_API_BASE_URL`、`UMI_APP_CDN_BASE_URL`、`UMI_APP_LANG_BASE_URL`、`UMI_APP_ENV` 等变量；`UMI_APP_ENV` 用于 **`<%= packageScope %>/utils/env`** 的 `isDev` / `isTest` / `isProd` / `isDebug` 判断，与 `UMI_ENV` 共同决定运行/构建行为。
+
+## 快速开始
+
+```bash
+pnpm install
+
+# 方式一：网关（读取 page.config.ts，单端口代理多应用）
+pnpm dev:gateway
+
+# 方式二：dev 预设（并行启动预设中的应用，无统一网关端口）
+pnpm dev:preset
+pnpm list:preset
+
+# 方式三：根目录交互式启动单个子应用（扫描 apps/；仅一个应用时直启，多个时终端选序号）
+pnpm dev
+```
+
+单独开发某一子应用：
+
+```bash
+cd apps/<子应用目录>
+pnpm dev
+```
+
+## 目录结构（示意）
+
+```
+.
+├── apps/                         # 各 Umi 子应用（目录名 = page.config 键）
+│   └── <子应用>/                 # 由 h5-react / subapp-h5 生成；含 eslint.config.ts、config/（薄封装到 umi-config 工厂）、src/（含 intl、app 运行时、services/、layouts/、pages/）、mock/、Tailwind 等
+├── packages/
+│   ├── common-intl/              # <%= packageScope %>/common-intl — @common-web/common-intl 的项目级封装（re-export + 预配置 init()）；依赖 domain、request、js-bridge
+│   ├── components/               # <%= packageScope %>/components — Layout / ImmersiveHeader / LayoutFooter 等项目级 UI；依赖 js-bridge、utils
+│   ├── constant/                 # <%= packageScope %>/constant — 业务常量（如 MEMBER_CONSTANT），按业务域拆文件
+│   ├── deeplink/                 # <%= packageScope %>/deeplink — 客户端跳转链接的语义层（占位实现，按业务协议改写）
+│   ├── domain/                   # <%= packageScope %>/domain — 运行时/环境变量解析 API、CDN、多语言接口等基址（window.__MICO_CONFIG__ 与 UMI_APP_*）
+│   ├── eslint/                   # <%= packageScope %>/eslint — ESLint 9 扁平共享配置（base / react 导出）
+│   ├── js-bridge/                # <%= packageScope %>/js-bridge — H5 与原生通信（callJSBridgeMethods、getUserInfo、closeH5Page 等）
+│   ├── request/                  # <%= packageScope %>/request — 基于 Umi `request` 的统一 HTTP 封装（拦截器、URL 与 apiBaseUrl 拼接；common-intl 的 init() 已内部绑定）
+│   ├── typescript/               # <%= packageScope %>/typescript — 共享 tsconfig（base / react）
+│   ├── umi-config/               # <%= packageScope %>/umi-config — 子应用 Umi 配置工厂（base / dev / prod / 各 UMI_ENV）+ Sentry 上传插件
+│   └── utils/                    # <%= packageScope %>/utils — 工具函数（env / url / number / date / md5 / Tailwind cn / mock baseUrl & tryProxy & validateBody 等）
+├── CICD/                      # Jenkins：环境构建、CDN_PUBLIC_PATH、网宿刷新等（创建时按 cdnPrefix 生成路径）
+├── scripts/
+│   ├── dev.js               # 根目录 pnpm dev：选单个子应用 + dotenv + pnpm --filter
+│   ├── gateway.ts           # 开发网关：起子应用 + http-proxy
+│   ├── dev-preset.js        # 按 dev.preset.json 并行启动指定应用
+│   ├── dev-preset.schema.json
+│   └── collect-dist.js      # 将各 apps/*/dist 汇总到根目录 dist/*（build / test 成功后执行）
+├── dev.preset.json          # dev:preset 的预设
+├── page.config.ts           # 网关要启动的应用（键 = apps 下文件夹名）
+├── turbo.json               # Turborepo 任务：build / build:development / build:testing / build:production / dev / lint / lint:fix
+├── pnpm-workspace.yaml      # workspace 范围 + catalog 版本钉扎
+├── package.json             # 根包名：<%= projectName %>
+├── .env / .env.development / .env.testing / .env.production  # 集中环境变量
+├── .lintstagedrc.js         # 仓库根集中维护的 lint-staged 规则
+├── .prettierrc.json         # Prettier 根配置
+├── .commitlintrc.js         # commitlint 规则（继承 conventional）
+└── README.md
+```
+
+> **Sentry sourcemap 上传插件已迁移**到 **`packages/umi-config/src/plugins/apply-sentry-plugin.ts`**，由 `createProductionConfig` 自动调用；仓库根 `scripts/` 不再持有该文件。
+
+## 根脚本说明
+
+| 命令 | 说明 |
+|------|------|
+| `pnpm dev:gateway` | 运行 `scripts/gateway.ts`：根据 `page.config.ts` 启动子应用并起代理；访问路径为 `/{apps 下目录名}` |
+| `pnpm dev:preset` | 按 `dev.preset.json` 的默认预设（或 `pnpm dev:preset <预设名>`）并行启动指定应用；通过 `pnpm --filter <包名>` 调用各包 `dev`，并注入与根目录一致的 dotenv 文件链 |
+| `pnpm list:preset` | 列出 `dev.preset.json` 中全部预设及应用列表；`pnpm dev:preset --config` 可打印配置文件路径 |
+| `pnpm dev` | 运行 `scripts/dev.js`：扫描 `apps/` 下存在 `package.json` 且含 `scripts.dev` 的目录；**仅一个**时直接启动，**多个**时在终端按序号选择；经解析到的 **dotenv-cli** 加载根目录 `.env` 链后执行 `pnpm --filter <包名> run dev`。**不是** `turbo run dev` |
+| `pnpm build` | `turbo run build` 成功后执行 `scripts/collect-dist.js`：`build` 任务依赖上游包的 `^build`（见 `turbo.json`），并纳入生产相关 env 作为输入；各 Umi 应用先产出 `apps/<名>/dist/**`，脚本再**移动**为根目录 `dist/<名>/`（并删除根级 `.map`，便于 CDN 部署、与 Sentry sourcemap 流程配合） |
+| `pnpm build:development` | 与开发环境 CICD 对应：`UMI_ENV=development` 的各包构建 + `collect-dist`；支持可选环境变量 **`TURBO_FILTER`** 限定子包 |
+| `pnpm build:testing` | 与测试环境 CICD 对应：`UMI_ENV=testing` |
+| `pnpm build:production` | 与生产环境 CICD 对应：`UMI_ENV=production`（子应用 `package.json` 中默认 `build` 指向此项） |
+| `pnpm lint` / `pnpm lint:fix` | `turbo run lint` / `turbo run lint:fix` |
+| `pnpm lint-staged` | 供 Husky 使用，**直接调用 `lint-staged`**（读根 `.lintstagedrc.js`，**不**经过 Turborepo） |
+| `pnpm prepare` | 安装 Husky（`pnpm install` 后由 pnpm 自动执行） |
+
+## Turborepo（`turbo.json`）要点
+
+- **`build` / `build:development` / `build:testing` / `build:production`**：分别 `dependsOn` 自身的 **`^<同名>`**，并将根目录对应的 `.env*` 链纳入 `inputs`（如 `build:development` 会绑定 `.env`、`.env.local`、`.env.development`、`.env.development.local`）；各包声明的产出为 `dist/**`（Umi 子应用即 `apps/<应用名>/dist`）。子应用 **`scripts.build`** 默认指向 `build:production`。
+- **`dev`**：`persistent: true`、`cache: false`；供各包声明 `dev` 脚本时使用。根目录 **`pnpm dev` 不经过 Turborepo**，而是由 `scripts/dev.js` 只拉起**一个**子应用（见上表）。
+- **`lint` / `lint:fix`**：无额外产物输出配置，便于并行检查。
+- **`test`**：当前未在 `tasks` 中定义；若启用测试流水线，需补充 `test` 任务及各包脚本（见下文「常见问题」）。
+- **`globalEnv`**：模板已包含 **`CDN_PUBLIC_PATH`**、**`BRANCH_OR_TAG`**、**`VERSION`**、**`SENTRY_AUTH_TOKEN`**；**`envMode: "loose"`**，避免严格模式下未声明的 env 影响开发体验。可按需追加业务变量。
+
+## 构建产物汇总（`scripts/collect-dist.js`）
+
+在 **`pnpm build`** 或 **`pnpm test`** 中 Turborepo 阶段成功结束后执行：遍历 `apps/` 下每个子目录，若存在 `apps/<名>/dist`，则将其**移动**到仓库根目录 **`dist/<名>/`**（根 `dist/` 已列入 `.gitignore`）。脚本会删除汇总目录中的 **`.map`** 文件（注释说明为配合 Sentry 上传 sourcemap、避免把 map 部署到 CDN）。**注意**：移动后原 `apps/<名>/dist` 不再存在，需重新构建才能再次得到子应用本地 `dist`。
+
+## 子应用 Umi 配置（委托给 `<%= packageScope %>/umi-config`）
+
+子应用 **`config/`** 下的所有文件都是**薄封装**，只 `import` 工厂并把业务自定义 delta 作为第二参数传入。Umi 在加载时按 `config.ts` < `config.[UMI_ENV].ts` < `config.[dev|prod].ts` < `config.[dev|prod].[UMI_ENV].ts` 顺序合并，因此本包按「基础 + 环境 delta」拆为 6 个工厂：
+
+| 工厂 | 子应用文件 | 职责 |
+|------|-----------|------|
+| `createBaseConfig` | `config/config.ts` | 公共基础配置：`mountElementId`、`history`、Tailwind / request 插件、`postcss-pxtorem`、`monorepoRedirect` 等（沿用 Umi 默认 `codeSplitting`，**不**显式声明） |
+| `createDevConfig` | `config/config.dev.ts` | `umi dev` delta：默认 `/api` 代理 |
+| `createProConfig` | `config/config.prod.ts` | 构建公共 delta：`publicPath: 'auto'` + `cssPublicPath: './'`（运行时按 HTML 加载位置解析，与 qiankun `runtimePublicPath` 兼容）、`externals`、`chainWebpack` 关闭 `runtimeChunk`（runtime 内联进入口 `umi.js`）+ 删 `runtimePublicPath` 插件 + 把异步 chunk 命名为 `[name].[contenthash:8].async.js`。**单参**调用，不再需要 `appName` |
+| `createDevelopmentConfig` | `config/config.prod.development.ts` | `UMI_ENV=development` delta（默认空，保留扩展点） |
+| `createTestingConfig` | `config/config.prod.testing.ts` | `UMI_ENV=testing` delta（默认空） |
+| `createProductionConfig` | `config/config.prod.production.ts` | `UMI_ENV=production` delta：`hidden-source-map` + 自动 Sentry sourcemap 上传 |
+
+```ts
+// 示例：apps/<应用>/config/config.prod.production.ts
+import { createProductionConfig } from '<%= packageScope %>/umi-config/config.prod.production';
+export default createProductionConfig({ appName: '<子应用 name>' }, { /* custom delta */ });
+```
+
+约束与细节（含 Sentry urlPrefix、各文件职责、不要在子应用里重抄 externals 等）见 **`.cursor/rules/umi-config.mdc`**。
+
+## Sentry 运行时与 Source Map 上传
+
+- **依赖**：根 **`pnpm-workspace.yaml`** 的 **`catalog`** 声明 **`@common-web/sentry`**；子应用 `package.json` 用 **`catalog:`** 引用。**`@sentry/webpack-plugin`** 安装在 **`packages/umi-config`** 的 `devDependencies`（不在仓库根，也不在子应用），由 `createProductionConfig` 自动加载。
+- **运行时**：各子应用 **`src/layouts/index.tsx`** 使用 **`SentryErrorBoundary`** 包裹 **`Outlet`**。生产 **`externals`** 把 **`react`**、**`react-dom`**、**`@common-web/sentry`** 标记为 **`React` / `ReactDOM` / `CommonWebSentry`**，需与主应用或页面注入的全局变量保持一致。
+- **Source Map 上传**：由 **`packages/umi-config/src/plugins/apply-sentry-plugin.ts`** 实现，在 `createProductionConfig` 的 `chainWebpack` 中自动 `apply`；使用 Legacy Sourcemap 路径（`urlPrefix` = `~/<%= cdnPrefixPath %><%= projectName %>/<version>/<appName>`，与 CICD 写出的 `CDN_PUBLIC_PATH` 一致）；构建前需注入 **`SENTRY_AUTH_TOKEN`**（**`turbo.json`** 的 **`globalEnv`** 已声明）。
+- **开发/生产差异**：开发使用 `createBaseConfig` 默认配置（沿用 Umi 默认 `codeSplitting`，支持动态 `import()`）；构建时 `createProConfig` 关闭 `runtimeChunk`、删除 `runtimePublicPath` 插件、固定异步 chunk 命名为 `[name].[contenthash:8].async.js`——宿主页只引一个入口 JS 即可启动，按需切片仍走 webpack 5 默认的 `document.currentScript.src` 解析逻辑，与 CDN 部署兼容。
+
+## CI/CD（`CICD/`）
+
+根目录 **`CICD/`** 提供 Jenkins 流水线脚本（如 `before_build.sh`、`start_dev.sh`、`start_test.sh`、`start_prod.sh`、`start_local.sh`、`wangsu_fresh_*.sh` 等）。创建项目时 **`mico create h5-react`** 会按交互输入的 **CDN 路径前缀**（可选，对应 `.micorc` 的 `cdnPrefix`）生成脚本中的 **`CDN_PUBLIC_PATH`** 与网宿刷新路径中的占位，格式为：
+
+`https://cdn-portal[-env].micoplatform.com/<prefix>/<projectName>/<version>/`（无前缀时省略 `<prefix>/` 段）。
+
+与 `micro-react` 一致：前缀用于区分不同业务线在 CDN 上的目录。
+
+## 子应用与网关
+
+- **`page.config.ts`**：导出对象，**键**为 `apps/` 下的文件夹名，值为 `true` 等占位即可。新增子应用后键名由 **`mico create subapp-h5`** 写入（也可手工维护）。
+- **代理**：网关从 **3000** 起探测可用端口；各子应用使用递增的本地端口（自 **4000** 起探测）。控制台会打印直连地址与经网关访问的 URL。访问网关根路径 `/` 会展示各子应用链接列表。
+- **路径与 Umi**：网关将 `/{key}` 前缀**改写**后再转发到子应用，因此经网关访问使用带前缀的 URL；**单独**在某应用目录执行 `pnpm dev` 时，一般为 Umi 默认根路径 `/`。
+- **路由**：**`config/routes.ts`** 模板只包含静态基础路由（如首页）；注释约定动态菜单可从 **`window.__MICO_MENUS__`** 等获取，按业务自行接入。
+
+## dev 预设（`dev.preset.json`）
+
+`dev.preset.json` 的 `presets.<名>.apps` 为要并行启动的包名列表（与 `apps/<目录>/package.json` 的 `name` 一致）。初始创建后 `full` 预设会包含首个子应用；后续每执行一次 **`mico create subapp-h5`** 会将新应用追加到 `full.apps`（若尚未存在）。
+
+若预设中 `apps` 为空，执行 `pnpm dev:preset` 会报错——请先至少创建一个子应用或编辑预设。
+
+## Tailwind CSS（Umi 子应用）
+
+由 **`mico create subapp-h5`** 生成的子应用**已默认接入** Tailwind 3 + **`tailwindcss-safe-area`**：
+
+- `package.json` 中 `tailwindcss`、`tailwindcss-safe-area`、`@umijs/plugins` 为 **`catalog:`**
+- 应用根目录含 **`tailwind.css`**（含 `@tailwind base/components/utilities`，并配置 `font-size: 16px;` 与 `1vw` 适配，与 `postcss-pxtorem` 配合做 H5 字号缩放）
+- 应用根目录含 **`tailwind.config.js`**（**ESM**，扫描 `./src/**`、排除 `.umi*`，并把 **`packages/components/src`** 加入 `content`，挂 `safeAreaConfig` 插件）
+- **`@umijs/plugins/dist/tailwindcss`** 与 **`tailwindcss: {}`** 由 `createBaseConfig` 默认注入，子应用 **`config/config.ts`** 不需要再写
+
+可直接在页面里写 Tailwind 类名，包括安全区工具类（`pt-safe`、`pb-safe-or-4`、`px-safe`、`size-safe` 等）。**`<%= packageScope %>/components`** 中 `Layout` / `ImmersiveHeader` / `LayoutFooter` 已基于这些类名实现，依赖子应用把组件包源码加入 `content`。
+
+手工接入或旧应用补全的步骤（含 `content` 路径、ESM 写法等）见 **`.cursor/rules/tailwind-umi.mdc`**。
+
+## 内部包
+
+> 完整规则见 **`.cursor/rules/internal-packages.mdc`**；列表概览：
+
+- **`<%= packageScope %>/utils`**：通用工具（`tailwind` 的 `cn`/`cva`/`VariantProps`、`env` 平台/环境判断、`url`、`number`、`date`、`md5`、**`mock`**：开发 mock 复用的 **`baseUrl`** + **`tryProxy`** 远程透传 + **`validateBody`** zod 入参校验），按 **`./<文件>`** 子路径直接 import。
+- **`<%= packageScope %>/domain`**：导出 **`apiBaseUrl`**、**`cdnBaseUrl`**、**`langBaseUrl`** 等；优先读 **`window.__MICO_CONFIG__`**，否则回退 **`UMI_APP_API_BASE_URL`** / **`UMI_APP_CDN_BASE_URL`** / **`UMI_APP_LANG_BASE_URL`**。被 **`request`**、**`common-intl`**、**`js-bridge`** 等依赖。
+- **`<%= packageScope %>/js-bridge`**：H5 ↔ 原生通信。**`canUseJSBridge`** + **`callJSBridgeMethods<D, T>(method, payload, options?)`**（处理 Android `postID` 路由 / iOS callback / Loading 防抖）；常用方法子路径如 **`./getUserInfo`**、**`./closeH5Page`**。开发期 `getUserInfo` 在 `isDebug` 下可回退 fetch 远程登录接口，便于本地联调（**线上不要开放**）。
+- **`<%= packageScope %>/request`**：对 Umi 运行时 **`request`** 的薄封装——统一 URL 解析（相对路径会拼 **`apiBaseUrl`**）、请求/响应拦截器、错误归一化、并发请求池。`isShowLoading` 默认 `true`，`skipRequestInterceptors` / `skipResponseInterceptors` / `rawUrl` 等选项见 **`.cursor/rules/workspace-request.mdc`**。`common-intl` 的 `init()` 内部已绑定该实例。
+- **`<%= packageScope %>/common-intl`**：**`@common-web/common-intl`** 的项目级封装——re-export 上游全部 API，并提供预配置的 **`init()`**（内部使用 **`<%= packageScope %>/js-bridge` 的 `getUserInfo()`** 取语言、绑定 `request` + `langBaseUrl`）。无构建步骤，`exports` 直接指向源码 TS。详见 **`packages/common-intl/README.md`** 与 **`.cursor/rules/common-intl.mdc`**。
+- **`<%= packageScope %>/components`**：项目级 UI（**`Layout`** / **`ImmersiveHeader`**（默认头：返回按钮通过 `closeH5Page` 走 JSBridge）/ **`LayoutFooter`**）。按子路径 import（如 `import Layout from '<%= packageScope %>/components/Layout'`）；图片资源通过 **`./assets/*`** 导出。
+- **`<%= packageScope %>/constant`**：业务常量集中地，按业务域拆文件（如 `member.ts`），`exports` 同时导出 **`.`** 与 **`./<文件>`**。
+- **`<%= packageScope %>/deeplink`**：客户端跳转链接的语义层（占位实现，业务侧需按客户端 deeplink 协议改写）。
+- **`<%= packageScope %>/umi-config`**：子应用 Umi 配置工厂集合（`createBaseConfig` / `createDevConfig` / `createProConfig` / `createDevelopmentConfig` / `createTestingConfig` / `createProductionConfig`）+ 内部 **`plugins/apply-sentry-plugin.ts`**。**所有子应用 `config/*.ts` 必须委托到本包**，详见 **`.cursor/rules/umi-config.mdc`**。
+- **`<%= packageScope %>/eslint`**（`"type": "module"`）：**`exports`**：**`.`** → `eslint.config.base.ts`（推荐 + TS + Prettier，已 ignore `mock/**`、`tailwind.config.*`、`postcss.config.*`、`src/.umi*`），**`./react`** → `eslint.config.react.ts`（再叠 React / Hooks / Refresh）。子应用在应用根目录维护 **`eslint.config.ts`**，`import` **`<%= packageScope %>/eslint/react`** 并 `defineConfig` 展开。
+- **`<%= packageScope %>/typescript`**：提供 `tsconfig.base.json`、`react` 等导出；当前 Umi 子应用与 **`packages/components`** / **`packages/umi-config`** 等含 Umi 类型的包默认继承 **Umi 生成的** `./src/.umi/tsconfig.json`，纯 TS 包则 `extends "<%= packageScope %>/typescript"`。
+
+## 子应用：请求、多语言与 Mock（`subapp-h5` 模板约定）
+
+由 **`mico create subapp-h5`** 生成的子应用默认包含：
+
+- **`config/`** 全部委托到 **`<%= packageScope %>/umi-config`**（含 `plugins`、`request: {}` 等基础字段，子应用内不重复）。
+- **`src/intl.ts`**：使用 **`init({ tag, indexedDBParams })`**（`<%= packageScope %>/common-intl` 预配置封装）取得 `{ fetchMultilingualData, i18n }`，再用 **`addIntl({ ... }, i18n)`** 定义文案对象并 `export default`，同时 `export { fetchMultilingualData }`。`init()` 内部经 **`<%= packageScope %>/js-bridge` 的 `getUserInfo()`** 拿语言，并已绑定 **`<%= packageScope %>/request`** + **`langBaseUrl`**，**子应用无需再传 `requestInstance` / `lang` 等**。
+- **`src/app.tsx`**：**`render`** 钩子在首屏前执行 **`fetchMultilingualData()`**，成功或失败都会 **`oldRender()`**（失败时用兜底文案）。
+- **`src/layouts/index.tsx`**：用 **`SentryErrorBoundary`** 包裹 **`<Outlet />`**。
+- **`src/services/<域>.ts`**：请求/响应类型 + 服务函数就近定义（与 `request<响应, 请求>(...)` 泛型、Mock 响应共用同一套类型）。
+- **`mock/<域>.ts`**：从 **`<%= packageScope %>/utils/mock`** 引入 **`baseUrl`** / **`tryProxy`** / **`validateBody`**，统一 mock 路径键、referer 透传与入参校验逻辑；入参用 **zod** schema + `validateBody(req.body, schema, res)`，响应用 **mockjs** 占位。约定见 **`.cursor/rules/umi-mock.mdc`**。
+
+微前端场景下仍可按 **`packages/common-intl/README.md`**：主应用初始化后子应用只读共享文案；独立 H5 子应用则以 **`@/intl`** 为业务入口。
+
+## ESLint / Stylelint / Prettier
+
+- **ESLint**：子应用 **`package.json`** 的 `lint` / `lint:fix` 为 **`eslint`** / **`eslint --fix`** 与 **stylelint** 组合（见各应用脚本）；配置为应用根目录 **`eslint.config.ts`**（flat config），继承 workspace **`<%= packageScope %>/eslint/react`**。各内部包同样在自身根目录维护 **`eslint.config.ts`**（继承 **`<%= packageScope %>/eslint`** 或 **`/react`**）。版本由根 **`pnpm-workspace.yaml`** 的 **`catalog.eslint`**（**^9**）钉扎。
+- **Stylelint**：子应用 **`.stylelintrc.js`** 继承 **`umi/stylelint`**，与 `lint` 脚本中的 stylelint 命令一致；`packages/*` 不跑 stylelint。
+- **Prettier**：由共享 ESLint 配置中的 **`eslint-plugin-prettier` / `eslint-config-prettier`** 与根 **`.prettierrc.json`** 对齐。
+- 根目录 **`pnpm lint`** 通过 Turborepo 调度各子应用 / 内部包的 `lint` 脚本；**`pnpm lint-staged`** 走根 `.lintstagedrc.js`，命中文件按 **`v10_config_lookup_from_file`** 解析最近的 flat config。
+
+## Git 钩子
+
+- **Husky**：根目录 `package.json` 已配置 **`"prepare": "husky"`**，在 **`pnpm install`** 时会安装钩子。新克隆仓库后务必先执行一次 `pnpm install`。
+- **pre-commit**（`.husky/pre-commit`）：提交前执行 `pnpm run lint-staged`，再 `git add .` 把格式化结果重新暂存。
+- **commit-msg**（`.husky/commit-msg`）：通过 `pnpm exec commitlint --edit` 校验提交说明；规则见根目录 **`.commitlintrc.js`**。
+- **lint-staged**：**统一在仓库根 `.lintstagedrc.js`**（CommonJS）维护：
+  - `apps/*/**/*.{js,jsx,ts,tsx}` → `eslint --flag v10_config_lookup_from_file --fix`
+  - `apps/*/**/*.{css,less}` → `stylelint --fix`
+  - `packages/!(eslint)/**/*.{js,jsx,ts,tsx}` → `eslint --flag v10_config_lookup_from_file --fix`
+  - **不再**在每个 `packages/<x>/` 下放 `.lintstagedrc`，新增包/应用直接被根 glob 命中。
+
+使用 `git commit --no-verify` 会跳过上述校验。
+
+## Cursor 规则（`.cursor/rules/`）
+
+仓库内预置 **`.mdc`** 规则，便于编辑器与协作时对齐约定：
+
+- **`monorepo`**：总览（目录、scripts、env、catalog 等）
+- **`umi-app`**：子应用 TS / ESLint / 委托 `umi-config` 工厂的写法
+- **`umi-config`**：子应用配置工厂（`createBaseConfig` / ... / `createProductionConfig`）与 Sentry 接入
+- **`umi-mock`**：Mock + `<%= packageScope %>/utils/mock`（`baseUrl` / `tryProxy` / `validateBody`）+ 与 `src/services/` 类型对齐
+- **`workspace-request`**：**`<%= packageScope %>/request`** API 与拦截器
+- **`common-intl`**：**`<%= packageScope %>/common-intl`** 与 `init()`（含 `js-bridge.getUserInfo` 取语言）
+- **`tailwind-umi`**：Tailwind 3 + `tailwindcss-safe-area` + 与 `<%= packageScope %>/components` 配合
+- **`internal-packages`**：所有 `packages/*` 的命名空间、exports、依赖关系
+- **`package-json`**：`workspace:^` / `catalog:` / 根脚本 / lint-staged
+- **`cicd-deploy`**：Jenkins、CDN、Sentry 注意事项
+- **`git-hooks`**：Husky / 根目录 `.lintstagedrc.js` / commitlint
+
+修改 **配置工厂、Mock、请求封装、多语言、Tailwind、JSBridge** 等公共能力时，优先打开对应规则对照。
+
+## 配置要点
+
+- **`.npmrc`**：可按团队需要配置 **scope 级 registry**（例如 **`@common-web`**），请勿将令牌提交到公开仓库；模板默认指向自建 nexus 仓库与 `package-lock=false`。
+- **根 `package.json`**：装 **ESLint、Stylelint**（catalog）、**`@types/http-proxy`**、**`@types/mockjs`**、**`http-proxy`**、**`mockjs`**、**`zod`**、**`portfinder`**、**`chalk`**、**`dotenv-cli`**、**`turbo`**、**`prettier`** 等，供 Turborepo / Mock / Gateway 等使用；子应用通过 `catalog:` 与 workspace 对齐版本。
+- **`@sentry/webpack-plugin`** 安装在 **`packages/umi-config`** 的 `devDependencies`（不在仓库根、不在子应用），保持 Sentry 上传逻辑闭环。
+- **`pnpm.overrides`**：固定 `eslint: catalog:` 与 `jiti: ^2`；`peerDependencyRules.allowedVersions` 放行 `eslint@9` / `react@18` / `react-dom@18`，避免 ESLint 9 / React 18 在子包间出现冲突的 peer 警告。
+
+## 常见问题
+
+1. **网关 404**  
+   检查 `page.config.ts` 是否包含对应键，且 `apps/<键>` 存在有效 `package.json`。
+
+2. **`pnpm dev` 与 `pnpm dev:gateway` / `pnpm dev:preset` 区别**  
+   根目录 **`pnpm dev`** 只启动**一个**子应用（`scripts/dev.js`，交互或自动选定）；**`pnpm dev:gateway`** 按 **`page.config.ts`** 拉起**全部**已配置键对应的应用并走统一代理；**`pnpm dev:preset`** 按 **`dev.preset.json`** 并行启动预设里的应用列表（无网关）。若需要「Turbo 并行 dev 多个包」，需在根 `package.json` 自行增加脚本（例如 `turbo run dev`），默认模板未将根 `pnpm dev` 绑定到 Turborepo。
+
+3. **`pnpm test` 失败**  
+   需在 `turbo.json` 与各包中补齐 `test` 任务与脚本。
+
+4. **Windows**  
+   `gateway.ts` 子进程在 Windows 上使用 `shell: true`。
+
+5. **子进程 stderr 中的 Rebuilding…**  
+   多为 Tailwind 等工具进度输出，一般不是错误。
+
+---
+
+维护者可根据团队规范补充部署、分支策略与发布流程等。

package/generators/h5-react/templates/_gitignore

@@ -0,0 +1,30 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+node_modules
+.umirc.local.ts
+config/config.local.ts
+**/src/.umi
+**/src/.umi-production
+**/src/.umi-test
+dist
+.swc
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files
+.env.local
+.env.*.local
+
+
+# Turborepo cache
+.turbo
+.turbopack

package/generators/h5-react/templates/_npmrc

@@ -0,0 +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/
+link-workspace-packages=true
+//nexus-vywrajy.micoworld.net/repository/mico-base-common/:_auth=bWljby1ucG06SDR4WUROazdad1NeczltblJMTw==
+

package/generators/h5-react/templates/dev.preset.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "./scripts/dev-preset.schema.json",
+  "presets": {
+    "full": {
+      "description": "启动所有应用",
+      "apps": []
+    }
+  },
+  "default": "full"
+}