feat(bat): 补全工作流命令与人工校对状态

Refs #43

docs/architecture/official-resource-backend.md

@@ -237,7 +237,7 @@ release 根目录写入 `translation-tasks.sqlite`，由版本化 `schema_migrat
 13. 发布完成后先对比上一完整 release 和当前 release 的 `official-download-manifest.json`，写出 `official-resource-changes.json` 和 `crowdin-translation-handoff.json`。同一 destination 只有 size 或 BLAKE3 变化才算 modified；新增+变更资源进入解析/翻译 handoff，删除资源只进入差异记录。当前只预留 Crowdin 本地 handoff，不发外部 API 请求。
 14. 随后刷新 active release 下的 `official-parse-cache.json` 和 `official-textunit-index.json`，并从 Added/Modified 资源、parse cache 与 TextUnit 明细索引派生 `official-textunit-tasks.json`、`crowdin-textunit-queue.json` 和版本化的 `translation-tasks.sqlite`；up-to-date 轮询在已有有效解析缓存、TextUnit 明细索引和 TextUnit 队列时只读取摘要，不重复解析，重新同步队列时保留已有 worker 状态。
 15. 若启用 `--import-repository`，已校验 release 会被导入 CAS + `ResourceRepository`，并可经 `resource.index` 查询。
-16. 官方同步报告默认给出 `localized_release_status=not_localized`，表示原版资源已发布、汉化资源未发布；UnityFS TextAsset patch 发布成功并通过 `localized-patch-manifest.json`、current symlink 和 release ID 校验后，`localized.status` 才返回 `localized`，表示原版和汉化两套资源都已发布。
+16. 官方同步报告默认给出 `localized_release_status=not_localized`，表示原版资源已发布、汉化资源未发布；UnityFS TextAsset patch 发布成功并通过 `localized-patch-manifest.json`、current symlink 和 release ID 校验后，`localized.status` 才返回 `localized`，表示原版和汉化两套资源都已发布。`translation.proofread` 只会把 workflow 标记成 `manual_proofreading` / `translation.manual_proofreading`，不会回退已发布汉化 release 的发布状态。
 
 维护期特殊分支：如果官方 launcher/server-info 已经指向新资源根，但 client-patch seed marker 或必需 seed catalog 仍返回 403/404 等未开放状态，`bat` 返回 `waiting_for_official_resources`，保留现有 `current`，不创建失败 staging；若本轮启用 `--auto-discover`，会在 `<output>/official-launcher-bootstrap.pending.json` 写入待处理 launcher bootstrap 证据，供后续排障和自研客户端开发使用。
 
@@ -337,7 +337,7 @@ JSON-RPC 2.0 服务，是面向上层服务（Go 层）的**主要跨语言边
 - 方法命名空间与实现状态、请求/响应示例见
   `docs/reference/rpc-backend-api.md`：`daemon.status/logs/stop/restart/reload/refresh/doctor`、
   `resource.state/sync/verify/repair/manifest/list/index`、`parse.status/text_units/errors`、
-  `translation.tasks/handoff/task.update`、`localized.status`、`catalog.*` 与
+  `translation.tasks/handoff/task.update/proofread`、`localized.status`、`catalog.*` 与
   `task.status/list/cancel/logs` 已实现；文件级 `patch.apply` / `unityfs.patch_*`
   已实现，发布级 patch 与复杂 UnityFS 语义编辑待引擎；
   `task.create` 按设计暂不开放通用任务入口；

docs/guides/bat-workflows.md

@@ -6,7 +6,7 @@ Rust `bat` 的工作流入口按三个一级命令组织：
 - `parse`：当前官方 release 的解析和 UnityFS 重打包。
 - `i18n`：离线翻译工作台、人工文本修改和汉化 release 发布。
 
-`resource`、`resources`、`translation` 和 `translate` 仍作为长别名接受，但文档示例统一使用 `res` 和 `i18n`。
+`resource`、`resources`、`translation` 和 `translate` 仍作为长别名接受，但文档示例统一使用 `res` 和 `i18n`；例如 `resource status`、`resource schedule`、`translation tasks`、`translation handoff` 和 `translation status` 都会落到同一组已实现命令。
 
 ## 资源拉取
 
@@ -106,7 +106,8 @@ bat i18n unset \
   --translation-id <text-unit-id>
 ```
 
