AskaEth
f217d83680
用户诉求是 PCL 差距四项里的「存档截图 / 导入」，M230 审计确认三层全缺。塔裁决 U3
把这一版钉成「只读列表 + 打开文件夹」，不做缩略图墙（缩略图要引图片解码依赖，而
AGENTS §2 只允许 palette-extract 引 image 类依赖；截图/导入产物形态也没定型）。
core
- `game::saves`（新）：只读列 `<run_dir>/saves`（世界目录）与 `<run_dir>/screenshots`
（图片文件）。只调 symlink_metadata / read_dir / metadata，不建目录、不写文件、不读
文件内容（`icon.png` 只判存在）。目录不存在 ⇒ 空列表不是错误；存在但不可用（符号
链接 / 不是目录 / 读不了）⇒ 具名错误。条目级异常逐条登记原因，不静默丢。
- `platform::opener`（新）：`open_dir` 是**目录**打开器的唯一收敛点（explorer / open /
xdg-open），内部复用 `child::quiet`，cfg 分支只此一处。塔明确要求按 AGENTS §6 放
platform 而不是业务模块，并要一条可执行判据防退化
（`the_launcher_literals_live_here_only` 扫 `crates/core/src`：除本文件外不许出现
`"explorer"` / `"xdg-open"` 字面量）。
presenter
- `dto::saves`：SavesCommand（List / OpenFolder）、SavesListView、SavesFailureView
（结构 + OS 原文，不拼中文）、`SavesListView` 的计数助手。
- `host::saves`：走 `job::spawn`，UI 只收快照；运行目录仍是
`isolation::derive_game_dir` 的同一个答案（与启动 / mod 列表同源，**不写盘**）。
「打开文件夹」打开哪个目录由 host 定：`saves/` → `screenshots/` → 运行目录。
失败分三类（InstanceUnavailable / DirUnusable / OpenFailed），可重试。
- `state::saves`：快照整体替换、迟到结果丢弃、失败保留绑定（重试才有意义）。
- 接线：CoreEvent::Saves / AppCommand::Saves / HostTask::Saves。
app-iced
- `pages::instances::saves`：详情页 SAVES 卡片（MODS 之后、启动参数之前；**不套第二层
滚动条**，整列那一条是唯一入口）。世界行带 UTC 时间与「有图标」，截图行带大小与时间；
第一行固定画「这一版只读」（U3 边界让用户看得见）。读盘失败画一条红字 + 「重试」；
打开文件夹失败**不画**重试（那个动作的重试就是再点一次按钮）。
- 接线：Message::{ReloadSaves, OpenSavesFolder}、`sync_saves`（与 `sync_mods` 同一判据）、
Model::saves、`saves_shot` 出图夹具（ULL_SAVES_FIXTURE=1）。
i18n
- `InstancesSaves*` 20 条中英成对，catalog 与金表在**同一条锚点**后追加、逐字节一致。
证据
- core 只读判据：`game::saves::tests` 在真盘建世界/截图，调用前后各拍一次
（相对路径, 是否目录, 字节数, mtime）指纹并逐条比对；另有用例钉「目录缺失不建目录」。
- presenter：`host::saves::tests` 真盘端到端（custom 档位派生运行目录 → 快照）。
- GUI：`--software-renderer` 1180×760 浅/深各一张 + 1180×1280 两张「整块卡片可见」
（1180×760 下 SAVES 卡片位于折叠线附近，只能看到卡头；第二对用 ULL_WINDOW_SIZE
把窗口拉高，口径与 M98 的矩阵一致），落 `DevDocs/artifacts/M235/`。
没做的（U3 边界内，见 handoff）：缩略图墙、导入、删除/重命名、`level.dat` 的
LevelName 解析（世界名暂时就是目录名）。
55 lines
3.2 KiB
Rust
55 lines
3.2 KiB
Rust
//! OS 抽象层：路径规则、平台目录差异、进程与文件锁、软渲染/显示能力探测辅助。
|
||
//!
|
||
//! 设计定稿：`DevDocs/PlanDoc/04-data-and-config.md` §1–§2（三模式路径与 `.ULL` 四分区）。
|
||
//! Win7 单独适配（决策 D11）在此收敛平台差异判断，避免散落各模块打补丁。
|
||
//!
|
||
//! 公共面（M12 已落地）：
|
||
//! - [`paths`]：宿主平台族与标准目录探测（环境变量可注入），可搬运路径字符串；
|
||
//! - [`layout`]：`.ULL/` 四分区（config/data/cache/logs）与各已知路径的唯一入口；
|
||
//! - [`data_dir`]：三模式数据目录解析（Portable 默认 / Standard / Custom + 高级覆盖）；
|
||
//! - [`redirect`]：迁移后留在旧目录的 `redirect.json` 指针（防便携盘旧目录被再次初始化）；
|
||
//! - [`receipt`]：迁移收据（源指纹防重放）；
|
||
//! - [`dir_migration`]：数据目录迁移（分区逐个搬 + 失败逆序回滚）；
|
||
//! - [`atomic`]：原子写（tmp → fsync → rename）；[`hash`]：迁移收据用的 SHA-256。
|
||
//!
|
||
//! 运行期系统探测（M20 / D19 · `11-os-detection.md`）：
|
||
//! - [`os_info`]：`OsInfo` 快照 + 最低支持判定（One / Unsupported，基线 **Windows 10+ /
|
||
//! macOS 12+ / Linux 达标**）+ 启动自检；
|
||
//! - [`windows_version`]：真实 `major.minor.build`（注册表 `CurrentBuildNumber` 快路径 →
|
||
//! 整键 `CurrentVersion` 家族 → `cmd /c ver` 兜底）；
|
||
//! - [`macos_version`]：`sw_vers` 产品版本 + `sysctl hw.optional.arm64` 运行架构；
|
||
//! - [`linux_caps`]：发行版（仅显示）+ 内核 release（喂 `os.version`）+ 会话/GL 能力探测；
|
||
//! - [`vk_probe`]：Vulkan 能力的安全层探测（loader 文件 / ICD 注册 / 环境变量，无 `unsafe`）；
|
||
//! - [`theme_probe`]：系统主题（浅色/深色）探测，供主题三态的 `auto` 初始化对齐与兜底跟随。
|
||
//! - [`wallpaper`]：桌面壁纸**路径探测**（D38 配色三级优先里第②级的输入）。本模块只做路径
|
||
//! 探测——不解码图片、不取色、不生成调色板，莫奈取色与三级降级在 `crates/design` 的
|
||
//! 后续 mission。
|
||
//! - [`child`]：子进程的唯一构造器 [`child::quiet`]（M213）。Windows 上给子进程带
|
||
//! `CREATE_NO_WINDOW`，否则 GUI 父进程 spawn 控制台程序会给子进程新建控制台——桌面上
|
||
//! 就是「黑框闪一下」。**别在别处直接构造 `Command`**，`tests/child_quiet.rs` 守门。
|
||
//! - [`opener`]：交出去的两件事——[`opener::open_url`]（授权码流）与 [`opener::open_dir`]
|
||
//! （实例详情页的「打开文件夹」，M235）。平台分支只在这里出现一次，业务模块一律调它。
|
||
//!
|
||
//! 尚未落地（后续 mission）：文件锁、进程工具、真实 GL/Vulkan 能力探测（钩子见
|
||
//! [`linux_caps::probe_gl`] 与 [`vk_probe::probe_vk`]，FFI 受限，实际探测归 app 层渲染后端选择）。
|
||
|
||
pub mod atomic;
|
||
pub mod child;
|
||
pub mod data_dir;
|
||
pub mod dir_migration;
|
||
pub mod error;
|
||
pub mod hash;
|
||
pub mod layout;
|
||
pub mod linux_caps;
|
||
pub mod macos_version;
|
||
pub mod opener;
|
||
pub mod os_info;
|
||
pub mod paths;
|
||
pub mod receipt;
|
||
pub mod redirect;
|
||
pub mod termux;
|
||
pub mod theme_probe;
|
||
pub mod vk_probe;
|
||
pub mod wallpaper;
|
||
pub mod windows_version;
|