feat(scripts): TMDB 多语言别名清理脚本与保留规则文档

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Cxwgnn2pbzQ7rXv3rq7fei

docs/porting/moviepilot-metadata-recognition.md

@@ -336,6 +336,7 @@ export interface TmdbPort { searchMovie(q: string, year?: number): Promise<TmdbS
 | --- | --- | --- |
 | 查询名顺序、按类型分步计划、年份容差 ±1、标题精确匹配优先、别名回退、季年份匹配、无类型 id 的双查加消歧、连接失败和不存在分开 | ① 所有 direct 或 alias 结果**只作为候选**，按证据打分输出 `candidates[]`；分数够高并且只有一个候选时才自动绑定，否则进入待识别池（REQ §7.5）；② 别名回退要**限制拉详情的次数**（例如前 5 个），避免上游那样对每个候选都请求一次；③ 已经存在本地实体时，先查 `title_alias`（pg_trgm）召回本地实体，再查 TMDB；④ TMDB 缺失或失败**不阻断**有本地证据的入库（REQ §14.1.3） | 本地 UUID 优先；控制成本；REQ 要求不因外部服务阻断 |
 | 中文标题补全 | 放进元数据协调层（REQ §7.3 字段级来源），**不改变路径绑定** | REQ §7.1 |
+| 别名与译名（`__get_names` 用全部 `alternative_titles` + 全部 `translations`；`__update_tmdbinfo_extra_title` 取 en / hk / tw / sg 译名，`__update_tmdbinfo_cn_title` 取 CN 地区别名） | **多语言保留规则**（2026-10-06 用户规则，`packages/adapters/src/tmdb/language-policy.ts`）：译名、别名、简介、标语只留简中（zh-CN / zh-SG / zh-Hans）、繁中（zh-TW / zh-HK / zh-MO / zh-Hant）、英文（en-*）、作品原语言；`alternative_titles` 按地区推断语言（CN / SG 简中、TW / HK / MO 繁中、英语区英文、原产地区原语言）并校验文字，推断不出或文字不符的丢弃；原产地区的罗马字别名（type 含 roma）记 `<原语言>-Latn`。识别比较（`details().aliases`、`match.ts` 别名回退、`tmdbToCandidate`、按作品搜资源的 `work-match.ts`）同样只用这些 | 用户规则：俄 / 葡 / 越 / 西 / 泰等与作品无关的语言别名只会制造误匹配和噪声；MP 的 en / hk / tw / sg / CN 取值都在保留范围内 |
 
 ---