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.
This commit is contained in:
2026-07-06 00:34:22 +08:00
parent 789402c887
commit 5e76ea4ae3
15 changed files with 661 additions and 345 deletions
+21 -15
View File
@@ -1,16 +1,18 @@
# BlueArchiveToolkit 文档索引
**更新时间**2026-06-29
**说明**:本索引用于快速定位当前权威文档和历史资料。
- **更新时间**2026-07-06
- **说明**:本索引用于快速定位当前权威文档和历史资料。
---
## 1. 权威入口
- `README.md`:项目概览和快速开始。
- `README.md`:项目概览、当前可用能力和快速开始。
- `PROJECT_PLAN.md`:完整开发计划和最终目标路线图。
- `CURRENT_STATUS.md`:当前工作区真实状态。
- `docs/reports/CURRENT_GAPS.md`:当前实现缺口和关闭顺序。
- `docs/guides/official-resource-test-pull.md`:官方资源拉取与自动更新用户指南。
- `docs/architecture/official-resource-backend.md`:官方资源后端职责、工作原理和审核说明。
- `CHANGELOG.md`:版本变更记录。
- `CLAUDE.md`:长期开发约束和项目要求。
@@ -19,11 +21,10 @@
## 2. 架构与指南
- `docs/architecture/README.md`:总体架构设计。
- `docs/architecture/official-resource-backend.md`:官方资源后端职责、工作原理和审核说明。
- `docs/api/README.md`API 设计入口。
- `docs/guides/development.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-status-handoff.md`:给下一次对话使用的当前进度交接说明。
- `docs/guides/baseline.md`:稳定工程基线指南。
@@ -70,27 +71,32 @@
1. `CURRENT_STATUS.md`
2. `PROJECT_PLAN.md`
3. `docs/reports/CURRENT_GAPS.md`
4. `docs/guides/baseline.md`
5. `docs/architecture/README.md`
6. `docs/guides/development.md`
3. `docs/guides/official-resource-test-pull.md`
4. `docs/architecture/official-resource-backend.md`
5. `docs/reports/CURRENT_GAPS.md`
6. `docs/guides/baseline.md`
7. `docs/architecture/README.md`
8. `docs/guides/development.md`
---
## 6. 状态摘要
当前总体完成度约 **18%**
当前总体完成度约 **22%**
已完成:
- Rust 领域模型和仓储接口骨架。
- Unity/Manifest/Client 适配器框架。
- 基础 CAS 文件系统存储
- CAS V1:原子写入、BLAKE3 校验、引用计数、GC、并发测试和损坏检测
- 文档整理和路线图重制。
- 官方资源链路验证和实验性 fixture 收敛
- Rust 官方资源同步闭环:`bat-official-sync``--auto-discover``--watch`、snapshot、manifest audit/repair、官方 seed `.hash` 校验
- Addressables 当前真实形态 fixture/golden 覆盖。
- SQLite Resource Repository 和粗粒度 FFI JSON 接口。
优先待办:
- 完成 Manifest 真实解析
- 启动 Go CLI 入口
- 设计 Resource Repository 持久化 schema
- 落地 Go CLI 最小可用入口
- 记录真实官方网络全量下载 smoke test
- 将官方同步结果接入 CAS + ResourceRepository 的用户级流程
- 开始 AssetBundle UnityFS 解析。