📌 阅读提示：本文含多张操作示意图位置标记，建议在实际发布前替换为真实截图。
在开始之前，先确认几件事：
| 项目 | 说明 |
|---|---|
| 设备 | Android 手机 / 鸿蒙（Harmony OS）设备 |
| 网络 | 能正常访问 GitHub / Gitee |
| 动手能力 | ⭐☆☆☆☆（会装 App 就行） |
| 预期 | 想要纯净听歌，愿意花 3 分钟配置 |
MusicFree 的核心逻辑：App 本身不自带任何音源，所有"能听什么"由你安装的插件决定。所以教程的重点就是——装插件。
.apk 文件（通常是 MusicFree-x.x.x.apk），点击下载访问 官方网站，首页即有下载入口。
安装完成后，打开 App，你会看到一个非常简洁的界面——因为没有插件，现在它还"什么也听不了"。别急，下一步就解决。
这是最关键的一步，跟着做就行：
📸 配图建议：此处插入「插件管理界面」+「粘贴地址后的确认弹窗」截图
回到 App 主界面，在顶部搜索框输入任意歌曲名（比如"晴天"），如果能看到搜索结果，说明插件安装成功 ✅
| 方式 | 操作路径 | 适用场景 |
|---|---|---|
| 从网络安装 | 插件管理 → 从网络安装 → 输入 .json 订阅地址 | 订阅多个插件（推荐） |
| 从本地安装 | 插件管理 → 从本地安装 → 选择 .js 或 .json 文件 | 自己下载了单个插件文件 |
| 手动导入 | 将插件文件放入手机存储 → 本地安装选择 | 插件作者分享的单文件 |
💡 去哪里找更多插件？
- 官方插件仓库：https://gitee.com/maotoumao/MusicFreePlugins
- GitHub 搜索 "MusicFree plugin"
- 社区论坛 / Telegram 群组（注意甄别安全性）
插件装好后，使用就非常简单了：
MusicFree 支持通过链接导入歌单（部分插件支持）：
这是 MusicFree 的一个隐藏神技：
场景：你听了一首 Live 版，但想看原版歌词；或者翻唱版没有歌词，想用原版的。
操作：
进阶：支持链式关联 A→B→C，三首歌统一显示 C 的歌词。
如果你有离线音乐文件：
| 操作 | 路径 |
|---|---|
| 禁用某个插件 | 插件管理 → 点击插件 → 关闭开关 |
| 更新插件 | 插件管理 → 从网络安装 → 重新输入同一地址覆盖 |
| 删除插件 | 插件管理 → 长按插件 → 删除 |
| 查看插件详情 | 插件管理 → 点击插件名称 |
MusicFree 本身只是一个播放器框架，不提供任何音源内容。插件获取的数据由插件作者决定，使用者需自行判断并遵守相关法律法规，建议及时删除数据、搭建自己的离线音乐仓库使用。
目前官方只发布了 Android / Harmony OS 版本，iOS 暂不支持。
| 资源 | 链接 |
|---|---|
| GitHub 仓库 | https://github.com/maotoumao/MusicFree |
| 官方网站 | https://musicfree.catcat.work |
| 官方插件仓库 | https://gitee.com/maotoumao/MusicFreePlugins |
MusicFree 的设计哲学很简单：软件是工具，选择权在你手里。
它不会替你决定"听什么""怎么听"，它只是给你一个干净、自由、可定制的框架。3 分钟配置好插件，你就能拥有一个完全属于自己、无广告、无追踪的音乐播放器。
开源不易，如果觉得好用，去 GitHub 点个 ⭐ 就是最大的支持。