fix(ci)+test(packaging): 接线自检不再给假安全证书：19 条变异重放全红，dev 线接上

r1 复审 P1-1：上一版自检对外宣称「不可能被改成总是绿」，实测 19 条变异漏 11 条（最要命的是把 `available` 写成恒 false —— 门禁永久关闭而每次运行都绿）。根因是三条判据只是字符串存在性检查、自测步与自检步被整条豁免、`is True` 挡不住 `'true'`。 `packaging/tests/gpu_shot_ci_selftest.py` 重写为 6 条判据： ① 五步按 `id:` 必须在场且无条件（`vectors`/`exitcodes`/`wiring`/`detect`/`judge`， `exitcodes` 还得真断言 `expect 0/1/2`）； ② 解析 `if:` 表达式后**求值**判「判定挂门」（`available` 取 `'true'`/`'false'`/`''` 必须真/假/假，认不出一律红）—— `|| always()` 这类文本层面的门现在真红了； ③ 两种调用形态都必须在场且产物来自 `needs.probe.outputs.*`； ④ 跳过路径**实跑 7 种输入**（新增 `packaging/tests/gpu_shot_ci_probe.py`），断言 `$GITHUB_OUTPUT` 的 `available`、summary 文案、`::warning::` 与三条红线的 exit≠0； ⑤ `continue-on-error` 按 YAML 布尔语义判（`'true'` / `${{ true }}` 也算开启）； ⑥ 扫所有 `python`+`packaging/` 的 `run`（自测步、自检步都在内），`|| true` / `; true` / `|| exit 0` / 裸 `exit 0` 全算吞。变异向量搬到 `packaging/tests/gpu_shot_ci_vectors.json`：21 条，按解析后的结构注入。 P2-1：`gpu-evidence.yml` 加 `workflow_call:`，`dev-guards.yml` 里 `uses:` 同一份 —— 直推 dev 时 selftest 那一半现在会跑（evidence 在 dev 上照样显式跳过）。 P2-2：跳过摘要与 `gpu-evidence.md §8` 改成唯一可行的补救路径（把产物提交进被 dispatch 的 ref，`git add -f`），并写明「就地拷文件在 CI 上做不到」。措辞：三处「不可能被改成总是绿」改成能复跑的覆盖面 + 边界。
2026-11-11 18:08:31 +08:00
1 parent 075769c6d2
commit 2e9702790d
@@ -9,13 +9,14 @@ name: GPU evidence
 #
 # 口径（塔定，M253 Context 原文）：**CI runner 无 GPU 时必须显式 skip 并写明原因，不得静默 pass**。
 # 落到这份文件的三条硬规矩 —— 它们由 `packaging/tests/gpu_shot_ci_selftest.py` 机器校验
-# （带变异向量），不是靠这几行注释自律：
+# （21 条「改绿」变异逐条重放），不是靠这几行注释自律；那份脚本的 docstring 写清它**保证什么、
+# 保证不了什么**（r1 复审实测：上一版 19 条变异漏 11 条，所以这里不敢再写「不可能」）：
 #   ① `selftest` job **无条件**跑 `--self-test`：它证明「尺子合格」，不需要 GPU、也不需要真产物；
 #      同一 job 再用真 CLI 走一遍三个退出码（0 过 / 1 判据不过 / 2 用法错）。
 #   ② 真实产物判据只在 `probe` job 探到**工作区里真有可用产物**时才跑。
 #   ③ **跳过与通过分开写**：跳过的做法是让 `evidence` job 的 `if:` 不成立 —— 它在 Actions 里显示
 #      **灰色 skipped**，不是一个绿色的 ✓；同时 `probe` 在 job summary 里写明缺什么、为什么，
-#      并打 `::warning::` 说明「本次没有判过任何真实产物」。`evidence` 永远不会在没判过时给绿。
+#      并打 `::warning::` 说明「本次没有判过任何真实产物」。
 #
 # 判据本身（六条 + `--expect-refuse` 三条）与能证/不能证：`packaging/docs/gpu-evidence.md`。
 # 改这份文件先跑 `python3 packaging/tests/gpu_shot_ci_selftest.py`。
@@ -38,6 +39,12 @@ on:
        description: '按负例口径判（--expect-refuse：要求 via=refuse 且一张图都没出）'
        type: boolean
        default: false
