docs: align project status with official sync pipeline

Update the authoritative docs, guides, architecture notes, gap list, deployment guidance, handoff notes, and changelog to reflect the current Rust official resource sync boundary.

docs/reports/current-status-handoff.md

@@ -1,50 +1,60 @@
 # 当前进度交接
 
-**更新时间**：2026-06-30  
-**状态分支**：`experiment`  
-**用途**：给下一次对话快速恢复上下文，优先以当前工作区与已验证结果为准。
+- **更新时间**：2026-07-06
+- **状态分支**：`experiment`
+- **最新功能提交**：`789402c feat: add official resource sync pipeline`
+- **用途**：给下一次对话快速恢复上下文，优先以当前工作区和已验证结果为准。
 
 ## 1. 现在处在什么阶段
 
-当前项目已经完成基础整理和 CAS V1，官方资源链路也已经验证过，下一阶段重点是把“资源同步”从验证推进到可继续扩展的真实实现。
+项目已经完成基础整理、CAS V1 和 Rust 官方资源同步闭环。下一阶段重点是 Go CLI 最小可用、真实官方网络 smoke、同步结果进入 CAS/ResourceRepository，以及 AssetBundle 解析起步。
 
 已确认的事实：
 
-- `cargo test --workspace` 通过。
-- `git status --short --branch` 可用，当前分支为 `experiment`。
+- 当前分支为 `experiment`。
 - `bat-cas-engine` 的 CAS V1 已完成。
-- 官方资源链路已收敛到只接受官方 host，默认验证平台是 `Windows` + `Android`。
-- 真实下载相关测试目前是通过 mock / fixture 验证，不是自动去拉线上全量资源。
+- `bat-official-sync` 是当前官方资源同步正式入口。
+- Linux 生产链路不安装、不启动、不依赖官方启动器。
+- `--auto-discover` 通过官方 HTTP metadata 和临时目录解析 `GameMainConfig`。
+- 默认平台是 `Windows + Android`。
+- 真实下载会维护 `official-download-manifest.json`，并使用 size + BLAKE3、本地 audit/repair 和官方 seed `.hash` 校验。
+- `--watch` 是 Rust 内部常驻检查模式，默认 1 小时；外部 systemd/container 只负责守护进程。
 
 ## 2. 现在不要误解的点
 
-- `cargo test --workspace` 只会跑测试，不等于自动开始真实下载。
-- 仓库里确实有几个本地实样本测试，但它们是 `#[ignore]`，只有显式启用对应 `BAT_REAL_*` 环境变量才会读本地文件。
+- `cargo test` 不会自动开始真实全量下载。
+- 仓库里的本地实样本测试仍应显式启用，不应默认读取 `/home/wanye/D/BlueArchive`。
 - `bluearchive.cafe` 不是官方资源域名，不能当成官方链路使用。
-- 当前运行时不应依赖“本地客户端一定存在”的假设。
+- 生产输出目录必须独立，不要指向已有客户端目录、官方启动器安装目录或开发资源目录。
+- Go CLI 尚未实现；当前可运行同步入口是 Rust binary。
+- `catalog_*.hash` 当前作为 Addressables marker，不按官方 seed `.hash` 的 `xxHash32(seed=0)` 规则做内容强校验。
 
 ## 3. 当前还没做完什么
 
 仍待实现的主线工作：
 
-1. `Manifest` / Addressables 的真实解析。
-2. `sync`、`manifest inspect`、`cache status` 这些 CLI 入口。
-3. 资源持久化 schema，以及下载结果写入 CAS + ResourceRepository。
-4. 端到端的真实同步测试。
-5. 之后再推进 AssetBundle 解析、文本提取、翻译库、补丁系统。
+1. Go CLI 最小入口：`bat doctor`、`bat sync --help`、`bat official sync --help`。
+2. 真实官方网络 smoke：dry-run、首次下载、二次 up-to-date、本地损坏 repair。
+3. 官方同步下载结果进入 CAS + `SqliteResourceRepository` 的用户级流程。
+4. Addressables parser 覆盖更多真实 catalog 结构。
+5. AssetBundle UnityFS header/block/directory 解析。
+6. Patch、翻译库、API Server、Web。
 
 ## 4. 下一次对话最合适的起点
 
-建议直接从 `Milestone 3：Manifest 与资源同步` 开始，先把这条链路收紧：
+建议从 Go CLI 最小可用开始：
 
-1. 真实 `Manifest` 字段解析。
-2. 资源版本、平台、URL、Hash、大小模型确认。
-3. 下载器和缓存落地。
-4. 端到端验证能否从官方入口跑通同步。
+1. 读取 `README.md`、`CURRENT_STATUS.md`、`PROJECT_PLAN.md`。
+2. 读取 `docs/guides/official-resource-test-pull.md` 和 `docs/architecture/official-resource-backend.md`。
+3. 实现 `cmd/bat` 和最小命令树。
+4. 将 `bat-official-sync` 的 JSON report 作为 Go CLI 输出的稳定来源。
 
 ## 5. 相关入口
 
+- `README.md`
 - `PROJECT_PLAN.md`
 - `CURRENT_STATUS.md`
-- `docs/reports/current-stage-prepush.md`
+- `DOCS_INDEX.md`
+- `docs/reports/CURRENT_GAPS.md`
 - `docs/guides/official-resource-test-pull.md`
+- `docs/architecture/official-resource-backend.md`