83 Commits

Include renames

Author	SHA1	Message	Date
nyaKazuha	4ed81f0030	feat(bat-api): 实现内嵌 dashboard ... Closes #46	2026-08-31 23:17:23 +08:00
nyaKazuha	ab21344773	feat(i18n): 完成 localized patch 发布回滚闭环 ... Closes #45	2026-08-31 00:02:55 +08:00
nyaKazuha	f441f1810e	feat(i18n): 接入翻译 provider worker ... Closes #44	2026-08-30 21:13:31 +08:00
nyaKazuha	7f465523e1	fix(bat-api): 完成 issue #19 同机 live 联调	2026-08-29 22:58:01 +08:00
nyaKazuha	9d4f8d903c	feat(addressables): 补全 catalog 可校验字段 ... 补充 JSON/compact catalog 的 provider ID、bundle name、资源类型、hash、size、CRC 和依赖字段，并贯通 ResourceEntry、SQLite 资源索引和回归 golden。对 compact extra data 与 resource type index 的损坏返回明确错误，不再把 bundle name 当作 hash fallback。\n\n验证：cargo fmt --check；cargo test -p bat-core --locked；cargo test -p bat-adapters --locked；cargo test -p bat-infrastructure --locked；git diff --check。\n\nClippy 仍受既有 core/src/domain/game_client.rs:141 的 needless-question-mark 和 items-after-test-module 基线问题影响，未混入本 issue 修复。\n\nFixes #2	2026-08-19 23:10:16 +08:00
nyaKazuha	72c1a879a3	feat(bat): 补全工作流命令与人工校对状态 ... Refs #43	2026-08-19 21:33:33 +08:00
nyaKazuha	550ee7fd9a	feat(bat): 补全翻译工作台编辑命令 ... Refs #43	2026-08-12 09:33:14 +08:00
nyaKazuha	974a6e18c3	feat(bat): 暴露翻译任务状态控制 ... Refs #43	2026-08-12 09:11:09 +08:00
nyaKazuha	1933d6acb0	feat(bat): 补全工作流校验与调度过滤 ... 新增 parse clear-cache 和 i18n validate，补齐 schedule 的作用域过滤与单轮执行上限，并将列表过滤参数暴露给 bat-api dashboard。同步 RPC、OpenAPI、用户文档和回归测试。 Refs #43	2026-08-03 23:47:59 +08:00
nyaKazuha	0784d5b532	feat(bat): 完善工作流调度与 dashboard RPC ... 补全资源拉取、解析、翻译、重打包和本地化发布命令，支持单次、限定次数与周期调度。移除 TUI 计划并通过 schedule.* RPC 暴露给 bat-api dashboard。 Closes #43	2026-08-03 22:18:52 +08:00
nyaKazuha	7c863d10d1	fix: 稳定并发 worker 回归测试	2026-08-03 00:57:29 +08:00
nyaKazuha	9a5b3ba39b	fix: 拆分 bat 控制面	2026-08-03 00:43:11 +08:00
nyaKazuha	2b053e247d	fix: 抽象官方库存与 sidecar hash 策略	2026-08-02 23:12:25 +08:00
nyaKazuha	ba28e067c9	fix: 明确并发下载报告按计划顺序输出	2026-08-02 22:47:21 +08:00
nyaKazuha	8b64cc94f3	fix: 完成下载并发与翻译交接链路	2026-08-02 22:34:23 +08:00
nyaKazuha	12c5d365ab	feat(translation): 增加离线任务状态查询	2026-08-01 19:04:54 +08:00
nyaKazuha	a05d3ee6af	fix(repository): 扩展资源索引查询面	2026-08-01 12:11:35 +08:00
nyaKazuha	80e6718e8a	fix(sync): 对齐 localized 状态契约	2026-07-31 18:28:02 +08:00
nyaKazuha	df361cff28	test(api): 固化 Rust-Go RPC 契约	2026-07-31 18:20:37 +08:00
nyaKazuha	1e466d3374	fix(sync): 规范 release flow 状态码解析	2026-07-31 17:45:50 +08:00
nyaKazuha	6af7706190	fix(api): 补齐 bat-api 控制与后端 RPC	2026-07-31 17:01:03 +08:00
nyaKazuha	20ddd67947	fix(api): 统一 catalog GameMainConfig 字段	2026-07-31 16:05:17 +08:00
nyaKazuha	4cc143f66d	fix(sync): 固化 release flow 状态码	2026-07-31 15:57:07 +08:00
nyaKazuha	99e6b3a23a	fix(sync): 立即校验官方 hash sidecar	2026-07-31 13:12:21 +08:00
nyaKazuha	16e73327b4	fix(sync): 补齐发布清理与校验进度	2026-07-31 13:00:53 +08:00
nyaKazuha	2079c6a307	feat(sync): 接入解析缓存与汉化发布前置 ... 补齐官方 release 解析缓存、TextUnit 明细索引、资源变更集、Crowdin handoff 预留、ResourceRepository 导入元数据和 localized release patch 前置链路。 同时开放文件级 patch.apply 与 UnityFS TextAsset/string/semantic field patch CLI/RPC 入口，并保留官方原版资源与汉化产物双目录发布状态。 验证：cargo test -p bat-assetbundle --locked；cargo clippy -p bat-assetbundle --all-targets --locked -- -D warnings；cargo test -p bat-infrastructure --locked。	2026-07-31 00:38:45 +08:00
nyaKazuha	3e9bb20d79	feat(assetbundle): 完善官方资源解析与双目录发布	2026-07-25 20:51:01 +08:00
nyaKazuha	102b49b666	feat(rpc): 完成 issue #1 Go 调用边界	2026-07-24 17:58:34 +08:00
nyaKazuha	ecda08ed97	feat(rpc): 补齐 issue #1 资源后端接口	2026-07-24 15:55:37 +08:00
nyaKazuha	a729615a48	fix(sync): 移除多线程下载并补齐staging复用回归	2026-07-24 10:34:58 +08:00
nyaKazuha	3f5d2a8da7	fix(sync): 修复官方资源并发下载与媒体路径 ... daemon 子进程现会透传下载并发配置，下载进度按已完成数量单调上报。MediaCatalog 改为使用官方相对路径生成全局媒体 URL，覆盖 GameData、Prologue 等目录并补齐 jpg 资源，避免叶子文件名误拼媒体根目录导致 403。同步更新测试、smoke 断言和运行文档。	2026-07-23 11:56:34 +08:00
nyaKazuhaandClaude Fable 5	0ab3f3b953	feat(download): 多线程下载 + 重试指数退避（issue #17） ... 下载主循环由串行改为「并发下载 + 串行簿记」三段式： - Phase A：无网络前置校验（官方性/目标路径/建目录）+ 判定跳过/需下载， 非官方 URL 在任何下载前 fail-fast - Phase B：need-download 项经 scoped 线程池并发下载（默认并发 4， 可配 1..=256）。worker 只做只读 &self 的 pull_one（各 URL 独立 .part/目标文件），经 mpsc 把结果送回主线程；manifest/quarantine 簿记与进度回调全在主线程串行执行，无需加锁。首个失败或 should_cancel 置 cancel 标志，其余 worker 在任务边界停止 - Phase C：按 plan 顺序串行收尾——seed .hash 校验（顺序相关、可 fail-fast）+ 构建有序结果 fail-fast 与「不发布不完整资源」不变量保留；进度事件按 URL 配对但 顺序不再单调（并发下天然如此）。 curl 重试加指数退避（网络类 200ms→400ms→800ms…上限 5s；ETXTBSY 仍走 极短退避），并发下对官方 CDN 更礼貌；退避基值 cfg(test) 下为 0 不拖慢 单测。 并发度经 OfficialUpdateConfig.download_concurrency 贯通，CLI --download-concurrency 与 BAT_DOWNLOAD_CONCURRENCY 可配，.env 模板 与 USERGUIDE/CURRENT_STATUS/CHANGELOG 同步。 验证：新增并发正确性测试（并发 8：每 URL 恰一次 started+finished、 全部落盘）、并发度钳制、退避时长计算、CLI/env 解析单测；progress 排序测试改为顺序无关不变量；workspace 全测试(20 套件) + fmt + clippy --all-targets -D warnings 全绿。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-18 03:25:04 -07:00
nyaKazuhaandClaude Fable 5	8efd8f36b4	feat(addressables): 提取 m_Crc 并提供 size/CRC 校验 API（issue #2） ... Addressables catalog 里的 m_Crc（bundle IEEE CRC-32）此前从未解析； 声明的 size 也只作元数据、无校验能力。本次： - ResourceEntry 新增 crc: Option<u32>（serde default 向后兼容）， compact 与 expanded 两种 catalog 形态均解析 m_Crc/m_Crc→crc - core 新增 crc32_ieee（IEEE CRC-32，等价 zlib/Unity m_Crc）与 ResourceEntry::{declared_crc, verify_downloaded_bytes}：按声明的 size/crc 校验字节，0 视为「无 CRC」跳过 - SqliteResourceRepository 持久化 crc 列，旧库经幂等 ensure_column 迁移补列（pragma_table_info 判断后 ALTER） - golden 投影与 fixture 补 crc 字段，验证真实形态 catalog 提取贯通 校验 API 暂不接入 import 覆盖路径（该路径按 CAS id 重写 hash/size 是 既定语义，且合成测试的声明值不匹配实际字节）；接入下载/导入校验留 待 G-011。 验证：core crc32 标准向量 + verify 分支单测、expanded 形态非零 crc 提取单测、golden 端到端；core/adapters/infrastructure 全测试 + fmt + clippy --all-targets -D warnings 全绿。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-18 02:41:41 -07:00
nyaKazuhaandClaude Fable 5	3edbe7ccee	feat(daemon): 任务历史文件态持久化与 .env 无参启动（issue #1） ... 任务持久化： - 任务历史落 <state-dir>/bat-tasks.json（版本化、0600 原子写、不跟随 symlink），生命周期转换时 write-through；seq 持久化避免 pid 复用撞 ID - daemon 重启恢复历史，中断时仍 queued/running 的任务标记 failed， 新增错误码 TASK_INTERRUPTED（BAT-ERR-700005） - 损坏文件改名 .corrupt 留证后从空历史开始；无法识别的记录计数跳过 - core 新增 ErrorCode::ALL 公开码表与 from_id 反查（持久化错误码往返） .env 配置： - 首次启动在二进制所在目录释放 .env 模板（0600、create_new 防竞态）， 之后每次启动加载为进程环境变量（不覆盖已存在变量） - 优先级：CLI > 进程环境变量 > .env > 内置默认；BAT_* 键映射到 CliOptions 默认值，BAT_WATCH/BAT_DAEMON 仅对无子命令 Run 生效且 CLI 显式模式/dry-run 时让位；Redis 键预留（未接入） - 工具/代理"非默认"判断改按 env 应用后基线，status/stop/logs 在 .env 存在时不误判；BAT_SKIP_ENV_FILE=1 整体禁用 验证：新增 10 个单测（env 解析/优先级/守卫回归/持久化往返/中断标记/ 损坏恢复/未知类型跳过）；真机 e2e：.env 释放加载、daemon 纯 .env 启动、 catalog.refresh 任务带类型化错误码落盘并跨 daemon 重启恢复（含日志）； fmt / clippy --workspace --all-targets -D warnings / test --workspace 全绿 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-17 21:15:47 -07:00
nyaKazuhaandClaude Fable 5	eac1edd455	feat(official-sync): 配置校验与 server-info/marker 拉取接入错误码 ... catalog.refresh 真机 e2e 暴露的缺口：任务配置校验失败落 900001，而 输入域码表（100xxx）早已定义却无使用点。本次接入： - 配置校验四处类型化（经 anyhow::Error::new 保留 DownloadError， task worker 现有 downcast 直接归类）： 缺少应用版本 → MISSING_APP_VERSION(100001)、 缺少连接组 → MISSING_CONNECTION_GROUP(100002)、 缺少服务器信息来源 → MISSING_SERVER_INFO_SOURCE(100003)、 GameMainConfig 缺 ServerInfoDataUrl → LAUNCHER_RESPONSE_INVALID (600004，launcher 链内容缺陷)。 - fetch_bytes 改返回 DownloadError：非官方 URL → NON_OFFICIAL_URL、 curl 失败保留准确网络域码。server-info / endpoint marker / 种子 catalog 拉取（5 处调用）由 anyhow::Error::msg 改 Error::new 保留 类型——发现阶段的网络失败此前全部落 internal，现携带 3xx 网络码。 测试：3 个配置校验错误码 downcast 断言 + fetch_bytes 双拒绝映射 （非官方 URL / 404）。真机 e2e：无 auto-discover 的 daemon 上 catalog.refresh → task.status 报 BAT-ERR-100001 missing_app_version （domain=input），修复前为 900001。全量 fmt / clippy --workspace --all-targets -D warnings / test --workspace 全绿。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-17 10:20:08 -07:00
nyaKazuhaandClaude Fable 5	11b19683cf	feat(daemon): 实现 catalog.* 命名空间与 resource.manifest（issue #1） ... 补齐 issue #1 方法分层中可立即实现的剩余命名空间： - catalog.status：当前已发布版本的 catalog 概览（读取其 snapshot： app/bundle 版本、connection group、addressables 根、端点与 marker 计数、launcher 元数据、GameMainConfig 摘要）。 - catalog.versions：版本历史（current / in_progress / previous / failed，来自 official-version-state.json）。 - catalog.diff：当前 snapshot 相对上一个可用版本的差异（复用 YostarJpSyncSnapshot::diff 与 diff_extended_snapshot；含 changed_endpoint_urls 与 previous_snapshot_missing 标志；无上一版本 时按首次观察处理 is_initial=true）。 - catalog.refresh：经任务执行器的 catalog 更新检查任务（dry-run + plan，不下载不审计；支持 force），返回 task_id 可轮询。 - resource.manifest：当前版本下载 manifest 的分页只读查询（offset 默认 0、limit 默认 100/上限 1000，BTreeMap 按 URL 有序保证分页稳定； 非法 limit → 700002）。infrastructure 公开 OfficialDownloadManifest(Entry) 与 read_download_manifest_at。 约定：只读查询在尚无已发布版本或文件缺失时返回 ok=true 且 data.available=false（正常状态而非错误，便于 Go 层直接分支）。 is_pending_rpc_method 缩减为 task.create / resource.repair / patch.* / unityfs.*（后两者待引擎；repair 待引擎独立修复模式）。 新增 read_daemon_resource_state 供 resource/catalog 只读查询共用。 测试：新增 10 个 dispatch 单测（含 fixture：状态文件 + 版本状态 + snapshot + manifest）与 read_download_manifest_at 单测；调整 pending 断言。真实 daemon 端到端验证（fixture 资源根 + 死代理快速失败）： raw socket 依次断言 catalog.status/versions/diff、resource.manifest 分页与参数错误、catalog.refresh 入队与 task.status 轮询、 resource.repair→700003、未知方法→700001，全部通过，daemon.stop 干净 退出。全量 fmt / clippy --workspace --all-targets -D warnings / test --workspace 全绿。 已知后续（另行推进）：任务配置校验失败（如缺少 app-version）尚未接入 输入域错误码（应为 100001，现落 900001）。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-17 10:10:03 -07:00
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 Opus 4.8	d4d6d0a686	fix(curl): 将 ETXTBSY 归为可重试的瞬时启动失败 ... 启动 curl 子进程时命中的 ETXTBSY（可执行文件忙）是多线程程序里 fork/exec 与"刚写出的可执行文件"之间的瞬时竞态：另一线程 fork 出的 子进程在 fork 与 execve 之间短暂持有目标文件的可写句柄，导致本次 exec 被内核判为忙。此前它被并入 ProcessFailed 且 retryable=false， per-URL 层直接放弃。 新增 CurlFailureKind::ProcessBusy（retryable=true），在 process_failed 中按 io::ErrorKind::ExecutableFileBusy 精确识别，并在 busy 重试前做 极短退避让兄弟进程完成 execve。生产中 curl 是固定系统二进制、从不 被并发改写，故此变更对真实下载无影响，仅消除集成测试在高并发下偶发的 "Text file busy" flake（fetch_bootstrap unwrap 失败）。 验证：以 8-10 并发 worker × 8 线程 / 4 核（≈64-80 线程超载）复现， 修复前首轮即挂；修复后 200+ 次超压运行零 ETXTBSY、零失败。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-17 07:30:20 -07:00
nyaKazuhaandClaude Fable 5	ab11cc899d	feat(official-sync): 下载失败携带类型化错误码 ... 用类型化错误(不做 message 匹配)把资源下载失败归到准确的 BAT-ERR 码: - curl_transfer：CurlFailureKind::error_code() 映射到网络域码(403→300001、 404→300002、5xx→300005、dns/connect/timeout/tls/interrupted→30001x、 proxy→310001、其余→300015)；CurlRetryError::final_error_code() 取末次失败的码。 - official_download：新增 pub DownloadError { code, message }，From<String>→internal， Display/Error；pull_* 的返回类型由 String 改为 DownloadError，内部 String 错误经 From 归 internal，下载失败边界带 pull_one 的 error_code()，非官方 URL 带 non_official_url(300030)。 - official_update：pull 错误改用 anyhow::Error::new 保留 DownloadError 类型。 - 任务 worker：downcast DownloadError 取 code 写入任务记录的 error（失败不再一律 900001），非下载失败仍归 internal。 验证：新增 kind→code 映射单测；pull 404 测试断言 DownloadError.code()==HTTP_NOT_FOUND； lib/core 全量测试通过，clippy --all-targets 干净。 范围说明:本次覆盖资源下载路径;launcher/metadata 拉取(official_launcher)的网络 失败仍归 internal,可按同一模式后续接入。 对应 issue #1（错误码细分映射，第一批）。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-17 07:01:31 -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	01ea5d8fa5	feat(daemon): 任务执行器 + 异步 resource.sync/verify（阶段 1b） ... 在 daemon 里加入任务模型，让 resource.sync/verify 经 RPC 触发即返回 task_id、 可轮询进度与最终结果： - 专用任务 worker 线程 + FIFO 队列（mpsc）；TaskRegistry 句柄包住内存态注册表 （HashMap，有界保留 64 条已结束任务，运行中/排队中不裁剪），方法访问便于将来 换 Redis 等持久化后端。 - 进程内 sync 锁：watch 循环与 worker 在跑同步前都获取它，互相等待而非撞 .official-sync.lock 文件锁失败；只在实际跑同步的那段持锁，空闲睡眠不持锁。 - resource.sync/resource.verify 入队返回 { task_id, kind }（envelope status=accepted）； worker 复用 run_with_progress_and_cancellation（sync 用 daemon config + force； verify 用 dry-run+plan+audit），进度写入任务记录，should_cancel 接 daemon 停止标志 （停机中止在途任务）。task.status/task.list 从注册表读真实数据。 验证：新增任务分发/入队/注册表单测（62 bin 测试全过）；真机端到端确认经裸 socket 触发 resource.sync 返回 task_id、轮询 task.status 走到最终态（fake curl 失败→ failed 且记录 error）、task.list 可见、resource.verify 亦入队。满足 issue #1 验收 「至少一个同步任务可经 RPC 触发并经 task.status 查询进度和最终结果」。 任务仅存内存（随 daemon 生死）；task.cancel/logs、错误码细分映射留待后续。 对应 issue #1（任务模型 + 最小方法集打通）。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-17 05:23:24 -07:00
nyaKazuhaandClaude Fable 5	b95a3ac417	feat(daemon): RPC 统一 envelope、命名空间分发与只读方法 ... 阶段 1a 的协议地基（承接错误码模型）： - 统一 envelope：所有响应装入 JSON-RPC 2.0 result 的 { ok, status, data, error, request_id }；error 用 bat_core::ApiError （含 BAT-ERR 码/kind/domain/location/retryable）。传输层解析失败仍走 JSON-RPC 顶层 error。request_id 为 req-<pid>-<seq>。 - 命名空间分发：方法改用国际惯例 <namespace>.<action>；daemon.* 为规范名， bat.* 保留为兼容别名（canonical_rpc_method 解析）。未知方法 → 700001， 已规划未实现（resource.sync/verify、catalog.*/patch.*/unityfs.* 等）→ 700003。 - 只读方法：daemon.status/logs/stop/reload/refresh（迁移）、resource.state（新增， 返回资源发布根 + 版本状态 + 上次同步结果）、task.status/task.list（任务库暂空， status → 700004，list → 空列表；执行器留待阶段 1b）。 - 客户端 daemon_rpc_call 解包 envelope（检查 ok、返回 data、把 error 转 Err）， CLI 调用方零改动。 验证：新增分发/别名/envelope 单测（60 bin 测试全过）；真机起停 daemon 端到端确认 daemon.status/logs/resource.state/task.list 经 CLI 与裸 socket 均正确返回 envelope， bat.* 别名生效，未知/未实现返回对应 BAT-ERR 码。 对应 issue #1（协议基础设施 + 最小只读方法集）。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-17 04:19:22 -07:00
nyaKazuhaandClaude Fable 5	232d74b617	fix(daemon): 串行化 bat-status.json 的读-改-写 ... watch 循环线程（update_daemon_status/update_daemon_progress）与 RPC 处理线程 （update_daemon_state_only）都会对状态文件做“读→改字段→写回”。单次写虽原子， 但整段读-改-写非原子，无互斥时并发线程会 last-writer-wins 丢失对方的字段更新。 新增进程级 DAEMON_STATUS_FILE_LOCK，三处读-改-写函数入口统一获取该锁串行化 （锁中毒时取 into_inner 继续，不 panic）。 对应 issue #18 维护清单 3-4。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-16 09:38:46 -07:00
nyaKazuhaandClaude Fable 5	0656ad05c7	refactor(official-sync): CLI 工程卫生清理 ... - doctor daemon_status 检查（3-3）：ok 与 message 原分别取自解析结果和文件存在性， 文件存在但解析失败时会“ok=false 却提示可解析”。改为从同一次解析结果派生两者。 - localize_error_message（3-1a）：空壳直通占位函数，删除并在 4 处调用点直接用消息。 - daemon 路径 helper 形参（3-1b）：output_root 实际语义是 state_dir，统一改名消除误导。 - stop_daemon 非 RPC 路径（3-1c）：删除无意义的 let-else（_pid 读后丢弃、两分支 逐字重复 stop_daemon_inner+print_report），stop_daemon_inner 内已做 PID 校验。 - parse_http_status（3-1d）：改为锚定 curl stderr 中 "error" 之后再取三位状态码， 避免误取端口/字节数等无关三位数字；新增锚定测试。 - 非 Unix process_exists（3-1e）：补注释说明保守返回 true 的理由（无法探测存活， 避免误回收可能仍在运行的 daemon）。 对应 issue #18 维护清单 3-1、3-3。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-16 09:35:31 -07:00
nyaKazuhaandClaude Fable 5	28e9ce5a6f	refactor(official-sync): 删除误导性的 skipped_this_run 字段并修正措辞 ... quarantine 条目的 skipped_this_run 字段恒写 true、仅测试读取、不参与任何逻辑， 且名称误导——下载失败是 fail-fast 中止整轮，并非“跳过该 URL 继续”。删除该字段， 并把失败消息中的“跳过本轮”改为“中止本轮同步、不发布不完整资源”以消除歧义。 （quarantine 为瞬时状态文件且未启用 deny_unknown_fields，旧文件多出的键会被忽略。） 对应 issue #18 维护清单 3-2。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-16 09:21:16 -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
nyaKazuhaandClaude Fable 5	c362fd80f4	fix(import): 导入失败回滚，find_bundle 拒绝同名歧义 ... - 非事务导入：import_manifest_bundles 中途某条目失败（如 AssetBundle 解析失败） 时，之前已写入的 CAS 对象和 ResourceRepository 行不回滚，留下部分导入状态。 改为记录本次写入的 object_id 与资源 id，任一条目失败时 best-effort 回滚 （删除资源行、对 store 增加的引用逐一 remove_reference）。 - find_bundle 跨目录同名：文件名回退无目录约束，jp/data.bundle 与 en/data.bundle 同名时可能静默取错数据。改为返回 Result：精确路径优先，文件名回退仅在唯一匹配 时采用，多个同名 bundle 时显式报错而非猜测。 新增单测：后续条目失败时回滚先前成功条目（资源行清空、CAS 引用回滚为 0）、 同名 bundle 歧义显式报错。 对应 issue #18 维护清单 2-2。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-16 08:29:27 -07:00
nyaKazuhaandClaude Fable 5	b570f37359	fix(official-sync): 区分代理故障并前置校验代理配置 ... - 代理故障分类：curl 因代理 407 认证失败（CONNECT 隧道失败）、无法解析/连接 代理等，原被归为普通可重试网络错误，永不成功也会耗尽 per-URL 重试且无诊断。 新增 CurlFailureKind::Proxy，从 curl stderr 识别代理故障，per-URL 层 fail-fast 不重试（daemon error-retry 循环仍整体重试以覆盖代理短暂抖动），并在失败摘要里 以 kind=proxy 明确标注。 - 前置校验：parse_proxy_config 新增 validate_proxy_url，拒绝拼错的代理 scheme （如 htp://），只接受 http/https/socks4/socks4a/socks5/socks5h 或无 scheme 的 host:port。 - doctor：proxy 检查不再恒 ok，对解析出的代理 URL（含 auto 从环境变量取得的） 做 scheme 校验，前置暴露配置错误。 新增单测：代理 407/解析失败归为 Proxy 且不重试、源站连接失败仍为 Connect 可重试、 拒绝不支持的 scheme、无 scheme host:port 接受。 对应 issue #18 维护清单 2-5。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-16 08:18:37 -07:00
nyaKazuhaandClaude Fable 5	f0fbe65429	fix(official-sync): 复用 staging 异常时退化为全量重下而非中止 ... recoverable_staging_path 对「staging 存在但不可用」（被外部替换成文件/symlink、 路径组件含 symlink、id 不匹配、路径逃逸等）一律返回 Err，经调用方 ? 中止整轮 同步。失败记录残留时每轮都会撞到同一异常而永久失败、无法自愈。 改为返回 Option<PathBuf>：任何无法安全复用的情况返回 None，走全量重下（始终安全 的 fail-closed 回退，复用文件仍逐一校验，不会发布损坏内容）。新增单测：staging 被替换成普通文件时不复用、返回 None 而非 Err。 对应 issue #18 维护清单 2-6。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-16 08:08:12 -07:00