V3 将音乐作为与电影、电视剧并列的媒体类型。下载完成后，系统会读取音频标签和实际音频参数，并结合种子名称、文件名、目录以及下载时保存的媒体信息，按音乐重命名格式整理到目标目录。
以下识别状态和按专辑纠正功能需要配套的 V3 后端与前端。旧后端只返回路径预览时，更新前端不会自动补出识别依据或启用专辑纠正。
尽量保留 PT 资源原有的专辑目录、CD1/CD2 等碟目录和种子名称。把多个专辑提前摊平到一个目录、删除版本信息，或只保留 01.flac 这样的文件名，会减少可用的识别依据。在线补全依赖已启用的数据源及其覆盖范围；指纹识别也是辅助证据，不能保证所有发行版本都有对应记录。
默认命名结构为：
专辑艺术家/专辑 (年份)/曲序 - 歌曲.扩展名
专辑艺术家/专辑 (年份)/Disc 碟号/曲序 - 歌曲.扩展名 # 已知多碟专辑
在 设定 -> 目录 -> 音乐重命名格式 中可使用 Jinja2 格式调整目录和文件名，常用字段包括 artist、album_artist、album、title、track、disc、disc_number、total_discs、year 和 fileExt。默认先使用专辑艺术家，没有时使用曲目艺人；总碟数大于 1 时才增加碟目录。升级不会替换你已经保存的自定义模板，需要时请自行加入碟号，避免不同碟的同序号歌曲重名。
音乐 -> 艺术家合集，按专辑子目录检查结果；不要把整个全集手动指定成一张专辑。MoviePilot 只负责下载后的识别、整理和刮削，不建立音乐媒体库、不播放音频，也不负责歌单或歌手库同步。整理完成后请由 Navidrome、Emby、Jellyfin、Plex 等媒体服务器扫描目标目录。
音乐整理会处理匹配的 CUE 及与音轨同目录、同主干名的 .lrc、.txt 和 .lyricsfile.yaml。启用音乐刮削后可写入目标文件的标签和封面，并按“质量升级”策略读取内嵌歌词、查询在线来源和生成旁挂歌词；已有同步歌词不会被纯文本降级覆盖。
新版音乐标签/封面写入会保护链接指向的源音频：目标为硬链接或软链接时，先在独立副本中完成修改，成功后替换媒体库中的目标入口。下载目录中的源文件内容保持不变；发生实际写入后，媒体库文件会占用独立空间。没有标签或封面变化时保留原链接。复制失败、空间不足或写入失败会保留原链接并报告错误。此保护针对 MoviePilot 的音乐写入流程；其他软件直接修改硬链接内容仍会影响做种文件。
仍在做种时优先使用合适的链接或复制方式；移动会改变源文件位置。只想整理文件名和目录时可以关闭刮削元数据。
文件管理中选择专辑目录或音频文件，打开整理；也可从失败的整理历史进入重新整理。点击预览，先核对目标路径和每组文件。本地标签、CUE 信息表示使用本地证据；在线匹配表示已核验在线身份；人工选择表示使用了指定身份。已有媒体信息不等同于在线确认。即使识别信息可用，也可能因目标分类、覆盖策略或文件操作失败而不能入库，应同时看每项错误。候选待确认、信息冲突或版本不对的专辑，点击该组的纠正专辑 / 版本。选择音乐数据源并搜索专辑，核对艺人和曲目表。具体发行版本中核对日期、地区、介质和曲目数。列表没有目标版本时，展开未找到所需发行版？，粘贴具体 Release UUID 并读取曲目。Release、Release Group 和 Recording 是不同身份，不能互换；无法读取或不属于该专辑的发行不能应用。应用并重新预览，检查逐曲对位和目标路径。确认后再立即整理或加入整理队列；入队表示请求已接收，实际结果以队列和整理历史为准。纠正只处理该组已经预览过的源文件，配套文件一并保留。保存纠正后，本次执行的全部范围固定为预览中的文件，不会重新扫描父目录并带入后来新增的专辑。修改全局选项或源文件选择会使纠正失效，需要重新预览和核对；折叠预览面板不会丢失选择。仍有未通过预览的文件时，请完成处理后再执行。
| 预览提示 | 建议处理 |
|---|---|
| 未找到匹配 / 候选待确认 | 保留完整专辑范围和版本信息，检查标签、曲序及曲目数，必要时手选专辑和发行版 |
| 信息冲突 | 核对标签、种子或目录名称是否指向不同专辑，检查是否混入其他发行的曲目 |
| 识别服务暂不可用 / 本次查询额度已用完 | 检查来源连通性，稍后重试；这不代表资源永久无法识别，无需反复批量提交 |
| 音频无法读取 | 确认下载完成、文件内容与扩展名一致、文件未损坏，以及 MoviePilot 有读取权限 |
| 仅文件名信息 / 此组暂不可纠正 | 检查远端存储或预览范围，必要时下载到本地后重新预览；旧服务也可能缺少完整文件范围 |
| 暂不支持整理 | 先解包或转换为支持的音频资源，再重新选择文件 |
MoviePilot V2版本支持按目录设定是否通过下载器监控整理或者目录监控整理，内建集成了目录监控功能，无需安装第三方插件。
5分钟，设定中所有启用的下载器且设定了对应目录时都会自动整理。MoviePilot V1通过监测下载器中的下载任务状态来实现自动整理已下载的文件，通过设定 -> 连接 -> 下载器 打开 下载文件自动整理 开关开启自动整理功能。
5分钟。下载器种子标签，则只有下载器中有对应标签的下载任务才会被自动整理。对于非MoviePilot添加的下载任务，插件市场中提供了目录监控等插件实现自动监测和整理，这类插件通过监测文件变化来实现自动整理，注意参照 环境准备 中操作系统章节说明调整文件系统参数，同时需要打开下载器的为不完整文件添加扩展名选项，以避免文件在下载中就被自动转移了。
建议通过MoviePilot下载的内容优先使用内建的下载文件自动整理实现自动整理，基于监控目录整理等仅是插件提供的功能，非推荐整理方式。
如果使用
Qbittorrent做为下载器，可在 QB设置->下载完成时运行外部程序 处填入：curl "http://localhost:3000/api/v1/transfer/now?token=moviepilot" ，实现无需等待轮循下载完成后立即整理入库（地址、端口和token按实际调整，curl也可更换为wget）。
根据磁盘结构、空间大小、保种需要等综合决定使用哪种文件整理方式，在设定 -> 目录 -> 整理模式 中调整。
/moviepilot/.config/rclone）或在容器内使用rclone config完成rclone配置，网盘配置名称必须为：MP，可自行通过Docker添加环境变量传递参数优化传输，参考：https://rclone.org/docs/#environment-variables 。在 设定 -> 目录 -> 整理模式 中调整媒体库已存在同名文件（后缀名也相同）时对应的处理策略：
从不覆盖：当媒体库中存在同名文件时中断整理，历史记录中将产生错误的整理记录。按大小覆盖：当下载文件比媒体库中已有文件更大时覆盖已有文件，否则中断整理并在历史记录中将产生错误的整理记录。总是覆盖：直接使用下载的文件覆盖媒体库中的同名文件。仅保留最新版本：同一个电影或者电视剧剧集，删除媒体库中的其它版本文件（包括文件名不一致的），仅保留下载整理的最新版本。历史记录中手动进行整理。文件管理功能浏览文件系统，对整个目录或者某个文件进行手动整理。文件管理中对专辑目录直接点击整理，或进入多选模式勾选该目录；类型选择音乐后会默认使用专辑实体，单个音频文件则默认使用单曲实体。如涉及需要同时整理多个相似文件（比如一部剧有多集），参见 进阶 批量手动整理章节。
历史记录 -> 整理历史 中的单条记录当前通常有两类重新处理方式：
重新整理
智能助手整理
使用前提：
AI_AGENT_ENABLE执行特点：
智能助手整理是独立的后端接口，不是简单包装传统/redo命令。
对于习惯命令方式处理问题的用户，仍然可以通过消息渠道使用：
/redo [id]
/redo [id] [media_source]|[media_id]|[类型]
适合：
如果并不确定该如何修正，优先尝试 智能助手整理 往往更省事。