nyaKazuha/BlueArchiveToolkit
1
0
Fork 0
mirror of https://github.com/Yuyi-Oak/BlueArchiveToolkit.git synced 2026-07-22 04:15:14 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
68 Commits 1 Branch 1 Tag
11b19683cf7ae8a237acd677177623cfcaa618d4
Commit Graph
9 Commits
Author SHA1 Message Date
nyaKazuhaandClaude Fable 5 e9b7ce219f fix(official-sync): 修正对抗性审查发现的 launcher 链错误码误归类 
对 d2466d6 做三视角对抗性核查（错误码语义/消费者破坏面/测试与文档），
确认 8 项（去重后 5 类）误归类，全部集中在 official_game_main_config
的 From<String> 兜底面。逐项修正：

- launcher_package_url 改返回 DownloadError：非官方 CDN 根（来自远端
  API 响应，安全边界拒绝）→ NON_OFFICIAL_URL；非法包路径（来自远端
  manifest 内容）→ LAUNCHER_RESPONSE_INVALID。此前提交说明称其为
  "硬编码常量上的内部不变量"不成立——三个生产调用点传入的都是远端
  API 下发的 cdn_root。
- select_game_main_config_source / find_resources_assets：目录 source
  缺 resources.assets 条目、无可用游戏包路径、包内容缺必需文件均为
  远端可触发的内容缺陷 → LAUNCHER_RESPONSE_INVALID（此前落 INTERNAL，
  且官方 manifest 布局已演进过一次，是现实的主要失败面）。
- extract_archive 解压失败 → ZIP_STRUCTURE_INVALID：结构校验不覆盖
  压缩数据流，数据区损坏（bad CRC）在 unzip 阶段首次暴露，主导成因
  是损坏/截断下载，归完整性域；本地原因保留在 stderr 消息中。
- verify_manifest_file_size 三种失败分码：size 字段无效 →
  LAUNCHER_RESPONSE_INVALID、本地读文件失败 → INTERNAL、真正不符 →
  SIZE_MISMATCH（此前三者统归 SIZE_MISMATCH）。
- 空 --launcher-version（用户 CLI 输入）→ INVALID_ARGUMENT，在发起
  任何请求前拒绝（此前落 INTERNAL）。
- 统一 launcher 链内容口径：API 响应、远端 manifest、包内容的解析/
  缺失问题全部归 LAUNCHER_RESPONSE_INVALID(600004)，
  MANIFEST_PARSE_FAILED(600001) 保留给资源侧 manifest/catalog；
  fetch_remote_manifest 两处 600001 改 600004，error_code.rs 注释与
  USERGUIDE 描述同步。
- download_file_with_fallback：备用 URL 构造失败不再经 `?` 丢弃主地址
  失败上下文，错误码与"两次都失败以最终一次为准"策略一致。

新增 7 个错误码断言测试（launcher_package_url 两类拒绝、空版本、
manifest 无条目、fallback 终码保留、fallback 构造失败保留主上下文、
select/verify/extract 各失败面）。全量 fmt / clippy --workspace
--all-targets -D warnings / test --workspace 全绿。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-17 09:42:17 -07:00
nyaKazuhaandClaude Fable 5 d2466d60db feat(official-sync): 错误码模型铺开到 launcher/metadata 拉取路径 
此前统一错误码只覆盖资源下载路径，launcher/metadata 链
（fetch_game_config → manifest URL → remote manifest → resources.assets
→ GameMainConfig）整条返回 Result<_, String>，经 anyhow::Error::msg
抹成无类型消息，RPC/任务层只能标为 internal。

本次将该链整体改为 Result<_, DownloadError>：

- core 新增两个错误码：LAUNCHER_API_REJECTED（300031，官方启动器 API
  返回非 200 业务码）与 LAUNCHER_RESPONSE_INVALID（600004，响应无法
  解析或缺少必需字段），并纳入唯一性测试；
- official_launcher：curl 失败保留准确网络域码（403/404/DNS/超时/TLS/
  代理等，final_error_code()），API 非 200 → LAUNCHER_API_REJECTED，
  响应解析/缺字段 → LAUNCHER_RESPONSE_INVALID，非官方 manifest URL →
  NON_OFFICIAL_URL，manifest 无文件条目 → MANIFEST_PARSE_FAILED，
  空版本/路径入参 → INVALID_ARGUMENT；
