feat(i18n): 接入翻译 provider worker

Closes #44

docs/architecture/assetbundle.md

@@ -208,6 +208,6 @@ catalog 仍按“明确不支持”处理，不把低保真路径伪装成完整
 
 1. 完成 Addressables Windows/Android 当前版本 catalog 样本集合，关闭 G-007 当前阶段。
 2. 完成 TypeTree 字段 reader 和 MonoBehaviour/ScriptableObject 遍历，推进 G-005。
-3. 将 `crowdin-textunit-queue.json` 接入真实 Crowdin worker、翻译记忆和 Patch 构建。
-4. 将翻译任务状态接入 CAS/ResourceRepository 查询面，推进 G-011。
+3. 基于 `translation.worker.run` 推进翻译记忆和 Patch 构建。
+4. 扩展翻译任务结果在 CAS/ResourceRepository 查询面的索引，推进 G-011。
 5. 在通用 Binary/JSON/Text Patch 基础上继续扩展复杂 AssetBundle 重打包和发布流程统一，保留当前 UnityFS TextAsset patch 发布前置链路。

docs/architecture/official-resource-backend.md

@@ -179,8 +179,9 @@
 `resource.index` RPC / CLI 只读查询现有 SQLite 索引；索引不存在时返回
 `available=false`，不会因为查询创建空库。发布后的 TextUnit 队列还会在当前
 release 根目录写入 `translation-tasks.sqlite`，由版本化 `schema_migrations`
-管理 queued/running/failed/completed/skipped 和 failure reason。`translation.tasks`
-优先查询这份状态库，`translation.task.update` 供 provider worker 回写状态；
+管理 queued/running/failed/completed/skipped、provider run、lease、失败分类、
+重试计划和 TextUnit 级译文结果。`translation.tasks` 优先查询这份状态库，
+`translation.worker.run` 由 Rust worker 回写状态；`translation.task.update` 仍供外部 provider 流程回写状态；
 没有状态库的旧 release 才回退到 immutable JSON 队列。G-011 剩余工作是 CAS
 诊断入口和面向大索引的查询优化。
 

docs/guides/baseline.md

@@ -92,8 +92,8 @@ CAS V1 和 Rust 官方同步闭环完成后，下一阶段优先推进：
 
 1. 继续联调 Go `bat-api` 与 Rust daemon 的资源分发路径；Go 同步 CLI 不再作为产品目标。
 2. 按 `docs/guides/official-full-pull-smoke.md` 在隔离目录执行真实官方网络全量下载 smoke，并保留运行报告。
-3. 将 `crowdin-textunit-queue.json` 接入真实 Crowdin worker、翻译记忆和 Patch 构建。
-4. 扩展 ResourceRepository 查询面：真实 provider worker 集成与状态落库验证、CAS 诊断入口和更丰富 TextUnit 查询。
+3. 基于 `translation.worker.run` 推进翻译记忆和 Patch 构建。
+4. 扩展 ResourceRepository 查询面：CAS 诊断入口、面向大索引的查询优化和更丰富 TextUnit 查询。
 5. 继续完善 AssetBundle 复杂对象解析、复杂对象重打包和 Patch 发布流程统一；通用 Binary/JSON/Text Patch 基础与 UnityFS TextAsset patch 发布前置链路已可用。
 
 优先阅读：

docs/guides/bat-workflows.md

@@ -133,9 +133,30 @@ bat i18n publish \
 
 发布只接受当前实现支持的直接 TextAsset 条目；TypeTree 字段和 zip 内 bundle 使用 `parse repack` 的 spec 单独处理。`--force` 不覆盖已有目录，而是生成独立的 `<official-release>-manual-<unix-seconds>` 汉化 release ID；也可以用 `--localized-release-id` 显式指定新 ID。因此强制发布仍保留旧 release 和 rollback 信息。
 
-当前 `i18n run` 是离线工作流：刷新 TextUnit 队列，并可用 `--translation-file` 导出工作台；不会假装调用未接入的外部 provider。
+当前 `i18n run` 是离线工作流：刷新 TextUnit 队列，并可用 `--translation-file` 导出工作台；真实 provider 由单独的 worker 命令消费 `translation-tasks.sqlite`。
 
