From ec40ed46606660ab687e842262eaa72a9f98cac8 Mon Sep 17 00:00:00 2001 From: Yuyi-Oak <1722157266@qq.com> Date: Fri, 17 Jul 2026 20:44:01 -0700 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=85=B3=E9=97=AD=20G-017=EF=BC=88?= =?UTF-8?q?=E5=86=B3=E7=AD=96=E4=B8=8D=E5=BC=95=E5=85=A5=E6=89=98=E7=AE=A1?= =?UTF-8?q?=20CI=EF=BC=89=E5=B9=B6=E5=90=8C=E6=AD=A5=20CURRENT=5FGAPS?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - G-017 按决策关闭：不加入 GitHub Workflows，质量门禁由本地 fmt/clippy/test 与 Makefile/scripts 可重复脚本承担 - G-008 补记对接边界现状：issue #1 RPC Backend API 已就绪， 实现 Go CLI 时应重写 cmd/bat 现有 cgo 骨架 - 关闭顺序移除已关闭的 G-018，更新时间与结语同步 - PROJECT_PLAN 里程碑 11 的 CI 交付物改为本地可重复验证， 与 G-017 决策一致 Co-Authored-By: Claude Fable 5 --- PROJECT_PLAN.md | 2 +- docs/reports/CURRENT_GAPS.md | 33 ++++++++++++++++++++++----------- 2 files changed, 23 insertions(+), 12 deletions(-) diff --git a/PROJECT_PLAN.md b/PROJECT_PLAN.md index 975c5de..9293d1d 100644 --- a/PROJECT_PLAN.md +++ b/PROJECT_PLAN.md @@ -348,7 +348,7 @@ BlueArchiveToolkit 不是一次性脚本，也不是演示项目。最终交付 交付物： -1. CI：format、lint、test、build、security audit、release artifact。 +1. 发布验证：format、lint、test、build、security audit、release artifact 由本地可重复命令与脚本承担（决策：不引入 GitHub Workflows 等托管 CI，见 `docs/reports/CURRENT_GAPS.md` G-017）。 2. Docker Compose：本地开发、服务端部署。 3. 数据备份与恢复文档。 4. 用户文档、开发文档、故障排查文档。 diff --git a/docs/reports/CURRENT_GAPS.md b/docs/reports/CURRENT_GAPS.md index f6013b1..a9bcf0a 100644 --- a/docs/reports/CURRENT_GAPS.md +++ b/docs/reports/CURRENT_GAPS.md @@ -1,6 +1,6 @@ # 当前实现缺口清单 -- **更新时间**：2026-07-06 +- **更新时间**：2026-07-17 - **用途**：集中跟踪当前代码中的占位实现、设计缺口和下一步验收项。 - **权威计划**：`../../PROJECT_PLAN.md` @@ -175,6 +175,10 @@ - `internal/ffi/ffi.go` 已存在，但只是可选 CGO 兼容包装，不是用户可运行的产品 CLI，也不是默认集成边界。 - `go test ./...` 当前没有产品级 Go package 覆盖。 +当前进展： + +- 对接边界已就绪：Rust daemon 的 `bat.sock` Unix socket JSON-RPC Backend API（issue #1 主体已完成：统一 envelope、`BAT-ERR` 错误码模型、`daemon.*`/`resource.*`/`catalog.*`/`task.*` 方法集）与 `bat --json` 进程边界均可用。Go CLI 缺的是产品级入口本身，实现时应重写 `cmd/bat` 现有 cgo 骨架为 RPC/进程边界对接。 + 影响： - 用户没有统一入口。 @@ -383,13 +387,21 @@ ### G-017：CI 未落地 -影响： +状态：**已关闭（决策：不引入托管 CI）** -- 无自动验证质量门槛。 +原现象： -验收： +- 仓库没有 GitHub Workflows 或等价托管 CI，质量门槛无自动远端执行。 -- GitHub Actions 或等价 CI 执行 format、lint、test、build。 +处理结果： + +- 明确决策：本项目不加入 GitHub Workflows，也不引入其他托管 CI。 +- 质量门禁由本地默认验证命令承担：提交前执行 `cargo fmt` / `cargo clippy --workspace --all-targets -- -D warnings` / `cargo test --workspace`（见 `docs/guides/development.md` 与 `docs/guides/baseline.md`）。 +- 发布类检查（build、smoke）由 `Makefile` 与 `scripts/` 下的可重复脚本承担（如 `make official-smoke`）。 + +限制： + +- 门禁执行依赖提交者本地自觉，无远端强制拦截；若未来出现多人协作或外部贡献需求，可重新评估本决策。 ### G-018：真实官方网络全量下载 smoke test 已固化为可重复命令 @@ -451,11 +463,10 @@ ## 6. 当前关闭顺序建议 1. G-008 -2. G-018 -3. G-011 +2. G-011 +3. G-005 4. G-007 -5. G-005 -6. G-012 -7. G-006 +5. G-012 +6. G-006 -这个顺序优先补齐用户入口和真实端到端验证，再推进资源索引、解析、翻译和补丁。 +这个顺序优先补齐用户入口和官方同步结果的资源索引编排，再推进解析、翻译和补丁。G-018 已固化为可重复 smoke 命令并关闭；G-017 已按"不引入托管 CI"决策关闭。