feat(i18n): 完成 localized patch 发布回滚闭环

Closes #45

docs/architecture/assetbundle.md

@@ -32,7 +32,7 @@
 | UnityFS container | `.bundle`、zip 内 bundle | header、block、directory、解压文件、基础摘要 | 已支持基础解包、LZ4/LZMA、alignment、大小/计数/路径/边界校验 |
 | Serialized file | UnityFS directory 文件 | header、type table、TypeTree node、object table、TextAsset bytes | 已支持基础表结构和 TextAsset bytes |
 | Unity 对象字段 | TextAsset、MonoBehaviour、ScriptableObject | 可翻译文本单元、上下文、资源定位 | TypeTree 基础字段读取、`SerializedReference` / prefixed managed-reference metadata alias、payload 提取和字符串提取已落地，真实结构覆盖继续扩大 |
-| Patch 发布前解析 | 已翻译文本、中间格式、原版资源 | 可验证 patch manifest、汉化 release 目录 | UnityFS TextAsset 前置已落地，通用 Binary/JSON/Text Patch 与文件级 patch / UnityFS 写入入口可用，发布级 build/rollback 未开放 |
+| Patch 发布 | 已翻译 TextUnit、中间格式、原版资源 | 可验证 localized patch manifest、汉化 release 目录、current/state | TextAsset、TypeTree string field 和 managed-reference string field 的 localized publish/rollback 已落地；整体 AssetBundle 重打包与通用 manifest 发布仍冻结 |
 
 ---
 
@@ -163,16 +163,16 @@ catalog 仍按“明确不支持”处理，不把低保真路径伪装成完整
 2. 解析缓存、资源变更集和 repository 数据能从同一 manifest fingerprint 追溯。
 3. CAS 对象跨版本复用，不重复存储相同文件。
 
-### P5：Patch 发布前置解析
+### P5：Patch 发布
 
-目标：让解析结果成为可生成汉化 patch 的输入。
+目标：让解析结果成为可生成、校验和回滚汉化 patch 的输入。
 
 交付：
 
-1. 已定义 `localized-patch-manifest.json`：目标官方版本、localized release、输出文件、hash、size、byte delta、TextAsset 操作和回滚信息。
-2. 已支持 UnityFS TextAsset raw bytes 替换的最小 patch 路径。
+1. 已定义 `localized-patch-manifest.json`：目标官方版本、localized release、输出文件、hash、size、byte delta、TextUnit/provider/review trace 和回滚信息。
+2. 已支持 UnityFS TextAsset、TypeTree string field 和 managed-reference string field 的 localized patch 操作。
 3. MonoBehaviour/ScriptableObject 字段替换必须依赖 P2 字段级解析结果。
-4. Patch 产物写入配置化汉化发布根下的 `.staging/<id>`，校验通过后发布到 `versions/<id>` 并切换 `current`。
+4. Patch 产物写入配置化汉化发布根下的 `.staging/<id>`，校验通过后发布到 `versions/<id>` 并切换 `current`；rollback 按 manifest 恢复上一 release。
 5. 成功后发布状态从 `not_localized` 切到 `localized`；`localized.status` 要求 state、current symlink 和 patch manifest 同时匹配当前官方 release。
 
 验收：
@@ -208,6 +208,6 @@ catalog 仍按“明确不支持”处理，不把低保真路径伪装成完整
 
 1. 完成 Addressables Windows/Android 当前版本 catalog 样本集合，关闭 G-007 当前阶段。
 2. 完成 TypeTree 字段 reader 和 MonoBehaviour/ScriptableObject 遍历，推进 G-005。
-3. 基于 `translation.worker.run` 推进翻译记忆和 Patch 构建。
+3. 基于 `translation.worker.run` 推进翻译记忆和通用 manifest Patch 构建。
 4. 扩展翻译任务结果在 CAS/ResourceRepository 查询面的索引，推进 G-011。
-5. 在通用 Binary/JSON/Text Patch 基础上继续扩展复杂 AssetBundle 重打包和发布流程统一，保留当前 UnityFS TextAsset patch 发布前置链路。
+5. 在通用 Binary/JSON/Text Patch 基础上继续扩展复杂 AssetBundle 重打包和通用 Patch 发布流程统一，保留当前受支持 localized patch 发布/rollback 链路。

