docs(docs): 按 issue 状态同步当前状态与缺口文档

G-018 已关闭并进入长期运行测试阶段,运行报告后续提供;阻塞项和下一步按
open issue #1/#2/#3 重排,明确 daemon JSON-RPC 扩展为 Rust Resource
Backend API 的优先级和最小方法集。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-15 06:51:46 -07:00
co-authored by Claude Fable 5
parent 0d07b9f4ce
commit 9e83bbea11
2 changed files with 20 additions and 12 deletions
+16 -12
View File
@@ -27,7 +27,7 @@ Rust 侧官方日服资源链路已经从实验验证推进到正式入口:
11. `<output>/official-version-state.json` 会明确保存当前已完成版本、正在拉取版本、上一个可用版本和失败版本;`bat status` 会显示最后成功时间、下次检查时间、最后错误摘要、当前阶段、当前下载 URL 进度、版本状态摘要、结构化日志路径和轮转日志路径。
12. 资源导入链路已支持 CAS + `ResourceRepository` 索引写入,AssetBundle 导入会记录 UnityFS 摘要,TextAsset/Table/Media 会按类型分类;当前/上一个/结构变化 catalog、403/404、hash mismatch 均有离线回归 fixture。
仍需明确:这不是完整产品完成。Go CLI 最小入口、完整 AssetBundle 解析、Patch、翻译系统、API Server 和 Web 仍是后续工作;真实官方网络全量拉取 smoke 已固化为可重复脚本和 runbook真实大文件产物与运行报告默认保存在 `/tmp` 隔离目录,不纳入 Git。
仍需明确:这不是完整产品完成。Go CLI 最小入口、完整 AssetBundle 解析、Patch、翻译系统、API Server 和 Web 仍是后续工作;真实官方网络全量拉取 smoke 已固化为可重复脚本和 runbook(G-018 已关闭),当前正在进行长期运行测试,运行报告将在后续提供;真实大文件产物与运行报告默认保存在 `/tmp` 隔离目录,不纳入 Git。
---
@@ -230,7 +230,7 @@ git status --short
未执行:
- 本次状态更新未执行真实官方网络全量下载 smoke;该流程已由 `docs/guides/official-full-pull-smoke.md``scripts/official-full-pull-smoke.sh` 固化,运行后会在隔离目录生成 `SMOKE_REPORT.md`
- 本次状态更新未执行一次性真实官方网络全量下载 smoke;该流程已由 `docs/guides/official-full-pull-smoke.md``scripts/official-full-pull-smoke.sh` 固化并关闭(G-018),当前处于长期运行测试阶段,运行报告将在后续提供
- Go CLI 端到端测试,因为 Go CLI 尚未实现。
- Web/API 测试,因为 Web/API 尚未实现。
@@ -261,28 +261,32 @@ cargo run -p bat-infrastructure --bin bat -- \
## 6. 当前阻塞项
GitHub issue 状态:#4#15 已全部关闭,当前 open 的是 #1P1)、#2P2)、#3P2)。
下一阶段必须优先完成:
1. Go CLI 最小可用入口:`bat doctor``bat sync --help`、通过 `bat --json` 包装 Rust 官方同步命令
2. 官方同步结果接入 CAS + ResourceRepository 的用户级工作流
3. AssetBundle UnityFS 基础解析
4. Addressables parser 对更多官方 catalog 结构的覆盖
5. 按 smoke runbook 在具备网络和磁盘窗口的环境中执行真实官方全量拉取,并保留本地报告
1. Issue #1P1):把 `bat` daemon 的 `bat.sock` Unix socket JSON-RPC 从运维控制通道扩展为面向 Go 服务层的本机 Rust Resource Backend API。方法按 `daemon.*``resource.*``catalog.*``patch.*``unityfs.*``task.*` 分层,统一响应 envelope`ok``status``error``data``request_id`),长任务返回 `task_id` 可轮询;首批最小方法集为 `daemon.status``daemon.logs``resource.sync``resource.verify``resource.state``task.status``task.list`。Go 层通过 RPC 调用 Rust backend,不走 FFI;现有 CLI 保持可用并可作为 RPC clientdaemon 不可用时保留兼容 fallback
2. Go CLI 最小可用入口:`bat doctor`、稳定的 `bat --help` 命令结构,默认通过上述 RPC 或 `bat --json` 进程边界获取同步 report
3. 官方同步结果接入 CAS + ResourceRepository 的用户级工作流(G-011 剩余部分:自动导入触发、schema 迁移、CLI 查询)
4. Issue #3P2):AssetBundle UnityFS 基础解析校验
5. Issue #2P2):继续逆向 Addressables catalog,提取 bundle hash/size/CRC 等可校验字段
6. Patch 和翻译系统仍应后置。
非阻塞跟踪项:官方同步长期运行测试正在进行,运行报告将在后续提供。
---
## 7. 下一步建议
立即任务:
1. 实现 Go CLI 最小框架和 `doctor`
2. `bat` 增加发布型构建/安装说明和服务化验证
3. 按端到端 smoke runbook 执行 dry-run、真实下载到隔离目录、二次运行静默 up-to-date、本地损坏后 repair
4. 开始 AssetBundle parser 的 UnityFS header/block/directory。
1. 按 issue #1 实现 daemon JSON-RPC 协议基础设施和首批最小方法集(`daemon.status``daemon.logs``resource.sync``resource.verify``resource.state``task.status``task.list`),并补齐 backend API 设计文档、任务模型、错误码和 RPC 测试
2. 实现 Go CLI 最小框架和 `doctor`,通过 RPC 或 `bat --json` 边界对接 Rust backend
3. 跟进官方同步长期运行测试,收集并归档运行报告
4. 开始 AssetBundle parser 的 UnityFS header/block/directoryissue #3),并继续扩展 Addressables catalog 可校验字段(issue #2
---
- **当前总体完成度**:约 22%
- **当前基线状态**:Rust 官方资源同步链路已具备可运行闭环;产品级 CLI/API/Web 仍未完成。
- **下一工程里程碑**:Go CLI 最小可用 + 官方同步结果接入 CAS/ResourceRepository + AssetBundle 解析起步。
- **下一工程里程碑**Rust Resource Backend RPC API 最小方法集(issue #1+ Go CLI 最小可用 + 官方同步结果接入 CAS/ResourceRepository + AssetBundle 解析起步。