媒体库

识别

这些设置只保存在本设备，不同步。

• 从 TMDB 获取影片信息：默认关闭。打开后，没有 NFO 的影片从 TMDB 获取海报、简介和演员。不需要自己申请 API 密钥。
• 动画也在 Bangumi 查找：默认开启，在 TMDB 开关打开时生效。
• 从 MusicBrainz 获取音乐信息：默认关闭。找到专辑的年份，补上缺少的封面，还找到具体的发行版本和演职人员；艺术家页的简介和照片来自维基百科和维基共享资源。
• 从 Open Library 获取图书信息：默认关闭。找到图书的年份，补上缺少的封面；作者页显示来自 Open Library 和维基百科的简介。
• AI 辅助识别：默认关闭。用你选择的 AI 服务和模型协助识别规则无法识别的影片、专辑和图书，见AI 辅助识别。
• 接口地址：默认 api.tmdb.org，在中国大陆可以访问；也可以选 api.themoviedb.org（中国大陆可能无法访问），或填写自己的 https 地址，例如反向代理。
• 图片地址：默认 image.tmdb.org，也可以自定义。

隐私与家长控制

• 私密媒体库：见私密媒体库。
• 家长控制：见家长控制。

同步

• 跨设备同步媒体库：见跨设备同步。
• 跨设备同步扫描数据和图片包：见同步扫描数据。

扫描与存储

• 同时读取的媒体库数：同时读取并查找信息的媒体库数量，默认 1，上一个媒体库完成后才开始下一个。
• 媒体信息：「后台检测媒体信息」「文件之间的间隔」「播放视频时暂停」和「海报角标」，见媒体信息。
• 本机数据：媒体库数据和图片占用的空间；「图片上限」默认 1 GB，可选 500 MB 至 100 GB，或不限；「清除媒体库数据」删除已读取的条目、详细信息和图片，然后重新读取，媒体库、识别结果和观看进度保留。见媒体库数据。

高级

• Emby 兼容接口（Meta Quest 没有）：见Emby 兼容接口。
• 导出与导入：「导出媒体库…」把媒体库保存为一个 JSON 文件；不使用同步时，可以在另一台设备上用「导入媒体库…」导入。私密媒体库只在解锁时导出。手动识别的结果不导出。电视上没有这一项。

不单独成为影片的文件

• 花絮和预告片属于所在的影片，例如 trailers、featurettes 文件夹，名称以 -trailer 结尾的文件，以及字幕组的 [NCOP]、[NCED]。
• NAS 和系统的文件夹不读取，例如 @eaDir、#recycle、$RECYCLE.BIN。
• 名称带「测试」「样片」「demo」等词的视频按测试片段处理，不在线查找。
• 同一个媒体库中同一部电影的几个文件合并为一部电影，在详情页的版本中选择。

在名称中指定条目

文件或文件夹名中的 {tmdbid=123}、[tmdb-123]、(imdb-tt0113277)，或 MoviePilot 的 {[tmdbid=123;type=tv;s=2]}，直接指定 TMDB 或 IMDb 条目，不再搜索。识别不对时，也可以在「识别…」中手动选择，或用识别词修正一批文件。

视频文件

mkv、mp4、m4v、mov、avi、wmv、flv、webm、mpg、mpeg、m2ts、mts、ts、vob、rmvb、rm、3gp、ogv、iso。

• =>、&&、<>、>> 两侧需要空格。调整集数时，前后的定位词可以有一个为空。
• 规则是正则表达式，对照名称原文匹配，包括扩展名；默认区分大小写。
• 调整集数时，两个词之间的每个数字都会改变；表达式支持 EP、整数和加减乘除。数字前面的 0 会保留（05 加 12 是 17），中文数字仍写成中文。
• {[…]} 中可以写 tmdbid、imdbid、type（movie 或 tv）、s（季）、e（集）。
• 最多读取 1,000 行，每行最多 1,000 个字符。