-这些工作台操作也可以写成 `bat i18n workbench set|get|unset|validate ...`。
+这些工作台操作也可以写成 `bat i18n workbench set|get|unset|validate ...`，
+`--translation-file` 也可简写为 `--workbench`。
 工作台会保存 source text、release ID、TextUnit 目标和人工译文；发布前会重新读取当前
 TextUnit 索引，拒绝过期 release、source text 或 patch 目标。
 
@@ -149,10 +150,27 @@ bat i18n task update \
 `--task-status` 支持 Rust contract 中的 `queued`、`running`、`failed`、
 `completed` 和 `skipped`；命令只更新当前 release 的
 `translation-tasks.sqlite`，不会创建任意翻译任务。
+任务查询和交接查询可以用 `bat i18n tasks` / `bat i18n handoff`；
+汉化发布状态可以用 `bat i18n status`。这些只读入口也可以写成
+`bat translation tasks|handoff|status`，其中 `translation` / `translate`
+是一级命令长别名。
+
+需要把当前汉化 workflow 切到人工校对中时，可用：
+
+```bash
+bat i18n proofread \
+  --output /tmp/bat-resources \
+  --localized-output /tmp/bat-localized
+```
+
+该命令只改写 `localized-version-state.json` 中的工作流标记，不会改动已发布的
+汉化 release 指针；如果自动汉化已经发布，后续仍可继续正常发布汉化资源。
 
 ## 持久化调度
 
 每个一级工作流都可以管理自己的 schedule。调度计划保存在 `--state-dir/bat-schedules.json`，计划记录包含动作、参数、下一次执行时间、周期、剩余次数、启用状态和最近错误。
+`parse schedule` 与 `res schedule` / `i18n schedule` 共用同一份计划库，
+`--id` / `--action` 分别是 `--schedule-id` / `--schedule-action` 的简写。
 
 新增一个每天执行的资源拉取计划：
 
@@ -175,6 +193,7 @@ bat res schedule list --state-dir /tmp/bat-schedule
 bat res schedule update --state-dir /tmp/bat-schedule --schedule-id daily-pull --schedule-every 12h
 bat res schedule remove --state-dir /tmp/bat-schedule --schedule-id daily-pull
 bat res schedule run --state-dir /tmp/bat-schedule
+bat parse schedule list --state-dir /tmp/bat-schedule
 ```
 
 `parse schedule add` 默认动作是 `run`，`i18n schedule add` 默认动作也是 `run`；可以用 `--schedule-action repack` 或 `--schedule-action publish` 选择对应动作。`--schedule-count` 限定执行次数，省略表示周期无限执行；没有 `--schedule-every` 的计划执行一次后自动停用。
@@ -210,6 +229,9 @@ contract：`id`、`group`、`action`、`args`、`next_run_unix_seconds`、
 `task_id`、`status`，以及可选的 `failure_reason`、`provider_run_id`；
 该接口只转发 `translation.task.update`。
 
+`POST /admin/control/translation-proofread` 会把当前汉化 workflow 标记为人工校对中；
+该接口只转发 `translation.proofread`，不会改动已发布汉化 release 指针。
+
 ## 边界
 
 解析器新增类型覆盖和新的解析格式仍受 `docs/reports/PARSER_FREEZE.md` 约束。本次 issue 43 的例外只开放已有解析输出的手动编排、缓存刷新、工作台编辑、既有 patch 实现的重打包和独立汉化发布，不扩展 UnityFS/AssetBundle/Addressables/TypeTree 的解析类型覆盖。

docs/guides/development.md

@@ -273,7 +273,10 @@ worker 状态、parse status、TextUnit format、队列 reason 和 provider fail
 `resource-index` 返回的资源 JSON 包含 release、平台、bundle path、TextAsset 和 TextUnit metadata，
 并可按 release、平台、destination、bundle path、archive entry、parse status 和 TextUnit format 做资源级过滤；
 `localized-status` 只有在 `localized-version-state.json`、`current` symlink 和
-`localized-patch-manifest.json` 都匹配当前官方 release 时才返回 `localized`。
+`localized-patch-manifest.json` 都匹配当前官方 release 时才返回 `localized`；
+当 workflow 被 `translation.proofread` 标记为人工校对中时，会额外返回
+`translation_workflow_status=manual_proofreading` 与
+`translation_workflow_status_code=translation.manual_proofreading`，但不会遮蔽已发布的汉化 release。
 
 文件级写入命令只处理显式输入/输出文件，不切换官方或汉化 release：
 

docs/reference/rpc-backend-api.md

@@ -205,6 +205,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.proofread` | 已实现 | `null` | 将当前汉化 workflow 标记为人工校对中，返回工作流状态报告。 |
 
 `parse.status` 是只读查询；没有当前 release 或没有解析缓存时返回
 `ok=true` 且 `data.available=false`。解析缓存来自官方原版资源目录，不读取
