最佳实践

Plex 发现新文件有三条路，按及时程度排列如下。

生成工具通知 Plex

STRM 或下载整理工具写完文件后，调用 Plex 的接口只扫描新文件所在的目录，例如 /library/sections/<媒体库编号>/refresh?path=<目录>。不依赖系统的文件通知，网络共享与网盘挂载的目录同样有效。工具支持时优先用这一条。

自动扫描

在 Plex 设置「资料库」里打开「自动扫描我的资料库」与「当检测到更改时，启动局部扫描」，Plex 收到系统的文件通知后只扫描变动的目录。目录很多时要先确认系统的监听名额够用，见「常见问题排查」一章的「新文件不自动入库」。

定时扫描

「定期扫描我的资料库」与维护时段的「维护期间刷新所有库中内容」都会扫描整个媒体库，媒体库越大越慢。前两条可靠时，保留其中一项、间隔设长一些作为兜底即可。

Plex 的定期扫描与局部扫描遇到没有变化的 STRM 文件夹时直接跳过，生成工具改写过 STRM 的文件夹才重新处理，Plex 客户端里看到的仍是视频的实际大小。从旧版升级后第一次启动时，Cirvel 在后台把已有 STRM 的记录修正一次，这期间 Plex 照常使用，修正完成之前开始的扫描还会按原来的方式处理一次。

电影、剧集、动漫、短剧分别建库，一个库扫描时不拖慢其它库，Cirvel 的补齐、按媒体库生成片头片尾与清理缺失文件也都能按库进行，先处理常看的库。同一部作品的本地文件与 STRM 可以放在同一个库里，Cirvel 会自动选择播放哪一份，见「播放」一章的「本地与 STRM 并存时优先播放」。

Cirvel 为 STRM 取得媒体信息时按下面的顺序查找，找到就停，前面几项都不访问网盘。

1. 1媒体档案 这条 STRM 之前分析过的结果，免费版同样使用。
2. 2媒体信息文件（Pro） 先找 STRM 旁边，再找设置的位置，见「媒体信息」一章的「读取与生成媒体信息文件」。
3. 3同一份本地文件（Pro） 本地有同名文件时复用 Plex 为它分析的结果，按「本地复用匹配」的方式核对，默认核对时只读远端文件首尾很少的数据。
4. 4访问网盘读取 以上都没有时才访问网盘，受「后台每小时请求上限」约束。

从 Emby 迁来

保留 Emby 导出的媒体信息文件，按原来的存放位置填好「媒体信息文件位置」，大部分条目不必再访问网盘。

今后可能迁移或重建媒体库

打开「生成媒体信息文件」，并保留 Cirvel 的备份，媒体档案随备份一起带走。

第一次整库补齐（Pro）

需要的时间大约是待分析的数量除以「后台每小时请求上限」，媒体库很大时会持续好几天，这是正常的，期间打开与播放的条目总是优先。不建议为了加快而调高上限，网盘风控的代价更大。

网盘风控很严

打开「静默分析」，只在打开条目时读取。

为只有 STRM 的集生成片头片尾要从网盘读取视频，自动生成默认关闭，打开后也受 STRM 每日上限约束。剧集很多时，自动生成跟不上新增的速度，按需生成更合适。

• 常看的剧在顶栏「查找条目」里找到这部剧或这一季，点「立即生成」，不计入每日上限。
• 有本地文件或文件自带章节的集不读网盘，见「片头片尾」一章的「从本地文件与章节补全」。
• 想让自动生成覆盖更多时，按媒体库逐个生成，从常看的库开始。