• 识别词只在这个媒体库中生效：文件管理、播放器和字幕中显示的仍是原来的名称，文件也不会被改名。
• 编辑器逐行检查，例如「第 4 行未使用：…」。「试一个名称」显示改写后的名称、是哪几行改的，以及读取出的片名、年份、季和集。
• 修改识别词后，媒体库重新整理；NFO 中的信息和观看进度保留。
• 「导出」保存为 <媒体库> 识别词.txt（UTF-8）。「导入」支持 UTF-8 和 GB18030 编码的文件，可以选「添加到末尾」（跳过已有的行）或「替换」。电视上可以用手机输入整段文字。
• 识别词随媒体库同步，以最后一次编辑为准。

来源

• 由文件名推测：每部影片先按文件名推测分辨率、HDR、编码和音轨（如 2160p、DV、Atmos）。
• 来自 NFO：NFO 中的 <streamdetails>。
• 检测媒体信息：读取文件开头，支持 MKV、MP4、TS 和 M2TS，一部 2 小时的电影通常只读取 128–320 KB；蓝光 ISO 和 BDMV 文件夹从播放列表读取正片的信息。
• 播放时保存：播放媒体库中的视频几秒后，保存播放器读到的信息。

能读出编码、分辨率、帧率、HDR10、HDR10+、HLG 和杜比视界、杜比全景声、DTS-HD MA 和 DTS:X，以及音轨和字幕的语言。结果按文件的大小和修改时间保存，文件改变后重新检测。

用途

媒体信息用于海报上的 4K、杜比视界、HDR、全景声角标（检测过的为实心，仅由文件名推测的为空心）、「画面与声音」筛选、一部电影有多个版本时选择最适合本设备的版本，以及在待确认中列出无法读取或时长不符的文件。开启「在媒体旁保存信息和图片」时，检测结果也写入 NFO。

识别时检测

每个视频媒体库的「识别时检测媒体信息」默认开启：扫描这个媒体库的设备在识别影片的同时读取视频文件的开头，最新的影片先检测，一个文件通常只读 256 KB 左右。开启跨设备同步扫描数据时，结果同步到其他设备，它们不再读取。

后台检测媒体信息

用于关闭了「识别时检测媒体信息」的媒体库。在「设置 → 媒体库 → 扫描与存储」中打开，默认关闭，只对本设备有效。它逐个、缓慢地读取每个视频文件的开头：读完一个文件后按「文件之间的间隔」等待（云盘默认 2 秒），播放视频时暂停。

设置

• 播放媒体库中剧集的一集时，在播放器的「片头片尾」中，播放到片头结束或片尾开始的地方点「设为当前位置」。
• 片头从每一集的开头算，片尾从每一集的结尾倒着算，所以长度不同的各集也能用同一个设置。
• 「跳过片头片尾」开关只对这台设备有效，默认打开；关闭后不跳过，设置的时间保留。

播放时

• 从头播放一集时跳过片头；播放到片尾开始的地方时接着播放下一集，这一集算作看完。
• 手动把进度拖到片头或片尾之内时照常播放。

哪些设备

Mac、iPhone、iPad、Apple TV、Apple Vision Pro（窗口播放和沉浸式播放）、Android 手机、平板和电视、Meta Quest、Windows 电脑。

格式

flac、ape、wav、wv、m4a、alac、aac、mp3、ogg、oga、opus、dsf、dff、tak、tta、aif、aiff、wma、dts、ac3、mka；SACD ISO；.cue 整轨。

标签

• 支持常见的标签格式：ID3、FLAC 和 Ogg 的 Vorbis 注释、MP4、APE 等。只读取文件开头的一小段，不下载整个文件。
• 用 GBK、Big5 等旧编码写的中文标签也能正确显示，例如「陳百強」。
• 繁体和简体视为同一位艺术家：「譚詠麟」和「谭咏麟」在一起。「群星」「Various Artists」的专辑排在艺术家列表最后。

CUE 和 SACD

整轨文件按 .cue 分成曲目，可以切换上一首、下一首；FLAC 内嵌的 CUE 和 GBK 编码的 CUE 也能读取。SACD ISO 的专辑页列出立体声和多声道曲目，多声道曲目标为 5.1。

封面

依次使用专辑文件夹中的图片、第一首内嵌的封面，以及开启 MusicBrainz 时 Cover Art Archive 的封面。

