fix(m161): 收更新键/按钮/矮窗口/启动错误/导入结果五笔债

① update.auto_check / update.channel 登记进 core setting schema(1.6.0)
   - 新增 setting/keys/update.rs(两键 + UPDATE_CHANNELS,只允许 stable);
     SettingSchema 加 with_all 供域键表批量登记。
   - 新增 setting/update_prefs.rs:cache/update/prefs.json → launcher.json 的一次性迁移。
     四条硬约束:源指纹闸门(幂等)、不丢 false、新值胜出、旧文件改名 .migrated 后不再被读;
     主配置不可写时不动旧文件。收据 config/update-prefs-migration.json。
   - presenter Runtime 建会话时迁一次并把结局留在 migration();prefs 字段换成
     auto_check + 每次派发从主配置读 channel(不再硬编码 Channel::Stable)。
     保留旧字段 auto_check 的真实来源(原有测试 cases 会断言)。
   - CLI config get/set/dump 先跑同一次迁移(幂等),输出里给 migration 段与收据路径。

② presenter/dto/events.rs 的「本次会话不再弹提示条」注释改成真实语义
   (记的是版本号:同版本压住、更高版本照弹、手动检查清掉)。

③ 检查/下载进行中按钮禁用:pages/update/busy.rs 的 busy/can_check/can_apply;
   设置页两颗按钮改画禁用(不是消失),app 层 on_update_action 再挡一道
   (忙碌时 CheckNow/Apply 不派发);新增两条用例(含「忙完恢回可点」)。

④ 内容库低高度:content_layout::MIN_BODY_HEIGHT=460 + BodyMode(按固定件+三整行算出来,
   用例守着算式);frame::body_height 从 Ui::metrics 算正文可用高,pages::Model 带 window_height。
   ≥460 列表自己滚;<460 主列整列一个滚动条、列表按自然高度铺开。

⑤ 启动错误文案本地化:presenter 删掉 launch_summary / 「启动失败:」前缀 / 五条中文阶段前缀,
   改发 LaunchFailureView{stage,detail};LaunchFinished 改带 exit_code/uptime_ms/failure,
   Toast 由 app 层按 i18n key 现求(与 install_cancelled 同构)。InstancesFailed 拆成
   InstancesFailedStage(列表单行)+ LaunchStageFailed(详情/Toast 全文)。

⑥ 导入结果块:ImportReportView 加 failure_stage(NotStarted/RolledBack/RollbackIncomplete,
   由 core 的 rollback 机器位推出);标题、图标、底色三处分档,预检失败不再说「已回滚」。

顺带:六处注释/文档漂移(update.rs 的分工表与偏好落点、pack 的「已整包回滚」、
build_request 的 Errors、settings/update 的按钮禁用说明等),
以及为守 400 行把 update/cli-config/core-keys/presenter-dto/presenter-launch/i18n-golden
里贴线或越线的文件按模块拆开(纯搬移,行为不变)。
This commit is contained in:
AskaEth committed 2026-11-07 15:02:13 +08:00
1 parent b2d9f3927f
commit 03741ecd2d
69 files changed
+2653 -707

No files matched your search

