  nyaKazuhaandClaude Fable 5
|
e9b7ce219f
|
fix(official-sync): 修正对抗性审查发现的 launcher 链错误码误归类
对 d2466d6 做三视角对抗性核查（错误码语义/消费者破坏面/测试与文档），
确认 8 项（去重后 5 类）误归类，全部集中在 official_game_main_config
的 From<String> 兜底面。逐项修正：
- launcher_package_url 改返回 DownloadError：非官方 CDN 根（来自远端
API 响应，安全边界拒绝）→ NON_OFFICIAL_URL；非法包路径（来自远端
manifest 内容）→ LAUNCHER_RESPONSE_INVALID。此前提交说明称其为
"硬编码常量上的内部不变量"不成立——三个生产调用点传入的都是远端
API 下发的 cdn_root。
- select_game_main_config_source / find_resources_assets：目录 source
缺 resources.assets 条目、无可用游戏包路径、包内容缺必需文件均为
远端可触发的内容缺陷 → LAUNCHER_RESPONSE_INVALID（此前落 INTERNAL，
且官方 manifest 布局已演进过一次，是现实的主要失败面）。
- extract_archive 解压失败 → ZIP_STRUCTURE_INVALID：结构校验不覆盖
压缩数据流，数据区损坏（bad CRC）在 unzip 阶段首次暴露，主导成因
是损坏/截断下载，归完整性域；本地原因保留在 stderr 消息中。
- verify_manifest_file_size 三种失败分码：size 字段无效 →
LAUNCHER_RESPONSE_INVALID、本地读文件失败 → INTERNAL、真正不符 →
SIZE_MISMATCH（此前三者统归 SIZE_MISMATCH）。
- 空 --launcher-version（用户 CLI 输入）→ INVALID_ARGUMENT，在发起
任何请求前拒绝（此前落 INTERNAL）。
- 统一 launcher 链内容口径：API 响应、远端 manifest、包内容的解析/
缺失问题全部归 LAUNCHER_RESPONSE_INVALID(600004)，
MANIFEST_PARSE_FAILED(600001) 保留给资源侧 manifest/catalog；
fetch_remote_manifest 两处 600001 改 600004，error_code.rs 注释与
USERGUIDE 描述同步。
- download_file_with_fallback：备用 URL 构造失败不再经 `?` 丢弃主地址
失败上下文，错误码与"两次都失败以最终一次为准"策略一致。
新增 7 个错误码断言测试（launcher_package_url 两类拒绝、空版本、
manifest 无条目、fallback 终码保留、fallback 构造失败保留主上下文、
select/verify/extract 各失败面）。全量 fmt / clippy --workspace
--all-targets -D warnings / test --workspace 全绿。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-07-17 09:42:17 -07:00 |
|
|
nyaKazuhaandClaude Fable 5
|
d2466d60db
|
feat(official-sync): 错误码模型铺开到 launcher/metadata 拉取路径
此前统一错误码只覆盖资源下载路径，launcher/metadata 链
（fetch_game_config → manifest URL → remote manifest → resources.assets
→ GameMainConfig）整条返回 Result<_, String>，经 anyhow::Error::msg
抹成无类型消息，RPC/任务层只能标为 internal。
本次将该链整体改为 Result<_, DownloadError>：
- core 新增两个错误码：LAUNCHER_API_REJECTED（300031，官方启动器 API
返回非 200 业务码）与 LAUNCHER_RESPONSE_INVALID（600004，响应无法
解析或缺少必需字段），并纳入唯一性测试；
- official_launcher：curl 失败保留准确网络域码（403/404/DNS/超时/TLS/
代理等，final_error_code()），API 非 200 → LAUNCHER_API_REJECTED，
响应解析/缺字段 → LAUNCHER_RESPONSE_INVALID，非官方 manifest URL →
NON_OFFICIAL_URL，manifest 无文件条目 → MANIFEST_PARSE_FAILED，
空版本/路径入参 → INVALID_ARGUMENT；
- official_game_main_config：下载失败带网络域码（主/备 CDN 均失败时
以最终一次为准），ZIP 结构 → ZIP_STRUCTURE_INVALID，manifest 大小
不符 → SIZE_MISMATCH，GameMainConfig 解密/解析 →
GAME_MAIN_CONFIG_FAILED，manifest 缺 source →
LAUNCHER_RESPONSE_INVALID；
- official_update 两处调用改 anyhow::Error::msg → anyhow::Error::new，
保留类型，task worker 现有 downcast 直接接住 launcher 路径错误码；
- USERGUIDE 错误码表补录 300031 与 600004。
内部工具函数（launcher_package_url / launcher_api_url /
launcher_authorization_header）仍返回 String，经 From<String> 归
INTERNAL——这些是硬编码常量上的内部不变量校验，非运行时主要失败面。
验证：新增 4 个单测断言映射（API 403 业务码 → 300031、非法 JSON →
600004、HTTP 404 → 300002、非官方 URL → 300030）；全量
fmt / clippy --workspace --all-targets -D warnings / test --workspace
全绿（含 examples 编译）。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-07-17 08:29:16 -07:00 |
|
|
nyaKazuha
|
c123f6c0dc
|
feat(official-sync): 支持本地代理下载官方资源
|
2026-07-16 00:12:27 +08:00 |
|
|
nyaKazuha
|
4192d7ee4c
|
fix: classify official download failures
Distinguish terminal HTTP errors from retryable CDN/network failures, record quarantined resources, and report failed download progress.
Fixes #7
|
2026-07-14 01:30:12 +08:00 |
|
|
nyaKazuha
|
f7255f7c04
|
feat: improve bat daemon cli output
|
2026-07-12 23:04:13 +08:00 |
|
|
nyaKazuha
|
b2d6871926
|
fix: harden official resource sync retries
|
2026-07-07 01:14:54 +08:00 |
|
|
nyaKazuha
|
adc1cd5b91
|
feat: prepare experiment push package
|
2026-06-30 00:08:36 +08:00 |
|