MusicBrainz

「从 MusicBrainz 获取音乐信息」和音乐库的「在线查找」都打开时，按条形码、CD 的曲目时长、唱片编号或专辑名和艺术家找到具体的发行版本，专辑页显示唱片公司、唱片编号、指挥、乐团、独奏和每首曲目的演职人员。艺术家使用 MusicBrainz 的名字，文件夹中的「Mozart」显示为 Wolfgang Amadeus Mozart；点名字打开艺术家页。专辑页的「识别专辑」可以手动选择，见识别专辑和图书。

歌词（同名的 .lrc 文件或标签中的歌词）由音频播放器显示。

整理和更新

• 第一次扫描时，找到的内容陆续出现，不需要等整个媒体库整理完。
• 没有改变的文件夹不会重新列出。列出文件夹的速度见避免网盘限制账号。
• 通过这台设备的 CloudDrive2 改名或移动文件时，影片的识别结果随文件移动。

什么时候重新扫描

• 完整扫描过的媒体库不会再自动扫描。可以在媒体库设置的「重新扫描」中设置自动扫描的间隔，或用「立即扫描」「扫描此文件夹」手动扫描。
• 第一次扫描被中断时，下次启动从中断处继续，直到完成。

自动发现新文件

账号有核心 Pro 功能文件变更通知时，通过这台设备的 CloudDrive2（应用、网页管理界面、WebDAV、挂载盘）添加、删除、改名的文件，通常在几秒内更新到媒体库，不需要重新扫描。

115、百度网盘和 123 云盘在文件夹内容改变时更新文件夹的修改时间，所以在其他地方添加的文件也能在下次整理时发现。其他云盘上由别的设备或网盘自己的应用做的改动，点「刷新」，或用「扫描此文件夹」「立即扫描」时出现。

本机数据

「设置 → 媒体库 → 扫描与存储」显示媒体库数据和图片占用的空间。「图片上限」可选 500 MB、1 GB、2 GB、5 GB、10 GB、50 GB、100 GB 或不限。「清除媒体库数据」删除已读取的条目、详细信息和图片，然后重新读取媒体库；媒体库、识别结果和观看进度都会保留。

离线时

网站无法访问时使用已缓存的信息。媒体库数据库中的内容在启动时立即显示，无法访问的云盘或文件夹不会让媒体库变空。

设备分享的内容

• 从文件中读取的信息：NFO、媒体信息、音乐标签、CUE、SACD 光盘文本和图书的元数据。
• 每个文件夹的整理结果，以及完整扫描过的媒体库的影片列表。取得列表的设备直接显示整个媒体库，只在发现变化或你要求扫描时，才重新读取变化的部分。
• 在线查找的结果，包括待确认和未找到的，以及人物的详情。
• 私密媒体库的数据也会同步：「私密」只在媒体界面中隐藏这些媒体库，不限制对云盘的访问。

不同步的内容

• 图片：由下面的图片包分享。
• 各设备自己的选项，例如图片上限和在本设备缓存文件。

文件夹结构

CloudDrive2 Sync/
  <CloudDrive 账号>/
    progress/   同步播放进度
    library/    媒体库
    facts/      扫描数据
      MacBook.<设备编号>.12-0.jsonl.zst
      MacBook.<设备编号>.12-3.jsonl.zst
    pictures/   图片包

每台设备只写自己的压缩文件。约 2.4 万个影视需要 18 MB。

什么时候同步

应用启动时、回到前台超过 10 分钟时读取；一次扫描或一轮在线查找有新内容时写入。数据包和图片等到连上 Wi-Fi 或有线网络再同步，除非打开「使用移动数据同步」。

关闭同步

已取入的内容保留在这台设备上。也可以同时从云盘删除这台设备的数据包和图片文件。

新设备加入

登录同一个 CloudDrive 账号，确认能访问保存「CloudDrive2 Sync」的云盘，然后打开「跨设备同步媒体库」和「跨设备同步扫描数据」。媒体库的文件夹按 CloudDrive2 中的完整路径保存，所以这个云盘在新设备上需要有相同的路径。其他设备完整扫描过的媒体库直接可用，例如一台新的 iPad 在约一分钟内显示了 Mac 上 7 个视频媒体库的全部影片。

