feat(m193): 下载并发/重试/gh-proxy 真接进引擎（schema 与引擎同源常量）
- download.concurrency / download.retry_limit 以前引擎侧零消费者（恒用 EngineConfig::default() 的 64，而 schema 说 8）。现在默认值与硬上限收成 download/config.rs 的常量，schema、EngineConfig::default()、Semaphore 容量 三处同源；宿主把三个键翻译成 DownloadTuning 后经 shared::set_tuning（按数据根） 灌进装配点，改了设置下一次取引擎就生效。 - download.gh_proxy 三态（留空=跟随内置默认 / off=关 / 前缀=覆盖）下沉到 shared::build，所有走共享引擎的下载路径（内容库/版本清单/字体/安装）一致。 - 删掉 MirrorTable::set_gh_proxy 与 default_gh_proxy 两个改了没用的入口。 - 下载设置页把三条假演示值换成说语义的中文行（含三态说明与 1~64 硬上限）。 - 守卫：探针读 Semaphore 真实许可数（不是读配置），每条配变异证明。 - docs/download-settings.md 记下取证表（另四个键仍零消费，已立 finding）。
This commit is contained in:
worker-dlmsettings authored and AskaEth committed
1 parent
98262d3835
commit
e8544b19a7
15 files changed
+958
-200
No files matched your search
@@ -0,0 +1,174 @@
|
||||
//! 设置页「下载」分组 + 下载调优的**宿主侧翻译**（M193）。
|
||||
//!
|
||||
//! ## 为什么单开一个文件
|
||||
//!
|
||||
//! 同 `host/settings_tests.rs` 的理由：`host/settings.rs` 正好顶在 400 行硬线上，而本轮要往这一组加
|
||||
//! 「`download.gh_proxy` 三态行 + 并发硬上限说明 + 调优翻译」约 24 行。不拆就得砍 `settings.rs` 里
|
||||
//! 那些**留着防复发**的论证注释（`ai_group` 的 M174 回归说明、`parse_value` 的 P1-1 浮点键事故）
|
||||
//! ——那比多一个文件糟得多。搬出来还有一个附带好处：这一组是**唯一**要往 core 灌下载调优的一组，
|
||||
//! 代码与它的守卫（`settings_tests.rs`）现在挨在一起。
|
||||
//!
|
||||
//! ## 谁在读 / 谁在写
|
||||
//!
|
||||
//! ```text
|
||||
//! config/launcher.json ←── store.set（`settings::set`，本模块只读）
|
||||
//! download.concurrency ─┐
|
||||
//! download.retry_limit ─┼─→ DownloadTuning（core 决定默认值与夹取）─→ shared::set_tuning
|
||||
//! download.gh_proxy ───┘ （引擎重建时生效）
|
||||
//! ```
|
||||
//!
|
||||
//! **调优的同步点是显式的**：`host/engine.rs` 每次取引擎前、`dispatch.rs` 的 `SetSetting` 分支里，
|
||||
//! 都调 [`apply_tuning`]（幂等：值没变就什么都不做）。它**不是**藏在某个读函数里的副作用——
|
||||
//! 「读起来是纯读、实际改全局状态」正是本仓吃过亏的那类形状。
|
||||
|
||||
use unlucky_core::download::config::{
|
||||
DownloadTuning, DEFAULT_MAX_ATTEMPTS_PER_SOURCE, DEFAULT_MAX_CONCURRENCY,
|
||||
};
|
||||
use unlucky_core::download::shared;
|
||||
|
||||
use crate::dto::{SettingGroupView, SettingRowView};
|
||||
|
||||
use super::super::env::HostEnv;
|
||||
use super::{int, selected, text};
|
||||
|
||||
/// 并发数的推荐档位（`selected()` 找不到时回 0；手改出来的非档位值会被插进选项表，见 [`group`]）。
|
||||
const CONCURRENCY_LADDER: [&str; 5] = ["4", "8", "16", "32", "64"];
|
||||
/// 单源尝试次数的推荐档位。
|
||||
const RETRY_LADDER: [&str; 5] = ["1", "2", "3", "5", "10"];
|
||||
|
||||
/// 下载（D7）：并发/重试/地区/镜像偏好/代理/GitHub 加速前缀。
|
||||
pub(super) fn group(env: &HostEnv) -> SettingGroupView {
|
||||
let concurrency = int(
|
||||
env,
|
||||
unlucky_core::download::config::KEY_CONCURRENCY,
|
||||
DEFAULT_MAX_CONCURRENCY as i64,
|
||||
)
|
||||
.to_string();
|
||||
let retry = int(
|
||||
env,
|
||||
unlucky_core::download::config::KEY_RETRY_LIMIT,
|
||||
i64::from(DEFAULT_MAX_ATTEMPTS_PER_SOURCE),
|
||||
)
|
||||
.to_string();
|
||||
let concurrency_options = ladder(&CONCURRENCY_LADDER, &concurrency);
|
||||
let retry_options = ladder(&RETRY_LADDER, &retry);
|
||||
let concurrency_options: Vec<&str> = concurrency_options.iter().map(String::as_str).collect();
|
||||
let retry_options: Vec<&str> = retry_options.iter().map(String::as_str).collect();
|
||||
let regions = ["auto", "cn", "global"];
|
||||
let mirrors = ["auto", "official", "mirror"];
|
||||
let proxies = ["none", "system", "manual"];
|
||||
let region_value = text(env, "download.region");
|
||||
let mirror_value = text(env, "download.mirror_preference");
|
||||
let proxy_value = text(env, "download.proxy_mode");
|
||||
SettingGroupView::new("download", "下载与镜像（D7）")
|
||||
.with(SettingRowView::choice(
|
||||
unlucky_core::download::config::KEY_CONCURRENCY,
|
||||
"并发数",
|
||||
"同时下载的文件数：出厂 8，可调 1~64（引擎硬上限 64，防止填 9999 把机器拖死）；越界或手改坏值按出厂值生效",
|
||||
&concurrency_options,
|
||||
selected(&concurrency_options, &concurrency),
|
||||
))
|
||||
.with(SettingRowView::choice(
|
||||
unlucky_core::download::config::KEY_RETRY_LIMIT,
|
||||
"单源尝试次数",
|
||||
"同一个源最多试几次（含首次；出厂 3）。换源不受此限：候选链上有几个源就各给几次",
|
||||
&retry_options,
|
||||
selected(&retry_options, &retry),
|
||||
))
|
||||
.with(SettingRowView::choice(
|
||||
"download.region",
|
||||
"地区判定",
|
||||
"auto = 时区+语言+探测；决定是否优先国内镜像",
|
||||
®ions,
|
||||
selected(
|
||||
®ions,
|
||||
if region_value.is_empty() {
|
||||
"auto"
|
||||
} else {
|
||||
®ion_value
|
||||
},
|
||||
),
|
||||
))
|
||||
.with(SettingRowView::choice(
|
||||
"download.mirror_preference",
|
||||
"镜像偏好",
|
||||
"auto = 按健康度评分；official = 官方源优先",
|
||||
&mirrors,
|
||||
selected(
|
||||
&mirrors,
|
||||
if mirror_value.is_empty() {
|
||||
"auto"
|
||||
} else {
|
||||
&mirror_value
|
||||
},
|
||||
),
|
||||
))
|
||||
.with(SettingRowView::choice(
|
||||
"download.proxy_mode",
|
||||
"代理模式",
|
||||
"none / system（跟随系统）/ manual（下面填地址）",
|
||||
&proxies,
|
||||
selected(
|
||||
&proxies,
|
||||
if proxy_value.is_empty() {
|
||||
"none"
|
||||
} else {
|
||||
&proxy_value
|
||||
},
|
||||
),
|
||||
))
|
||||
.with(SettingRowView::text(
|
||||
"download.proxy_url",
|
||||
"HTTP 代理",
|
||||
"manual 模式生效；留空则用系统代理",
|
||||
&text(env, "download.proxy_url"),
|
||||
))
|
||||
// M193：gh-proxy 三态。**留空与 off 是两件事**，描述里必须都写出来——用户最容易把
|
||||
// 「我还没决定」当成「我不要加速」，于是以为自己关掉了、实际还在套前缀。
|
||||
.with(SettingRowView::text(
|
||||
unlucky_core::download::config::KEY_GH_PROXY,
|
||||
"GitHub 加速前缀（gh-proxy）",
|
||||
"留空 = 跟随内置默认（镜像优先/国内判定时自动套 gh-proxy.com）；填 off = 关闭（不生成任何 gh-proxy 候选）；填一个 URL 前缀 = 覆盖它",
|
||||
&text(env, unlucky_core::download::config::KEY_GH_PROXY),
|
||||
))
|
||||
.with(SettingRowView::action(
|
||||
super::super::engine::DETECT_REGION_ACTION,
|
||||
"重新检测地区",
|
||||
"清掉 24h 地区缓存，下次下载重新判定",
|
||||
"detect_region",
|
||||
))
|
||||
}
|
||||
|
||||
/// 推荐档位 + 「当前值不在档位里就把它插进去」（否则这一行会把 2 显示成 4 —— 又一个假值）。
|
||||
fn ladder(ladder: &[&str], current: &str) -> Vec<String> {
|
||||
let mut options: Vec<String> = ladder.iter().map(|item| (*item).to_string()).collect();
|
||||
if !current.is_empty() && !options.iter().any(|option| option == current) {
|
||||
options.push(current.to_string());
|
||||
options.sort_by_key(|option| option.parse::<i64>().unwrap_or(i64::MAX));
|
||||
}
|
||||
options
|
||||
}
|
||||
|
||||
/// 从 `launcher.json` 读出下载调优（默认值与夹取口径在 core，本函数只做「取原始值」）。
|
||||
#[must_use]
|
||||
pub(crate) fn tuning_of(env: &HostEnv) -> DownloadTuning {
|
||||
use unlucky_core::download::config::{KEY_CONCURRENCY, KEY_GH_PROXY, KEY_RETRY_LIMIT};
|
||||
let store = env.store();
|
||||
let doc = store.doc();
|
||||
let gh = doc
|
||||
.effective_str(KEY_GH_PROXY)
|
||||
.map(str::to_string)
|
||||
.unwrap_or_default();
|
||||
DownloadTuning::from_settings(
|
||||
doc.effective_i64(KEY_CONCURRENCY),
|
||||
doc.effective_i64(KEY_RETRY_LIMIT),
|
||||
Some(gh.as_str()),
|
||||
)
|
||||
}
|
||||
|
||||
/// 把当前设置灌进 core 的下载调优（按数据根），返回**是否真的变了**（变了就失效该根的引擎）。
|
||||
///
|
||||
/// 幂等：值没变时 `shared::set_tuning` 一行不动，所以「每次取引擎前都调」是安全的。
|
||||
pub(crate) fn apply_tuning(env: &HostEnv) -> bool {
|
||||
shared::set_tuning(env.layout.cache(), tuning_of(env))
|
||||
}
|
||||
Reference in new issue
Block a user