OhGithubLost

release_notes · 发布说明

每版本一个 Markdown,中英逐条对照,固定小节:新增 / 变更 / 修复 / 已知限制 / 产物。

正文是怎么进到 Release 页的(v6.4.2 起自动化)

发布作业 build.yml → release job 的「生成发布说明」步骤按优先级取正文:

顺序 来源 说明
① workflow 输入 release_notes 手工 dispatch 时显式传入
② release_notes/v<版本>.md 正规来源
③ release_notes/v<版本>-<通道>.md 预发布(如 v7.0.0-beta.md)
④ 自动模板 兜底;同时发 warning 提示缺文件

在此之前只有 ① 和 ④ —— 仓库里写好的发布说明不会出现在 Release 页上, 线上看到的是信息量最少的模板(263 字符 vs 笔记的 1500+),于是每个版本都得 事后手工 PATCH 一次,漏了就一直是错的。现在发布作业自己读笔记。

若某版 Release 正文明显偏短(只有通道/版本/产物三行),说明当时用的是 兜底模板:检查 release_notes/v<版本>.md 是否存在,然后 PATCH 补上。

跳版本核查结论(2026-10-06 全量比对)

把 CHANGELOG、本目录、changed/_posts/、线上 Release 四处清单逐版本比对后:

版本 情况
v6.0.1 CHANGELOG / 本目录 / 日志站都有,但从未发布为 GitHub Release(线上 404)。改动已并入 v6.2.0;日志站那一篇已如实标注并指向 v6.2.0。
v4.4.0 CHANGELOG 有条目,但本目录与日志站都缺文件,且未标注未发布。本文件为事后补齐。
v5.4.0 / v5.5.0 明确标注「内部开发版 · 未单独发布」 → 正确。
v5.7.0 / v5.8.0 / v2.1.0 明确标注「未发布 / 跳过」 → 正确。
v5.9.0 明确标注「未发布成功 · 构建失败」 → 正确(本目录保留其说明,日志站按无日期跳过)。
其余 CHANGELOG 写 v4.2.0-alpha 而文件名为 v4.2.0-alpha.md,属命名后缀差异,非缺口。

结论:真正的缺口只有 v6.0.1 缺 GitHub Release 与 v4.4.0 缺发布说明(已补)。 不再为 v6.0.1 事后补建 Release —— 它没有对应的构建产物,凭空建一个空 Release 会让人误以为它发布过;日志站那篇已说明情况并指向 v6.2.0。

文件 对应版本
v7.4.0.md 7.4.0 正式版(仓库文件操作接入文件操作服务 + 遗留缺陷修复批)
v7.3.1.md 7.3.1 正式版(界面细节修复批:弹层闭场动效 / 表单返回保护 / 动效与无障碍覆盖 / 多语言文案)
v7.3.0.md 7.3.0 正式版(新增文件操作服务 + 传输层健全 + 界面与交互修复)
v7.2.2.md 7.2.2 正式版(修复一轮界面与交互审查发现的问题)
v7.2.1.md 7.2.1 正式版(调整平台架构兼容性)
v7.0.0.md 7.0.0 正式版(新增 Web 版 + 按版本发布到 app/)
v6.5.0.md 6.5.0 正式版(一轮全量审查的修复)
v6.4.3.md 6.4.3 正式版(删内置代理,只留自定义通道;去掉静默降级)
v6.4.2.md 6.4.2 正式版(图标改由 assets/icon 派生 + 修两个自 v5.6.0 起存在的缺陷)
v6.4.1.md 6.4.1 正式版(私有仓库加速的知情警告弹窗)
v6.4.0.md 6.4.0 正式版(界面语言由 15 种收敛为 6 种)
v6.3.0.md 6.3.0 正式版(无障碍 + 截屏矩阵 + 可见性统一)
v6.2.0.md 6.2.0 正式版(下载链路重做 + 文件预览 + 隐私承诺)
v6.0.1.md 6.0.1 正式版(加速通道换新代理 + 实验性 Web(wasm))
v6.0.0.md 6.0.0 正式版(合并 v5.9.0 未发布功能)