XIaodou0416/Beans-Music · 上手攻略

  • 仓库：XIaodou0416/Beans-Music
  • 链接：https://github.com/XIaodou0416/Beans-Music
  • 分类：iOS 工具 · 第三方音乐播放器
  • 作者：Tom
  • 更新：2026-08-30

这是什么

Beans-Music 是一款基于 iOS 26 液态玻璃（Liquid Glass） 设计语言的第三方音乐播放器，完全用 SwiftUI 实现，聚合网易云音乐与 QQ 音乐两大国内平台。项目本身由 OpenAI Codex 全程开发（需求分析 → UI 设计 → 代码实现），作者自称"纯新手"，但代码架构完整、更新活跃（最新版本 1.5.7，2026 年 8 月）。

核心定位：颜值 + 可定制化。不同于系统自带音乐 App，Beans-Music 几乎每一个 UI 元素（主题色、壁纸、进度条样式、歌词排版、播放器控件位置）都可以自由调节，并在 iOS 26 以上呈现与系统 App 一致的原生液态玻璃视觉效果。

解决什么问题

国内用户日常面临的几类痛点，Beans-Music 均有针对性设计：

  • 多平台割裂：同时用网易云和 QQ 音乐时，两套账号体系、歌单、评论互相孤立。Beans-Music 双平台登录后统一管理，歌单/收藏/排行榜一站式切换。
  • 会员版权限制：VIP/SVIP 歌曲版权各异，单一平台总有盲区。Beans-Music 内置第三方音源（聆澜 LX / CR / QT 三套预设），可作为官方地址失效时的备用来源；iOS 15+ 支持免费听歌开关，自动匹配第三方音源。
  • 界面千篇一律：iOS 系统播放器可定制程度极低。Beans-Music 提供 9 套主题色、自定义壁纸、全局背景同步、XY 自由拖动播放器控件、4 种进度条样式、DJ 节奏脉冲光效等深度 DIY 选项。
  • 歌词体验粗糙：支持当前行/未播放行颜色、发光效果、3D 立体倾斜、逐行跟随、点击跳转等高阶歌词功能。

快速安装

方式一：下载现成 IPA（推荐）

  1. 前往 Releases 页面 下载最新版本 .ipa 文件。
  2. 使用 Sideloadly、AltStore 或爱思助手导入 IPA。
  3. 用自己的 Apple ID 签名安装（免费自签有效期 7 天）。

⚠️ 签名有效期有限，到期需重新签或使用 AltServer 续签。

方式二：本地源码构建

需要：Mac + Xcode 26+（注意 Xcode 版本要求较高）

# 1. 安装 XcodeGen
brew install xcodegen

# 2. 生成 Xcode 项目
xcodegen generate

# 3. 构建（不签名）
xcodebuild -project Beans.xcodeproj \
  -scheme Beans \
  -configuration Release \
  -sdk iphoneos \
  -derivedDataPath build \
  CODE_SIGNING_ALLOWED=NO \
  CODE_SIGNING_REQUIRED=NO \
  CODE_SIGN_IDENTITY="" \
  build

# 4. 打包成 IPA
mkdir -p Payload
cp -R build/Build/Products/Release-iphoneos/Beans.app Payload/
ditto -c -k --sequesterRsrc --keepParent Payload Beans-unsigned.ipa

构建产物 Beans-unsigned.ipa 仍需签名才能安装到真机。

系统要求

  • 最低：iOS 15（部分功能）
  • 最佳体验：iOS 26+（原生液态玻璃 TabBar / 系统材质）
  • Bundle ID：com.beans.app

核心用法

双平台登录

网易云音乐 - 方式一：扫码登录（推荐） - 方式二：应用内网页登录（WKWebView 自动读取 Cookie）

QQ 音乐 - 方式一：扫码授权 - 方式二：网页登录 / Cookie 导入

登录后自动同步：歌单、收藏、听歌排行、VIP/SVIP 标识。

平台快速切换

底部 Tab 栏一键切换网易云 / QQ 音乐，发现页（每日推荐/排行榜/推荐歌单）、搜索、热搜随平台联动。

听歌与下载

  • 音质选择：5 档（标准 / 较高 / 极高 / 无损 / Hi-Res），无损与 Hi-Res 自动回落。
  • 下载歌曲：128k（低质量）/ 320k（高质量），存至「文件」App。
  • 免费听歌：开启后 VIP/版权歌曲自动匹配第三方音源播放。
  • 倍速播放：0.5x ~ 2.0x。
  • 睡眠定时：可设置。

歌词进阶

