mirror of
https://github.com/Yuyi-Oak/BlueArchiveToolkit.git
synced 2026-07-22 04:15:14 +08:00
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:
+16
-12
@@ -27,7 +27,7 @@ Rust 侧官方日服资源链路已经从实验验证推进到正式入口:
|
|||||||
11. `<output>/official-version-state.json` 会明确保存当前已完成版本、正在拉取版本、上一个可用版本和失败版本;`bat status` 会显示最后成功时间、下次检查时间、最后错误摘要、当前阶段、当前下载 URL 进度、版本状态摘要、结构化日志路径和轮转日志路径。
|
11. `<output>/official-version-state.json` 会明确保存当前已完成版本、正在拉取版本、上一个可用版本和失败版本;`bat status` 会显示最后成功时间、下次检查时间、最后错误摘要、当前阶段、当前下载 URL 进度、版本状态摘要、结构化日志路径和轮转日志路径。
|
||||||
12. 资源导入链路已支持 CAS + `ResourceRepository` 索引写入,AssetBundle 导入会记录 UnityFS 摘要,TextAsset/Table/Media 会按类型分类;当前/上一个/结构变化 catalog、403/404、hash mismatch 均有离线回归 fixture。
|
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 尚未实现。
|
- Go CLI 端到端测试,因为 Go CLI 尚未实现。
|
||||||
- Web/API 测试,因为 Web/API 尚未实现。
|
- Web/API 测试,因为 Web/API 尚未实现。
|
||||||
|
|
||||||
@@ -261,28 +261,32 @@ cargo run -p bat-infrastructure --bin bat -- \
|
|||||||
|
|
||||||
## 6. 当前阻塞项
|
## 6. 当前阻塞项
|
||||||
|
|
||||||
|
GitHub issue 状态:#4–#15 已全部关闭,当前 open 的是 #1(P1)、#2(P2)、#3(P2)。
|
||||||
|
|
||||||
下一阶段必须优先完成:
|
下一阶段必须优先完成:
|
||||||
|
|
||||||
1. Go CLI 最小可用入口:`bat doctor`、`bat sync --help`、通过 `bat --json` 包装 Rust 官方同步命令。
|
1. Issue #1(P1):把 `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 client,daemon 不可用时保留兼容 fallback。
|
||||||
2. 官方同步结果接入 CAS + ResourceRepository 的用户级工作流。
|
2. Go CLI 最小可用入口:`bat doctor`、稳定的 `bat --help` 命令结构,默认通过上述 RPC 或 `bat --json` 进程边界获取同步 report。
|
||||||
3. AssetBundle UnityFS 基础解析。
|
3. 官方同步结果接入 CAS + ResourceRepository 的用户级工作流(G-011 剩余部分:自动导入触发、schema 迁移、CLI 查询)。
|
||||||
4. Addressables parser 对更多官方 catalog 结构的覆盖。
|
4. Issue #3(P2):AssetBundle UnityFS 基础解析校验。
|
||||||
5. 按 smoke runbook 在具备网络和磁盘窗口的环境中执行真实官方全量拉取,并保留本地报告。
|
5. Issue #2(P2):继续逆向 Addressables catalog,提取 bundle hash/size/CRC 等可校验字段。
|
||||||
6. Patch 和翻译系统仍应后置。
|
6. Patch 和翻译系统仍应后置。
|
||||||
|
|
||||||
|
非阻塞跟踪项:官方同步长期运行测试正在进行,运行报告将在后续提供。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 7. 下一步建议
|
## 7. 下一步建议
|
||||||
|
|
||||||
立即任务:
|
立即任务:
|
||||||
|
|
||||||
1. 实现 Go CLI 最小框架和 `doctor`。
|
1. 按 issue #1 实现 daemon JSON-RPC 协议基础设施和首批最小方法集(`daemon.status`、`daemon.logs`、`resource.sync`、`resource.verify`、`resource.state`、`task.status`、`task.list`),并补齐 backend API 设计文档、任务模型、错误码和 RPC 测试。
|
||||||
2. 为 `bat` 增加发布型构建/安装说明和服务化验证。
|
2. 实现 Go CLI 最小框架和 `doctor`,通过 RPC 或 `bat --json` 边界对接 Rust backend。
|
||||||
3. 按端到端 smoke runbook 执行 dry-run、真实下载到隔离目录、二次运行静默 up-to-date、本地损坏后 repair。
|
3. 跟进官方同步长期运行测试,收集并归档运行报告。
|
||||||
4. 开始 AssetBundle parser 的 UnityFS header/block/directory。
|
4. 开始 AssetBundle parser 的 UnityFS header/block/directory(issue #3),并继续扩展 Addressables catalog 可校验字段(issue #2)。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
- **当前总体完成度**:约 22%
|
- **当前总体完成度**:约 22%
|
||||||
- **当前基线状态**:Rust 官方资源同步链路已具备可运行闭环;产品级 CLI/API/Web 仍未完成。
|
- **当前基线状态**:Rust 官方资源同步链路已具备可运行闭环;产品级 CLI/API/Web 仍未完成。
|
||||||
- **下一工程里程碑**:Go CLI 最小可用 + 官方同步结果接入 CAS/ResourceRepository + AssetBundle 解析起步。
|
- **下一工程里程碑**:Rust Resource Backend RPC API 最小方法集(issue #1)+ Go CLI 最小可用 + 官方同步结果接入 CAS/ResourceRepository + AssetBundle 解析起步。
|
||||||
|
|||||||
@@ -416,6 +416,10 @@
|
|||||||
- 脚本退出码为 0 即表示 runbook 验收通过。
|
- 脚本退出码为 0 即表示 runbook 验收通过。
|
||||||
- 真实网络执行需要外部网络和足够磁盘空间;本仓库只保存 runbook、脚本和测试,不保存官方大文件。
|
- 真实网络执行需要外部网络和足够磁盘空间;本仓库只保存 runbook、脚本和测试,不保存官方大文件。
|
||||||
|
|
||||||
|
后续跟踪(非阻塞):
|
||||||
|
|
||||||
|
- 官方同步长期运行测试正在进行,运行报告将在后续提供。
|
||||||
|
|
||||||
### G-019:下载失败重试策略不够精细
|
### G-019:下载失败重试策略不够精细
|
||||||
|
|
||||||
状态:**已关闭**
|
状态:**已关闭**
|
||||||
|
|||||||
Reference in New Issue
Block a user