# 当前进度交接

**更新时间**：2026-06-30  
**状态分支**：`experiment`  
**用途**：给下一次对话快速恢复上下文，优先以当前工作区与已验证结果为准。

## 1. 现在处在什么阶段

当前项目已经完成基础整理和 CAS V1，官方资源链路也已经验证过，下一阶段重点是把“资源同步”从验证推进到可继续扩展的真实实现。

已确认的事实：

- `cargo test --workspace` 通过。
- `git status --short --branch` 可用，当前分支为 `experiment`。
- `bat-cas-engine` 的 CAS V1 已完成。
- 官方资源链路已收敛到只接受官方 host，默认验证平台是 `Windows` + `Android`。
- 真实下载相关测试目前是通过 mock / fixture 验证，不是自动去拉线上全量资源。

## 2. 现在不要误解的点

- `cargo test --workspace` 只会跑测试，不等于自动开始真实下载。
- 仓库里确实有几个本地实样本测试，但它们是 `#[ignore]`，只有显式启用对应 `BAT_REAL_*` 环境变量才会读本地文件。
- `bluearchive.cafe` 不是官方资源域名，不能当成官方链路使用。
- 当前运行时不应依赖“本地客户端一定存在”的假设。

## 3. 当前还没做完什么

仍待实现的主线工作：

1. `Manifest` / Addressables 的真实解析。
2. `sync`、`manifest inspect`、`cache status` 这些 CLI 入口。
3. 资源持久化 schema，以及下载结果写入 CAS + ResourceRepository。
4. 端到端的真实同步测试。
5. 之后再推进 AssetBundle 解析、文本提取、翻译库、补丁系统。

## 4. 下一次对话最合适的起点

建议直接从 `Milestone 3：Manifest 与资源同步` 开始，先把这条链路收紧：

1. 真实 `Manifest` 字段解析。
2. 资源版本、平台、URL、Hash、大小模型确认。
3. 下载器和缓存落地。
4. 端到端验证能否从官方入口跑通同步。

## 5. 相关入口

- `PROJECT_PLAN.md`
- `CURRENT_STATUS.md`
- `docs/reports/current-stage-prepush.md`
- `docs/guides/official-resource-test-pull.md`