fix(tm):建立 Trusted 唯一性与 Supersede 治理

2026-09-18 12:14:56 +08:00 · 2026-09-18 06:44:14 +08:00
parent e486f1aaaa
commit ff1adb91ee
37 changed files with 2679 additions and 530 deletions
@@ -196,8 +196,10 @@ pub struct ParserRegistry {
 ### 4. 翻译系统（目标扩展，Go；当前 worker 由 Rust `bat` 承担）

 当前已实现的是 Rust `bat` 的离线 TextUnit 队列、mock/Crowdin provider worker、
-lease/retry、结果落库、项目级 Translation Memory V1 和独立 Glossary V2。TM 位于独立
-SQLite，按 raw source + 完整 context 做 trusted exact reuse，candidate 必须显式 confirm；
+lease/retry、结果落库、项目级 Translation Memory persistence schema V2 和独立 Glossary
+domain/feature contract V1（SQLite persistence schema V2）。TM 位于独立 SQLite，按 raw
+source + 完整 context 做 current Trusted exact reuse，candidate 必须显式 confirm；
+同一 identity 的不同译文必须显式 supersede，历史 Trusted 冲突必须显式 resolve；
 Glossary 只有 approved term 进入 provider/TM 自动流程，并在结果上执行确定性 QA；模糊
 匹配和完整 Provider 体系仍属后续缺口。

@@ -229,7 +231,7 @@ type TranslationProvider interface {
 - Azure Translator Provider

 **翻译记忆库**：
- 当前 V1：raw source 完全相同、完整 context 完全相同且记录为 trusted 时自动复用。
+- 当前规则：raw source 完全相同、完整 context 完全相同且只有一条 current Trusted 时自动复用。
 - provider 输出写入先是 candidate；manual task result 不会自动建立 TM 或 trusted。`bat i18n memory confirm` 显式确认单条记录后才可自动复用。
 - source、context、release、TextUnit、provider 和 run provenance 保存在 Rust TM SQLite 中。
 - 模糊匹配、术语优先级和 PostgreSQL 服务化仍不是当前实现。
@@ -296,7 +298,8 @@ HTTP Request → Middleware (Auth, CORS, Logger) → Handler → Service → Rep

 ### 7. Web 后台 (Vue 3，目标设计)

-当前只有 `bat-api` 内嵌 dashboard MVP；Rust `bat` 的 Glossary V2 已实现，登录、角色、Web 术语管理和完整协作审核仍未实现。
+当前只有 `bat-api` 内嵌 dashboard MVP；Rust `bat` 的 Glossary domain/feature contract V1
+及 SQLite persistence schema V2 已实现，登录、角色、Web 术语管理和完整协作审核仍未实现。

 **技术栈**：
 - Vue 3 + Composition API
@@ -36,8 +36,10 @@
   - 新的跨语言控制和查询能力优先增加 Rust RPC contract，再由
     `internal/backendrpc` 消费。

-4. **完整游戏业务 API、完整 Web 协作后台和 Provider 扩展体系仍是后续目标；Rust `bat` 已持有 Glossary V2，Web 术语协作视图仍待建设**；
-   Translation Memory V1 已由 Rust `bat` 持有，不能从目标架构图推断 Go 侧拥有第二份状态。
+4. **完整游戏业务 API、完整 Web 协作后台和 Provider 扩展体系仍是后续目标；Rust `bat` 已持有
+   Glossary domain/feature contract V1（SQLite persistence schema V2），Web 术语协作视图仍待建设**；
+   Translation Memory persistence schema V2 已由 Rust `bat` 持有，不能从目标架构图推断 Go
+   侧拥有第二份状态。

 ---

@@ -180,9 +180,9 @@
 `available=false`，不会因为查询创建空库。发布后的 TextUnit 队列还会在当前
 release 根目录写入 `translation-tasks.sqlite`，由版本化 `schema_migrations`
 管理 V2 queued/running/failed/completed/skipped、provider run、lease、失败分类、
-重试计划和 TextUnit 级译文结果。跨 release 的 Translation Memory V1 独立存储在
-`<output>/translation-memory.sqlite`，记录 raw source/hash、完整 context、candidate/
-trusted 和 release/TextUnit/provider/run provenance；`translation.tasks` 优先查询这份状态库，
+重试计划和 TextUnit 级译文结果。跨 release 的 Translation Memory persistence schema V2
+独立存储在 `<output>/translation-memory.sqlite`，记录 raw source/hash、完整 context、
+candidate/trusted 和 release/TextUnit/provider/run provenance；`translation.tasks` 优先查询这份状态库，
 `translation.worker.run` 由 Rust worker 回写状态；`translation.task.update` 仍供外部 provider 流程回写状态；
 没有状态库的旧 release 才回退到 immutable JSON 队列。`bat doctor cas`
 已提供只读 CAS 根目录、对象目录、元数据库文件和对象统计诊断；`resource.index`