-provider worker 消费 handoff 后，可以用 `i18n task update` 回写当前 release 的任务状态：
+运行一次 mock provider worker：
+
+```bash
+bat i18n worker run \
+  --output /tmp/bat-resources \
+  --provider mock \
+  --worker-concurrency 8
+```
+
+`--provider` 支持 `mock` 和 `crowdin`。`mock` 可通过 `--translation-fixture`
+读取本地 JSON fixture；`crowdin` 从环境变量 `CROWDIN_PROJECT_ID`、
+`CROWDIN_LANGUAGE_ID`、`CROWDIN_API_TOKEN` 读取配置。worker 默认并发为 8，
+范围 `1..=256`；每个 worker 完成当前任务后立即从 SQLite 队列领取下一项，
+不会等待当前一批 worker 全部结束后再重新分配。
+
+可用参数包括 `--worker-max-attempts`、`--worker-lease-seconds`、
+`--worker-retry-backoff` / `--worker-retry-backoff-seconds`、
+`--worker-max-tasks` 和 `--worker-id`。worker 支持 `--run-count` 与
+`--watch`，因此可以单次、限定次数或周期执行；`--run-count > 1` 时仍必须
+显式指定 `--interval`。
+
+外部 provider 或人工流程也可以用 `i18n task update` 回写当前 release 的任务状态：
 
 ```bash
 bat i18n task update \
@@ -224,11 +245,24 @@ contract：`id`、`group`、`action`、`args`、`next_run_unix_seconds`、
 `enabled`；`schedule.list` 额外接受 `id`、`group`、`enabled` 过滤，
 `schedule.run` 额外接受 `group`、`force` 和 `max_runs`。
 
+翻译任务状态可由已鉴权的 dashboard 通过 `GET /admin/translation/tasks`
+查询，query 过滤项包括 `offset`、`limit`、`task_id`、`release_id`、
+`destination`、`path_pattern`、`archive_entry`、`status`、`worker_status`、
+`parse_status`、`format`、`has_reason` 和 `has_failure_reason`。完整 provider
+run 交接视图通过 `GET /admin/translation/handoff` 查询。两个查询接口都只转发
+Rust `translation.tasks` / `translation.handoff`，不在 Go 侧维护状态。
+
 翻译任务状态也可由已鉴权的 dashboard 通过
 `POST /admin/control/translation-task-update` 回写，请求字段为
 `task_id`、`status`，以及可选的 `failure_reason`、`provider_run_id`；
 该接口只转发 `translation.task.update`。
 
+`POST /admin/control/translation-worker-run` 会触发 Rust 侧
+`translation.worker.run`，请求字段为 `provider`、`fixture_path`、
+`concurrency`、`max_attempts`、`lease_seconds`、`retry_backoff_seconds`、
+`max_tasks` 和 `worker_id`。bat-api 只做鉴权、JSON 解码和基础范围校验；
+任务状态、lease、重试和 provider 结果仍由 Rust 持久化。
+
 `POST /admin/control/translation-proofread` 会把当前汉化 workflow 标记为人工校对中；
 该接口只转发 `translation.proofread`，不会改动已发布汉化 release 指针。
 

docs/guides/development.md

@@ -258,6 +258,7 @@ cargo run -p bat-infrastructure --bin bat -- parse-errors --limit 50
 cargo run -p bat-infrastructure --bin bat -- translation-tasks --task-status skipped_parse_failed --has-reason --limit 50
 cargo run -p bat-infrastructure --bin bat -- translation-tasks --worker-status failed --has-failure-reason --limit 50
 cargo run -p bat-infrastructure --bin bat -- translation-handoff
+cargo run -p bat-infrastructure --bin bat -- i18n worker run --provider mock --worker-concurrency 8 --worker-max-tasks 10
 cargo run -p bat-infrastructure --bin bat -- localized-status
 cargo run -p bat-infrastructure --bin bat -- resource-index --limit 50
 cargo run -p bat-infrastructure --bin bat -- resource-index --release-id <ID> --platform windows --archive-entry <PATH> --format json --limit 50
@@ -270,6 +271,9 @@ cargo run -p bat-infrastructure --bin bat -- resource-index --release-id <ID> --
 worker 状态、parse status、TextUnit format、队列 reason 和 provider failure reason
 查询离线 TextUnit 翻译任务状态与跳过/失败原因；发布后的状态保存在当前 release
 根目录的 `translation-tasks.sqlite`，旧 release 没有状态库时回退到 JSON 队列；
+`i18n worker run` / `translation.worker.run` 会由 Rust provider worker 独立 claim
+下一项任务并落库 lease、失败分类、重试计划和 TextUnit 级译文结果，默认并发为 8，
+范围 `1..=256`；
 `translation-handoff` / `translation.handoff` 会动态合并版本化
 `translation-handoff.json` 与 SQLite 状态，返回 job、unit、provider run 的完整交接
 视图；

docs/reference/rpc-backend-api.md

@@ -150,11 +150,12 @@ SQLite `ResourceRepository`，索引不存在时返回 `ok=true` 且
   本地文件未变且索引有效时复用，不重复解析。
 - `official-textunit-tasks.json`：只由 added + modified 资源、parse cache 和
   TextUnit 明细索引派生，记录 TextUnit 任务、跳过原因和解析诊断。
-- `crowdin-textunit-queue.json`：只包含已产生 TextUnit 的离线任务，预留给后续
-  Crowdin worker；当前不会发出网络请求。
+- `crowdin-textunit-queue.json`：只包含已产生 TextUnit 的离线任务；官方同步阶段
+  不发出 provider 网络请求。
 - `translation-tasks.sqlite`：当前 release 的可变 worker 状态库，记录
   queued / running / failed / completed / skipped、attempt count、provider run
-  ID 和 failure reason；schema 由 `schema_migrations` 版本表管理。
+  ID、provider、TextUnit 级译文结果、lease、失败分类、可重试标记和
+  next attempt；schema 由 `schema_migrations` 版本表管理。
 - `translation-handoff.json`：当前 release 的版本化 job/unit/provider run 交接
   快照；worker 更新后的实时状态仍以 `translation-tasks.sqlite` 为准。
 
@@ -206,6 +207,7 @@ SQLite `ResourceRepository`，索引不存在时返回 `ok=true` 且
 | `translation.tasks` | 已实现 | `{ "offset": 0, "limit": 100, "task_id": "...", "release_id": "...", "destination": "...", "archive_entry": "...", "status": "skipped_parse_failed", "parse_status": "failed", "format": "json", "has_reason": true }` | 当前官方 release 的离线 TextUnit 翻译任务状态分页。 |
 | `translation.handoff` | 已实现 | `null` | 当前官方 release 的 job、unit、provider run 交接视图；动态合并队列和 SQLite worker 状态。 |
 | `translation.task.update` | 已实现 | `{ "task_id": "...", "status": "failed", "failure_reason": "...", "provider_run_id": "..." }` | 写入当前 release 的 provider worker 状态，返回可回查任务记录。 |
+| `translation.worker.run` | 已实现 | provider worker 参数 | 异步触发 Rust provider worker，返回 `{ "task_id": "...", "kind": "translation.worker.run", "worker": {...} }`。 |
 | `translation.proofread` | 已实现 | `null` | 将当前汉化 workflow 标记为人工校对中，返回工作流状态报告。 |
 
 `parse.status` 是只读查询；没有当前 release 或没有解析缓存时返回
@@ -215,8 +217,8 @@ SQLite `ResourceRepository`，索引不存在时返回 `ok=true` 且
 `textunit_index_summary`；存在 `official-textunit-tasks.json` 时，响应会包含
 `textunit_queue_available=true`、`textunit_task_queue_path` 和
 `textunit_task_summary`。当 TextUnit 队列存在且有离线任务时，
-`translation_status_code=translation.queued_offline`；真实 Crowdin worker
-尚未接入时不会返回翻译完成状态。
+`translation_status_code=translation.queued_offline`；provider worker 完成任务后，
+同一查询面会返回已落库的 worker 状态和 TextUnit 级译文结果。
 
 `parse.text_units` / `parse.errors` 是只读查询；没有当前 release 或没有
 `official-textunit-index.json` 时返回 `ok=true` 且 `data.available=false`。
@@ -260,6 +262,31 @@ bat-api 可通过 `translation.tasks` 查询单项任务，也可通过
 不会触发下载或 provider 网络请求；没有当前 release 或任务队列时返回
 `data.available=false`。
 
+`translation.worker.run` 通过 daemon 任务队列异步启动 Rust provider worker。
+provider worker 会先同步当前 release 的 TextUnit 队列到
+`translation-tasks.sqlite`，回收过期 lease，然后由 `concurrency` 个独立 worker
+循环 claim 下一项任务；任一 worker 完成当前任务后会立即领取下一项，不等待
+其他 worker 完成本轮批次。默认并发为 8，范围 `1..=256`。
+
+provider worker 参数：
+
+| 字段 | 类型 | 默认 | 说明 |
+|---|---|---|---|
+| `provider` | string | `mock` | `mock` 或 `crowdin`。 |
+| `fixture_path` | string/null | `null` | mock provider fixture；别名为 `translation_fixture`、`provider_fixture`、`mock_fixture`、`fixture`。 |
+| `concurrency` | uint | `8` | 独立 worker 数，范围 `1..=256`；别名为 `worker_concurrency`、`translation_concurrency`。 |
+| `max_attempts` | uint | `3` | 单个任务最大 claim 次数，必须大于 0。 |
+| `lease_seconds` | uint | `300` | claim lease 秒数，必须大于 0。 |
+| `retry_backoff_seconds` | uint | `5` | 可重试 provider 失败的 next attempt 间隔，可为 0。 |
+| `max_tasks` | uint/null | `null` | 本轮最多 claim 的任务数，设置时必须大于 0。 |
+| `worker_id` | string | `bat-rpc-worker` | lease 诊断用 worker ID 前缀。 |
+
+数字字段必须是 JSON number；字符串数字、负数和越界值会返回
+`BAT-ERR-700002`。`mock` provider 在没有 fixture 时把 source text 写成可诊断的
+mock 译文；`crowdin` provider 从 `CROWDIN_PROJECT_ID`、`CROWDIN_LANGUAGE_ID`、
+`CROWDIN_API_TOKEN` 读取配置，可选 `CROWDIN_API_BASE_URL` 和 `BAT_CURL`。
+token 不会进入报告、任务记录或调试输出。
+
 ### localized
 
 | 方法 | 状态 | params | data |
@@ -397,6 +424,7 @@ CLI 对应关系：
 | `bat translation-handoff` | `translation.handoff` |
 | `bat i18n task list` / `bat i18n task status` | `translation.tasks` |
 | `bat i18n task update` | `translation.task.update` |
+| `bat i18n worker run` | `translation.worker.run` |
 | `bat i18n proofread` | `translation.proofread` |
 | `bat localized-status` | `localized.status` |
 | `bat resource-index` | `resource.index` |
@@ -424,10 +452,10 @@ CLI 对应关系：
 - typed helper 已覆盖 daemon 已实现方法（`status/logs/stop/restart/reload/refresh/doctor`）、
   `resource.state/sync/verify/repair/manifest/list`、`schedule.list/add/update/remove/run`、
   `catalog.*`、`parse.*`、
-  `localized.status`、`translation.task.update`、`translation.proofread`、`task.*` 和三个
-  `unityfs.patch_*` 方法。
-- `resource.index`、`translation.tasks`、`translation.handoff` 和
-  `patch.apply` 当前没有专用 typed helper；需要直接使用 `Call`，并仍须遵守
+  `localized.status`、`translation.tasks`、`translation.handoff`、
+  `translation.task.update`、`translation.worker.run`、`translation.proofread`、
+  `task.*` 和三个 `unityfs.patch_*` 方法。
+- `resource.index` 和 `patch.apply` 当前没有专用 typed helper；需要直接使用 `Call`，并仍须遵守
   本契约的参数和响应定义。
 
 `internal/api` 对 bat-api 生产路径进一步收窄接口：
@@ -437,7 +465,7 @@ CLI 对应关系：
 | `Backend` | `daemon.status`、`daemon.doctor`、`resource.state`、`catalog.status`、`resource.manifest` | 启动发现、周期刷新和资源分发 |
 | `ControlBackend` | `daemon.restart`、`daemon.reload`、`daemon.refresh`、`resource.sync`、`resource.verify`、`resource.repair`、`catalog.refresh` | 鉴权后的管理控制白名单 |
 | `ScheduleBackend` | `schedule.list`、`schedule.add`、`schedule.update`、`schedule.remove`、`schedule.run` | 鉴权后的 dashboard 调度计划控制 |
-| `TranslationBackend` | `translation.task.update`、`translation.proofread` | 鉴权后的 dashboard 翻译任务状态回写与人工校对标记 |
+| `TranslationBackend` | `translation.tasks`、`translation.handoff`、`translation.task.update`、`translation.worker.run`、`translation.proofread` | 鉴权后的 dashboard 翻译任务查询、交接视图、状态回写、provider worker 触发与人工校对标记 |
 
 `daemon.stop`、`daemon.clean-stable` 和任意通用 RPC 不属于 bat-api 管理控制面。
 Rust dispatch、Go transport 和 bat-api 接口的权威实现位置分别是

docs/reports/CURRENT_GAPS.md

@@ -232,8 +232,8 @@ issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、Typ
 - `cmd/bat-api`：组织 Rust `bat` 已发布 release 的启动前资源入口，并只读分发官方 CDN host/path 形态资源。
 - **拉取归属 Rust `bat`**；`bat-api` 不做下载器。
 - 发现经 `bat.sock`：先 `daemon.status`，再 `daemon.doctor`，再 `catalog.status` / `resource.manifest`。
-- Rust RPC 的 `resource.state`、`catalog.status`、`parse.status` 和 `localized.status` 会返回短状态 `status` 与稳定生命周期状态码 `status_code`；`backendrpc` 已提供对应 client 能力，当前 `bat-api` 发现流程只消费 `resource.state`、`catalog.status`、`resource.manifest`，parse/localized 不由 HTTP surface 暴露；错误原因仍以 `BAT-ERR-*` 为准。
-- `bat-api` 可通过受限 Web 控制面转发 `reload` / `refresh` / `restart` / `sync` / `verify` / `repair` / `catalog-refresh`，这些控制动作均走 Rust live RPC；`parse.*`、`localized.status` 和文件级 `unityfs.patch_*` 属于 `backendrpc` 能力，但当前不由 HTTP surface 暴露；`daemon.clean-stable` 等危险或离线生命周期命令不经 Web 转发。
+- Rust RPC 的 `resource.state`、`catalog.status`、`parse.status` 和 `localized.status` 会返回短状态 `status` 与稳定生命周期状态码 `status_code`；`backendrpc` 已提供对应 client 能力，当前 `bat-api` 发现流程只消费 `resource.state`、`catalog.status`、`resource.manifest`，translation task/handoff 通过受鉴权的 admin 查询端点暴露，parse/localized 不由 HTTP surface 暴露；错误原因仍以 `BAT-ERR-*` 为准。
+- `bat-api` 可通过受限 Web 控制面转发 `reload` / `refresh` / `restart` / `sync` / `verify` / `repair` / `catalog-refresh`，并通过 translation admin 端点查询/回写任务、触发 provider worker 和标记人工校对；这些动作均走 Rust live RPC；`parse.*`、`localized.status` 和文件级 `unityfs.patch_*` 属于 `backendrpc` 能力，但当前不由 HTTP surface 暴露；`daemon.clean-stable` 等危险或离线生命周期命令不经 Web 转发。
 - 生产与 Rust `bat` 同环境运行，资源根来自 RPC 返回的 `resource_root`；`--resource-root` 仅用于 fixture 或应急只读诊断。
 - `.env` 配置端口 / public base / RPC socket / RPC 刷新周期；预留 database/redis。
 - `/v1/bootstrap` 返回 RPC 健康、release 摘要、server-info URL、client-patch base 和改写后的 Addressables root。
@@ -294,9 +294,9 @@ issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、Typ
 - 官方 release 发布后还会写入版本化 `translation-handoff.json`；`translation.handoff` RPC/CLI 动态合并该快照与 SQLite worker 状态，暴露 job、unit、provider run、attempt 和 failure reason。
 - `translation-tasks.sqlite` 由 `schema_migrations` 管理 durable task state、attempt count、provider run ID 和 failure reason；重复同步会保留已有 worker 状态。
 - `translation.tasks` RPC/CLI 优先查询 `translation-tasks.sqlite`，旧 release 没有状态库时回退到 `official-textunit-tasks.json`；返回队列 `status`、worker `task_status`、failure reason 和时间/尝试次数。
-- `translation.task.update` 已提供 queued/running/failed/completed/skipped 状态回写契约，并已通过 `bat i18n task update`、Go typed helper 和 bat-api 鉴权控制面暴露；`translation.proofread` 已提供人工校对状态标记契约，provider worker 可在消费 handoff 后按 task_id 更新并由同一查询接口反查。
+- `translation.tasks` / `translation.handoff` 已提供 Go typed helper 和 bat-api 鉴权查询端点；`translation.task.update` 已提供 queued/running/failed/completed/skipped 状态回写契约，并已通过 `bat i18n task update`、Go typed helper 和 bat-api 鉴权控制面暴露；`translation.worker.run` 已提供 Rust provider worker，支持 mock/Crowdin、独立 claim、lease、失败分类、重试和 TextUnit 级译文结果落库；`translation.proofread` 已提供人工校对状态标记契约。
 - `i18n get/set/unset` 可查看、修改或清空单条工作台译文，`i18n validate` 可在发布前校验工作台 release、source text、重复 patch 目标，并区分可直接发布的 TextAsset 与必须进入 `parse repack` 的条目；`i18n proofread` 可把当前汉化 workflow 标记为人工校对中，且不会遮蔽已发布汉化 release；`parse clear-cache` 只删除可再生解析/队列 JSON，保留 `translation-tasks.sqlite` 的 worker 状态。
-- 真实 Crowdin 网络 worker、翻译记忆和完整 localized repack 仍属于后续翻译系统工作，不在当前 Rust 离线状态仓储范围内。
+- 翻译记忆和完整 localized repack 仍属于后续翻译系统工作，不在当前 provider worker 状态闭环范围内。
 
 验收：
 

docs/reports/GO_STATUS.md

@@ -95,7 +95,7 @@
 | 组件 | 路径 | 状态 | 说明 |
 |---|---|---|---|
 | Module | `go.mod` → `bat-api` | 已用 | 服务层模块名 |
-| RPC client | `internal/backendrpc` | **完成** | Unix socket JSON-RPC transport + typed helper；typed helper 覆盖 daemon 已实现控制/查询、`resource.state/sync/verify/repair/manifest/list`、`catalog.*`、`parse.*`、`localized.status`、`task.*`、`translation.task.update`、`translation.proofread` 和文件级 UnityFS patch 调用；`resource.index`、其余 `translation.*`、`patch.apply` 仍通过通用 `Call` 走同一 contract；fake transport 单测，配合 `internal/api/testdata/contract/` 固化 Rust 输出 mirror |
+| RPC client | `internal/backendrpc` | **完成** | Unix socket JSON-RPC transport + typed helper；typed helper 覆盖 daemon 已实现控制/查询、`resource.state/sync/verify/repair/manifest/list`、`catalog.*`、`parse.*`、`localized.status`、`task.*`、`translation.tasks`、`translation.handoff`、`translation.task.update`、`translation.worker.run`、`translation.proofread` 和文件级 UnityFS patch 调用；`resource.index`、`patch.apply` 仍通过通用 `Call` 走同一 contract；fake transport 单测，配合 `internal/api/testdata/contract/` 固化 Rust 输出 mirror |
 | 资源 bootstrap/分发 | `cmd/bat-api` + `internal/api` | **MVP+生产控制面** | RPC 发现 + 周期刷新/诊断 + `/v1/bootstrap` + `/v1/launcher/bootstrap` + launcher 资源 metadata 兼容 + `/readyz` + CDN Range/缓存头 + 鉴权/限流/访问日志/反代适配 + OpenAPI + 管理控制白名单 + `.env` |
 | 试验 CLI | `cmd/bat` | **试验** | doctor 固定 ok；manifest/sync 走 FFI |
 | FFI | `internal/ffi` | **可选** | 需 `build-ffi` |