- official_game_main_config：下载失败带网络域码（主/备 CDN 均失败时
  以最终一次为准），ZIP 结构 → ZIP_STRUCTURE_INVALID，manifest 大小
  不符 → SIZE_MISMATCH，GameMainConfig 解密/解析 →
  GAME_MAIN_CONFIG_FAILED，manifest 缺 source →
  LAUNCHER_RESPONSE_INVALID；
- official_update 两处调用改 anyhow::Error::msg → anyhow::Error::new，
  保留类型，task worker 现有 downcast 直接接住 launcher 路径错误码；
- USERGUIDE 错误码表补录 300031 与 600004。

内部工具函数（launcher_package_url / launcher_api_url /
launcher_authorization_header）仍返回 String，经 From<String> 归
INTERNAL——这些是硬编码常量上的内部不变量校验，非运行时主要失败面。

验证：新增 4 个单测断言映射（API 403 业务码 → 300031、非法 JSON →
600004、HTTP 404 → 300002、非官方 URL → 300030）；全量
fmt / clippy --workspace --all-targets -D warnings / test --workspace
全绿（含 examples 编译）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-17 08:29:16 -07:00
nyaKazuhaandClaude Fable 5 1a25ea58dd feat(core): 引入统一错误码模型并新增 USERGUIDE 
为 issue #1 的公共错误契约建立错误码模型：

- core/src/error_code.rs：ErrorCode（BAT-ERR-<域3位><序号3位>，如 BAT-ERR-300012）
  + 44 个初始码表（覆盖输入/路径安全/网络下载/校验/发布存储/解析/任务RPC/内部
  八域，网络域含代理故障 310001）、ErrorDomain、以及进入 RPC envelope / --json /
  bat-events.jsonl 的统一 ApiError { code, kind, domain, location, message, retryable }。
  location 用稳定的组件·操作标签（不随行号漂移）。
- 新增 USERGUIDE.md：bat 命令、选项（发现/同步/守护/输出）、退出码（含 75=locked）、
  运行时默认值，以及从码表同步的错误码参考（含承载结构与域一览）。

命名遵循国际惯例（英文 kind/domain slug）。码表以 error_code.rs 为准，USERGUIDE
错误码表与之逐条一致。后续各链路报错接入该码表在 issue #1 下推进。

对应 issue #1（错误码模型 + 用户指南）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-17 03:57:17 -07:00
nyaKazuhaandClaude Fable 5 48ffc08cdf fix(cas): exists 返回 Result 以区分不存在与存储故障 
CasRepository::exists（core trait）与底层 Storage::exists 原返回裸 bool，
FileSystemStorage 用 try_exists(...).unwrap_or(false)、infra 适配层吞掉解析/
初始化错误返回 false，调用方无法区分“对象不存在”和权限/IO/初始化故障。

将整条链改为 Result<bool>：
- storage trait 与 FileSystemStorage：try_exists 的 IO 错误经 ? 传播；
- repository FileSystemCasRepository::exists 及 store/add_reference 内部调用；
- core CasRepository::exists trait；
- infra 适配层：解析失败→InvalidArgument、初始化/引擎错误经 map_error 传播。
Ok(false) 仅表示确实不存在。

新增单测：合法但不存在的对象返回 Ok(false)，非法 ObjectId 返回 Err（而非静默
false）；同步更新各层 exists 断言。

对应 issue #18 维护清单 2-1。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-16 08:53:54 -07:00
nyaKazuha 90307a3243 feat: track official versions and import resources 
Persist official version-state, extend CAS/ResourceRepository import classification, and add offline catalog and failure regression fixtures.

Fixes #13

Fixes #12

Fixes #8
 2026-07-15 19:53:10 +08:00
nyaKazuha 789402c887 feat: add official resource sync pipeline 
Add the production-facing official update service and bat-official-sync watch CLI for unattended resource synchronization.

Support launcher-resource discovery without installing the launcher, remote marker snapshots, local manifest audit and repair, official seed hash validation, bootstrap caching, richer Addressables coverage, SQLite resource persistence, and FFI JSON helpers.
 2026-07-05 23:49:56 +08:00
nyaKazuha 3c00659691 refactor: reduce quality findings 2026-06-28 15:42:12 +08:00
nyaKazuha b202d7b231 feat: implement production cas v1 2026-06-28 12:39:17 +08:00
nyaKazuha dd53e3054e chore: establish development baseline 2026-06-28 01:27:09 +08:00