From cb3ae8556ba0115a7f2308297bea899b0bc35c8e Mon Sep 17 00:00:00 2001
From: AskaEth <i@yeij.top>
Date: Sat, 7 Nov 2026 09:22:46 +0800
Subject: [PATCH] =?UTF-8?q?docs(core):=20install.rs=20=E6=A8=A1=E5=9D=97?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3=E8=A1=A5=E4=B8=8A=20Termux=20=E5=88=86?=
 =?UTF-8?q?=E6=94=AF=E4=B8=8E=E5=B9=B3=E5=8F=B0=E5=8F=82=E6=95=B0=E4=B8=8D?=
 =?UTF-8?q?=E6=97=A9=E9=80=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

拆分后模块文档只描述归档链，读起来像「Termux 也走这条」；补一行说明 Termux 的系统包
分支在链之前，以及 `AdoptiumTarget::host()` 失败已改成每家一条降级原因（不再整体早退）。
---
 crates/core/src/game/java/install.rs | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/crates/core/src/game/java/install.rs b/crates/core/src/game/java/install.rs
index 358b22c..6377579 100644
--- a/crates/core/src/game/java/install.rs
+++ b/crates/core/src/game/java/install.rs
@@ -1,6 +1,7 @@
 //! 托管 JDK 安装编排：发行版回退链 → 下载引擎 → 解压 → `java -version` 验证。
 //!
 //! ```text
+//! [Termux] termux_install::attempt            系统包（.deb）——与下面这条链不共用任何一步
 //! vendor::order(用户优先级, 地区)                  D23 的尝试顺序
 //!   → source::fetch(vendor, major)                查到该家最新 GA（Temurin/Oracle/MS/Zulu）
 //!   → location::JavaInstallRoot::jdk_dir          按落点模式算目录
@@ -13,6 +14,14 @@
 //! **回退的粒度是发行版**（D23）：该家没有这个大版本、镜像全 4xx、sha256 取不到、下载校验失败，
 //! 都记一条降级原因然后换下一家；只有全部失败才整体报错，错误里带上每一跳的原因。
 //!
+//! **平台参数（`AdoptiumTarget::host()`）失败不提前退出**：Termux/Android 这类没有归档产物的
+//! 宿主上，早退只会在错误里留一句「不支持该平台」，看不出是哪几家、各卡在哪；现在它降级成
+//! 每家一条原因，与其它失败同形。
+//!
+//! 这一步**不拼任何镜像 URL**（Oracle 的哈希段不可推导，见 `oracle` 模块）：Temurin 的
+//! GitHub 直链交给 `MirrorTable::expand` 展开成院校镜像，Oracle/MS/Zulu 的链接由各自模块
+//! 从目录页/模板/API 拿到最终形态，引擎只负责「把这个 URL 下下来并校验」。
+//!
 //! 这一步**不拼任何镜像 URL**（Oracle 的哈希段不可推导，见 `oracle` 模块）：Temurin 的
 //! GitHub 直链交给 `MirrorTable::expand` 展开成院校镜像，Oracle/MS/Zulu 的链接由各自模块
 //! 从目录页/模板/API 拿到最终形态，引擎只负责「把这个 URL 下下来并校验」。