基于NeteaseCloudMusicApi的音乐app 支持 DeepSeek 自然语言找歌、批量导入歌单、下载音乐转换成MP3，下载歌词

为什么写这个项目

网易云音乐官方的几个痛点相信大家都经历过：

想把自己收藏的歌单分享给别人，只能发链接，对方还得一个一个点播放
截图 OCR 识别歌单？准确率感人，日韩歌曲基本识别不出来
下载不了歌曲，下载不了歌词

于是花了几个周末，用 Kotlin + Jetpack Compose 从零写了一个增强版音乐客户端，把上面这些痛点都解决了。

项目已开源：GitHub - music_wyy

核心功能

1. 文本列表批量导入歌单

这是我觉得最实用的功能。你只需要把「歌名 - 歌手」格式的文本列表粘贴进去，App 会通过网易云 API 并行精确搜索匹配，一键创建歌单。比如：

复制代码

晴天 - 周杰伦
Lemon - 米津玄师
Dynamite - BTS
进击的巨人 - Linked Horizon

粘贴 → 搜索 → 创建歌单，三步搞定。

2. AI 自然语言找歌（DeepSeek）

这是项目的亮点。传统搜歌只能打关键词，这个可以：

"推荐一些适合下雨天听的钢琴曲"

"进击的巨人所有 OP 和 ED"

"类似米津玄师 Lemon 风格的日语歌曲"

工作流程：

用户输入自然语言描述
DeepSeek LLM 生成 30+ 个搜索关键词
Python 后端 httpx 6 并发搜索网易云 API
去重 → 验证真实性 → 返回结果
Redis 缓存 7 天，重复查询秒级返回

关键设计 ：每首歌必须经过网易云 API 实际搜索验证，消除 100% 的 LLM 虚构歌曲。这一点很重要，因为 LLM 非常擅长编造不存在的歌名。

3. 卡拉 OK 模式歌词显示

LRC 逐字同步滚动
中英翻译一键切换
沉浸式全屏模式
歌词文本导出 & 系统分享

4. 全自动签到系统

基于 WorkManager 后台定时任务，自动完成：

每日签到
云贝任务
300 首刷歌打卡

设置一次就不用管了。

5. 完整音乐播放器

基于 AndroidX Media3 (ExoPlayer)，支持流式播放、离线缓存、LRU 缓存淘汰、单曲/列表/随机三种循环模式、MiniPlayer 迷你播放条。

技术栈

层级	技术选型
语言	Kotlin 2.1+
UI	Jetpack Compose + Material Design 3
架构	MVVM + UDF 单向数据流 + Clean Architecture
依赖注入	Koin
数据库	Room + KSP
网络	Retrofit + OkHttp + kotlinx.serialization
媒体播放	AndroidX Media3 (ExoPlayer)
后台任务	WorkManager
AI 后端	Python FastAPI + DeepSeek API + Redis
最低支持	Android 7.0 (API 24)

系统架构

复制代码

UI 层:  Compose Screens + ViewModels (StateFlow + UDF)
        ↓
领域层: UseCase / Repository 接口 / Domain Models
        ↓
数据层: Room (本地) + DataStore (配置) + Retrofit (远程)

12 个功能模块：登录、首页、歌单、批量创建、AI 找歌、播放器、歌词、自动签到、私信、云贝、个人中心、设置。

AI 找歌后端

独立部署的 Python 服务：

FastAPI 提供 REST API（:8100）
DeepSeek API 生成搜索关键词
Redis 缓存查询结果（:6380，TTL 7 天）
httpx 异步并发搜索网易云 API

服务端代码不到 300 行，docker compose up -d 一键部署。

快速上手

bash 复制代码

git clone https://github.com/MouShenT/music_wyy.git

用 Android Studio 打开，等 Gradle 同步完就能跑了。后端需要 Docker 部署 NeteaseCloudMusicApi + AI 服务。

写在最后

这个项目花了不少心血，从 UI 到后端再到 AI 链路都自己整了一遍。如果你也在做类似的音乐相关项目，或者对 Jetpack Compose / FastAPI / DeepSeek 感兴趣，这个项目应该能给你一些参考。

觉得有用的话，可以给个 Star ⭐，感谢支持！

项目地址：https://github.com/MouShenT/music_wyy

标签：Android, Kotlin, Jetpack Compose, 网易云音乐, DeepSeek, AI, 开源项目, FastAPI, 音乐播放器