feat(app-iced,pages): M100 取证密闭 + harness 参数拆分 + 设置页测试按 section 下放

四件前置事，都是为了设置页正文四条 section 线能并行（不写任何 section 正文）： 1. 取证密闭（两条通道各有各的机制，证据分开算） - 产品 bin：`cli::ForcedState` 加 `Rest`（静息态），给了 `--screenshot` 且没显式 `--force-state` 时默认 `Some(Rest)`；交互模式仍是 `None`（`shell::overridden` 与 `app/view.rs` 的 `model()` 各补一支）。 - harness：截图窗口开 `window::enable_mouse_passthrough`（winit 的 `set_cursor_hittest(false)`）⇒ 窗口收不到指针事件 ⇒ 全树控件恒为 Active。为什么用通道级而不是逐控件灌 forced：设置页「外观」区的滑块/文本框/裸 button 都不消费 forced，逐控件做要改十几个组件文件，而新产品组件随时会漏。 - harness 同时数指针事件并打进日志（`指针事件=N`）：让「这张图见过几个鼠标事件」变成可读数字，替代「连跑几次 hash 一样」那种恒真的假绿。 2. harness 的外观真状态入口：`--appearance=real` 让设置页走 `appearance: Some(..)` （工厂态 + `ULL_APPEARANCE_*`），新入口 `pages::app_with_appearance`。 `--screen=settings` 之前就有了，但 `appearance` 恒为 None，D30 要的那一屏根本不存在。 3. `pages/harness.rs` 400 行 → 拆 `pages/harness/request.rs`（`#[path]` 范式），纯搬移部分 240 行 + 新增密闭代码。拆分等价性：同一 argv 的 PNG sha256 与拆分前一致。 4. `pages/settings/tests.rs` 按 section 下放成 `tests/{general,appearance,java,download}_section.rs`， mod 层只留跨 section 断言（每条写清守什么、为什么不能下放）。给某组加一条新断言 = 只改它自己那个文件。顺带：`shell/mod.rs` 在 HEAD 就 399 行、`cli.rs` 394 行，两处都按同一范式把 tests 搬成 `shell/tests.rs` / `cli/tests.rs`（断言一字不动，逐字节可 diff）。变异验证：把四处实现各改坏一处（默认 Rest、passthrough 默认值、overridden 的 Rest 分支、 view 的 Rest 映射），对应 4 条断言全红（390 passed / 4 failed），恢复后 394 passed。
2026-11-03 14:22:40 +08:00
1 parent 2ad808d55c
commit 2061296615
@@ -14,7 +14,7 @@
 //! | `--screen` | `shell`/`gallery` | 启动画面；**`gallery` = 组件库视觉验收 harness**（D39 §5） |
 //! | `--scale-factor` | `>0` | 强制缩放因子（验收要 100%，即 `1`） |
 //! | `--diff` / `--diff-scan` | 两个路径 / 非负整数 | 逐像素对比（不开窗）与 ±n px 平移扫描 |
-//! | `--force-state` | `hover`/`pressed` | 把整屏可交互控件强制成某态（取证） |
+//! | `--force-state` | `rest`/`hover`/`pressed` | 把整屏可交互控件强制成某态（取证）；**给了 `--screenshot` 就默认 `rest`** |
 //! | `--data-dir` | 路径 | 翻牌兼容：**接受并忽略**（CI 冒烟在用） |
 //!
 //! **截图主题默认 Light（门禁依赖，不许改回 None）**，理由与不变量见
