os-release

# OS Release — 发版清单 ## 为什么有这份清单 机检管得住的部分不用你记，跑一条命令即可。这份清单只管**机检管不住的部分**，以及 **谁按哪个按钮**。 历史上同型漏项两次：**tag 推了、GitHub Release 条目没建**，访客主页的 latest 徽章 因此卡在旧版本两周。所以别把"tag 推完"当成发版完成——第 10 步才是。 ## 执行分工（硬约束：发布流水线必须可中断） | 步骤 | 谁执行 | | --- | --- | | 1–6 准备与校验 | Leader 全权 | | 7 commit · 8 tag | Leader 执行，但**先把 `git diff --stat` 与拟好的 message 交用户批准** | | 9 双仓推送 · 10 建 Release 条目 | **用户执行**。Leader 只把命令准备好打印出来 | | 11 事后核对 | Leader（只读） | 不要代替用户 push / publish，也不要在未批准前 commit。 --- ## 1. 预检全绿 ```bash bash scripts/preflight.sh # 发版必须跑全量，不要 --fast ``` 五道门禁：`ruff check src/ tests/` → `dashboard npm run lint` → 前端实时事件回归 （`npm --prefix dashboard test`）→ `check_invariants.sh` → `pytest tests/unit/`。 **机检条目数以脚本输出为准**，别在别处写死范围（当前到 I21）。 失败长这样：每项后面跟 `✗ <门禁名> 失败`，末尾 `✗ 预检未通过 — 修复后再 push`。 退出码非 0。 两处**既定豁免**： - 未构建 `dashboard/dist` 的环境里 I3 输出 `⚠️ dist 目录缺失（未构建环境可忽略）` ——警告不拦。但发版必须构建（见第 4 步），所以发版时这条不该还是警告。 - I16 在 execpolicy rules 或 Codex 二进制缺席时输出 `⚠️ [I16] Codex execpolicy（...）` ——本期是占位状态，warn 不拦。它转成 ok 的那一天要留意：那意味着这台机器上真的跑了 一次宿主校验，结论才有分量。 ## 2. 版本锁步七处 **I2 机检的五处**（漂移即红，`❌ [I2] 版本号漂移: ...`）： - `pyproject.toml` - `src/aiteam/__init__.py` - `plugin/.claude-plugin/plugin.json` - `plugin/.claude-plugin/marketplace.json` - `.claude-plugin/marketplace.json` **另两处由 I6 第①类硬等式盯**：`README.md` 与 `README.zh-CN.md` 的 announcement 行 （`> ⚡` 开头）必须含 `v<新版本>`，否则 `❌ [I6] README 数字漂移`。 **机检不覆盖、必须人眼看的**：`plugin/.claude-plugin/plugin.json` 里 `description` 文本中的数字（MCP 工具数、生命周期事件数）。v1.11.1 那次人审抓到的唯一实...