企业官网建设流程全解析

3分钟装好MusicFreePlugins：一套免费插件让播放器搜遍全网音乐源

【免费下载链接】MusicFreePluginsMusicFree播放插件项目地址: https://gitcode.com/gh_mirrors/mu/MusicFreePlugins

你是不是也有过这种体验：一首歌在A软件搜不到，B软件要开会员，C软件干脆下架了。翻遍了手机里五个App，最后还是没听到。MusicFreePlugins就是为此准备的开源插件仓库：它为 MusicFree 播放器提供了一套可安装的音乐插件，让你在一个搜索框里同时查多个平台的曲库，而且默认过滤掉收费和试听内容。这篇指南按"先跑通、再加深"的顺序带你从零用到进阶。

装之前，先把这份30秒清单过一遍

准备工作其实很短，缺哪样补哪样，别急着往下装。

• 装好 MusicFree 播放器：插件是寄生在播放器里的，App 本身要先就位，且建议是较新版本，老版本可能出现协议不兼容。
• 网络能访问插件托管地址：插件是通过远程地址下载的，网络受限（校园网、公司代理）会直接导致安装失败。
• 拿到插件清单文件：仓库根目录的plugins.json就是所有插件的"菜单"，每个条目有name、url、version三个字段，后面装哪个都从这里查。
• （可选）Node.js 环境：只有当你想自己构建或测试插件时才需要，纯安装使用可以跳过。

第一次安装：从最小组合开始，一次只装两个插件

新手最容易犯的错是十几个全装上，出问题了都不知道是谁的锅。建议第一只装bilibili和歌词千寻这两个，刚好覆盖"找歌"和"找词"两件最常用的事。

具体步骤：

1. 克隆仓库拿到本地文件：

git clone https://gitcode.com/gh_mirrors/mu/MusicFreePlugins

2. 打开plugins.json，找到 bilibili 条目，复制它的url值。
3. 在 MusicFree 的插件管理里选"从URL安装"，把地址粘贴进去；如果你已经把仓库克隆到本地并执行过npm run build，也可以用"从本地安装"直接选dist/目录下对应的index.js文件。
4. 验证是否装好了：在搜索框输入一首你熟悉且有代表性的歌名。如果结果列表里出现了带平台标识的条目、点开能播放，并且歌词栏能自动带出文字，说明闭环已经跑通。整个过程顺利的话，三分钟以内。

装完这两个再逐步添，每一步都能立刻验证，出问题定位也快。

高频到进阶：插件到底能替你干哪些事

跑通基础搜索后，这些能力按使用频率从高到低排给你。

多档音质切换。播放器统一用 low / standard / high / super 四档标准（定义在 类型定义文件 里），插件按档位返回不同码率的音频地址。移动数据用标准档，家里 WiFi 切高档，省流量和听感两头兼顾。

歌单导入。bilibili 插件支持把公开收藏夹整单搬进播放器：在插件的提示文案（hints字段，就在plugins/bilibili/index.ts的导出对象里能看到）里写了很详细的链接获取方式，移动端和桌面端各有一套，照着做就行。注意一点：非公开收藏夹导不进来，得先在原站改成公开。

榜单。bilibili 插件内置了榜单接口，分类不少，适合没有明确目标、就想随便刷刷的时候。

自建音乐服务。这是隐藏大招：Navidrome、WebDAV、Airsonic 三个插件都用了userVariables机制——说白了就是装完会弹窗让你填服务器地址、用户名、密码，不用改一行代码，NAS 或网盘里自己存的音频就变成了可搜索、可播放的曲库，还不受任何平台规则影响。

歌词补全。歌词千寻、歌词网两个插件声明了supportedSearchType: ['lyric']，专门负责"只有歌没有词"的场面，装了之后缺失歌词可以自动补齐。

其他零散能力。suno、udio 插件把 AI 音乐平台接了进来；bilibili 插件还实现了评论获取，播放时能顺带看评论区。

按你的身份选组合，别贪多

通勤学生党（求稳、省流量）

• 清单：bilibili + 歌词千寻
• 流程：装完 → 搜索试听 → 音质固定标准档 → 收藏夹整单导入当日常播放列表
• 建议：先用满两周再加插件，习惯它的聚合搜索逻辑，比装得多更重要。

NAS 玩家（本地曲库是主体）

• 清单：navidrome（或 webdav）+ bilibili + 歌词网
• 流程：装 navidrome → 弹窗填服务器地址和账号 → 把本地曲库设为常用来源 → 在线平台只用来补本地没有的
• 建议：自建服务地址务必带协议前缀，http://或https://少了就是连不上。

想动手写插件的开发者

• 路径：读example/freesound.js这个不到 60 行的完整示例 → 对照 types/plugin.d.ts 的接口定义 → 重点理解search和getMediaSource两个方法 → 到test/目录找同类脚本跑一遍验证
• 建议：第一版插件只需要让每条搜索结果带上id、title、artist、url四个字段，能搜能播就算毕业。

出问题了：自己按这张表查

排查原则一句话：一次只动一个变量。改了地址还不行，就别同时改密码，先把每个可能单独验证过。

最后一句：好用的前提是守边界

这套插件本质是教学示例，数据来自网络公开接口，仓库已过滤全部 VIP、收费和试听内容，作者也曾在收到告知函后移除了部分平台来源。所以请把它仅用于学习和个人合理使用，不要商用，也别绕过付费墙——省下的会员费可以，省掉创作者的权益不行。

装两个插件、搜一首歌、导一个歌单，十分钟以内你就能看到效果。剩下的能力，听多了自然就知道下一步该加什么了。

【免费下载链接】MusicFreePluginsMusicFree播放插件项目地址: https://gitcode.com/gh_mirrors/mu/MusicFreePlugins