nyaKazuha and Claude 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
nyaKazuha and Claude 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
nyaKazuha and Claude 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
nyaKazuhaandClaude Fable 5