AfuseKt 自动刮削原理 - 元数据抓取与 TMDB 匹配机制

刮削是什么

刮削（Scraper） 是 AfuseKt 的核心卖点。简单说就是：

你给一堆视频文件起好名 → AfuseKt 自动匹配 TMDB 数据库 → 拉取电影海报、评分、剧情简介、演员阵容、导演等元数据 → 渲染成精美的海报墙。

如果没有刮削，你看到的只是一堆文件名；有了刮削，你看到的是和 Netflix 首页一样的封面墙。

刮削的工作流程

文件进入资源库
    ↓
扫描文件名（识别 "名称 + 年份 + S01E01" 模式）
    ↓
匹配 TMDB 数据库（按名称 + 年份搜索）
    ↓
抓取元数据（海报图、简介、评分、演员…）
    ↓
本地缓存 → 生成海报墙

核心识别来源：文件名

AfuseKt 不依赖文件夹名称，只看文件名里的信息来识别电影 / 剧集。这意味着：

• 同一文件夹里的多个视频，每个单独识别
• 文件夹可以随便取个好记的名字，不影响刮削
• 但文件名必须符合命名规范（详见 电影命名规范 和 剧集命名规范）

TMDB 数据库

AfuseKt 使用 TMDB（The Movie Database） 作为元数据来源。TMDB 是全球最大的开放电影 / 剧集数据库之一：

• 收录量：电影 100 万+，剧集 25 万+，免费开放 API
• 数据内容：海报、剧情简介、评分、导演、演员、制作公司、上映日期、片长、类型标签…
• 多语言支持：包括中文简介和中文海报（部分热门作品有，冷门作品只有英文）

刮削缓存

所有刮削到的元数据都会缓存在手机本地存储中：

• 第二次打开同一资源库时不用重新刮削
• 换设备登录同一账号（PRO 版同步），可以在新设备上恢复
• 缓存过期后可手动触发重新刮削

刮削失败怎么办

如果文件名识别失败或 TMDB 没匹配到：

AI 增强刮削

v3.x 新增了 AI 增强刮削功能，可以在 TMDB 匹配失败时用 AI 辅助识别（详见 AI 增强刮削）。

本地库 vs 扫库模式

AfuseKt 对不同资源类型有两种刮削模式：

刮削引擎本身相同，区别在刮削完成后的首页呈现方式。