先同步，再扫描

应用启动、打开同步或添加媒体库时，先取回其他设备的扫描数据，再扫描和识别，只处理数据包中还没有的部分。最多等待 5 分钟；离线或读取失败时照常扫描。

由一台设备扫描

同时打开两个同步开关时，一个媒体库由一台设备扫描，其他设备等待它的扫描结果，不再各自列出同样的文件夹。创建媒体库的设备默认扫描它，可以在媒体库设置的「在本设备上扫描此媒体库」中改为另一台设备。

• 扫描期间，扫描的设备至少每 10 分钟上传一次数据包；其他设备显示「正在 某设备 上扫描」，并取入它陆续找到的内容。
• 扫描的设备 30 分钟没有上传数据包（关机、离线）时，由其他设备继续扫描，已经得到的内容不会丢失。
• 在本设备点「立即扫描」「扫描此文件夹」或「刷新」总是马上扫描。
• 图书库扫描只要几秒，每台设备自己扫描。

锁定时

• 锁定时不能进入文件、文件管理器和设置；「识别…」、添加和删除媒体库需要输入密码。
• 离开应用或屏幕关闭时立即锁定；也可以设置输入密码后多久没有操作就重新锁定，默认从不。
• 忘记密码：输入这台设备上登录的 CloudDrive2 账户的密码，验证通过后设置新密码。

最高分级

可选不限制、G（所有年龄）、PG（8 岁以上）、PG-13（13 岁以上）、R（17 岁以上）。锁定时，高于此分级的影片在所有页面、搜索和首页中隐藏。

• 分级先取 NFO 中的分级，再取 TMDB 的分级；没有美国的分级时，按英国、德国、法国、日本等其他国家和地区的分级换算。
• 显示没有分级的影片：默认关闭。还没有分级信息的影片在锁定时隐藏，除非打开此项。

• CloudDrive 的服务器：不接收媒体库的任何内容。
• 信息来源网站：只在对应开关和媒体库的「在线查找」都打开时，发送表格中列出的内容，例如片名和年份。不发送文件内容、路径和账号。打开艺术家或作者页时，MusicBrainz 编号或作者姓名会发送给 Wikidata 和维基百科。
• 你选择的 AI 服务：只在打开「AI 辅助识别」时，发送所选媒体库中未识别项目在媒体库文件夹以下的路径、文件名，以及从文件中读到的标签、CUE、SACD 文本或 OPF（Windows 不发送目录表、目录编号和 SACD 文本）。私密媒体库的内容不发送。部分服务可能会用免费套餐下发送的内容训练模型；DeepSeek 将数据存储在中国大陆。
• 你的 Emby 或 Jellyfin 服务器：只在导入时用你的登录读取媒体库、影片、人物、图片和你的观看记录，不写入任何内容。
• 局域网中的应用：只在打开 Emby 兼容接口时，持有密钥的应用可以读取所选媒体库中的影片和人物。
• 你的云盘：开启同步时，保存同步文件；开启同步扫描数据时，保存数据包、图片文件，以及其他应用和导入的服务器给出的人物照片；开启保存信息和图片时，保存 NFO 和图片；用「编辑元数据…」保存时，写入影片文件夹的 NFO 和图片。

同步文件是普通的 JSON 文本，不加密，包含媒体库的名称和文件夹、PIN 校验信息、已识别影片的路径和 TMDB 编号、待确认的候选，以及剧集每一季跳过片头片尾的时间。能打开这个云盘的人，包括与你共用这个云盘账号的人和云盘服务商，都可以读取。请选择你愿意保存这些信息的云盘。删除「CloudDrive2 Sync」文件夹会删除云盘中的副本；仍然开启同步的设备会重新写入自己的文件。

扫描数据包是压缩的，没有加密，包含影视的路径、NFO 文件的内容、从媒体文件中读到的信息，以及 TMDB、MusicBrainz 等服务的查询结果，包括私密媒体库的数据；图片文件包含海报和封面。能打开这个云盘的人都能读到。