Repository navigation
v0.1.15
这次修的是什么
维护轮门禁此前从未生效——月度 workflow maintenance.yml(2026-10-19 加入,cron 0 4 5 * *)
至今 0 次运行、0 个维护轮 issue,而真实地板漂移是 20 仓(阈值 8):门禁到期不报,
且没人知道信号丢了。三个根因互相叠加:
maintenance_check.py不认MATRIX_BASE——CI 布局下 24 仓全部「读不到」。
脚本硬编码BASE = parent.parent.parent,而matrix.repo_dir(repo, base)的语义是
base or os.environ.get("MATRIX_BASE", ...)——base 非空就把环境变量短路掉。
CI 里仓克隆在$GITHUB_WORKSPACE/repos/<name>,三个候选路径一个都不命中
⇒ 24 仓全抛FileNotFoundError⇒ 被except Exception吞掉 ⇒MAINTENANCE_COUNT=0。- 后果是反向的:
count == '0'走的正是「关闭维护轮 issue」分支
⇒ 门禁方向反了——到期不报、反而关单。 - 标签
matrix-maintenance在本仓不存在 ⇒ 即使走对分支,issues.create也会
422 Validation Failed,issue 依然开不出来。(matrix-drift存在,所以audit.yml
的漂移 issue 开得出来——这就是两个 workflow 表现不一致的原因。)
连带:align_floors.py 是同一行硬编码,而它是维护轮唯一的整改工具
⇒ 定位错 ⇒ 整改命令打到错误目录。
改了什么
scripts/maintenance_check.py:base 解析认MATRIX_BASE(与audit.py同口径),
--base可显式覆盖,新增--repos单仓盘点;「读不到」与「真的没漂移」分开——
读不到的仓计入MAINTENANCE_UNDETERMINED,且不再打印「✓ 全矩阵地板零漂移」
(与 audit 在 #79 对 remote tag 的处理同口径:读不到 ≠ 事实为空)。scripts/align_floors.py:同样认MATRIX_BASE/ 新增--base/--repos。.github/workflows/maintenance.yml:显式传--base "$PWD/repos";
set -o pipefail让脚本崩溃传导为步骤失败(而不是被tee吞成 0);
关闭分支收紧为count == '0' && undetermined == '0'——只有确定没有漂移才关单;
计数缺失(脚本崩了)⇒ 明确失败、不改动任何维护轮 issue;
开 issue 前确保标签存在(自愈,不依赖仓外的带外设置)。scripts/maintenance_check_selftest.py(新):一道没人验证过的门禁,很可能自己就是
个假绿。自测用临时目录 + 临时 git 仓(不联网、不碰真仓)复刻 CI 布局,证明仓能
被认出、漂移能被算出来、仓读不到时不许输出「零漂移」、align_floors.py同样认
MATRIX_BASE。改前红 4/5、改后绿 5/5(同一命令行,失败原因只能是 bug 本身)。.github/workflows/audit.yml:自测接入既有selftestjob。README.md:补维护轮 workflow 说明与两个工具的 base 口径。