🎧 ZMusic

不是功能越多越好。
ZMusic 只想把一件事做好——
让听歌，变得安静、顺滑、沉进去。

少一点打扰，多一点沉浸。打开它，就是为了听。

• 沉浸播放 —— 全屏播放器、歌词异步加载，起播不被阻塞；三种播放模式（列表循环 / 单曲循环 / 随机）
• 应用内灵动岛 —— 所有软件内提示统一为顶部液体玻璃胶囊（非 Toast / Snackbar），带封面与过冲动画，见 ANDROID-ISLAND-NOTICE.md
• 液体玻璃设计 —— Kyant Backdrop 真实折射玻璃，Dock、确认弹窗与灵动岛同窗采样
• 系统级播控 —— Media3 MediaSessionService 独占通知与前台服务，锁屏 / 通知栏可控
• 智能缓存 —— 封面磁盘缓存、歌词缓存、下一首 URL 短 TTL 预取
• 扫码与手机号登录 —— 与网易云兼容 API 打通，会话安全存储
• 社区版本目录 —— 公开接口为 XAIOP 文本；Android 用 Maven 包 io.github.aboutuip:xaiop 0.15.1 解析（HTTP / WebSocket 走 OkHttp，不用 JDK HttpClient）
• 跨端对齐 —— Android 与 Windows 两端独立实现，播放语义、鉴权与接口行为级一致

# Android（需要 Android Studio / JDK）
cd Android
./gradlew assembleDebug          # Windows 下用 gradlew.bat

# Windows 客户端
dotnet run --project Windows/ZMusic.csproj

# Linux amd64 .deb（Ubuntu / Debian / Kali）
bash Distribution/Linux/build-deb.sh --install-deps
sudo apt install ./artifacts/linux/ZMusic-Linux-0.1.deb

API 基址默认内置；本地调试可覆盖（文档不写死服务地址）：

# Android/local.properties
ncm.api.base.url=http://127.0.0.1:3000

# Windows（PowerShell）
$env:ZMUSIC_NCM_API_BASE_URL = "http://127.0.0.1:3000"

# Linux
export ZMUSIC_NCM_API_BASE_URL=http://127.0.0.1:3000

ZMusic/
├── Android/          Android 客户端（Compose + Media3）
├── Windows/          Windows 客户端（WPF · .NET 9）
├── Linux/            Linux 客户端（Compose Desktop，见 docs/LINUX.md）
├── Distribution/     发行脚本与安装包工程
├── docs/             架构、分发与接口文档
└── artifacts/        构建产物（已 gitignore）

细节一律以 docs/ 为准。

本项目以 GNU GPL v2.0 开源，以温柔的方式存在。