zzyoxml / md3Music

# MD3Music
 A modern Material 3 music player built with Flutter & Rust. 
一个以 Material 3 与 Apple Music 风格体验为核心的 Android 音乐客户端。 
 下载最新版 ·
 功能特性 ·
 构建指南 ·
 AI 代理接入 ·
 贡献指南 
MD3Music 是一款基于酷狗音乐 API 的 Flutter 音乐播放器，内置嵌入式 Rust API 服务器，无需外部服务器即可使用。支持手机/平板自适应、MD3 与 Apple Music 风格播放页、逐字歌词和多种音频输出能力。本项目仅供学习，请勿用于商业用途，详情见免责声明。
> **版本说明**：V5 之前的所有版本与分支均已废弃并彻底删除，请勿使用过时版本。最新版请前往 GitHub Releases。
>
> 由于私有库开发同步会覆盖公开库代码，公开库代码现由脚本全量推送至公开库 `rust-local-force` 分支。
>
> **投屏功能声明**：投屏采用行业标准的通用传输协议（DLNA/AirPlay），仅用于在个人家庭网络内将音乐流转至用户本人合法拥有的播放设备，不涉及对音乐文件的再存储、分发或向公众传播。
>
> 请勿用于公共场所播放或多人同步观看场景，否则由此引发的一切法律责任由使用者自行承担。
***
## 🏆 Trendshift Achievements
## 📈 GitHub Star 趋势
> README 中展示的是静态趋势预览。点击图表打开开源榜交互页面后，可将鼠标悬停在曲线上查看对应日期、Stars 和单日增长。数据由 GitHub Actions 定时读取 GitHub API，并保存为仓库内的每日历史快照。
***
## ✨ 功能特性
- **在线音乐** — 搜索、每日推荐、排行榜、新碟上架、听歌识曲、私人 FM、歌单/专辑/歌手/评论/MV、云盘、听书、场景音乐、频道、刷刷短视频、一起听、刷歌推荐
- **本地音乐** — 文件夹浏览、内嵌封面与歌词、本地收藏、音质标签、多维度排序、在线歌曲元数据智能匹配
- **播放体验** — 多音质选择（标准/高质/无损/Hi-Res）、USB 独占输出、均衡器、automix无缝过渡、响度均衡、DLNA 投屏、睡眠定时、倍速、进度记忆、画中画、弹幕显示、动态封面、3D封面、歌曲弹幕
- **歌词UI** — Apple Music 风格逐字歌词（KRC/LRC），支持翻译/罗马音、辉光、模糊、动态取色，以及桌面/锁屏/蓝牙歌词与 lyricinfo lyricon词幕 SuperLyric flyme歌词 推送协议
- **用户中心** — VIP 三签到、多账号管理、听歌等级/排行/识曲、收藏与播放历史、桌面小组件
- **个性化** — MD3E/AM 双风格、主题色与动态取色、深色模式、全局背景图、桌面歌词、主页 Tab 自定义
- **电视端** — 适配电视端遥控器操作，覆盖全场景使用
***
## 🏗️ 架构说明
### 本地架构
 [code] 
### 核心特点
- **嵌入式 Rust 服务器** — App 启动时通过 `libkugou_server.so`（JNI/MethodChannel）启动本地 tiny\_http 服务器（`127.0.0.1`），所有酷狗 API 请求在本地处理
- **高性能低资源** — Rust 实现取代旧 Node.js 方案，内存占用更低，启动更快
- **无需外部服务器** — 用户无需自行搭建 API 服务器
- **多架构支持** — 支持 armeabi-v7a（32 位）、arm64-v8a（64 位）、x86、x86\_64（模拟器）
- **本地投屏支持** — 内置局域网 HTTP 服务器（支持 Range 请求），本地音乐也能投屏到 DLNA 设备
***
## 🔄 CI/CD
项目配置了 GitHub Actions，推送 `v*` 标签会自动构建并创建 GitHub Release。当前发布包共 **5 个文件：4 个 APK + 1 个 Windows 便携版 ZIP**：
- `MD3Music- -standard-arm64-v8a.apk`：Android 标准版（64 位）
- `MD3Music- -apple-music-arm64-v8a.apk`：Vivo 原子随身听兼容版（64 位）
- `MD3Music- -tv-arm64-v8a.apk`：Android TV（64 位）
- `MD3Music- -tv-armeabi-v7a.apk`：Android TV（32 位）
- `md3music-windows- .zip`：Windows 便携版
例如 v6.0.5 的以上 5 个产物可在最新 Release下载。注意：公开仓库不包含私有库的一键入口 `scripts/md3.ps1`；公开树仅保留 `scripts/tasks/android.ps1`、`scripts/tasks/windows.ps1` 和 `scripts/tools/mcp_stdio_bridge.py`。
***
## 📷 更多界面预览
### 手机 · Apple Music 风格
### 手机 · 更多界面(夜间和横屏)
### 平板 · Material Design 3
### 平板 · Apple Music 风格(横屏 和 zen沉浸模式)
### Flyme 状态栏歌词
## 🚀 快速开始
### 前置要求
- **Flutter SDK** 3.47.0 或更高版本
- **Dart SDK** 3.12.0 或更高版本
- **Rust** 1.70+（用于构建嵌入式 API 服务器，若使用已提交的 `.so` 可跳过）
- **Android Studio** / VS Code
- **Android NDK** 28（用于 Rust 交叉编译）
已验证构建环境：Flutter 3.47.5、Dart 3.12.x、Android NDK 28。
### 1. 克隆项目
 [code] 
### 2. 安装 Flutter 依赖
 [code] 
### 3. 构建 Rust 服务器（可选）
`libkugou_server.so` 已提交进 Git 仓库，通常无需重新编译。仅当你修改了 `kugou_api_server/rust/src/` 下的代码时才需要重建：
 [code] 
### 4. 运行应用（调试模式）
 [code] 
### 5. 构建发布版 APK
公开仓库没有私有库的一键入口 `scripts/md3.ps1`。在 Windows PowerShell 中直接运行公开树提供的独立构建脚本：
 [code] 
该脚本默认构建标准版（arm64-v8a、armeabi-v7a、x86\_64）、3D 封面版（arm64-v8a）及随身听兼容版（arm64-v8a），本地默认共 5 个 APK，输出到 `build\ap