@neteasecloudmusicapienhanced/api 4.30.1 → 4.30.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/README.MD +48 -23
  2. package/data/china_ip_ranges.txt +4147 -0
  3. package/module/cloud.js +136 -119
  4. package/module/cloud_upload_complete.js +72 -0
  5. package/module/cloud_upload_token.js +111 -0
  6. package/module/comment_add.js +15 -0
  7. package/module/comment_delete.js +10 -0
  8. package/module/comment_info_list.js +30 -0
  9. package/module/comment_reply.js +13 -0
  10. package/module/search_suggest_pc.js +13 -0
  11. package/module/song_like.js +12 -0
  12. package/module/song_url_ncmget.js +2 -74
  13. package/module/song_url_v1_302.js +53 -0
  14. package/module/user_followeds.js +1 -1
  15. package/module/voice_upload.js +36 -22
  16. package/module/voicelist_my_created.js +13 -0
  17. package/module/voicelist_search.js +6 -9
  18. package/package.json +19 -25
  19. package/plugins/songUpload.js +67 -19
  20. package/plugins/upload.js +5 -7
  21. package/public/cloud.html +406 -39
  22. package/public/docs/home.md +232 -9
  23. package/public/docs/index.html +1 -1
  24. package/public/docs/logo.svg +6 -0
  25. package/public/docs/netease.png +0 -0
  26. package/public/index.html +29 -4
  27. package/public/static/docs.png +0 -0
  28. package/server.js +43 -18
  29. package/util/fileHelper.js +88 -0
  30. package/util/index.js +55 -52
  31. package/data/ChineseIPGenerate.csv +0 -26
  32. package/public/docs/ncmapireborn.png +0 -0
  33. /package/public/static/{screenshot1.png → module_test.png} +0 -0
package/README.MD CHANGED
@@ -1,10 +1,38 @@
1
- # 网易云音乐 API Enhanced
1
+ <p align="center">
2
+ <img src="./public/docs/netease.png" alt="网易云音乐 API Enhanced Logo" width="120" height="120" />
3
+ </p>
4
+
5
+ <h1 align="center">NeteaseCloudMusicAPI Enhanced</h1>
6
+
7
+ <p align="center">
8
+ <a href="https://www.npmjs.com/package/@neteasecloudmusicapienhanced/api">
9
+ <img src="https://img.shields.io/npm/v/@neteasecloudmusicapienhanced/api?style=flat-square" alt="NPM Version" />
10
+ </a>
11
+ <a href="https://www.npmjs.com/package/@neteasecloudmusicapienhanced/api">
12
+ <img src="https://img.shields.io/npm/dm/@neteasecloudmusicapienhanced/api?style=flat-square" alt="NPM Downloads" />
13
+ </a>
14
+ <a href="https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced">
15
+ <img src="https://img.shields.io/github/license/NeteaseCloudMusicApiEnhanced/api-enhanced?style=flat-square" alt="License" />
16
+ </a>
17
+ <a href="https://nodejs.org/">
18
+ <img src="https://img.shields.io/node/v/@neteasecloudmusicapienhanced/api?style=flat-square" alt="Node Version" />
19
+ </a>
20
+ <a href="https://hub.docker.com/r/moefurina/ncm-api">
21
+ <img src="https://img.shields.io/docker/v/moefurina/ncm-api?style=flat-square" alt="Docker Version" />
22
+ </a>
23
+ <a href="https://hub.docker.com/r/moefurina/ncm-api">
24
+ <img src="https://img.shields.io/docker/pulls/moefurina/ncm-api?style=flat-square" alt="Docker Pulls" />
25
+ </a>
26
+ <a href="https://www.typescriptlang.org/">
27
+ <img src="https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript" alt="TypeScript" />
28
+ </a>
29
+ </p>
30
+
2
31
 
3
- ---
4
32
 
5
33
  ## 项目简介
6
34
 
7
- 本项目为网易云音乐第三方 Node.js API，基于停更的原版 API 持续维护，支持丰富的音乐相关接口，适合自建服务、二次开发和多平台部署(如果原版诈尸, 我会及时同步 or 归档)。
35
+ 网易云音乐第三方 Node.js API, 支持丰富的音乐相关接口，适合自建服务、二次开发和多平台部署(如果原版诈尸, 我会及时同步 or 归档)。
8
36
 
9
37
  > [!IMPORTANT]
10
38
  >
@@ -100,15 +128,15 @@ $ sudo docker run -d -p 3000:3000 ncm-api
100
128
 
101
129
  ## 3. 环境变量
102
130
 
103
- | 变量名 | 默认值 | 说明 |
104
- | -------------------------- | ------------------------------------ | ------------------------------------------------------------------------------ |
131
+ | 变量名 | 默认值 | 说明 |
132
+ |----------------------------|--------------------------------------|----------------------------------------------------|
105
133
  | **CORS_ALLOW_ORIGIN** | `*` | 允许跨域请求的域名。若需要限制，请指定具体域名（例如 `https://example.com`）。 |
