docs: update bat runtime documentation

This commit is contained in:
2026-07-12 23:04:26 +08:00
parent f7255f7c04
commit bd9f50c85c
14 changed files with 195 additions and 115 deletions
+2 -2
View File
@@ -184,7 +184,7 @@
- `bat doctor` 可运行。
- `bat --help` 命令结构稳定。
- 命令支持配置文件和 JSON 输出。
- 命令支持默认人类可读输出和 `--json` 机器输出。
### G-009API Server 和 OpenAPI 尚未实现
@@ -330,7 +330,7 @@
影响:
- 无法用文档证明当前 `bat-official-sync` 在真实官方网络环境下完成首次下载、二次静默 up-to-date 和本地损坏 repair。
- 无法用文档证明当前 `bat` 在真实官方网络环境下完成首次下载、二次静默 up-to-date 和本地损坏 repair。
验收:
+5 -5
View File
@@ -15,7 +15,7 @@
2. 自动发现官方 `app-version``connection-group``server-info`
3. 拉取 Windows + Android 官方资源集合。
4. 保存 snapshot,按远端 marker 和本地 manifest 判断是否需要更新。
5. 支持 `bat-official-sync --watch` 常驻检查,默认每 1 小时运行一次。
5. 支持 `bat --watch` 常驻检查,默认每 1 小时运行一次。
6. 通过文档明确生产目录不能指向已有客户端或开发资源目录。
## 2. 当前实现状态
@@ -27,7 +27,7 @@
- `AddressablesCatalogDriver` 对当前真实形态 fixture/golden 的解析。
- `OfficialResourcePullService` 的官方 URL 拒绝、`.part` 续传、重试、本地 manifest、官方 seed `.hash` 校验。
- `OfficialUpdateService` 的 auto-discover、bootstrap cache、v2 snapshot、remote marker diff、本地 audit/repair。
- `bat-official-sync` one-shot 和 `--watch`
- `bat` one-shot 和 `--watch`
- `bat-ffi` 的 Manifest inspect 和 sync plan JSON API。
- `SqliteResourceRepository`
@@ -47,8 +47,8 @@
cargo test -p bat-adapters -- --nocapture
cargo test -p bat-ffi -- --nocapture
cargo test -p bat-infrastructure -- --nocapture
cargo test -p bat-infrastructure --bin bat-official-sync -- --nocapture
cargo run -p bat-infrastructure --bin bat-official-sync -- --help
cargo test -p bat-infrastructure --bin bat -- --nocapture
cargo run -p bat-infrastructure --bin bat -- --help
git diff --cached --check
```
@@ -67,6 +67,6 @@ git status --short
## 5. 下一步
1. 实现 Go CLI`bat doctor``bat sync --help``bat official sync --help`
2.`bat-official-sync` 做真实官方网络 smoke,输出目录必须隔离。
2.`bat` 做真实官方网络 smoke,输出目录必须隔离。
3. 将官方同步下载结果接入 CAS + `SqliteResourceRepository`
4. 开始 AssetBundle UnityFS header/block/directory 解析。
+2 -2
View File
@@ -13,7 +13,7 @@
- 当前分支为 `experiment`
- `bat-cas-engine` 的 CAS V1 已完成。
- `bat-official-sync` 是当前官方资源同步正式入口。
- `bat` 是当前官方资源同步正式入口。
- Linux 生产链路不安装、不启动、不依赖官方启动器。
- `--auto-discover` 通过官方 HTTP metadata 和临时目录解析 `GameMainConfig`
- 默认平台是 `Windows + Android`
@@ -47,7 +47,7 @@
1. 读取 `README.md``CURRENT_STATUS.md``PROJECT_PLAN.md`
2. 读取 `docs/guides/official-resource-test-pull.md``docs/architecture/official-resource-backend.md`
3. 实现 `cmd/bat` 和最小命令树。
4. `bat-official-sync` 的 JSON report 作为 Go CLI 输出的稳定来源。
4. Go CLI 调用 `bat` 时显式传 `--json`,把该结构化 report 作为稳定机器输出来源。
## 5. 相关入口