@neteasecloudmusicapienhanced/api 4.29.20 → 4.30.0

package/README.MD

@@ -6,11 +6,20 @@
 
 本项目为网易云音乐第三方 Node.js API，基于停更的原版 API 持续维护，支持丰富的音乐相关接口，适合自建服务、二次开发和多平台部署(如果原版诈尸, 我会及时同步 or 归档)。
 
+> [!IMPORTANT]
+>
+> ## 注意
+>
+> - 本项目是一个高度去中心化的第三方 API，其维护都由社区志愿者使用`Pull Request`完成。   
+> - 使用本项目时请务必遵守相关法律法规，遵守`MIT`协议, 尊重网易云音乐的服务条款。   
+> - 原作者项目 [Binaryify/NeteaseCloudMusicApi](https://github.com/binaryify/NeteaseCloudMusicApi) 并非完全停止维护, 你可以在 [NeteaseCloudMusicApi 的 NPMJS 页面](https://www.npmjs.com/package/NeteaseCloudMusicApi) 查看最新版本信息。   
+> - 感谢尊重和理解!
+
 ## 快速开始
 
 ### 环境要求
 
-- Node.js 14 及以上
+- Node.js 18 及以上
 - 推荐使用 pnpm 进行依赖管理
 
 ### 安装
@@ -51,31 +60,43 @@ set PORT=4000 && node app.js  # Windows
 
 本项目支持通过 Docker 一键部署，无需手动安装 Node.js 或依赖。
 
-### 1. 拉取镜像
+> 注意: 在 docker 中运行的时候, 由于使用了 request 来发请求, 所以会检查几个 proxy 相关的环境变量(如下所列), 这些环境变量 会影响到 request 的代理, 详情请参考[request 的文档](https://github.com/request/request#proxies), 如果这些环境变量 指向的代理不可用, 那么就会造成错误, 所以在使用 docker 的时候一定要注意这些环境变量. 不过, 要是你在 query 中加上了 proxy 参数, 那么环境变量会被覆盖, 就会用你通过 proxy 参数提供的代理了.
 
-从 Docker Hub 拉取最新版本镜像：
+request 相关的环境变量
 
-```bash
+1. http_proxy
+2. https_proxy
+3. HTTP_PROXY
+4. HTTPS_PROXY
+5. no_proxy
+6. NO_PROXY
+
+```shell
 docker pull moefurina/ncm-api:latest
-```
 
-或指定版本（与 package.json 中版本号一致）：
+docker run -d -p 3000:3000 --name ncm-api moefurina/ncm-api:latest
 
-```bash
-docker pull moefurina/ncm-api:4.29.0
 
-```
+// 或者
+docker run -d -p 3000:3000 moefurina/ncm-api:latest
 
-### 2. 运行容器
+// 去掉或者设置相关的环境变量
 
-```bash
-docker run -d \
-  --name ncm-api \
-  -p 3000:3000 \
-  moefurina/ncm-api:latest
+docker run -d -p 3000:3000 --name ncm-api -e http_proxy= -e https_proxy= -e no_proxy= -e HTTP_PROXY= -e HTTPS_PROXY= -e NO_PROXY= moefurina/ncm-api:latest
+
+// 或者
+docker run -d -p 3000:3000 -e http_proxy= -e https_proxy= -e no_proxy= -e HTTP_PROXY= -e HTTPS_PROXY= -e NO_PROXY= moefurina/ncm-api:latest
 ```
 
-运行后访问 http://localhost:3000 即可使用 API。
+> 以下是自行 build docker 镜像方式
+
+```shell
+$ git clone https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced && cd api-enhanced
+
+$ sudo docker build . -t ncm-api
+
+$ sudo docker run -d -p 3000:3000 ncm-api
+```
 
 ## 3. 环境变量
 
@@ -162,6 +183,15 @@ pnpm test
 
 - 欢迎提交 PR、Issue 参与维护
 
+## 最近更新日志
+### 4.30.0 | 2026.02.06
+- feat: 新增音乐人黑胶会员任务接口 `/musician/vip/tasks` (#95)
+- feat: 自动构建: 添加Windows、Linux、macOS预编译二进制文件 (#88)
+- fix: 修复模块未定义问题
+- chore: 更新依赖项 (music-metadata: ^11.11.1 -> ^11.11.2, ansi-escapes: ^7.2.0 -> ^7.3.0, commander: ^14.0.2 -> ^14.0.3)
+- chore: 更新GitHub Actions (checkout: v4 -> v6, setup-node: v4 -> v6, upload-artifact: v4 -> v6, download-artifact: v4 -> v7, github-script: v7 -> v8)
+- refactor: 注释掉IP地址日志输出以提升隐私保护
+
 ### 致谢
 
 原作者 [Binaryify/NeteaseCloudMusicApi](https://github.com/binaryify/NeteaseCloudMusicApi) 项目为本项目基础 (该项目在`npmjs`网站上仍持续维护, 但 github 仓库已不再更新)

package/interface.d.ts

@@ -1715,6 +1715,8 @@ export function nickname_check(
 
 export function musician_tasks_new(params: RequestBaseConfig): Promise<Response>
 
+export function musician_vip_tasks(params: RequestBaseConfig): Promise<Response>
+
 export function playlist_update_playcount(
   params: {
     id?: number | string

package/module/musician_vip_tasks.js

@@ -0,0 +1,11 @@
+// 获取音乐人任务
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {}
+  return request(
+    `/api/nmusician/workbench/special/right/vip/info`,
+    data,
+    createOption(query, 'eapi'),
+  )
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@neteasecloudmusicapienhanced/api",
-  "version": "4.29.20",
-  "description": "A revival project for NeteaseCloudMusicApi Node.js Services (Half Refactor & Enhanced)|| 网易云音乐 API 备份 + 增强 || 本项目自原版v4.28.0版本后开始自行维护",
+  "version": "4.30.0",
+  "description": "全网最全的网易云音乐API接口 || A revival project for NeteaseCloudMusicApi Node.js Services (Half Refactor & Enhanced) || 网易云音乐 API 备份 + 增强 || 本项目自原版v4.28.0版本后开始自行维护",
   "scripts": {
     "dev": "nodemon app.js",
     "start": "node app.js",
@@ -9,9 +9,9 @@
     "lint": "eslint \"**/*.{js,ts}\"",
     "lint-fix": "eslint --fix \"**/*.{js,ts}\"",
     "prepare": "husky install",
-    "pkgwin": "pkg . -t node18-win-x64 -C GZip -o bin/app --no-bytecode",
-    "pkglinux": "pkg . -t node18-linux-x64 -C GZip -o bin/app --no-bytecode",
-    "pkgmacos": "pkg . -t node18-macos-x64 -C GZip -o bin/app --no-bytecode"
+    "pkgwin": "pkg . -t node18-win-x64 -C GZip -o precompiled/app",
+    "pkglinux": "pkg . -t node18-linux-x64 -C GZip -o precompiled/app",
+    "pkgmacos": "pkg . -t node18-macos-x64 -C GZip -o precompiled/app"
   },
   "bin": "./app.js",
   "pkg": {
@@ -66,14 +66,14 @@
     "data"
   ],
   "dependencies": {
-    "@neteasecloudmusicapienhanced/unblockmusic-utils": "^0.1.3",
-    "axios": "^1.13.2",
+    "@neteasecloudmusicapienhanced/unblockmusic-utils": "^0.2.2",
+    "axios": "^1.13.5",
     "crypto-js": "^4.2.0",
-    "dotenv": "^17.2.3",
+    "dotenv": "^17.2.4",
     "express": "^5.2.1",
     "express-fileupload": "^1.5.2",
     "md5": "^2.3.0",
-    "music-metadata": "^11.10.3",
+    "music-metadata": "^11.12.0",
     "node-forge": "^1.3.3",
     "pac-proxy-agent": "^7.2.0",
     "qrcode": "^1.5.4",
@@ -88,22 +88,22 @@
     "@types/express": "^5.0.6",
     "@types/express-fileupload": "^1.5.1",
     "@types/mocha": "^10.0.10",
-    "@types/node": "24.10.0",
-    "@typescript-eslint/eslint-plugin": "8.46.2",
-    "@typescript-eslint/parser": "8.46.3",
+    "@types/node": "25.0.9",
+    "@typescript-eslint/eslint-plugin": "8.46.3",
+    "@typescript-eslint/parser": "8.53.0",
     "eslint": "9.39.0",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-html": "8.1.3",
-    "eslint-plugin-prettier": "5.5.4",
+    "eslint-plugin-prettier": "5.5.5",
     "globals": "^16.5.0",
     "husky": "9.1.7",
     "intelli-espower-loader": "1.1.0",
-    "lint-staged": "16.2.6",
+    "lint-staged": "16.2.7",
     "mocha": "11.7.5",
     "nodemon": "^3.1.11",
     "pkg": "^5.8.1",
     "power-assert": "1.6.1",
-    "prettier": "3.6.2",
+    "prettier": "3.7.4",
     "typescript": "5.9.3"
   }
 }

package/public/api.html

@@ -5,82 +5,148 @@
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>API 调试界面</title>
 <style>
+    * {
+      margin: 0;
+      padding: 0;
+      box-sizing: border-box;
+    }
+
     body {
-        font-family: Arial, sans-serif;
-        margin: 20px;
-        display: flex;
-        flex-direction: column;
-        min-height: 100vh;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      min-height: 100vh;
+      background: #f5f5f5;
+      padding: 20px;
     }
+
     .container {
-        display: flex;
-        flex-direction: column;
-        flex-grow: 1;
+      max-width: 1200px;
+      margin: 0 auto;
+      background: white;
+      border-radius: 12px;
+      padding: 32px;
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
     }
+
+    h1 {
+      font-size: 24px;
+      font-weight: 600;
+      color: #333;
+      margin-bottom: 24px;
+    }
+
     form {
-        display: flex;
-        flex-direction: row;
-        align-items: center;
-        gap: 10px;
-        margin-bottom: 10px;
+      display: flex;
+      flex-direction: column;
+      gap: 16px;
+      margin-bottom: 24px;
+    }
+
+    .form-row {
+      display: flex;
+      gap: 12px;
+      align-items: center;
+    }
+
+    label {
+      font-size: 14px;
+      font-weight: 500;
+      color: #555;
+      min-width: 80px;
+    }
+
+    input, select {
+      padding: 10px 14px;
+      border: 1px solid #ddd;
+      border-radius: 6px;
+      font-size: 14px;
+      flex: 1;
+      outline: none;
     }
-    input, button {
-        padding: 10px;
-        box-sizing: border-box;
-        flex: 1;
+
+    input:focus, select:focus {
+      border-color: #333;
     }
+
     button {
-        background-color: #4CAF50;
-        color: white;
-        border: none;
-        cursor: pointer;
+      background: #333;
+      color: white;
+      padding: 10px 24px;
+      border: none;
+      border-radius: 6px;
+      font-size: 14px;
+      font-weight: 500;
+      cursor: pointer;
+      transition: background 0.2s ease;
+    }
+
+    button:hover {
+      background: #555;
     }
+
     .data-result {
-        display: flex;
-        flex-direction: row;
-        flex-grow: 1;
+      display: flex;
+      gap: 16px;
+      min-height: 400px;
     }
+
     .data-result > div {
-        display: flex;
-        flex-direction: column;
-        flex-grow: 1;
-        padding: 10px;
-        box-sizing: border-box;
+      flex: 1;
+      display: flex;
+      flex-direction: column;
     }
+
     .data-result label {
-        margin-bottom: 10px;
+      margin-bottom: 8px;
+      padding: 0;
     }
-    #data, #result {
-        height: 100%;
-        box-sizing: border-box;
+
+    textarea {
+      flex: 1;
+      padding: 12px;
+      border: 1px solid #ddd;
+      border-radius: 6px;
+      font-family: 'Courier New', monospace;
+      font-size: 13px;
+      resize: vertical;
+      min-height: 350px;
+      outline: none;
     }
-    #data {
-        border-right: 1px solid #ccc;
+
+    textarea:focus {
+      border-color: #333;
     }
 </style>
 </head>
 <body>
     <div class="container">
+        <h1>API 调试界面</h1>
         <form onsubmit="event.preventDefault(); sendRequest();">
-            <label for="uri">uri</label>
-            <input type="text" id="uri" name="uri" value="/api/song/lyric/v1">
-            <label for="crypto">crypto</label>
-            <select id="crypto" name="crypto">
-                <option value="weapi">weapi</option>
-                <option value="eapi">eapi</option>
-                <option value="api">api</option>
-                <option value="linuxapi">linuxapi</option>
-                <option value="" selected>(默认)</option>
-            </select>
-            <button type="submit">发送</button>
+            <div class="form-row">
+                <label for="uri">URI</label>
+                <input type="text" id="uri" name="uri" value="/api/song/lyric/v1">
+            </div>
+            <div class="form-row">
+                <label for="crypto">加密方式</label>
+                <select id="crypto" name="crypto">
+                    <option value="weapi">weapi</option>
+                    <option value="eapi">eapi</option>
+                    <option value="api">api</option>
+                    <option value="linuxapi">linuxapi</option>
+                    <option value="" selected>(默认)</option>
+                </select>
+            </div>
+            <div class="form-row">
+                <label></label>
+                <button type="submit">发送请求</button>
+            </div>
         </form>
         <div class="data-result">
             <div>
-                <label for="result">result</label>
-                <textarea id="result" name="result"></textarea>
+                <label for="result">响应结果</label>
+                <textarea id="result" name="result" readonly></textarea>
             </div>
             <div>
-                <label for="data">data</label>
+                <label for="data">请求数据</label>
                 <textarea id="data" name="data">
 {
     "cp": false,

package/public/audio_match_demo/afp.js

@@ -1,6 +1,5 @@
 'use strict'
 const WASM_BINARY_PLACEHOLDER = 'WASM_BINARY_PLACEHOLDER';
-const logger = require('../../util/logger.js')
 // See https://github.com/Distributive-Network/PythonMonkey/issues/266
 if (typeof globalThis.setInterval != 'function'){
     globalThis.setInterval = function pm$$setInterval(fn, timeout) {
@@ -1612,9 +1611,9 @@ function instantiateRuntime(){
 
 function GenerateFP(floatArray) {
     let PCMBuffer = Float32Array.from(floatArray)
-    logger.info('[afp] input samples n=', PCMBuffer.length)    
+    console.info('[afp] input samples n=', PCMBuffer.length)    
     return instantiateRuntime().then((fpRuntime) => {
-        logger.info('[afp] begin fingerprinting')
+        console.info('[afp] begin fingerprinting')
         let fp_vector = fpRuntime.ExtractQueryFP(PCMBuffer.buffer)        
         let result_buf = new Uint8Array(fp_vector.size());
         for (let t = 0; t < fp_vector.size(); t++)