fix(download): M294 r1 —— JDK 下载页与 CLI 也接上源选择，文档同步

复审 p1：发布版 GUI 的「下载 JDK」页是第二处 DownloadEngine::new（要 with_progress
拿走引擎），此前只读了 gh_proxy，region / mirror_preference 到不了那里；报告却把 GUI
写成「已接」。复审 p2：CLI 四条命令同样不认这两个键 —— 同一份 launcher.json 在 GUI 与
CLI 上表现不同，等于把「设置项说假话」挪到 CLI 侧。

- app-iced downloads/engine.rs：新增 SourceSelection（只读键、不翻译）+
  engine_with(.., &SourceSelection)，在 gh-proxy 三态之前叠
  DownloadTuning::with_source_selection(..).apply_source_selection(..)
- Request 加 source_selection 字段，构造点（app/update/settings/java/downloads.rs）
  用 SourceSelection::of_config(&config) 显式传值（不从缓存根反推配置路径：
  反推失败会静默按 auto 收场，正是本 mission 要消灭的形状）
- cli download.rs 的 tuning()：链 .with_source_selection(..)，四条命令共用这一处装配
- core 的 summary()：把「地区 / 镜像偏好」两档印进 CLI 那行生效值（CLI 既然读了，
  少印两项就是新的半真话）
- shared.rs 注释说清「共享引擎」与本文件的第二处装配点；app-iced 模块头补对照表
- 新判据：JDK 下载页与 CLI 各一条断候选源顺序的用例，均配变异验证（换回裸
  EngineConfig::default() / 裸 tuning 即红）；补一条 region=cn + gh_proxy=off 的
  叠加次序守卫（复审 P3-2）
- docs/download-settings.md：§1 表格两行、§5 拆「已接 / 未接」、新增 §3.1.1 覆盖面
  表、§6 补 M14-M16 三条变异、§7 补「镜像可达性没验」

连带（不加就编不过，已报备 tower）：downloads/tests.rs 的 Request 字面量 +1 行、
downloads/tests/gh_proxy.rs 两处 engine_with 调用点补第四参。

crates/app-iced/src/app/update/settings/java/downloads.rs

@@ -37,7 +37,9 @@ impl App {
     /// ① 目录里有这个大版本；② 没有别的作业在跑；③ 有可写的设置文件与能解析的落点；
     /// ④ 这一档在这台机器上真有一家发行版承接（纯判据，不联网）。
     pub(super) fn start_java_download(&mut self, major: u32) {
-        use pages::settings::java::downloads::{gh_proxy_of_config, Refusal, Request};
+        use pages::settings::java::downloads::{
+            gh_proxy_of_config, Refusal, Request, SourceSelection,
+        };
 
         self.settings.java.download_notice = None;
         self.settings.java.notice = None;
@@ -80,6 +82,9 @@ impl App {
             // `download.gh_proxy`（M197 的任务书那句「默认值可改」）：空 = 跟随内置默认，
             // `off` = 关，其余 = 覆盖前缀。Java 页不画这一项的 UI（归 M193 的下载设置页）。
             gh_proxy: gh_proxy_of_config(&config),
+            // M294：`download.region` / `download.mirror_preference` 从**同一份** config 读出来
+            // 显式传下去（装配点不猜配置在哪；翻译在 core，这里只搬原文）。
+            source_selection: SourceSelection::of_config(&config),
         });
         if !started {
             self.settings.java.download_notice = Some(Refusal::Busy);

crates/app-iced/src/pages/settings/java/downloads.rs

@@ -54,7 +54,7 @@ mod engine;
 mod recommend;
 mod refusal;
 
-pub use engine::{gh_proxy_of_config, GhProxy};
+pub use engine::{gh_proxy_of_config, GhProxy, SourceSelection};
 pub use recommend::recommend;
 pub use refusal::Refusal;
 
@@ -211,6 +211,11 @@ pub struct Request {
     pub priority: Vec<JdkVendor>,
     /// `download.gh_proxy`（`Builtin` = 跟随内置默认；`Off` = 关；`Prefix` = 覆盖前缀）
     pub gh_proxy: GhProxy,
+    /// `download.region` / `download.mirror_preference` 的原文（M294；两个 `None` = 都没设 = 按探测）
+    ///
+    /// 由调用方从**同一份** `launcher.json` 读出后显式传进来（[`SourceSelection::of_config`]）：
+    /// 装配点不再自己去猜配置在哪。翻译（`auto` 回落/优先级）仍只有 core 那一处。
+    pub source_selection: SourceSelection,
 }
 
 /// 作业槽：快照 + 「线程还活着」。
@@ -272,7 +277,12 @@ impl Slot {
                 feed.apply(event);
             }
         });
