三步装好MusicFreePlugins：一个搜索框搞定全网音乐源
【免费下载链接】MusicFreePluginsMusicFree播放插件项目地址: https://gitcode.com/gh_mirrors/mu/MusicFreePlugins
搜一首歌，A软件提示要会员，B软件说已下架，C软件直接搜不到。MusicFreePlugins 就是为了解决这类麻烦：它是给 MusicFree 播放器的一套免费可安装音乐搜索插件，装上之后，一个搜索框同时查多个平台的曲库，收费和试听内容默认过滤掉。
先确认三件事再动手
- MusicFree 播放器已安装：插件跑在播放器里，App 要先就位，版本太旧可能出现协议不兼容。
- 网络能访问插件托管地址：插件从远程地址下载，校园网、公司代理这类受限网络会直接安装失败。
- 看清插件清单：仓库根目录的
plugins.json是所有插件的菜单，每个条目有 name、url、version 三个字段，装哪个都从这里查。 - Node.js 环境：想自己构建或测试插件才需要，纯安装使用可以跳过。
克隆仓库并装上第一个插件
- 把仓库克隆到本地：
git clone https://gitcode.com/gh_mirrors/mu/MusicFreePlugins- 打开
plugins.json，找到 bilibili 和歌词千寻两个条目，分别复制它们的 url 值。 - 在播放器的插件管理里选"从 URL 安装"，逐个粘贴地址。别急着全装，十几个一起上的话，出了问题都不知道是谁的锅。
- 搜一首你熟悉的歌：结果列表里出现带平台标识的条目、点开能播、歌词栏带出文字，就算跑通了。
过一遍能力：从日常用到动手做 🎧
你大概率会用到
- 多档音质切换：播放器统一用 low、standard、high、super 四档（定义在 types/plugin.d.ts 里），插件按档位返回不同码率的音频地址。移动数据用标准档，家里 WiFi 切高档。
- 歌词补全：歌词千寻、歌词网两个插件专门负责歌词，歌曲缺词时自动补齐。
- 榜单：bilibili 插件内置榜单接口，分类不少，没有明确目标、就想随便刷刷的时候最顺手。
用熟了再试
- 歌单导入：bilibili 插件支持把公开收藏夹整单搬进来，链接获取方式 就写在源码的 hints 字段里，移动端和桌面端各有一套。注意非公开收藏夹导不进来，得先在原站改成公开。
- 自建音乐服务：Navidrome、WebDAV、Airsonic 三个插件都用了 userVariables 机制（装完会弹窗让你填服务器地址、用户名、密码），NAS 或网盘里自己存的音频直接变成可搜索、可播放的曲库。
动手党专属
- 写自己的插件：先读 example/freesound.js 这个不到 60 行的完整示例，再对照接口定义理解 search（关键词搜索）和 getMediaSource（按歌曲信息取播放地址）两个方法，到 test/ 目录找同类脚本跑一遍验证。第一版插件只需让每条搜索结果带上 id、title、artist、url 四个字段，能搜能播就算毕业。
按你的用法选一套安装组合
- 如果你只是想通勤听歌：装 bilibili + 歌词千寻，音质固定标准档，把一个公开收藏夹导进来当日常播放列表。先用满一周再加插件，先习惯它的聚合搜索逻辑。
- 如果你本地已有一批音频：装 navidrome 或 webdav，弹窗里填服务器地址和账号，地址务必带 http:// 或 https:// 前缀，在线平台只用来补本地没有的。
- 如果你想看懂播放器内部在干什么：读 example/freesound.js 示例 → 对照 types/plugin.d.ts 的接口定义 → 重点吃透 search 和 getMediaSource → 到 test/ 目录跑一个同类脚本验证。
出问题先按这个顺序查
问：插件装不上。答：多半是 url 复制不完整或网络受限。重新完整复制plugins.json里的地址，换个网络环境再试；还不行就升级播放器版本。
问：搜索结果为空。答：关键词太长太特殊，或平台接口变了。改成"歌名+歌手"的短组合，并确认装的是仓库里的最新版。
问：播放到一半卡住。答：网络波动或音质档位拉太高。降一档重试，顺便检查代理设置是否影响音频流。
问：收藏夹导入报错。答：收藏夹没公开或链接格式不对。原站改成公开，再按插件 hints 提示的格式重新复制链接。
问：自建服务连不上。答：地址漏了协议前缀，或账号密码填错。补上 http:// 或 https://，重新编辑用户变量并保存。
记住一条原则：一次只改一个变量，改完等结果再动下一个。
用之前先知道两件事
这套插件本质是教学示例，数据来自网络公开接口，仓库已过滤全部 VIP、收费和试听内容，作者收到告知函后也移除了部分平台来源。请仅用于学习和个人合理使用，不商用，也别绕付费墙。
装两个插件 + 搜一首歌 + 导一个歌单，十分钟以内就能看到效果。
【免费下载链接】MusicFreePluginsMusicFree播放插件项目地址: https://gitcode.com/gh_mirrors/mu/MusicFreePlugins
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
