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
@@ -25,8 +25,8 @@
 - 归档解压后是**一个顶层目录** `unlucky-launcher-<ver>-<槽位>/`，用户不会解压出一堆散文件。
 - **`ull` 是并列的裸资产，不塞进 tar.gz**：headless 用户要的就是「下一个小文件直接跑」；归档里放
  LICENSE/NOTICE/README.md 是许可义务，而这三份本来就作为并列 Release 资产分发，裸 `ull` 不缺条款。
- `unlucky-launcher` 本体也认全部 CLI 子命令（M82），`ull` 不是第二个界面，而是**不链接图形栈**的
-  同一套命令（差异见 §4 与 §7.4）——两者都不是重复品。
+- `unlucky-launcher` 本体也认全部 CLI 子命令（M82），`ull` 不是第二个界面，而是**不链接图形栈**的同一套命令（差异见 §4 与 §7.4），两者不是重复品。
+  M118：GUI 的**构建产物**名是 `unlucky-launcher-iced`（`crates/app` 已被 workspace `exclude`，不再产出 `unlucky-launcher`）；对外文件名仍是 `unlucky-launcher`，改名在 `make_artifacts.py` 落盘时（`LAUNCHER_BIN` 找产物 / `LAUNCHER_ASSET` 定对外名），所以下载链接 / `SHA256SUMS` / 本文矩阵不变。
 - `<ver>` 不带前导 `v`（tag 是 `v0.1.0`，文件名是 `0.1.0`）——由脚本统一裁剪。
 - UNIX 归档内 `mtime`/`uid`/`gid` 归零、权限固定（二进制 0755、文本 0644），
  同源构建的 sha256 不受打包时刻影响。
@@ -51,7 +51,7 @@
 ### 本地（当前平台）

 ```bash
-cargo build --release --locked                 # 产出 target/release/{unlucky-launcher,ull,unlucky-launcher-iced}
+cargo build --release --locked                 # 产出 target/release/{unlucky-launcher-iced,ull}（M118：Slint 版不再进 workspace）
 cargo build --profile fast --bins              # 只是想快点看到画面/跑测试：快档（§6），产物在 target/fast/
 python packaging/make_artifacts.py --out dist  # 产物落在 dist/，含 SHA256SUMS.txt
 python packaging/make_artifacts.py --version v0.1.0   # 顺带校验版本一致性
@@ -67,7 +67,7 @@ macOS x64），其它组合直接报错退出——不在矩阵里的平台不
 ```bash
 rustup target add aarch64-pc-windows-msvc
 cargo build --release --locked --target aarch64-pc-windows-msvc \
-  --bin unlucky-launcher --bin ull      # 不用 --bins：发布矩阵只发 GUI + ull，iced 不进产物
+  --bin unlucky-launcher-iced --bin ull   # 不用 --bins：矩阵只发 GUI + ull；GUI 的构建产物名是 iced 的 bin（M118）
 python packaging/make_artifacts.py --slot windows-arm64 \
  --build-dir target/aarch64-pc-windows-msvc/release --out dist
 ```
@@ -181,7 +181,7 @@ macOS 产物是**裸二进制**而非 `.app` bundle：符合单文件承诺，

 ## 5. 软渲染兜底（无 GPU / 老驱动 / 远程桌面）

-Slint 默认 `renderer-femtovg`（GL）。两条兜底路径，效果等价，任选其一：
+M118（D26）：以下是**历史实现（Slint 版，默认 `renderer-femtovg`/GL）**的兜底路径，已不在默认构建与发布矩阵内（`crates/app` 被 workspace `exclude`，源码仅作参考、不编译）。现役 GUI 是 iced 版：`unlucky-launcher-iced --software-renderer`（= `ICED_BACKEND=tiny-skia`）走 tiny-skia 光栅化。v0.1.0 的产物仍认下面两条：

 ```bash
 unlucky-launcher --software-renderer                     # 启动参数（本仓库解析后设 SLINT_BACKEND）
@@ -190,9 +190,8 @@ SLINT_BACKEND=winit-software unlucky-launcher            # 环境变量（Slint

 - 参数解析在 `crates/app/src/main.rs` 的 `apply_renderer_flag()`，只认完全相等的 `--software-renderer`。
 - 软渲染是 CPU 光栅化，无 GPU 也能出图；代价是动画与大窗口重绘更慢（Metro 纯色界面影响有限）。
