feat(bat): 暴露翻译任务状态控制

Refs #43

docs/guides/bat-workflows.md

@@ -115,6 +115,22 @@ bat i18n publish \
 
 当前 `i18n run` 是离线工作流：刷新 TextUnit 队列，并可用 `--translation-file` 导出工作台；不会假装调用未接入的外部 provider。
 
+provider worker 消费 handoff 后，可以用 `i18n task update` 回写当前 release 的任务状态：
+
+```bash
+bat i18n task update \
+  --state-dir /tmp/bat-state \
+  --task-id textunit/v-current/TextAssets/Scenario.json \
+  --task-status failed \
+  --failure-reason "provider rejected payload" \
+  --provider-run-id provider-run-1 \
+  --json
+```
+
+`--task-status` 支持 Rust contract 中的 `queued`、`running`、`failed`、
+`completed` 和 `skipped`；命令只更新当前 release 的
+`translation-tasks.sqlite`，不会创建任意翻译任务。
+
 ## 持久化调度
 
 每个一级工作流都可以管理自己的 schedule。调度计划保存在 `--state-dir/bat-schedules.json`，计划记录包含动作、参数、下一次执行时间、周期、剩余次数、启用状态和最近错误。
@@ -170,6 +186,11 @@ contract：`id`、`group`、`action`、`args`、`next_run_unix_seconds`、
 `enabled`；`schedule.list` 额外接受 `id`、`group`、`enabled` 过滤，
 `schedule.run` 额外接受 `group`、`force` 和 `max_runs`。
 
+翻译任务状态也可由已鉴权的 dashboard 通过
+`POST /admin/control/translation-task-update` 回写，请求字段为
+`task_id`、`status`，以及可选的 `failure_reason`、`provider_run_id`；
+该接口只转发 `translation.task.update`。
+
 ## 边界
 
 解析器新增类型覆盖和新的解析格式仍受 `docs/reports/PARSER_FREEZE.md` 约束。本次 issue 43 的例外只开放已有解析输出的手动编排、缓存刷新、工作台编辑、既有 patch 实现的重打包和独立汉化发布，不扩展 UnityFS/AssetBundle/Addressables/TypeTree 的解析类型覆盖。

docs/reference/rpc-backend-api.md

@@ -391,6 +391,7 @@ CLI 对应关系：
 | `bat parse-errors` | `parse.errors` |
 | `bat translation-tasks` | `translation.tasks` |
 | `bat translation-handoff` | `translation.handoff` |
+| `bat i18n task update` | `translation.task.update` |
 | `bat localized-status` | `localized.status` |
 | `bat resource-index` | `resource.index` |
 
@@ -414,11 +415,11 @@ 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`、`task.*` 和三个
+  `localized.status`、`translation.task.update`、`task.*` 和三个
   `unityfs.patch_*` 方法。
-- `resource.index`、`translation.tasks`、`translation.handoff`、
-  `translation.task.update` 和 `patch.apply` 当前没有专用 typed helper；
-  需要直接使用 `Call`，并仍须遵守本契约的参数和响应定义。
+- `resource.index`、`translation.tasks`、`translation.handoff` 和
+  `patch.apply` 当前没有专用 typed helper；需要直接使用 `Call`，并仍须遵守
+  本契约的参数和响应定义。
 
 `internal/api` 对 bat-api 生产路径进一步收窄接口：
 
@@ -427,6 +428,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` | 鉴权后的 dashboard 翻译任务状态回写 |
 
 `daemon.stop`、`daemon.clean-stable` 和任意通用 RPC 不属于 bat-api 管理控制面。
 Rust dispatch、Go transport 和 bat-api 接口的权威实现位置分别是

docs/reports/CURRENT_GAPS.md

@@ -293,7 +293,7 @@ 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` RPC 已提供 queued/running/failed/completed/skipped 状态回写契约，provider worker 可在消费 handoff 后按 task_id 更新并由同一查询接口反查。
+- `translation.task.update` 已提供 queued/running/failed/completed/skipped 状态回写契约，并已通过 `bat i18n task update`、Go typed helper 和 bat-api 鉴权控制面暴露；provider worker 可在消费 handoff 后按 task_id 更新并由同一查询接口反查。
 - `i18n validate` 可在发布前校验工作台 release、source text、重复 patch 目标，并区分可直接发布的 TextAsset 与必须进入 `parse repack` 的条目；`parse clear-cache` 只删除可再生解析/队列 JSON，保留 `translation-tasks.sqlite` 的 worker 状态。
 - 真实 Crowdin 网络 worker、翻译记忆和完整 localized repack 仍属于后续翻译系统工作，不在当前 Rust 离线状态仓储范围内。
 

docs/reports/GO_STATUS.md

@@ -134,7 +134,7 @@ make build-go-cli   # 产出 bin/bat-go
 | 项 | 状态 |
 |---|---|
 | G-008 Go 同步 CLI | **已决策关闭**（正式同步 CLI = Rust `bat`） |
-| G-009 bat-api 资源 bootstrap/分发 | **部分完成**（MVP+生产控制面）；已含资源 bootstrap 关系面、launcher 资源 metadata 兼容、HTTP 鉴权/限流/日志/反代适配、RPC 周期刷新/诊断、readiness、OpenAPI、管理控制白名单、Rust-owned `schedule.*` dashboard 代理和部署模板，后续远程服务器联调/可选持久化 |
+| G-009 bat-api 资源 bootstrap/分发 | **部分完成**（MVP+生产控制面）；已含资源 bootstrap 关系面、launcher 资源 metadata 兼容、HTTP 鉴权/限流/日志/反代适配、RPC 周期刷新/诊断、readiness、OpenAPI、管理控制白名单、Rust-owned `schedule.*` dashboard 代理、`translation.task.update` 状态回写代理和部署模板，后续远程服务器联调/可选持久化 |
 | issue #19 | 资源面 MVP 与 USERGUIDE 基础章节已编码；真机联调后继续补充实战样例；**未自动关 issue** |
 | G-010 Web | 未开始 |