Mineradio

先看清项目状态

这是个长期停更的个人项目，这一点必须先说清：README 明确写了「目前因个人原因，Mineradio 项目处于长期停更状态」，仓库保留源码、历史版本和下载说明，供个人玩家 Fork 或做二创。当前可用的历史稳定版是 2.2.0。把它当持续演进的产品去期待更新会落空，当成「一次装好、慢慢用」的播放器则没问题。

许可证是 GPL-3.0，作者已明确保留 Logo、名称与界面视觉设计的所有权。

视觉系统怎么配合

Mineradio 的卖点是视觉，但视觉不是一套东西而是几套按场景切换的系统：

• 完整桌面模式把播放器、主页、歌单和桌面交互放在一起，可以当"桌面播放器"用。
• 歌词舞台与粒子舞台同步工作，支持自定义歌词、歌词位置与视觉控制。
• 电影镜头视觉系统基于节奏驱动，面向长播客和 DJ 曲目另有专属模式。
• 3D 歌单架通过右键唤起，用于浏览歌单队列。
• 支持本地 MP4 与 Wallpaper Engine 视觉内容，也可以自己上传并裁剪专辑封面。

首次启动内置一个「默认测试」视觉用户存档，软件内的默认视觉参数与该存档一致——调乱了大可以从这里恢复。

安装被拦是正常现象

安装包未签名，被浏览器、Windows Defender 或 SmartScreen 拦下属于预期内：

1. 浏览器下载栏提示风险时，打开下载列表，点这条下载右侧的 ... 三个点，选「保留」/「仍要保留」/「显示更多」后继续保留。
2. SmartScreen 弹出蓝色窗口时，点「更多信息」，再点「仍要运行」。
3. 如果杀毒软件明确报木马、高危或已经隔离，不要强行运行。删掉文件重新从官方公告的网盘入口下载，仍异常就带截图反馈给作者。

注意认准文件名：正式安装包是 Mineradio-2.2.0-Setup.exe。不要把 .blockmap、latest.yml 或 win-unpacked 目录当成正式安装包——这三个是构建中间产物，不是给用户装的。

更新机制的真相

软件内的更新入口只会用系统浏览器打开下载页，不会在客户端内下载、安装或应用任何补丁。即使 GitHub Release 上挂着完整安装包，2.0.3+ 客户端也不会去读取那个附件。更新是手动动作。

要本地验证这条链路，可以把环境变量 MINERADIO_UPDATE_MANIFEST 指向一个本地 manifest JSON 或 HTTP 地址，模拟线上 Release。

自己跑源码的话是三条命令：

bashnpm install
npm start
npm run build:win

桌面版入口由 Electron 主进程加载本地服务，npm run build:win 生成 Windows NSIS 安装包，产物在 dist/。

登录与隐私

网易云音乐、QQ 音乐的账号、搜索、歌单体验都是第三方平台接入，不是官方客户端。这意味着：接口变动就会失效，可用性不由项目方掌握。项目方也明确说明不提供绕过付费、绕过会员、破解音质或重新分发音乐内容的能力。

数据方面，登录 Cookie、搜索历史、自定义封面、自定义歌词、节奏分析缓存都只应保存在本机用户数据目录或浏览器本地存储中，不要提交到仓库。