- 验收/无交互桌面场景另有进程内截图通道：`--screenshot <png>`（见 `crates/app/src/screenshot.rs`），
-  它同样能在软渲染下工作，是 CI 与远程机唯一可靠的"真出图"证据。
- 发布冒烟（本机实跑，见 §7）就是用 `--software-renderer --screenshot` 组合证明"无 GPU 也能起来"。
+- 截图通道 `--screenshot <png>`：历史实现 `crates/app/src/screenshot.rs`，现役 `crates/app-iced/src/shot/`；
+  软渲染下照样出图，是 CI 与远程机唯一可靠的"真出图"证据（发布冒烟见 §7，本机实跑 `--software-renderer --screenshot`）。

 ## 6. Cargo 构建档位（release 体积档 / fast 速度档）

@@ -237,14 +236,14 @@ SLINT_BACKEND=winit-software unlucky-launcher            # 环境变量（Slint
 ① **依赖 opt-level 从 3 退回 `"z"` 又快 29.6% 又小 19~24%**（两臂同为 cu16，唯一自变量是 opt-level）——抬 opt-level 是拿编译时间和体积换运行期；
 `cu1 → cu16` 的收益本轮**没有同条件对照**，未归因。② `fast` **冷编译比 `release` 还慢**（24m27s vs 16m01s）、体积 2.3 倍，瓶颈在两个大 UI
 crate + 链接 + 机械盘 IO——定位是 **SSD 机器与增量重编**，不是冷编译加速。体积归因：GUI 相对旧基线 +12.9%（13.92 → 15.72 MiB）里
-「代码增长」与「依赖 cu16」**未分离**；`ull` 只 +1.7%，在 +1~3% 口径内。体积构成：Slint 运行时（双渲染器 + winit/accesskit/托盘）+ rustls/reqwest + rig/rmcp/axum 为主，`ull` 更小是 D18（CLI 零 UI 依赖）的结果。
+「代码增长」与「依赖 cu16」**未分离**；`ull` 只 +1.7%，在 +1~3% 口径内。体积构成（**M118 前的 Slint 版，历史数**）：Slint 运行时（双渲染器 + winit/accesskit/托盘）+ rustls/reqwest + rig/rmcp/axum 为主，`ull` 更小是 D18（CLI 零 UI 依赖）的结果。

 ### 7.2 冒烟（真跑，2026-10-31 夜间 + 11-01 早，本机 Win11 26100）

 | 命令 | 实测结果 |
 |------|---------|
 | `ull.exe --version` | 输出 `ull 0.1.0（unlucky-cli）` + `os: Windows 11 · 10.0.26100（x86_64）· 满足最低要求`，exit 0 —— 版本与 workspace `0.1.0` 一致 |
-| `unlucky-launcher.exe --software-renderer --screenshot … --data-dir …` | exit 0，产出 1180×760 PNG（3,588,298 B）；看图确认 Metro 实例页（侧栏/搜索/空态/AI 助手面板）正常渲染 → **软渲染路径真的能出图**，不依赖 GL |
+| `unlucky-launcher.exe --software-renderer --screenshot … --data-dir …`（Slint 版，历史实测） | exit 0，产出 1180×760 PNG（3,588,298 B）；看图确认 Metro 实例页（侧栏/搜索/空态/AI 助手面板）正常渲染 → **软渲染路径真的能出图**，不依赖 GL |
 | `unlucky-launcher.exe --version` | **无输出**，8 秒后被 timeout 杀掉（exit 124）——GUI 当时不解析 `--version`，会直接开窗口。M82 后已修（走 CLI 分发，见 §10-1）|

 ### 7.3 打包验证（本机 Windows 槽位真跑）
