unblockneteasemusic 原理：多音源替换如何解锁灰色歌曲

核心思路

unblockneteasemusic（以下简称 UNM）模块的核心是：网易云返回灰色 → 去其他平台找同曲 → 替换音源。

这不是"反封"或"解锁 API"——技术上没有破解网易云接口。只是当网易云告诉你"这首我不能播"时，UNM 说"好的，我去别家买这首"。

执行流程

用户点击灰色歌曲播放
       ↓
网易云接口返回 blocked / 不可播状态
       ↓
UNM 模块介入，获取歌曲的 metadata（歌名、歌手、专辑）
       ↓
按优先级依次查询其他平台：
  ┌──────────┬──────────┬──────────┬──────────┐
  │ QQ 音乐  │ 酷我     │ 酷狗     │ 百度     │
  ├──────────┼──────────┼──────────┼──────────┤
  │ 虾米     │ 咕咪     │ JOOX     │          │
  └──────────┴──────────┴──────────┴──────────┘
       ↓
找到匹配的曲目 → 用该平台播放地址替换网易云音源
       ↓
播放器正常播放（用户无感音源已换）

匹配准确度

同名同艺人的曲目并不总是对得上——重名歌曲、翻唱、现场版、EP/专辑同曲等都会造成匹配困难。UNM 的匹配逻辑：

1. 优先按 歌名 + 艺人 精确匹配
2. 专辑信息做辅助验证
3. 找不到精确匹配时尝试模糊搜索（歌名关键词）
4. 取搜索结果第一条或相似度最高的

已知问题：

• 纯重名歌曲可能匹配错版本（比如两个不同歌手都有《夜空中最亮的星》）
• 现场版可能匹配到 studio 版
• 小语种歌曲匹配率较低

音源优先级

UNM 默认的音源优先级：QQ > 酷我 > 酷狗 > 百度 > 虾米 > 咕咪 > JOOX。

这个顺序可以在 AlgerMusicPlayer 设置里调整（v5.1.0 支持自定义）。调整依据：

• 某个音源在你的网络环境下质量差（经常卡顿）
• 某个音源匹配准确率低
• 个人偏好

为什么能做到"本地"

UNM 模块运行在 AlgerMusicPlayer 的本地 Electron 进程里。它访问的是各音乐平台的公开搜索接口和播放地址，不依赖任何第三方中转服务的稳定性。只要网络通、目标平台可访问，解析就能工作。

技术边界（重要）

UNM 不是万能的，以下情况必然失败：

• 跨平台独占曲目：某首歌只在 QQ 音乐有，其他平台完全没有 → 所有音源都找不到 → 无法播放
• 小语种 / 地下音乐：平台音源库覆盖不到
• 重名混淆：匹配到的是完全不同的歌（这时会"成功播放但内容不对"）
• 网络环境限制：公司 / 校园网络屏蔽了部分音源平台

遇到解析失败时，参考：灰色歌曲解析失败怎么办