Update README.md

2025-09-14 03:26:46 +08:00 · 2025-08-25 01:30:19 +08:00 · 2025-08-25 01:30:19 +08:00 · 780337dc2e
commit 780337dc2e
parent 7d2fd1af8c
1 changed files with 213 additions and 48 deletions
--- a/README.md
+++ b/README.md
@ -1,78 +1,244 @@
-# 网易云无损音乐解析
+# 网易云音乐无损解析

-> **声明**  
+<div align="center">
+
+![GitHub stars](https://img.shields.io/github/stars/Suxiaoqinx/Netease_url?style=flat-square)
+![GitHub forks](https://img.shields.io/github/forks/Suxiaoqinx/Netease_url?style=flat-square)
+![GitHub issues](https://img.shields.io/github/issues/Suxiaoqinx/Netease_url?style=flat-square)
+![GitHub license](https://img.shields.io/github/license/Suxiaoqinx/Netease_url?style=flat-square)
+
+**功能强大的网易云音乐解析工具**
+
+支持歌曲搜索 | 单曲解析 | 歌单解析 | 专辑解析 | 音乐下载
+
+[在线体验](https://api.toubiec.cn/wyapi.html) • [使用文档](./使用文档.md) • [问题反馈](https://github.com/Suxiaoqinx/Netease_url/issues)
+
+</div>
+
+---
+
+> **⚠️ 重要声明**  
 > 本项目为开源软件，遵循 MIT 许可证。任何个人或组织均可自由使用、修改和分发本项目的源代码。但本项目及其任何衍生作品**禁止用于任何商业或付费项目**。如有违反，将视为对本项目许可证的侵犯。欢迎大家在遵守开源精神和许可证的前提下积极贡献和分享代码。

---
+## ✨ 功能特性

-## 功能简介
+### 🎵 核心功能
+- **🔍 歌曲搜索**：支持关键词搜索网易云音乐库中的歌曲
+- **🎧 单曲解析**：解析单首歌曲的详细信息和下载链接
+- **📋 歌单解析**：批量解析歌单中的所有歌曲信息
+- **💿 专辑解析**：批量解析专辑中的所有歌曲信息
+- **⬇️ 音乐下载**：支持多种音质的音乐文件下载

-本项目可解析网易云音乐无损音质下载链接，支持多种音质选择，支持 API 与命令行（GUI）两种模式。
+### 🎼 音质支持
+- `standard`：标准音质 (128kbps)
+- `exhigh`：极高音质 (320kbps)
+- `lossless`：无损音质 (FLAC)
+- `hires`：Hi-Res音质 (24bit/96kHz)
+- `jyeffect`：高清环绕声
+- `sky`：沉浸环绕声
+- `jymaster`：超清母带
+
+### 🌐 使用方式
+- **Web界面**：直观友好的网页操作界面
+- **RESTful API**：完整的API接口支持
+- **批量处理**：支持歌单和专辑的批量解析
+- **多格式支持**：支持ID和链接多种输入格式

 ---

-## 快速开始
+## 🚀 快速开始

-### 1. 安装依赖
+### 环境要求
+- Python 3.7+
+- 网易云音乐黑胶会员账号

+### 安装步骤
+
+#### 1. 克隆项目
+```bash
+git clone https://github.com/Suxiaoqinx/Netease_url.git
+cd Netease_url
+```
+
+#### 2. 安装依赖
 ```bash
 pip install -r requirements.txt
 ```

-### 2. 配置 Cookie
-
-   
-   在 `cookie.txt` 文件中填入黑胶会员账号的Cookie：
-   
-   > 💡 **获取Cookie方法**：
-   > 1. 登录网易云音乐网页版
-   > 2. 按F12打开开发者工具
-   > 3. 在Network标签页找到任意请求
-   > 4. 复制请求头中的Cookie值
-
-### 3. 运行
-
-#### GUI 模式
-
-```bash
-python main.py --mode gui --url <网易云音乐地址> --level <音质参数>
+#### 3. 配置Cookie
+在 `cookie.txt` 文件中填入黑胶会员账号的Cookie：
+```
+MUSIC_U=你的MUSIC_U值;os=pc;appver=8.9.70;
 ```

-#### API 模式
+> 💡 **获取Cookie方法**：登录网易云音乐网页版 → F12开发者工具 → Network标签页 → 复制任意请求的Cookie值

+#### 4. 启动服务
 ```bash
-python main.py --mode api
+python main.py
 ```

- 访问接口：http://ip:port/类型解析
- 支持 GET 和 POST 请求
+#### 5. 访问界面
+打开浏览器访问：`http://localhost:5000`
+
+### 🐳 Docker部署
+
+```bash
+# 使用Docker Compose
+docker-compose up -d
+
+# 或使用Docker
+docker build -t netease-music-api .
+docker run -d -p 5000:5000 netease-music-api
+```

 ---

-## 参数说明
+## 📖 使用指南

-### GUI 模式参数
+### Web界面使用

-| 参数         | 说明                         |
-| ------------ | ---------------------------- |
-| --mode       | 启动模式：api 或 gui         |
-| --url        | 需要解析的网易云音乐地址     |
-| --level      | 音质参数（见下方音质说明）   |
+#### 🔍 歌曲搜索
+1. 选择功能：**歌曲搜索**
+2. 输入关键词（歌曲名、歌手名等）
+3. 点击**搜索**按钮
+4. 在搜索结果中点击**解析**或**下载**按钮

-### API 模式参数
+#### 🎧 单曲解析
+1. 选择功能：**单曲解析**
+2. 输入歌曲ID或网易云音乐链接
+   - 支持格式：`1234567890` 或 `https://music.163.com/song?id=1234567890`
+3. 点击**解析**按钮查看歌曲信息

-| 参数         | 说明                                         |
-| ------------ | -------------------------------------------- |
-| url / ids    | 网易云音乐地址或歌曲ID（二选一）             |
-| level        | 音质参数（见下方音质说明）                   |
-| type         | 解析类型：json / down / text（三选一）       |
+#### 📋 歌单解析
+1. 选择功能：**歌单解析**
+2. 输入歌单ID或网易云音乐歌单链接
+   - 支持格式：`1234567890` 或 `https://music.163.com/playlist?id=1234567890`
+3. 点击**解析**按钮查看歌单中所有歌曲
+4. 点击单首歌曲的**解析**或**下载**按钮

-| 类型参数         | 说明                                         |
-| ------------ | -------------------------------------------- |
-| Song_v1    | 单曲解析             |
-| search        | 搜索解析                   |
-| playlist         | 歌单解析       |
-| album         | 专辑解析       |
+#### 💿 专辑解析
+1. 选择功能：**专辑解析**
+2. 输入专辑ID或网易云音乐专辑链接
+   - 支持格式：`1234567890` 或 `https://music.163.com/album?id=1234567890`
+3. 点击**解析**按钮查看专辑中所有歌曲
+4. 点击单首歌曲的**解析**或**下载**按钮
+
+#### ⬇️ 音乐下载
+1. 选择功能：**音乐下载**
+2. 输入歌曲ID或链接
+3. 选择音质（标准/极高/无损/Hi-Res等）
+4. 点击**下载**按钮
+
+### 支持的链接格式
+
+```
+# 歌曲链接
+https://music.163.com/song?id=1234567890
+https://music.163.com/#/song?id=1234567890
+
+# 歌单链接
+https://music.163.com/playlist?id=1234567890
+https://music.163.com/#/playlist?id=1234567890
+
+# 专辑链接
+https://music.163.com/album?id=1234567890
+https://music.163.com/#/album?id=1234567890
+
+# 直接使用ID
+1234567890
+```
+
+## 🔌 API接口文档
+
+### 基础信息
+- **Base URL**: `http://localhost:5000`
+- **请求方式**: GET / POST
+- **响应格式**: JSON
+
+### 接口列表
+
+#### 1. 健康检查
+```http
+GET /health
+```
+**响应示例**:
+```json
+{
+  "status": "ok",
+  "message": "Service is running"
+}
+```
+
+#### 2. 歌曲搜索
+```http
+POST /search
+Content-Type: application/json
+
+{
+  "keywords": "周杰伦 稻香",
+  "limit": 10
+}
+```
+**响应示例**:
+```json
+{
+  "code": 200,
+  "result": {
+    "songs": [
+      {
+        "id": 185668,
+        "name": "稻香",
+        "artists": ["周杰伦"],
+        "album": "魔杰座",
+        "duration": 223000
+      }
+    ]
+  }
+}
+```
+
+#### 3. 单曲解析
+```http
+POST /song
+Content-Type: application/json
+
+{
+  "id": "185668"
+}
+```
+
+#### 4. 歌单解析
+```http
+POST /playlist
+Content-Type: application/json
+
+{
+  "id": "123456789"
+}
+```
+
+#### 5. 专辑解析
+```http
+POST /album
+Content-Type: application/json
+
+{
+  "id": "123456789"
+}
+```
+
+#### 6. 音乐下载
+```http
+POST /download
+Content-Type: application/json
+
+{
+  "id": "185668",
+  "quality": "lossless"
+}
+```
+**响应**: 直接返回音频文件流

 ---

@ -136,5 +302,4 @@ python main.py --mode api

 ---

-
 欢迎 Star、Fork 和 PR！