docs: document Translation Memory and config contracts

docs/reference/rpc-backend-api.md

@@ -158,6 +158,12 @@ SQLite `ResourceRepository`，索引不存在时返回 `ok=true` 且
   next attempt；schema 由 `schema_migrations` 版本表管理。
 - `translation-handoff.json`：当前 release 的版本化 job/unit/provider run 交接
   快照；worker 更新后的实时状态仍以 `translation-tasks.sqlite` 为准。
+- `translation-memory.sqlite`：跨 release 的项目级 Translation Memory，不位于
+  `versions/<id>`，也不与 `translation-tasks.sqlite` 共用；记录 raw source/hash、完整
+  TextUnit context、candidate/trusted、translation 和 release/TextUnit/provider/run
+  provenance。默认路径为 `<output>/translation-memory.sqlite`，可由
+  `BAT_TRANSLATION_MEMORY_PATH`、`[translation.worker].translation_memory_path` 或 CLI
+  覆盖。
 
 删除资源只进入 `official-resource-changes.json`，不进入 Crowdin handoff。
 
@@ -209,6 +215,14 @@ SQLite `ResourceRepository`，索引不存在时返回 `ok=true` 且
 | `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 标记为人工校对中，返回工作流状态报告。 |
+| `translation.memory.summary` | 已实现 | 可选 `{ "translation_memory_path": "..." }` | 返回 TM schema 版本、总记录数及 candidate/trusted/rejected/superseded 状态计数。 |
+| `translation.memory.query` | 已实现 | `{ "source_text": "...", "source_context": {...}, "limit": 100 }` | 按 raw source 查询记录，返回 match kind、trust、translation 和 provenance。 |
+| `translation.memory.confirm` | 已实现 | `{ "record_id": "...", "reviewer": "...", "reason": "..." }` | 显式确认一条 candidate 为 trusted；worker 之后才可自动复用。 |
+
+TM 的自动复用规则是 raw source 完全相同、完整 context 完全相同且状态为 `trusted`；
+context 缺失/不一致、normalized source 仅辅助查询、candidate 或 provider 成功都不会
+自动复用或自动变成 trusted。TM 查询、confirm 和诊断由 Rust `bat` 持有，Go
+`bat-api` 不维护第二份 TM 状态。
 
 `parse.status` 是只读查询；没有当前 release 或没有解析缓存时返回
 `ok=true` 且 `data.available=false`。解析缓存来自官方原版资源目录，不读取
@@ -284,6 +298,7 @@ provider worker 参数：
 | `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 前缀。 |
+| `translation_memory_path` | string/null | 按配置推导 | 覆盖 Rust worker 使用的项目级 TM 数据库路径；未指定时使用 worker 配置或 `<output>/translation-memory.sqlite`。 |
 
 数字字段必须是 JSON number；字符串数字、负数和越界值会返回
 `BAT-ERR-700002`。`mock` provider 在没有 fixture 时把 source text 写成可诊断的
@@ -299,7 +314,7 @@ token 不会进入报告、任务记录或调试输出。
 | `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.status` 严格按 daemon / `config.toml` 或环境变量中的 `BAT_LOCALIZED_OUTPUT` 或
 `--localized-output` 查询汉化产物目录，不把 `./bat-resources` 与
 `./bat-localized` 混用。当前支持未汉化发布状态和已汉化发布状态的只读报告。
 `status` / `status_code` 使用生命周期短状态和稳定状态码，例如
@@ -432,6 +447,8 @@ CLI 对应关系：
 | `bat i18n task update` | `translation.task.update` |
 | `bat i18n worker run` | `translation.worker.run` |
 | `bat i18n proofread` | `translation.proofread` |
+| `bat i18n memory summary` / `bat i18n memory query` | `translation.memory.summary` / `translation.memory.query` |
+| `bat i18n memory confirm` | `translation.memory.confirm` |
 | `bat localized-status` | `localized.status` |
 | `bat resource-index` | `resource.index` |
 
@@ -463,7 +480,8 @@ CLI 对应关系：
   `catalog.*`、`parse.*`、
   `localized.status`、`localized.publish`、`localized.rollback`、
   `translation.tasks`、`translation.handoff`、`translation.task.update`、
-  `translation.worker.run`、`translation.proofread`、
+  `translation.worker.run`、`translation.proofread`、`translation.memory.summary`、
+  `translation.memory.query`、`translation.memory.confirm`、
   `task.*` 和三个 `unityfs.patch_*` 方法。
 - `resource.index` 和 `patch.apply` 当前没有专用 typed helper；需要直接使用 `Call`，并仍须遵守
   本契约的参数和响应定义。
@@ -479,6 +497,7 @@ CLI 对应关系：
 | `TaskBackend` | `task.list`、`task.status`、`task.logs`、`task.cancel` | 鉴权后的 daemon 任务查询和取消 |
 | `ParseBackend` | `parse.status`、`parse.text_units`、`parse.errors` | 鉴权后的当前 release 解析状态、TextUnit 和解析错误只读查询 |
 | `TranslationBackend` | `translation.tasks`、`translation.handoff`、`translation.task.update`、`translation.worker.run`、`translation.proofread` | 鉴权后的 dashboard 翻译任务查询、交接视图、状态回写、provider worker 触发与人工校对标记 |
+| `TranslationMemoryBackend` | `translation.memory.summary`、`translation.memory.query`、`translation.memory.confirm` | 鉴权后的 TM 摘要、source/context 查询和显式 candidate 确认；Go 只转发，不持有 TM 状态 |
 | `LocalizedBackend` | `localized.status`、`localized.publish`、`localized.rollback` | 鉴权后的汉化 release 状态、发布与显式回滚 |
 
 `daemon.stop`、`daemon.clean-stable` 和任意通用 RPC 不属于 bat-api 管理控制面。
@@ -487,8 +506,9 @@ Rust dispatch、Go transport 和 bat-api 接口的权威实现位置分别是
 `internal/api/rpc_release.go`；修改方法、字段或 allowlist 时必须同步更新本文档。
 
 Go mirror contract fixture 固化在 `internal/api/testdata/contract/`，覆盖
-`catalog.status` available/unavailable、`resource.manifest` page0 和对应
-`official-sync-snapshot.json`。这些 fixture 由 Rust 输出归一化而来，只用于
+`catalog.status` available/unavailable、`resource.manifest` page0、对应
+`official-sync-snapshot.json` 以及 Translation Memory query/缺库 mirror。
+这些 fixture/mirror 由 Rust 输出形状归一化而来，只用于
 schema / mirror 回归；live daemon socket 和完整 fixture release 切换由
 `make bat-api-local-live-smoke` 在同机 `/tmp` 隔离环境中验证。该 smoke 不替代
 `make official-smoke` 的官方网络全量下载验证。