Mineradio - LX Music / MR

基于 Electron 的沉浸式桌面音乐播放器二次开发与长期维护项目。

围绕音乐播放、歌词、可视化、局域网控制、资源稳定性与 AI Agent 等方向持续迭代。

Windows 下载 · GitHub Release · 抖音项目演示

项目预览

主界面

!Mineradio 最新主界面

沉浸式首页展示：每日推荐、最近播放、平台排行榜、歌单广场、音乐电台、局域网遥控与实时频谱等功能。

AI Agent「小M」

!AI Agent 小M

小M 不只是聊天窗口，可将自然语言指令转换为播放器实际操作，例如搜索并播放歌曲、调整音量、切换音质、操作歌单等。

歌词与可视化

!Mineradio 歌词与可视化

粒子可视化、双语歌词与实时频谱组合展示，体现桌面音乐播放器的沉浸式视觉能力。

截图来自当前版本实际运行界面，项目仍在持续迭代。

项目亮点

• 完整桌面应用体验：本地音乐、在线搜索、歌单、排行榜、电台、歌词、播放队列、托盘与媒体控制。
• AI Agent「小M」：支持通过自然语言控制播放、队列、歌单、音量、音质、歌词动画、界面与视觉效果。
• 多种歌词与可视化能力：翻译歌词、桌面歌词、实时频谱、粒子可视化、3D 歌词舞台、自定义壁纸与视频背景。
• 局域网多设备遥控：支持手机扫码后在同一网络内控制桌面播放器。
• 播放稳定性优化：围绕资源解析、缓存、下一曲预取、超时、失败重试与回退机制持续优化。
• 长列表与界面性能优化：针对大量歌曲、歌单与复杂界面进行分批渲染及交互优化。
• 完整发布流程：使用 Electron / electron-builder 构建 Windows 安装包，并通过 GitHub Release 发布版本。
• 真实用户反馈驱动迭代：通过抖音项目演示持续展示项目功能和版本更新，相关账号累计 9000+ 粉丝，根据实际反馈持续改进功能。

技术栈

Electron / JavaScript / HTML / CSS / Node.js / Git / GitHub

同时使用 FFmpeg、RePKG 等工具完成部分音视频与 Wallpaper Engine 相关能力。

我负责的内容

本项目基于原始开源项目 XxHuberrr/Mineradio 进行二次开发和长期维护，并非从零原创全部代码。

主要工作包括：

• 阅读并理解现有 Electron 项目结构与业务代码；
• 根据实际需求进行功能设计、功能实现与交互迭代；
• 排查播放、资源加载、歌词、界面状态与兼容性问题；
• 针对播放稳定性和界面性能进行优化；
• 集成并维护 AI Agent「小M」及播放器工具调用能力；
• 完成测试验证、Git/GitHub 版本管理、安装包构建与 Release 发布；
• 通过用户反馈持续发现问题并迭代功能。

工程问题与解决

1. 播放稳定性

在线资源存在解析耗时、链接失效、网络波动等情况。项目围绕这些问题持续加入：

• 解析结果缓存；
• 下一曲预取；
• 超时处理；
• 播放失败自动重试与切换；
• 封面及资源地址规范化；
• 异常情况下的占位与回退逻辑。

2. 长列表与界面性能

随着本地音乐、歌单和功能模块增加，长列表及复杂 UI 会带来明显的渲染压力。

针对这类问题，项目对部分长列表采用分批渲染，并持续调整页面结构、交互逻辑和高频更新区域，降低不必要的界面刷新与卡顿。

3. AI Agent 工具调用

AI Agent「小M」不仅用于文本聊天，而是将播放器已有能力封装为可调用工具，让模型可以把自然语言指令转换为实际的软件操作。

例如：

• “播放周杰伦的歌”
• “音量调到 40%”
• “切换无损音质”
• “打开音乐库”
• “把当前歌曲收藏到我喜欢”
• “创建一个通勤歌单”

最新版本：1.7.0

下载 Windows 安装包 / 查看 v1.7.0 Release

支持 Windows 10/11 x64。使用标准安装向导，可选择安装目录和是否创建桌面快捷方式；覆盖升级前请先关闭正在运行的 Mineradio，选择原安装目录即可。升级保留 %APPDATA%\Mineradio 中的歌单、设置和用户数据。安装包不内置音乐音源。

1.7.0 主要更新

• 接入 Folia 的 14 种歌词动画及多种背景效果，提供配色、背景和各模式参数设置。
• 修复商籁、绘光的 Pixi 渲染加载问题。
• 调整新效果的显示层级，让当前队列、右侧唱片架、主页和音源入口可见。
• 返回主页时保留当前选中的歌词背景效果。
• 修复“当前配色”把旧字体栈误传给歌词引擎造成的文字排版和裁切异常。

主要功能

