mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-13 14:14:29 +08:00
9f04c0b5f8
- 修复 semantic-release 配置，切换到 conventionalcommits preset 并显式声明 breaking、revert、patch 语义 - 更新 auto-tag workflow，补充 preview 成功守卫、PAT 存活性校验、snapshot 说明与 release notes summary 输出 - 更新 AGENTS 与 semantic-release topic 的 tracking/trace，记录当前发版规则、验证结果与恢复点
45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
# Semantic Release 版本迁移追踪
|
||
|
||
## 2026-04-26
|
||
|
||
### 当前恢复点（SEMREL-RP-002）
|
||
|
||
- 当前链路：
|
||
- `workflow_dispatch` 手动启动
|
||
- `preview` 对 dispatch SHA 执行 dry-run
|
||
- `release-approval` environment 审批
|
||
- `release` 在同一次 run、同一 SHA 上执行真实打 tag
|
||
- 当前规则：
|
||
- `conventionalcommits` preset 负责解析 `feat!:` / `feat(scope)!:` 与 `BREAKING CHANGE`
|
||
- `feat -> minor`
|
||
- `fix/perf/refactor -> patch`
|
||
- `docs/test/chore/build/ci/style -> no release`
|
||
- `breaking -> major`
|
||
- 当前 workflow 加固：
|
||
- `release` 额外要求 `needs.preview.result == 'success'`
|
||
- `PAT_TOKEN` 在真实 release 前通过 GitHub API 做存活性校验
|
||
- preview / release summary 会展示 snapshot 语义与生成的 release notes
|
||
|
||
### 本轮关键决策
|
||
|
||
- 保留 `@semantic-release/release-notes-generator`，但不再让它白跑：
|
||
- 继续生成 notes
|
||
- 将 notes 写入 GitHub Actions summary
|
||
- 不保留已废弃的 `release_mode=preview|release` 中间方案：
|
||
- active trace 只保留当前有效链路
|
||
- 历史演进以 tracking 文档的已完成项为准
|
||
|
||
### 验证结论
|
||
|
||
1. `npx --yes -p semantic-release -p conventional-changelog-conventionalcommits@9.1.0 semantic-release --dry-run --no-ci`
|
||
- 已确认新 preset 包可加载，`commit-analyzer` 与 `release-notes-generator` 正常初始化
|
||
- 本次 dry-run 未继续出版本，因为干净克隆的 `main` 已落后远端
|
||
2. `dotnet build GFramework.sln -c Release`
|
||
- 通过，`639 warning / 0 error`
|
||
- warning 为仓库既有基线，本轮未新增关联 warning
|
||
|
||
### 下一步
|
||
|
||
1. 复查当前 PR 的 open review threads 是否只剩等待 push 的已修复项
|
||
2. 创建提交并推送当前分支
|