docs/guides/baseline.md

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

docs/guides/bat-workflows.md

@@ -119,8 +119,8 @@ bat i18n validate \
   --translation-file /tmp/bat-workbench.json
 ```
 
-报告会区分未审核、原文未变化、可直接 `i18n publish` 的 TextAsset，以及必须使用
-`parse repack` 的 TypeTree/嵌套 archive 条目。
+报告会区分未审核、原文未变化、可直接 `i18n publish` 的受支持 TextAsset/
+TypeTree string field 条目，以及需要先经过独立 repack 流程的 ZIP 内或其他不支持条目。
 
 发布汉化 release：
 
@@ -131,7 +131,12 @@ bat i18n publish \
   --translation-file /tmp/bat-workbench.json
 ```
 
-发布只接受当前实现支持的直接 TextAsset 条目；TypeTree 字段和 zip 内 bundle 使用 `parse repack` 的 spec 单独处理。`--force` 不覆盖已有目录，而是生成独立的 `<official-release>-manual-<unix-seconds>` 汉化 release ID；也可以用 `--localized-release-id` 显式指定新 ID。因此强制发布仍保留旧 release 和 rollback 信息。
+发布接受当前实现支持的直接 TextAsset、TypeTree string field 和 managed-reference
+string field 条目；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 由单独的 worker 命令消费 `translation-tasks.sqlite`。
 
@@ -266,6 +271,45 @@ Rust `translation.tasks` / `translation.handoff`，不在 Go 侧维护状态。
 `POST /admin/control/translation-proofread` 会把当前汉化 workflow 标记为人工校对中；
 该接口只转发 `translation.proofread`，不会改动已发布汉化 release 指针。
 
+## localized patch 发布与回滚
+
+`i18n publish` 会在独立的 `.staging/<localized-release-id>` 中复制当前官方
+release，校验工作台与当前 TextUnit 索引的 source/location 一致后，写入已有支持
+范围内的 TextAsset、TypeTree string field 和 managed-reference string field
+patch。校验通过后才原子切换 `localized/current`，并在 release manifest 中记录
+源/目标 BLAKE3、字节数、patch kind、TextUnit、provider、review 和 rollback
+信息。ZIP 内 bundle 不会被静默改写。
+
+使用人工编辑的工作台发布：
+
+```bash
+bat i18n publish \
+  --translation-file /tmp/bat-workbench.json \
+  --localized-release-id release-manual-1
+```
+
+使用已完成 provider worker 的译文结果发布：
+
+```bash
+bat i18n publish \
+  --from-worker \
+  --localized-release-id release-worker-1
+```
+
+发布失败会清理 staging，不切换 `current`。当前 release 的 rollback 目标由
+manifest 记录，执行后删除本次版本目录并恢复上一版本；没有上一版本时移除
+`current`：
+
+```bash
+bat i18n rollback --localized-release-id release-worker-1
+```
+
+Rust RPC 方法为 `localized.publish` 和 `localized.rollback`；bat-api 对应为
+`POST /admin/control/localized-publish`、`POST /admin/control/localized-rollback`
+以及鉴权的 `GET /admin/translation/status`。发布请求必须且只能包含
+`translation_file` 或 `from_worker=true`；rollback 可省略 release ID 以操作当前
+release。Go 只做鉴权、参数校验和转发，状态与产物仍由 Rust 持有。
+
 ## 边界
 
 解析器新增类型覆盖和新的解析格式仍受 `docs/reports/PARSER_FREEZE.md` 约束。本次 issue 43 的例外只开放已有解析输出的手动编排、缓存刷新、工作台编辑、既有 patch 实现的重打包和独立汉化发布，不扩展 UnityFS/AssetBundle/Addressables/TypeTree 的解析类型覆盖。

docs/reference/rpc-backend-api.md

@@ -292,6 +292,8 @@ token 不会进入报告、任务记录或调试输出。
 | 方法 | 状态 | params | data |
 |---|---|---|---|
 | `localized.status` | 已实现 | `null` | 汉化发布状态、当前官方 release 匹配关系和汉化输出目录。 |
