docs: 补充版本变更日志与发版规则

This commit is contained in:
SkyJourney
2026-08-26 11:48:53 +08:00
parent 64445322eb
commit 55614fafed
2 changed files with 254 additions and 1 deletions
+15 -1
View File
@@ -1,5 +1,16 @@
# 发版规则
## 变更日志与发布说明
根目录 [`CHANGELOG.md`](../CHANGELOG.md) 是版本变更摘要的单一事实来源。
每项面向用户或部署方的重要新增、修复、行为变化和兼容性变化应先记录在
`Unreleased`;冻结版本时将相关内容移动到带发布日期的版本章节。
Gitea Release 页面正文应以 `CHANGELOG.md` 对应版本章节为基础生成,可按发布
场景补充下载提示,但不得与变更日志中的功能、兼容性和验证结论冲突。
`docs/releases/v<version>.md` 用于保存更详细的发布门禁、验证结论和内部发行说明,
不单独维护另一份相互矛盾的版本摘要。
## 唯一产物目录
所有正式分发文件必须统一归集到仓库根目录下的:
@@ -54,7 +65,8 @@ TTF、OTF、WOFF 和 WOFF2 必须由 Git LFS 跟踪。新增或升级字体前
1. 完成全量测试、类型检查、生产构建和视觉门禁。
2. 构建字体直接内置的 Desktop 安装包和便携 ZIP。
3. 构建并验证版本化 Docker 镜像。
4. 准备 `docs/releases/v<version>.md`
4. `CHANGELOG.md` 中本版本变更从 `Unreleased` 冻结为带日期的版本章节,
并以该章节为基础准备 `docs/releases/v<version>.md` 与 Gitea Release 正文。
5. 执行:
```powershell
@@ -65,6 +77,8 @@ TTF、OTF、WOFF 和 WOFF2 必须由 Git LFS 跟踪。新增或升级字体前
7. 创建内容完整的 `release:` 提交。
8. 重新生成 release 清单,确保 `gitCommit` 指向该发布提交。
9. 创建 annotated `v<version>` 标签,标签说明与发布提交正文一致。
10. 发布 Gitea Release,正文以 `CHANGELOG.md` 对应版本章节为基础,并附上
本轮正式分发文件。
安装器公开分发前应完成 Authenticode 签名;未签名产物只能按内部发布风险
规则分发。