worker-logplace
5fd5cd47dc
用户投诉原话：「我们的启动日志放在哪？…他找半天没找到崩溃日志」「只有一个安装日志」。 启动器运行日志（.ULL/logs/launcher.log） - presenter 构造 HostEnv 时就登记日志目录：启动早期缓冲的 200 行（[probe]/[font]/[theme]） 当场刷盘，不再是「只有开过一局游戏才有日志」。 - app/** 里所有 eprintln! 诊断改走 app::diag::diag!（stderr + 文件双写，行首 [tag] 即 scope）， 含 boot/boot::fallback/state/update 各线。 - boot 那一拍补一行后端事实（request/effective/fallback）。 - 滚动上限（1 MiB → launcher.1.log，只留一份）写进 README 与 docs/logs-location.md。 会话日志搬家：data/agent/sessions → logs - LauncherLayout: sessions_root()/game_logs() 新增，agent_sessions() 降级为只读兼容。 - host/logs 与 cli/commands/sessions 两个根合并（同 id 新根优先），event_path 回落旧家。 - 不搬不删；日志目录写一份 session-log-location.json 记录（moved=0, policy=read-only-compat）。 入口与文案 - 设置页「通用」新增「日志文件夹」行：路径 + 打开目录 + 复制路径（i18n 中英）。 - 日志页页头的「打开目录」不再是占位：走 M187 的 open_dir，失败文本带路径并送进剪贴板。 - README.md / README.zh-CN.md 新增「日志在哪」章节（含 crash-reports 只在游戏走到那一步才有）， docs/logs-location.md 给出上限、双写判据、迁移策略与没验的部分。 守门（每条都有变异证明，见报告） - 旧家会话仍列得出/打不开 ⇒ 只读新根变红；新会话写 logs/game ⇒ 只读旧根、写回旧家都变红。 - launcher.log 滚动 ⇒ 干掉 rename 变红。 - 打开日志文件夹指向真实目录 ⇒ 换成 cache/ 或去掉 create_dir_all 都变红。 - 日志根随三模式变化 ⇒ 把 HostEnv::logs_dir 写死成便携落点变红。
250 lines
12 KiB
Rust
250 lines
12 KiB
Rust
//! 页面消息的落点（`on_page`）：解 M94 冲突时从 `update.rs` 拆出来。
|
||
//!
|
||
//! 为什么拆：`main` 上 `update.rs` 已经 **397 行**（M94 自己也是因此把下载页四支拆到
|
||
//! `update/download.rs`），日志页再往里塞「剪贴板 + 清日志」两支就顶破 400 硬线。
|
||
//! 与 M94 同一种做法：`app/update/**` 属本 mission scope。
|
||
//!
|
||
//! ## 穷尽性（M94 复审的 p3，本轮收掉）
|
||
//!
|
||
//! 这里是全 crate **唯一**对 [`pages::Message`] 的穷尽匹配点，所以**没有** `_ => {}` 兜底：
|
||
//! 谁往枚举里加变体却忘了接线，编译器立刻报 E0004。原来是 `_ => {}` + 注释「做穷尽性」——
|
||
//! 方向正好写反了，它**取消**穷尽性，把「漏接线」变成「点了没反应」。
|
||
//!
|
||
//! 代价：由前置分支（`on_download` / 本文件里的剪贴板分支）先消费的变体，在 match 里**仍要
|
||
//! 显式列出**。那是保住穷尽性的必要代价，也是这条守卫抓得住东西的原因。
|
||
//!
|
||
//! ## 边界（抓得住什么 / 抓不住什么）
|
||
//!
|
||
//! - 抓得住：**加一个 `pages::Message` 变体却没接线** → 编译失败（E0004），不会静默；
|
||
//! - 抓不住：加一个 `pages::Action` 变体 —— 它落进 `Action(action)` 的占位分支（打印一行
|
||
//! `[page] 占位动作 …`），编译期不会报。这是占位期的既有设计，不是本文件能守的。
|
||
|
||
use unlucky_i18n::{Lang, LangChoice};
|
||
|
||
use crate::app::diag::diag;
|
||
use crate::pages;
|
||
use crate::ui::lang::LangState;
|
||
|
||
use super::*;
|
||
|
||
// --------------------------------------------------------------- 界面语言（M106）
|
||
//
|
||
// 这三个方法住在本文件而不是 `app/state.rs`：`state.rs` 贴着 400 行硬线（M104 的 `agent`、
|
||
// M105 的 `download_draft` 都往那儿长），而 `set_language` 的唯一调用点就是本文件的
|
||
// `pages::Message::Language` 分支——落点与调用点放一起，读的人不用来回跳。
|
||
// 与 M93 把 appearance 那批 `App` 方法放进 `app/appearance.rs` 是同一手法。
|
||
|
||
impl App {
|
||
/// 页面消息：导航走路由栈，真业务命令派发，纯视图态改本地呈现。
|
||
pub(super) fn on_page(&mut self, message: pages::Message) -> Task<Message> {
|
||
// 下载页的四支（含「刷新下载源」）在 `update/download.rs`：`update.rs` 早已贴 400 行
|
||
if self.on_download(&message) {
|
||
return Task::none();
|
||
}
|
||
|
||
match message {
|
||
pages::Message::Navigate(route) => {
|
||
// M109：进内容库时补一次检索（首个动作不该是「再点一下搜索」）。
|
||
// 判据在 `ensure_content_loaded` 里（已有结果/请求在飞就不重复打网络）。
|
||
let entering_content = route == Route::Content;
|
||
self.state.navigate(route);
|
||
self.view_dirty = true;
|
||
self.refresh_view();
|
||
if entering_content {
|
||
self.ensure_content_loaded();
|
||
}
|
||
}
|
||
pages::Message::Launch(id) => self.dispatch(AppCommand::LaunchInstance(id)),
|
||
// M159：自更新动作（检查 / 下载安装 / 忽略 / 立即重启 / 开关自动检查）
|
||
pages::Message::Update(action) => return self.on_update_action(action),
|
||
pages::Message::Stop(id) => self.dispatch(AppCommand::StopInstance(id)),
|
||
pages::Message::Appearance(change) => self.on_appearance(change),
|
||
// M101：设置页的四条填页线共用一个投递口；组内变体在 `update/settings.rs` 里穷尽分发
|
||
// （那一层没有 `_ =>`，见本文件末尾与 `update/settings/tests.rs` 的两条守门）
|
||
pages::Message::Settings(group) => return self.on_settings(group),
|
||
// M106：换界面语言（落盘 + 重建视图模型；档位不是业务命令，不派 `AppCommand`）。
|
||
// 这是**唯一**一处绕开 M101 投递口的页面消息：语言档位不是「某一组的状态」，
|
||
// 它要落盘到 `ui.language` 并重建整棵视图模型（设置页的语言行只是它的第一个出口）。
|
||
pages::Message::Language(choice) => self.set_language(choice),
|
||
// M109：内容库那一套意图在自己的文件里穷尽分发（`update/content.rs`）
|
||
pages::Message::Content(message) => return self.on_content(message),
|
||
// M95：摘要落剪贴板（文本由页面造，这里只搬）
|
||
pages::Message::CopySummary(text) => return iced::clipboard::write(text),
|
||
// 下面四支已由 `on_download` 提前消化；显式列出而不是 `_ => {}`，见模块文档
|
||
pages::Message::SelectVersion(_)
|
||
| pages::Message::InstallVersion(_)
|
||
| pages::Message::CancelInstall
|
||
// M105 的三支 + M107 的四支 + 分类：全部由 `on_download` 提前消化（显式列出保住穷尽性）
|
||
| pages::Message::SetLoader(_)
|
||
| pages::Message::SetLoaderVersion(_)
|
||
| pages::Message::SetInstanceName(_)
|
||
| pages::Message::SetCategory(_)
|
||
// M107 的四支同属下载页（查询 / 清空 / 主版本桶 / 折叠类型栏）
|
||
| pages::Message::SetVersionQuery(_)
|
||
| pages::Message::ClearVersionQuery
|
||
| pages::Message::SelectMajor(_)
|
||
| pages::Message::ToggleTypeRail => debug_assert!(false, "应由 on_download 消费"),
|
||
// M95：清空日志是**呈现层**操作（`log_lines` 是 presenter 的公开快照字段，
|
||
// 不派业务命令、不写持久状态）
|
||
pages::Message::Action(pages::Action::ClearLogs) => {
|
||
self.state.log_lines.clear();
|
||
self.view_dirty = true;
|
||
self.refresh_view();
|
||
}
|
||
// M157：实例页「启动参数」区（编辑写进页面状态；保存才派发命令）
|
||
pages::Message::Instances(message) => return self.on_instance_message(message),
|
||
// M114：账户页（三轨登录 / 列表动作 / 表单输入）
|
||
pages::Message::Account(message) => return self.on_account(message),
|
||
// M188：日志页与设置页的「打开日志文件夹」——同一个落点，路径从设置桥反推
|
||
// （三模式都对），失败文本带完整路径，并**送进剪贴板**（打不开时用户至少能粘出去）。
|
||
pages::Message::Action(pages::Action::OpenLogs) => {
|
||
return match crate::app::logs_folder::open() {
|
||
Ok(dir) => {
|
||
diag!("[logs] 已打开日志文件夹 {}", dir.display());
|
||
Task::none()
|
||
}
|
||
Err(error) => {
|
||
diag!("[logs] 打开日志文件夹失败：{error}");
|
||
iced::clipboard::write(error)
|
||
}
|
||
};
|
||
}
|
||
// 还没接后端的占位动作：只打日志（哪几个、为什么，见 pages 模块文档的偏离登记）
|
||
pages::Message::Action(action) => {
|
||
diag!("[page] 占位动作 {action:?} pressed（没有对应 AppCommand）");
|
||
}
|
||
}
|
||
|
||
Task::none()
|
||
}
|
||
}
|
||
|
||
impl App {
|
||
/// 当前生效的界面语言（= 目录选择；页面文案一律由它派生）。
|
||
pub(in crate::app) fn lang(&self) -> Lang {
|
||
self.lang.lang()
|
||
}
|
||
|
||
/// 设置页语言行要的两件：档位（画选中态）+ 生效语言（画回显）。
|
||
pub(in crate::app) fn language(&self) -> pages::Language {
|
||
self.lang.for_settings()
|
||
}
|
||
|
||
/// 换界面语言（设置页语言行 → `pages::Message::Language`）。
|
||
///
|
||
/// 三件事缺一不可：①档位与结论换掉 ②视图模型重建（`view_dirty` + `refresh_view`，目录是
|
||
/// 视图模型的一部分）③落盘（重启后保持所选语言）。字体不在这里重扫：中文档缺字体时的
|
||
/// 判据/信号归 `i18n::font::decide` + `fonts/cjk.rs`（见报告「没验的部分」）。
|
||
pub(in crate::app) fn set_language(&mut self, choice: LangChoice) {
|
||
if choice == self.lang.choice() {
|
||
return;
|
||
}
|
||
self.lang = LangState::of(choice);
|
||
self.lang.log();
|
||
if !self.bridge.persist_ui_language(choice.setting_value()) {
|
||
diag!("[i18n] 语言偏好没落盘（配置只读或数据根解析不出来）：本次生效，重启会回到旧值");
|
||
}
|
||
self.lang.log_cjk();
|
||
self.view_dirty = true;
|
||
self.refresh_view();
|
||
}
|
||
}
|
||
|
||
#[cfg(test)]
|
||
mod tests {
|
||
use unlucky_design::color::SchemeFlavor;
|
||
use unlucky_i18n::LangChoice;
|
||
use unlucky_presenter::mock::MockBackend;
|
||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||
|
||
use crate::app::state::App;
|
||
use crate::cli::Options;
|
||
use crate::pages;
|
||
use crate::theme::Families;
|
||
|
||
const FAMILIES: Families = Families {
|
||
text: "Segoe UI",
|
||
display: "Segoe UI",
|
||
mono: "Consolas",
|
||
};
|
||
|
||
/// 不碰磁盘的 App（mock 后端 + 内存设置桥），与 `app/tests.rs` 的 `headless` 同型。
|
||
fn headless() -> App {
|
||
App::with_presenter(
|
||
Options::default(),
|
||
FAMILIES,
|
||
SchemeFlavor::Light,
|
||
Box::new(MockBackend::new()),
|
||
SettingsBridge::memory_only(),
|
||
)
|
||
}
|
||
|
||
/// M106：设置页语言行点一下 → 生效语言与视图模型都跟着换。
|
||
///
|
||
/// 抓得住：①`pages::Message::Language` 没接进 `on_page`（点了没反应，编译器不会报——它接得住，
|
||
/// 但接错了分支就静默）；②`set_language` 只改字段不重建视图（界面要等下一次刷新才变）；
|
||
/// ③档位与生效语言各说各话（设置页会画错选中态）。
|
||
/// 抓不住：界面真的画成中文了没有（那要截图，见 `DevDocs/artifacts/m106/`）。
|
||
#[test]
|
||
fn the_language_message_switches_the_catalog_and_rebuilds_the_view() {
|
||
let mut app = headless();
|
||
assert_eq!(
|
||
app.view.lang,
|
||
app.lang(),
|
||
"首帧的视图模型要已经按生效语言建好"
|
||
);
|
||
|
||
let _ = app.update(crate::app::message::Message::Page(
|
||
pages::Message::Language(LangChoice::Fixed(unlucky_i18n::Lang::ZhCn)),
|
||
));
|
||
assert_eq!(app.lang(), unlucky_i18n::Lang::ZhCn);
|
||
assert_eq!(app.view.lang, unlucky_i18n::Lang::ZhCn, "目录要跟着换");
|
||
assert_eq!(
|
||
app.language(),
|
||
pages::Language {
|
||
choice: LangChoice::Fixed(unlucky_i18n::Lang::ZhCn),
|
||
effective: unlucky_i18n::Lang::ZhCn,
|
||
}
|
||
);
|
||
|
||
let refreshes = app.refreshes;
|
||
let _ = app.update(crate::app::message::Message::Page(
|
||
pages::Message::Language(LangChoice::Fixed(unlucky_i18n::Lang::En)),
|
||
));
|
||
assert_eq!(app.view.lang, unlucky_i18n::Lang::En);
|
||
assert_eq!(app.refreshes, refreshes + 1, "换语言要重建一次视图模型");
|
||
|
||
// 同一档再点一次：什么都不该发生（不白重建）
|
||
let refreshes = app.refreshes;
|
||
let _ = app.update(crate::app::message::Message::Page(
|
||
pages::Message::Language(LangChoice::Fixed(unlucky_i18n::Lang::En)),
|
||
));
|
||
assert_eq!(app.refreshes, refreshes, "同一档不该再重建");
|
||
}
|
||
|
||
/// 抓得住：有人给 `on_page` 的 match 重新加 `_ => {}` 兜底 —— 那正是 M94 复审的 p3：
|
||
/// 兜底让「加了变体忘了接线」从**编译错误**退化成「点了没反应」，这条测试把它拽回来。
|
||
/// 抓不住：别的兜底写法（把 match 拆成 if-else 链、给子枚举加通配之后再漏变体），
|
||
/// 也抓不住「加了变体但接错分支」——那两条只有编译器和人读得出来。
|
||
#[test]
|
||
fn the_page_match_has_no_wildcard_fallback() {
|
||
let source = include_str!("page_messages.rs");
|
||
let wildcards: Vec<(usize, &str)> = source
|
||
.lines()
|
||
.enumerate()
|
||
.filter(|(_, line)| {
|
||
let trimmed = line.trim();
|
||
trimmed.starts_with("_ =>") || trimmed.starts_with("_=>")
|
||
})
|
||
.map(|(index, line)| (index + 1, line))
|
||
.collect();
|
||
|
||
assert!(
|
||
wildcards.is_empty(),
|
||
"on_page 里出现了 `_ =>` 兜底（行 {:?}）：它会取消对 pages::Message 的穷尽性，\
|
||
新变体漏接线时编译器不再报 E0004",
|
||
wildcards
|
||
);
|
||
}
|
||
}
|