MoeKoe Music Mobile

一款开源、简洁、高颜值的第三方酷狗音乐移动端播放器

基于 Expo / React Native 构建，是 MoeKoeMusic 桌面版的移动端实现

🌎 GitHub仓库  |   📦️ 下载安装包  |   💬 访问博客  |   🏠 项目主页

✨ 特性

• 🎵 无需自建服务器 — 酷狗 API 适配层直接直连官方，开箱即用，不依赖外部 API 地址

• 🏠 首页推荐 — 每日推荐、精选歌单、排行榜

• 🧭 发现页 — 分类歌单、新歌速递等内容探索

• 🔍 搜索 — 快速检索歌曲、歌单、专辑

• 📀 歌单 / 专辑 / 排行榜 — 完整的详情页与曲目列表

• 🎧 播放器 — 滚动歌词、播放队列、迷你播放条（MiniPlayer）、后台播放

• 🎚️ 音质检测 — 自动探测并选择可用音质

• 📱 手机号登录 — 同步酷狗账号的收藏与歌单

• 🌗 深色模式 — 跟随系统自动切换明暗主题

📝 Todo List

• 首页每日推荐 / 精选歌单 / 排行榜

• 发现页分类内容浏览

• 搜索歌曲、歌单、专辑

• 歌单 / 专辑 / 排行榜详情页

• 播放器：滚动歌词、播放队列、迷你播放条、后台播放

• 音质检测与自动选择

• 手机号登录

• 账号密码登录

• 扫码登录(其他设备)

• 我喜欢 / 收藏同步

• 用户歌单管理（创建 / 收藏 / 编辑）

• 歌曲详情浏览

• 通知栏 / 锁屏播放控制

• 桌面歌词

• 听歌识曲

• 平板与横屏适配

📸 预览

🚀 快速开始

环境要求

• Node.js ≥ 20

• Git

• iOS 模拟器 / Android 模拟器，或安装了开发版客户端的真机

开发运行

# 克隆仓库（包含 api submodule）
git clone --recurse-submodules https://github.com/MoeKoeMusic/MoeKoeMusic-Mobile.git
cd MoeKoeMusic-Mobile

# 安装依赖
npm install
npm --prefix api install

# 生成移动端 API 入口（api/ 更新后需重新执行）
npm run generate:mobile-api

# 启动开发服务器
npx expo start

如果克隆时遗漏了 submodule，可执行 git submodule update --init 补齐。

打包构建

项目使用 EAS Build：

# 开发版（Development Client）
eas build --profile development --platform android

# 预览版（内部分发）
eas build --profile preview --platform android

# 生产版
eas build --profile production --platform all

🏗️ 项目结构

├── api/                    # KuGouMusicApi（git submodule）
├── scripts/
│   └── generate-mobile-api-entry.mjs   # 扫描 api/module 生成移动端入口
├── src/
│   ├── app/                # expo-router 路由
│   │   ├── (tabs)/         # 首页、发现、我的
│   │   ├── player.tsx      # 全屏播放页
│   │   ├── search.tsx      # 搜索页
│   │   ├── login.tsx       # 登录页
│   │   └── playlist|album|rank/[id].tsx  # 详情页
│   ├── components/ui/      # 通用 UI 组件（歌词、队列、迷你播放条等）
│   ├── features/           # 业务模块（player / discover / search / account ...）
│   ├── lib/kugou-api/      # 应用内 API 运行时适配层
│   ├── hooks/              # 通用 Hooks
│   └── constants/          # 主题与布局常量
├── app.json                # Expo 应用配置
└── eas.json                # EAS 构建配置

🔧 技术栈

🤝 相关项目

• MoeKoeMusic — 桌面版（Windows / macOS / Linux）

• KuGouMusicApi — 酷狗音乐 Node.js API，本项目的数据来源

💬 贡献

欢迎任何形式的贡献！

1. Fork 本仓库

2. 创建特性分支：git checkout -b feat/amazing-feature

3. 提交更改：git commit -m 'feat: add amazing feature'

4. 推送分支并发起 Pull Request

发现问题或有功能建议，请提交 Issue。

⚠️ 免责声明

1. 本项目仅供学习与技术研究使用，请勿用于任何商业用途。

2. 本项目不存储、不分发任何音频资源，所有数据均来自酷狗音乐官方接口。

3. 音乐版权归酷狗音乐及相应版权方所有，请支持正版音乐。

4. 使用本项目产生的一切后果由使用者自行承担，与开发者无关。

📄 License

本项目基于 GPL-2.0 License 开源。