106
- | **ENABLE_PROXY** | `false` | 是否启用反向代理功能。 |
107
- | **PROXY_URL** | `https://your-proxy-url.com/?proxy=` | 代理服务地址。仅当 `ENABLE_PROXY=true` 时生效。 |
108
- | **ENABLE_GENERAL_UNBLOCK** | `true` | 是否启用全局解灰（推荐开启）。开启后所有歌曲都尝试自动解锁。 |
109
- | **ENABLE_FLAC** | `true` | 是否启用无损音质（FLAC）。 |
110
- | **SELECT_MAX_BR** | `false` | 启用无损音质时，是否选择最高码率音质。 |
111
- | **FOLLOW_SOURCE_ORDER** | `true` | 是否严格按照音源列表顺序进行匹配。 |
134
+ | **ENABLE_PROXY** | `false` | 是否启用反向代理功能。 |
135
+ | **PROXY_URL** | `https://your-proxy-url.com/?proxy=` | 代理服务地址。仅当 `ENABLE_PROXY=true` 时生效。 |
136
+ | **ENABLE_GENERAL_UNBLOCK** | `true` | 是否启用全局解灰（推荐开启）。开启后所有歌曲都尝试自动解锁。 |
137
+ | **ENABLE_FLAC** | `true` | 是否启用无损音质（FLAC）。 |
138
+ | **SELECT_MAX_BR** | `false` | 启用无损音质时，是否选择最高码率音质。 |
139
+ | **FOLLOW_SOURCE_ORDER** | `true` | 是否严格按照音源列表顺序进行匹配。 |
112
140
 
113
141
  ---
114
142
 
@@ -182,15 +210,7 @@ pnpm test
182
210
  ## 贡献与社区
183
211
 
184
212
  - 欢迎提交 PR、Issue 参与维护
185
-
186
- ## 最近更新日志
187
- ### 4.30.0 | 2026.02.06
188
- - feat: 新增音乐人黑胶会员任务接口 `/musician/vip/tasks` (#95)
189
- - feat: 自动构建: 添加Windows、Linux、macOS预编译二进制文件 (#88)
190
- - fix: 修复模块未定义问题
191
- - chore: 更新依赖项 (music-metadata: ^11.11.1 -> ^11.11.2, ansi-escapes: ^7.2.0 -> ^7.3.0, commander: ^14.0.2 -> ^14.0.3)
192
- - chore: 更新GitHub Actions (checkout: v4 -> v6, setup-node: v4 -> v6, upload-artifact: v4 -> v6, download-artifact: v4 -> v7, github-script: v7 -> v8)
193
- - refactor: 注释掉IP地址日志输出以提升隐私保护
213
+ - 要贡献新接口, 请参考[这篇文章](https://www.focalors.ltd/post/how-to-contribute-ncm-api)
194
214
 
195
215
  ### 致谢
196
216
 
@@ -208,11 +228,12 @@ pnpm test
208
228
 
209
229
  ### SDK 生态
210
230
 
211
- | 语言 | 作者 | 地址 | 类型 |
212
- | ------ | ------------------------------------------- | ---------------------------------------------------------------------------------------- | ------ |
231
+ | 语言 | 作者 | 地址 | 类型 |
232
+ |--------|---------------------------------------------|------------------------------------------------------------------------------------------|-----|
213
233
  | Java | [JackuXL](https://github.com/JackuXL) | [NeteaseCloudMusicApi-SDK](https://github.com/JackuXL/NeteaseCloudMusicApi-SDK) | 第三方 |
214
234
  | Java | [1015770492](https://github.com/1015770492) | https://github.com/1015770492/yumbo-music-utils | 第三方 |
215
- | Python | [盧瞳](https://github.com/2061360308) | [NeteaseCloudMusic_PythonSDK](https://github.com/2061360308/NeteaseCloudMusic_PythonSDK) | 第三方 |
235
+ | Python | [盧瞳](https://github.com/2061360308) | [NeteaseCloudMusic_PythonSDK](https://github.com/2061360308/NeteaseCloudMusic_PythonSDK) | 第三方 |
236
+ | Swift | [Lincb522](https://github.com/Lincb522) | [NeteaseCloudMusicApi-Swift](https://github.com/Lincb522/NeteaseCloudMusicAPI-Swift) | 第三方 |
216
237
 
217
238
 
218
239
  ### 依赖此项目的优秀开源项目
@@ -221,6 +242,10 @@ pnpm test
221
242
 
222
243
  - [qier2222/YesPlayMusic](https://github.com/qier222/YesPlayMusic)
223
244
 
245
+ - [MaigoLabs/amaoke.app](https://github.com/MaigoLabs/amaoke.app)
246
+
247
+ - [Yueby/music-together](https://github.com/Yueby/music-together)
248
+
224
249
  ## License
225
250
 
226
251
  [MIT License](https://github.com/MoeFurina/NeteaseCloudMusicApiEnhanced/blob/main/LICENSE)