bump 5.0.0

.github/workflows/build-dev.yml

@@ -14,15 +14,15 @@ jobs:
         include:
           - os: ubuntu-latest
             platform: linux
-            target: node18-linux-x64
+            target: node22-linux-x64
             output: precompiled/app
           - os: windows-latest
             platform: win
-            target: node18-win-x64
+            target: node22-win-x64
             output: precompiled/app.exe
           - os: macos-latest
             platform: macos
-            target: node18-macos-x64
+            target: node22-macos-x64
             output: precompiled/app
 
     steps:
@@ -32,7 +32,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '18'
+          node-version: '24'
 
       - name: Setup pnpm
         run: npm install -g pnpm@9

.github/workflows/ci-check.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [18, 22, 24]
+        node-version: [22, 24]
     steps:
       - uses: actions/checkout@v6
 

.github/workflows/release-on-version-change.yml

@@ -78,17 +78,17 @@ jobs:
         include:
           - os: ubuntu-latest
             platform: linux
-            target: node18-linux-x64
+            target: node22-linux-x64
             output: ncm-api-linux-x64
 
           - os: windows-latest
             platform: windows
-            target: node18-win-x64
+            target: node22-win-x64
             output: ncm-api-win-x64.exe
 
           - os: macos-latest
             platform: macos
-            target: node18-macos-x64
+            target: node22-macos-x64
             output: ncm-api-macos-x64
 
     steps:

AGENTS.md

@@ -2,7 +2,7 @@
 
 ## 快速开始
 - **包管理器**：开发与 CI 使用 `pnpm`，`Dockerfile` 也用 pnpm（`pnpm@9 --frozen-lockfile`，匹配 `pnpm-lock.yaml`）。仓库没有 `yarn.lock`，不要引入 yarn。
-- **Node 版本**：README 推荐 Node 22+；`package.json` 的 `engines` 声明 `>=12`；CI/打包在 Node 18–24 上运行。现代 Node 均可。
+- **Node 版本**：`package.json` 的 `engines` 声明 `>=22`；CI/打包在 Node 22–24 上运行。现代 Node 均可。
 - **环境变量**：`server.js` 调用了 `dotenv.config()`，本地 `.env` 会被自动加载；所有支持的变量见 `.env.prod.example`。
 
 ## 常用命令
@@ -11,7 +11,7 @@
 - 跑测试：`pnpm test`（Mocha，超时 60s）
 - Lint：`pnpm lint`；自动修复：`pnpm lint-fix`
 - 文档格式化检查/修复：`pnpm docs:check` / `pnpm docs:format`
-- 打包独立二进制：`pnpm pkgwin` / `pkglinux` / `pkgmacos`
+- 打包独立二进制：`pnpm pkgwin` / `pkglinux` / `pkgmacos`（@yao-pkg/pkg，node22 目标，`--no-bytecode` + `--public` 规避 node22 bytecode 回归）
 
 ## 目录内非路由文件
 - `plugins/`——内部上传辅助（`upload.js`、`songUpload.js`），被 `module/*` require，本身不是路由。

README.MD

@@ -163,7 +163,7 @@ docker run -d -p 3000:3000 moefurina/ncm-api:latest
    ```bash
    #!/bin/bash
    export PORT=9000
-   /var/lang/node16/bin/node app.js
+   /var/lang/node22/bin/node app.js
    ```
 4. 完成部署后，访问 API 网关的 URL 即可
 

app.js

@@ -3,6 +3,17 @@ const fs = require('fs')
 const path = require('path')
 const tmpPath = require('os').tmpdir()
 
