fix: classify official download failures

Distinguish terminal HTTP errors from retryable CDN/network failures, record quarantined resources, and report failed download progress.

Fixes #7

docs/reports/CURRENT_GAPS.md

@@ -344,6 +344,32 @@
 - 脚本退出码为 0 即表示 runbook 验收通过。
 - 真实网络执行需要外部网络和足够磁盘空间；本仓库只保存 runbook、脚本和测试，不保存官方大文件。
 
+### G-019：下载失败重试策略不够精细
+
+状态：**已关闭**
+
+历史现象：
+
+- curl 失败只按固定次数重试，错误信息主要保留最后一次 stderr。
+- 403/404 和 5xx 没有不同处理。
+- 单个 URL 长期失败时缺少可查询的 quarantine 诊断状态。
+- 旧 launcher 包下载虽然有 primary/backup CDN 路径，但失败信息没有统一分类。
+
+处理结果：
+
+- 新增统一 curl 失败分类：`http_forbidden`、`http_not_found`、`http_client_error`、`http_too_many_requests`、`http_server_error`、`dns`、`connect`、`timeout`、`tls`、`interrupted`、`network` 等。
+- 403/404/普通 4xx 视为不可重试并提前停止；5xx、429、DNS、连接、超时、中断和网络类错误按尝试次数重试。
+- 单个资源 URL 最终失败会写入 `official-download-quarantine.json`，记录失败类型、HTTP 状态、是否可重试、尝试次数和最后错误。
+- 失败 URL 会发出 Failed progress，daemon status 和 `bat-events.jsonl` 暴露失败类型、HTTP 状态、重试属性和 quarantine 状态。
+- quarantine 会中断同步并阻止发布不完整 staging；下一轮成功下载或复用后清理对应 quarantine 条目。
+- 旧 launcher 包或 `resources.assets` 下载在 primary CDN 失败后会切换官方 backup CDN。
+
+验收：
+
+- HTTP 404 不重试，写入 quarantine，manifest 不写失败项。
+- HTTP 5xx 重试到上限后写入 quarantine。
+- launcher primary CDN 失败后会尝试官方 backup CDN。
+
 ---
 
 ## 6. 当前关闭顺序建议

docs/reports/current-stage-prepush.md

@@ -25,7 +25,8 @@
 - `bat-cas-engine` CAS V1。
 - `bat-adapters` 官方日服 URL 规则、server-info 解析、平台 discovery、inventory 枚举。
 - `AddressablesCatalogDriver` 对当前真实形态 fixture/golden 的解析。
-- `OfficialResourcePullService` 的官方 URL 拒绝、`.part` 续传、重试、本地 manifest、官方 seed `.hash` 校验。
+- `OfficialResourcePullService` 的官方 URL 拒绝、`.part` 续传、403/404/5xx 分类重试、下载 quarantine、本地 manifest、官方 seed `.hash` 校验。
+- 旧 launcher 包或 `resources.assets` 下载的官方 primary/backup CDN 切换。
 - `OfficialUpdateService` 的 auto-discover、bootstrap cache、v2 snapshot、remote marker diff、本地 audit/repair。
 - `bat` one-shot 和 `--watch`。
 - `bat` 运行时 progress log 覆盖总体下载进度、单文件进度和校验结果摘要。

docs/reports/current-status-handoff.md

@@ -18,6 +18,8 @@
 - `--auto-discover` 通过官方 HTTP metadata 和临时目录解析 `GameMainConfig`。
 - 默认平台是 `Windows + Android`。
 - 真实下载会维护 `official-download-manifest.json`，并使用 size + BLAKE3、本地 audit/repair 和官方 seed `.hash` 校验。
+- 下载失败会按 403/404/5xx/网络类型分类；最终失败写入 `official-download-quarantine.json` 并阻止发布不完整资源。
+- 旧 launcher 包或 `resources.assets` 下载使用官方 primary/backup CDN 切换。
 - `--watch` 是 Rust 内部常驻检查模式，正常检查默认 1 小时，失败重试默认 60 秒；外部 systemd/container 只负责守护进程。
 - `bat` progress log 会输出总体下载进度、单文件进度和校验结果摘要。
 - 真实官方网络 smoke 已固化为 `scripts/official-full-pull-smoke.sh`、`make official-smoke` 和 `docs/guides/official-full-pull-smoke.md`，默认写入 `/tmp` 隔离目录。