chore(workspace): M118 —— crates/app 退出默认构建，发布改打 iced bin（Slint 版停发）

M118（D26）：Slint 退役树 `crates/app` 不再进 workspace。目录与源码原样保留（不删一个文件），只是配置上不再可编。 - 根 Cargo.toml：`[workspace] exclude = ["crates/app"]`。摘掉的是整棵 slint 1.18 + usvg 0.48 依赖树（本机单路冷编 ≈14 分钟；并行超配时表现为 rustc 退 1 且零诊断，见踩坑记录 p2 T7）。 Cargo.lock 由 cargo 自己重算：8639 → 6343 行（-2389/+93），`name = "slint"` 1→0、 `name = "i-slint` 11→0、`name = "slint-build"` 1→0。锁必须一起提交：旧锁配 `--locked` 会直接 `cannot update the lock file`（release.yml 与 ci.yml 的冒烟都带 `--locked`）。 - ci.yml：clippy/test/build 的 `--workspace` 自然不再覆盖 unlucky-app；runtime-smoke（Linux 与 macOS 探针）打的是 Slint 版 `--bin unlucky-launcher`，该 bin 已不存在 → 换成 iced 版 `unlucky-launcher-iced`（它的 cli.rs 照抄 Slint 版口径，`--data-dir` 仍被接受）。 - release.yml：**Slint 版停发**。旧写法 `--bin unlucky-launcher` 打的是 crates/app 的 bin，也就是说流水线一直在发 Slint 版；改为 `--bin unlucky-launcher-iced --bin ull`，Windows 导入表自检的 EXE 指向构建产物 `unlucky-launcher-iced.exe`。对外产物文件名不变。 - make_artifacts.py：拆成 `LAUNCHER_BIN = "unlucky-launcher-iced"`（找产物）与 `LAUNCHER_ASSET = "unlucky-launcher"`（落盘名），tar 内文件名/权限随之按对外名走。 - guards.yml / README（中英）/ packaging/README.md：逐条写明排除后的覆盖口径，历史实现段落全部保留并加限定语（不提供构建方式，也不暗示自救）。门禁：fmt exit 0；clippy --workspace --all-targets -j 4 -- -D warnings exit 0（44.6s）； check --workspace --all-targets exit 0（5m20s，slint 命中 0 行）；cargo deny check exit 0。
2026-11-04 00:09:38 +08:00
1 parent 3f228ae092
commit cf8c6912ec
@@ -3,6 +3,12 @@ name: CI
 # 主干门禁：fmt / clippy / test / build 双平台矩阵。
 # 架构守门（core 零 UI、文件 ≤400 行、依赖许可）见 guards.yml。
 # 平台基线 Win10+（标准工具链产物），平台矩阵见 AGENTS.md §7。
+#
+# M118（D26）：根 Cargo.toml 已 `exclude = ["crates/app"]`（Slint 退役树，源码原样保留）。
+# 所以本文件里所有 `--workspace` 都**不再**覆盖 `unlucky-app`：CI 不再编 slint 1.18 + usvg 0.48
+# 那棵依赖树（本机单路冷编 ≈14 分钟；并行超配时表现为 `rustc` 退 1 且零诊断，
+# 见 DevDocs/00-踩坑记录-p2.md T7）。历史实现只作源码参考，**没有构建方式**（见 README：
+# 它的 manifest 整份是 workspace 继承写法，离开 workspace 后连解析都过不了）。

 on:
  push:
@@ -38,7 +44,7 @@ jobs:
    runs-on: ${{ matrix.os }}
    steps:
      - uses: actions/checkout@v4
-      - name: Linux 图形栈构建依赖（winit / femtovg 编译期需要）
+      - name: Linux 图形栈构建依赖（winit / wgpu 编译期需要）
        if: runner.os == 'Linux'
        run: |
          sudo apt-get update
