MusicFree 3 步搞定完整歌词获取链路【免费下载链接】MusicFree插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/GitHub_Trending/mu/MusicFree切到下一首歌歌词却还停在 loading——很多人以为 MusicFree 内置了一个大歌词库其实它是靠插件实现多源歌词获取你装了几个音乐插件它就多了几个歌词来源每首新歌都要现场去问一遍。为什么切歌后歌词总要慢半拍这个免费开源的播放器把歌词能力外包给了插件体系。好处是不用自己养歌词库代价也很直接一首从没听过的歌第一次播放时歌词全靠网络现拉慢是正常现象不是坏了。真正值得看的是它在拿不到歌词时那一串兜底动作。一首歌的歌词从哪条路找来整条链路在 lyricManager.ts 里流程可以口语化成一句话播放新歌 → 先问这首歌出身平台的插件 → 插件内部依次试手动关联过的歌词、本地上传的 LRC 文件、上次缓存的结果、再问平台要 → 全都落空且开了自动搜索 → 拿歌名去其他插件里搜选最像的那条。第一步就是按歌曲的平台找到对应插件把歌词请求交出去lrcSource await this.pluginManager.getByMedia(musicItem) ?.methods?.getLyric(musicItem) ?? null;插件内部也分先后手动关联的歌词和写在 local_lrc 目录里的本地文件最优先其次才是缓存和远程接口。同一首歌第二次播放时基本不用等网络。自动搜索是怎么挑歌的搜索时pluginManager 会列出所有支持搜歌词的已启用插件当前歌曲出身的平台除外每个插件只取前两条结果然后把歌名差几个字 歌手差几个字加起来总和最小的候选中选标题和歌手完全一致就直接命中后面的插件不用问了。参与搜索的歌名优先用歌曲别名没有别名才退回标题。const dist minDistance(keyword, musicItem.title) minDistance(item.artist, musicItem.artist); 3 个开关把歌词调到最顺手打开歌词缺失时自动搜索歌词在设置的基础设置里缺词时自动跨插件找找不到也不会一直白屏。给插件排个序插件管理里可以调整顺序排序决定歌词搜索的提问顺序把最可靠的源放前面。把好词固定下来在歌曲详情的歌词菜单里关联歌词到正确版本或上传本地 LRC支持单独传翻译文件之后永远走本地文件秒开、离线也能看。⚡ 3 个容易卡住的地方自动搜索挂上了别人的歌原因每个插件只比前两条结果同名不同人的歌很容易撞。处理手动关联到正确歌曲一次设置永久生效自动搜索不再插手这首歌。快速切歌时歌词一直转圈原因每首歌的歌词都是现场网络请求切太快时旧请求会被直接丢弃、新请求从头开始。处理高频播放的歌上传本地 LRC读文件不走网络。歌词和口型固定差几秒原因源歌词自带时间偏差不同平台同一首歌的时间轴也不一定一致。处理在歌词菜单里调偏移量按毫秒记在这首歌身上下次不用重调。这套链路的设计思路其实很朴素能本地就不联网能复用就不重拉实在没有再去全网搜最像的。装上两三个音乐插件后挑一首经常缺词的歌试一次关联歌词第二遍播放它就不再让你等了。【免费下载链接】MusicFree插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/GitHub_Trending/mu/MusicFree创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考