feat(assetbundle): 完善官方资源解析与双目录发布

This commit is contained in:
2026-07-25 20:51:01 +08:00
parent 102b49b666
commit 3e9bb20d79
37 changed files with 4663 additions and 1333 deletions
+8 -2
View File
@@ -11,9 +11,12 @@
- `PROJECT_PLAN.md`:完整开发计划和最终目标路线图。
- `CURRENT_STATUS.md`:当前工作区真实状态。
- `docs/reports/CURRENT_GAPS.md`:当前实现缺口和关闭顺序。
- `docs/reports/GO_STATUS.md`:Go 侧边界、约定与组件进度(权威)。
- `docs/guides/official-resource-test-pull.md`:官方资源拉取与自动更新用户指南。
- `docs/guides/official-full-pull-smoke.md`:真实官方全量拉取 smoke runbook 和可重复命令。
- `docs/architecture/official-resource-backend.md`:官方资源后端职责、工作原理和审核说明。
- `docs/architecture/resource-release-layout.md`release 布局、URL 映射、seed 规则、bat-api 分发契约(资源侧逆向权威)。
- `docs/architecture/assetbundle.md`AssetBundle、Addressables、Serialized File、文本提取和 Patch 前置解析路线图。
- `docs/reference/rpc-backend-api.md`Rust Resource Backend JSON-RPC 稳定 contract。
- `CHANGELOG.md`:版本变更记录。
- `AGENTS.md`:AI agent 和自动化开发助手长期规则。
@@ -40,7 +43,6 @@
后续建议新增:
- `docs/architecture/cas.md`CAS 生产级设计。
- `docs/architecture/assetbundle.md`AssetBundle 解析设计。
- `docs/architecture/translation.md`:翻译系统设计。
---
@@ -101,14 +103,18 @@
- CAS V1:原子写入、BLAKE3 校验、引用计数、GC、并发测试和损坏检测。
- 文档整理和路线图重制。
- Rust 官方资源同步闭环:`bat``--auto-discover``--watch``--daemon`、Unix socket JSON-RPC 后台控制、`status``stop``restart``reload``refresh``logs``verify``repair``doctor``clean-stable`、北京时间固定强制刷新、snapshot、manifest audit/repair、官方 seed `.hash` 校验。
- 官方原版资源与汉化产物目录分离:`./bat-resources` 只承载原版 release`./bat-localized` 承载后续汉化 release;当前官方同步报告 `not_localized`Patch 发布完成后才进入 `localized`
- 官方 release 会维护 `official-parse-cache.json`,用于跳过未变化资源的重复解析。
- `bat-api/internal/backendrpc` typed Unix socket JSON-RPC client。
- `cmd/bat-api` 资源分发 HTTP MVP(进度见 `docs/reports/GO_STATUS.md`)。
- 真实官方网络全量拉取 smoke 已固化为 `scripts/official-full-pull-smoke.sh``make official-smoke`,默认写入 `/tmp` 隔离目录并输出本地运行报告。
- `bat` 运行时 progress log 已覆盖下载已完成计数、单文件下载进度和校验结果摘要。
- Addressables 当前真实形态 fixture/golden 覆盖。
- 解析补全路线图已固化到 `docs/architecture/assetbundle.md`:解析缓存、Addressables、UnityFS、Serialized 字段级解析、文本提取、CAS 接入和 Patch 发布前置。
- SQLite Resource Repository 和可选无状态 `bat-ffi` JSON 兼容接口。
优先待办:
- 收敛 Go 产品入口的最终形态,避免把试验性 `cmd/bat` 误当作完成品
- `bat-api` 与全量 release / 服务器 daemon 联调(issue #19 剩余)
- 将官方同步结果接入 CAS + ResourceRepository 的用户级流程。
- 推进 AssetBundle UnityFS 引擎级解析。