  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
|
9a5fef23af
|
feat(daemon): 补全 task.cancel 与 task.logs
完成 task.* 命名空间：
- task.cancel：每个任务带共享的取消标志（Arc<AtomicBool>），worker 的 should_cancel
同时检查它和 daemon 停止标志；请求取消后置标志，worker 在下一个同步检查点中止，
任务转为 cancelled（协作式，不硬杀正在执行的 curl）。已结束任务返回 already-finished，
不存在返回 700004。
- task.logs：worker 把每条 progress 追加到任务的有界日志（上限 200 行），task.logs
返回该历史；不存在返回 700004。TaskRecord 的 cancel/log 字段 serde(skip)，不进
task.status 输出。
- 新增 cancelled 任务状态；prune 与已结束判定纳入 cancelled。
- USERGUIDE RPC 方法表更新（cancel/logs 标为已实现）。
验证：新增取消/日志注册表单测（63 bin 测试全过）；真机端到端确认触发 resource.sync
后 task.cancel 使任务转为 cancelled、task.logs 返回进度历史。
对应 issue #1（task.* 命名空间补全）。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-07-17 06:00:26 -07:00 |
|
|
nyaKazuhaandClaude Fable 5
|
d7257db447
|
docs(userguide): 增加 Daemon RPC 接口章节
记录 bat.sock JSON-RPC 2.0 控制面：统一 envelope（ok/status/data/error/request_id）、
方法命名空间与实现状态（daemon.*/resource.*/task.* 已实现，catalog/patch/unityfs
及 task.cancel/logs 返回 700003）、异步任务模型（resource.sync/verify 返回 task_id、
task.status/list 轮询）和调用示例。
对应 issue #1（协议文档）。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-07-17 05:31:57 -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 |
|