AskaEth/Unlucky-Launcher
1
0 Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
820 Commits 3 Branches 7 Tags
2ecb33afaed653a021ef560c9708aa127fdf5d40
Commit Graph
4 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
worker-javapin a0aeccf303 fix(java): 把「这一页不存在」与「这一页读不懂」分开，解析失败不再被当成翻到尾巴（M280 r3） 
r3 复审 p2-1items：r2 的吞判据按 `JavaErrorKind` 判，而 `Metadata` 这个桶里除了
404/410 与 200+空体，还装着**解析失败**（`parse_release_list`）⇒ 第二页起上游回
「看得懂的状态码 + 读不懂的内容」时，清单被静默截断且标成 `Complete`，用户看到的是
「这个 major 没有版本 X（可用：…）」，而 X 其实在上游。

## 修法：语义信号代替错误种类（复审判据里没选字面方案，选了改动面最小的等价实现）
`fetch_page` 的返回类型变成 `Result<Option<Vec<String>>, JavaError>`，`None` 只由
**新的纯函数 `page_outcome(status, body)`** 产生：404/410 或 200+空体。判据是状态码 +
体形状，**不匹配任何错误文案**。

- `page > 0` 的 `None` ⇒ 翻到尾巴：交回已取到的全部，`truncated = false`（r2 已做对，保留）；
- `page == 0` 的 `None` ⇒ 这个大版本真没有 GA 清单：仍然 `Err`（与 r2 之前同口径，
  只是判据从「错误种类」换成「哪一页不存在」）；
- **任何页的解析失败 / 非 2xx 非 404 / 网络错误 ⇒ 一律 `Err`**（不再有「读不懂 ⇒ 没有更多」）；
- 错误落在最后一页也是 `Err`，不可能再报 `Complete`。

`api/version.rs` 里新增 `page_outcome`（纯）+ `fetch_release_page`（HTTP 那一跳，判定全交给前者），
`fetch_version` 的闭包改调 `fetch_release_page`。只动本 mission scope 内的两个文件，
没有改 `net.rs`，也没有给跨 crate 匹配的 `JavaErrorKind` 加变体（cli / app-iced 的 match 不变）。

## 用例（离线；每条都有能变红的变异）
- `a_missing_page_after_a_full_page_ends_the_tail_cleanly`（判据 1）：page0=20 条、page1=None
  ⇒ `Ok((20, false))`，逐条相等、`calls == 2`；
- `a_missing_page_is_404_410_or_an_empty_body_and_nothing_else`：404/410/200+空白 ⇒ `None`；
  正常 JSON ⇒ `Some(names)`；`<html>502</html>` ⇒ `Err(Metadata)`；500/403/429/502 ⇒ `Err(Network)`；
- `a_parse_failure_on_a_later_page_is_an_error_not_the_end_of_the_list`（判据 2）：夹具用**真的**
  `parse_release_list("<html>502</html>").unwrap_err()` ⇒ 必须 `Err`，且报的是解析失败本身；
  `Err` 分支在签名上就带不出部分结果；
- `an_error_on_the_last_allowed_page_is_never_reported_as_complete`（判据 3）：错误落在
  `page == MAX_PAGES-1` ⇒ 必须 `Err`，不许 `Ok((_, false))`；
- `a_missing_first_page_is_still_an_error`：第一页就不存在 ⇒ `Err`；
- `a_network_error_on_a_later_page_is_not_swallowed`：网络错误照抛。

变异（做完都还原，`git status` 干净）：R3-A 把 page>0 的 None 当失败 ⇒ 判据 1 那条红；
R3-B 把 Metadata 重新并进吞掉的分支 ⇒ 判据 2/3 两条红（panic 原文就是 `(…20 条…, false)`，
即复审实测的那个 bug）；R3-C 把 `page_outcome` 的解析失败并成 `None` ⇒ 底座那条红。

## 顺带两条（复审 P3）
- P3-1：报告里「钉住上游越界页就是 404」那句改成正确表述（夹具手写，钉的是「收到『这一页
  不存在』要把已取到的交出去」）；`--lib` 数字按 tip 重数（`aac0eef` 上是 880，本轮 +3 ⇒ 883）。
- P3-2：删掉 `catalog/tests.rs` 里冗余的否定式断言（紧邻的正向断言已蕴含它），
  保留两条正向断言（`Adoptium 里可用` / `Oracle 镜像目录里可用`）。

门禁（CARGO_TARGET_DIR=C:/Temp/ull-target/wt-280）：core --lib 883 / --test game 120 /
--test launch 91、cli --all-targets、fmt --check、clippy -D warnings 全部 EXIT=0。
 2026-11-12 22:34:07 +08:00
