V3 将音乐接入现有搜索、订阅、下载、整理和媒体服务器流程。可以搜索歌曲或专辑,选择站点资源下载,整理音频文件并补充标签、封面与歌词。
MoviePilot 不提供独立音乐播放器、歌单管理或另一套本地音乐库。整理结果交给 Navidrome 或其他支持音乐的媒体服务器扫描与播放;各来源和服务的可用能力以当前实例为准。
可以先从已有音频文件的手动整理开始,不必先开启音乐订阅。
在搜索页选择音乐相关入口,核对结果是 歌曲 还是 专辑,再查看艺术家、专辑、发行信息和资源。相同名称可能有不同演唱者、重录版、单曲版和专辑版,不能只凭标题判断。
音乐订阅复用订阅站点、刷新、过滤和下载流程。创建歌曲或专辑订阅后,检查订阅页的目标及进度;洗版还需设置能区分音质的规则和合适覆盖策略。
站点直接搜索的资源是候选,不等同于已经完成音乐身份匹配。资源类型、曲目范围和专辑完整性都会影响后续处理。
当前 MoviePilot 的音乐标签与封面写入会保护链接源:有实际修改时先写独立副本,再替换媒体库目标;源音频保持不变,目标因此可能占用独立空间。没有变化时保留原链接。其他软件直接改写硬链接内容仍会影响源文件,不能将这项保护推广到所有外部软件。详细流程见文件整理。
| 项目 | 相关设置或检查 |
|---|---|
| 封面网络 | MUSIC_COVER_PROXY,以及封面来源可达性 |
| 同目录封面 | MUSIC_LOCAL_COVER_ENABLE、MUSIC_COVER_FILE_PATTERNS |
| CUE 信息 | MUSIC_CUE_ENABLE;错误的关联 CUE 可能影响分轨识别 |
| 标准元数据简体化 | MUSIC_METADATA_TO_SIMPLIFIED |
| 歌词正文简体化 | MUSIC_LYRICS_TO_SIMPLIFIED,与元数据开关独立 |
| 发行偏好 | MUSIC_RELEASE_REGION_PRIORITY、MUSIC_RELEASE_SCRIPT_PRIORITY |
| 在线歌词 | LRCLIB_BASE_URL、AMLL_BASE_URL 及已安装歌词插件 |
默认值与说明见配置项索引。歌词、封面缺失不一定意味着音频识别失败,应分别检查来源与日志。
CUE 开关表示是否读取关联信息,不应据此认为所有整轨格式都会自动分割成独立曲目。以整理预览、支持的音频格式和实际结果为准。
未启用智能助手时,已接入并获得授权的消息渠道可使用音乐命令,例如:
音乐 搜索 周杰伦 晴天
音乐 下载 周杰伦 晴天
音乐 订阅 周杰伦 晴天
音乐 洗版 周杰伦 晴天
按回复中的编号或按钮继续选择歌曲、专辑和资源。启用智能助手后,也可以使用自然语言,但下载与整理仍需遵守账号权限和实际配置。
| 现象 | 检查方向 |
|---|---|
| 能搜歌曲但没有站点资源 | 站点音乐分类、关键词、凭据和索引支持 |
| 错专辑、错艺术家 | 音频标签、文件名、来源身份、发行版次与 CUE |
| 专辑整理不完整 | 资源包含曲目、支持后缀、曲号、识别和失败记录 |
| 封面或歌词没有写入 | 单独检查开关、来源网络与当前文件格式 |
| 音乐库没有更新 | 目标路径、服务器音乐库范围、扫描和库存同步 |