WebMusic/webmusic-server/README-MUSIC.md

音乐服务后端说明

功能说明

本后端实现了以下功能：

1. 歌曲搜索 - 支持搜索歌曲，结果缓存在内存中（5分钟过期）
2. 播放队列管理 - 支持添加、移除、清空播放队列，队列数据存储在内存中
3. 歌曲详情 - 获取歌曲详情，结果缓存在内存中（10分钟过期）
4. 歌曲播放URL - 获取歌曲播放链接

API接口

1. 搜索歌曲

GET /api/music/search?keywords=关键词&limit=20

2. 获取歌曲详情

GET /api/music/song/:id/detail

3. 获取歌曲播放URL

GET /api/music/song/:id/url?level=standard

4. 获取播放队列

GET /api/music/queue

5. 添加到播放队列

POST /api/music/queue/add
Body: { "song": { "id": "123", "title": "歌曲名", ... } }

6. 播放下一首（从队列取出）

POST /api/music/queue/play-next

7. 清空队列

POST /api/music/queue/clear

8. 从队列移除歌曲

POST /api/music/queue/remove
Body: { "songId": "123" }

配置

环境变量

• NETEASE_API_BASE: 网易云API服务器地址，默认为 http://localhost:3000

端口

后端服务运行在 7001 端口（可在 src/config/config.default.ts 中修改）

启动

# 开发模式
npm run dev

# 生产模式
npm run build
npm start

注意事项

1. 所有缓存数据存储在内存中，服务重启后数据会丢失
2. 确保网易云API服务器（api-enhanced）正在运行在 3000 端口
3. 前端需要配置 VITE_BACKEND_API 环境变量指向后端地址（默认 http://localhost:7001）