## 基础信息
```bash
nodejs 20.19.0
pnpm 10.12.4
```

## 本地开发
```bash
  npm run dev # 启动研发环境
  npm run dev:test # 启动测试环境
  npm run dev:pro # 启动生产环境
```

## 构建说明
项目提供了多种构建方式，分别适用于不同的场景：
```bash
  # 构建生产环境
  npm run build # 不生成tag分支与版本文件
  # 以下脚本都会生成tag分支与版本文件
  npm run build:test # 构建测试环境
  npm run build:pro # 构建生成环境
  npm run build:tag:test # 基于特定tag 构建测试环境
  npm run build:tag:pro # 基于特定tag 构建生产环境
```

### 1、测试构建
用于日常开发测试，自动生成带时间戳的测试版本tag，如：`test-202508061340`
```bash
  npm run build:test
```
* 执行该命令会：
  * 自动生成格式为 `test-YYYYMMDDHHmm` 的tag
  * 在dist目录下生成包含版本信息的 `version.json` 文件
  * 不会修改 `package.json` 中的版本号

### 2、发布构建
用于发布正式版本，自动生成带版本号的tag,如：`publish-v0.0.2`
```bash
  npm run build:pro
```
* 执行该命令会：
  * 自动生成格式为 `publish-vX.X.X` 的tag
  * 在dist目录下生成包含版本信息的 `version.json` 文件
  * 会更新 `package.json` 中的版本号


### 3、基于特定tag构建
用于基于已有的tag进行构建，用于重新构建特定tag版本的代码
```bash
  npm run build:tag:test # 基于特定tag 构建测试环境
  npm run build:tag:pro # 基于特定tag 构建生产环境
```

### 4、构建注意事项
1. 确保在执行构建命令前已提交所有更改
2. 发布构建会修改 `package.json` 中的版本号，请确保有相应的权限
3. 基于指定 `tag` 版本构建会切换工作目录到指定 `tag` 分支，构建完成后会自动切换回原分支，若切换失败则需手动切换回原分支
4. 所有构建命令都会自动创建对应的 `git tag`，用于版本追踪，仅打包构建除外
5. 构建完成后，建议手动检查 `dist` 目录下的文件，确保无误

### 5、仅打包构建
适用于仅打包，不生成 `tag` 的场景
```bash
  npm run build
```
* 执行该命令后，仅会打包生成 `dist` 目录，不会生成 `tag`，也不会修改 `package.json` 中的版本号