-        let engine = engine::engine_with(&request.cache_root, emitter, &request.gh_proxy);
+        let engine = engine::engine_with(
+            &request.cache_root,
+            emitter,
+            &request.gh_proxy,
+            &request.source_selection,
+        );
         let install_request = InstallRequest::new(request.major).with_priority(request.priority);
         let result = block_on(install(&engine, &request.install_root, install_request));
         // 引擎丢掉 ⇒ 发射器丢掉 ⇒ 抽干线程读到 `None` 自然退出。

crates/app-iced/src/pages/settings/java/downloads/engine.rs

@@ -1,7 +1,25 @@
-//! 带进度发射器的下载引擎（M197）：一次 JDK 安装一个实例 + `download.gh_proxy` 的真消费者。
+//! 带进度发射器的下载引擎（M197）：一次 JDK 安装一个实例 + `download.*` 的真消费者。
 //!
 //! 从 `downloads.rs` 拆出来（行数 + 口径独立：这里只说「为什么不用共享引擎」）。
-//! 装配口径与 `core::download::shared::build` 一致，只多挂一个 `ProgressEmitter`。
+//!
+//! ## 与 `core::download::shared::build` 的关系（别读成「一样」）
+//!
+//! 一个数据根上**有两处** `DownloadEngine::new`：共享登记处（`shared::build`，GUI 主路径与 CLI
+//! 都走它）和这里（JDK 下载页，因为 `with_progress` 要**拿走**引擎）。差别是实打实的：
+//!
+//! | | `shared::build` | 这里 |
+//! |---|---|---|
+//! | 缓存 / 健康度 | 该数据根 | 同一份（盘上共用） |
+//! | 设置调优（并发 / 重试 / 三段超时） | `wanted(cache_root)`（M193/M292/M289） | **`EngineConfig::default()`** —— 未接，已知差 |
+//! | 源选择（`region` / `mirror_preference`） | `apply_source_selection`（M294） | 同一入口（M294 r1） |
+//! | gh-proxy 三态 | `DownloadTuning::apply_gh_proxy` | 本文件的 [`GhProxy`]（M197） |
+//! | 进度事件 | `ProgressEmitter::silent()` | 这次作业的 emitter |
+//!
+//! 第一行「调优」是**没接**的差：JDK 页不理会 `download.concurrency` / 超时键。要接就把它并进
+//! `DownloadTuning` 一起用 `wanted(cache_root)`——那是另一个决定面，不在 M294 里顺手做。
+//! 「源选择」那一行本轮接上了（r1 复审 p1：设置页改「地区/镜像偏好」在这条路径上没生效），
+//! 并且走的是**与共享引擎同一个翻译层**（`DownloadTuning::with_source_selection`），宿主里没有
+//! 第二份字符串匹配。
 //!
 //! ## gh-proxy 的取值链（任务书那句「（默认值可改）」的落点）
 //!
@@ -24,8 +42,10 @@ use std::path::Path;
 use std::sync::Arc;
 
 use unlucky_core::download::cache::now_ms;