• AI Agent 小M：自然语言控制播放器、队列、歌单、音质、歌词动画、界面和视觉效果，支持文字及可用环境下的语音输入。
• 本地音乐：导入本地文件和文件夹，管理音乐库、播放队列、自定义歌单和文件夹歌单。
• 音乐首页：继续播放、每日推荐、最近播放、聆听统计、接下来播放、歌单广场、平台排行榜、音乐电台和局域网多设备遥控。
• 歌手与专辑：在线匹配歌手，浏览专辑及曲目，整张播放或收藏。
• 音乐电台：29 种私人漫游、场景、风格和能量模式，可收藏并置顶常用电台。
• 平台榜单与歌单导入导出：五平台歌单广场、公开歌单搜索、真实平台榜单、LX 歌单文件和多平台分享链接导入，并可导出 LX Music 兼容的 .lxmc 歌单。
• 音源管理：音源状态与管理入口位于页面右上角，可导入本地 LX 兼容音源脚本、链接导入、批量文件导入和音源切换。
• 歌词：本地及在线歌词、翻译歌词、歌词偏移、多种窗口内动画，以及可调左右/高度/大小/透明度的桌面歌词。
• 音效：均衡器、自定义声场、空间音频、人声/伴奏分离、智能母带、智能 DJ、前级增益和输出设备选择。
• 可视化：底部实时频谱及高度调节、粒子可视化、3D 歌词舞台、自定义壁纸、视频背景和 Wallpaper Engine 壁纸读取。
• 桌面体验：托盘和媒体控制、沉浸模式、桌面融合播放、可拖动歌单栏、迷你队列、可收起的右上角主页入口，以及可选主页透明交互。
• 录制与预览：60 FPS H.264 场景录制、GIF 预览和 Wallpaper Engine 资源转换。
• 更新：从 GitHub Release 检查后续版本并下载更新。

AI Agent 小M

点击小M悬浮球即可打开对话面板，也可以使用 Alt+A；在高级设置中可以隐藏悬浮球，全局热键 Ctrl+Alt+A 仍可唤起。

可使用类似下面的自然语言命令：

• “播放海阔天空”“暂停”“下一首”“音量调到 40%”“跳到 1 分 30 秒”
• “切换无损音质”“打开音乐库”“打开音乐电台”“打开排行榜”“打开音源管理”
• “歌词动画切换成玻璃”“把当前歌曲收藏到我喜欢”“创建一个通勤歌单”
• “隐藏小M”“打开小M”“世界和平”

运行与打包

开发运行

npm install
npm start

Windows 打包

构建 1.7.0 发布版时，请先切换至 v1.7.0 标签，再按其中的 lyric-viz-bridge/README.md 构建并同步歌词引擎输出。

npm run build:win

build:win 会下载并校验固定版本的 FFmpeg 与 RePKG，运行发布校验，然后生成：

• dist/Mineradio.Setup.1.7.0.exe
• dist/Mineradio.Setup.1.7.0.exe.blockmap
• dist/latest.yml
• dist/Mineradio.Setup.1.7.0.SHA256.txt

安装包包含的内容

正式 Windows 安装包包含运行完整功能所需的：

• Electron 主程序、页面、桌面歌词和全部前端资源
• AI Agent 小M前后端、工具调用、热键、语音辅助脚本和设置界面
• 音效、歌手专辑、实时频谱、局域网遥控代码与二维码运行时依赖
• FFmpeg 8.1.1、RePKG v0.4.0-alpha 及第三方许可说明
• 安全覆盖升级、路径校验和卸载保护逻辑

作者支持

如果这个二创版本给你带来了更好的体验，欢迎自愿支持后续维护与稳定性改进。

查看完整支持页

我的抖音

!Mineradio 作者支持渠道

支持完全自愿，不提供功能解锁、专属资源、优先服务等权益，也不构成付费服务合同。

原项目、授权与使用声明

• 本项目基于 XxHuberrr/Mineradio 修改维护，是非官方二创版本。
• Mineradio 原有代码沿用 GPL-3.0-only；1.7.0 发布版中的 Folia 歌词渲染代码遵循 AGPL-3.0，其要求适用于包含该代码的组合版本。对应源码见 v1.7.0 标签。
• 本项目不代表原作者、网易云音乐、QQ 音乐、腾讯音乐娱乐集团或其他第三方平台的官方版本。
• 用户应确保对自行导入的本地文件、音源脚本和第三方链接拥有合法使用权限，并遵守相关平台条款。
• 禁止将本项目用于盗版音乐、违规抓取、绕过平台限制、传播侵权内容或其他违法违规用途。

License

本项目采用 GNU General Public License v3.0（GPL-3.0-only）发布。

1.7.0 发布版还包含 Folia 的 AGPL-3.0 代码，原作者许可和来源说明见对应源码中的 Folia 许可证 和 第三方移植说明。