VidHub 自动刮削原理 为什么文件名这么重要
什么是刮削
刮削（Scraping）= 根据视频文件名，在线搜索电影/电视剧的海报、简介、演员、上映时间等信息，自动添加到媒体库中。
你添加了一个文件源后，VidHub 会自动：
- 扫描这个文件夹里所有的视频文件
- 取出每个文件的文件名
- 用文件名去 TMDB（全球最大的影视数据库）搜索匹配的电影或电视剧
- 把搜索到的影片海报、简介、演员阵容、分类信息下载下来
- 整理成漂亮的海报墙媒体库展示给你
整个过程全自动，通常只需要几秒到几分钟（取决于文件数量和网络）。
刮削的唯一依据：文件名
这是 VidHub 刮削机制最重要的一点：文件名是匹配影片的唯一依据。
- 文件夹叫"我的电影"不影响刮削
- 文件放在哪个目录不影响刮削
- 只有视频文件本身的文件名（不含后缀）会被拿去匹配
所以：
- 文件名写对了 → 刮削精准、海报漂亮
- 文件名写错了 → 可能匹配到错误的影片、或者完全匹配不上（归类到"其他"）
TMDB 数据源
VidHub 的所有影片信息和海报都来自 TMDB（The Movie Database，全球最大的开放影视数据库）。TMDB 覆盖了绝大多数电影和电视剧，支持多语言。
TMDB 数据包括：
- 海报图、剧照、背景图
- 电影/电视剧名称（原始名称 + 多语言译名）
- 上映年份、类型、评分
- 演员阵容、导演
- 剧情简介
- 电视剧集数和季数信息
自动刮削流程详解
添加文件源文件夹
↓
VidHub 扫描文件夹内所有视频文件
↓
对每个文件：提取文件名 → 清理年份/分辨率/压缩组信息
↓
用清理后的文件名搜索 TMDB API
↓
匹配到唯一结果？→ 下载数据，写入媒体库
匹配到多个结果？→ 取相似度最高的第一个
完全没匹配？→ 归类到"其他"，不显示海报VidHub 不会把所有文件名拿去逐个手动搜索，而是用 TMDB 的自动搜索 API，在 0.5-1 秒内返回匹配结果。
刮削什么时候触发
- 添加新文件源后立即触发 — 这是最常见的情况
- 手动重新扫描文件时触发 — 你改了文件名或文件夹里有新视频
- 设置 → 资源 → 刷新在线影视数据 — 用最新的 TMDB 数据更新现有影片信息（不会重新匹配文件名，只更新已有影片的数据）
为什么刮削可能不准确
最常见的不准确原因：
1. 文件名包含过多噪音信息
比如 The.Matrix.1999.1080p.BluRay.x264-GROUP.mkv——VidHub 会从中提取"The Matrix"作为主名，通常能匹配正确。但如果文件名是 矩阵-高清完整版.mkv（全中文且不包含原名），可能匹配失败或匹配到错误结果。
2. 年份混淆
电影有重拍版，比如《功夫》2004 和《功夫》可能有其他同名作品。正确的年份标注能帮助区分。
3. 简称或别名
《蜘蛛侠》可能匹配到《蜘蛛侠：平行宇宙》、《蜘蛛侠：英雄远征》或其他任何带"蜘蛛侠"的影片。如果没有年份，VidHub 只能取第一个匹配。
4. 电视剧集数不规范
电视剧文件没有正确标注集数（如 S01E05 格式），可能被识别为独立电影。
正确命名 = 80% 的刮削问题解决
下一页会详细讲解电影和电视剧的正确命名格式。花时间整理文件名，是让你的媒体库最漂亮的投入。