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 下下来并校验」。