Infuse 自动海报墙 — TMDB 元数据抓取原理与触发方式
海报墙是 Infuse 的灵魂
很多人第一次用 Infuse 最惊艳的时刻，就是 NAS 里一堆乱七八糟命名的 MKV 文件突然变成了漂亮的 Netflix 风格海报墙。这个功能的核心是 TMDB（The Movie Database）——一个社区维护的开源影视数据库，Infuse 是它的客户端。
抓取原理
Infuse 扫描到你的视频文件后，会按以下步骤匹配 TMDB：
- 解析文件名：从文件名提取标题、年份、类型（电影还是电视剧）
- 请求 TMDB 接口：用提取到的信息在 TMDB 搜索最匹配的条目
- 拉取元数据：匹配成功后下载：
- 标题（中/英/多语言）
- 剧情简介
- 演员阵容列表
- 海报图片（多种尺寸）
- 评分（TMDB 社区评分）
- 预告片链接
- 类型标签（动作、科幻、喜剧…）
- 缓存到本地：Infuse 把这些信息缓存在设备上，下次打开不需要重新请求
关键点：TMDB 是社区数据库，内容由全球用户共同维护。某些冷门资源可能没有中文信息、没有海报或剧情缺失，属于正常现象。
语言偏好设置
Infuse 默认用设备当前语言请求 TMDB。如果你的 iPhone 语言是中文，会优先请求 TMDB 上的中文海报和剧情。但 TMDB 中文条目覆盖不全，所以 Infuse 会自动回退到英文条目、然后翻译显示。
可以手动指定偏好：Infuse 设置 → 库 → 语言 → 选中文或「跟随系统」。
什么时候触发重新抓取
元数据和海报不是永久不变的——新剧可能有新演员、海报升级、简介修改。Infuse 会在以下时机重新请求 TMDB：
- 打开 App 时：Infuse 扫描已连接的文件来源，发现新文件立刻抓取
- 每隔 15 分钟（前台）：在 Apple TV/iPad 上长时间放着不操作时，自动刷新
- 每小时（后台）：如果在系统设置里开启了 Infuse 的「后台应用刷新」
- 手动刷新：选中视频 → 长按 → 刷新；或设置 → 库 → 「扫描更改」
匹配失败怎么办
Infuse 会尽力匹配，但以下情况容易失败：
- 文件名只有
电影.mkv→ 完全没有有用信息，匹配不上 - 用了奇怪的缩写或别名（比如把「流浪地球」写成「地球.mp4」）
- 老电影/冷门动漫 TMDB 条目不全
解决方法：
- 改文件名为规范格式（参考同组的「电影文件命名规则」和「电视剧命名规则」两页）
- 手动覆盖元数据：选中视频 → 编辑元数据 → 手动输入标题、上传自己的海报图
- TMDB 自己注册账号（免费）去补全缺失的条目——你在 TMDB 上编辑的内容一天后会同步到 Infuse
匹配成功后海报不对
有时 Infuse 抓到的海报是别的版本（比如中文条目和英文条目对应不同海报）：
- 长按视频图标 → 刷新（强制重新请求）
- 或者「编辑元数据」里手动选 TMDB 的正确条目
- 也可以上传本地图片覆盖
隐私设计的细节
Infuse 官方明确声明：不追踪、不上传你的媒体库信息。请求 TMDB 只发「标题 + 年份」，不带任何个人身份信息。服务器端不存你的浏览历史、不做行为分析。这在流媒体播放器里是非常少见的。