BlueArchiveToolkit/CURRENT_STATUS.md

BlueArchiveToolkit 当前工作区状态

更新时间：2026-06-28
状态来源：本地工作区盘点与命令验证
权威计划：PROJECT_PLAN.md

---

1. 总体判断

当前项目处于 架构骨架完成、核心能力待实装 阶段。

旧文档中存在 Week 3 “完成”和“回滚”两类互相冲突的报告。以当前代码为准，Week 3 不能视为生产级完成：CAS、AssetBundle、Patch、Go CLI/API/Web 仍有明显占位或未实现部分。

---

2. 工作区整理结果

根目录保留

根目录现在主要保留入口文件和工程配置：

• README.md
• PROJECT_PLAN.md
• CURRENT_STATUS.md
• DOCS_INDEX.md
• CHANGELOG.md
• CLAUDE.md
• Cargo.toml
• Cargo.lock
• go.mod
• Makefile
• LICENSE

已归档

历史阶段报告已移动到：

• docs/reports/historical/root/
• docs/reports/historical/week2/
• docs/reports/historical/week3/
• docs/reports/historical/build-logs/
• docs/reports/historical/quality/
• docs/reports/historical/nested-docs/

原先误嵌套的 docs/docs/archive 已合并到：

• docs/archive/

原先空的重复目录 docs/docs 和 docs/adapters 已删除。

---

3. 当前模块状态

Rust workspace

已显式纳入 workspace：

• core
• adapters
• infrastructure
• crates/bat-assetbundle
• crates/bat-cas-engine
• crates/bat-ffi
• crates/bat-patch

bat-core

状态：接口和领域骨架基本完成

已包含：

• GameClient
• GameVersion
• Resource
• Translation
• CasRepository
• ResourceRepository
• TranslationRepository

待完成：

• 领域服务模块仍为空。
• Glossary、Provider、Patch、Manifest 等后续仓储/服务接口需要补齐。
• 公共错误模型需要与 CLI/API 错误码统一。

bat-adapters

状态：适配器框架可用，真实解析能力不足

已包含：

• Unity adapter trait、注册表、Unity 2021.3 adapter 骨架。
• Manifest driver trait、Addressables driver、注册表。
• Client integration、backup、discovery trait。

待完成：

• Unity bundle parse/serialize 仍是后续阶段能力。
• Addressables Catalog 复杂字段解析未完成。
• 客户端发现、备份、应用补丁流程尚未连接真实实现。

bat-cas-engine

状态：有基础文件系统存储，未达到生产级 CAS

已包含：

• BLAKE3 Hash。
• 文件系统对象存储。
• put/get/exists/delete/list/stats 基础接口。
• 基础单元测试。

待完成：

• 引用计数。
• GC。
• 原子写入。
• 并发安全。
• 对象损坏恢复策略。
• 事务化元数据。
• 与 infrastructure CAS 适配层的职责合并。

bat-assetbundle

状态：占位

当前只有：

• Parser trait 占位。
• AssetType 占位。
• 错误类型骨架。

待完成：

• UnityFS header、block、directory、metadata、object table。
• LZ4/LZMA 解压。
• TypeTree 解析。
• TextAsset、MonoBehaviour、ScriptableObject 解析入口。

bat-patch

状态：占位

当前 Binary Patch 和 JSON Patch 函数返回空结果，不具备真实补丁能力。

待完成：

• Binary diff/apply。
• JSON Patch apply/validate。
• Patch manifest。
• Integrity check。
• Rollback。

bat-ffi

状态：骨架

已能编译并引用 Rust 引擎 crate，但尚未提供完整稳定 FFI API。

Go / API / Web

状态：目录存在，功能未实现

当前 cmd/、internal/、pkg/、api/、web/ 多数为空目录或只有目录结构，没有 Go package 可测试。

Makefile 已调整：在 Go package 尚未实现时，Go build/test/check/fmt/lint 会明确跳过，避免误报失败。

---

4. 本次验证结果

已运行：

cargo test --workspace

结果：通过。

已运行：

go test ./...

结果：当前没有 Go package，因此无测试可运行。Makefile 已修正为跳过该状态。

---

5. 当前阻塞项

Git 元数据

原 .git/ 是空目录，无法恢复原历史。本轮已新初始化 Git 仓库，并将默认分支设置为 main。

当前状态：

• git status --short --branch 可用。
• 原历史未恢复。
• 本轮建立首次 Git 基线提交。

核心能力未实装

下一阶段必须优先完成：

1. CAS 生产级设计和实现。
2. Manifest 真实解析。
3. AssetBundle 解析。
4. 文本提取中间格式。

不建议在这些完成前优先推进 Web UI。

---

6. 下一步建议

立即任务：

1. 冻结 CAS trait、元数据和引用计数设计。
2. 合并重复 CAS 实现边界。
3. 实现 CAS 原子写入、引用计数、GC 和并发测试。

---

当前总体完成度：约 15%
当前基线状态：已建立可继续开发的 Git 基线。
下一工程里程碑：Milestone 1 + Milestone 2，即核心接口冻结与生产级 CAS。