BlueArchiveToolkit/docs/reports/current-status-handoff.md

当前进度交接

更新时间：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