feat: 更新 Web 项目发布构建的 GitHub Action,确保版本号输出统一添加 v 前缀,优化版本获取逻辑,更新文档以反映新格式和使用示例。

This commit is contained in:
Lyda
2025-08-20 19:29:45 +08:00
parent da4e1db20d
commit e4063690cd
5 changed files with 53 additions and 45 deletions

View File

@@ -80,7 +80,8 @@ Action 自动处理各种版本格式,确保输出一致:
# - package.json: "v1.2.3" 或 "1.2.3"
# - 提交信息: "release: v1.2.3" 或 "release: 1.2.3"
# 输出始终为: "1.2.3" (不含 v 前缀)
# 输出始终为: "v1.2.3" (统一添加 v 前缀)
# 带横线版本: "v1-2-3" (保持 v 前缀)
```
## 输入参数
@@ -125,8 +126,8 @@ Action 支持通过 `env` 传递**任意数量**的环境变量给发布命令
| 参数名 | 描述 |
| ------------------- | -------------------------------------- |
| `version` | 发布的版本号 |
| `version-with-dash` | 版本号(点号替换为横线) |
| `version` | 发布的版本号(带 v 前缀) |
| `version-with-dash` | 版本号(带 v 前缀,点号替换为横线) |
| `release-status` | 发布命令执行状态 (`success`/`failure`) |
| `exit-code` | 发布命令退出码(仅在失败时有值) |
@@ -303,10 +304,10 @@ steps:
2. **智能版本获取**: 只在发布成功时执行,通过多种方法自动获取版本号
- 优先从版本文件读取(`/tmp/last-version` 或自定义路径)
- 回退到最新 git tag自动去除 `v` 前缀
- 回退到最新 git tag保持原始格式
- 回退到 `package.json` 中的版本
- 最后尝试从提交信息解析(支持 `v1.2.3``1.2.3` 格式)
- **所有方法都确保输出包含 `v` 前缀**
- **所有方法都确保输出统一包含 `v` 前缀**
3. **发布总结**: 显示详细的发布状态信息
@@ -342,7 +343,7 @@ steps:
module.exports = {
hooks: {
"before:release": [
"echo '${version}' > /tmp/last-version",
"echo 'v${version}' > /tmp/last-version",
"npm run build",
],
},
@@ -465,7 +466,7 @@ A: Action 会按优先级尝试多种方法获取版本:
```javascript
// .release-it.js
hooks: {
'before:release': ['echo \'${version}\' > /tmp/last-version']
'before:release': ['echo \'v${version}\' > /tmp/last-version']
}
```
@@ -486,9 +487,9 @@ A: Action 会按优先级尝试多种方法获取版本:
4. **提交信息**:在提交信息中包含版本号
```bash
git commit -m "release: 1.2.3"
# 或者
git commit -m "release: v1.2.3"
# 或者
git commit -m "release: 1.2.3"
```
### Q: Gitea Token 权限不足