+| `localized.publish` | 已实现 | `{ "translation_file": "...", "localized_release_id": "...", "force": false }` 或 `{ "from_worker": true, "localized_release_id": "...", "force": false }` | 已校验并发布的汉化 release、manifest 和完整性报告。 |
+| `localized.rollback` | 已实现 | `{ "localized_release_id": "..." }`，可省略 | 删除当前 release、恢复 manifest 记录的上一 release 和新状态。 |
 
 `localized.status` 严格按 daemon / `.env` 中的 `BAT_LOCALIZED_OUTPUT` 或
 `--localized-output` 查询汉化产物目录，不把 `./bat-resources` 与
@@ -392,7 +394,7 @@ daemon 重启后仍处于 `queued` 或 `running` 的历史任务会被标记为
 `data` 会返回 source / patch 或 replacement / target 的 size 与 BLAKE3。`target_path`
 不能与输入文件相同。
 
-仍关闭的范围：发布级 `patch build` / `patch rollback`、复杂 UnityFS 语义编辑、
+仍关闭的范围：通用 manifest 驱动的发布级 `patch build` / `patch rollback`、复杂 UnityFS 语义编辑、
 `unityfs.inspect`、通用 manifest 驱动 release 切换。调用这些规划方法仍返回
 `BAT-ERR-700003`。
 
@@ -452,8 +454,9 @@ 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.tasks`、`translation.handoff`、
-  `translation.task.update`、`translation.worker.run`、`translation.proofread`、
+  `localized.status`、`localized.publish`、`localized.rollback`、
+  `translation.tasks`、`translation.handoff`、`translation.task.update`、
+  `translation.worker.run`、`translation.proofread`、
   `task.*` 和三个 `unityfs.patch_*` 方法。
 - `resource.index` 和 `patch.apply` 当前没有专用 typed helper；需要直接使用 `Call`，并仍须遵守
   本契约的参数和响应定义。
@@ -466,6 +469,7 @@ CLI 对应关系：
 | `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.tasks`、`translation.handoff`、`translation.task.update`、`translation.worker.run`、`translation.proofread` | 鉴权后的 dashboard 翻译任务查询、交接视图、状态回写、provider worker 触发与人工校对标记 |
+| `LocalizedBackend` | `localized.status`、`localized.publish`、`localized.rollback` | 鉴权后的汉化 release 状态、发布与显式回滚 |
 
 `daemon.stop`、`daemon.clean-stable` 和任意通用 RPC 不属于 bat-api 管理控制面。
 Rust dispatch、Go transport 和 bat-api 接口的权威实现位置分别是

docs/reports/CURRENT_GAPS.md

@@ -123,7 +123,7 @@
 - `ResourceImportService` 的 UnityFS 摘要已经能暴露解包文件数、serialized file 数、TextAsset 名称、TextUnit 数量/格式和字段诊断。
 - `MonoBehaviour`、`ScriptableObject` 已有基础 TypeTree 字段级反序列化和字符串提取入口；array/vector/staticvector/`List<T>`/`HashSet<T>`/map 元素与 TypeTree-covered managed reference registry payload 已保留独立 field path、offset 和 byte size，enum `value__` backing field 会暴露为语义化 `{type_name, storage_type, value}`，`LayerMask` / `BitField` 的 `m_Bits` backing field 会暴露为语义化 `{type_name, storage_type, bits}`，managed-reference full typename 可拆为 assembly/namespace/class，常见 `m_ManagedReferences` / `RefIds` / `m_RefIds` / verbose type 字段命名、`managedReference*` / `serializedReference*` prefixed metadata、`SerializedReference` 节点 alias 和 `data` / `value` / `payload` / `object` / `managedReferencePayload` / `referencePayload` / `serializedReferencePayload` / `managedReferenceValue` / `referenceValue` / `serializedReferenceValue` / `managedReferenceObject` / `referenceObject` / `serializedReferenceObject` / `managedReferenceData` / `referenceData` / `serializedData` / `serializedReferenceData` payload 命名已有回归覆盖，多记录 registry 聚合已有单元回归，TextUnit 提取会跳过 registry 元数据字符串并把它们作为 payload 文本上下文，fallback 字段遍历也会跳过常见 managed-reference 元数据别名，并按 `RefIds[n]` 等记录前缀或子字段推导 metadata 写入 payload TextUnit context；当前可对 string、bool、integer、float raw bits、bytes、enum、bit_field、常见固定 Unity float/int/hash 值类型的 leaf/direct-child 形态、unknown fixed-size raw bytes 同长度替换、PPtr、object 字段组合和 TypeTree schema 支撑的 array/vector/List/HashSet/map 整体替换执行文件级 patch，map entry 的 `first/second` 与 `key/value` 字段命名已有 serialized 和 UnityFS 重建回归，ScriptableObject `key/value` map 解析、变长替换和 UnityFS 重建已有专门回归；真实版本差异、未见样本驱动的复杂 managed reference registry / map entry 变体、unknown 字段结构语义和发布级重打包入口仍未完成。
 
-issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、TypeTree string 和受支持语义 field patch 实现；它不新增解析器类型、字段族或 catalog 覆盖。人工翻译工作台和有限 TextAsset 发布也只消费已有 TextUnit 输出。
+issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、TypeTree string 和受支持语义 field patch 实现；它不新增解析器类型、字段族或 catalog 覆盖。人工翻译工作台和 localized publish 只消费已有 TextUnit 输出，当前 publish 支持 TextAsset、TypeTree string field 和 managed-reference string field。
 
 影响：
 
@@ -149,7 +149,7 @@ issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、Typ
 
 - 见 `docs/architecture/assetbundle.md` 的 P2/P3/P5。
 
-### G-006：Patch 引擎基础已落地，发布入口仍未完成
+### G-006：Patch 引擎基础已落地，通用发布入口仍未完成
 
 状态：**部分关闭**
 
@@ -358,7 +358,7 @@ issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、Typ
 - `cargo test -p bat-infrastructure version_state`
 - `cargo test -p bat-infrastructure --test official_game_main_config_bootstrap`
 
-### G-011D：汉化发布状态与 Patch 发布流程未完成
+### G-011D：受支持汉化发布已完成，通用 Patch 发布流程仍未完成
 
 状态：**部分关闭**
 
@@ -368,13 +368,14 @@ issue 43 例外说明：新增的 `parse repack` 只编排已有 TextAsset、Typ
 - CLI 支持 `--localized-output` / `BAT_LOCALIZED_OUTPUT`，并拒绝官方目录和汉化目录相同或互相嵌套。
 - 官方同步报告新增 `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。
