灰色歌曲解析失败怎么办？排查与解决手册
排查流程
灰色歌曲在 AlgerMusicPlayer 里仍然不能播放时，按以下步骤逐步排查，从上往下优先级依次降低。
第一步：是不是真的在 AlgerMusicPlayer 里播的
很多用户在网易云官方客户端点了灰色歌曲，然后跑来 Alger 找。确认：你是在 AlgerMusicPlayer 的界面里点的播放。官方客户端的灰色和 Alger 无关。
第二步：等够时间
UNM 会依次尝试多个音源，每个有超时。灰色歌曲点播放后，给它 10~15 秒。如果 15 秒后还是没反应，说明所有音源都失败了或匹配没找到。
第三步：手动去浏览器查各音源
打开浏览器，分别去 QQ 音乐、酷我、酷狗网页版搜这首歌的 歌名 + 艺人：
| 情况 | 结论 |
|---|---|
| 所有平台都搜不到 | 这首确实是跨平台独占 → Alger 也解不了，换曲目 |
| QQ 音乐能搜到但 Alger 不行 | 你的网络可能屏蔽了 QQ 音乐搜索接口，或 UNM 匹配逻辑问题 |
| 只有 1~2 个平台能搜到 | 调整 Alger 的音源优先级（把能搜到的平台调到前面） |
| 搜到但内容不对（重名） | 匹配错误，手动搜正确版本播放 |
第四步：检查网络代理
如果你在用代理 / VPN，试试关掉或切换节点。原因：
- 某些代理节点屏蔽了音乐平台
- 海外节点访问国内音乐平台可能不稳定
- 代理会改变请求 UA，触发平台风控
反过来：如果你没开代理但想访问海外音源（如 JOOX），可能需要开代理。
第五步：清理缓存重试
设置 → 缓存 里清理音乐缓存和歌词缓存后重启 AlgerMusicPlayer。有时候旧的解析结果会被缓存导致重复失败。
相关页面：缓存与目录配置
第六步：版本太旧
早期版本的 UNM 模块可能有已知 bug。确认你运行的是最新稳定版。设置 → 关于 页面检查更新。
常见错误与原因速查
| 现象 | 最可能原因 | 解决方案 |
|---|---|---|
| 点播放立即无反应 | 所有音源匹配失败 | 手动换音源优先级 / 换曲目 |
| 等 10 秒后报"无法加载" | 音源平台在你网络不可达 | 换网络 / 开代理 / 切换音源 |
| 播放了但不是这首 | 重名匹配出错 | 手动搜正确版本 |
| 歌词和歌曲对不上 | 换了音源但歌词还是网易云的 | 这是已知限制，手动切换歌词 |
接受一个事实
即使完美满足所有条件，跨平台独占曲目（比如只在 QQ 有、其他平台全下架） 仍然解不了。这不是 Alger 的问题，是物理上音源不存在。这种情况只能接受，或换用该曲目独占的平台客户端。