为什么插件安装失败——URL 格式与网络问题排查
正确的 URL 格式
从网络安装插件时，输入框里填的 URL 必须以 .json 或 .js 结尾。
- .json：插件仓库的描述文件（包含多个插件元信息和下载地址）——比如官方示例仓库的 plugins.json。
- .js：单个插件文件的源码。
错误的格式包括但不限于：
- 随便一段 JSON 文本（没有托管在 HTTP 地址上）
- HTML 页面链接（比如一个介绍插件的博客页面）
- 裸域名（比如只写 musicfree.catcat.work 不加具体文件路径）
官方示例仓库地址
以下任一可用（GitHub 打不开换 GitCode）：
| 来源 | 地址 |
|---|---|
| GitCode | raw.gitcode.com/maotoumao/MusicFreePlugins/raw/master/plugins.json |
| GitHub | raw.githubusercontent.com/maotoumao/MusicFreePlugins/master/plugins.json |
如果 URL 格式确认正确但还是失败
可能原因：
- 网络不通：插件文件托管在境外服务器，国内访问可能需要科学上网或切换到 GitCode 镜像。稍后重试通常能解决。
- URL 已失效：插件作者可能删除或更新了插件，旧 URL 不再返回正确内容。
- 插件签名/校验失败：部分版本可能加入了插件安全校验机制，非官方签名的插件会被拒绝。
走本地安装的备选方案
网络安装不通时，可以手动下载插件文件：
- 用浏览器在电脑上打开插件仓库页面。
- 找到需要的插件 .js 文件或 plugins.json。
- 手动下载到手机（传到手机存储或通过 USB）。
- 在 MusicFree 里选择「从本地安装插件」，找到下载好的文件。
总结
插件安装失败 90% 是 URL 格式不对（不是 .json/.js 结尾）或网络不通（GitHub Raw 被墙）。先检查这两点再考虑其他可能性。