diff --git a/DOCS_INDEX.md b/DOCS_INDEX.md index f788013..26d0d4f 100644 --- a/DOCS_INDEX.md +++ b/DOCS_INDEX.md @@ -25,6 +25,7 @@ - `docs/guides/deployment.md`:部署指南。 - `docs/guides/official-resource-test-pull.md`:官方资源拉取用户指南。 - `docs/reports/current-stage-prepush.md`:当前阶段说明与推送前核查记录。 +- `docs/reports/current-status-handoff.md`:给下一次对话使用的当前进度交接说明。 - `docs/guides/baseline.md`:稳定工程基线指南。 - `docs/architecture/adr/0001-engine-and-application-boundaries.md`:Rust/Go 边界决策。 - `docs/architecture/adr/0002-cas-v1-design-boundary.md`:CAS V1 边界决策。 diff --git a/docs/reports/current-status-handoff.md b/docs/reports/current-status-handoff.md new file mode 100644 index 0000000..614beda --- /dev/null +++ b/docs/reports/current-status-handoff.md @@ -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 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`