ci(release): M139 发布 CI 只跑两个 Windows 槽位，整表六槽位改为手动取证

build 矩阵从六个槽位裁到 windows-x64 / windows-arm64 两个： - 矩阵改由新增的 `plan` job 生成（`fromJSON(needs.plan.outputs.matrix)`），槽位表只在该 job 里有一份，`mode: ci` 默认编、`mode: probe` 只有 `all_slots=true` 才编； - `workflow_dispatch` 新增 `all_slots` 布尔输入（默认 false = 只跑 Windows）， Linux/macOS 四档保留完整定义与打开办法（改 mode 一行），取证能力没删； - `PUBLISH_SLOTS` 不变（两个 Windows 槽位）；齐全性检查仍按下载下来的产物判，白名单槽位没编/编挂就 fail，不会因矩阵变小而永远过； - packaging/README.md §1/§3/§4/§9 与 release-notes.md 的 Downloads / Support matrix 同步成「四档默认不构建」，不留「六槽位都构建」的旧说法。
2026-11-06 11:33:52 +08:00
1 parent f617f60134
commit 9de51e16af
@@ -1,21 +1,18 @@
 name: Release

-# 发布流水线：tag `v*` → 四平台（六槽位）矩阵**全部构建** → 单文件产物 + SHA256SUMS
-# → 上传 artifact + 创建 GitHub Release（pre-release 默认开）。同一 tag 重跑幂等：
-# Release 已存在时覆盖资产与说明，不再 `gh release create`（见 release job 末步）；
-# 重跑**不碰** pre-release 标记，该标记只在 `inputs.prerelease` 显式给出时才被断言。
+# 发布流水线：tag `v*` → **只构建两个 Windows 槽位** → 单文件产物 + SHA256SUMS → artifact + GitHub Release
+# （pre-release 默认开；同 tag 重跑幂等 = 覆盖资产与说明而不 create；重跑不碰该标记，只在显式 inputs.prerelease 时才断言）
 #
-# **构建 ≠ 发布**：六槽位一律构建取证，但只有 release job 的 `PUBLISH_SLOTS` 白名单里的槽位会进 Release
-# 与 SHA256SUMS。当前只有两个 Windows 槽位 —— Linux/macOS 四档从未真构建成功过一次、也没在真机跑过，
-# 未验证的产物不推给用户（开关与打开办法见该处注释）。
+# **构建 ≠ 发布**：只有 release job 的 `PUBLISH_SLOTS` 白名单里的槽位才会进 Release 与 SHA256SUMS。
+# **CI 只跑两个 Windows 槽位**（M139）：Linux x64/arm64、macOS arm64/x64 四档从未真构建成功过一次、
+# 也没在真机跑过，默认**一个都不跑**（省 CI 配额、不留没意义的红叉）；要整表六槽位取证走手动入口
+# `gh workflow run release.yml -f all_slots=true`（槽位表在 `plan` job 里，唯一真相源）。
 #
-# 契约唯一真相源：packaging/README.md（命名/目录/运行时依赖/发布白名单）。
-# 打包本体在 packaging/make_artifacts.py（本地与 CI 同一份脚本，逐字节同布局）。
-# 手动触发（workflow_dispatch）默认只跑构建不建 Release —— 用来把六槽位矩阵整体编一遍取证。
-# `inputs.prerelease` 只在 **tag ref** 上 dispatch 才可达（Actions 页面只能选分支，要跑 tag 得
-# `gh workflow run release.yml --ref v0.2.1`）；分支 ref 的 dispatch 与 push 一样被 release job 的
-# `if: github.ref_type == 'tag'` 挡在发布之外，所以「dispatch 只构建不发布」与「dispatch 可关
-# pre-release」并不矛盾。
+# 契约唯一真相源：packaging/README.md（命名/目录/运行时依赖/发布白名单）；打包本体在
+# packaging/make_artifacts.py（本地与 CI 同一份脚本，逐字节同布局）。`inputs.prerelease` 只在 **tag ref**
+# 上 dispatch 才可达（Actions 页面只能选分支，跑 tag 得 `gh workflow run release.yml --ref v0.2.1`）；
+# 分支 ref 的 dispatch 与 push 一样被 release job 的 `if: github.ref_type == 'tag'` 挡在发布之外，所以
+# 「dispatch 只构建不发布」与「dispatch 能关 pre-release」并不矛盾。

 on:
  push:
