移动端插件安装——从输入 URL 到能搜歌

为什么必须先装插件

MusicFree 的软件本体不带任何音源。第一次启动后，搜索框搜不到任何歌曲、歌单页是空的、播放页没有内容——这全是正常的。只有安装插件后，搜索、播放、歌词、歌单导入这些功能才会生效。

方式一：从网络安装插件（推荐）

官方提供了一个示例插件仓库，可以一键安装多个常用音源插件：

1. 打开 MusicFree，点击左上角侧边栏。
2. 滑动找到「插件设置」，点击进入。

1. 点击右下角的加号按钮。
2. 选择「从网络安装插件」。
3. 在输入框中填入插件仓库的 JSON 地址（以 .json 结尾），点击确认。

官方示例仓库地址（任一可用）：

• GitCode：raw.gitcode.com/maotoumao/MusicFreePlugins/raw/master/plugins.json
• GitHub：raw.githubusercontent.com/maotoumao/MusicFreePlugins/master/plugins.json

1. 等待下载完成，插件列表会出现新安装的插件条目。
2. 逐个点击插件，进入详情页后点「启用」。

方式二：本地安装插件

如果已经从网上下载了单个插件文件（.js 或 .json 格式）：

1. 同样进入「插件设置」，点右下角加号。
2. 选择「从本地安装插件」。
3. 在文件管理器中找到下载好的插件文件。
4. 确认导入后启用插件。

插件列表里有什么

启用插件后回到主界面，搜索框就能用了。不同插件提供的功能不同，常见的包括：

• 网易云音乐插件：支持搜索、播放、歌单导入
• QQ 音乐插件：同上
• 酷我音乐插件：同上
• 咪咕音乐插件：同上

每个插件的功能覆盖度可能不同（有的能导入歌单，有的只能搜索播放），这取决于插件本身的实现。

常见问题

插件安装失败？ 检查输入的 URL 是否以 .json 或 .js 结尾；确认 URL 确实指向 MusicFree 插件；网络不通时可以稍后重试，或下载后走本地安装流程。

插件能装多少个？ 没数量上限，但建议根据实际需求安装，太多可能导致插件列表冗长。

插件需要登录吗？ 示例插件仓库声明不过滤需要登录才能访问的内容，但大多数示例插件不强制要求登录。第三方插件可能有自己的登录要求。