Releases: Akilaea/Aerome
Aerome v1.3.0 — 基于 Mineradio 的 GPL-3.0 派生作品
酷狗登录模式接入
酷狗免登录 m.kugou.com playInfo 端点在 v1.2.2 实测整体失效（连免费歌都拿不到播放地址），酷狗音源实际不可用。本版本改为登录模式：
- 弹出官方
www.kugou.com网页窗口扫码登录，抓取 cookie 后走官网 web 接口wwwapi.kugou.com/play/songinfo获取播放地址。 - 登录账号有权限的 VIP 歌曲也能播；登录态持久化到
.kugou-login。 - 酷狗成为第三平台账号：登录模态新增「酷狗」tab，用户菜单支持切换 / 补登 / 退出，接入三音源（网易云 ↔ QQ ↔ 酷狗）自动换源。
- 全程只走官网 web 接口 + 真实浏览器 cookie，不碰安卓接口、不做任何风控绕过；搜索与歌词仍免登录可用。
派生作品声明
本项目是基于 Mineradio（作者 XxHuberrr）的 GPL-3.0 派生作品，已按 GPL-3.0 协议保留原作者版权与许可声明（见 LICENSE / NOTICE.md）。
安装
下载 Aerome-1.3.0-Setup.exe 安装。数据目录落在安装根目录下的 data\，不依赖特定盘符。
SHA256
见 Aerome-1.3.0-SHA256SUMS.txt。
上游安全同步提示
从上游同步代码时若用 sed 批量替换品牌名，注意字符串长度常量差异（如 \Mineradio 10 字符 vs \Aerome 7 字符），v1.2.1 hotfix 即为修此类 sed 漏改 bug。
🤖 Generated with Claude Code
Aerome v1.2.2 — 基于 Mineradio 的 GPL-3.0 派生作品
派生作品声明
Aerome 是 Mineradio（作者 XxHuberrr）的 GPL-3.0 派生作品，遵循 GPL-3.0，保留原作者版权声明与 LICENSE，并在其基础上做了扩展。原作者保留对 Mineradio 名称、MR Logo、界面视觉设计与原创视觉表达的权利；Aerome 使用独立的项目名与图标，不与原项目混淆。
v1.2.2 修复
1. 修复安装后打不开
v1.2.0/v1.2.1 把数据目录硬编码在 E 盘（E:\Claude code\AeromeData），没有 E 盘或该父目录的机器，fs.mkdirSync 静默失败，Electron 写不进 userData → 启动崩溃。
现已改为落到安装根目录下的 data\（打包版取 resourcesPath 上一层），开发版回退 .aerome-data\，仍可用 AEROME_DATA_DIR 环境变量覆盖。所有运行时缓存（cookie、酷狗 dfid、Electron userData）不再依赖特定盘符。
2. 嵌套安装目录自动清理
v1.2.0 buggy 安装会把目录堆成 D:\Aerome\Aerome\Aerome\Aerome；在 v1.2.2 选 D:\Aerome 想扁平化时会被「非专属目录」校验拒绝。新增清理逻辑：安装前向下最多查找 5 层带标记的真实安装根，找到则弹窗确认清理 $INSTDIR\Aerome，确认后才继续安装。只走交互式路径，不影响静默安装。
升级建议
老版本用户直接覆盖安装 v1.2.2 即可。
SHA256
62c642d4dacdbbb39161d1157b890656d06c28cdcfdeb21f3d7a89f73bae03a7 Aerome-1.2.2-Setup.exe
150af640ce9e7d09aa712ab246e76f7f147d8b55f6fce9282f15958a94af50a1 Aerome-1.2.2-Setup.exe.blockmap
27a680a40befb6e8ae1d787bfb7c38868abd16b8c2b6d9d7034c17f1966986b9 latest.yml
来自上游的安全提示
上游 v1.0.10 及更早旧安装包不再建议继续安装或传播。Aerome 直接基于 v1.1.0 源码派生，请只使用本仓库的 GitHub Release 资产。
本安装包未代码签名，Windows SmartScreen 首次运行会提示「不识别的应用」，属开源项目正常现象，点「仍要运行」即可。
Aerome v1.2.1（hotfix）— 修复安装目录重复叠加
概述
v1.2.0 hotfix — 修复安装目录重复叠加 bug。
Bug 描述
v1.1.1 同步上游 Mineradio installer.nsh 时，sed 批量替换 Mineradio → Aerome 漏改了字符串长度常量：
| 项 | 上游 \Mineradio |
Aerome \Aerome |
|---|---|---|
| 长度 | 10 字符 | 7 字符 |
| 代码里写的长度判断 | 10 | 10 ❌（应该是 7） |
导致 D:\Aerome（长度 9 < 10）每次 normalize 都被追加一层 \Aerome，最终安装路径变成 D:\Aerome\Aerome\Aerome\Aerome。
修复
build/installer.nsh 三处长度判断改为 7（\Aerome 实际长度）：
AeromeNormalizeInstallDirAeromeValidateInstallDirun.AeromeNormalizeInstallDir
升级建议
- v1.2.0 / v1.1.1 用户：直接覆盖安装 v1.2.1。会装到正确的
D:\Aerome；旧嵌套目录D:\Aerome\Aerome\Aerome\Aerome会被新卸载器按文件清单清空，残留的空目录可手动删除。 - 新装用户：直接装 v1.2.1，无嵌套问题。
其它
酷狗音源 + 三方 fallback + 缓存统一到 E 盘 等功能性改动继承自 v1.2.0，本次仅为安装器 hotfix。
SHA256 校验
9c1185b26f43965247c58c469ccfa4e12798b103ac7e0f537402cac22788286e Aerome-1.2.1-Setup.exe
315e68ce2c02b5a6200c207e1e2600b2688128413abbc0cefce62aa94fc77ae9 Aerome-1.2.1-Setup.exe.blockmap
3d67a0db55c72c0815de68f9c5ea05ebdc58780b5792a01f077e0a04baeb67a8 latest.yml
Aerome v1.2.0 — 酷狗音源 + 三方跨音源 fallback
概述
新增 酷狗音乐音源 + 三方跨音源 fallback（参考 ncm 解锁思路），同时把所有运行时缓存统一迁出 C 盘。
酷狗音源接入
- 新增
/api/kugou/search：免登录搜索，走msearch.kugou.com/api/v3/search/song+ 自实现 MD5 签名，返回标准化 SongInfo 列表。 - 新增
/api/kugou/song/url：免登录拿播放 URL，走m.kugou.com/app/i/getSongInfo.php。免费歌曲返回 128K 试听 URL，VIP 歌曲返回payRequired=true。 - 新增
/api/kugou/lyric：免登录拿 LRC 歌词，走krcs.kugou.com/search+lyrics.kugou.com/download两步式接口。 - 设备标识
dfid+mid启动时生成 + 持久化，避免反爬。 audioProxyHeadersFor增加kugou.com分支。
三方跨音源 fallback（VIP 解锁思路）
- 改造
alternatePlaybackProviders返回['qq', 'kugou', 'netease']数组（剔除当前源）。 searchAlternatePlatformSong依次尝试每个备选音源，第一个同名同歌手匹配返回。- 实际场景：网易云 VIP → 自动找 QQ 版本；QQ VIP → 自动找酷狗版本；酷狗 VIP → 自动找 QQ 版本。
- 覆盖范围比 v1.1.x 双源 fallback 显著扩大。
UI 端
- 搜索 tab 增加「酷狗」选项；酷狗品牌蓝
#009AF3。 - 全平台「All」搜索现在并行搜网易云 + QQ + 酷狗，结果按相关性合并。
- VIP/受限歌曲自动触发 fallback，UI 友好提示「已自动切换音源」。
缓存目录统一（v1.1.x 遗留改进）
- 所有运行时缓存重定向到
E:\Claude code\AeromeData\，不再写入 C 盘%APPDATA%\Aerome\：.cookie+.qq-cookie+.bili-buvid+.kugou-dfidbeatmaps/+updates/+userData/（Electron 内部 Cache/GPUCache/IndexedDB）
- 可通过
AEROME_DATA_DIR环境变量覆盖。 - 老版本用户升级后旧 C 盘 cookie/缓存不会自动迁移，如需保留登录态可手动拷贝。
升级说明
- 直接覆盖安装即可；v1.1.x 已有的独立
Aerome文件夹会被识别为可接管目录。 - 首次启动时
E:\Claude code\AeromeData\会自动创建。
第三方平台声明
酷狗音乐是广州酷狗计算机科技有限公司的商标，本项目非官方、非附属。酷狗接入仅使用公开免登录接口（搜索 + 免费歌曲 128K 试听 + LRC 歌词），VIP 歌曲仅标记为不可播放并尝试自动跨音源匹配其它平台的免费版本。
本项目是 Mineradio（作者 XxHuberrr，GPL-3.0）的派生作品，遵循 GPL-3.0 许可证保留原作者署名。
SHA256 校验
6a9d40ed1144458823b4e335bd1e782bf68d8d5c613bab1b48c0d05e2df7a6fc Aerome-1.2.0-Setup.exe
2707cfc98ad17ea4e9173eb840dad55992b1c84d2c4e201c0789258e084e3547 Aerome-1.2.0-Setup.exe.blockmap
6ea2300d8c98a2aef8b2374d20a4352a7dbaff843ac699d281844c768ad26264 latest.yml
Aerome v1.1.1 — 安装器安全同步上游
概述
同步上游 Mineradio v1.1.1 的 P0 安装器安全修复，完成 Aerome 品牌化适配。
安装器安全修复（来自上游 v1.1.1）
- 新增专属标记文件：安装时在安装根目录写入
.aerome-install-root标记（含appId=com.aerome.desktop）。卸载时只清理该标记文件确认归属的目录，避免误删用户其它文件。 - 卸载不再递归删除安装根目录：新卸载器改为枚举 Aerome 已知文件名（
Aerome.exe、Electron 运行时 DLL/pak/dat、locales/、resources/、swiftshader/等空目录），不再使用RMDir /R $INSTDIR。 - 卸载前双重校验：强制要求卸载路径必须以
\Aerome结尾且存在标记文件；任一项不满足直接退出，不删任何文件。 - 禁止在混合目录就地安装：例如
D:\百度盘\翻身(1)这类含其它文件的目录不再被接管为安装目录。 - 禁用遗留不安全卸载器：扫描注册表中记录的旧 InstallLocation，如果该路径缺少标记文件且不可接管，删除遗留的
Uninstall Aerome.exe单文件并清理残留注册表项。 - 首次安装目录选择改进：自动从 D-Z 盘中选首个可用盘作为默认安装位置；只有电脑确实只有 C 盘时才放行
C:\Aerome。 - C 盘保护：检测到 D-Z 任意盘存在时，禁止安装到 C 盘。
- 保留覆盖能力：v1.1.0 已经创建过的独立
Aerome文件夹即使没有标记文件，也可以被 v1.1.1 安全覆盖安装。
升级说明
- 这是 P0 安全更新，必须运行完整的 Setup.exe 才能替换旧版 Windows 卸载器和注册表项；不提供软件内快速补丁。
- 已经安装 v1.1.0 的用户：直接覆盖安装即可。
- 已经从更早版本升级过的用户：如果当前安装路径是独立的
D:\Aerome之类的纯净目录，直接覆盖安装；如果是混合目录，安装器只移除遗留的Uninstall Aerome.exe单文件，并把新版本安装到一个安全的Aerome子目录，不会触碰目录里的其它文件。
关于上游 SUPPORT 海报
上游 v1.1.1 同时附带了作者个人的支持海报（赞助渠道），Aerome 派生版本不携带此文件，仅同步与安全相关的代码改动。
上游版权声明
本项目是 Mineradio（作者 XxHuberrr，GPL-3.0）的派生作品。安装器安全修复代码源自上游 v1.1.1，遵循 GPL-3.0 许可证保留原作者署名。
SHA256 校验
77b73a2ee34b4d487b2d9849f19dde99e5c6424f3044bacbdd784069b57205dd Aerome-1.1.1-Setup.exe
5612d1c2dbbfb10c52b8ebc553565ec300c62bcbbc2c4d0a763ac3e22fbda673 Aerome-1.1.1-Setup.exe.blockmap
cdb7f4ce531fd4524768c3c03fb9b2bac3d220a4f8ba16c4075ac530335a068c latest.yml
Aerome v1.1.0
关于 Aerome
Aerome 是 [Mineradio]二创作品
由 Akilaea 维护。
- 原作品版权
Copyright (C) 2026 XxHuberrr - 派生作品版权
Copyright (C) 2026 Akilaea - 协议：GPL-3.0（详见
LICENSE与NOTICE.md）
Aerome 使用独立项目名、独立 appId (com.aerome.desktop)、独立图标，不与原 Mineradio 项目混淆。
下载
| 文件 | 用途 |
|---|---|
Aerome-1.1.0-Setup.exe |
Windows NSIS 安装包（110 MB） |
Aerome-1.1.0-Setup.exe.blockmap |
差异更新用 |
Aerome-1.1.0-SHA256SUMS.txt |
所有资产的 SHA256 校验 |
安装包 SHA256：
6e349ab8a399befeac0f3ec0d2eebceb08fba9ac6f615db56aefb5b9269882b9 Aerome-1.1.0-Setup.exe
sha256sum -c Aerome-1.1.0-SHA256SUMS.txt。
相对上游 Mineradio v1.1.0 的改动
新功能
- B 站音源接入（免登录）：搜索 tab 新增「B站」平台选项，能搜视频、取最高码率音频流（DASH 192K mp4a）、播放。
/api/bili/search/api/bili/detail/api/bili/audio/api/bili/subtitle四个端点。字幕接口已就绪但多数音乐视频无字幕，目前按 best-effort 处理。
安全基线收紧
- 本地 HTTP 服务默认监听
127.0.0.1（不再绑0.0.0.0），需要局域网访问可设HOST=0.0.0.0 - CORS 收紧到只允许
localhost/127.0.0.1来源，拒绝恶意网页跨域调用本机 API - 静态资源服务增加显式 root 边界校验（路径穿越防御纵深）
性能优化
localBeatMapCache纳入trimRuntimeCaches（防无界增长）- 播放进度 200ms 定时器在 paused / 隐藏时跳过歌词高亮更新
musicTempoWorkerUrl在beforeunload时revokeObjectURLinitUpdatePreview改为 splash dismiss 后触发（替代固定 9 秒延迟）/api/audio/api/cover在客户端断开时AbortController.abort()取消上游下载
品牌重命名
Mineradio→Aerome（appId、executableName、IPC channel、Electron 分区、窗口标题、安装器 NSIS、PowerShell class、splash wordmark、所有 UI 可见字符串）- 兼容性：旧
MINERADIO_*环境变量已移除（clean break）
视觉资产
- 全新 AM 图标（黑底白字 squircle logo）
- 全新安装向导贴图（sidebar / header）
继承自上游 v1.1.0 的核心特性
- Open-Meteo 天气电台
- 网易云音乐 / QQ 音乐双源搜索与播放
- 3D 歌单架、歌词舞台、粒子视觉、电影镜头系统
- DIY 视觉控制台、用户存档
- GitHub Releases 自动更新检测
上游安全提示
继承自上游：上游 v1.0.10 及更早旧安装包不再建议继续安装或传播。Aerome 直接基于 v1.1.0 源码派生重打包，请只使用本仓库 GitHub Release 的资产。
反馈
发现问题请到 Issues。提交时请勿附带 Cookie、Token、账号信息等敏感数据。