AskaEth
7b80b0e314
pages::Model.forced 此前只到得了外壳 + 实例页（唯一消费者 pages/instances.rs:159）， 设置页「外观」区的滑块/文本框/裸 iced::button 全都不消费它 ⇒ M284 那四处状态层 （语言档 / 主题档 / 日志 action_button / 外观 choice）只有单测证据，做不出像素判据。 改动： - settings/mod.rs: resolve_state(forced, status) 与 forced_button(button, forced) 成为全仓唯一两个「forced 怎么解释」的点；view → form → section_columns 一路 新增 forced 形参（默认 None ⇒ 今天的行为逐字节不变）。 - Group.body（registry.rs）加第 4 个形参 Option<Interaction>，六组统一签名。 - 四类裸 iced::button 控件把 forced 递进样式闭包并经 resolve_state 落地： 语言档 chip（general/language.rs）、主题档 chip（general/theme.rs）、 日志 action_button（logs_row.rs）、外观 choice（appearance/section/mod.rs， 含 accent/window/bg_image/colour_source 共 10 处调用）。 - components::buttons::Button 的三组（update / ai / java）走 forced_button 的 .state()。 - harness: request.rs 解析 --force-state=rest|hover|pressed（未知值报错，词与产品 cli.rs 同一套），slug 加 -hover/-pressed；app.rs 把它写进 model.forced， 截图通道默认 Rest 的纪律保持（显式值优先）。 - pages/mod.rs: 唯一调用点把 model.forced 传给 settings::view（397 → 399 行）。 单测：resolve_state 的 Some 覆盖 / None 退回；forced_button 的 Some 钉态 / None 原样。
269 lines
12 KiB
Rust
269 lines
12 KiB
Rust
//! harness 的**参数解析**（M100 从 `harness.rs` 搬出来：那边正好 400 行、零余量）。
|
||
//!
|
||
//! 搬移**不改行为**：同一份 argv 方言、同一份 slug、同一句报错。等价性判据是「同一 argv 出的 PNG
|
||
//! sha256 与拆分前一致」（M100 报告里有实测）。
|
||
//!
|
||
//! 参数方言与 `crates/app-iced/src/cli.rs` 同源（`--key value` 与 `--key=value` 都认），但**刻意不共用
|
||
//! 那个 parser**：harness 是取证通道，默认值与产品启动不同（`--screenshot` 默认开**指针穿透**，见
|
||
//! [`Request::passthrough`]）。产品 bin 的密闭手段是另一套（`cli::ForcedState::Rest`）——两条通道的
|
||
//! 证据分开算，别互相冒充。
|
||
|
||
use std::path::PathBuf;
|
||
|
||
use unlucky_design::color::SchemeFlavor;
|
||
|
||
use crate::app::components::interaction::Interaction;
|
||
use crate::cli::Backend;
|
||
use crate::pages::{layout::WidthClass, Screen};
|
||
|
||
/// 验收窗口尺寸（D30：1180×760、100% DPI）。
|
||
const DEFAULT_SIZE: (f32, f32) = (1180.0, 760.0);
|
||
|
||
/// 取证窗口的落点请求值（`--screenshot` 时才用）。
|
||
///
|
||
/// 为什么要固定：密闭验证要把系统指针放进窗口里某个点（**故意压在控件上**），窗口位置每次都飘的话，
|
||
/// 「指针到底在不在窗口里」就变成了猜——那正是 U1 的形状。真实矩形由 harness 用
|
||
/// `window::position` / `window::size` 的**返回值**打日志报出，脚本按日志放指针，不以这个常量为准
|
||
/// （它只是请求值）。
|
||
pub const CAPTURE_POSITION: (f32, f32) = (80.0, 80.0);
|
||
|
||
/// 一次渲染请求。
|
||
#[derive(Debug, Clone, PartialEq)]
|
||
pub struct Request {
|
||
/// 渲染哪一页。
|
||
pub screen: Screen,
|
||
/// 窗口宽度（**含外壳**：布局档位就是按它判的）。
|
||
pub width: f32,
|
||
/// 窗口高度。
|
||
pub height: f32,
|
||
/// 主题（`--screenshot-theme` > `--theme` > 浅色）。
|
||
pub flavor: SchemeFlavor,
|
||
/// 出图路径（`None` = 只开窗）。
|
||
pub screenshot: Option<PathBuf>,
|
||
/// 渲染后端请求。
|
||
pub backend: Backend,
|
||
/// 强制缩放因子（截图要 100% DPI）。
|
||
pub scale_factor: Option<f32>,
|
||
/// 设置页正文画**真控件**（`appearance: Some(..)`）还是演示行（`--appearance=real|demo`）。
|
||
///
|
||
/// 只对 `--screen=settings` 有意义：别的页没有外观分组，静默接受会造出「以为接了线」的假图（U1）。
|
||
pub real_appearance: bool,
|
||
/// 强制交互态（`--force-state=rest|hover|pressed`）：`Some` 时**控件按那一态画**（M285）。
|
||
///
|
||
/// 为什么这个开关在本文件而不在产品 bin：产品 bin 的 `--screen` 只认 `shell|gallery`，设置页 /
|
||
/// 外观区只能走本 harness 出图（`examples/pages_demo.rs`）。M282 / M284 各自撞过一次——
|
||
/// `pages::Model.forced` 到不了设置页，于是「hover 与 pressed 必须不同」这条判据**做不出像素证据**，
|
||
/// 只能降级成单测。接上之后两条态各自一张图。
|
||
///
|
||
/// 词与语义与产品的 `cli::ForcedState` 一致（`rest|hover|pressed`），但**刻意不共用那个 enum**：
|
||
/// 产品那条通道的默认值与守卫（`--screenshot` 恒钉 `Rest`）是另一套，把两者拧在一起会让
|
||
/// 「取证通道的默认值」和「产品窗口的默认值」互相污染。这里存的是下游形状 [`Interaction`]，
|
||
/// 落点是 `pages::Model.forced`（`harness/app.rs`）。
|
||
pub force_state: Option<Interaction>,
|
||
/// 截图窗口开**指针穿透**（`window::enable_mouse_passthrough` ⇒ winit `set_cursor_hittest(false)`）。
|
||
///
|
||
/// 默认：给了 `--screenshot` 就开；**交互模式（没有截图）一律关**——交互窗口收不到鼠标是产品事故，
|
||
/// 所以 `--passthrough` 在交互模式下直接报错，不留「配一下就行」的口子。
|
||
///
|
||
/// `--passthrough=off` 只服务一件事：对照实验——证明「不开穿透时，同一指针位置会把 hover 漏进图」。
|
||
/// 没有这个反向证据的话，「穿透开着时 hash 不变」既可能是真密闭，也可能只是指针压根没进窗口。
|
||
pub passthrough: bool,
|
||
}
|
||
|
||
impl Default for Request {
|
||
fn default() -> Self {
|
||
Self {
|
||
screen: Screen::Instances,
|
||
width: DEFAULT_SIZE.0,
|
||
height: DEFAULT_SIZE.1,
|
||
flavor: SchemeFlavor::Light,
|
||
screenshot: None,
|
||
backend: Backend::Auto,
|
||
scale_factor: None,
|
||
real_appearance: false,
|
||
force_state: None,
|
||
passthrough: false,
|
||
}
|
||
}
|
||
}
|
||
|
||
impl Request {
|
||
/// 从进程参数解析（`argv[1..]`）。未知参数 / 缺值 / 数字非法时返回人话。
|
||
pub fn parse(args: impl IntoIterator<Item = String>) -> Result<Self, String> {
|
||
let mut request = Self::default();
|
||
let mut theme: Option<SchemeFlavor> = None;
|
||
let mut shot_theme: Option<SchemeFlavor> = None;
|
||
let mut passthrough: Option<bool> = None;
|
||
let mut args = args.into_iter();
|
||
|
||
while let Some(arg) = args.next() {
|
||
let (key, inline) = match arg.split_once('=') {
|
||
Some((key, value)) => (key.to_owned(), Some(value.to_owned())),
|
||
None => (arg.clone(), None),
|
||
};
|
||
|
||
match key.as_str() {
|
||
"--screen" => {
|
||
let raw = take(&mut args, inline, "--screen")?;
|
||
request.screen = Screen::from_slug(&raw).ok_or_else(|| {
|
||
format!("--screen 只认 instances|download|settings|logs，收到 {raw:?}")
|
||
})?;
|
||
}
|
||
"--width" => {
|
||
request.width = number(&take(&mut args, inline, "--width")?, "--width")?
|
||
}
|
||
"--height" => {
|
||
request.height = number(&take(&mut args, inline, "--height")?, "--height")?;
|
||
}
|
||
"--theme" => theme = Some(flavor(&take(&mut args, inline, "--theme")?)?),
|
||
"--screenshot-theme" => {
|
||
shot_theme = Some(flavor(&take(&mut args, inline, "--screenshot-theme")?)?);
|
||
}
|
||
"--screenshot" => {
|
||
request.screenshot =
|
||
Some(PathBuf::from(take(&mut args, inline, "--screenshot")?));
|
||
}
|
||
"--software-renderer" => request.backend = Backend::Cpu,
|
||
"--renderer" => {
|
||
request.backend = match take(&mut args, inline, "--renderer")?.as_str() {
|
||
"auto" => Backend::Auto,
|
||
"gpu" => Backend::Gpu,
|
||
"cpu" => Backend::Cpu,
|
||
other => {
|
||
return Err(format!("--renderer 只认 auto|gpu|cpu，收到 {other:?}"))
|
||
}
|
||
};
|
||
}
|
||
"--scale-factor" => {
|
||
let raw = take(&mut args, inline, "--scale-factor")?;
|
||
let value = number(&raw, "--scale-factor")?;
|
||
if value <= 0.0 {
|
||
return Err(format!("--scale-factor 必须 > 0，收到 {raw:?}"));
|
||
}
|
||
request.scale_factor = Some(value);
|
||
}
|
||
"--appearance" => {
|
||
request.real_appearance =
|
||
match take(&mut args, inline, "--appearance")?.as_str() {
|
||
"real" => true,
|
||
"demo" => false,
|
||
other => {
|
||
return Err(format!("--appearance 只认 real|demo，收到 {other:?}"))
|
||
}
|
||
};
|
||
}
|
||
"--force-state" => {
|
||
// 三档词与产品 bin 同一套（`cli.rs` 的 `--force-state`），报错文案也照抄。
|
||
request.force_state =
|
||
Some(match take(&mut args, inline, "--force-state")?.as_str() {
|
||
"rest" => Interaction::Enabled,
|
||
"hover" => Interaction::Hovered,
|
||
"pressed" => Interaction::Pressed,
|
||
other => {
|
||
return Err(format!(
|
||
"--force-state 只认 rest|hover|pressed，收到 {other:?}"
|
||
))
|
||
}
|
||
});
|
||
}
|
||
"--passthrough" => {
|
||
passthrough = Some(match take(&mut args, inline, "--passthrough")?.as_str() {
|
||
"on" => true,
|
||
"off" => false,
|
||
other => return Err(format!("--passthrough 只认 on|off，收到 {other:?}")),
|
||
});
|
||
}
|
||
other => return Err(format!("未知参数 {other:?}")),
|
||
}
|
||
}
|
||
|
||
request.flavor = shot_theme.or(theme).unwrap_or(SchemeFlavor::Light);
|
||
|
||
// 指针穿透**只服务取证通道**：没有 `--screenshot` 时显式给值就是配置错误，不是「忽略」——
|
||
// 静默忽略会让人以为交互窗口也「密闭」了，而它其实照常收鼠标。
|
||
if passthrough.is_some() && request.screenshot.is_none() {
|
||
return Err(
|
||
"--passthrough 只服务 --screenshot 取证通道：交互模式的窗口必须收得到鼠标"
|
||
.to_owned(),
|
||
);
|
||
}
|
||
request.passthrough = match request.screenshot {
|
||
// 取证默认密闭：开窗口的那一刻就断开指针输入（见 `Harness::update` 的 `WindowReady`）
|
||
Some(_) => passthrough.unwrap_or(true),
|
||
None => false,
|
||
};
|
||
|
||
if request.real_appearance && request.screen != Screen::Settings {
|
||
return Err(format!(
|
||
"--appearance=real 只对 --screen=settings 生效（当前 --screen={}），别的页没有外观分组，\
|
||
静默接受会出一张假装接了线的图",
|
||
request.screen.slug()
|
||
));
|
||
}
|
||
|
||
if request.width < 320.0 || request.height < 320.0 {
|
||
return Err(format!(
|
||
"窗口太小：{}×{}（至少 320×320）",
|
||
request.width, request.height
|
||
));
|
||
}
|
||
|
||
Ok(request)
|
||
}
|
||
|
||
/// 出图文件名片段（`<screen>[-real][-hover|-pressed]-<class>-<flavor>-w<宽>`，归档用）。
|
||
pub fn slug(&self) -> String {
|
||
let class = WidthClass::of(self.width);
|
||
let flavor = if self.flavor.is_dark() {
|
||
"dark"
|
||
} else {
|
||
"light"
|
||
};
|
||
let width = self.width as u32;
|
||
// 「演示行版」与「真控件版」必须能靠文件名分开，否则归档里两张图分不清谁是谁
|
||
let screen = if self.real_appearance {
|
||
format!("{}-real", self.screen.slug())
|
||
} else {
|
||
self.screen.slug().to_owned()
|
||
};
|
||
// 强制态也进文件名（`-hover` / `-pressed`）：同一屏在两个 forced 下是**两张不同的证据图**，
|
||
// 归档里必须能分开（与 `-real` 同一条理由）。`rest` / 不给 = 不加后缀 ⇒ 既有文件名逐字不变。
|
||
let screen = match self.force_state {
|
||
Some(Interaction::Hovered) => format!("{screen}-hover"),
|
||
Some(Interaction::Pressed) => format!("{screen}-pressed"),
|
||
_ => screen,
|
||
};
|
||
format!("{screen}-{}-{flavor}-w{width}", class.name())
|
||
}
|
||
}
|
||
|
||
fn take(
|
||
args: &mut impl Iterator<Item = String>,
|
||
inline: Option<String>,
|
||
flag: &str,
|
||
) -> Result<String, String> {
|
||
inline
|
||
.or_else(|| args.next())
|
||
.ok_or_else(|| format!("{flag} 需要一个值"))
|
||
}
|
||
|
||
fn number(raw: &str, flag: &str) -> Result<f32, String> {
|
||
raw.parse::<f32>()
|
||
.map_err(|_| format!("{flag} 需要数字，收到 {raw:?}"))
|
||
.and_then(|value| {
|
||
if value.is_finite() && value > 0.0 {
|
||
Ok(value)
|
||
} else {
|
||
Err(format!("{flag} 必须是正数，收到 {raw:?}"))
|
||
}
|
||
})
|
||
}
|
||
|
||
fn flavor(raw: &str) -> Result<SchemeFlavor, String> {
|
||
match raw {
|
||
"light" => Ok(SchemeFlavor::Light),
|
||
"dark" => Ok(SchemeFlavor::Dark),
|
||
other => Err(format!("主题只认 light|dark，收到 {other:?}")),
|
||
}
|
||
}
|