添加文件源后的自动刮削流程 等待什么

触发刮削的时机

刮削会在以下情况自动触发：

1. 第一次添加文件源 — 最常见的场景
2. 手动重新扫描文件 — 你改了文件名或添加了新视频
3. 设置 → 资源 → 刷新在线影视数据 — 更新已有影片的信息（不会重新匹配文件名）

刮削过程中发生了什么

添加文件源后，VidHub 依次执行以下步骤：

第一步：扫描文件列表

遍历文件源文件夹及其所有子文件夹，找到所有支持的视频格式文件（MKV、AVI、MP4、MOV、RMVB、WMV、FLV、WebM、TS、3GP 等）。

第二步：提取文件名

对每个视频文件，去掉后缀，把文件名清理成干净的匹配字符串：

• 去掉压缩组标记（如 x264-GROUP）
• 去掉分辨率（如 1080p、4K）
• 去掉编码信息（如 HEVC、x265）
• 保留年份（帮助区分重名作品）
• 保留电视剧的 SXXEXX 标记

第三步：搜索 TMDB

用清理后的字符串调用 TMDB 的搜索 API：

• 电影：直接按名称搜索
• 电视剧：检测到 SXXEXX 格式时，先匹配剧名，再根据季集数建立关联

第四步：下载和整理

匹配成功后：

• 下载海报图、背景图
• 保存影片简介、演员、导演等信息
• 电影归类到"电影"
• 电视剧根据季数集数整理到"电视剧"下
• 完全没匹配的归类到"其他"

如何查看刮削进度

• 扫描时：进入媒体库，拉到底部可以看到扫描状态文字（"扫描 N/M 文件中..."）
• 扫描完成：底部显示媒体库统计信息——电影数量、电视剧数量、其他视频数量
• 实时查看：媒体库页面的海报会在刮削成功后逐个出现，不是一次性全部显示

刮削完成后的典型状态

刮削耗时参考

云盘场景刮削较慢是因为 VidHub 先需要从云盘获取文件列表，这个过程本身可能比较慢。

加速刮削

• 确保网络连接通畅，特别是能访问 TMDB（国内用户建议使用较快的网络环境）
• 云盘文件源不要选根目录，选具体的子文件夹
• 文件名提前整理好，避免反复刮削
• 大型刮削过程中可以让 VidHub 在后台运行（iOS/iPadOS）

刮削完成后发现新文件怎么办

已经添加的文件源里出现了新视频：

• VidHub 不会自动检测 — 需要手动触发扫描
• 方法一：长按文件源 → 重新扫描文件
• 方法二：设置 → 资源 → 重新扫描文件（扫描所有文件源）
• 方法三：长按文件夹 → 重新扫描文件（只扫描该文件夹）

扫描完成后，新视频会被自动刮削并出现在媒体库对应的分类中。