docs: add status handoff

This commit is contained in:
2026-06-30 22:20:01 +08:00
parent adc1cd5b91
commit 99e66a48d7
2 changed files with 51 additions and 0 deletions
+1
View File
@@ -25,6 +25,7 @@
- `docs/guides/deployment.md`:部署指南。 - `docs/guides/deployment.md`:部署指南。
- `docs/guides/official-resource-test-pull.md`:官方资源拉取用户指南。 - `docs/guides/official-resource-test-pull.md`:官方资源拉取用户指南。
- `docs/reports/current-stage-prepush.md`:当前阶段说明与推送前核查记录。 - `docs/reports/current-stage-prepush.md`:当前阶段说明与推送前核查记录。
- `docs/reports/current-status-handoff.md`:给下一次对话使用的当前进度交接说明。
- `docs/guides/baseline.md`:稳定工程基线指南。 - `docs/guides/baseline.md`:稳定工程基线指南。
- `docs/architecture/adr/0001-engine-and-application-boundaries.md`Rust/Go 边界决策。 - `docs/architecture/adr/0001-engine-and-application-boundaries.md`Rust/Go 边界决策。
- `docs/architecture/adr/0002-cas-v1-design-boundary.md`CAS V1 边界决策。 - `docs/architecture/adr/0002-cas-v1-design-boundary.md`CAS V1 边界决策。
+50
View File
@@ -0,0 +1,50 @@
# 当前进度交接
**更新时间**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 3Manifest 与资源同步` 开始,先把这条链路收紧:
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`