@@ -270,7 +271,9 @@ bat-api 可通过 `translation.tasks` 查询单项任务，也可通过
 `status` / `status_code` 使用生命周期短状态和稳定状态码，例如
 `pending` / `localized.pending`、`stale` / `localized.stale`、`published` /
 `localized.published`；旧的 `localized` / `not_localized` 业务标签放在
-`localized_release_status`。返回 `localized_release_status=localized` 的条件是：
+`localized_release_status`。`translation_workflow_status` / `translation_workflow_status_code`
+用于表示汉化工作流的人工校对状态，例如 `manual_proofreading` /
+`translation.manual_proofreading`。返回 `localized_release_status=localized` 的条件是：
 `localized-version-state.json` 的官方 release ID 匹配当前官方 release，
 `current` symlink 指向汉化发布根下对应的 `versions/<id>`，并且该版本目录中的
 `localized-patch-manifest.json` 存在且 release ID 匹配。响应会返回
@@ -391,10 +394,15 @@ CLI 对应关系：
 | `bat parse-errors` | `parse.errors` |
 | `bat translation-tasks` | `translation.tasks` |
 | `bat translation-handoff` | `translation.handoff` |
+| `bat i18n task list` / `bat i18n task status` | `translation.tasks` |
 | `bat i18n task update` | `translation.task.update` |
+| `bat i18n proofread` | `translation.proofread` |
 | `bat localized-status` | `localized.status` |
 | `bat resource-index` | `resource.index` |
 
+`bat translation-tasks` / `bat i18n tasks`、`bat translation-handoff` / `bat i18n handoff`、
+`bat localized-status` / `bat i18n status` 都对应同一 RPC；这里列出的是推荐命令形态。
+
 `bat resource-index` 支持 `--offset`、`--limit`、`--resource-type`、`--hash`、
 `--path-pattern`、`--release-id`、`--platform`、`--destination`、
 `--bundle-path`、`--archive-entry`、`--parse-status` 和 `--format`；
@@ -415,7 +423,7 @@ 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`、`task.*` 和三个
+  `localized.status`、`translation.task.update`、`translation.proofread`、`task.*` 和三个
   `unityfs.patch_*` 方法。
 - `resource.index`、`translation.tasks`、`translation.handoff` 和
   `patch.apply` 当前没有专用 typed helper；需要直接使用 `Call`，并仍须遵守
@@ -428,7 +436,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 翻译任务状态回写 |
+| `TranslationBackend` | `translation.task.update`、`translation.proofread` | 鉴权后的 dashboard 翻译任务状态回写与人工校对标记 |
 
 `daemon.stop`、`daemon.clean-stable` 和任意通用 RPC 不属于 bat-api 管理控制面。
 Rust dispatch、Go transport 和 bat-api 接口的权威实现位置分别是

docs/reports/CURRENT_GAPS.md

@@ -293,8 +293,8 @@ 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 鉴权控制面暴露；provider worker 可在消费 handoff 后按 task_id 更新并由同一查询接口反查。
-- `i18n get/set/unset` 可查看、修改或清空单条工作台译文，`i18n validate` 可在发布前校验工作台 release、source text、重复 patch 目标，并区分可直接发布的 TextAsset 与必须进入 `parse repack` 的条目；`parse clear-cache` 只删除可再生解析/队列 JSON，保留 `translation-tasks.sqlite` 的 worker 状态。
+- `translation.task.update` 已提供 queued/running/failed/completed/skipped 状态回写契约，并已通过 `bat i18n task update`、Go typed helper 和 bat-api 鉴权控制面暴露；`translation.proofread` 已提供人工校对状态标记契约，provider worker 可在消费 handoff 后按 task_id 更新并由同一查询接口反查。
+- `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 离线状态仓储范围内。
 
 验收：
