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

+57 -1
View File
@@ -19,7 +19,7 @@ use unlucky_core::setting::appearance::Appearance;
use unlucky_core::setting::keys::launcher_schema;
use unlucky_core::setting::store::SettingStore;
use crate::prefs::{AppearancePrefs, ThemeMode};
use crate::prefs::{AppearanceBase, AppearancePrefs, ThemeMode};
/// 数据根配置键(决定 `launcher.json` 落在哪个数据目录;与 CLI 的 `DATA_ROOT_KEYS` 同源同义)。
const DATA_ROOT_KEYS: [&str; 4] = [
@@ -100,6 +100,23 @@ impl SettingsBridge {
)
}
/// 外观**下层**的只读快照(D36·D37·D38):整窗 α / 标题栏三态 / 配色来源档。
///
/// 为什么不并进 [`SettingsBridge::load`] 的返回值:那个结构体(`AppearancePrefs`)是
/// **UI 写入用**的(每个字段都会被 `persist` 回写),而这三个键**只读不写**——
/// 落盘走 core 的 `Appearance::write`。并进去会让每个 `AppearancePrefs` 构造点都要补字段,
/// 还会让「这三项只读」这件事在类型上消失。
///
/// UI 侧(`crates/app-iced`)拿它读启动值:`app-iced` 不直接依赖 `unlucky-core`,
/// 所以「把 core 的 `SettingDocument` 翻译成只读快照」这一步必须留在本 crate。
#[must_use]
pub fn load_base(&self) -> AppearanceBase {
match &self.store {
Some(store) => AppearanceBase::from_document(store.doc()),
None => AppearanceBase::factory(),
}
}
/// 落盘(只写出现过的键;失败静默——配置写不进去不该把 UI 卡住,诊断走日志)。
pub fn persist(&mut self, appearance: &AppearancePrefs, theme: ThemeMode) {
let Some(store) = self.store.as_mut() else {
@@ -193,6 +210,7 @@ fn mtime(path: &Path) -> Option<SystemTime> {
#[cfg(test)]
mod tests {
use super::*;
use crate::prefs::PaletteSource;
use unlucky_core::setting::appearance::BgFill;
fn temp_config(label: &str) -> PathBuf {
@@ -291,4 +309,42 @@ mod tests {
appearance.bg_image.clear();
assert!(!appearance.bg_active(), "路径空也不算生效");
}
/// `load_base()` 是「重启后读回整窗 α / 配色来源」的唯一通道(M93)。
///
/// 抓得住:①文件里写着 `window_opacity=0.6` / `palette_source=wallpaper` 时能被**新开的**
/// bridge 读到(= 重启语义);②缺键时回出厂(1.0 / preset),而不是 `0.0` 或随机档。
/// 抓不住:UI 侧是否真的用它来下发窗口 α(那由 `app-iced` 的日志与单测证明)。
#[test]
fn load_base_reads_the_three_read_only_keys_and_defaults_when_missing() {
let path = temp_config("base");
// 文件由「外部写者」(CLI / AI / 设置页的 SetSetting)产生,这里直接落 JSON。
std::fs::write(
&path,
r#"{"appearance":{"theme_mode":"dark","window_opacity":0.6,"palette_source":"wallpaper","panel_alpha":0.5}}"#,
)
.expect("写配置文件");
let bridge = SettingsBridge::with_path(&path);
let base = bridge.load_base();
assert_eq!(base.window_opacity, 0.6, "重启后读回整窗 α");
assert_eq!(base.palette_source, PaletteSource::Wallpaper);
assert!(base.is_transparent());
// 缺键 → 出厂值(与 `AppearanceBase::factory()` 逐字段相等)。
let empty = path.with_file_name("launcher-empty.json");
std::fs::write(&empty, "{}").expect("写空配置");
let factory = SettingsBridge::with_path(&empty).load_base();
assert_eq!(factory, AppearanceBase::factory());
assert_eq!(factory.window_opacity, 1.0);
assert_eq!(factory.palette_source, PaletteSource::Preset);
// 数据根解析不出来的内存态桥也要给得出出厂值(不 panic、不返回 0)。
assert_eq!(
SettingsBridge::memory_only().load_base(),
AppearanceBase::factory()
);
std::fs::remove_dir_all(path.parent().unwrap().parent().unwrap()).ok();
}
}