TMDB 元数据匹配怎么帮 Miru 更好地展示内容

TMDB 是什么

The Movie Database (TMDB) 是一个开放的影视元数据 API，由社区维护，提供全球范围内的电影、剧集、动漫、纪录片等内容的标准化信息。Mirv 用 TMDB 来弥补扩展数据的不足。

为什么需要 TMDB 集成

很多扩展返回的元数据很粗糙——可能只有一个标题和封面，没有分集名称、演员、剧情简介。TMDB 匹配解决了这个问题：

• 统一封面风格：不同源的封面图质量参差不齐，TMDB 的封面是标准化的高清海报；
• 自动补全分集名称：很多视频源的分集只写"第 1 集 / 第 2 集"，TMDB 能拉取官方的分集标题；
• 多语言支持：TMDB 覆盖中文、日文、英文等多种语言，可以展示本地化的名称和简介；
• 演员、导演、年份等元数据：详情页自动补全。

匹配怎么触发

当扩展的 detail() 方法返回了内容后，Mirv 会尝试在 TMDB 上匹配这个条目。匹配逻辑大致是：

1. 用扩展返回的标题在 TMDB API 搜索；
2. 找到最匹配的条目；
3. 拉取 TMDB 的元数据覆盖或补充扩展返回的数据。

如果匹配成功，详情页的封面、简介、分集名称等会被替换为 TMDB 提供的版本。如果匹配不上（标题差异太大、TMDB 没有对应条目），则保留扩展原始数据。

匹配不上怎么办

• 扩展返回的标题和 TMDB 官方名称差异较大 → 这是扩展的问题，需要扩展开发者改进标题字段；
• TMDB 上确实没有这个条目 → 以扩展原始数据为准；
• 你想看的内容刚好是冷门作品 → 大概率匹配不上，这是正常的。

TMDB 是 Mirv 的数据依赖

从技术角度看，Miru 的详情页元数据有两个来源：扩展原始数据 + TMDB 补充。扩展返回什么 Mirv 就用什么，然后用 TMDB 覆盖它能找到的部分。这也是为什么有些用户会看到"同一个视频在不同扩展下封面和分集名不一样"的原因——可能是两个扩展的 TMDB 匹配结果不同，或者一个匹配成功另一个没匹配上。