feat: add official full pull smoke

Emit runtime download progress and validation summaries for official sync.

Add repeatable real-network full pull smoke runbook and script.

Fixes #4

Fixes #6

docs/reports/current-status-handoff.md

@@ -1,13 +1,13 @@
 # 当前进度交接
 
-- **更新时间**：2026-07-06
+- **更新时间**：2026-07-14
 - **状态分支**：`experiment`
-- **最新功能提交**：`789402c feat: add official resource sync pipeline`
+- **最新功能提交**：以当前 `git log --oneline -1` 为准
 - **用途**：给下一次对话快速恢复上下文，优先以当前工作区和已验证结果为准。
 
 ## 1. 现在处在什么阶段
 
-项目已经完成基础整理、CAS V1 和 Rust 官方资源同步闭环。下一阶段重点是 Go CLI 最小可用、真实官方网络 smoke、同步结果进入 CAS/ResourceRepository，以及 AssetBundle 解析起步。
+项目已经完成基础整理、CAS V1、Rust 官方资源同步闭环，以及真实官方网络 smoke 的可重复命令固化。下一阶段重点是 Go CLI 最小可用、同步结果进入 CAS/ResourceRepository，以及 AssetBundle 解析起步。
 
 已确认的事实：
 
@@ -19,6 +19,8 @@
 - 默认平台是 `Windows + Android`。
 - 真实下载会维护 `official-download-manifest.json`，并使用 size + BLAKE3、本地 audit/repair 和官方 seed `.hash` 校验。
 - `--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` 隔离目录。
 
 ## 2. 现在不要误解的点
 
@@ -34,7 +36,7 @@
 仍待实现的主线工作：
 
 1. Go CLI 最小入口：`bat doctor`、`bat sync --help`、`bat official sync --help`。
-2. 真实官方网络 smoke：dry-run、首次下载、二次 up-to-date、本地损坏 repair。
+2. 按 smoke runbook 在具备网络和磁盘窗口的环境中执行真实官方网络 smoke，并保留隔离目录报告。
 3. 官方同步下载结果进入 CAS + `SqliteResourceRepository` 的用户级流程。
 4. Addressables parser 覆盖更多真实 catalog 结构。
 5. AssetBundle UnityFS header/block/directory 解析。
@@ -57,4 +59,5 @@
 - `DOCS_INDEX.md`
 - `docs/reports/CURRENT_GAPS.md`
 - `docs/guides/official-resource-test-pull.md`
+- `docs/guides/official-full-pull-smoke.md`
 - `docs/architecture/official-resource-backend.md`