@@ -110,6 +110,13 @@ pub struct Options {
 /// 五态完整矩阵由 `--screen=gallery` 的 `Button::state(..)` 出，本开关只给整屏取证。
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub enum ForcedState {
+    /// **常态**（静息）：压掉系统光标带来的 hover/pressed。
+    ///
+    /// 截图通道（给了 `--screenshot`）**默认就是它**，理由是实测：M99 复审在同一个 exe 上连跑 8 次，
+    /// 第 6 次给出第三个 hash，差异区是某个按钮被画成 `Hovered`——因为 harness/产品都开真窗口，
+    /// `button::Status` 由系统光标位置决定。取证图不能因为「指针恰好压在某个按钮上」而变色。
+    /// 显式 `--force-state=hover|pressed` 仍然优先（那是**故意**要画那个态）。
+    Rest,
    /// 所有可交互控件按 hover 画。
    Hover,
    /// 所有可交互控件按 pressed 画。
@@ -189,11 +196,12 @@ impl Options {
                "--force-state" => {
                    let raw = take(&mut args, inline, "--force-state")?;
                    options.force_state = Some(match raw.as_str() {
+                        "rest" => ForcedState::Rest,
                        "hover" => ForcedState::Hover,
                        "pressed" => ForcedState::Pressed,
                        other => {
                            return Err(format!(
-                                "--force-state 只认 hover|pressed，收到 {other:?}"
+                                "--force-state 只认 rest|hover|pressed，收到 {other:?}"
                            ));
                        }
                    });
@@ -216,6 +224,12 @@ impl Options {
            }
        }

+        // **截图通道默认强制 `Rest`**（M100）：取证图不许跟着系统指针的位置变。
+        // 交互模式保持 `None`——那是用户的真窗口，不许替用户把状态钉死（钉死了就永远看不到 hover）。
+        if options.screenshot.is_some() && options.force_state.is_none() {
+            options.force_state = Some(ForcedState::Rest);
+        }
+
        Ok(options)
    }

@@ -264,131 +278,5 @@ fn flavor(raw: &str) -> Result<SchemeFlavor, String> {
 }

 #[cfg(test)]
-mod tests {
-    use super::*;
-
-    fn parse(args: &[&str]) -> Result<Options, String> {
-        Options::parse(args.iter().map(|arg| (*arg).to_owned()))
-    }
-
-    #[test]
-    fn defaults_are_auto_system_theme_and_shell() {
-        let options = parse(&[]).expect("空参数要能解析");
-        assert_eq!(options.backend, Backend::Auto);
-        assert_eq!((options.theme, options.screenshot), (None, None));
-        assert_eq!(options.screen, Screen::Shell);
-    }
-
-    #[test]
-    fn software_renderer_is_an_alias_of_cpu() {
-        assert_eq!(
-            parse(&["--software-renderer"]).unwrap().backend,
-            Backend::Cpu
-        );
-        assert_eq!(parse(&["--renderer=cpu"]).unwrap().backend, Backend::Cpu);
-        assert_eq!(parse(&["--renderer", "gpu"]).unwrap().backend, Backend::Gpu);
-    }
-
-    #[test]
-    fn both_argv_forms_are_accepted() {
-        let spaced = parse(&["--screenshot", "out.png"]).unwrap();
-        let inline = parse(&["--screenshot=out.png"]).unwrap();
-        assert_eq!(spaced.screenshot, Some(PathBuf::from("out.png")));
-        assert_eq!(spaced.screenshot, inline.screenshot);
-        assert_eq!(
-            parse(&["--diff", "a.png", "b.png"]).unwrap().diff,
-            Some((PathBuf::from("a.png"), PathBuf::from("b.png")))
-        );
-        assert_eq!(
-            parse(&["--screen", "gallery"]).unwrap().screen,
-            Screen::Gallery
-        );
-        assert_eq!(parse(&["--diff-scan=2"]).unwrap().diff_scan, 2);
-        assert_eq!(
-            parse(&["--force-state", "hover"]).unwrap().force_state,
-            Some(ForcedState::Hover)
-        );
-    }
-
-    #[test]
-    fn screenshot_theme_wins_over_theme() {
-        let o = parse(&["--theme=dark", "--screenshot-theme=light"]).unwrap();
-        assert_eq!(
-            (o.theme, o.shot_flavor()),
-            (Some(SchemeFlavor::Dark), Some(SchemeFlavor::Light))
-        );
-    }
-
-    #[test]
-    fn bad_values_are_reported_not_panicked() {
-        for args in [
-            &["--renderer=metal"][..],
-            &["--theme=blue"],
-            &["--scale-factor=0"],
-            &["--scale-factor=abc"],
-            &["--screenshot"],
-            &["--diff", "only-one.png"],
-            &["--screen=settings"],
-            &["--force-state=focus"],
-            &["--diff-scan=-1"],
-            &["--nope"],
-        ] {
-            assert!(parse(args).is_err(), "{args:?} 应该报错");
-        }
-    }
-
-    #[test]
-    fn data_dir_is_accepted_and_ignored_for_the_flip() {
-        // 现役 CI 冒烟：--software-renderer --screenshot <png> --data-dir <dir>
-        let options = parse(&[
-            "--software-renderer",
-            "--screenshot",
-            "shot.png",
-            "--data-dir",
-            "/d/tmp/x",
-        ])
-        .expect("翻牌前必须兼容 --data-dir");
-        assert_eq!(options.backend, Backend::Cpu);
-        assert_eq!(options.screenshot, Some(PathBuf::from("shot.png")));
-        assert_eq!(options.data_dir, Some(PathBuf::from("/d/tmp/x")));
-    }
-
-    /// **门禁依赖**：CI 的 runtime-smoke 不带主题，截图模式必须有确定主题。
-    /// 退化成 `None` 的话，xvfb 里的 runner 会挂到超时（不是红，更难查）。
-    #[test]
-    fn screenshot_without_theme_defaults_to_light() {
-        let options = parse(&["--screenshot", "out.png"]).unwrap();
-        assert_eq!(options.shot_flavor(), None, "用户没给主题");
-        assert_eq!(
-            options.capture_flavor(),
-            Some(SchemeFlavor::Light),
-            "截图模式必须给确定主题（CI 冒烟依赖这条）"
-        );
-        assert!(!options.wants_system_theme(), "截图模式不许等系统主题");
-    }
-
-    #[test]
-    fn explicit_themes_still_win_in_screenshot_mode() {
-        let dark = parse(&["--screenshot", "a.png", "--theme=dark"]).unwrap();
-        assert_eq!(dark.capture_flavor(), Some(SchemeFlavor::Dark));
-
-        let both = parse(&[
-            "--screenshot",
-            "a.png",
-            "--theme=dark",
-            "--screenshot-theme=light",
-        ]);
-        assert_eq!(both.unwrap().capture_flavor(), Some(SchemeFlavor::Light));
-    }
-
-    #[test]
-    fn interactive_mode_still_follows_the_system_theme() {
-        let interactive = parse(&[]).unwrap();
-        assert_eq!(interactive.capture_flavor(), None);
-        assert!(interactive.wants_system_theme(), "交互模式等系统主题");
-
-        let pinned = parse(&["--theme=dark"]).unwrap();
-        assert_eq!(pinned.capture_flavor(), Some(SchemeFlavor::Dark));
-        assert!(!pinned.wants_system_theme());
-    }
-}
+#[path = "cli/tests.rs"]
+mod tests;