# 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. 本次验证结果

已运行：

```bash
cargo test --workspace
```

结果：通过。

已运行：

```bash
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。