-use unlucky_core::download::config::KEY_GH_PROXY;
-use unlucky_core::download::region::{decide_from, load_cached};
+use unlucky_core::download::config::{
+    DownloadTuning, KEY_GH_PROXY, KEY_MIRROR_PREFERENCE, KEY_REGION,
+};
+use unlucky_core::download::region::{decide_from, load_cached, RegionProfile};
 use unlucky_core::download::region_system::detect_signals;
 use unlucky_core::download::{
     ContentCache, DownloadEngine, EngineConfig, HealthRegistry, MirrorTable, ProgressEmitter,
@@ -76,7 +96,46 @@ pub fn gh_proxy_of_config(config: &Path) -> GhProxy {
     gh_proxy_from(store.doc().effective_str(KEY_GH_PROXY).unwrap_or_default())
 }
 
-/// 带进度发射器的引擎（装配口径与 `download::shared::build` 一致，只多挂一个 emitter + gh-proxy 覆盖）。
+/// 一次 JDK 下载要用的两个「源选择」键的**原文**（`download.region` / `download.mirror_preference`）。
+///
+/// **显式传值**：由按钮回调（`app/update/settings/java/downloads.rs`）从同一份 `launcher.json` 读出、
+/// 挂进 [`Request`](crate::pages::settings::java::downloads::Request) 随作业传到这里，「设置从哪来」
+/// 在调用处一眼可读。不从缓存根反推配置路径——反推失败就静默按 `auto` 收场，正是这条 mission 要
+/// 消灭的那种「设置被无声忽略」。
+#[derive(Debug, Clone, Default, PartialEq, Eq)]
+pub struct SourceSelection {
+    /// `download.region` 原文（`None` = 键不存在 / 不是字符串）。
+    pub region: Option<String>,
+    /// `download.mirror_preference` 原文（同上）。
+    pub mirror_preference: Option<String>,
+}
+
+impl SourceSelection {
+    /// 从 `launcher.json` 把两个键**读出来**（文件不存在 / 键没写 ⇒ `effective_str` 给 schema 默认
+    /// 值 `"auto"`；非字符串值才是 `None`。两者在 core 那里同义，都落成 `Auto`）。
+    ///
+    /// **这里不做默认值回落、也不做取值校验**：`auto` 的语义、大小写与空白的归一、未知值怎么退，
+    /// 全部由 [`DownloadTuning::with_source_selection`] 负责（全仓唯一一处）。在这个函数里再加一层
+    /// 判断，就是「两份口径」的种子——GUI 认一套、CLI 认另一套。
+    #[must_use]
+    pub fn of_config(config: &Path) -> Self {
+        let store = SettingStore::load(config, launcher_schema());
+        let doc = store.doc();
+        Self {
+            region: doc.effective_str(KEY_REGION).map(str::to_string),
+            mirror_preference: doc.effective_str(KEY_MIRROR_PREFERENCE).map(str::to_string),
+        }
+    }
+
+    /// 叠到地区档案上：显式设置压过探测结论（`gh_proxy` 留 `Builtin`，前缀仍由调用点那三态决定）。
+    fn apply(&self, profile: RegionProfile) -> RegionProfile {
+        DownloadTuning::default()
+            .with_source_selection(self.region.as_deref(), self.mirror_preference.as_deref())
+            .apply_source_selection(profile)
+    }
+}
+
+/// 带进度发射器的引擎（装配口径见模块头的对照表，**不等于** `shared::build`）。
 ///
 /// 为什么不再走 `shared::engine_for`：那个登记处交出的是 `Arc<DownloadEngine>`，而挂进度要
 /// 拿走引擎（`with_progress(self)`）。要让共享引擎带「按作业」的观察者，得改引擎内部的
@@ -87,6 +146,7 @@ pub(super) fn engine_with(
     cache_root: &Path,
     progress: ProgressEmitter,
     gh_proxy: &GhProxy,
+    selection: &SourceSelection,
 ) -> DownloadEngine {
     let now = now_ms();
     let profile = load_cached(&cache_root.join("region.json"), now).unwrap_or_else(|| {
@@ -94,6 +154,10 @@ pub(super) fn engine_with(
         let _ = std::fs::create_dir_all(cache_root);
         profile
     });
+    // 显式地区 / 镜像偏好先叠（M294）：`DownloadTuning::default()` 的 gh_proxy 是 `Builtin`
+    // （恒等），所以这一步只动「谁在前」；前缀仍由下面那三态决定——那是 JDK 页 `off` 档的唯一
+    // 真相源，不在这里再翻译一次。
+    let profile = selection.apply(profile);
     let profile = match gh_proxy {
         GhProxy::Builtin => profile,
         GhProxy::Off => profile.with_gh_proxy(None),
@@ -108,3 +172,128 @@ pub(super) fn engine_with(
     )
     .with_progress(progress)
 }
+
+#[cfg(test)]
+mod tests {
+    //! JDK 下载页这个**独立装配点**的守门（M294 r1 复审 P1-1）。
+    //!
+    //! 不进 `downloads/tests.rs`：那一族守的是作业/快照，而这里守的是装配点本身，测试就在被守的
+    //! 函数旁边（`engine_with` 是 `pub(super)`，同文件内可见）。
+
+    use super::*;
+    use std::path::PathBuf;
+    use unlucky_core::download::region::{store_cached, RegionProfile};
+    use unlucky_core::download::types::{DownloadRequest, ResourceKind};
+
+    const LIBRARIES_URL: &str =
+        "https://libraries.minecraft.net/com/google/guava/guava/32.0.0/guava-32.0.0.jar";
+
+    /// 一次 JDK 下载的临时数据根（`<dir>/cache` + `<dir>/config`，与 `prefs_store` 的布局一致）。
+    fn root(tag: &str) -> PathBuf {
+        let dir = std::env::temp_dir().join(format!("ull-jdk-{tag}-{}", std::process::id()));
+        let _ = std::fs::remove_dir_all(&dir);
+        std::fs::create_dir_all(dir.join("cache")).expect("cache");
+        std::fs::create_dir_all(dir.join("config")).expect("config");
+        dir
+    }
+
+    /// 这个数据根的 `launcher.json`（与 `prefs_store` 的布局一致：`<home>/config/launcher.json`）。
+    fn config_of(dir: &Path) -> PathBuf {
+        dir.join("config").join("launcher.json")
+    }
+
+    fn write_config(dir: &Path, key: &str, value: &str) {
+        let mut store = SettingStore::load(config_of(dir), launcher_schema());
+        store
+            .set(key, value.to_string().into())
+            .unwrap_or_else(|err| panic!("schema 认识 {key}：{err}"));
+        store.save().expect("写 launcher.json");
+    }
+
+    fn clear_config(dir: &Path) {
+        std::fs::write(config_of(dir), b"{}").expect("清空 launcher.json");
+    }
+
+    fn plan_sources(engine: &DownloadEngine, dest: &Path) -> Vec<String> {
+        let request = DownloadRequest::new(
+            ResourceKind::Library,
+            LIBRARIES_URL.to_string(),
+            dest.to_path_buf(),
+        );
+        engine
+            .plan(&request, 0)
+            .into_iter()
+            .map(|candidate| candidate.source)
+            .collect()
+    }
+
+    /// **P1-1 判据**：`download.region` / `download.mirror_preference` 改得动 JDK 下载页的候选顺序。
+    ///
+    /// 两段都让设置与 `region.json` 的探测结论**相反**，所以「装配点没读设置」时断言必红
+    /// （未接线时两段的第一条都还是探测值 `bmclapi` / `official`）。
+    ///
+    /// 变异证明：删掉 `engine_with` 里那句 `apply_source_selection`（换回裸档案）⇒ 两段顺序各自红。
+    /// 抓不住：真机上下载 JDK 时实际命中哪个镜像（离线，没有网络证据）。
+    #[test]
+    fn the_source_selection_settings_reach_the_jdk_download_engine() {
+        let dir = root("source-selection");
+        let cache = dir.join("cache");
+        let now = now_ms();
+
+        // 探测=镜像优先，设置 official ⇒ 官方第一条。
+        store_cached(
+            &cache.join("region.json"),
+            &RegionProfile::mirror_first(now),
+        )
+        .expect("档案");
+        write_config(&dir, KEY_MIRROR_PREFERENCE, "official");
+        let selection = SourceSelection::of_config(&config_of(&dir));
+        let engine = engine_with(
+            &cache,
+            ProgressEmitter::silent(),
+            &GhProxy::Builtin,
+            &selection,
+        );
+        assert_eq!(
+            plan_sources(&engine, &dir.join("a.jar")),
+            ["official", "bmclapi"],
+            "JDK 下载页也必须认 mirror_preference"
+        );
+
+        // 探测=直连，设置 cn ⇒ 镜像第一条（先清掉上一段的 official：它优先级更高）。
+        store_cached(&cache.join("region.json"), &RegionProfile::direct(now)).expect("档案");
+        clear_config(&dir);
+        write_config(&dir, KEY_REGION, "cn");
+        let selection = SourceSelection::of_config(&config_of(&dir));
+        let engine = engine_with(
+            &cache,
+            ProgressEmitter::silent(),
+            &GhProxy::Builtin,
+            &selection,
+        );
+        assert_eq!(
+            plan_sources(&engine, &dir.join("a.jar")),
+            ["bmclapi", "official"],
+            "JDK 下载页也必须认 region"
+        );
+
+        // 不设 ⇒ 回到探测结论（这一条与 M294 之前逐值相同）。清空后 `effective_str` 给的是
+        // schema 默认值 `auto`（不是 `None`）——两者在 core 那里同义，都落成 `Auto`。
+        clear_config(&dir);
+        let selection = SourceSelection::of_config(&config_of(&dir));
+        assert_eq!(selection.region.as_deref(), Some("auto"), "{selection:?}");
+        let engine = engine_with(
+            &cache,
+            ProgressEmitter::silent(),
+            &GhProxy::Builtin,
+            &selection,
+        );
+        assert_eq!(
+            plan_sources(&engine, &dir.join("a.jar")),
+            ["official", "bmclapi"],
+            "不设 = 探测结论（直连档案）"
+        );
+
+        std::fs::remove_dir_all(&dir).ok();
+    }
+}

crates/app-iced/src/pages/settings/java/downloads/tests.rs

@@ -174,6 +174,7 @@ fn the_real_download_installs_a_usable_jdk() {
         install_root: JavaInstallRoot::custom(dir.join("jdks")),
         priority: Vec::new(),
         gh_proxy: super::GhProxy::Builtin,
+        source_selection: super::SourceSelection::default(),
     }));
     // 失败/panic 也要清理：这条用例会真下 ~180 MB，留在系统 temp 里是最贵的垃圾。
     struct Cleanup(std::path::PathBuf);

crates/app-iced/src/pages/settings/java/downloads/tests/gh_proxy.rs

@@ -39,7 +39,7 @@ fn the_gh_proxy_setting_maps_to_three_states() {
 #[test]
 fn the_gh_proxy_setting_reaches_the_candidate_chain() {
     use crate::pages::settings::java::downloads::engine::engine_with;
-    use crate::pages::settings::java::downloads::{gh_proxy_of_config, GhProxy};
+    use crate::pages::settings::java::downloads::{gh_proxy_of_config, GhProxy, SourceSelection};
     use unlucky_core::download::cache::now_ms;
     use unlucky_core::download::region::{store_cached, RegionProfile};
     use unlucky_core::download::types::{DownloadRequest, ResourceKind};
@@ -79,6 +79,8 @@ fn the_gh_proxy_setting_reaches_the_candidate_chain() {
         &cache,
         ProgressEmitter::silent(),
         &gh_proxy_of_config(&config),
+        // M294：这条用例只守 gh-proxy，两个源选择键留空（= 跟随 region.json 的判定）。
+        &SourceSelection::default(),
     );
     // ② 档案被覆盖
     assert_eq!(
@@ -104,7 +106,12 @@ fn the_gh_proxy_setting_reaches_the_candidate_chain() {
     );
 
     // 关掉那一档：一个代理候选都不生成（同一份 region.json，只换设置值）。
-    let off = engine_with(&cache, ProgressEmitter::silent(), &GhProxy::Off);
+    let off = engine_with(
+        &cache,
+        ProgressEmitter::silent(),
+        &GhProxy::Off,
+        &SourceSelection::default(),
+    );
     assert_eq!(off.region().gh_proxy, None, "off 必须把前缀清掉");
     let plan = off.plan(&request, 0);
     assert!(

crates/cli/src/download.rs

@@ -14,6 +14,11 @@
 //!   → shared::engine_with_tuning(<cache 根>, tuning) → 引擎的 Semaphore / attempts_for() / 三段超时
 //! ```
 //!
+//! M294 r1：`download.region` / `download.mirror_preference` 走**同一条链**（入口是
+//! [`DownloadTuning::with_source_selection`]，与 presenter 的 `tuning_of` 同一个），落成引擎的
+//! `RegionProfile`（候选源的先后）。在此之前 CLI 的四条命令认不到这两个键，同一份
+//! `launcher.json` 在 GUI 与 CLI 上表现不同——「设置项说假话」只是从 GUI 挪到了 CLI。
+//!
 //! M292：`download.*` 从三个键扩到六个（多了吞吐下限 / 无进展窗口 / 单次请求上界），装配链没变，
 //! 变的是 [`tuning`] 取值的宽度与 [`engine`] 里那一行**仅在改过设置时**才打的 stderr 说明——用户在
 //! 慢链路上改完设置，得能在终端里看见引擎实际拿到了什么（P21 的验收判据；为什么不是写
@@ -26,7 +31,7 @@ use std::sync::Arc;
 
 use unlucky_core::download::config::{
     DownloadTuning, RawTuning, KEY_CHUNK_STALL, KEY_CONCURRENCY, KEY_GH_PROXY,
-    KEY_RESPONSE_TIMEOUT, KEY_RETRY_LIMIT, KEY_THROUGHPUT_FLOOR,
+    KEY_MIRROR_PREFERENCE, KEY_REGION, KEY_RESPONSE_TIMEOUT, KEY_RETRY_LIMIT, KEY_THROUGHPUT_FLOOR,
 };
 use unlucky_core::download::{shared, DownloadEngine};
 use unlucky_core::setting::keys::launcher_schema;
@@ -34,7 +39,7 @@ use unlucky_core::setting::store::SettingStore;
 
 use crate::context::Ctx;
 
-/// 从 CLI 自己的 setting store 读下载调优（`launcher.json` 的六个 `download.*` 键）。
+/// 从 CLI 自己的 setting store 读下载调优（`launcher.json` 的八个 `download.*` 键）。
 ///
 /// 读的是 `ctx.launcher_config()`——与 `ull config set download.concurrency` 的落点同一份文件
 /// （设置键的落点分流见 [`Ctx::setting_path_for`]）。gh-proxy 空串 = 跟随内置默认，**不是**关。
@@ -42,6 +47,11 @@ use crate::context::Ctx;
 /// **本函数只做「取裸值」**：默认值、区间、回落、KiB→字节的换算全在 core 的
 /// [`DownloadTuning::from_raw`]（M292 起宿主不再逐个判断，也不再自己决定缺省值——那是「UI 说 8、
 /// 引擎跑 64」长回来的地方）。
+///
+/// M294 r1：`download.region` / `download.mirror_preference` 也在这里读，但**不经过
+/// [`RawTuning`]**——那两个是枚举，翻译层是 core 的 [`DownloadTuning::with_source_selection`]
+/// （未知值回落 `auto`）。CLI 与 presenter 走的是同一个入口，别在宿主里再写一份字符串匹配：
+/// 两份口径就是「GUI 认、CLI 不认」的下一次复发。
 #[must_use]
 pub(crate) fn tuning(ctx: &Ctx) -> DownloadTuning {
     let store = SettingStore::load(ctx.launcher_config(), launcher_schema());
@@ -58,6 +68,10 @@ pub(crate) fn tuning(ctx: &Ctx) -> DownloadTuning {
         stall_timeout_secs: doc.effective_i64(KEY_CHUNK_STALL),
         response_timeout_secs: doc.effective_i64(KEY_RESPONSE_TIMEOUT),
     })
+    .with_source_selection(
+        doc.effective_str(KEY_REGION),
+        doc.effective_str(KEY_MIRROR_PREFERENCE),
+    )
 }
 
 /// 生效值那一行说明，**只在改过设置时**给：`None` = 全是出厂值，没什么可说的。

crates/cli/src/download/tests.rs

@@ -343,3 +343,49 @@ fn the_timeout_settings_reach_the_engine_and_the_console_line() {
     assert_eq!(super::tuning(&ctx), DownloadTuning::default());
     assert!(super::announce(&super::tuning(&ctx)).is_none());
 }
+
+/// 一个 URL 在 CLI 装配出来的引擎里的**源名顺序**（`plan()` 是引擎真正的选源决策点）。
+fn plan_sources(engine: &DownloadEngine) -> Vec<String> {
+    let url = "https://libraries.minecraft.net/com/google/guava/guava/32.0.0/guava-32.0.0.jar";
+    let dest = std::env::temp_dir().join("ull-cli-plan-guava.jar");
+    let request = DownloadRequest::new(ResourceKind::Library, url.to_string(), dest);
+    engine
+        .plan(&request, 0)
+        .into_iter()
+        .map(|c| c.source)
+        .collect()
+}
+
+/// **M294 r1（P2-1）**：两键进 CLI 四条命令的生产装配点，终端那行说明也含它们。
+///
+/// 判据是**候选顺序**：两段都让设置与探测结论相反，没接上时必红（变异：`download-settings.md` M15）。
+#[test]
+fn the_source_selection_settings_reach_the_cli_engine() {
+    use unlucky_core::download::region::{store_cached, RegionProfile};
+
+    let dir = TempDir::new("source-selection");
+    let ctx = ctx_at(&dir);
+    let cache = ctx.layout().cache();
+    std::fs::create_dir_all(&cache).expect("建缓存根");
+    let now = unlucky_core::download::cache::now_ms();
+    let region_json = cache.join("region.json");
+
+    // 探测=镜像优先 + 设置 official ⇒ 官方第一条（未接线时是 bmclapi）。
+    store_cached(&region_json, &RegionProfile::mirror_first(now)).expect("档案");
+    let mirror = json!({ "download": { "mirror_preference": "official" } });
+    write_launcher_config(&ctx, mirror);
+    let engine = crate::commands::install::build_engine(&ctx);
+    assert_eq!(plan_sources(&engine), ["official", "bmclapi"], "官方第一条");
+    let line = super::announce(&super::tuning(&ctx)).expect("该有一行");
+    assert!(line.contains("镜像偏好=official"), "{line}");
+    assert!(line.contains("地区=auto"), "{line}");
+
+    // 探测=直连 + 设置 cn ⇒ 镜像第一条（未接线时是 official）。
+    store_cached(&region_json, &RegionProfile::direct(now)).expect("档案");
+    write_launcher_config(&ctx, json!({ "download": { "region": "cn" } }));
+    let engine = crate::commands::install::build_engine(&ctx);
+    assert_eq!(plan_sources(&engine), ["bmclapi", "official"], "镜像第一条");
+    let line = super::announce(&super::tuning(&ctx)).expect("该有一行");
+    assert!(line.contains("地区=cn"), "{line}");
+    assert!(line.contains("镜像偏好=auto"), "{line}");
+}

crates/core/src/download/config/tuning.rs

@@ -177,9 +177,11 @@ impl DownloadTuning {
     /// 存在的理由就是 P21 的验收判据：用户改完设置之后，得在 `logs/launcher.log` 里**看见**生效值，
     /// 而不是只有「我以为我改了」。字段顺序与 `EngineConfig` 一致，单位写在名字里。
     ///
-    /// M294 的两个「源选择」键**故意不在这一行里**：这一行唯一的读者是 CLI，而 CLI 的 `tuning()`
-    /// 还没读那两个键——印一句 `地区=auto` 对文件里写着 `cn` 的用户就是新的假话。等 CLI 接线
-    /// （见 `with_source_selection` 的说明）再一起加。
+    /// M294 r1：两个「源选择」档位（`地区` / `镜像偏好`）也在这里——CLI 的
+    /// `download::tuning` 已经读了它们，这一行若不含就等于「打了一行说生效值、却少说两项」。两个值都用
+    /// [`RegionPreference::as_str`] / [`MirrorPreference::as_str`]，与 schema 的取值逐字相同。
+    ///
+    /// （`crates/cli/src/download.rs::tuning` 是唯一读者。）
     #[must_use]
     pub fn summary(&self) -> String {
         let gh_proxy = match &self.gh_proxy {
@@ -188,12 +190,14 @@ impl DownloadTuning {
             GhProxyOverride::Prefix(prefix) => prefix.clone(),
         };
         format!(
-            "并发={} 单源尝试={} 吞吐下限={}KiB/s 无进展窗口={}s 单次请求上界={}s gh_proxy={gh_proxy}",
+            "并发={} 单源尝试={} 吞吐下限={}KiB/s 无进展窗口={}s 单次请求上界={}s 地区={} 镜像偏好={} gh_proxy={gh_proxy}",
             self.max_concurrency,
             self.max_attempts_per_source,
             self.min_avg_throughput / 1024,
             self.chunk_stall_timeout.as_secs(),
             self.response_timeout.as_secs(),
+            self.region.as_str(),
+            self.mirror_preference.as_str(),
         )
     }
 

crates/core/src/download/preference/tests.rs

@@ -193,3 +193,35 @@ fn the_settings_reach_the_engines_candidate_plan() {
 
     std::fs::remove_dir_all(&dir).ok();
 }
+
+/// **叠加次序**（r1 复审 P3-2）：`gh_proxy` 三态在源选择**之后**叠，所以
+/// 「`region=cn`（⇒ 镜像优先）+ `gh_proxy=off`」⇒ 一个 gh-proxy 候选都不生成。
+///
+/// 这条此前只靠读 `apply_source_selection` 的实现，没有断言。变异证明：把
+/// `apply_source_selection` 写成 `preference::apply(self.apply_gh_proxy(p), …)`（先 gh_proxy 后
+/// 源选择）⇒ 前缀被重判成内置默认，`off` 那一段红。
+#[test]
+fn an_explicit_gh_proxy_off_wins_over_a_mirror_first_region() {
+    use crate::download::config::GhProxyOverride;
+
+    let url = "https://github.com/o/r/releases/download/v1/a.jar";
+    let sources = |tune: &DownloadTuning| -> Vec<String> {
+        let profile = tune.apply_source_selection(RegionProfile::direct(0));
+        MirrorTable::builtin()
+            .expand(url, ResourceKind::GitHubRelease, &profile)
+            .into_iter()
+            .map(|candidate| candidate.source)
+            .collect()
+    };
+
+    // 基线：`region=cn` 让档案变镜像优先，GitHub 资源因此套上内置前缀。
+    let mut tune = DownloadTuning::default().with_source_selection(Some("cn"), None);
+    assert_eq!(sources(&tune), ["gh_proxy", "official"]);
+
+    // 同一次设置里再写 `off`：它最后叠 ⇒ 前缀被清掉，候选链只剩官方。
+    tune.gh_proxy = GhProxyOverride::Off;
+    let off = tune.apply_source_selection(RegionProfile::direct(0));
+    assert_eq!(off.mode, RegionMode::MirrorFirst, "off 不该改「谁在前」");
+    assert_eq!(off.gh_proxy, None, "off 必须清掉前缀");
+    assert_eq!(sources(&tune), ["official"]);
+}

crates/core/src/download/shared.rs

@@ -139,7 +139,8 @@ pub fn constructions(cache_root: impl AsRef<Path>) -> usize {
         .unwrap_or(0)
 }
 
-/// 真实构造（**presenter 侧**唯一一处 `DownloadEngine::new` 的宿主装配；CLI 走 [`engine_with_tuning`]）。
+/// 真实构造（**共享引擎**这一处的宿主装配：presenter 主路径与 CLI 都走它，CLI 经 [`engine_with_tuning`]）。
+/// 发布版 GUI 的 JDK 下载页另有一处装配（`app-iced` 的 `…/java/downloads/engine.rs`，要 `with_progress` 拿走引擎）；两处共用同一个源选择翻译层。
 /// 装配参数从该数据根的 [`wanted`] 取，不用裸 `EngineConfig::default()`（M193）：并发 → `Semaphore`
 /// 容量、尝试次数 → `attempts_for()` 上限、gh_proxy/地区/镜像偏好 → 地区档案（`expand()` 只认它）。
 fn build(cache_root: &Path) -> DownloadEngine {