@@ -280,7 +279,7 @@ CI 的 MSVC `+crt-static` 产物同理（静态 CRT）；`release.yml` 里用 `d
 总之不允许"悄悄要用户装可再发行包"。
 注意：本机只装了 GNU 工具链，MSVC 那个槽位的产物本身**没有在本机验证过**，由 CI 首跑验证。

-Linux 侧同一件事的对照（M82 实测：`readelf -d` + `ldd` + `nm -D`，容器内 Debian 12 glibc 2.36）：Slint
+Linux 侧同一件事的对照（M82 实测：`readelf -d` + `ldd` + `nm -D`，容器内 Debian 12 glibc 2.36；被测的是 **Slint 版 GUI，历史实测**）：Slint
 GUI 的 ELF `DT_NEEDED` 只有 `libfontconfig.so.1` / `libgcc_s.so.1` / `libm.so.6` / `libc.so.6` /
 `ld-linux-x86-64.so.2`；`libX11` / `libxcb` / `libxkbcommon` / `libwayland-client` / `libGL` / `libEGL`
 **都不在**导入表里，而是以字符串形式由 `dlopen` 在开窗那一刻加载（`nm -D` 可见 `U dlopen@GLIBC_2.34` /
@@ -318,6 +317,7 @@ merge 后由 tower 重指 tag 重跑流水线，两槽位进 `SHA256SUMS.txt`
  三份文本在 UNIX 归档内、在 Windows 侧作为并列 Release 资产。
 - Slint 的 RF 2.0 义务：关于页保留 `AboutSlint` 部件（已在 UI 内），不得移除；
  选 RF 分支即不触发 GPL 分支义务（见 `deny.toml` 的许可证白名单注释）。
+- **M118 后这条义务只跟着已发布的 `v0.1.0` 资产走**：`crates/app` 已被 workspace `exclude`，发布矩阵里再没有链接 Slint 的二进制，新的 iced 版产物不链接 Slint；`deny.toml` 那条 RF-2.0 allow 因此暂时是死条目（不删，留给将来真有别的路径引入 Slint 时兜底）。
 - `README.md`（英文主版）随包分发；中文版 `README.zh-CN.md` 留在仓库不进包（避免包体噪音）。
 - 依赖许可门禁不变：`deny.toml` 白名单（Apache-2.0 / MIT / BSD / Zlib / BSL-1.0 / ISC / CC0 / Unlicense /
  Unicode-3.0 / CDLA-Permissive-2.0 / Slint-RF-2.0）。发布任务不新增任何依赖。
@@ -54,7 +54,13 @@ import tarfile
 from pathlib import Path
 from typing import NoReturn

-LAUNCHER_BIN = "unlucky-launcher"
+# M118（D26）：GUI 的**构建产物**名是 iced 版的 `unlucky-launcher-iced`。旧值 `unlucky-launcher`
+# 是 `crates/app`（Slint 退役树）的 bin —— 那棵树已被根 Cargo.toml `exclude`，再也不产出它了。
+# **对外**文件名仍叫 `unlucky-launcher`：下载链接 / SHA256SUMS / README 都绑着这个名字，
+# 改名是「翻牌」那一步的事，不是打包这一步的事。所以刻意拆成两个常量：
+# 找文件用 LAUNCHER_BIN，落盘（tar 内文件名 / exe 资产名）用 LAUNCHER_ASSET。
+LAUNCHER_BIN = "unlucky-launcher-iced"
+LAUNCHER_ASSET = "unlucky-launcher"
 CLI_BIN = "ull"
 # 随包分发的合规文本（仓库根目录）；英文主版 README 是对外分发口径。
 COMPLIANCE_DOCS = ("LICENSE", "NOTICE", "README.md")
@@ -216,7 +222,7 @@ def stage_archive(out_dir: Path, tag: str, version: str, launcher: Path) -> Path
    if stage.exists():
        shutil.rmtree(stage)
    stage.mkdir(parents=True)
-    shutil.copy2(launcher, stage / launcher.name)
+    shutil.copy2(launcher, stage / LAUNCHER_ASSET)
    for doc in COMPLIANCE_DOCS:
        source = REPO_ROOT / doc
        if not source.is_file():
@@ -232,7 +238,7 @@ def stage_archive(out_dir: Path, tag: str, version: str, launcher: Path) -> Path
            info.mtime = 0
            info.uid = info.gid = 0
            info.uname = info.gname = ""
-            info.mode = 0o755 if entry.name == launcher.name else 0o644
+            info.mode = 0o755 if entry.name == LAUNCHER_ASSET else 0o644
            with entry.open("rb") as handle:
                tar.addfile(info, handle)
    shutil.rmtree(stage)