@@ -23,6 +20,10 @@ on:
      - "v*"
  workflow_dispatch:
    inputs:
+      all_slots:
+        description: "构建全部六个槽位（含未验证的 Linux/macOS 四档）；默认只跑两个 Windows"
+        type: boolean
+        default: false
      prerelease:
        description: "标记为 pre-release（仅在 tag ref 上 dispatch 时才生效）"
        type: boolean
@@ -40,51 +41,55 @@ concurrency:
  cancel-in-progress: false

 jobs:
+  # M139：矩阵不写死在 `build` 里，改由本 job 按 `inputs.all_slots` 生成 —— 矩阵不能带 `if`，而
+  # `jobs.<id>.strategy` 可读 `needs`，所以「默认两个 Windows / 手动整表六槽位」用
+  # `fromJSON(needs.plan.outputs.matrix)` 实现。**槽位表只在下面这一处**，改槽位只改这里。
+  plan:
+    name: 选槽位（默认两个 Windows）
+    runs-on: ubuntu-latest
+    outputs:
+      matrix: ${{ steps.pick.outputs.matrix }}
+    steps:
+      - name: 生成 build 矩阵（`all_slots=true` 才整表六槽位）
+        id: pick
+        shell: bash
+        env:
+          ALL_SLOTS: ${{ inputs.all_slots }}
+        run: |
+          set -euo pipefail
+          python3 - "$ALL_SLOTS" >> "$GITHUB_OUTPUT" <<'PY'
+          import json, sys
+          # 槽位表（唯一真相源）。mode："ci" = 默认在 CI 里构建；"probe" = 未验证，仅 all_slots=true 时构建。
+          SLOTS = [
+              # Windows x64：MSVC + 静态 CRT（+crt-static）→ exe 不依赖 VC++ 可再发行包，双击即用的单文件。
+              dict(slot="windows-x64", os="windows-latest", target="", build_dir="target/release", rustflags="-C target-feature=+crt-static", mode="ci"),
+              # Windows arm64：在 windows-latest（x64 宿主）**交叉编译**到 aarch64-pc-windows-msvc，产物在
+              # target/<triple>/release（故 build_dir 参数化）；不用原生 windows-11-arm 的理由见 README §4。
+              dict(slot="windows-arm64", os="windows-latest", target="aarch64-pc-windows-msvc",
+                   build_dir="target/aarch64-pc-windows-msvc/release",
+                   rustflags="-C target-feature=+crt-static", mode="ci"),
+              # ↓ 四档**未验证，不纳入 CI**：从未真构建成功过一次、也没在真机跑过，默认一个都不编；
+              #   `all_slots=true` 时照编（那是将来验证 Linux/macOS 的唯一入口，别删）。真机验证通过后：
+              #   把该行 mode 改成 "ci"（一行一改，不用重写矩阵）+ 槽位键加进 PUBLISH_SLOTS + 同步
+              #   packaging/README.md §1/§9 与 release-notes.md 的 published 列 —— 三处不一致即是假话。
+              #   Linux 固定 22.04 而非 latest：否则 glibc 地板跟着 runner 漂移（依据见 README §4）。
+              dict(slot="linux-x64", os="ubuntu-22.04", target="", build_dir="target/release", rustflags="", mode="probe"),
+              dict(slot="linux-arm64", os="ubuntu-22.04-arm", target="", build_dir="target/release", rustflags="", mode="probe"),
+              # macOS：latest = arm64；Intel x64 用 macos-15-intel（macos-13 已下线）。
+              dict(slot="macos-arm64", os="macos-latest", target="", build_dir="target/release", rustflags="", mode="probe"),
+              dict(slot="macos-x64", os="macos-15-intel", target="", build_dir="target/release", rustflags="", mode="probe"),
+          ]
+          keep = [s for s in SLOTS if s["mode"] == "ci" or sys.argv[1] == "true"]
+          print("matrix=" + json.dumps({"include": keep}, separators=(",", ":")))
+          print("本次构建槽位：" + " ".join(s["slot"] for s in keep), file=sys.stderr)
+          PY
+
  build:
    name: build (${{ matrix.slot }})
+    needs: plan
    strategy:
      fail-fast: false
