补充tag #1

Open
opened 2026-09-10 21:04:41 +08:00 by augushong · 0 comments
Owner

总结完毕,计划已落盘到 .omo/tag-backfill-plan.md(新任务直接照单执行,无需再调查)。

情况说明

断档比想象的久:tag 链停在 v2.2.8(2026-06-01),之后的 129 个提交(MCP、XHProf、nginx-log、S3/WebDAV、定时器重构……)全都没打过标签。这些工作跨了几个「版本里程碑」,但发布时只走了「改 VERSION 常量」这一步,--push-tag 从未执行。

还有一个考据发现:v2.3.x / v2.4.0 / v2.5.0 这些号从来没进过 VERSION 常量——VERSION 从 v2.2.8 直接跳到 v2.5.1(2906d51,2026-09-07)。那些号只存在于升级工具链里(admin:update:code --update-version v2.5.0、tips.php 条目、nginx-log 的 v2.4.0 升级脚本),是升级标记,不是发布版本号。

所以 v2.6.0 的 COMMENT 没写少——v2.5.1→v2.6.0 真实就 5 个内容提交,4 个有分量的都写了。「应该有很多提交」的感觉来自 tag 起点太老(129 个提交的量),不是本期漏写。

能不能补

能,但只有 v2.5.1 一个诚实锚点(2906d51,真实存在过的 VERSION 里程碑)。补上之后 tag 链变成 v2.2.8 → v2.5.1 → v2.6.0,与 VERSION 常量历史一一对应,以后 --generate-comment / --generate-release 的起点就正确了。

v2.4.0 / v2.5.0 / v2.3.x 不建议补——没有可挂的真实版本提交,硬补就是伪造里程碑。

新任务的执行要点(详见计划文件)

  1. 从 2906d51 的历史版本提取当时的 COMMENT 作注解消息(保真)
  2. git tag -a v2.5.1 2906d51 -F <消息文件> → git push origin v2.5.1 → 验证
  3. 全程宿主机操作(容器无 git/SSH,已实证)
  4. 纯增量操作,不动分支、不动常量、不重写历史

顺带记了一个可选的长期修复进计划:给 dev 镜像装 git 或让 pushTag() 在 git 缺失时明确报错,避免下次发布再踩 --push-tag 静默失败的坑。

新任务要开的时候说一声就行。

总结完毕,计划已落盘到 `.omo/tag-backfill-plan.md`(新任务直接照单执行,无需再调查)。 ## 情况说明 **断档比想象的久**:tag 链停在 `v2.2.8`(2026-06-01),之后的 129 个提交(MCP、XHProf、nginx-log、S3/WebDAV、定时器重构……)全都没打过标签。这些工作跨了几个「版本里程碑」,但发布时只走了「改 VERSION 常量」这一步,`--push-tag` 从未执行。 **还有一个考据发现**:`v2.3.x / v2.4.0 / v2.5.0` 这些号**从来没进过 VERSION 常量**——VERSION 从 v2.2.8 直接跳到 v2.5.1(`2906d51`,2026-09-07)。那些号只存在于升级工具链里(`admin:update:code --update-version v2.5.0`、tips.php 条目、nginx-log 的 v2.4.0 升级脚本),是升级标记,不是发布版本号。 **所以 v2.6.0 的 COMMENT 没写少**——v2.5.1→v2.6.0 真实就 5 个内容提交,4 个有分量的都写了。「应该有很多提交」的感觉来自 tag 起点太老(129 个提交的量),不是本期漏写。 ## 能不能补 **能,但只有 `v2.5.1` 一个诚实锚点**(`2906d51`,真实存在过的 VERSION 里程碑)。补上之后 tag 链变成 `v2.2.8 → v2.5.1 → v2.6.0`,与 VERSION 常量历史一一对应,以后 `--generate-comment` / `--generate-release` 的起点就正确了。 **v2.4.0 / v2.5.0 / v2.3.x 不建议补**——没有可挂的真实版本提交,硬补就是伪造里程碑。 ## 新任务的执行要点(详见计划文件) 1. 从 `2906d51` 的历史版本提取当时的 COMMENT 作注解消息(保真) 2. `git tag -a v2.5.1 2906d51 -F <消息文件>` → `git push origin v2.5.1` → 验证 3. 全程宿主机操作(容器无 git/SSH,已实证) 4. 纯增量操作,不动分支、不动常量、不重写历史 顺带记了一个可选的长期修复进计划:给 dev 镜像装 git 或让 `pushTag()` 在 git 缺失时明确报错,避免下次发布再踩 `--push-tag` 静默失败的坑。 新任务要开的时候说一声就行。
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ulthon/ulthon_admin#1
No description provided.