歌词与 MV 匹配说明

歌词和 MV 都属于“候选匹配”功能。ECHO NEXT 会根据当前歌曲的标题、艺术家、专辑、时长、已有标签和网络来源返回结果，再尽量选择最合适的候选。

这类功能的重点是提高便利性，不是保证每首歌都能自动命中完全正确的版本。遇到不准、不同步、打不开时，先按候选和诊断排查，不要把它当成曲库、音频输出或播放器一定坏了。

先理解匹配为什么不可能 100%

自动匹配不是读取一个绝对标准答案。现实里同一首歌可能有很多版本：

情况	会造成什么
原版、现场版、剪辑版、Remix、伴奏版	歌词时间轴和 MV 画面可能完全不同
单曲版和专辑版时长不同	歌词整体可能越来越偏
标题里有 feat.、with、翻译名、罗马音、别名	搜索候选可能混入其它版本
平台视频标题不是标准曲名	MV 自动匹配可能选到饭制、舞台、剪辑或搬运
上传者重新压制或剪掉片头片尾	视频和音频不可能天然完全同步
网络源返回顺序变化	今天第一个候选不一定永远是同一个

所以“自动匹配”只能做到尽量接近。它可以节省大量手动搜索时间，但不能替代用户对具体版本的判断。

歌词匹配应该怎么判断

歌词的优先级建议是：

1. 本地 LRC 或你自己保存过的歌词。
2. 文件内嵌歌词。
3. 在线歌词候选。
4. 手动选择的候选。
5. 单曲偏移或手动修正。

如果歌词不准，先判断是哪一种不准：

现象	更可能的原因	先做什么
完全是另一首歌	匹配到错误候选	手动切换候选
整首都早一点或晚一点	候选歌词整体偏移	调单曲偏移
前面准、后面越来越不准	歌曲版本或时长不同	换同版本歌词
只有几句不准	歌词文件自身时间轴质量差	换候选或手动修
翻译对不上原文	翻译来源和主歌词不是同一版本	关闭翻译或换候选

不要拿全局偏移去修单首歌。全局偏移只适合“所有歌曲在你的设备上都稳定早一点或晚一点”的情况。

MV 匹配为什么更难

MV 比歌词更不可能做到 100% 自动匹配，尤其当 MV 来源是 Bilibili 时。

Bilibili 本质上是视频平台，不是专门为某个音频文件建立的一一对应 MV 数据库。平台上的视频可能是官方 MV、现场、字幕版、饭制、剪辑、搬运、补帧、重压制、演唱会片段或不同地区版本。视频标题、简介、标签、投稿者和播放量只能作为线索，不能证明它就是当前音频文件的标准 MV。

更重要的是，Bilibili 视频里的音轨通常不是你正在播放的那份音频文件。即使视频内容是同一首歌，也可能存在：

1. 片头、片尾、黑屏、字幕卡。
2. 上传者剪辑过前奏或结尾。
3. 音频被重新压制。
4. 现场版和录音室版不同。
5. MV 版本和专辑版本时长不同。
6. 视频帧率、浏览器解码、网络缓冲带来的显示延迟。

因此 MV 不可能承诺与音频完全同步。ECHO NEXT 可以帮你找候选、尽量对齐、提供重播音频或手动 URL，但不能把第三方视频源变成和本地音频逐毫秒绑定的官方同步素材。

MV 不准时怎么处理

按这个顺序排查最省时间：

1. 先看候选标题、上传者、时长和画面内容。
2. 优先选择官方 MV 或最接近官方版本的视频。
3. 如果自动候选不对，手动选择候选。
4. 如果你已经知道正确视频，直接填自定义 URL。
5. 如果音频和视频版本不同，换视频比调同步更有效。
6. 如果只是整体早晚，可以尝试同步相关设置。
7. 如果每次都差得很离谱，先提高自动匹配阈值，减少误选。

不要把“MV 不准”当作音频输出问题。音频正常播放、歌词正常显示，但 MV 选错或不同步时，重点看候选、来源、版本和视频状态。

MV 打不开或看不到画面

打不开不一定是 ECHO 自身问题。MV 需要经过网络请求、平台访问、账号或 Cookie 状态、视频流解析、浏览器解码、画面渲染等多步链路。任意一环失败都会表现成没有画面、加载失败、黑屏或只能外部播放。

先检查：

1. 当前网络能否访问对应平台。
2. 代理设置是否影响 Bilibili、YouTube 或其它来源。
3. 账号登录状态或 Cookie 是否过期。
4. 视频是否需要登录、地区权限、会员权限或平台风控。
5. 画质是否过高，例如 HEVC、HDR、Dolby Vision、4K 60fps。
6. 是否开启了过重的沉浸背景、视频壁纸或实时效果。
7. 外部播放器能否打开同一个 URL。

如果有打不开、黑屏、加载失败、只有声音没有画面、候选明明存在但无法播放等问题，请打开 MV 诊断报告。它会生成可复制的本地 Markdown 报告，里面包含当前 MV 状态、候选、来源、错误线索和页面可见性信息。

反馈时请把 MV 诊断报告 连同截图、ECHO NEXT 版本、系统版本、当前歌曲、视频 URL 或候选标题一起发出。只说“MV 打不开”通常无法判断是网络、平台、登录、编码、候选还是渲染问题。

建议设置

目标	建议
想减少错配	提高 MV 自动匹配阈值
网络慢或页面卡	关闭 MV 自动预加载，降低最高画质
视频卡顿	关闭 60fps，先用 720p 或 1080p
画面能播但歌词看不清	开启 MV 歌词可读性增强或调暗背景
候选经常不是官方 MV	手动选择候选或使用自定义 URL
排查打不开	打开 MV 诊断报告 并复制报告

反馈前别做什么

这些操作通常不能解决歌词或 MV 问题，反而会让排查变复杂：

1. 不要先删除数据库。
2. 不要清空整个曲库。
3. 不要连续切很多音频输出模式。
4. 不要同时改代理、账号、画质、来源顺序和同步模式。
5. 不要只截图黑屏页面而不发诊断报告。

更稳的做法是：保留当前歌曲、当前候选、当前设置和诊断报告。这样才能看出问题发生在哪一环。