-      matrix:
-        include:
-          # Windows x64：MSVC + 静态 CRT（+crt-static）→ exe 不依赖 VC++ 可再发行包，
-          # 双击即用的单文件形态；UCRT 本身就是 Win10+ 的系统组件。
-          # 产物根 target/release；自检与打包都从 matrix.build_dir 取路径（不硬编码）。
-          - slot: windows-x64
-            os: windows-latest
-            build_dir: target/release
-            rustflags: -C target-feature=+crt-static
-          # Windows arm64：在 windows-latest（x64 宿主）上**交叉编译**到 aarch64-pc-windows-msvc。
-          # 不用 windows-11-arm 原生 runner（GitHub 文档 2026 已把它列为公开仓库免费 runner）的理由：
-          # ① 双 Windows 槽位共用同一套已验证镜像/工具链，tag 重跑行为与既有槽位一致；② M50 的 dumpbin
-          # 定位链取 `Hostx64/x64/dumpbin.exe`，它读 ARM64 PE 的导入表没问题，而原生 ARM 宿主上那条链
-          # 还得再长一条 `Hostarm64/arm64` 分支——为一个槽位放宽刚立的门禁不值得；③ 交叉产物路径变成
-          # target/<triple>/release，已用 matrix.build_dir 参数化。将来改原生：os 换 windows-11-arm、
-          # 去掉 target/rustflags 依赖并给 dumpbin 定位链补 Hostarm64 分支（届时再评估）。
-          - slot: windows-arm64
-            os: windows-latest
-            target: aarch64-pc-windows-msvc
-            build_dir: target/aarch64-pc-windows-msvc/release
-            rustflags: -C target-feature=+crt-static
-          # ↓ 下面四档（Linux x64/arm64、macOS arm64/x64）只**构建取证**、不进本次 Release（从未真构建
-          # 成功过一次、也没在真机跑过）；发哪几个槽位由 release job 的 `PUBLISH_SLOTS` 白名单唯一决定。
-          # Linux：固定 ubuntu-22.04（glibc 2.35 地板）而不是 latest，
-          # 否则产物的 glibc 底线会跟着 runner 漂移（24.04 的 glibc 明显更高）。
-          - slot: linux-x64
-            os: ubuntu-22.04
-            build_dir: target/release
-          # Linux arm64：公开仓库免费的原生 ARM64 runner（4C/16GB，原生构建不交叉）。用 22.04-arm
-          # 而非 24.04 是为了与 x64 同 glibc 地板（2.35），覆盖 Debian 12 / Ubuntu 22.04 arm64 /
-          # Raspberry Pi OS Bookworm（2.36）；该家族标签还有 `ubuntu-24.04-arm` / `ubuntu-26.04-arm`。
-          - slot: linux-arm64
-            os: ubuntu-22.04-arm
-            build_dir: target/release
-          # macOS：latest = arm64；Intel x64 用 macos-15-intel（macos-13 已下线）。
-          - slot: macos-arm64
-            os: macos-latest
-            build_dir: target/release
-          - slot: macos-x64
-            os: macos-15-intel
-            build_dir: target/release
+      matrix: ${{ fromJSON(needs.plan.outputs.matrix) }}
    runs-on: ${{ matrix.os }}
    steps:
      - uses: actions/checkout@v4
@@ -130,11 +135,9 @@ jobs:
            exit 1
          fi

-      # M118（D26）：**Slint 版停发** —— GUI 来源只有 `unlucky-launcher-iced`；`crates/app` 已在根
-      # Cargo.toml 被 `exclude`，不参与任何 workspace 构建（它连 `--manifest-path` 都编不了）。
-      # 对外产物名由 packaging/make_artifacts.py 的 `asset_stem()` 统一生成
-      # `<名字>_<版本号>_<平台>_<架构>`（下划线分段、不带 `iced` 这类实现细节字样）；`LAUNCHER_BIN`
-      # 只用来在构建产物里找文件。
+      # M118（D26）：**Slint 版停发** —— GUI 来源只有 `unlucky-launcher-iced`（`crates/app` 已被根
+      # Cargo.toml `exclude`，不参与任何 workspace 构建）。对外产物名由 make_artifacts.py 的
+      # `asset_stem()` 生成 `<名字>_<版本号>_<平台>_<架构>`；`LAUNCHER_BIN` 只用来在产物里找文件。
      - name: cargo build --release --locked
        shell: bash
        env:
@@ -152,9 +155,8 @@ jobs:
        if: runner.os == 'Windows'
        shell: bash
        env:
