From 9e83bbea11d84c7d98977c8d827d855d8a7339e3 Mon Sep 17 00:00:00 2001 From: Yuyi-Oak <1722157266@qq.com> Date: Wed, 15 Jul 2026 06:51:46 -0700 Subject: [PATCH] =?UTF-8?q?docs(docs):=20=E6=8C=89=20issue=20=E7=8A=B6?= =?UTF-8?q?=E6=80=81=E5=90=8C=E6=AD=A5=E5=BD=93=E5=89=8D=E7=8A=B6=E6=80=81?= =?UTF-8?q?=E4=B8=8E=E7=BC=BA=E5=8F=A3=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit G-018 已关闭并进入长期运行测试阶段，运行报告后续提供；阻塞项和下一步按 open issue #1/#2/#3 重排，明确 daemon JSON-RPC 扩展为 Rust Resource Backend API 的优先级和最小方法集。 Co-Authored-By: Claude Fable 5 --- CURRENT_STATUS.md | 28 ++++++++++++++++------------ docs/reports/CURRENT_GAPS.md | 4 ++++ 2 files changed, 20 insertions(+), 12 deletions(-) diff --git a/CURRENT_STATUS.md b/CURRENT_STATUS.md index 03fa0d2..6b79044 100644 --- a/CURRENT_STATUS.md +++ b/CURRENT_STATUS.md @@ -27,7 +27,7 @@ Rust 侧官方日服资源链路已经从实验验证推进到正式入口： 11. `/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 的是 #1（P1）、#2（P2）、#3（P2）。 + 下一阶段必须优先完成： -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 #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. Go CLI 最小可用入口：`bat doctor`、稳定的 `bat --help` 命令结构，默认通过上述 RPC 或 `bat --json` 进程边界获取同步 report。 +3. 官方同步结果接入 CAS + ResourceRepository 的用户级工作流（G-011 剩余部分：自动导入触发、schema 迁移、CLI 查询）。 +4. Issue #3（P2）：AssetBundle UnityFS 基础解析校验。 +5. Issue #2（P2）：继续逆向 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/directory（issue #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 解析起步。 diff --git a/docs/reports/CURRENT_GAPS.md b/docs/reports/CURRENT_GAPS.md index 12b4b06..6aadaf6 100644 --- a/docs/reports/CURRENT_GAPS.md +++ b/docs/reports/CURRENT_GAPS.md @@ -416,6 +416,10 @@ - 脚本退出码为 0 即表示 runbook 验收通过。 - 真实网络执行需要外部网络和足够磁盘空间；本仓库只保存 runbook、脚本和测试，不保存官方大文件。 +后续跟踪（非阻塞）： + +- 官方同步长期运行测试正在进行，运行报告将在后续提供。 + ### G-019：下载失败重试策略不够精细 状态：**已关闭**