mirror of
https://github.com/Yuyi-Oak/BlueArchiveToolkit.git
synced 2026-07-22 01:15:14 +08:00
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:
@@ -1,8 +1,8 @@
|
||||
# 当前实现缺口清单
|
||||
|
||||
**更新时间**:2026-06-28
|
||||
**用途**:集中跟踪当前代码中的占位实现、设计缺口和下一步验收项。
|
||||
**权威计划**:`../../PROJECT_PLAN.md`
|
||||
- **更新时间**:2026-07-06
|
||||
- **用途**:集中跟踪当前代码中的占位实现、设计缺口和下一步验收项。
|
||||
- **权威计划**:`../../PROJECT_PLAN.md`
|
||||
|
||||
---
|
||||
|
||||
@@ -145,18 +145,23 @@
|
||||
|
||||
### G-007:Addressables Catalog 解析不完整
|
||||
|
||||
状态:**部分关闭**
|
||||
|
||||
现象:
|
||||
|
||||
- 复杂压缩字段解析仍标记 TODO。
|
||||
- `AddressablesCatalogDriver` 已能解析当前真实形态 JSON catalog fixture/golden。
|
||||
- 已输出 path、hash、size、resource_type、address、dependencies、metadata。
|
||||
- 仍需覆盖更多官方 catalog 结构变体、二进制/压缩字段组合和更明确的失败诊断。
|
||||
|
||||
影响:
|
||||
|
||||
- 真实 Manifest 解析可能只能覆盖简单样本。
|
||||
- 当前解析能力可以服务 Manifest inspect 和部分资源索引,但还不能宣称完整兼容所有 Unity Addressables/SBP catalog 形态。
|
||||
|
||||
验收:
|
||||
|
||||
- 能解析项目目标版本的真实 Catalog 样本。
|
||||
- 能解析项目目标版本的真实 Catalog 样本集合。
|
||||
- 解析结果包含资源 key、provider、dependency、hash、size、path。
|
||||
- 对不支持的 catalog 结构返回明确错误,而不是静默丢字段。
|
||||
|
||||
---
|
||||
|
||||
@@ -167,7 +172,8 @@
|
||||
现象:
|
||||
|
||||
- `cmd/bat` 目录存在,但无 `main.go`。
|
||||
- `go test ./...` 当前无 package。
|
||||
- `internal/ffi/ffi.go` 已存在,但还不是用户可运行 CLI。
|
||||
- `go test ./...` 当前没有产品级 Go package 覆盖。
|
||||
|
||||
影响:
|
||||
|
||||
@@ -217,14 +223,19 @@
|
||||
|
||||
### G-011:Resource Repository 未持久化
|
||||
|
||||
状态:**部分关闭**
|
||||
|
||||
影响:
|
||||
|
||||
- 无法可靠记录资源版本、资源路径、依赖和 CAS hash 映射。
|
||||
- `SqliteResourceRepository` 已存在,可按领域 repository 接口保存资源元数据。
|
||||
- 官方同步下载结果尚未作为用户级流程自动写入 CAS + ResourceRepository。
|
||||
- 迁移、版本化 schema 和 CLI 查询入口仍需补齐。
|
||||
|
||||
验收:
|
||||
|
||||
- schema 和迁移可重复执行。
|
||||
- 可按版本、类型、hash、路径查询资源。
|
||||
- 官方同步后的资源可通过 CLI 查询并能追溯到 CAS 对象。
|
||||
|
||||
### G-012:Translation Memory 未实现
|
||||
|
||||
@@ -266,32 +277,37 @@
|
||||
|
||||
### G-015:README 与当前真实状态不完全一致
|
||||
|
||||
状态:**已关闭**
|
||||
|
||||
现象:
|
||||
|
||||
- README 描述了最终架构,但部分功能尚未实现。
|
||||
- 旧 README 描述了最终架构,但部分功能尚未实现。
|
||||
|
||||
验收:
|
||||
|
||||
- README 明确区分已实现、开发中、规划中。
|
||||
|
||||
状态:
|
||||
处理结果:
|
||||
|
||||
- 已部分修正,当前 README 已明确列出已具备与未完成项,并增加当前阶段说明入口。
|
||||
- README 已明确区分当前可用能力、未完成模块、官方同步运行命令和近期优先级。
|
||||
|
||||
### G-016:架构文档需要更新为当前路线图
|
||||
|
||||
状态:**已关闭当前阶段**
|
||||
|
||||
现象:
|
||||
|
||||
- `docs/architecture/README.md` 仍描述理想架构,缺少当前状态和边界冻结记录。
|
||||
- 旧 `docs/architecture/README.md` 偏目标架构,容易让读者误以为 Go 同步器和 API/Web 已经可用。
|
||||
|
||||
验收:
|
||||
|
||||
- 增加 ADR 或架构决策记录。
|
||||
- 明确 Rust/Go/DB/Plugin 边界。
|
||||
|
||||
状态:
|
||||
处理结果:
|
||||
|
||||
- 已部分修正,`docs/architecture/README.md` 已增加当前可用官方资源入口,但仍保留目标架构描述,因此只算阶段性对齐完成。
|
||||
- 架构 README 已明确当前 Rust 官方同步入口、Go 计划边界和目标架构差异。
|
||||
- 官方资源后端说明由 `docs/architecture/official-resource-backend.md` 承载。
|
||||
|
||||
### G-017:CI 未落地
|
||||
|
||||
@@ -303,15 +319,37 @@
|
||||
|
||||
- GitHub Actions 或等价 CI 执行 format、lint、test、build。
|
||||
|
||||
### G-018:真实官方网络全量下载 smoke test 未记录
|
||||
|
||||
状态:**未关闭**
|
||||
|
||||
现象:
|
||||
|
||||
- 本地测试覆盖 mock、fixture、synthetic import 和 CLI 参数。
|
||||
- 尚未在隔离输出目录记录一次真实官方网络全量下载。
|
||||
|
||||
影响:
|
||||
|
||||
- 无法用文档证明当前 `bat-official-sync` 在真实官方网络环境下完成首次下载、二次静默 up-to-date 和本地损坏 repair。
|
||||
|
||||
验收:
|
||||
|
||||
- 使用独立目录执行 dry-run。
|
||||
- 执行真实首次下载,不指向任何现有客户端或人工维护资源目录。
|
||||
- 二次运行返回 `up_to_date`,watch 模式在 up-to-date 时静默。
|
||||
- 人工破坏一个本地文件后,audit 检出并 repair。
|
||||
- 记录命令、摘要、输出目录和未纳入 Git 的大文件位置。
|
||||
|
||||
---
|
||||
|
||||
## 6. 当前关闭顺序建议
|
||||
|
||||
1. G-007
|
||||
2. G-008
|
||||
3. G-005
|
||||
4. G-011
|
||||
5. G-012
|
||||
6. G-006
|
||||
1. G-008
|
||||
2. G-018
|
||||
3. G-011
|
||||
4. G-007
|
||||
5. G-005
|
||||
6. G-012
|
||||
7. G-006
|
||||
|
||||
这个顺序优先建立可信工作区和基础存储,再推进资源同步、解析、翻译和补丁。
|
||||
这个顺序优先补齐用户入口和真实端到端验证,再推进资源索引、解析、翻译和补丁。
|
||||
|
||||
Reference in New Issue
Block a user