+- `LocalizedPatchService` 已写入结构化 `localized-patch-manifest.json`，记录 TextAsset、TypeTree string field 和 managed-reference string field 操作、原始/汉化 hash、size、byte delta、TextUnit/provider/review 和 rollback 信息；发布前后会校验 manifest hash/size 与 current symlink，失败时清理 staging / 未完成 version。
+- 已完成从 workbench 或 completed provider worker 结果生成受支持 patch operation 的流程；`localized.publish` / `localized.rollback` RPC、`i18n publish` / `i18n rollback` CLI，以及 bat-api 的鉴权 status/publish/rollback 接口已落地。
 - `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` 仅描述人工校对流程，不影响已发布汉化资源继续正常发布。
 
 仍未完成：
 
 - 真实 Patch/翻译构建阶段尚未从 `crowdin-textunit-queue.json`、翻译记忆和 Crowdin 结果生成完整汉化文件集合。
-- 通用 Binary/JSON/Text Patch crate 基础和文件级 `patch.apply` / UnityFS 写入入口已经实现；复杂 AssetBundle 重打包、发布级 patch build/rollback 和与汉化发布流程的统一仍未完成。
+- 通用 Binary/JSON/Text Patch crate 基础和文件级 `patch.apply` / UnityFS 写入入口已经实现；通用 manifest 驱动的跨类型发布、复杂 AssetBundle 重打包和双发布后的清理策略仍未完成。
 - 尚未实现原版资源与汉化资源双发布后的查询、分发和清理策略。
 
 验收：

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.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 |
+| 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/publish/rollback`、`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` |