+2 -2
View File
@@ -131,8 +131,8 @@ fn appearance_keys_are_all_ai_writable_and_registered() {
fn schema_registration_shape_is_right() {
assert_eq!(
launcher_version().minor,
5,
"1.5.0 登记 M116 的窗口圆角策略键"
6,
"1.6.0 登记 M161 的自更新两键(update.auto_check / update.channel)"
);
let schema = launcher_schema();
assert_eq!(
+3 -2
View File
@@ -128,9 +128,10 @@ fn overrides_key_is_an_enum_whitelist() {
#[test]
fn schema_versions_register_the_new_keys_without_migration() {
// 1.5.0 登记 M116 的窗口圆角策略键(1.4.0 = M91 外观下层三键,1.3.0 = D17「外观(高级)」,
// 1.6.0 登记 M161 的自更新两键(`update.auto_check` / `update.channel`;
// 1.5.0 = M116 窗口圆角,1.4.0 = M91 外观下层三键,1.3.0 = D17「外观(高级)」,
// 1.2.0 = D23 的 JDK 落点/优先级键)。
assert_eq!(launcher_version(), SchemaVersion::new(1, 5, 0));
assert_eq!(launcher_version(), SchemaVersion::new(1, 6, 0));
assert_eq!(instance_version(), SchemaVersion::new(1, 1, 0));
assert_eq!(launcher_schema().id(), SchemaId::LAUNCHER);
// major 仍是 1:迁移链(按 major 走)不需要新步骤,老文件缺键即默认值。
@@ -66,7 +66,8 @@ fn install_root_accepts_a_path_and_keeps_empty_as_unset() {
#[test]
fn schema_version_bumps_minor_only_so_no_migration_step_is_needed() {
assert_eq!(launcher_version(), SchemaVersion::new(1, 5, 0));
// 1.6.0 = M161 的自更新两键(此前 1.5.0 是 M116 窗口圆角)。
assert_eq!(launcher_version(), SchemaVersion::new(1, 6, 0));
assert_eq!(
launcher_version().major,
1,
+1
View File
@@ -19,3 +19,4 @@ mod redirect;
mod schema_compat;
mod spec_ai;
mod store;
mod update_keys;
+234
View File
@@ -0,0 +1,234 @@
//! M161:`update.auto_check` / `update.channel` 的 schema 契约 + 旧 `cache/update/prefs.json` 的迁移。
//!
//! 迁移的四条硬约束在这里逐条钉住(幂等 / 不丢 `false` / 新值胜出 / 旧文件退役),
//! 另外还有一条 schema 层面的:`update.channel` 现在只允许 `stable`——清单里没有的渠道
//! 写进文件等于「设了但没生效」,宁可让 `config set` 当面拒绝。
use serde_json::json;
use unlucky_core::setting::document::{RenderMode, SettingDocument};
use unlucky_core::setting::keys::launcher_schema;
use unlucky_core::setting::keys::update::UPDATE_CHANNELS;
use unlucky_core::setting::spec::{Sensitivity, ValueKind};
use unlucky_core::setting::store::SettingStore;
use unlucky_core::setting::update_prefs::{
self, Migration, Targets, DEFAULT_AUTO_CHECK, DEFAULT_CHANNEL, KEY_AUTO_CHECK, KEY_CHANNEL,
RECEIPT_FILE,
};
use super::common::TempDir;
/// 三个路径(`<root>/config/launcher.json` + `<root>/cache/update/prefs.json` + 收据)。
fn targets(_temp: &TempDir) -> (String, String, String) {
(
"config/launcher.json".to_string(),
"cache/update/prefs.json".to_string(),
format!("config/{RECEIPT_FILE}"),
)
}
fn run(temp: &TempDir) -> Migration {
let (launcher, legacy, receipt) = targets(temp);
update_prefs::migrate(
Targets {
launcher: &temp.child(&launcher),
legacy: &temp.child(&legacy),
receipt: &temp.child(&receipt),
},
1_700_000_000_000,
)
}
/// 读主配置里的显式值(`None` = 文件里没这个键)。
fn explicit(temp: &TempDir, key: &str) -> Option<serde_json::Value> {
let store = SettingStore::load(temp.child("config/launcher.json"), launcher_schema());
store.doc().get(key).cloned()
}
#[test]
fn the_two_keys_are_registered_with_the_expected_shape() {
let schema = launcher_schema();
let auto = schema
.spec(KEY_AUTO_CHECK)
.expect("update.auto_check 必须登记");
assert_eq!(auto.default, json!(DEFAULT_AUTO_CHECK), "出厂是开");
assert_eq!(auto.kind, ValueKind::Bool);
assert_eq!(
auto.ai.sensitivity,
Sensitivity::Medium,
"改它会让启动器自己下载并替换 exe,AI 改过要留审计痕迹"
);
let channel = schema.spec(KEY_CHANNEL).expect("update.channel 必须登记");
assert_eq!(channel.default, json!(DEFAULT_CHANNEL));
assert_eq!(channel.kind, ValueKind::Enum(UPDATE_CHANNELS));
assert!(schema.validate(KEY_CHANNEL, &json!("stable")).is_ok());
// 清单里还没有的渠道:**当面拒绝**(写进文件等于「设了但没生效」)。
assert!(schema.validate(KEY_CHANNEL, &json!("beta")).is_err());
assert!(schema.validate(KEY_CHANNEL, &json!("nightly")).is_err());
assert!(schema.validate(KEY_AUTO_CHECK, &json!(1)).is_err());
}
#[test]
fn the_keys_render_in_the_nested_shape() {
let (mut document, problems) = SettingDocument::load(&launcher_schema(), &json!({}));
assert!(problems.is_empty(), "{problems:?}");
// 默认值不落盘:空文档渲染出来不该有 update 段。
assert!(
document.render(RenderMode::Full).get("update").is_none(),
"出厂值不该写进文件"
);
document.set(KEY_AUTO_CHECK, json!(false)).expect("写");
document.set(KEY_CHANNEL, json!("stable")).expect("写");
let rendered = document.render(RenderMode::Full);
assert_eq!(
rendered["update"],
json!({ "auto_check": false, "channel": "stable" }),
"点分键在文件里是嵌套对象(与既有键同一形状)"
);
// 读回来也要是同一个值(IPC/CLI 都读这一份)。
let (reloaded, problems) = SettingDocument::load(&launcher_schema(), &rendered);
assert!(problems.is_empty(), "{problems:?}");
assert!(
!update_prefs::auto_check(&reloaded),
"读回来的生效值必须是文件里的 false"
);
assert_eq!(update_prefs::channel(&reloaded), "stable");
}
#[test]
fn a_false_switch_is_migrated_and_the_old_file_is_retired() {
let temp = TempDir::new("m161-migrate-false");
temp.write("cache/update/prefs.json", r#"{"auto_check": false}"#);
let outcome = run(&temp);
let Migration::Migrated {
auto_check,
retired,
receipt,
} = outcome.clone()
else {
panic!("应当迁入,实际 {outcome:?}");
};
assert!(!auto_check, "旧文件里的 false 不许被默认值盖掉");
// 主配置里是显式的 false(不是「缺键取默认」)。
assert_eq!(explicit(&temp, KEY_AUTO_CHECK), Some(json!(false)));
// 旧文件不能再被读到。
assert!(!temp.exists("cache/update/prefs.json"), "旧文件必须退役");
assert!(temp.exists("cache/update/prefs.json.migrated"), "留着取证");
assert_eq!(retired, temp.child("cache/update/prefs.json.migrated"));
// 收据可查:落盘、类型/指纹/端点齐全。
assert!(receipt.exists(), "收据要落盘:{}", receipt.display());
let text = temp.read(&format!("config/{RECEIPT_FILE}"));
assert!(text.contains("\"legacy_config\""), "{text}");
assert!(text.contains("prefs.json"), "{text}");
assert!(text.contains("launcher.json"), "{text}");
assert!(text.contains("\"applied_at_ms\": 1700000000000"), "{text}");
}
#[test]
fn running_twice_is_idempotent() {
let temp = TempDir::new("m161-migrate-twice");
temp.write("cache/update/prefs.json", r#"{"auto_check": false}"#);
assert!(run(&temp).touched(), "第一遍要真的动手");
let after_first = temp.read("config/launcher.json");
let receipt_first = temp.read(&format!("config/{RECEIPT_FILE}"));
// 第二遍:旧文件已经改名 ⇒ 什么都没得做。
let second = run(&temp);
assert_eq!(second, Migration::Nothing, "第二遍必须是空操作");
assert_eq!(temp.read("config/launcher.json"), after_first, "文件不许变");
assert_eq!(
temp.read(&format!("config/{RECEIPT_FILE}")),
receipt_first,
"收据也不该被重写(源指纹相同 = 跳过)"
);
}
#[test]
fn a_missing_legacy_file_is_a_silent_noop() {
let temp = TempDir::new("m161-migrate-absent");
assert_eq!(run(&temp), Migration::Nothing);
// 连主配置都不该建(没有值要写,就不该白建一个文件)。
assert!(!temp.exists("config/launcher.json"), "不该凭空建配置");
assert!(
!temp.exists(&format!("config/{RECEIPT_FILE}")),
"不该写收据"
);
}
#[test]
fn an_explicit_new_value_wins_over_the_legacy_file() {
let temp = TempDir::new("m161-migrate-new-wins");
temp.write(
"config/launcher.json",
&json!({
"$schema": schema_url(),
"schemaVersion": 1,
"update": { "auto_check": true }
})
.to_string(),
);
temp.write("cache/update/prefs.json", r#"{"auto_check": false}"#);
let outcome = run(&temp);
assert_eq!(
outcome.as_str(),
"new_value_wins",
"主配置里有显式值时不许覆盖:{outcome:?}"
);
assert_eq!(
explicit(&temp, KEY_AUTO_CHECK),
Some(json!(true)),
"新值胜出"
);
// 旧文件照样退役(它已经不是真相源),收据也写了。
assert!(!temp.exists("cache/update/prefs.json"));
assert!(temp.exists(&format!("config/{RECEIPT_FILE}")));
}
#[test]
fn the_default_true_is_not_written_but_the_file_still_retires() {
let temp = TempDir::new("m161-migrate-default");
temp.write("cache/update/prefs.json", r#"{"auto_check": true}"#);
let outcome = run(&temp);
assert_eq!(outcome.as_str(), "migrated");
// 「默认值不落盘」:写进去只是噪音,生效值本来就是 true。
assert_eq!(explicit(&temp, KEY_AUTO_CHECK), None, "出厂值不落盘");
assert!(!temp.exists("cache/update/prefs.json"), "旧文件仍要退役");
let store = SettingStore::load(temp.child("config/launcher.json"), launcher_schema());
assert!(update_prefs::auto_check(store.doc()));
}
#[test]
fn a_corrupt_legacy_file_touches_nothing() {
let temp = TempDir::new("m161-migrate-corrupt");
temp.write("cache/update/prefs.json", "{ not json");
let outcome = run(&temp);
assert_eq!(outcome.as_str(), "unreadable", "{outcome:?}");
// 坏文件保持原样:下一次还能再试(我们既不猜值也不删证据)。
assert!(temp.exists("cache/update/prefs.json"));
assert!(!temp.exists(&format!("config/{RECEIPT_FILE}")));
}
#[test]
fn an_empty_legacy_file_still_means_the_default() {
// `serde(default)`:老文件里没有 auto_check 字段(或整份是 `{}`)⇒ 按出厂值处理,
// 而不是把整份文件判成坏文件。
let temp = TempDir::new("m161-migrate-empty");
temp.write("cache/update/prefs.json", "{}");
let outcome = run(&temp);
assert_eq!(outcome.as_str(), "migrated");
let store = SettingStore::load(temp.child("config/launcher.json"), launcher_schema());
assert!(update_prefs::auto_check(store.doc()), "缺字段取出厂值 true");
}
/// 真 `$schema`(加载不降级才看得到显式值)。
fn schema_url() -> String {
use unlucky_core::setting::keys::launcher_version;
use unlucky_core::setting::schema::{SchemaId, SchemaRef};
SchemaRef::new(SchemaId::LAUNCHER, launcher_version()).url()
}