feat: implement production cas v1

This commit is contained in:
2026-06-28 12:39:17 +08:00
parent dd53e3054e
commit b202d7b231
33 changed files with 1082 additions and 447 deletions
+21 -20
View File
@@ -8,9 +8,9 @@
## 1. 总体判断
当前项目处于 **架构骨架完成、核心能力待实装** 阶段。
当前项目处于 **稳定基线完成、CAS V1 已落地、资源同步与解析待实装** 阶段。
旧文档中存在 Week 3 “完成”和“回滚”两类互相冲突的报告。以当前代码为准,Week 3 不能视为生产级完成:CAS、AssetBundle、Patch、Go CLI/API/Web 仍有明显占位或未实现部分。
旧文档中存在 Week 3 “完成”和“回滚”两类互相冲突的报告。以当前代码为准,历史 Week 3 不再作为状态依据;当前 CAS V1 已由新实现接管,AssetBundle、Patch、Go CLI/API/Web 仍有明显占位或未实现部分。
---
@@ -103,24 +103,25 @@
### `bat-cas-engine`
状态:**有基础文件系统存储,未达到生产级 CAS**
状态:**CAS V1 已完成**
已包含:
- BLAKE3 Hash。
- 文件系统对象存储
- put/get/exists/delete/list/stats 基础接口
- 基础单元测试
- 原子文件写入:临时文件、fsync、rename、目录 sync
- 文件系统对象存储:put/get/exists/delete/list/stats。
- SQLite 对象元数据和引用计数
- 引用计数增加、减少、查询。
- GC 候选查询和 GC 删除。
- 并发写入相同内容测试。
- 损坏对象 Hash mismatch 检测。
- infrastructure 仓储适配层。
待完成:
- 引用计数
- GC
- 原子写入
- 并发安全。
- 对象损坏恢复策略。
- 事务化元数据。
-`infrastructure` CAS 适配层的职责合并。
- 更复杂的跨进程压力测试
- 未来需要时扩展流式大文件写入
- 未来需要时扩展非 SQLite 元数据后端
### `bat-assetbundle`
@@ -205,8 +206,8 @@ go test ./...
下一阶段必须优先完成:
1. CAS 生产级设计和实现
2. Manifest 真实解析
1. Manifest 真实解析
2. Go CLI 基础入口
3. AssetBundle 解析。
4. 文本提取中间格式。
@@ -218,12 +219,12 @@ go test ./...
立即任务:
1. 冻结 CAS trait、元数据和引用计数设计
2. 合并重复 CAS 实现边界
3. 实现 CAS 原子写入、引用计数、GC 和并发测试
1. 完成 Manifest 真实字段解析和资源模型映射
2. 落地 Go CLI 的 `doctor` 和基础命令框架
3. 设计 Resource Repository 的持久化 schema
---
**当前总体完成度**:约 15%
**当前总体完成度**:约 18%
**当前基线状态**:已建立可继续开发的 Git 基线。
**下一工程里程碑**Milestone 1 + Milestone 2,即核心接口冻结与生产级 CAS
**下一工程里程碑**Manifest 真实解析与 Go CLI 基础入口