worker-javapin aac0eef1b8 fix(java): 越界页 404 不许作废已取到的清单 + 三处文档/文案（M280 r2） 
r2 复审 p2-1items / fix-then-merge，只做指定的四项。

## P2-1 满页收尾会多打一页 404，把前几页一起丢掉
`collect_releases` 原来靠「本页不满 PAGE_SIZE」收尾；某条 GA 线的条数恰好是 20 的倍数时
最后一页是满页 ⇒ 会多要一页 ⇒ Adoptium 对越界页回 **HTTP 404 + 空体**（实测，不是空数组）
⇒ 那一页的 Metadata 错误把**已经取到的前几页**一起作废，整条 `--version` 路径失败。

- `page > 0` 的 Metadata（404 / 空响应）视为「翻到尾巴」：返回已取到的全部 + `truncated=false`；
- `page == 0` 的 404 仍然报错（那才是「这个 major 没有 GA 清单」）；
- **网络错误**（`JavaErrorKind::Network`）在任何一页都不被吞，照样冒泡。

用例（全离线，注入夹具）：
- `a_404_on_the_page_after_a_full_page_ends_the_tail_cleanly`：page0=Ok(20 条)、
  page1=Err(Metadata 404) ⇒ 断言 `Ok((20 条, false))` 且 `calls == 2`（把「今天上游越界页就是 404」钉住）；
- `a_404_on_the_first_page_is_still_an_error`：page0 就 404 ⇒ 必须 `Err`；
- `a_network_error_on_a_later_page_is_not_swallowed`：page1 网络错误 ⇒ 必须 `Err`。

## P3-1 `install/plan.rs` 文档与事实矛盾
改成如实描述：搬移的直接原因（400 行硬线）+ **三处语义变化**（签名接 `&InstallRequest`、
函数体改走 `chain_fetch` 与 `install` 共用同一份判据、`request.priority` 现在参与选择顺序）。

## P3-2 `api.rs` 头注释
补一句：latest 那条走本模块，「指定版本」走子模块 `version`（`feature_releases` 翻页枚举 →
`assets/release_name`），两者共用同一套响应结构。

## P3-3 Oracle 拒绝文案多一个空格
`source` 自带连接词（`Adoptium 里` / `Oracle 镜像目录里`），模板改成 `（{source}可用：…）`。
真机：`（Oracle 镜像目录里可用：21.0.2 / 21.0.1 / 21）`、`（Adoptium 里可用：… 等 26 个）`。
用例补三条断言钉住这两种拼法，并断言 Oracle 那句不许出现「镜像目录 里」。

门禁（CARGO_TARGET_DIR=C:/Temp/ull-target/wt-280）：core --lib 873 / --test game 120 /
--test launch 91、cli --all-targets、fmt --check、clippy -D warnings 全部 EXIT=0。
 2026-11-12 22:05:19 +08:00
worker-javapin 1353c044c3 fix(java): Temurin 指定版本要翻页 + 三层「不静默回落」补上守卫（M280 r1） 
复审 r1 判 p2-2items / fix-then-merge。两条都在这轮修掉。

## P2-1 Temurin 只读第一页 ⇒ 上游有的版本被报「没有」
`page_size` 上限 20 是上游硬约束，但 8/11/17 线各有 26 条 GA（实测 17/ga page=0 回
20 条、page=1 回 6 条）。原来只读第一页，`17.0.4` 这种「上游有、第一页没有」的版本
被报成「没有这个版本」，而且「等 20 个」是我们的窗口而不是上游总数。

- `releases_url(major, target, page)` 带页码；`collect_releases(fetch_page)` 是**纯**骨架
  （分页由闭包注入），翻到「本页不满一页」为止，上限 `MAX_PAGES = 5`；
- `fetch_version` 用 `pick_release(&releases, wanted)` 挑（不取最新、不取第一条）；
- 文案：`catalog::VersionListScope::{Complete, Truncated}` +
  `available_versions_text(.., scope)`。完整时说「等 N 个」（= 上游总数），
  到上限时才说「只查了前 N 条，后面可能还有」——不再把窗口当全集。
- 真机复现（复审给的命令）：`17 --version 17.0.4` 现在命中 `17.0.4+8`；
  `17 --version 17` 命中第二页最后一条 `17+35`；`17 --version 17.0.99` 报「等 26 个」。

## P2-2 三层保证一条守卫都没有（复审的变异 A/B/C）
现在每条都有能变红的用例：

