feat(app-iced): M93 —— 外观接线:整窗 α / 面板 α / 背景图 / 配色来源

把 appearance.* 那批键接到窗口与像素上(M91 只落了键与判据,零调用方)。

整窗 α(D34/D36)
- `ensure_layered(hwnd)` 落在唯一 unsafe 文件 `platform/win32/transparency.rs`
  (`WS_EX_LAYERED` 只有 Get/SetWindowLongPtrW 能加,且 CI 的 unsafe-scope 是集合相等);
  `app/boot.rs` 只负责开窗,句柄到手后由 `Message::WindowHandle` → `window_alpha::dispatch`
  先补样式再下发。本机实测 `layered=ok outcome=Applied { byte: 205 }`(α=0.8)。
- 三条入口都会重算并下发:启动(句柄到达)、设置页改动、配置文件热切。
- `layered` 日志有三态:`n/a`(α≥1,压根不需要)/ `ok` / `FAILED`,避免把「没用到」写成假红。

面板 α 与 CPU 档(D36)
- 面板 α 独立于整窗 α:只作用到外壳层(根容器 / 标题栏 / 导航轨)与外观卡片;
  CPU 档强制 1.0、玻璃强制关(`pages/appearance/alpha.rs` 的真值表 + 单测)。
- 色卡档继续走令牌 baseline,只有取色档(①②级)才换 `Ui` 的 scheme(`Ui::from_scheme`)。

背景图(D38)
- 读盘解码(png)→ cover/contain/tile 三种填充几何 → `bg_dim` 向底色退 → 36dp 网格马赛克;
  iced 的 `image` widget 需要 `iced/image` feature(Cargo.toml 不在 scope),故为已登记降级。
- 读盘失败静默回落 + 一条可读诊断(设置页错误行 + 日志),配色经 `Provenance` 回落色卡。

设置页「外观」分组
- 整窗透明度滑块(下限 0.08)/ 面板透明度(CPU 档禁用并写明 55%→100% 的降级)/
  背景图开关与路径 / 填充三档 / 暗化 / 配色来源三档;改完即时生效并写回:
  bridge 覆盖的 5 个键走 `SettingsBridge::persist`,`window_opacity` / `palette_source`
  走 `AppCommand::SetSetting`(每个键只有一个写者)。
- `SettingsBridge::load_base()`(presenter)让 app-iced 不需要直接依赖 core 就能读回
  `window_opacity` / `palette_source`。

取证
- `ULL_APPEARANCE_*` / `ULL_START_ROUTE` 只影响本次进程(语义同 ULL_TICK_TRACE),
  截图通道不读用户配置(D30)。
This commit is contained in:
AskaEth committed 2026-11-02 18:07:31 +08:00
1 parent eae7ae0ff4
commit b8ab46662c
24 files changed
+3119 -48

No files matched your search