@@ -49,6 +55,8 @@ jobs:
        with:
          components: clippy
      - uses: Swatinem/rust-cache@v2
+      # `--workspace` 现在是 8 个 crate，不含 `unlucky-app`（M118 的 workspace exclude），
+      # 所以这条命令不会拉起 slint / usvg / i-slint-*。
      - run: cargo clippy --workspace --all-targets -- -D warnings

  test:
@@ -69,6 +77,9 @@ jobs:
            libwayland-dev libxcb1-dev
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
+      # 同 clippy：`--workspace` 不含 `unlucky-app`（M118），Slint 退役树不再被 `--all-targets` 拉起。
+      # 也因此**不要**再写 `--exclude unlucky-app`：它已不是成员，那面旗子只会打一条
+      # `excluded package(s) … not found in workspace` 的警告然后空转（实测 exit 0，不报错）。
      - run: cargo test --workspace --all-targets

  build:
@@ -89,14 +100,19 @@ jobs:
            libwayland-dev libxcb1-dev
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
+      # 同上：`--workspace` 不含 `unlucky-app`（M118）。被摘掉的正是 release 档
+      # （lto=fat + codegen-units=1）最贵的那棵 slint + usvg 树。
      - run: cargo build --workspace --release

  # 运行时冒烟（M62）：Linux 上**真渲染一帧**，补上「能编译 ≠ 能跑」的空白。
  # 上面四个 job 都只证明代码编得过、测得过，从不创建真实图形窗口；本 job 在 Xvfb 虚拟显示里
-  # 启动 GUI 进程，让 Slint 软件渲染器把当前场景渲进内存像素缓冲并编码成 PNG，再对**像素本身**
+  # 启动 GUI 进程，让软件渲染器把当前场景渲进内存像素缓冲并编码成 PNG，再对**像素本身**
  # 断言（不是只看退出码：窗口起来了但一帧空白同样是「退出码 0」）。
  # 诚实边界：证明「Linux 上真能跑出非空白的一帧」，**不**证明视觉正确——视觉靠人眼看 artifact。
-  # 本 job 绑死 Slint Window::take_snapshot；迁 iced 后必须提供等价的离屏截图通道，否则本 job 静默退化成「能起进程」。
+  # M118（D26）：这里原本绑死 Slint 的 `Window::take_snapshot`，打的是 Slint 版 bin
+  # `unlucky-launcher`；`crates/app` 退出 workspace 后那个 bin 不再存在，改用 iced 版
+  # `unlucky-launcher-iced` 自带的 `--screenshot` 通道（`crates/app-iced/src/shot/`）。
+  # 命令行参数刻意不动：iced 的 `cli.rs` 就是照 Slint 版的口径写的，`--data-dir` 也仍被接受（忽略）。
  runtime-smoke:
    name: runtime smoke (ubuntu x64, xvfb)
    runs-on: ubuntu-latest
@@ -116,13 +132,14 @@ jobs:
      - uses: Swatinem/rust-cache@v2
      # 用 debug 而不是 release：本 job 验的是「运行时渲染通路能通」，不是优化后二进制的行为；
      # release 的 lto="fat" + codegen-units=1 会把这一步拖到十几分钟却不带来额外证据。
-      - run: cargo build --bin unlucky-launcher --locked
+      # M118：bin 从 Slint 版 `unlucky-launcher` 换成 iced 版（见上方 job 注释）。
+      - run: cargo build --bin unlucky-launcher-iced --locked
      - name: 在 Xvfb 里跑一帧并截图（退出码非 0 即失败）
        run: |
          set -o pipefail  # 当前没有管道（死行），保留是为将来加管道时先有失败传播
          mkdir -p "$RUNNER_TEMP/smoke/data"
          xvfb-run -a --server-args="-screen 0 1280x1024x24" \