进入播放页 → 点击中间歌曲标题打开「播放器设置」→ 歌词 tab： - 当前行 / 未播放行颜色（色盘任选） - 发光效果（强度 + 模糊起始距离 + 模糊强度） - 渐变起止色 - 3D 立体倾斜（上下后仰 + 左右倾斜） - 字号、行距、显示行数、对齐方式

全局主题与壁纸

  • 9 套内置主题色（琥珀暖金 / 青碧湖绿 / 樱粉 / 星蓝 / 罗兰紫 / 赛博青 / 蜜桃粉 / 鎏金黑 / 翡翠绿）
  • 自定义全局强调色（色盘选取，影响按钮/进度条/文字高亮）
  • 上传多张壁纸存入壁纸库，随时切换
  • 壁纸同步至播放器封面页、控制中心背景
  • 动态封面取色：背景渐变、进度条、播放按钮等全部跟随专辑封面主色实时变化

播放器底部布局自由拖动

进入自定义布局模式后： - 进度条、控制按钮、指示线支持 XY 自由拖动 + 缩放 - 调整时有悬浮窗实时预览 - 一键恢复默认位置

配置备份与恢复

设置 → 备份与恢复，可导出/导入完整配置（主题/壁纸/歌词效果/播放器布局/自定义音源/本地歌单），换机无忧。备份文件为 JSON 格式，不包含账号 Cookie 和登录信息。

典型适用场景

场景 推荐理由
同时使用网易云 + QQ 音乐 统一管理双平台歌单/收藏，一个 App 搞定
对 UI 颜值有追求 iOS 26 液态玻璃 + 9 色主题 + 壁纸同步，颜值第一梯队
想听 VIP 歌曲但没会员 内置第三方音源作为备用来源，免费听歌开关
追求歌词沉浸感 3D 倾斜/发光/行距/渐变全套 DIY，业界罕见
播放器布局想完全自定义 XY 拖动控件 + 4 种进度条样式 + DJ 光效
换机迁移设置 JSON 备份/恢复，换机不用重新调

坑与注意

  1. 签名有效期限制：免费 Apple ID 签名 IPA 有效期仅 7 天，需要定期重新签名。AltStore 可自动续签，但需要保持电脑端 AltServer 运行。
  2. 第三方音源依赖逆向接口：内置聆澜等音源基于非官方 API，版权/会员歌曲匹配率受平台政策影响，不保证 100% 可用。
  3. iOS 26 以下无原生液态玻璃：iOS 15/16/17 自动降级为系统材质，但功能完整保留。仅视觉效果差异。
  4. Xcode 26 构建要求：本地源码构建需要 Xcode 26，当前正式版 Xcode 为 Xcode 27（测试版渠道外无法稳定获取），普通用户建议直接用 Release IPA。
  5. 不支持 Apple Music / Spotify：仅聚合网易云与 QQ 音乐，无其他流媒体平台。
  6. 免责声明：作者在 README 明确"仅供学习研究使用"，第三方音乐 API 涉及平台接口逆向，使用需自担风险。
  7. 备份不含账号信息：1.5.1 版本起备份文件不包含 Cookie/token，换机后需重新登录各平台账号。
  8. GitHub 自动更新检测：1.5.0+ 支持自动检测 GitHub 新版本，但下载后仍需手动重新签名安装。

与同类对比

特性 Beans-Music LyricFish（同类歌词工具） 爱思助手（IPA 安装）
双平台聚合 ✅ 网易云 + QQ ❌ ❌
iOS 26 液态玻璃 ✅ 原生 ❌ ❌
播放器控件自由拖动 ✅ XY + 缩放 ❌ ❌
歌词 3D 倾斜/发光 ✅ 部分 ❌
全局主题/壁纸同步 ✅ ❌ ❌
免费听 VIP 歌曲 ✅（第三方音源） ❌ ❌
配置 JSON 导出 ✅ ❌ ❌
纯 SwiftUI 实现 ✅ — ❌
开源 ✅ MIT 部分 ❌

Beans-Music 在第三方 iOS 音乐播放器细分中，以极高的可定制化程度和 iOS 26 液态玻璃设计语言形成差异化竞争力。国内同类开源项目较少与之直接对标，闭源竞品（如酷狗/网易云自身）则在双平台聚合和 AI 全流程开发上无法相比。

一句话推荐结论

Beans-Music 是目前 iOS 上颜值最高、可定制化最深的双平台音乐播放器，若你同时用网易云和 QQ 音乐、对界面审美有追求、想摆脱官方 App 的千篇一律，值得一试——但需接受 IPA 签名限制和第三方音源的稳定性浮动。