Yee Music
简洁美观的第三方网易云音乐客户端
优雅、灵动
[!IMPORTANT] 关于项目维护状态的声明
由于本人需要准备考研，本项目将暂时停止高频维护和新功能开发。 在此期间，我可能无法及时回复 Issue，预计将在 2026 年 12 月（初试结束后） 恢复正常维护，请见谅！如果你对本项目感兴趣并有修复 Bug 或优化代码的想法，欢迎随时提交 PR。
🖼️ 界面展示
✨ 功能与特性
- 界面设计深度参考 Fluent UI
- 支持 Win11 原生 Acrylic 与 Mica 效果
- 扫码登录及手机号登录
- 深浅色主题
- 新建、编辑、删除歌单及对歌单添加\删除歌曲
- 收藏歌手、歌单、专辑
- 漫游模式
- 逐字歌词、类 Apple Music 风格歌词滚动动画与流体渐变背景
- 支持全局界面与独立歌词字体配置
- 集成歌词翻译以及罗马音歌词
- 下载歌曲
- 播放本地音乐
- 歌曲缓存管理
📅 更新计划
- 音乐网盘
- 本地音乐播放支持
- 桌面歌词
🚀 快速开始
在开始之前，请确保你的开发环境已安装 Rust 和 Node.js。
1. 环境要求
- Node.js: >= 20
- Rust
- Windows 依赖: 确保已安装 C++ 生成工具和 Edge WebView2 运行时
2. 安装运行
# 1. 克隆项目
git clone https://github.com/1sen3/YeeMusic.git
cd yee-music
# 2. 安装依赖
pnpm install
# 3. 启动开发环境
pnpm tdev
# 4. 构建
pnpm tbuild
⚙️ 自定义 API 配置
本项目不直接提供后端服务，如有需要请自行部署 NeteaseCloudMusicAPI Enhanced。
- 部署好 API 服务后，获取你的服务地址。
- 在项目根目录下的 src/lib/utils/api.ts 中，修改 BASE_URL 变量：
// src/lib/utils/api.ts
const BASE_URL = "你的 API 地址";
🛠️ 技术栈
- 核心: React 19, TypeScript, Rust, Tauri 2.0
- 动画: Framer Motion, GSAP, Three.js
- 样式: TailwindCSS 4.0, shadcn/ui, Fluent UI React
- 状态与数据: Zustand, SWR
- 工具链: Biome, Vitest
🎁 致谢
⚠️ 声明
- 本项目为本人学习用的开源项目，仅供学习交流使用。
- 项目中使用的音乐数据及 API 均来自第三方，版权归属于网易云音乐，请勿用于任何商业用途。
📄 开源协议
本项目基于 GNU Affero General Public License v3.0 协议开源。
- 你可以自由地使用、复制、修改和分发本项目的代码（包括商业用途）。
- 请在使用、分发时保留原作者的版权声明和许可声明。
- 如果你修改了本项目，或者基于本项目创建了衍生作品并进行分发，你的衍生项目必须以相同的 AGPL-3.0 协议开源，并公开完整源代码。