企业官网建设流程全解析

3分钟装好MusicFreePlugins：一个搜索框免费查遍全网音乐源

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

一首歌，A软件搜不到，B软件要开会员，C软件干脆下架了。翻遍手机里的五个App，最后连个响儿都没听到——这种翻车现场，你大概率经历过。

MusicFreePlugins就是为这事准备的开源插件仓库：它给 MusicFree 播放器提供一套可安装的音乐插件，让你在同一个搜索框里同时查多个平台的曲库，并且默认过滤掉收费和试听内容。这篇文章按"先装 → 再玩 → 最后排雷"的顺序走，看完就能跑通第一个功能。

动手前确认三件事：MusicFreePlugins 安装前置条件

别急着装，缺哪样补哪样：

1. 装好 MusicFree 播放器。插件是寄生在播放器里的，App 本身要先就位，且建议是较新版本。版本太旧会出现协议不兼容，装上去也跑不动。
2. 网络能访问插件托管地址。插件通过远程地址下载，校园网、公司代理这类受限网络会直接导致安装失败。受限就换个普通网络再试。
3. 拿到插件清单。仓库根目录的 plugins.json 是所有插件的"菜单"，每个条目有name、url、version三个字段，后面装哪个都从这里查。找不到它，就只能到处问人要链接了。
4. Node.js 环境（可选）。只有想自己构建或测试插件时才需要，纯安装使用可以直接跳过，别被吓退。

最小闭环：3分钟让第一首歌响起来

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

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

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

做完这步，你本地应该多了一个 MusicFreePlugins 文件夹。 2. 打开 plugins.json，找到bilibili条目，完整复制它的url值（这是安装入口，少一个字符都装不上）。 3. 在 MusicFree 的插件管理里选从URL安装，把地址粘贴进去；如果你本地跑过npm run build，也可以用"从本地安装"，直接选dist/目录下对应的index.js。 4.验证闭环：在搜索框输入一首你熟悉且有代表性的歌名。结果列表里出现带 bilibili 平台标识的条目、点开能播放、歌词栏能自动带出文字——就说明装好了。

顺利的话，3分钟以内。之后再逐步添插件，每一步都立刻验证，出问题定位也快。

能力地图：找内容、管歌单、接私有源、补信息

跑通基础搜索后，这些能力按使用场景拆开看：

找内容。播放器统一用 low / standard / high / super 四档音质（定义在 类型定义文件 里），插件按档位返回不同码率的音频地址。移动数据用标准档，家里 WiFi 切高档，省流量和听感两头兼顾。bilibili 插件还内置了榜单接口，分类不少，适合没有明确目标、就想随便刷刷的时候。

管歌单。bilibili 插件支持把公开收藏夹整单搬进播放器：移动端和桌面端各有一套链接获取方式，详细步骤就写在 plugins/bilibili/index.ts 导出对象的hints字段里，照着做就行。记住这个限制：非公开收藏夹导不进来，得先在原站改成公开。

接私有源。这是隐藏大招：Navidrome 和 WebDAV 插件都用了userVariables机制——说白了就是装完会弹窗让你填服务器地址、用户名、密码，不用改一行代码，NAS 或网盘里自己存的音频就变成了可搜索、可播放的曲库，还不受任何平台规则影响。进阶姿势：WebDAV 插件还会多问一个"存放歌曲的路径"，把搜索范围锁定到单个目录，翻得更快。

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

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

三条使用路线：轻度尝鲜、日常主力还是深度定制

路线一：轻度尝鲜

• 装什么：bilibili + 歌词千寻，共 2 个。
• 先做什么：搜索试听一首熟悉的歌，音质固定标准档，把"聚合搜索"这个概念先用起来。
• 什么时候加东西：用满两周，发现某类内容（播客、纯音乐、AI 音乐）经常搜不到时，再回来挑插件。
• 判断标准：你只是想要一个"搜得到歌的框"，走这条就够了。

路线二：日常主力

• 装什么：bilibili + 歌词千寻 + 歌词网，共 3 个；有自建音乐服务的话，把 bilibili 换成 Navidrome 或 WebDAV。
• 先做什么：装完自建服务插件后，在弹窗里填服务器地址和账号，地址务必带http://或https://前缀，然后把本地曲库设为常用来源，在线平台只用来补本地没有的。
• 什么时候加东西：搜索时反复撞空（某类歌曲总是没有结果）时，再按需加对应平台插件。
• 判断标准：你有自建服务，或者不想每天在不同平台之间切，走这条。

路线三：深度定制（自己写插件）

• 装什么：先按路线一装好 2 个插件，留一个能用的底子。
• 先做什么：读 example/freesound.js 这个不到 60 行的完整示例，对照 types/plugin.d.ts 的接口定义，重点理解search和getMediaSource两个方法。
• 什么时候加东西：第一版插件只要让每条搜索结果带上id、title、artist、url四个字段，能搜能播就算毕业；之后再考虑歌词、榜单。
• 判断标准：你愿意打开 test 目录跑验证脚本、改一行代码看效果，这条就是你的路。

排雷：症状 → 原因 → 动作对照表

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

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

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

现在打开仓库，把开头那条 clone 命令复制进终端，装好 bilibili 和歌词千寻，去找一首你很久没听到的歌。

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