+// engines 字段只在 npm/pnpm 安装时生效，直接 node app.js 不会被拦截，
+// 这里给出友好的最低版本检查（>=22，与 package.json engines 保持一致）
+const [major] = process.versions.node.split('.').map(Number)
+if (major < 22) {
+  console.error(
+    `[${new Date().toLocaleString()}] Node.js >= 22 is required (current: ${process.versions.node}). ` +
+      '请升级 Node.js 后重试 / Please upgrade Node.js to v22 or newer.',
+  )
+  process.exit(1)
+}
+
 async function start() {
   // 检测是否存在 anonymous_token 文件,没有则生成
   if (!fs.existsSync(path.resolve(tmpPath, 'anonymous_token'))) {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neteasecloudmusicapienhanced/api",
-  "version": "4.41.1",
+  "version": "5.0.0",
   "description": "全网最全的网易云音乐API接口 || A revival project for NeteaseCloudMusicApi Node.js Services (Half Refactor & Enhanced)",
   "scripts": {
     "dev": "nodemon app.js",
@@ -11,9 +11,9 @@
     "prepare": "husky install",
     "docs:format": "node scripts/format-docs.js",
     "docs:check": "node scripts/format-docs.js --check",
-    "pkgwin": "node scripts/build-pkg.js . -t node18-win-x64 -C GZip -o precompiled/app",
-    "pkglinux": "node scripts/build-pkg.js . -t node18-linux-x64 -C GZip -o precompiled/app",
-    "pkgmacos": "node scripts/build-pkg.js . -t node18-macos-x64 -C GZip -o precompiled/app"
+    "pkgwin": "node scripts/build-pkg.js . -t node22-win-x64 -C GZip -o precompiled/app --no-bytecode --public-packages \"*\" --public",
+    "pkglinux": "node scripts/build-pkg.js . -t node22-linux-x64 -C GZip -o precompiled/app --no-bytecode --public-packages \"*\" --public",
+    "pkgmacos": "node scripts/build-pkg.js . -t node22-macos-x64 -C GZip -o precompiled/app --no-bytecode --public-packages \"*\" --public"
   },
   "bin": "./app.js",
   "pkg": {
@@ -52,7 +52,7 @@
   },
   "homepage": "https://neteasecloudmusicapienhanced.js.org/",
   "engines": {
-    "node": ">=12"
+    "node": ">=22"
   },
   "lint-staged": {
     "*.js": [
@@ -110,9 +110,9 @@
     "husky": "^9.1.7",
     "intelli-espower-loader": "^1.1.0",
     "lint-staged": "^16.4.0",
-    "mocha": "^12.0.3",
+    "mocha": "^11.8.0",
     "nodemon": "^3.1.14",
-    "pkg": "^5.8.1",
+    "@yao-pkg/pkg": "^6.23.0",
     "power-assert": "^1.6.1",
     "prettier": "^3.9.9",
     "typescript": "^5.9.3"

public/docs/home.md

@@ -5932,7 +5932,7 @@ let data = encodeURIComponent(
 
 **调用例子 :** `/fans/group/feed/recommend?fansGroupId=1872529203038486609&size=10&cursor=0`
 
-## 每日指定风格歌曲推荐
+### 每日指定风格歌曲推荐
 
 说明 : 调用此接口 , 可获取每日指定风格歌曲推荐
 
@@ -5940,7 +5940,7 @@ let data = encodeURIComponent(
 
 **调用例子 :** `/recommend/category/songs`
 
-## 获取每日指定风格歌曲推荐的风格列表
+### 获取每日指定风格歌曲推荐的风格列表
 
 说明 : 调用此接口 , 可获取每日指定风格歌曲推荐的风格列表
 
@@ -5948,7 +5948,7 @@ let data = encodeURIComponent(
 
 **调用例子 :** `/recommend/category/configs`
 
-## 设置每日指定风格歌曲推荐的风格
+### 设置每日指定风格歌曲推荐的风格
 
 说明 : 调用此接口 , 可设置每日指定风格歌曲推荐的风格
 

scripts/build-pkg.js

@@ -1,10 +1,10 @@
 /**
  * Invoke the pkg packager (cross-platform, independent of node_modules layout).
  *
- * Background: on Windows, pnpm links node_modules/pkg to
- * node_modules/.pnpm/pkg@<ver>/node_modules/pkg via a junction. Some CI
- * environments (pnpm 11 + Windows runner) may fail to create that link,
- * so executing node_modules/pkg/lib-es5/bin.js directly throws
+ * Background: on Windows, pnpm links node_modules/@yao-pkg/pkg to
+ * node_modules/.pnpm/@yao-pkg+pkg@<ver>/node_modules/@yao-pkg/pkg via a junction.
+ * Some CI environments (pnpm 11 + Windows runner) may fail to create that link,
+ * so executing node_modules/@yao-pkg/pkg/lib-es5/bin.js directly throws
  * MODULE_NOT_FOUND.
  *
  * This script first resolves pkg via require.resolve and falls back to
@@ -17,16 +17,24 @@ const path = require('path')
 
 function resolvePkgBin() {
   try {
-    return require.resolve('pkg/lib-es5/bin.js')
+    return require.resolve('@yao-pkg/pkg/lib-es5/bin.js')
   } catch (err) {
-    // require.resolve failed (e.g. missing node_modules/pkg link): scan .pnpm
+    // require.resolve failed (e.g. missing node_modules/@yao-pkg/pkg link): scan .pnpm
     const pnpmDir = path.join(process.cwd(), 'node_modules', '.pnpm')
     if (fs.existsSync(pnpmDir)) {
       const candidates = fs
         .readdirSync(pnpmDir)
-        .filter((dir) => dir.startsWith('pkg@'))
+        .filter((dir) => dir.startsWith('@yao-pkg+pkg@'))
         .map((dir) =>
-          path.join(pnpmDir, dir, 'node_modules', 'pkg', 'lib-es5', 'bin.js'),
+          path.join(
+            pnpmDir,
+            dir,
+            'node_modules',
+            '@yao-pkg',
+            'pkg',
+            'lib-es5',
+            'bin.js',
+          ),
         )
         .filter((file) => fs.existsSync(file))
       if (candidates.length) {