30秒速读
网易云音乐听得多，又想在桌面和终端两处都能听，Yokaze一次给了两个入口：图形桌面端看歌单、双语歌词和菜单栏歌词，终端 ypm 则在命令行里画封面、歌词和频谱。本篇讲两个入口怎么选、怎么装，以及装之前必须先核对的平台条件。
GitHub 国内访问较慢，如打不开可多刷新几次。
项目信息表
| 项目 | Yokaze |
|---|---|
| 定位 | 支持桌面端与终端 TUI 的网易云音乐播放器 |
| 支持平台 | macOS、Windows、Ubuntu 与终端环境 |
| 桌面端技术 | Tauri 2、Vue 3、Vite，Rust 构建 |
| 终端端 | ypm TUI，ratatui 绘制封面、双语歌词与频谱 |
| 系统要求 | macOS 面向 Apple Silicon，需 macOS 14 或更高版本；Linux x64 以 Ubuntu 22.04、glibc 2.35 为兼容基线，并依赖 libasound2 |
| 核心能力 | 每日推荐、私人 FM、歌单、专辑、歌手、云盘、双语歌词、菜单栏歌词、迷你播放条、灰色歌曲换源、无损与 Hi-Res 音质 |
| 扩展能力 | Last.fm 记录、Discord 状态、全局快捷键、系统媒体键、JSON 播放状态、版本化 NDJSON 频谱流 |
| 获取方式 | 从项目仓库 Releases 页面按平台与架构下载，ypm 也可通过 Homebrew 第三方 tap 安装 |
上手指南
- 先定入口：只在桌面听就装桌面端，整天泡终端就只装 ypm，两个都想要再两个都装，不要上来全装一遍。
- 桌面端按系统选包：macOS 从 Releases 下载 DMG，注意是面向 Apple Silicon 的包；Windows 用户建议在 Windows Terminal 里使用终端部分。
- ypm 安装前先确认 Linux 条件：Ubuntu 22.04、glibc 2.35、libasound2，缺音频库先补齐，否则装完也可能起不来。
- 登录网易云音乐账号后先打开每日推荐和私人 FM，确认歌单、云盘内容能正常加载，再去调歌词和主题。
- 桌面窗口压低可切换为迷你播放条，macOS 还能在菜单栏显示封面与当前歌词；终端里则试八套内置主题，挑一套看着舒服的，再按需改自定义配色。
装完先做三件事：第一，备份 ypm 的自定义 TOML 配置和主题，因为配置错误会直接导致退出，升级前有备份才能快速恢复；第二，终端用户装好 Nerd Font 再开 ypm，否则图标可能显示不正常；第三，确认自动更新通道，发布包的自动更新只适用于从 tag 构建的包，本地构建不会配置自动更新公钥，别指望它自己静默升级。
明确取舍：适合谁，不适合谁
| 场景 | 建议 |
|---|---|
| 网易云音乐用户，想要桌面加终端两个听歌入口 | 适合，这是它区别于单一播放器的地方 |
| 只在终端听歌，想要封面、双语歌词、频谱和主题定制 | 适合，只装 ypm 就够 |
| 想用脚本或外部工具读播放状态、做可视化 | 适合，JSON 状态与 NDJSON 频谱流就是为此准备的 |
| 设备不是 Apple Silicon Mac，或 Linux 不是 Ubuntu 22.04 基线 | 先验证，不要直接假设能跑，发行说明里没写明的架构都要实测 |
| 需要离线播放、企业级服务保证或完整 API 契约 | 不适合，它依赖网易云音乐账号与网络服务，未说明这些边界 |
一句话结论：Yokaze 适合把网易云音乐当主力、又同时混桌面与终端的人；平台条件卡得比较细，装之前先按系统要求自查一遍，能省下大量排错时间。
常见问题
问：Windows 上终端部分怎么用？据项目说明，Windows 端建议使用 Windows Terminal，先确认终端本身显示正常，再验证 ypm 的封面、歌词与频谱表现。
问：Linux 装完起不来，最先查什么？先查三项：是不是 Ubuntu 22.04 与 glibc 2.35 基线、libasound2 装了没有、架构包有没有选错，这三项是项目明确给出的兼容条件。
问：ypm 配置改完直接退出，是坏了吗？不一定是坏了，据项目说明配置错误会直接退出。先用备份的 TOML 恢复，再逐项改回，定位是哪一行写错。
问：灰色歌曲能听吗？据项目说明支持灰色歌曲自动换源，最高可用无损和 Hi-Res 音质，但换源结果仍受账号与曲库限制，个别歌曲换不到是正常情况。
问：菜单栏歌词会被截断吗？会，据项目说明 macOS 菜单栏歌词按显示宽度截断，歌词太长时看不全是已知表现，完整歌词回主窗口或迷你播放条看。
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
