From 034399bad5e3ef2553a2e1fd027593d4f1a3bcd3 Mon Sep 17 00:00:00 2001 From: tianma-if Date: Sun, 19 Jul 2026 17:36:07 +0800 Subject: [PATCH] docs: simplify release guidance --- AGENTS.md | 14 ++++---------- 1 file changed, 4 insertions(+), 10 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 6418dd72..df1c5c0a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,11 +16,9 @@ ## GitHub Issue 与 Release 约束 -正式版本遵循 Semantic Versioning。发布前检查最新 Release 和远端标签，选择未使用的版本号。Git 标签与 Release 标题必须完全一致，格式为 `vX.Y.Z`。每个正式版本标签必须与一个已发布的 GitHub Release 一一对应，不得遗留只有标签、没有 Release 的正式版本；发现历史遗留的孤立正式标签时，应先识别并处理其影响，再继续发布新版本。 +正式版本遵循 Semantic Versioning，标签与 Release 标题统一使用 `vX.Y.Z`。发布前检查远端标签与实际 GitHub Release；孤立标签不作为发布基线，每个正式标签最终都应有对应 Release。 -Release 正文必须以上一个实际发布的正式 GitHub Release 为变更基线，完整审计从该 Release 标签到本次发布提交之间的全部提交，并面向用户汇总其中所有可感知变化，不得直接复制提交记录，也不得只说明当前任务或最新一次提交。若中间存在只有 Git 标签、没有对应 GitHub Release 的版本，不得将其视为发布基线；应继续回溯到最近一个实际存在的正式 Release。正文应覆盖该完整区间内的功能、修复、界面、文档及其他用户可感知变化；变更较多、需要审计或方便开发者追溯时，可按需附上 GitHub Compare 链接。 - -Release 标签必须指向 `main` 上经过验证的发布提交；默认发布为非 Draft、非 Prerelease。发布正文使用以下结构： +Release 以上一个实际发布的正式 Release 为基线，审计完整提交区间并面向用户汇总所有可感知变化。标签必须指向 `main` 上经过验证的提交，默认发布为非 Draft、非 Prerelease。功能或修复 Release 须关联带对应 Label 的 Issue；发布后回链并关闭 Issue。正文结构： ```md ## 主要更新 @@ -34,13 +32,9 @@ Release 标签必须指向 `main` 上经过验证的发布提交；默认发布 - 列出实际完成的测试、类型检查和构建结果。 ``` -每个功能或修复 Release 必须关联带有对应 Label 的 GitHub Issue；没有 Issue 时先创建。发布后在 Issue 中回链 Release，并按完成状态关闭。验证失败时不得发布正式 Release。 +验证失败时不得发布正式 Release。 -每个正式 Release 必须提供可直接安装的 Android APK 下载，并在发布前验证 APK 的版本号、签名和 SHA-256。是否重新构建 APK，应以上一个实际发布的正式 Release 为基线审计完整变更区间： - -- 若变更可能影响移动端运行时或安装包内容，必须从本次 Release 提交重新构建生产签名 APK。触发范围包括但不限于 `apps/mobile/**`、移动端实际引用的共享包、移动端依赖或锁文件、Android 原生配置，以及影响 APK 生成结果的构建脚本。不得使用测试签名或仅供单一测试设备使用的 APK 作为正式 Release 附件。 -- 若完整变更区间确认不影响移动端运行时或安装包内容，可复用最近一个已验证且兼容的正式 APK，无需无意义地重复编译。复用时必须保持 APK 的真实版本文件名与原始 SHA-256，并在 Release 正文及附件说明中明确标注来源 Release；不得重命名为当前版本或暗示它是本次新构建产物。 -- 创建 Release 后必须检查附件列表，确认 APK 实际上传成功且可下载；只有 AAB、Actions Artifact 或外部商店链接不满足 APK 附件要求。 +每个正式 Release 必须附带可安装的 Android APK。若完整变更区间影响移动端代码、其共享依赖、原生配置或 APK 构建，则从本次发布提交重新构建生产签名 APK；否则可复用最近的兼容 APK，并在正文中注明来源 Release。发布前验证 APK 版本、签名、SHA-256 及下载可用性。 ## Cloudflare 自动部署约束