| 守卫 | 位置 | 用例 |
| --- | --- | --- |
| Temurin 命中而非取最新 | `api/version.rs::pick_release` | `the_pinned_version_wins_over_the_newest_entry` + 两页用例 |
| 兜底闸（版本必须对上） | `catalog::version_mismatch` | `catalog/tests.rs::the_version_gate_rejects_...` |
| 装配层的「记失败继续走链」 | `install/chain.rs::resolve_one` / `chain_fetch` | `a_release_that_is_not_...`、`a_mismatch_records_a_failure_and_the_chain_moves_on`、`nothing_matching_...` |
| 钉死一家不换家 | `install()` 全链（`--vendor zulu --version`） | `a_pinned_vendor_that_cannot_pin_is_tried_alone`（断言「试过 1」+ `latest=true` + 一个字节没落盘） |

`install` 的循环与 `--dry-run` 的 `plan` 现在**共用同一份判据**（`resolve_one`）：
`install` 逐家调它，`plan` 用 `chain_fetch` 驱动整条链。

## 拆分（守 400 行硬线）
- `catalog.rs` 400 → `catalog.rs` 278 + `catalog/tests.rs` 229（既有 7 条用例搬走，
  唯一差异是新 API 的 `VersionListScope::Complete` 参数）
- `install.rs` → `install/plan.rs`（`plan` 段落；文档与签名原样，函数体改成走
  `chain_fetch`，这正是「同一份判据」的要求）+ `install/chain.rs`（新骨架与守卫，
  `install.rs` 361 行）
- `api/version.rs` 417 → `api/version.rs` 214 + `api/version/tests.rs` 207

## 门禁（CARGO_TARGET_DIR=C:/Temp/ull-target/wt-280）
core --lib 870 / --test game 120 / --test launch 91、cli --all-targets、fmt --check、
clippy -D warnings 全部 EXIT=0。
 2026-11-12 22:05:19 +08:00
worker-javapin 9fded45d9e feat(java): --version 指定 JDK 版本（Temurin/Oracle 能，MS 只认快照，Zulu 报错）+ --dry-run（M280） 
用户原话：「我们内置了那么多镜像源 甚至用户不能手动选择指定版本下载。」这条之前
`InstallRequest` 根本没有版本字段，四家全是「该 major 最新 GA」。

core：
- `InstallRequest.version: Option<String>` + `with_version`；`None` 时仍走 `source::fetch`
  的老路径（`latest_url` / `parse_latest` / `fetch_latest` 一个字节未动）。
- `source::fetch` 在唯一分派点按 `Option<&str>` 分两路：`latest` 与 `pinned`，后者绝不换家。
- Temurin（新 `api/version.rs`）：先 `assets/feature_releases/{major}/ga` 枚举（`page_size`
  上限 20），把用户给的公共版本号翻成 release 名，再打 `assets/release_name/eclipse/{name}`
  取归档——不走 `latest`。实测 `/v3/assets/version/{v}` 在线上回 404，故不用它（见报告）。
- Oracle：`versions_for` 接进选择路径（`select_version`），`None` 仍是 `pick_version`。
- Microsoft：只认写死快照里那一个版本号，别的版本明确报错并说清「这家不能自选版本」。
- Zulu / Termux：上游只有 latest / 版本由系统包定 → 明确报错，不回落、不换家。
- `catalog.rs` 收策略：`matches_version`（唯一相等判据，不做前缀近似）、
  `version_pin_error`（四家文案互不相同且各自说清原因 + 下一步）、`version_mismatch`
  （兜底闸：装到的版本必须真是用户要的那一版）。
- `plan()` 改成接 `&InstallRequest`，`--dry-run` 与真装走同一条选择路径。

cli：
- `java install <major> [--version V] [--dry-run] [--vendor X]`；`--json` 增 `requested_version`。
- 全局 `--version` 只在子命令之前成立，否则 `java install 21 --version 21.0.13+9` 会被
  当成「打印启动器版本」吞掉。

拆分（守 400 行硬线，均为纯搬移 + 逐字节核对）：
- `api.rs` → `api/version.rs`、`oracle.rs` → `oracle/listing.rs`（纯的那一半）、
  `cli/parse.rs` → `cli/parse/java.rs`、`commands/java.rs` → `commands/java_install.rs`。

门禁（CARGO_TARGET_DIR=C:/Temp/ull-target/wt-280）：core --lib / --test game / --test launch、
cli --all-targets、fmt --check、clippy -D warnings 全部 EXIT=0。
 2026-11-12 22:05:17 +08:00