Kumone 是一个在 macOS 上原生运行的网易云音乐客户端，用 SwiftUI 从零写成，专治「在 Mac 上听网易云只能开网页」这件事。
Mac 用户对这件事应该都有体会：网页版没有全局快捷键，系统媒体键按不动，锁屏看不到封面，切歌得先切回浏览器。官方一直没出 Mac 客户端，于是大家要么忍着用网页，要么去找第三方。
第三方里出名的是 YesPlayMusic 那类，底子是 Electron——一个网页套了层壳。能用，但启动慢、吃内存、滚动带阻尼感，怎么都像个网页而不是 Mac 应用。
Kumone 换了条路：SwiftUI 写界面，AVPlayer 放声音，请求直连网易云，中间没有第三方服务器。
它是原生 Mac 应用，不是套壳网页
这点决定了手感。几个能直接感知的差别：
- 系统级集成：媒体键、控制中心、锁屏信息都跟着走，切歌不用切窗口
- 苹果签名并公证：不是来路不明的野包，拖进应用程序就能开，Gatekeeper 不拦
- 内置 Sparkle 更新：菜单栏 Kumone → Check for Updates…，不用回 GitHub 手动下
- Universal 构建：Apple Silicon 与 Intel 同一份包，不用挑版本
装起来有多快
两种方式，都不用改系统设置、也不用关 Gatekeeper：
- Homebrew：
brew install owo-network/brew/kumone --cask - 手动：下载
Kumone-0.3.21.zip，解压后把 App 拖进「应用程序」
第一次打开会让你扫码登录，之后 Cookie 自己续期，不用反复扫。
听歌这块覆盖到什么程度
不是个能播就行的壳子，该有的都有：
- 扫码登录：拿网易云 App 扫一下，Cookie 存在本地并自动续期
- 首页：每日推荐、私人 FM、心动模式、推荐歌单、个人雷达、排行榜、新碟、推荐歌手
- 探索：精选、官方、榜单、心情四类歌单，可以一直往下翻
- 播放：标准到 Hi-Res 多档音质、随机与三种循环、播放队列、灰色歌曲识别
- 歌词：同步滚动、桌面歌词面板、全屏沉浸式正在播放
音质上限取决于账号，不是它
这点容易被误解：它本身不提供会员，也不破解音质。账号有黑胶 VIP 才放得出无损，没有就自动回落到标准档——不会放不出来，只是到不了最高那档。
它做的是把能拿到的那一档完整播出来，AVPlayer 引擎，不是网页播放器压出来的声音。
三个别家没做的事
- 不经过第三方服务器：weapi 与 eapi 两套加密全在 Swift 里实现，请求直接打到网易云域名。多一层中转就多一份账号风险，它省掉了这一层
- iCloud 同步：播放进度、偏好设置、登录状态可以在多台设备间接续，换台 Mac 不用重新配
- 灰色歌曲处理：内置一套替换逻辑，遇到因版权下架的歌会尝试找可播来源，找不到也不崩
几个绕不过去的限制
- macOS 15 起：系统版本不够直接跑不起来，老 Mac 没戏
- 上不了 App Store：第三方客户端拿不到授权，只能从 GitHub 下或 brew 装
- CarPlay 要自己开：代码写好了但默认不打包——苹果只给申请过的音频类应用发 entitlement。仓库留了
make configure-carplay一条命令，前提是你的开发者账号已经获批
iPhone 和 iPad 也有
每个版本同时发一个未签名的 ipa（iOS 16 起），用 AltStore、SideStore、Sideloadly 或 Xcode 拿自己的 Apple ID 签名后装上。不上架，所以也别指望 App Store 搜得到。
装过巨魔（TrollStore）的设备还能自动更新：设置 → 关于 → 检查更新，下载完直接交给 TrollStore 一键安装。普通侧载没有这个能力，只能重新签一遍，好在登录状态和设置会保留。
什么时候别用它
你只用 Apple Music 或 Spotify，没必要为了一首歌折腾侧载。手头 Mac 系统低于 15，也省下这份心。
它对的人是：日常主力听网易云、长期在 Mac 上工作、受够了网页版割裂感的那批人。
项目在这里，更新日志和构建说明都写得很细：
