Peach: Local-first video metadata scraper and media manager.
fix(release): 排队兜底的报错写清查不到 runner 的两种情形
longmeidaod35761e64706
diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.mdindex b36e25b4d..18ab59761 100644--- a/docs/OPERATIONS.md+++ b/docs/OPERATIONS.md@@ -668,7 +668,7 @@ Windows 托盘在取得单实例锁后启动独立监视器。监视器用 Win32- **定版**:在干净的 master 主检出上运行 `python scripts/release_tag.py --bump auto --apply`。它按上一个版本标签到 HEAD 的区间定档(`bump_part_for()`:主题以 `feat` 开头、带破坏性标记 `!`,或 `migrations/` 有新文件时推 minor,其余推 patch;1.0 要手工 `--bump major` 并另立 ADR,见 ADR-0012),写入 `__version__`,并把 `CHANGELOG.md` 的未发布一节定成这个版本号。区间只改了文档、技能和测试时直接拒绝,因为那样打出的包和上一个标签完全相同。`--bump` 只写文件不提交,并打印定版的那一节供人检查;不带 `--apply` 只打印计划。- **发布**:确认之后运行 `python scripts/release_tag.py --ship --apply`,一次完成剩下四步:提交 `src/peach/__init__.py` 与 `CHANGELOG.md`(消息 `chore(release): 版本 <新版本>`)、推送 master、每 30 秒查一次这个提交的 Test 工作流、变绿后创建并推送 annotated tag。默认最多等 30 分钟,用 `--timeout` 修改。不带 `--apply` 只打印步骤。- `--ship` 在动手前检查:不在 master、变更日志缺这一节、标签已被占用、工作区除了那两份定版文件还有别的改动,任何一条成立就拒绝(标签指向发布提交,夹带什么就等于发布什么)。Test 结束不是绿色就立刻停,这时标签还没打。-- 等 Test 期间能确定等不到结果的也立刻停,不耗到超时:GitLab 必需任务(`verify-linux`、`verify-windows`、`verify-macos`、`wheel-smoke`)已失败;任务排着队没人接,且带这些 tags 的 runner 都不在线或已暂停(读 runner 列表要维护者权限,读不到时改为排队满 5 分钟仍未开始才停);推送 5 分钟后仍没有 Test 记录。报错写明任务名、tags 和已等时长。GitHub 只对自建 runner 任务做同样判断,托管 runner 排队照常等。处理好之后再跑一次 `--ship --apply` 接着走。+- 等 Test 期间能确定等不到结果的也立刻停,不耗到超时:GitLab 必需任务(`verify-linux`、`verify-windows`、`verify-macos`、`wheel-smoke`)已失败;任务排着队没人接,且带这些 tags 的 runner 都不在线或已暂停(读 runner 列表要维护者权限;读不到,或列表里查不到带这些 tags 的 runner 时,按排队满 5 分钟仍未开始判停);推送 5 分钟后仍没有 Test 记录。报错写明任务名、tags 和已等时长。GitHub 只对自建 runner 任务做同样判断,托管 runner 排队照常等。处理好之后再跑一次 `--ship --apply` 接着走。- 中途停下(断网、CI 还在跑、超时)就再运行一次同一条命令:每一步都先看当前状态,已提交的不重复提交,已推送的不重复推送,Test 没绿绝不打标签。- 单独补打标签用 `python scripts/release_tag.py`:默认只检查本地与 GitHub master 一致、这个提交最新的 Test 全绿、`CHANGELOG.md` 有这个版本的一节、标签不存在;加 `--apply` 才创建 annotated tag 并只推送这个标签。适用于发布提交已推送、只差标签的情况。变更日志那一节是硬性要求,缺了先用 `--bump` 起草。版本标签不覆盖,下一版先改 `__version__`。推送失败留下本地标签时,先确认归属再人工处理,不强推。Release 工作流会再检查标签提交在 master 历史里、同一提交的 Test 已通过,然后构建、验收制品、创建预发布。打标签代表公开预发布,不等于替换本机生产入口。- 已确认的发布提交推送后,若 master 继续推进,用 `python scripts/release_tag.py --release-sha <完整提交 SHA>` 核对固定提交的发布计划,确认输出后加 `--apply` 补打标签。这个模式从选定提交读取版本与变更日志,并在创建标签前再次核对主线归属、同一提交最新的绿色 Test 和标签占用;只推送标签,保留当前 master。它不能与 `--bump`、`--ship` 或 `--verify-sha` 合用。diff --git a/scripts/release_tag.py b/scripts/release_tag.pyindex 23daa8655..ad30fbade 100644--- a/scripts/release_tag.py+++ b/scripts/release_tag.py@@ -142,7 +142,8 @@ def _stalled(queued: list[dict], first_seen: dict, now: float) -> list[str]:"带这些 tags 的 runner 都不在线或已暂停")elif waited >= STALL_SECONDS:lines.append(f"{job['name']}(tags:{tags})排队 {waited / 60:.0f} 分钟未开始;"- "读不到 runner 列表,runner 不在线或一直被占着都会这样")+ "确认不了有没有带这些 tags 的在线 runner(列表要维护者权限,"+ "共享 runner 也未必列出),runner 不在线或一直被占着都会这样")return lines