【免费下载链接】kumone
雲の音 — Native macOS NetEase Cloud Music client built with SwiftUI
如果你在使用网易云音乐客户端时，总是遇到无法播放的灰色歌曲——页面灰掉、点击没反应，或只能听到几秒试听？Kumone 这款 macOS/iOS 原生客户端内置了灰歌解锁功能：开启"灰色歌曲解锁"开关后，无版权或已下架的歌曲会自动从 pyncmd、酷狗、酷我等第三方音源中匹配出正确的歌曲并直接播放。本文将带你从零开始完成设置，并讲清楚它背后的匹配原理。
一、先搞懂：什么是"灰色"歌曲？
在网易云音乐里，歌曲的可播放状态由接口返回的权限字段决定。Kumone 将一首歌归纳为五种状态：
| 状态 | 含义 | 能否解锁 |
|---|---|---|
playable | 正常可播 | ✅ 不需要 |
vipOnly | VIP 专属（黑胶会员） | ❌ 需开通会员 |
paidAlbum | 付费专辑 | ❌ 需购买 |
noCopyright | 无版权（灰色） | ✅ 可解锁 |
delisted | 已下架 | ✅ 可解锁 |
判断逻辑在 Track.swift 中：Kumone 会读取每首歌的fee、pl、st等字段，灰色歌曲通常对应noCopyright（无版权）或delisted（下架）两种状态。
💡 小提示：VIP 歌曲即使开启灰歌解锁，官方渠道也只能播放试听片段，Kumone 会弹出"VIP 歌曲，当前为试听片段"的提示；而真正"灰色"的无版权歌曲才是解锁功能的主场。
二、一键开启：30 秒配置灰歌解锁
灰歌解锁的设置入口非常简单，只需两步：
第 1 步：打开总开关
进入设置 → 播放，打开**"灰色歌曲解锁"**开关。界面提示会写明："无版权或下架歌曲将从已启用音源中匹配播放"（见 SettingsView.swift）。
第 2 步：勾选备用音源
开启后，设置页会多出一个**"音源"**区块，可以逐个开关三个内置音源：
- pyncmd：直连解析源，优先使用，直接按网易歌曲 ID 解析播放地址
- 酷狗音乐：搜索匹配源
- 酷我音乐：搜索匹配源，作为最后备选
这个"逐音源开关"能力对应 SettingsManager.swift 中的enableUnblock与enabledAudioSourceIDs两个设置项。只有总开关打开且至少勾选一个音源时，解锁才算真正生效（canResolveUnblockedTracks）。
⚠️ 常见错误：只打开总开关却没勾选任何音源，灰色歌曲依然无法播放。两个条件缺一不可。
三、它怎么找到"同一首歌"？严格的三重匹配
从第三方平台找歌，最怕匹配到同名翻唱或错误版本。Kumone 在 AudioSourceProvider.swift 中内置了严格的匹配校验器AudioSourceTrackMatcher：
- 标题必须一致（忽略大小写、繁简宽度差异）
- 歌手必须包含原歌手名
- 时长误差不能超过 5 秒
- 版本冲突检查：
live、remix、伴奏、cover、翻唱、dj等标记必须两边一致，否则拒绝匹配
匹配失败不会勉强播放，而是继续尝试下一个音源——宁可灰着，也不放错歌。
四、解锁成功长什么样：音源徽标与提示
解锁过程对用户几乎无感，但 Kumone 留下了两处明确反馈：
- 顶部提示：播放解锁歌曲时，会弹出"已使用第三方音源：pyncmd / 酷狗音乐 / 酷我音乐"
- 播放条音源徽标：播放条右侧会出现一个"音源"标签，悬停可见"来自 xxx"（见 PlayerBar.swift）
此外，歌单列表里的灰色歌曲在解锁开启后会被标记为可播放状态（TrackList.swift），"播放全部"也不会再跳过它们。
五、播放链路全景：从灰色到响铃
播放引擎 PlayerService.swift 中的resolveSource方法，完整走一遍 URL 解析链：
- 按你设置的音质向网易官方请求播放地址
- 高音质被拒时，自动降级到标准音质重试
- 若仍拿不到地址（或只有试听），且开启了灰歌解锁 → 交给UnblockService救援
- UnblockService.swift 按pyncmd → 酷狗 → 酷我的顺序依次尝试已启用的音源
- 拿到地址后正常起播，并打上
unblock:xxx缓存标记
为什么酷我排在最后？CHANGELOG 里有记录：酷我接口越来越多地返回"请在酷我音乐APP播放"的提示音而非歌曲，因此被降为末位备选（#44）。
六、常见问题 FAQ
Q1：开启了灰歌解锁，为什么某首歌还是灰色？
可能是：①没勾选任何音源；②三个音源上都没有这首歌（地区版权限制）；③匹配器判定为版本冲突主动放弃。可查看 AudioSourceTrackMatcher 了解拒绝条件。
Q2：解锁歌曲的音质和原版一样吗？
第三方音源返回的是 MP3 流（pyncmd 请求 320kbps），音质可能低于网易官方的无损/Hi-Res，但胜在"能听到"。
Q3：解锁功能会增加流量或缓存负担吗？
会。解锁播放的歌曲与正常歌曲一样进入本地音频缓存，缓存策略由 AudioCache.swift 统一管理，可在"存储"页查看用量。
Q4：离线时灰歌能播吗？
不能。离线模式只能播放已下载的歌曲（见 OfflineAudio.swift）；解锁依赖实时网络匹配。
写在最后
Kumone 的灰歌解锁把"灰色歌曲"从劝退项变成了普通选项：一个开关 + 三个音源 + 一套防错匹配，全部在客户端内原生完成，不需要部署任何服务端。配合它的双语歌词、黑胶 VIP 无损音质和 AutoMix 自动过渡，几乎可以听完歌单里的每一首歌。
核心文件速查：
- 解锁调度：UnblockService.swift
- 匹配协议：AudioSourceProvider.swift
- 酷狗音源：KugouAudioSourceProvider.swift
- 酷我音源：KuwoAudioSourceProvider.swift
- 设置界面：SettingsView.swift
- 项目文档：docs/
【免费下载链接】kumone
雲の音 — Native macOS NetEase Cloud Music client built with SwiftUI
相关推荐
如何快速恢复网易云灰色歌曲：完整解锁指南
你是否曾经打开网易云音乐，却发现心爱的歌曲变成了灰色无法播放？这种情况相信很多音乐爱好者都遇到过。版权限制、地区限制等因素导致大量歌曲被标记为灰色，严重影响了我
网络后端UnblockNeteaseMusic终极指南：如何一键解锁网易云音乐灰色歌曲
还在为网易云音乐里的灰色歌曲烦恼吗？UnblockNeteaseMusic这个开源工具能够帮你解决这个困扰，让所有歌曲重获新生。作为一款专业的音乐解锁工具，它通
后端API网关终极解锁网易云音乐灰色歌曲：全网音源一键畅听指南
你是否曾经满怀期待地打开网易云音乐，却发现心爱的歌曲列表里布满了无法播放的灰色歌曲？🎵 无论是身处海外遭遇版权壁垒，还是精心收藏的歌单突然失效，这些困扰音乐爱
后端API网关
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