@@ -365,10 +365,10 @@ issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、Typ
 
 - 官方原版资源发布根为 `./bat-resources`，汉化产物发布根为 `./bat-localized`。
 - CLI 支持 `--localized-output` / `BAT_LOCALIZED_OUTPUT`，并拒绝官方目录和汉化目录相同或互相嵌套。
-- 官方同步报告新增 `localized_release_status=not_localized`，明确表示原版资源已发布、汉化资源未发布。
+- 官方同步报告新增 `localized_release_status=not_localized`，明确表示原版资源已发布、汉化资源未发布；`translation.proofread` 只写 workflow 标记，不会把 `localized_release_status` 从 `localized` 回退成 `not_localized`。
 - `LocalizedPatchService` 已具备将给定汉化文件按官方相对路径发布到 `--localized-output` / `BAT_LOCALIZED_OUTPUT` 指定目录下的 `.staging/<id>`、校验后移动到 `versions/<id>`、原子切换 `current` 并写入 `localized-version-state.json` 的基础能力。
 - `LocalizedPatchService` 已写入结构化 `localized-patch-manifest.json`，记录 TextAsset 操作、原始/汉化 hash、size、byte delta 和 rollback 信息；发布前后会校验 manifest hash/size 与 current symlink，失败时清理 staging / 未完成 version。
-- `localized.status` RPC 会读取 `.env` / daemon 配置中的汉化输出目录，校验汉化状态是否匹配当前官方 release，且要求 patch manifest 存在并匹配 release，避免写死 `./bat-localized` 或误报手工状态；其中 `status` / `status_code` 返回生命周期状态，`localized_release_status` 保留 `localized` / `not_localized` 发布标签。
+- `localized.status` RPC 会读取 `.env` / daemon 配置中的汉化输出目录，校验汉化状态是否匹配当前官方 release，且要求 patch manifest 存在并匹配 release，避免写死 `./bat-localized` 或误报手工状态；其中 `status` / `status_code` 返回生命周期状态，`localized_release_status` 保留 `localized` / `not_localized` 发布标签，`translation_workflow_status=manual_proofreading` 仅描述人工校对流程，不影响已发布汉化资源继续正常发布。
 
 仍未完成：
 

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.*` 和文件级 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.task.update`、`translation.proofread` 和文件级 UnityFS patch 调用；`resource.index`、其余 `translation.*`、`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` |
@@ -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 代理、`translation.task.update` 状态回写代理和部署模板，后续远程服务器联调/可选持久化 |
+| G-009 bat-api 资源 bootstrap/分发 | **部分完成**（MVP+生产控制面）；已含资源 bootstrap 关系面、launcher 资源 metadata 兼容、HTTP 鉴权/限流/日志/反代适配、RPC 周期刷新/诊断、readiness、OpenAPI、管理控制白名单、Rust-owned `schedule.*` dashboard 代理、`translation.task.update` 状态回写代理、`translation.proofread` 状态标记代理和部署模板，后续远程服务器联调/可选持久化 |
 | issue #19 | 资源面 MVP 与 USERGUIDE 基础章节已编码；真机联调后继续补充实战样例；**未自动关 issue** |
 | G-010 Web | 未开始 |