媒体刮削
路径：媒体管理 → 媒体刮削。
媒体刮削根据影片或剧集名称查找资料，并把海报、简介和资料文件写到媒体所在目录。它不会移动媒体文件；要调整文件位置和名称，请使用媒体整理。
一次刮削通常会产生媒体服务器需要的 NFO、海报或背景图等资料文件。它是否能写入，取决于目标存储和目录的写权限；只读挂载、只读网盘令牌或错误的目标目录都会导致任务失败。
开始前
先打开“设置 → 自动化设置 → TMDB”，填写 TMDB API 读访问令牌并点击“测试连接”。文件名中包含片名、年份、季数或集数时，自动识别会更准确。
推荐先用一部电影和一季剧集各做一次手动刮削，确认语言、海报和 NFO 内容符合预期，再建立定时任务。改 TMDB 语言或覆盖方式不会自动重写已经存在的资料。
新建刮削任务
点击“新建任务”后，填写以下内容：
| 字段 | 怎么填写 | 保存或运行后的影响 |
|---|---|---|
| 任务名称 | 例如“电影库补全海报”。 | 仅用于区分任务和历史记录。 |
| 媒体库存储、媒体库目录 | 选择已有媒体所在的存储和目录。 | 刮削资料会写回这里；存储必须允许新建和写入文件。 |
| 媒体类型 | 电影、剧集或自动识别。 | 明确选择电影或剧集可降低同名作品匹配错误。 |
| 覆盖方式 | 首次建议“仅缺失”。 | 决定已有资料是否被刷新，见下表。 |
| 调度方式 | 手动、定时或目录监控。 | 决定任务何时自动开始。 |
| 覆盖方式 | 会发生什么 |
|---|---|
| 仅缺失 | 只补充缺少的资料，尽量保留已有海报和资料文件。 |
| 全部覆盖 | 重新写入本次识别到的资料和图片；需要更新旧资料时再使用。 |
保存后还要在任务列表点击“运行”，手动任务才会开始。定时任务填写执行时间即可，例如 0 2 * * * 表示每天 02:00；目录监控只适用于本地来源目录，有新文件稳定后会自动刮削。
当前分支的本地和远端手动、定时任务可选择“扫描处理方式”。“就绪即处理”允许已核实作品和目标的文件先处理；剧、季和目录共用的资料仍需等待所属范围完整。“扫描完成后处理”会先完整读取目录，再开始本轮写入。手动运行重新读取来源；网盘定时运行的缓存说明见目录缓存。
刮削的目标目录必须可写。只读库需先为所需目录开放写权限，或复制到可写媒体库后刮削，不能靠选择“全部覆盖”绕过写权限。
“媒体类型”选“自动识别”适合命名规范的目录；同名作品、翻拍作品或文件名不完整时，建议明确选择电影/剧集，或直接使用手动刮削指定 TMDB 结果。
手动刮削：用于改正一部作品
当自动识别找错、找不到或同名作品很多时，点击“手动刮削”。操作顺序如下：
- 选择媒体所在的存储和目录。
- 点击“从路径识别标题和年份”，先让页面尝试填入搜索条件；也可以自己填写。
- 在“搜索关键词”中输入片名；“年份”可选，重名作品时建议填写四位年份。
- 需要指定作品时，点击搜索并选择正确的电影或剧集。按目录自动识别时可以不指定单部作品，混放多部作品的目录不要强制统一成同一个结果。
- 需要强制更新已有资料时，勾选“覆盖已有刮削结果”。
- 点击确认。
| 字段 | 作用 |
|---|---|
| 搜索关键词 | 用于在 TMDB 中查找作品。使用正式片名通常更准确。 |
| 年份 | 可选的四位年份，用来区分同名电影、翻拍作品或同名剧集。 |
| 搜索结果 | 要强制指定作品时选择；请确认类型、年份和海报。目录自动识别与从历史重新刮削的要求不同，按表单提示操作。 |
| 覆盖已有刮削结果 | 勾选后会强制刷新该目录的资料文件和海报；不勾选则只补缺失内容。 |
从历史记录发起“重新刮削”时，系统会沿用那次记录的文件位置；重新选择正确搜索结果即可。
失败记录还可以直接点“重试”，按当时的设置再执行一次；“重新刮削”会打开表单，允许调整设置后再执行。批量操作也分别提供这两个入口。来源沿用历史快照，原任务修改或删除后仍以那次记录为准。已取消的记录不能快速重试。
任务列表上方的“最近的一次性运行”显示本轮成功、失败、等待和取消的文件数；运行中可以暂停、恢复或取消。扫描未结束时文件总数还会增加。
只补齐缺失图片
历史行提供“补齐缺失图片”时，可沿用这次已经确认的作品和来源，只补充缺少的图片，保留已有 NFO 和图片。适合资料正确、部分图片下载失败的情况；它不会修正找错的作品，也不会重新命名媒体文件。
来源变化、旧记录缺少可信的产物位置，或多个作品争用同一目录时，可能要求先重新扫描或确认归属，不会凭同名文件自动补写。
作品与共享资料冲突
同一目录里混放多部剧、不同文件争用同一个 NFO 或海报时，共用资料可能无法安全写入。优先把不同作品分目录，再用小范围刮削验证；不要用重复点击“全部覆盖”处理归属冲突。
历史中的“确认作品归属”会展示候选、证据和全部适用文件。确认针对整组，季集修正也会作用于整组，具体步骤见确认作品归属。
有写入结果需要核实
任务详情出现此提示时，先暂停任务并等待在途操作停止，再点击“核实写入结果”。核实只读取已存在的目标，与原写入证据比较，不会补写图片或覆盖 NFO；证据不足会继续保护该目标。
决定放弃此产物时，可使用“终止此产物”：将它记为失败并保留现有文件和证据，依赖它的文件按实际结果结束。核实或终止后都不会自动恢复任务，仍需另行决定。完整流程见异常结果核对。
查看结果
任务详情和历史记录会列出处理结果。需要让 Emby 或 Jellyfin 显示新资料时，在媒体服务器中刷新对应媒体库。
| 情况 | 建议 |
|---|---|
| 找不到作品 | 检查片名、年份和媒体类型；必要时使用手动刮削。 |
| 找错作品 | 在手动刮削中重新搜索并选择正确结果。 |
| 没有写入资料 | 检查该存储和目录是否可写，以及任务是否实际运行。 |
| 海报没有更新 | 选择“全部覆盖”或在手动刮削中勾选覆盖，然后刷新媒体服务器。 |
刮削成功只表示资料已经写入目标目录，不代表 Emby 或 Jellyfin 已经立即显示。媒体服务器仍可能需要刷新媒体库；如果服务器开启了自己的资料缓存，也要等待它重新读取。
普通缺图、必需资料失败与写入结果不明的含义不同，先读逐文件原因和警告。已写出的单文件资料不会因共享资料失败自动删除，取消也不会撤回已完成的写入。
删除刮削任务只删除自动运行规则，不会删除已写入的海报、简介或资料文件。