+  # 日常线 `dev` 复用**同一份**判据与接线（r1 P2-1）：`dev-guards.yml` 里
+  # `uses: ./.github/workflows/gpu-evidence.yml`。理由与 guards.yml 的 `workflow_call:` 逐字相同：
+  # 判据只能有一份，两份各自演进迟早出现「dev 绿、main 红」的双真相；而 `dev-guards.yml` 文件头
+  # 自己写着「空跑的门禁等于没有」。dev 上 `evidence` 照样显式跳过（无 GPU、无产物），所以 dev 拿到的
+  # 是 `selftest` 那一半：19 条向量 + 三个退出码 + 接线自检，成本就是一次 python 自测。
+  workflow_call:

 jobs:
  selftest:
@@ -46,10 +53,12 @@ jobs:
    steps:
      - uses: actions/checkout@v4
      - name: 判据实现自测（19 条向量，数据在 packaging/tests/gpu_shot_vectors.json）
+        id: vectors
        run: python3 packaging/check_gpu_shot.py --self-test
      # 自测走的是判据**函数**，退出码是 `main()` 的那一行。这里用真 CLI 把三个码都走一遍：
      # 少了这一步，「退出码永远 0」这种回归在 CI 上照样全绿（门禁自己变成假绿）。
      - name: 退出码语义（0 过 / 1 判据不过 / 2 用法错）
+        id: exitcodes
        run: |
          set -uo pipefail
          work="$RUNNER_TEMP/gpu-shot-exitcodes"
@@ -85,7 +94,8 @@ jobs:
            python3 packaging/check_gpu_shot.py "$work/red.stderr.log" "$work/pass.png"
          expect 2 "用法错（一个位置参数都没给）" \
            python3 packaging/check_gpu_shot.py
-      - name: 接线自检（本 workflow 不许被改成「总是绿」）
+      - name: 接线自检（21 条「改绿」变异必须重放为红；覆盖边界见脚本 docstring）
+        id: wiring
        run: python3 packaging/tests/gpu_shot_ci_selftest.py

  probe:
@@ -181,21 +191,27 @@ jobs:
              echo "- 结论：**⏭ 跳过（未验证）** —— ${reason}"
              echo "- 「这张图真是 GPU 档出的」这件事，**本次没有判过**；跳过不等于通过。"
              echo "- 已经验过的是尺子本身：\`--self-test\`（19 条向量）与三个退出码 0/1/2（\`selftest\` job）。"
-              echo "- 想让它变成真判定：\`workflow_dispatch\` 填 \`shot_log\` / \`shot_png\`，"
-              echo "  或在有 GPU 的机器上取证后放到 \`${default_dir}/${default_stem}.stderr.log\` + \`${default_dir}/${default_stem}.png\`。"
+              echo "- 想让它变成真判定，只有两条**在这个 CI 运行里真能执行**的路："
+              echo "  ① \`workflow_dispatch\` 填 \`shot_log\` / \`shot_png\`，且两个文件必须**已被 checkout 下来**"
+              echo "     —— checkout 只拿已跟踪文件，所以产物得先提交进被 dispatch 的那个 ref；"
+              echo "  ② 把一对产物提交到 \`${default_dir}/${default_stem}.stderr.log\` + \`${default_dir}/${default_stem}.png\`"
+              echo "     再对那个 ref 跑一次（\`${default_dir}\` 在 .gitignore 里，要用 \`git add -f\`；"
+              echo "     或改放到任一已跟踪目录，用 ① 的输入指过去）。"
+              echo "  就地往 workspace 里拷文件（不提交）在 CI 上做不到：那次运行 checkout 的树里没有 DevDocs/。"
            fi
          } >> "$GITHUB_STEP_SUMMARY"

  evidence:
    name: GPU 证据 — 真实产物判据
    needs: [selftest, probe]
-    # 第 ③ 条规矩就在这一行：没有可用产物 ⇒ 整个 job 不运行（UI 显示 skipped），
-    # 所以它在「没判过」的情况下不可能显示成一个绿色的 ✓。
+    # 第 ③ 条规矩就在这一行：没有可用产物 ⇒ 整个 job 不运行，UI 上是灰色 skipped，
+    # 不是一个绿色 ✓。这正是「跳过」与「通过」分开写的地方（r1 复审实核过这条 if 的语义）。
    if: needs.probe.outputs.available == 'true'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 判定（0 过 / 1 判据不过 / 2 用法错；退出码即结论，不许被 || true 吞掉）
+        id: judge
        env:
          LOG: ${{ needs.probe.outputs.log }}
          PNG: ${{ needs.probe.outputs.png }}