+118
View File
@@ -0,0 +1,118 @@
//! App 侧的外观动作:**下发整窗 α / 写回配置 / 打取证日志**。
//!
//! 三件事各自只有一条路,且都从这里出去(`update` 只负责把它们按消息串起来):
//!
//! | 动作 | 唯一落点 | 为什么 |
//! |---|---|---|
//! | 下发整窗 α | [`App::apply_window_alpha`] → `app::window_alpha::dispatch` | 判据在 `platform`、FFI 在 `platform/win32`,这里只做「取 α → 交给执行侧 → 记日志」 |
//! | 写回配置 | [`App::persist_appearance`](8 个 UI 字段)+ `AppCommand::SetSetting`(另外两个只读键) | 每个键**只有一个写者**:`AppearancePrefs` 里没有 `window_opacity` / `palette_source`,它们只能走 schema 指令 |
//! | 取证日志 | [`App::log_appearance`] | 一行里同时有请求值、生效值、下发字节与 FFI 结局 |
//!
//! ## 为什么「写回」要分两条路
//!
//! `SettingsBridge::persist` 收的是 `AppearancePrefs`(背景图四件 + 面板 α + 玻璃 + 强调色),
//! 它的实现是「先读文件当前值,再覆盖我们改的那几个字段」——所以用它写**它覆盖的键**最省事,
//! 也不会把用户的自定义强调色冲掉。而 `appearance.window_opacity` / `appearance.palette_source`
//! 不在那个结构里(它们是「只读下层键」,见 `presenter::prefs::AppearanceBase`),
//! 写它们只能走 schema 白名单指令 `AppCommand::SetSetting`(真 host 用 `SettingStore::set` 落盘)。
use unlucky_presenter::dto::AppCommand;
use crate::pages::appearance::Change;
use super::state::App;
use super::window_alpha::{self, Dispatch};
impl App {
/// 把当前整窗 α 交给执行侧(补 `WS_EX_LAYERED` + `SetLayeredWindowAttributes`)并记一行日志。
///
/// 没有句柄时**也打日志**(`hwnd=none`):不能让「α 没生效」这件事只体现为「屏幕上没变化」。
pub(super) fn apply_window_alpha(&self, context: &str) {
let Some(hwnd) = self.hwnd else {
self.log_appearance(context, None);
return;
};
let alpha = crate::platform::effective_window_alpha(
self.appearance.backend,
f64::from(self.appearance.window_opacity),
);
let dispatch = window_alpha::dispatch(hwnd, alpha);
self.log_appearance(context, Some(&dispatch));
}
/// 取证日志:`[appearance] <状态行> layered=… outcome=…`。
///
/// 数值来自 [`crate::pages::appearance::State::log_line`](请求值 / 生效值 / 下发字节),
/// 尾巴来自执行侧。**这一行就是「透明度到底设成了多少」的证据**——RDP 上的观感不可信。
pub(super) fn log_appearance(&self, context: &str, dispatch: Option<&Dispatch>) {
let mut line = self.appearance.log_line(context);
if let Some(dispatch) = dispatch {
line.push(' ');
line.push_str(&dispatch.describe());
} else {
line.push_str(" layered=skipped outcome=no-window");
}
eprintln!("{line}");
}
/// 设置页改了一项外观。
pub(super) fn on_appearance(&mut self, change: Change) {
let needs_window = self.appearance.apply(change.clone());
// 配色来源 / 背景图可能变了 ⇒ `Ui` 可能要改用解析出的方案。
self.rebuild_ui();
self.view_dirty = true;
self.refresh_view();
match change.key() {
// 两个只读下层键:走 schema 指令(`SettingsBridge` 的结构里没有它们)。
Some(_) if matches!(change, Change::WindowOpacity(_) | Change::PaletteSource(_)) => {
if let (Some(key), Some(value)) = (change.key(), change.value()) {
self.dispatch(AppCommand::SetSetting {
key: key.to_owned(),
value,
});
}
}
// 其余键:走 bridge(它知道怎么保留强调色这类本 mission 不管的字段)。
Some(_) => self.persist_appearance(),
None => {}
}
if needs_window {
self.apply_window_alpha("change");
} else {
self.log_appearance("change", None);
}
}
/// 重读配置后同步外观(热切:外部 CLI / AI 改完 1 秒内生效)。
pub(super) fn reload_appearance(&mut self) {
let (prefs, _theme) = self.bridge.load();
let base = self.bridge.load_base();
self.appearance.reload(&prefs, &base);
self.appearance_prefs = prefs;
self.rebuild_ui();
self.view_dirty = true;
self.apply_window_alpha("reload");
}
/// 把外观写回 `launcher.json`(只改本 mission 管的字段,强调色/玻璃原样保留)。
fn persist_appearance(&mut self) {
let mut prefs = self.appearance_prefs.clone();
prefs.bg_image_enabled = self.appearance.bg_enabled;
prefs.bg_image = self.appearance.bg_path.clone();
prefs.bg_fill = self.appearance.bg_fill;
prefs.bg_dim = self.appearance.bg_dim;
prefs.panel_alpha = self.appearance.panel_alpha;
prefs.glass = self.appearance.glass;
self.bridge.persist(&prefs, self.theme_mode);
self.appearance_prefs = prefs;
match self.bridge.path() {
Some(path) => eprintln!("[settings] 外观已写回 {}", path.display()),
None => eprintln!("[settings] 外观未落盘(数据根解析不出来,内存态运行)"),
}
}
}
+9
View File
@@ -62,6 +62,15 @@ pub(crate) fn run(options: Options) -> iced::Result {
min_size: Some(MIN_SIZE),
decorations: false,
resizable: true,
// M93 / D36:整窗 α 需要 `WS_EX_LAYERED`,但**这里给不了**——
// ① iced 0.14 的 `window::Settings` 没有扩展样式字段;
// ② winit 0.30 只在鼠标穿透(`IGNORE_CURSOR_EVENT`)时置这一位,`transparent: true`
// 走的是 DWM 那条路,与 `LWA_ALPHA` 无关;
// ③ 加扩展样式只有 `Get/SetWindowLongPtrW`,是 `unsafe`,而全仓 `unsafe` 只允许出现在
// `platform/win32/transparency.rs`(CI 的 `unsafe-scope` 是集合相等)。
// 所以窗口创建侧只负责开窗,样式补齐与 α 下发都在拿到句柄之后:
// `app::update` 的 `Message::WindowHandle` → `window_alpha::dispatch`(先 ensure_layered)。
transparent: false,
..window::Settings::default()
});
+2
View File
@@ -38,6 +38,8 @@ pub enum Message {
Heartbeat,
/// 窗口事件(M90:`Resized` 决定布局档位,600 / 840 两条断点靠它生效)。
Window(window::Event),
/// 窗口句柄(M93:`window::run` 探测出的 raw handle;`None` = 拿不到,整窗 α 无法下发)。
WindowHandle(Option<isize>),
/// 页面消息(导航 / 启动 / 停止 / 占位动作)。
Page(pages::Message),
/// 外壳导航轨点选(`src/shell/nav.rs` 的回调仍然发这一条;收到就翻成同一个路由跳转)。
+2
View File
@@ -27,12 +27,14 @@
//! `src/components/`(组件目录自己的归属规则不变),逻辑路径仍是 `crate::app::components`
//! (组件源码里的文档与测试都按这个路径写)。
mod appearance;
mod boot;
mod message;
mod state;
mod subscription;
mod update;
mod view;
mod window_alpha;
#[cfg(test)]
mod tests;
+66 -8
View File
@@ -110,6 +110,15 @@ pub struct App {
pub(super) refreshes: u64,
/// 首屏快照到位后是否已经自动选中过第一行(list-detail 的桌面惯例,见 `update::auto_select`)。
pub(super) auto_selected: bool,
/// 窗口高度(背景图马赛克的视口判据;宽度在 `width`)。
pub(super) height: f32,
/// 外观运行期状态(M93):面板 α / 背景图 / 配色来源 / 诊断。
pub(super) appearance: pages::appearance::State,
/// 设置文件里那 8 个「UI 写入」外观字段的最近快照(写回时只改我们真改了的字段,
/// 强调色这类本 mission 不管的字段原样保留)。
pub(super) appearance_prefs: unlucky_presenter::prefs::AppearancePrefs,
/// 窗口句柄(`Message::WindowHandle` 之后才有;非 Windows 平台恒 `None`)。
pub(super) hwnd: Option<isize>,
}
impl App {
@@ -140,14 +149,34 @@ impl App {
bridge: SettingsBridge,
) -> Self {
let width = WINDOW_SIZE.width;
let height = WINDOW_SIZE.height;
let theme_mode = bridge.load().1;
// 外观两半分开读:`load()` 给 8 个 UI 写入字段,`load_base()` 给 3 个只读下层键
// (整窗 α / 标题栏三态 / 配色来源)。M93 之前这两个键在 app 侧**根本读不到**。
//
// 截图通道**不读用户配置**(D30:同一份代码在两台机器上要出同一张图):外观一律取出厂值,
// 矩阵需要的值由 `ULL_APPEARANCE_*` 显式灌进来。
let (appearance_prefs, appearance_base) = if options.screenshot.is_some() {
(
unlucky_presenter::prefs::AppearancePrefs::factory(),
unlucky_presenter::prefs::AppearanceBase::factory(),
)
} else {
(bridge.load().0, bridge.load_base())
};
let appearance = pages::appearance::State::new(
&appearance_prefs,
&appearance_base,
options.backend,
flavor,
);
let view = pages::Model::new(
pages::Screen::Instances,
width,
Some(pages::Screen::Instances.nav()),
);
Self {
let mut app = Self {
ui: Ui::new(flavor, families),
families,
options,
@@ -166,7 +195,14 @@ impl App {
frames: 0,
refreshes: 0,
auto_selected: false,
}
height,
appearance,
appearance_prefs,
hwnd: None,
};
// 配色来源档可能已经指向一张背景图:那时 `Ui` 必须由解析出的方案构造,而不是 baseline。
app.rebuild_ui();
app
}
/// 本次进程是否走截图通道。
@@ -174,19 +210,41 @@ impl App {
self.options.screenshot.is_some()
}
/// 切主题:只重建 [`Ui`](= 重建 Style),**不动任何 UI 状态**。
/// 切主题:重建 [`Ui`](= 重建 Style),**不动任何 UI 状态**。
///
/// M93 起 `Ui` 有两个来源:配色来源取到了图(①②级)就用解析出的方案,否则用令牌 baseline。
/// 所以这里改叫「重算 `Ui`」:先让外观状态记住新深浅(配色解析要它),再重建。
pub(super) fn set_flavor(&mut self, flavor: SchemeFlavor) {
if self.ui.flavor() == flavor {
if self.ui.flavor() == flavor && self.appearance.flavor() == flavor {
return;
}
let next = Ui::new(flavor, self.families);
self.appearance.set_flavor(flavor);
let previous = self.ui.name();
self.rebuild_ui();
eprintln!(
"[theme] {} -> {} (Theme::name 变化触发缓存重算)",
self.ui.name(),
next.name()
previous,
self.ui.name()
);
self.ui = next;
}
/// 按「配色来源是否取色成功」重建 [`Ui`]。
///
/// 色卡档(③)刻意继续走 `Scheme::baseline`:`resolve_source` 的色卡档返回的是
/// `DEFAULT_CARD`(天蓝卡)方案,与令牌 baseline 逐色不同,应用它会把**全部既有验收图的
/// 像素**改掉。这条偏离登记在 `pages::appearance` 的偏离表 #4。
pub(super) fn rebuild_ui(&mut self) {
self.ui = match self.appearance.derived_scheme() {
Some(scheme) => {
eprintln!(
"[appearance] palette={} → Ui::from_scheme(取色方案接管 49 个角色)",
self.appearance.palette_level()
);
Ui::from_scheme(*scheme, self.families)
}
None => Ui::new(self.appearance.flavor(), self.families),
};
}
/// 把 presenter 的快照转换成页面视图模型(**展示转换在 UI 侧做**)。
+2
View File
@@ -9,6 +9,8 @@ use unlucky_presenter::mock::MockBackend;
use unlucky_presenter::router::Route;
use unlucky_presenter::settings_bridge::SettingsBridge;
#[cfg(test)]
mod appearance;
#[cfg(test)]
mod presenter;
+290
View File
@@ -0,0 +1,290 @@
//! 外观接线的单测:**配置 → 状态 → 下发字节 / 像素 / 落盘**。
//!
//! 每条都按本 mission 的验收纪律写「抓得住 / 抓不住」。真机才有的东西(`WS_EX_LAYERED` 是否补上、
//! `LWA_ALPHA` 的观感)不在这里假装——那是 `[appearance]` 日志与报告里「没验的部分」的事。
use std::path::PathBuf;
use unlucky_design::color::SchemeFlavor;
use unlucky_presenter::mock::MockBackend;
use unlucky_presenter::prefs::{BgFill, PaletteSource};
use unlucky_presenter::settings_bridge::SettingsBridge;
use crate::cli::{Backend, Options};
use crate::pages::appearance::{self, Change, State};
use crate::pages::{self, Screen};
use super::{headless, FAMILIES};
use super::super::state::App;
/// 一个把配置写在临时文件里的 App(测「读回 / 写回」必须真的过文件)。
fn with_config(json: &str, backend: Backend, label: &str) -> (App, PathBuf) {
let dir = std::env::temp_dir().join(format!(
"ull-appear-{label}-{}-{}",
std::process::id(),
line!()
));
std::fs::create_dir_all(dir.join("config")).expect("临时目录");
let path = dir.join("config/launcher.json");
std::fs::write(&path, json).expect("写配置文件");
let app = App::with_presenter(
Options {
backend,
..Options::default()
},
FAMILIES,
SchemeFlavor::Light,
Box::new(MockBackend::new()),
SettingsBridge::with_path(&path),
);
(app, dir)
}
fn cleanup(dir: &PathBuf) {
std::fs::remove_dir_all(dir).ok();
}
/// 抓得住:配置里写 `window_opacity=0.8` → 启动读回 0.8 → 下发字节 204(钳位链的入口那一段)。
/// 抓不住:Win32 是否真的收下 204(`transparency` 的单测与本机日志各自举证)。
#[test]
fn the_configured_window_alpha_is_read_back_and_turned_into_a_byte() {
let (app, dir) = with_config(
r#"{"appearance":{"window_opacity":0.8,"palette_source":"preset"}}"#,
Backend::Cpu,
"read",
);
assert_eq!(app.appearance.window_opacity, 0.8);
assert_eq!(
app.appearance.window_alpha_byte(),
Some(205),
"f32 0.8 → f64 略大于 0.8 → ceil 205(不向下取整)"
);
// CPU 档:窗口 α 允许,面板 α 强制 1.0。
assert_eq!(app.appearance.effective_panel_alpha(), 1.0);
assert!(app.appearance.panel_is_forced());
cleanup(&dir);
}
/// 抓得住:①面板 α 滑到 0.8 → 状态是 0.8、生效值 GPU 档也是 0.8;
/// ②CPU 档下滑到 0.5 → 生效值仍是 1.0,而**请求值**仍是 0.5(界面上的「requested → forced」靠这条)。
/// 抓不住:这层半透明在屏幕上到底多透(RDP 上不可信,见报告)。
#[test]
fn panel_alpha_is_independent_of_the_window_alpha_and_forced_on_cpu() {
let mut gpu = headless(Options::default(), SchemeFlavor::Light);
gpu.appearance.apply(Change::PanelAlpha(0.8));
assert_eq!(gpu.appearance.panel_alpha, 0.8);
assert_eq!(gpu.appearance.effective_panel_alpha(), 0.8);
assert_eq!(gpu.appearance.window_opacity, 1.0, "面板 α 不许带动整窗 α");
let mut cpu = headless(
Options {
backend: Backend::Cpu,
..Options::default()
},
SchemeFlavor::Light,
);
assert!(
!cpu.appearance.apply(Change::PanelAlpha(0.5)),
"只有整窗 α 需要立刻下发(面板 α 只重绘)"
);
assert_eq!(cpu.appearance.panel_alpha, 0.5, "请求值保留");
assert_eq!(
cpu.appearance.effective_panel_alpha(),
1.0,
"CPU 档强制 1.0"
);
assert_eq!(cpu.appearance.window_alpha_byte(), None, "整窗 α 仍是 1.0");
}
/// 抓得住:一次滑块改动 → 落盘 → **新开一个 bridge** 能读回(= 重启后还在)。
/// 抓不住:真 host 是否也写了同一份文件(`AppCommand::SetSetting` 走的是同一份 schema)。
#[test]
fn a_panel_alpha_change_is_written_back_to_the_config_file() {
let (mut app, dir) = with_config("{}", Backend::Gpu, "write");
app.on_appearance(Change::PanelAlpha(0.8));
app.on_appearance(Change::BgFill(BgFill::Tile));
app.on_appearance(Change::BgDim(0.5));
let path = dir.join("config/launcher.json");
let reopened = SettingsBridge::with_path(&path).load().0;
assert_eq!(reopened.panel_alpha, 0.8);
assert_eq!(reopened.bg_fill, BgFill::Tile);
assert!((reopened.bg_dim - 0.5).abs() < 1e-6);
assert_eq!(
app.appearance_prefs.panel_alpha, 0.8,
"内存里的「已落盘快照」也要跟上,否则下一次写回会拿旧基底覆盖"
);
cleanup(&dir);
}
/// 抓得住:路径读不出来时 ①不 panic ②`background_active()` 为假(静默回落)
/// ③诊断里有一句人话(不是空串)④配色回落到色卡档(不换 scheme)。
/// 抓不住:这张图在别的机器上路径存在时会怎样(那是成功路径,另一条测试管)。
#[test]
fn a_broken_background_path_falls_back_silently_but_says_why() {
let mut app = headless(Options::default(), SchemeFlavor::Light);
app.appearance
.apply(Change::BgImage("D:/definitely/not/here.png".to_owned()));
assert!(!app.appearance.background_active());
assert!(app.appearance.mosaic((1180.0, 760.0), [0, 0, 0]).is_none());
assert_eq!(app.appearance.diagnostics().len(), 1, "恰好一条诊断");
assert!(
app.appearance.diagnostics()[0].contains("could not be read"),
"诊断要是人话:{:?}",
app.appearance.diagnostics()
);
assert_eq!(app.appearance.palette_level(), "preset", "回落色卡");
assert!(
app.appearance.derived_scheme().is_none(),
"色卡档不换 scheme"
);
}
/// 抓得住:真 PNG → 背景真的生效(有马赛克、有格数、配色走「背景图取色」这一级)。
/// 抓不住:马赛克的观感(36dp 网格是已登记的降级),以及填充三种档的视觉差异(几何由
/// `background` 的纯函数测试守)。
#[test]
fn a_decodable_png_makes_the_background_and_the_palette_active() {
let dir = std::env::temp_dir().join(format!("ull-appear-png-{}", std::process::id()));
std::fs::create_dir_all(&dir).expect("临时目录");
let path = dir.join("bg.png");
let image = image::RgbImage::from_fn(64, 32, |x, _y| {
if x < 32 {
image::Rgb([200, 30, 30])
} else {
image::Rgb([20, 60, 200])
}
});
image.save(&path).expect("写 png");
let mut app = headless(Options::default(), SchemeFlavor::Light);
app.appearance
.apply(Change::PaletteSource(PaletteSource::BackgroundImage));
app.appearance
.apply(Change::BgImage(path.to_string_lossy().to_string()));
app.rebuild_ui();
assert!(app.appearance.background_active());
let mosaic = app
.appearance
.mosaic((1180.0, 760.0), [0, 0, 0])
.expect("有背景层");
assert!(mosaic.cols > 1 && mosaic.rows > 1);
assert_eq!(app.appearance.diagnostics().len(), 0, "成功时没有诊断");
assert_eq!(app.appearance.palette_level(), "background-image");
assert!(
app.appearance.derived_scheme().is_some(),
"取色成功后 Ui 要换成解析出的方案"
);
// 换 scheme 之后主题名仍是同一个(深浅没变),但 primary 必须与 baseline 不同。
assert_eq!(app.ui().name(), "ull-m3-light");
let baseline = crate::theme::Ui::new(SchemeFlavor::Light, FAMILIES);
assert_ne!(
app.ui().color(unlucky_design::color::Role::Primary),
baseline.color(unlucky_design::color::Role::Primary)
);
std::fs::remove_dir_all(&dir).ok();
}
/// 抓得住:设置页在有外观状态时能真的构图(真控件树,含文本框/滑块/互斥按钮),并且
/// 「外观」分组的下标与 `appearance::APPEARANCE_GROUP` 一致(点左列能切过去)。
/// 抓不住:这些控件点下去之后的交互(`Message` 的落点由 `on_appearance` 的其它测试管)。
#[test]
fn the_settings_page_renders_the_real_appearance_group() {
let mut app = headless(Options::default(), SchemeFlavor::Light);
app.state
.navigate(unlucky_presenter::router::Route::Settings);
app.refresh_view();
assert_eq!(app.view.screen, Screen::Settings);
assert_eq!(app.appearance.selected_group, appearance::APPEARANCE_GROUP);
let _tree = pages::page_with_appearance(&app.ui, &app.view, &app.appearance);
drop(_tree);
// 切分组:只改视图状态,不落盘(`Change::SelectGroup` 的 key() == None)。
app.appearance.apply(Change::SelectGroup(0));
assert_eq!(app.appearance.selected_group, 0);
let _tree = pages::page_with_appearance(&app.ui, &app.view, &app.appearance);
}
/// 抓得住:**把滑块从头拖到尾**(0.00 → 1.00 的 11 个档)时,状态里的整窗 α 与下发字节逐档单调
/// 上升、且最低一档就是下限字节 21(= 0.0824 ≥ 0.08)、最后一档不透明(不给字节)。
/// 这就是「拖动 → 实际 α」的链条在数值上的等价物;真机拖动的那一次由二进制日志举证。
/// 抓不住:拖动的手感与真实观感(RDP 上不可信)。
#[test]
fn a_slider_sweep_moves_the_alpha_and_the_byte_monotonically() {
let mut app = headless(Options::default(), SchemeFlavor::Light);
let mut bytes = Vec::new();
for step in 0..=10 {
let fraction = step as f32 / 10.0;
let alpha = crate::pages::appearance::alpha::window_alpha_from_fraction(fraction);
app.appearance.apply(Change::WindowOpacity(alpha));
let byte = app.appearance.window_alpha_byte();
bytes.push(byte);
// 每一档都要能打出一行(数值而不是观感)。
assert!(app.appearance.log_line("sweep").contains("window_alpha="));
}
assert_eq!(bytes[0], Some(21), "0% 一档 = 下限 0.08 → 21");
assert_eq!(bytes[10], None, "100% 一档 = 不透明 → 不下发");
let sent: Vec<u8> = bytes.iter().flatten().copied().collect();
assert!(
sent.windows(2).all(|pair| pair[0] <= pair[1]),
"字节必须单调不减:{sent:?}"
);
assert_eq!(sent.len(), 10, "除最后一档(不透明)之外每档都有字节");
assert!(
sent.iter().all(|byte| *byte >= 21),
"任何一档都不许低于下限字节:{sent:?}"
);
}
/// 抓得住:日志行里有请求值、生效值与下发字节(RDP 上唯一可信的证据形态)。
/// 抓不住:这行日志是否真的被写进了 stderr(本测试只钉格式,真机日志由跑起来的二进制举证)。
#[test]
fn the_log_line_carries_requests_effective_values_and_the_byte() {
let mut cpu = headless(
Options {
backend: Backend::Cpu,
..Options::default()
},
SchemeFlavor::Light,
);
cpu.appearance.apply(Change::WindowOpacity(0.5));
cpu.appearance.apply(Change::PanelAlpha(0.4));
let line = cpu.appearance.log_line("change");
assert!(line.starts_with("[appearance] change "), "{line}");
assert!(line.contains("window_alpha=0.500"), "{line}");
assert!(line.contains("panel_alpha=1.000"), "CPU 档生效值:{line}");
assert!(line.contains("(requested 0.400)"), "请求值也要在:{line}");
assert!(
line.contains("byte=128"),
"0.5×255=127.5 → 向上取整 128:{line}"
);
// 不透明时不给字节(而不是给 255)。
let opaque = headless(Options::default(), SchemeFlavor::Light);
assert!(opaque.appearance.log_line("boot").contains("byte=none"));
}
/// 抓得住:`State::new` 与 `apply_env` 之外,`State` 的构造不会偷偷读环境(测试之间不串味)。
/// 抓不住:`ULL_APPEARANCE_*` 在真机上的解析(`apply_env` 由截图矩阵覆盖,见报告)。
#[test]
fn a_fresh_state_is_the_factory_appearance() {
let state = State::new(
&unlucky_presenter::prefs::AppearancePrefs::factory(),
&unlucky_presenter::prefs::AppearanceBase::factory(),
Backend::Gpu,
SchemeFlavor::Light,
);
assert_eq!(state.window_opacity, 1.0);
assert_eq!(state.effective_panel_alpha(), 1.0);
assert!(!state.background_active());
assert!(state.diagnostics().is_empty());
assert!(state.mosaic((1180.0, 760.0), [0, 0, 0]).is_none());
}
+55 -2
View File
@@ -48,6 +48,24 @@ impl App {
Message::Boot => self.on_boot(),
Message::WindowReady(id) => {
self.window = id;
// M93:整窗 α 要 Win32 句柄,而 iced 只给 `window::Id`。`window::run` 是唯一能把
// `&dyn Window`(实现了 `HasWindowHandle`)拿出来的入口。
match id {
Some(id) => {
window::run(id, super::window_alpha::probe_hwnd).map(Message::WindowHandle)
}
None => Task::none(),
}
}
Message::WindowHandle(hwnd) => {
self.hwnd = hwnd;
match hwnd {
Some(_) => self.apply_window_alpha("boot"),
None => {
eprintln!("[appearance] hwnd=none(拿不到窗口句柄:整窗 α 无法下发)");
self.log_appearance("boot", None);
}
}
Task::none()
}
Message::SystemTheme(mode) => {
@@ -69,6 +87,8 @@ impl App {
Message::Window(event) => {
if let window::Event::Resized(size) = event {
self.width = size.width;
// 高度是背景马赛克的视口判据之一(宽度早就有),以前只记宽是因为没有背景层。
self.height = size.height;
self.view_dirty = true;
self.refresh_view();
}
@@ -122,6 +142,12 @@ impl App {
// 截图通道**不读设置文件**(D30 可复现:同一份代码在两台机器上要出同一张图)。
self.apply_config_theme();
// M93 外观取证开关(`ULL_APPEARANCE_*`)+ 启动那一行数值日志。
// 必须在 `refresh_view` 之前:设置页要画的就是这份状态。
self.appearance.apply_env();
self.rebuild_ui();
self.log_appearance("boot", None);
// 交互模式且没显式指定主题 → 探系统;截图模式永不等(见 cli 模块文档)
if self.options.wants_system_theme() {
tasks.push(iced::system::theme().map(Message::SystemTheme));
@@ -129,6 +155,16 @@ impl App {
// 「重新扫描实例目录 + 全部页面快照」:真 host 在这里发首批事件,mock 在构造时已预置
self.dispatch(AppCommand::RefreshAll);
// 取证开关 `ULL_START_ROUTE`:截图/冒烟直接落到某一页(`cli.rs` 不在本 mission 的 scope,
// 而「外观」分组只在设置页上,出矩阵必须能直达)。未知值忽略。
if let Some(route) = env_start_route() {
eprintln!("[boot] ULL_START_ROUTE → {route:?}");
self.state.navigate(route);
// 直达某一页时不要再被「自动选中第一条实例」拉回详情页。
self.auto_selected = true;
}
self.auto_select();
self.view_dirty = true;
self.refresh_view();
@@ -209,8 +245,10 @@ impl App {
let reloaded =
!self.has_screenshot() && poll_due && self.bridge.reload_if_changed().is_some();
if reloaded {
eprintln!("[settings] 配置文件变了,重读主题");
eprintln!("[settings] 配置文件变了,重读主题 + 外观");
self.apply_config_theme();
// M93:外观也热切(面板 α / 背景图 / 配色来源 / 整窗 α 都在里面)。
self.reload_appearance();
}
if self.view_dirty {
@@ -245,6 +283,7 @@ impl App {
}
pages::Message::Launch(id) => self.dispatch(AppCommand::LaunchInstance(id)),
pages::Message::Stop(id) => self.dispatch(AppCommand::StopInstance(id)),
pages::Message::Appearance(change) => self.on_appearance(change),
// 还没接后端的占位动作:只打日志(哪几个、为什么,见 pages 模块文档的偏离登记)
pages::Message::Action(action) => {
eprintln!("[page] 占位动作 {action:?} pressed(没有对应 AppCommand)");
@@ -253,7 +292,7 @@ impl App {
}
/// 派发一条指令并**立刻**抽干它带出来的事件(不本地回显,等价于 Slint 版的 `dispatch`)。
fn dispatch(&mut self, command: AppCommand) {
pub(super) fn dispatch(&mut self, command: AppCommand) {
self.backend.dispatch(command);
// 观察窗:命令发出后 3 秒内保持帧订阅,等后端把第一条事件交回来
// (真 host 是异步的,派发瞬间状态还没变;不设这个窗口,空闲态的帧订阅永远不会打开)。
@@ -330,3 +369,17 @@ fn heartbeat() -> Task<Message> {
Message::Heartbeat
})
}
/// 取证开关 `ULL_START_ROUTE` 的取值解析(`settings` / `instances` / `download` / `logs`)。
///
/// 为什么是环境变量:`crates/app-iced/src/cli.rs` 不在 M93 的 scope,而外观矩阵必须在**设置页**上
/// 出图。语义与 `ULL_APPEARANCE_*` / `ULL_TICK_TRACE` 一致:只影响这一次进程。
fn env_start_route() -> Option<Route> {
match std::env::var("ULL_START_ROUTE").ok()?.trim() {
"instances" => Some(Route::Instances),
"download" => Some(Route::Download),
"logs" => Some(Route::Logs),
"settings" => Some(Route::Settings),
_ => None,
}
}
+19 -7
View File
@@ -42,14 +42,26 @@ impl App {
// `shell` 画,中间那块才是页面。M90 r2 之前这里用的是 `pages::app`(自带一条**没有任何
// 控件**的标题栏留白带),而 `DragWindow` / `ResizeStart` / `Minimize` / `ToggleMaximize` /
// `Close` 五个消息只在外壳里构造 ⇒ 产品页「拖不动、缩不了、点不到关闭」。
//
// M93:三样东西从外观状态进来——①背景层(垫在最底下)②面板 α(外壳层的底色)③设置页要读
// 的那份状态本身(`page_with_appearance`)。
match pages::Screen::of(self.state.route()) {
Some(_) => shell::view_with_content(
&self.ui,
nav_item_of(self.state.route()),
APP_TITLE,
pages::page(&self.ui, &self.view).map(Message::Page),
self.options.force_state,
),
Some(_) => {
let background =
pages::appearance::layer(&self.ui, &self.appearance, (self.width, self.height))
.map(|element| element.map(Message::Page));
shell::view_with_background(
&self.ui,
nav_item_of(self.state.route()),
APP_TITLE,
background,
self.appearance.effective_panel_alpha(),
pages::page_with_appearance(&self.ui, &self.view, &self.appearance)
.map(Message::Page),
self.options.force_state,
)
}
// `Route::Agent`:AI 独立页还没有页面实现(P1),回退到 M68 的外壳卡(同一套装饰)。
None => shell::view(
&self.ui,
+134
View File
@@ -0,0 +1,134 @@
//! 整窗 α 的**执行侧**:句柄探测 → `WS_EX_LAYERED` → `SetLayeredWindowAttributes` → 一行日志。
//!
//! ## 为什么句柄要绕一圈 iced
//!
//! iced 0.14 只给 `window::Id`(它自己的编号),没有「给我 HWND」的公开 API;唯一的入口是
//! `window::run(id, callback)`——回调里拿到的 `&dyn Window` 实现了 `HasWindowHandle`
//! (raw-window-handle 0.6),于是能取到 `RawWindowHandle::Win32(hwnd)`。
//!
//! ## 三层责任(顺序不能换)
//!
//! 1. **探测句柄**:[`probe_hwnd`],纯取;拿不到就整条链跳过(并如实打日志,不许假装成功);
//! 2. **补分层样式**:`ensure_layered`(唯一 `unsafe` 落点,`platform/win32/transparency.rs`);
//! `SetLayeredWindowAttributes` 在没有 `WS_EX_LAYERED` 的窗口上**必然失败**(Win32 返回 0,
//! 本机 `GetLastError` 常见 87),所以这一步是硬前提;
//! 3. **下发 α**:`apply_window_alpha`。`α ≥ 1` 时它返回 `Opaque` 并且**不调 FFI**,那时也就不必
//! 改扩展样式(1、2 步都是白改),[`dispatch`] 里按这个条件短路。
//!
//! ## 为什么日志要记「下发字节」而不是「看起来多透明」
//!
//! 本机是 RDP + 4 个虚拟显示适配器:`LWA_ALPHA` 的**观感**在这里不可信。所以证据链是
//! `配置值 → 判据 → 字节 → Win32 返回值`,全部经 [`super::App::log_appearance`] 落成一行文本。
use iced::window;
use crate::platform::win32::transparency::{apply_window_alpha, ensure_layered, AlphaOutcome};
/// 一次「补样式 + 下发」的结果(日志与单测共用)。
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(super) struct Dispatch {
/// `WS_EX_LAYERED` 是否就位(`α ≥ 1` 或 `α = None` 时为 `false`:那次根本没动扩展样式)。
pub layered: bool,
/// 下发的结局。
pub alpha: AlphaOutcome,
}
impl Dispatch {
/// 日志尾巴:`layered=ok outcome=Applied { byte: 205 }`。
///
/// `layered` 有三个值,刻意区分「没用到」与「失败」:
/// - `n/a`:α ≥ 1 或被拒绝 —— 那次**根本不需要**分层窗口,不是错误;
/// - `ok`:这一位在(原本就有或本条补上);
/// - `FAILED`:需要补但补不上(无效句柄等)—— 只有这一种是坏消息。
pub(super) fn describe(&self) -> String {
let layered = match self.alpha {
AlphaOutcome::Opaque | AlphaOutcome::Rejected(_) => "n/a",
AlphaOutcome::Applied { .. } | AlphaOutcome::Failed { .. } if !self.layered => "FAILED",
_ => "ok",
};
format!("layered={layered} outcome={:?}", self.alpha)
}
}
/// 把 iced 的窗口句柄翻成 Win32 的 `HWND`(`isize`)。非 Windows 平台返回 `None`。
pub(super) fn probe_hwnd(handle: &dyn window::Window) -> Option<isize> {
use window::raw_window_handle::RawWindowHandle;
let handle = handle.window_handle().ok()?;
match handle.as_raw() {
#[cfg(target_os = "windows")]
RawWindowHandle::Win32(win32) => Some(win32.hwnd.get()),
#[cfg(not(target_os = "windows"))]
_ => None,
#[cfg(target_os = "windows")]
_ => None,
}
}
/// 补样式 + 下发(**幂等**:`α ≥ 1` 时什么都不做,返回 `Opaque`)。
pub(super) fn dispatch(hwnd: isize, alpha: Option<f64>) -> Dispatch {
// α 不透明 / 被拒绝时不需要分层窗口:`SetLayeredWindowAttributes` 那次调用也不会发生,
// 改扩展样式纯属副作用(还会让 DWM 换一条合成路径),所以短路掉。
let needs_layered = alpha.is_some_and(|alpha| alpha < 1.0);
let layered = needs_layered && ensure_layered(hwnd);
Dispatch {
layered,
alpha: apply_window_alpha(hwnd, alpha),
}
}
#[cfg(test)]
mod tests {
use super::dispatch;
use crate::platform::win32::transparency::{AlphaOutcome, AlphaRejection};
/// 抓得住:①`α = None` / `α ≥ 1` / `α = 0` 时**不去碰扩展样式**(短路条件写反会在这里红);
/// ②拒绝路径的返回值与 `transparency` 的判据一致。
/// 抓不住:真实窗口(有效句柄)上 `WS_EX_LAYERED` 是否真的加上了——那要靠本机日志的 `layered=ok`。
#[test]
fn opaque_or_refused_alpha_never_touches_the_window_style() {
for none in [None, Some(1.0), Some(1.5), Some(0.0), Some(-1.0)] {
let result = dispatch(1234, none);
assert!(!result.layered, "{none:?} 不该改扩展样式");
}
assert_eq!(
dispatch(1234, None).alpha,
AlphaOutcome::Rejected(AlphaRejection::NoAlpha)
);
assert_eq!(dispatch(1234, Some(1.0)).alpha, AlphaOutcome::Opaque);
// 无效句柄 + 合法 α:样式补不上(layered=false),FFI 也不会成功——两层都如实报告。
let invalid = dispatch(1, Some(0.5));
assert!(!invalid.layered, "无效句柄补不上 WS_EX_LAYERED");
assert!(
matches!(invalid.alpha, AlphaOutcome::Failed { .. }),
"{:?}",
invalid.alpha
);
}
/// 本机真窗口的取证由 `App` 启动日志给(见 `app::appearance::log_appearance`),
/// 这里只钉日志格式:`Applied { byte: 205 }` 必须能一眼读出字节,且「没用到样式」不等于失败。
#[test]
fn the_log_tail_carries_the_byte_and_distinguishes_skipped_from_failed() {
let applied = super::Dispatch {
layered: true,
alpha: AlphaOutcome::Applied { byte: 205 },
};
assert!(applied.describe().starts_with("layered=ok outcome=Applied"));
assert!(applied.describe().contains("205"));
// α = 1.0:没补样式是**正常**的,不许写成 FAILED(否则报告里会出现假红)。
let opaque = super::Dispatch {
layered: false,
alpha: AlphaOutcome::Opaque,
};
assert!(opaque.describe().starts_with("layered=n/a"));
// 真的要补却没补上:这才是 FAILED。
let failed = super::Dispatch {
layered: false,
alpha: AlphaOutcome::Failed { code: 87 },
};
assert!(failed.describe().starts_with("layered=FAILED"));
}
}