-            target/debug/unlucky-launcher --software-renderer \
+            target/debug/unlucky-launcher-iced --software-renderer \
            --screenshot "$RUNNER_TEMP/smoke/runtime-smoke.png" \
            --data-dir "$RUNNER_TEMP/smoke/data"
      - name: 断言 PNG 存在且非空白（尺寸 / 唯一色数 / 亮度σ / 强边缘占比）
@@ -137,10 +154,11 @@ jobs:

  # macOS 槽位探针（M62）：**默认不在 PR 上跑**，只有手动 dispatch 才触发。
  # 之所以是探针而不是常驻槽位：官方 macOS runner 处于 LaunchDaemon 上下文，没有登录的
-  # WindowServer 会话，Slint 的 winit backend 创建窗口大概率直接失败；而 worker 禁 push，
+  # WindowServer 会话，GUI 的 winit backend 创建窗口大概率直接失败；而 worker 禁 push，
  # 本机也没有 macOS，这条路径**尚无任何实测证据**——不拿未验证的 job 卡住主干门禁。
  # 首跑结论决定去留：绿 → 去掉 if/continue-on-error 升为常驻槽位；红 → 按 D26 归入 iced
  # 重写后再规划，并把错误原文贴进 progress 文档（不静默删 job、不吞失败原因）。
+  # M118：bin 与 Linux 那条一样，从 Slint 版换成 iced 版（`unlucky-launcher-iced`）。
  runtime-smoke-macos:
    name: runtime smoke (macos arm64, probe)
    if: github.event_name == 'workflow_dispatch'
@@ -153,12 +171,12 @@ jobs:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
-      - run: cargo build --bin unlucky-launcher --locked
+      - run: cargo build --bin unlucky-launcher-iced --locked
      - name: 尝试截图（macOS 没有 X 服务器，直接跑；失败即为结论）
        run: |
          set -o pipefail  # 当前没有管道（死行），保留是为将来加管道时先有失败传播
          mkdir -p "$RUNNER_TEMP/smoke/data"
-          target/debug/unlucky-launcher --software-renderer \
+          target/debug/unlucky-launcher-iced --software-renderer \
            --screenshot "$RUNNER_TEMP/smoke/runtime-smoke.png" \
            --data-dir "$RUNNER_TEMP/smoke/data"
      - name: 断言 PNG 存在且非空白
@@ -7,6 +7,16 @@ name: Guards
 #   4. file-size       —— 全仓代码/文档单文件 ≤400 行（用户硬约束）
 #   5. licenses        —— cargo-deny：许可证白名单 + GPL 依赖拦截 + 供应链来源校验
 #   6. unsafe-scope    —— 全仓 `allow(unsafe_code)` 的文件集合必须恰好只有一个（D36 / M91）
+#
+# M118（D26）：根 Cargo.toml 已 `exclude = ["crates/app"]`（Slint 退役树）。逐条核对过本文件，
+# **没有**任何一条守卫以 `--workspace` 为前提，所以排除不会让它们空转：
+#   ① core-no-ui / presenter-no-ui / design-zero-dep —— 「manifest 文本 + `cargo tree -p <crate>`」
+#      口径，被守的 crate 仍是 workspace 成员，依赖树与排除前逐行一致；
+#   ② file-size / unsafe-scope —— 走 `git ls-files` / `git grep`，与构建图无关，**仍然覆盖
+#      `crates/app/**`**（源码还在仓库里，就还得守它的行数与 unsafe 落点）；
+#   ③ licenses —— 唯一走 workspace 依赖图的守卫。排除后 Slint 那棵树不再进图（实测 `cargo deny
+#      list` 里 `slint*` / `i-slint-*` 为 0 个），这与「不再随任何产物发布」一致；代价是它的许可证
+#      不再被本门禁审 —— 真要重新纳入发布，得先把它加回 workspace，门禁随之恢复。

 on:
  push:
@@ -48,6 +58,9 @@ jobs:

  # presenter 是 Slint 版（crates/app）与 iced 版（crates/app-iced）共用的唯一业务层（D26）。
  # 一旦 slint/iced/winit 被拉进来，分层就废了，而编译与单测仍会全绿 —— 所以必须由 CI 守。
+  # M118 之后 Slint 版已被 workspace `exclude`，但本条**照样守得住**：它查的是 presenter 自己的
+  # manifest 与 `cargo tree -p unlucky-presenter`，与「谁在消费 presenter」无关；依赖树里一旦出现
+  # slint/iced/winit 仍会当场红。名单里的 slint 继续留着，就是为了防「把 UI 依赖偷偷塞进宿主层」。
  # 与 core-no-ui 同样是「依赖表 + cargo tree」双查，名单保持一致；脚本刻意复制而非抽公共脚本，
  # 理由是 CI 守门脚本自身挂掉的排查成本远高于这几行重复。
  presenter-no-ui:
@@ -356,4 +369,9 @@ jobs:
      - uses: EmbarkStudios/cargo-deny-action@v2
        with:
          # 只跑许可/禁用/来源三类，advisories 由后续安全轮次单独接管
+          # M118：cargo-deny 走 **workspace 依赖图**，`crates/app` 被 exclude 后 Slint 那棵树不再进图
+          # （实测 `cargo deny list` 里 `slint*` / `i-slint-*` 命中 0 个），所以本门禁不再审 Slint 的
+          # RF-2.0 许可 —— 与「它不再随任何产物发布」一致。这不是回退：`deny.toml` 里为 Slint 留的
+          # allow 条目**故意没删**（删它得先确认没有别的路径重新引入），当前等于一条死条目。
+          # 若将来把 `crates/app` 加回 workspace，本门禁的覆盖会自动恢复。
          command: check licenses bans sources
@@ -132,6 +132,13 @@ jobs:
            exit 1
          fi

+      # M118（D26）：**Slint 版停发**。旧写法 `--bin unlucky-launcher` 打的是 `crates/app`
+      # （Slint 退役树）的 bin —— 也就是说这条流水线一直在发 Slint 版二进制，而 D26 早已把
+      # iced 定为产品 UI。现在 GUI 来源只有 `unlucky-launcher-iced`；`crates/app` 也已在根
+      # Cargo.toml 被 `exclude`，不参与任何 workspace 构建（它连 `--manifest-path` 都编不了）。
+      # 对外产物文件名**不变**（`unlucky-launcher-<ver>-<slot>.*`）：改名发生在
+      # `packaging/make_artifacts.py` 内部（`LAUNCHER_BIN` 找 iced 产物、落盘用对外名），
+      # 下载链接 / SHA256SUMS / README 都不用跟着漂。
      - name: cargo build --release --locked
        shell: bash
        env:
@@ -143,14 +150,16 @@ jobs:
          if [ -n "$TARGET" ]; then
            target_args+=(--target "$TARGET")
          fi
-          cargo build --release --locked "${target_args[@]}" --bin unlucky-launcher --bin ull
+          cargo build --release --locked "${target_args[@]}" --bin unlucky-launcher-iced --bin ull

      - name: Windows 单文件自检（导入表不得出现 VC++ 可再发行 DLL）
        if: runner.os == 'Windows'
        shell: bash
        env:
          # 跨槽位的关键点：产物在 target/<triple>/release 而不是 target/release。
-          EXE: ${{ matrix.build_dir }}/unlucky-launcher.exe
+          # M118：校验的是**构建产物**（iced bin 的原始文件名）。对外名 `unlucky-launcher`
+          # 由 packaging/make_artifacts.py 在落盘时才换上，那一步之后才存在。
+          EXE: ${{ matrix.build_dir }}/unlucky-launcher-iced.exe
        run: |
          set -euo pipefail
          # +crt-static 是否真的生效，只看导入表：出现 VCRUNTIME/MSVCP/msvcr/ucrtbase 说明还得装