-          # 跨槽位的关键点：产物在 target/<triple>/release 而不是 target/release。
-          # M118：校验的是**构建产物**（iced bin 的原始文件名）；对外名 `unlucky-launcher` 由
-          # packaging/make_artifacts.py 在落盘时才换上，那一步之后才存在。
+          # 跨槽位的关键点：产物在 target/<triple>/release；校验的是**构建产物**（iced bin 原始名），
+          # 对外名 `unlucky-launcher` 由 make_artifacts.py 落盘时才换上，那一步之后才存在。
          EXE: ${{ matrix.build_dir }}/unlucky-launcher-iced.exe
        run: |
          set -euo pipefail
@@ -179,8 +181,7 @@ jobs:
            done
          fi
          if [ -z "$DUMPBIN" ]; then
-            # 镜像里的 VS 根形如 <年>/<版次>（2022/Enterprise、2022/BuildTools……），
-            # 固定层数的 glob 会在 <年>/<版次> 这两级踩空，所以按路径模式扫。
+            # VS 根形如 <年>/<版次>（2022/Enterprise、2022/BuildTools……），固定层数的 glob 会踩空，按模式扫。
            for root in "C:/Program Files/Microsoft Visual Studio" \
                        "C:/Program Files (x86)/Microsoft Visual Studio"; do
              [ -d "$root" ] || continue
@@ -263,7 +264,7 @@ jobs:
  release:
    name: GitHub Release
    needs: build
-    # `always()` + `!cancelled()`：白名单外的槽位（Linux/macOS）只是构建取证，它们红了**不能连坐**
+    # `always()` + `!cancelled()`：白名单外的槽位（只有 `all_slots` 取证跑里才存在）红了**不能连坐**
    # Windows 发布。真正拦发布的是下面「发布白名单齐全性」那一步：白名单里少任何一个就 fail。
    if: always() && !cancelled() && github.ref_type == 'tag'
    runs-on: ubuntu-latest
@@ -272,11 +273,11 @@ jobs:
    env:
      # ── 发布白名单：唯一决定「哪几个槽位进 Release」的开关（空格分隔，键同 matrix.slot）──
      # 为什么只有两个 Windows 槽位：Linux x64/arm64、macOS arm64/x64 这四档**从未真构建成功过一次、
-      # 更没在真机上跑过**，未验证的产物不推给用户；它们照跑构建，产物留在本次运行的 `dist-<slot>`
-      # artifact 里取证（可下载验证），不进 Release、不进 SHA256SUMS。
-      # 将来某槽位真机验证通过后「打开」它只改这一行（把槽位键加进列表，如 `macos-arm64`）：齐全性检查
-      # 与 SHA256SUMS 自动跟着扩；同时把 packaging/README.md §1/§9 与 packaging/release-notes.md 的
-      # Downloads / Support matrix 同步成「已发布」——三处不一致即是假话。
+      # 更没在真机上跑过**，未验证的产物不推给用户；它们默认连构建都不跑（M139），只有 `all_slots=true`
+      # 的取证跑里才有产物，留在本次运行的 `dist-<slot>` artifact 里可下载验证，不进 Release/SHA256SUMS。
+      # 将来某槽位真机验证通过后「打开」它需同时改三处（缺一即是假话）：① `plan` 槽位表里把它的 mode
+      # 改成 `ci`；② 把槽位键加进这一行（齐全性检查与 SHA256SUMS 自动跟着扩）；③ packaging/README.md
+      # §1/§9 与 packaging/release-notes.md 的 Downloads / Support matrix。
      PUBLISH_SLOTS: "windows-x64 windows-arm64"
    steps:
      - uses: actions/checkout@v4
@@ -318,6 +319,8 @@ jobs:
          # GUI 与 CLI 两个资产——只按「槽位名出现过」判会被其中一个掩盖。档位比对用下划线形态：
          # 资产名自 D49 起是 `unlucky-launcher_<ver>_windows_x64.exe`，旧写法 `dist/$prefix-*-$slot*`
          # （连字符）对现行命名永远匹配不上，已一并修正。
+          # 矩阵裁到两个槽位（M139）后这条检查依然有效：它比的是**下载下来的产物**，不看矩阵大小 ——
+          # 白名单里的槽位没编（比如忘了改 plan 里的 mode）或编挂了，就在这里因缺产物 fail，不会永远过。
          for slot in $PUBLISH_SLOTS; do
            stem=${slot//-/_}
            for prefix in unlucky-launcher ull; do