docs: 修改运行要求

feat(artist): 添加关注歌手新歌播放全部&新作品接口

.dockerignore

@@ -7,8 +7,9 @@
 !/app.js
 !/server.js
 !/package.json
-!/package-lock.json
 !/index.js
 !/generateConfig.js
 !/main.js
 !/data
+!/.env
+!/pnpm-lock.yaml

.env.prod.example

@@ -8,31 +8,20 @@ ENABLE_PROXY = false
 ## 代理配置
 PROXY_URL = "https://your-proxy-url.com/?proxy="
 
+### 随机IP设置
+## 启用随机中国IP（默认关闭）；启用后，所有请求默认使用随机中国IP，除非请求参数randomCNIP显式关闭
+ENABLE_RANDOM_CN_IP = false
 
 ### UnblockNeteaseMusic 设置项
-## 启用全局解灰, 无论是否调用参数都会使用解灰(推荐开启)
+## 启用全局解灰, 无论是否调用参数都会使用解灰(不推荐开启)
-ENABLE_GENERAL_UNBLOCK = true
+ENABLE_GENERAL_UNBLOCK = false
 ## 歌曲启用无损音质
 ENABLE_FLAC = true
 ## 启用无损音质时，是否选择音质最高的
-SELECT_MAX_BR = true
+SELECT_MAX_BR = false
-## 音源设置
-UNBLOCK_SOURCE = pyncmd,qq,kuwo,migu,kugou
 ## 严格按照配置音源设置顺序进行匹配
 FOLLOW_SOURCE_ORDER = true
 ## Cookie设置项; 推荐在Vercel等平台进行环境变量的设置或者设置github secret
 # 网易云 cookie
 # 格式：MUSIC_U=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-NETEASE_COOKIE = ""
+# NETEASE_COOKIE = ""
-# JOOX cookie
-# 格式：JOOX_COOKIE="wmid=<your_wmid>; session_key=<your_session_key>"
-JOOX_COOKIE = ""
-# 咪咕 cookie
-# 格式：MIGU_COOKIE="<your_aversionid>"
-MIGU_COOKIE = ""
-# qq cookie
-# 格式：QQ_COOKIE="uin=<your_uin>; qm_keyst=<your_qm_keyst>"
-QQ_COOKIE = ""
-# Youtube 密钥
-# 格式：YOUTUBE_KEY="<your_data_api_key>"
-YOUTUBE_KEY = ""

.eslintrc.js

@@ -1,57 +0,0 @@
-module.exports = {
-  root: true,
-
-  ignorePatterns: ['public/'],
-  parserOptions: {
-    parser: 'babel-eslint',
-    ecmaVersion: 2018,
-    sourceType: 'module',
-  },
-  plugins: ['html'],
-  extends: ['plugin:prettier/recommended'],
-  env: {
-    browser: true,
-    node: true,
-  },
-
-  rules: {
-    'prettier/prettier': [
-      'error',
-      {
-        endOfLine: 'auto',
-      },
-    ],
-    indent: ['error', 2, { SwitchCase: 1 }],
-    'space-infix-ops': ['error', { int32Hint: false }],
-    'key-spacing': [
-      2,
-      {
-        beforeColon: false,
-        afterColon: true,
-      },
-    ],
-    'no-octal': 2,
-    'no-redeclare': 2,
-    'comma-spacing': 2,
-    'no-new-object': 2,
-    'arrow-spacing': 2,
-    quotes: [
-      2,
-      'single',
-      {
-        avoidEscape: true,
-        allowTemplateLiterals: true,
-      },
-    ],
-  },
-  overrides: [
-    {
-      files: ['**/*.ts'],
-      parser: '@typescript-eslint/parser',
-      extends: [
-        'plugin:@typescript-eslint/recommended', // Uses the recommended rules from the @typescript-eslint/eslint-plugin
-        // 'prettier/@typescript-eslint',
-      ],
-    },
-  ],
-}

.github/FUNDING.yml

@@ -0,0 +1 @@
+custom: ["https://rewards.focalors.ltd"]

.github/ISSUE_TEMPLATE/------.md

@@ -1,45 +0,0 @@
----
-name: 创建问题反馈
-about: 问题反馈
-title: "<不按照模版格式或者删除模版信息将得不到处理,确认看完了调用前须知再发 issues>"
-labels: ''
-assignees: ''
-
----
-
-## 环境
-- 系统/平台: <你的系统和平台>
-
-- nodejs 版本: <你的 NodeJS 版本号>
-
-- API版本: <运行的云音乐 API 的版本号， 对应 package.json 里面的 version>
-
-## 出现问题
-<请清晰描述出现的问题,不要使用xxx不行之类的模糊不清的语句,我没有读心术>
-
-## 重现步骤
-<请清晰描述重现步骤，调用的接口链接和参数以及命令行错误信息,最好贴上截图(命令行错误信息和接口返回内容)>
-
-## 期待效果
-<请清晰描述现在的效果和期待的效果>  
-
-
-
----
-
->注意: 如果解灰出现问题, 本项目只是集成[UnblockNeteaseMusic](https://github.com/UnblockNeteaseMusic/server)的接口, 请在对应的仓库开启议题
-
->维护项目都是业余时间,精力有限,我只能挑容易解决的issues处理,为了节约双方时间,请尽可能提供足够的有用的信息,给的信息不够我只能根据精力和时间看情况处理,如果模板信息看都不看就删掉,我不会进行任何回复,并且一个月后close掉issue
-
->先看文档有没有相关说明,调用前须知必看,确认看完了调用前须知再发 issues
-
->先在 issues 搜一下是否有相似问题，没有再发,否则直接关闭
-
->不处理别人搭建的线上服务的问题,此项目提供任何线上服务不保证质量,请自行搭建
-
->重现步骤尽量详细,不能含糊不清，包含请求地址和对应参数以及操作过程描述,不是每个人都喜欢猜别人遇到了什么问题和找参数一个个试,也比较浪费时间
-
->如果不是提建议,提 issues 如果不照着模版来将不会优先处理或放着不管
-
->460 cheating 的问题把 `utils/request.js` 里面的 `headers['X-Real-IP']` 的注释取消掉就好
-

.github/ISSUE_TEMPLATE/----.md

@@ -1,11 +0,0 @@
----
-name: 功能需求
-about: 希望添加新接口
-title: ''
-labels: 功能需求
-assignees: ''
-
----
-
-**功能描述**
-- 请清晰描述你所希望添加的功能，最好贴上对应客户端界面的截图

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,117 @@
+name: 🐛 Bug报告
+description: 报告API其中的错误或问题
+title: "[Bug] "
+labels: ["bug"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢您报告Bug！请填写以下信息帮助我们快速定位和修复问题。
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: 确认事项
+      description: |
+        在提交Bug报告前，请确认以下事项：
+
+        - 我已经搜索了现有的issues，确认这不是重复问题
+        - 我使用的是最新版本的API, 而且是官方发布的版本，而不是fork或修改版
+        - 不处理别人搭建的线上服务的问题,此项目提供任何线上服务不保证质量
+        - 如果不是提建议,提 issues 如果不照着模版来将不会优先处理或放着不管
+        - 维护项目都是业余时间,精力有限,我只能挑容易解决的issues处理,为了节约双方时间,请尽可能提供足够的有用的信息,给的信息不够我只能根据精力和时间看情况处理,如果模板信息看都不看就删掉,我不会进行任何回复,并且一个月后close掉issue
+
+      options:
+        - label: 我已确认以上事项
+          required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: API版本
+      description: 请提供您使用的API版本以及nodejs版本
+      placeholder: "v4.2x.x, Node.js v22.x.x"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: deployment
+    attributes:
+      label: 部署方式
+      description: 此项目支持本地部署和云平台部署，您使用的是哪种方式？
+      options:
+        - 本机直接运行 (node / pm2)
+        - 本机 Docker 部署
+        - Vercel
+        - Heroku
+        - Railway
+        - 其他云平台 (请在描述中说明)
+    validations:
+      required: true
+
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: Bug描述
+      description: 请详细描述您遇到的问题
+      placeholder: |
+        清晰简洁地描述bug的具体表现...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction-steps
+    attributes:
+      label: 重现步骤
+      description: 请提供详细的重现步骤
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: 期望行为
+      description: 请描述您期望发生的行为
+      placeholder: 清晰简洁地描述您期望应该发生什么...
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: 实际行为
+      description: 请描述实际发生的行为
+      placeholder: 清晰简洁地描述实际发生了什么...
+    validations:
+      required: true
+
+  - type: textarea
+    id: error-output
+    attributes:
+      label: 错误输出日志
+      description: 请提供完整的错误信息日志
+      render: shell
+      placeholder: |
+        错误信息输出...
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: 额外信息
+      description: 添加任何其他有助于理解问题的信息
+      placeholder: |
+        - 截图
+        - 相关配置文件
+        - 其他相关信息
+
+  - type: checkboxes
+    id: help
+    attributes:
+      label: 愿意协助
+      description: 您是否愿意帮助修复这个bug？
+      options:
+        - label: 我愿意提交PR来修复这个bug
+        - label: 我可以提供更多测试用例
+        - label: 我可以帮助测试修复方案

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: ↑请尽量使用议题模板创建议题↑
+    url: https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced/issues/new/choose
+    about: 选择适合的议题模板可以帮助我们更快地定位和解决问题
+  - name: 提问的艺术
+    url: https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/main/README-zh_CN.md
+    about: 默认所有 Issues 发起者均已了解此处的内容 

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,72 @@
+name: ✨ 接口添加请求
+description: 希望添加新接口
+title: "[Feature] "
+labels: ["enhancement"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢您提出新功能建议！请填写以下信息帮助我们理解您的需求。
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: 确认事项
+      description: 在提交功能请求前，请确认以下事项
+      options:
+        - label: 我已经搜索了现有的issues，确认这不是重复请求
+          required: true
+        - label: 我已经查看了项目文档
+          required: true
+        - label: 该项目符合该项目的目标和范围
+          required: true
+        - label: 我确认我提供的接口请求是合理且有意义的
+          required: true
+
+
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: 功能描述
+      description: 请详细描述您希望添加的功能，最好贴上对应客户端界面的截图
+      placeholder: |
+        请详细描述您期望的功能：
+        - 新的网易云音乐api 接口?
+    validations:
+      required: true
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: 优先级
+      description: 您认为这个功能的优先级如何？
+      options:
+        - 低 (可有可无的改进)
+        - 中 (会显著改善使用体验)
+        - 高 (严重影响了我使用)
+        - 紧急 (阻塞了重要工作)
+    validations:
+      required: true
+
+  - type: textarea
+    id: compatibility
+    attributes:
+      label: 兼容性考虑
+      description: 这个功能是否会影响现有代码的兼容性？
+      placeholder: |
+        - 是否是破坏性变更？
+        - 是否需要语法变更？
+        - 对性能的影响？
+
+  - type: checkboxes
+    id: implementation
+    attributes:
+      label: 实现意愿
+      description: 您是否愿意参与这个功能的实现？
+      options:
+        - label: 我愿意提交PR来实现这个功能
+        - label: 我可以协助设计API接口
+        - label: 我可以提供测试用例
+        - label: 我可以帮助编写文档

.github/dependabot.yml

@@ -0,0 +1,41 @@
+# .github/dependabot.yml
+
+version: 2
+updates:
+  # 更新 npm (JavaScript) 依赖
+  - package-ecosystem: "npm"
+    directory: "/" # package.json 所在的位置
+    schedule:
+      interval: "weekly" # 每周一检查
+    # 默认情况下，Dependabot 会自动获取最新版本。
+    # 你可以使用 `ignore` 来排除某些特定更新
+    ignore:
+      - dependency-name: "eslint"
+        # 对于 ESLint，忽略主版本 8 以上的所有更新
+        versions: ["> 8"]
+    # 自动合并小版本更新的 PR (可选)
+    # 可以设置针对 patch 或 minor 版本更新自动合并
+    commit-message:
+      prefix: "build(packages):" # PR 合并提交信息的前缀
+
+  # 更新 GitHub Actions 依赖
+  - package-ecosystem: "github-actions"
+    directory: "/" # .github/workflows/ 目录所在的位置
+    schedule:
+      interval: "monthly"
+
+  # 更新 Python (pip) 依赖，如果你的项目有 requirements.txt
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  # 如果你有多个目录（例如一个 monorepo），可以为每个目录单独配置
+  # - package-ecosystem: "npm"
+  #   directory: "/packages/frontend"
+  #   schedule:
+  #     interval: "weekly"
+  # - package-ecosystem: "npm"
+  #   directory: "/packages/backend"
+  #   schedule:
+  #     interval: "weekly"

.github/workflows/Build_Image.yml

@@ -1,31 +0,0 @@
-name: Build Image
-
-on:
-  push:
-      tags:
-          - v*
-
-jobs:
-  build:
-      if: github.event.base_ref == 'refs/heads/main'
-      runs-on: ubuntu-latest
-      name: Build image job
-      
-      steps:
-          - name: Checkout main
-            uses: actions/checkout@v3
-          - name: Get version
-            id: get_version
-            if: startsWith(github.ref, 'refs/tags/') && startsWith(github.repository, 'Binaryify/ncm')
-            run: echo "VERSION=${GITHUB_REF/refs\/tags\//}" >> $GITHUB_OUTPUT
-          - name: Set up Docker Buildx
-            uses: docker/setup-buildx-action@v2
-          - name: Build and publish image
-            uses: elgohr/Publish-Docker-Github-Action@v5
-            if: startsWith(github.ref, 'refs/tags/') && startsWith(github.repository, 'Binaryify/ncm')
-            with:
-              name: binaryify/netease_cloud_music_api # dockerid/imageName
-              platforms: linux/arm64,linux/amd64 # 你准备构建的镜像平台
-              tags: latest,${{ steps.get_version.outputs.VERSION }}
-              username: ${{ secrets.DOCKER_USERNAME }} # docker hub userid 在setting创建secrets name=DOCKER_USERNAME  value=dockerid
-              password: ${{ secrets.DOCKER_PASSWORD }} # docker hub password,在setting创建secrets name=DOCKER_PASSWORD  value=dockerpassword

.github/workflows/build-dev.yml

@@ -0,0 +1,53 @@
+name: Build Artifacts
+
+on:
+  workflow_dispatch: # 手动触发
+  push:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        include:
+          - os: ubuntu-latest
+            platform: linux
+            target: node18-linux-x64
+            output: precompiled/app
+          - os: windows-latest
+            platform: win
+            target: node18-win-x64
+            output: precompiled/app.exe
+          - os: macos-latest
+            platform: macos
+            target: node18-macos-x64
+            output: precompiled/app
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: |
+          npm install -g pnpm
+          pnpm install
+
+      - name: Build for ${{ matrix.platform }}
+        run: |
+          npm run pkg${{ matrix.platform }}
+        env:
+          PKG_TARGET: ${{ matrix.target }}
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: app-${{ matrix.platform }}
+          path: ${{ matrix.output }}
+          if-no-files-found: error

.github/workflows/issue-manage.yml

@@ -0,0 +1,79 @@
+name: Issue Management
+permissions:
+  issues: write
+  contents: read
+
+on:
+  issues:
+    types: [opened, labeled]
+  issue_comment:
+    types: [created]
+
+jobs:
+  welcome-new-issues:
+    if: github.event.action == 'opened'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Welcome new issue
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            ## 快速链接
+
+            在我们处理您的问题之前，您可以先查看以下资源：
+
+            - 📖 查看[项目文档](https://neteasecloudmusicapienhanced.js.org)
+            - 💬 加入[QQ交流群](https://qm.qq.com/q/TpeP9Uv2yk) 
+            - 🔍 搜索[现有issues](https://github.com/neteasecloudmusicapienhanced/api-enhanced/issues) 看是否有类似问题
+
+  handle-help-wanted:
+    if: contains(github.event.issue.labels.*.name, 'question')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Add help resources
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          issue-number: ${{ github.event.issue.number }}
+          body: |
+            🆘 需要帮助？
+
+            这里有一些可能对您有用的资源：
+
+            📚 **文档资源**
+            - [项目文档](https://neteasecloudmusicapienhanced.js.org)
+
+            🔍 **常见问题**
+            - 搜索[已关闭的issues](https://github.com/neteasecloudmusicapienhanced/api-enhanced/issues?q=is%3Aissue+is%3Aclosed) 看看是否有类似的问题已经被解答。
+
+            💬 **即时帮助**
+            - 加入QQ群：https://qm.qq.com/q/TpeP9Uv2yk
+
+            如果以上资源无法解决您的问题，请提供更多详细信息，我们会尽快为您解答！
+
+  stale-issues:
+    if: github.event.action == 'opened'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Mark stale issues
+        uses: actions/stale@v10
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          stale-issue-message: |
+            这个issue已经30天没有活动了。
+
+            如果这个问题仍然存在，请回复此评论说明当前状态。
+            否则，这个issue将在7天后自动关闭。
+
+            您可以随时重新打开已关闭的issue。
+          stale-pr-message: |
+            这个PR已经30天没有活动了。
+
+            如果您仍在处理这个PR，请回复此评论。
+            否则，这个PR将在7天后自动关闭。
+          days-before-stale: 30
+          days-before-close: 7
+          stale-issue-label: "stale"
+          stale-pr-label: "stale"
+          exempt-issue-labels: "pinned,enhancement,priority:high,ongoing,fatal"
+          exempt-pr-labels: "pinned,priority:high,ongoing,fatal"

.github/workflows/node.js.yml

@@ -1,59 +0,0 @@
-name: Node.js CI
-
-on:
-  pull_request:
-    branches: [ main ]
-  push:
-    branches: [ main ]
-permissions:
-  contents: read
-
-jobs:
-  test:
-    name: Test
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [14.x, 16.x, 18.x ]
-    steps:
-    - uses: actions/checkout@v3
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v3
-      with:
-        node-version: ${{ matrix.node-version }}
-    - uses: actions/cache@v3
-      with:
-        path: ~/.npm
-        key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
-        restore-keys: |
-          ${{ runner.os }}-node-
-    - run: npm ci
-      name: Install dependencies
-    - name: Test
-      env:
-        NCM_API_TEST_LOGIN_COUNTRY_CODE: ${{ secrets.NCM_API_TEST_LOGIN_COUNTRY_CODE }}
-        NCM_API_TEST_LOGIN_PHONE: ${{ secrets.NCM_API_TEST_LOGIN_PHONE }}
-        NCM_API_TEST_LOGIN_PASSWORD: ${{ secrets.NCM_API_TEST_LOGIN_PASSWORD }}
-      run: npm test
-  lint:
-    name: Lint
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [14.x]
-    steps:
-    - uses: actions/checkout@v3
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v3
-      with:
-        node-version: ${{ matrix.node-version }}
-    - uses: actions/cache@v3
-      with:
-        path: ~/.npm
-        key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
-        restore-keys: |
-          ${{ runner.os }}-node-
-    - run: npm ci
-      name: Install dependencies
-    - name: Lint
-      run: npm run lint

.github/workflows/npm.yml

@@ -1,42 +0,0 @@
-# .github/workflows/release.yml
-name: Release
-
-on:
-  push:
-  workflow_dispatch:
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-    steps:
-      - uses: actions/checkout@v3
-
-      # 发布到 NPM Registry
-      - name: Setup Node.js for NPM
-        uses: actions/setup-node@v3
-        with:
-          node-version: 20
-          registry-url: 'https://registry.npmjs.org/'
-      - run: npm install
-      - name: Publish to NPM
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      # 发布到 GitHub Packages
-      - name: Setup Node.js for GitHub Packages
-        uses: actions/setup-node@v3
-        with:
-          node-version: 20
-          registry-url: 'https://npm.pkg.github.com'
-      - name: Update package name for GitHub Packages
-        run: |
-          json=`cat package.json`
-          echo "$json" | jq '.name = "@neteasecloudmusicapienhanced/api"' > package.json
-      - name: Publish to GitHub Packages
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ github.token }}

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

@@ -0,0 +1,315 @@
+name: Create Release on Version Change
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - package.json
+
+  workflow_dispatch:
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  detect:
+    name: Detect Version Change
+    runs-on: ubuntu-latest
+
+    outputs:
+      version: ${{ steps.version.outputs.value }}
+      should_release: ${{ steps.check.outputs.should_release }}
+      tag_exists: ${{ steps.tagcheck.outputs.exists }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Extract version from package.json
+        id: version
+        run: |
+          echo "value=$(jq -r .version package.json)" >> $GITHUB_OUTPUT
+
+      - name: Check if version changed
+        id: check
+        shell: bash
+        run: |
+          if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
+            echo "should_release=true" >> $GITHUB_OUTPUT
+            exit 0
+          fi
+
+          if git diff "${{ github.event.before }}" "${{ github.sha }}" -- package.json | grep -q '"version"'; then
+            echo "should_release=true" >> $GITHUB_OUTPUT
+          else
+            echo "should_release=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Check if tag already exists
+        id: tagcheck
+        shell: bash
+        run: |
+          VERSION="${{ steps.version.outputs.value }}"
+
+          if git rev-parse "v$VERSION" >/dev/null 2>&1; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+          fi
+
+  build:
+    name: Build ${{ matrix.platform }}
+    needs: detect
+
+    if: |
+      needs.detect.outputs.should_release == 'true' &&
+      needs.detect.outputs.tag_exists != 'true'
+
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+
+      matrix:
+        include:
+          - os: ubuntu-latest
+            platform: linux
+            target: node18-linux-x64
+            output: ncm-api-linux-x64
+
+          - os: windows-latest
+            platform: windows
+            target: node18-win-x64
+            output: ncm-api-win-x64.exe
+
+          - os: macos-latest
+            platform: macos
+            target: node18-macos-x64
+            output: ncm-api-macos-x64
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v6
+        with:
+          version: 9
+          
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+
+      
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build binary
+        shell: bash
+        env:
+          PKG_TARGET: ${{ matrix.target }}
+        run: |
+          mkdir -p release-artifacts
+
+          case "${{ matrix.platform }}" in
+            linux)
+              npm run pkglinux
+              mv precompiled/app "release-artifacts/${{ matrix.output }}"
+              ;;
+
+            windows)
+              npm run pkgwin
+              mv precompiled/app.exe "release-artifacts/${{ matrix.output }}"
+              ;;
+
+            macos)
+              npm run pkgmacos
+              mv precompiled/app "release-artifacts/${{ matrix.output }}"
+              ;;
+          esac
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: ${{ matrix.platform }}-binary
+          path: release-artifacts/*
+
+  release:
+    name: Create GitHub Release
+
+    needs:
+      - detect
+      - build
+
+    if: |
+      needs.detect.outputs.should_release == 'true' &&
+      needs.detect.outputs.tag_exists != 'true'
+
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Download build artifacts
+        uses: actions/download-artifact@v8
+        with:
+          path: release-artifacts
+          merge-multiple: true
+
+      - name: List flattened artifacts
+        shell: bash
+        run: |
+          mkdir -p final-artifacts
+          cp release-artifacts/* final-artifacts/
+          ls -lah final-artifacts
+
+      - name: Generate release notes
+        shell: bash
+        run: |
+          VERSION="${{ needs.detect.outputs.version }}"
+
+          PREV_TAG=$(git tag --sort=-v:refname | head -1)
+
+          {
+            echo "# Release v${VERSION}"
+            echo ""
+            echo "## 更新内容 / Changelog"
+            echo ""
+
+            if [ -n "$PREV_TAG" ]; then
+              echo "从 \`$PREV_TAG\` 到 \`v$VERSION\` 的提交记录："
+              echo ""
+
+              git log "$PREV_TAG..HEAD" \
+                --no-merges \
+                --pretty=format:"- %s (%h)"
+
+            else
+              echo "首次发布，包含以下提交："
+              echo ""
+
+              git log \
+                --no-merges \
+                --pretty=format:"- %s (%h)"
+            fi
+
+            echo ""
+            echo ""
+            echo "---"
+            echo "自动发布 via GitHub Actions"
+
+          } > release-notes.md
+
+          cat release-notes.md
+
+      - name: Create Git tag
+        run: |
+          git tag "v${{ needs.detect.outputs.version }}"
+          git push origin "v${{ needs.detect.outputs.version }}"
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ needs.detect.outputs.version }}
+          name: Release v${{ needs.detect.outputs.version }}
+          body_path: release-notes.md
+          files: final-artifacts/*
+          draft: false
+          prerelease: false
+
+  publish-docker:
+    name: Publish Docker Image
+    needs: detect
+
+    if: |
+      needs.detect.outputs.should_release == 'true' &&
+      needs.detect.outputs.tag_exists != 'true'
+
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Read package version
+        id: pkg
+        run: echo "VERSION=$(jq -r .version package.json)" >> $GITHUB_ENV
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v4
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v4
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          push: true
+          tags: |
+            moefurina/ncm-api:latest
+            moefurina/ncm-api:${{ env.VERSION }}
+            ghcr.io/neteasecloudmusicapienhanced/ncm-api:latest
+            ghcr.io/neteasecloudmusicapienhanced/ncm-api:${{ env.VERSION }}
+          platforms: linux/amd64,linux/arm64/v8
+
+  publish-npm:
+    name: Publish to npm
+    needs: detect
+
+    if: |
+      needs.detect.outputs.should_release == 'true' &&
+      needs.detect.outputs.tag_exists != 'true'
+
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: pnpm/action-setup@v6
+        with:
+          version: 9
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - run: pnpm install --frozen-lockfile
+
+      - run: pnpm publish --access public --provenance 

.github/workflows/sync.yml

@@ -17,12 +17,12 @@ jobs:
     steps:
       # Step 1: run a standard checkout action
       - name: Checkout target repo
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       # Step 2: run the sync action
       - name: Sync upstream changes
         id: sync
-        uses: aormsby/[email protected].1
+        uses: aormsby/[email protected].3
         with:
           upstream_sync_repo: NeteaseCloudMusicApiEnhanced/api-enhanced
           upstream_sync_branch: main

.gitignore

@@ -8,3 +8,5 @@ examples/moddef.json
 bin
 anonymous_token
 .vercel
+.env
+IFLOW.md

.travis.yml

@@ -1,4 +1,4 @@
 language: node_js
 
 node_js:  
-     - 12
+     - 22

AGENTS.md

@@ -0,0 +1,23 @@
+# Agent Instructions for NeteaseCloudMusicApiEnhanced
+
+## Quick Start
+- **Package Manager**: Use `pnpm` (not npm or yarn).
+- **Node Version**: Requires Node.js 18 or later.
+
+## Developer Commands
+- **Install dependencies**: `pnpm i`
+- **Start server**: `pnpm start` or `node app.js`
+- **Start dev server**: `pnpm dev` (uses nodemon)
+- **Run tests**: `pnpm test` (uses Mocha)
+- **Linting**: `pnpm lint` (check) or `pnpm lint-fix` (auto-fix)
+
+## Architecture & Entrypoints
+- **Executable Server**: `app.js` is the main entrypoint for running the API server.
+- **Module Exports**: `main.js` is the entrypoint when the project is imported as a Node.js dependency.
+- **API Endpoints**: Located in the `module/` directory. Each file typically corresponds to an API route.
+- **Core Utilities**: Request handling, encryption, and core utilities are found in the `util/` directory.
+
+## Important Gotchas & Quirks
+- **Environment Variables**: The server defaults to port 3000 but can be overridden with the `PORT` environment variable.
+- **Proxy Variables**: Be very careful with proxy environment variables (`http_proxy`, `https_proxy`, `no_proxy`). The request library (like axios) will automatically pick these up. If they point to an unavailable proxy (especially common in Docker environments), requests will fail silently or throw connection errors.
+- **Code Style**: The project uses ESLint and Prettier. Always run `pnpm lint-fix` before committing changes to ensure formatting consistency.

README.MD

@@ -1,23 +1,58 @@
-# 网易云音乐 API Enhanced
+<p align="center">
+  <img src="./public/static/neteaselogo.png" alt="网易云音乐 API Enhanced Logo" />
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@neteasecloudmusicapienhanced/api">
+    <img src="https://img.shields.io/npm/v/@neteasecloudmusicapienhanced/api?style=flat-square" alt="NPM Version" />
+  </a>
+  <a href="https://www.npmjs.com/package/@neteasecloudmusicapienhanced/api">
+    <img src="https://img.shields.io/npm/dm/@neteasecloudmusicapienhanced/api?style=flat-square" alt="NPM Downloads" />
+  </a>
+  <a href="https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced">
+    <img src="https://img.shields.io/github/license/NeteaseCloudMusicApiEnhanced/api-enhanced?style=flat-square" alt="License" />
+  </a>
+  <a href="https://nodejs.org/">
+    <img src="https://img.shields.io/node/v/@neteasecloudmusicapienhanced/api?style=flat-square" alt="Node Version" />
+  </a>
+  <a href="https://hub.docker.com/r/moefurina/ncm-api">
+    <img src="https://img.shields.io/docker/v/moefurina/ncm-api?style=flat-square" alt="Docker Version" />
+  </a>
+  <a href="https://hub.docker.com/r/moefurina/ncm-api">
+    <img src="https://img.shields.io/docker/pulls/moefurina/ncm-api?style=flat-square" alt="Docker Pulls" />
+  </a>
+  <a href="https://www.typescriptlang.org/">
+    <img src="https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript" alt="TypeScript" />
+  </a>
+</p>
+
 
----
 
 ## 项目简介
 
-本项目为网易云音乐第三方 Node.js API，基于社区停更的原版 API 持续维护和升级，支持丰富的音乐相关接口，适合自建服务、二次开发和多平台部署(如果原版诈尸, 我会及时同步 or 归档)。
+网易云音乐第三方 Node.js API, 支持丰富的音乐相关接口，适合自建服务、二次开发和多平台部署
+
+> [!IMPORTANT]
+>
+> ## 注意
+>
+> - 本项目是自由项目, 不带任何担保, 在基于`MIT License`的许可下, 任何人都可以自由使用、修改和分发本项目的代码, 包括用于商业目的. 
+> - 该项目是个合作计划, 有很多人参与了此次贡献, 前往 [Contributors](https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced/graphs/contributors) 页面查看所有贡献者
+> - 原作者项目 [Binaryify/NeteaseCloudMusicApi](https://github.com/binaryify/NeteaseCloudMusicApi) 并非完全停止维护, 你可以在 [NeteaseCloudMusicApi 的 NPMJS 页面](https://www.npmjs.com/package/NeteaseCloudMusicApi) 查看最新版本信息。   
+> - 感谢尊重和理解!
 
 ## 快速开始
 
 ### 环境要求
 
-- Node.js 14 及以上
+- Node.js 22 及以上
 - 推荐使用 pnpm 进行依赖管理
 
 ### 安装
 
 ```bash
 git clone https://github.com/neteasecloudmusicapienhanced/api-enhanced.git
-cd api
+cd api-enhanced
 pnpm i
 ```
 
@@ -34,25 +69,93 @@ set PORT=4000 && node app.js  # Windows
 
 ### 重要提示
 
-- 调用前请务必阅读文档的 [调用前须知](https://music-api.focalors.ltd/#/?id=%e8%b0%83%e7%94%a8%e5%89%8d%e9%a1%bb%e7%9f%a5) 部分。
+- 调用前请务必阅读文档的 [调用前须知](https://neteasecloudmusicapienhanced.js.org/#/?id=%e8%b0%83%e7%94%a8%e5%89%8d%e9%a1%bb%e7%9f%a5) 部分。
 - 推荐将敏感信息（如 cookie）通过部署平台的环境变量进行配置。
 
 ## 在线体验与文档
 
-- [在线文档](https://music-api.focalors.ltd/)
+- [在线文档](https://neteasecloudmusicapienhanced.js.org/)
-- [NPM 包地址](https://www.npmjs.com/package/@neteaseapireborn/api)
+- [NPM 包地址](https://www.npmjs.com/package/@neteasecloudmusicapienhanced/api)
+- [Dockerhub 主页](https://hub.docker.com/r/moefurina/ncm-api)
 
 ## 常见部署方式
 
-- 推荐参考[在线文档](https://music-api.focalors.ltd/)
+- 推荐参考[在线文档](https://neteasecloudmusicapienhanced.js.org/)
 
-### Vercel 一键部署
+## Docker 部署说明
+
+本项目支持通过 Docker 一键部署，无需手动安装 Node.js 或依赖。
+
+> 注意: 在 docker 中运行的时候, 由于使用了 request 来发请求, 所以会检查几个 proxy 相关的环境变量(如下所列), 这些环境变量 会影响到 request 的代理, 详情请参考[request 的文档](https://github.com/request/request#proxies), 如果这些环境变量 指向的代理不可用, 那么就会造成错误, 所以在使用 docker 的时候一定要注意这些环境变量. 不过, 要是你在 query 中加上了 proxy 参数, 那么环境变量会被覆盖, 就会用你通过 proxy 参数提供的代理了.
+
+request 相关的环境变量
+
+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
+
+docker run -d -p 3000:3000 --name ncm-api moefurina/ncm-api:latest
+
+
+// 或者
+docker run -d -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
+```
+
+> 以下是自行 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. 环境变量
+
+| 变量名                        | 默认值                                  | 说明                                                 |
+|----------------------------|--------------------------------------|----------------------------------------------------|
+| **CORS_ALLOW_ORIGIN**      | `*`                                  | 允许跨域请求的域名。可填写单个源，或使用逗号分隔多个源（例如 `https://a.com,https://b.com`）。 |
+| **ENABLE_PROXY**           | `false`                              | 是否启用反向代理功能。                                        |
+| **PROXY_URL**              | `https://your-proxy-url.com/?proxy=` | 代理服务地址。仅当 `ENABLE_PROXY=true` 时生效。                 |
+| **ENABLE_RANDOM_CN_IP**    | `false`                              | 是否默认启用随机中国IP。启用后，所有请求默认使用随机中国IP，除非请求参数 `randomCNIP` 显式关闭。 |
+| **ENABLE_GENERAL_UNBLOCK** | `true`                               | 是否启用全局解灰（推荐开启）。开启后所有歌曲都尝试自动解锁。                     |
+| **ENABLE_FLAC**            | `true`                               | 是否启用无损音质（FLAC）。                                    |
+| **SELECT_MAX_BR**          | `false`                              | 启用无损音质时，是否选择最高码率音质。                                |
+| **FOLLOW_SOURCE_ORDER**    | `true`                               | 是否严格按照音源列表顺序进行匹配。                                  |
+
+---
+
+### 4. 更新镜像
+
+更新到最新版本：
+
+```bash
+docker pull moefurina/ncm-api:latest
+docker stop ncm-api && docker rm ncm-api
+docker run -d -p 3000:3000 moefurina/ncm-api:latest
+```
+
+## Vercel 一键部署
 
 1. fork 本项目
 2. 在 Vercel 官网新建项目，导入 fork 的仓库
 3. 直接 Deploy
 
-### 腾讯云 Serverless 部署
+## 腾讯云 Serverless 部署
 
 1. fork 本项目
 2. 在腾讯云 serverless 控制台新建 Web 应用，选择 Express 框架
@@ -69,7 +172,10 @@ set PORT=4000 && node app.js  # Windows
 支持直接在 Node.js 项目中引入和调用，返回 Promise：
 
 ```js
-const { login_cellphone, user_cloud } = require('@neteaseapireborn/api')
+const {
+  login_cellphone,
+  user_cloud,
+} = require('@neteasecloudmusicapienhanced/api')
 async function main() {
   const result = await login_cellphone({ phone: '手机号', password: '密码' })
   console.log(result)
@@ -82,7 +188,7 @@ main()
 ## TypeScript 支持
 
 ```ts
-import { banner } from '@neteaseapireborn/api'
+import { banner } from '@neteasecloudmusicapienhanced/api'
 banner({ type: 0 }).then((res) => console.log(res))
 ```
 
@@ -98,22 +204,50 @@ pnpm test
 - 用户信息、歌单、动态、播放记录
 - 歌曲、专辑、歌手、MV、歌词、评论、排行榜
 - 搜索、推荐、私人 FM、签到、云盘
-- 歌曲解锁（解灰）、多音源支持（qq/kuwo/kugou/migu/pyncmd）
+- 歌曲解锁（解灰）
-> 注意: 如果解灰出现问题, 本项目只是集成[UnblockNeteaseMusic](https://github.com/UnblockNeteaseMusic/server)的接口, 请在对应的仓库开启议题
-- 详细接口请见[在线文档](https://music-api.focalors.ltd/)
 
 ## 贡献与社区
 
 - 欢迎提交 PR、Issue 参与维护
+- 要贡献新接口, 请参考[这篇文章](https://www.focalors.ltd/post/how-to-contribute-ncm-api)
 
-## SDK 生态
+### 致谢
 
-| 语言   | 作者                                        | 地址                                                                                     | 类型   |
+原作者 [Binaryify/NeteaseCloudMusicApi](https://github.com/binaryify/NeteaseCloudMusicApi) 项目为本项目基础 (该项目在`npmjs`网站上仍持续维护, 但 github 仓库已不再更新)
-| ------ | ------------------------------------------- | ---------------------------------------------------------------------------------------- | ------ |
+
+感谢大佬们为逆向eapi, weapi, xeapi等加密算法所做的贡献
+
+项目参考:
+
+[trazyn/ieaseMusic](https://github.com/trazyn/ieaseMusic)
+
+[listen1/listen1_chrome_extension](https://github.com/listen1/listen1_chrome_extension)
+
+[chaunsin/netease-cloud-music](https://github.com/chaunsin/netease-cloud-music)
+
+[folltoshe/netease-report-listen-song](https://github.com/folltoshe/netease-report-listen-song)
+
+### SDK 生态
+
+| 语言     | 作者                                          | 地址                                                                                       | 类型  |
+|--------|---------------------------------------------|------------------------------------------------------------------------------------------|-----|
 | Java   | [JackuXL](https://github.com/JackuXL)       | [NeteaseCloudMusicApi-SDK](https://github.com/JackuXL/NeteaseCloudMusicApi-SDK)          | 第三方 |
-| Java   | [1015770492](https://github.com/1015770492) | https://github.com/1015770492/yumbo-music-utils                                          | 第三方 |
+| Java   | [1015770492](https://github.com/1015770492) | [yumbo-music-utils](https://github.com/1015770492/yumbo-music-utils)      | 第三方 |
-| Python | [盧瞳](https://github.com/2061360308)       | [NeteaseCloudMusic_PythonSDK](https://github.com/2061360308/NeteaseCloudMusic_PythonSDK) | 第三方 |
+| Python | [盧瞳](https://github.com/2061360308)         | [NeteaseCloudMusic_PythonSDK](https://github.com/2061360308/NeteaseCloudMusic_PythonSDK) | 第三方 |
+| Swift  | [Lincb522](https://github.com/Lincb522)  | [NeteaseCloudMusicApi-Swift](https://github.com/Lincb522/NeteaseCloudMusicAPI-Swift)     | 第三方 |
+| Rust   | [SPlayer-Dev](https://github.com/splayer-dev)  | [ncm-api-rs](https://github.com/SPlayer-Dev/ncm-api-rs)     | 第三方 |
+
+
+### 依赖此项目的优秀开源项目
+
+- [qier2222/YesPlayMusic](https://github.com/qier222/YesPlayMusic)
+
+- [MaigoLabs/amaoke.app](https://github.com/MaigoLabs/amaoke.app)
+
+- [Yueby/music-together](https://github.com/Yueby/music-together)
+
+- [chthollyphlie/folia-major](https://github.com/chthollyphile/folia-major)
 
 ## License
 
-[MIT License](https://github.com/IamFurina/NeteaseCloudMusicApiReborn/blob/main/LICENSE)
+[MIT License](https://github.com/MoeFurina/NeteaseCloudMusicApiEnhanced/blob/main/LICENSE)

edgeone.json

@@ -1,14 +0,0 @@
-{
-  "functions": [
-    {
-      "path": "/(.*)",
-      "method": ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
-      "handler": "index.js",
-      "headers": {
-        "Access-Control-Allow-Credentials": "true",
-        "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS",
-        "Access-Control-Allow-Headers": "X-CSRF-Token, X-Requested-With, Accept, Accept-Version, Content-Length, Content-MD5, Content-Type, Date, X-Api-Version"
-      }
-    }
-  ]
-}

eslint.config.js

@@ -0,0 +1,91 @@
+const { defineConfig, globalIgnores } = require('eslint/config')
+
+const html = require('eslint-plugin-html')
+const globals = require('globals')
+const tsParser = require('@typescript-eslint/parser')
+const js = require('@eslint/js')
+
+const { FlatCompat } = require('@eslint/eslintrc')
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+  recommendedConfig: js.configs.recommended,
+  allConfig: js.configs.all,
+})
+
+module.exports = defineConfig([
+  {
+    languageOptions: {
+      ecmaVersion: 2020,
+      sourceType: 'module',
+      parserOptions: {
+        parser: 'babel-eslint',
+      },
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+    },
+
+    plugins: {
+      html,
+    },
+
+    extends: compat.extends('plugin:prettier/recommended'),
+
+    rules: {
+      'prettier/prettier': [
+        'error',
+        {
+          endOfLine: 'auto',
+        },
+      ],
+
+      indent: [
+        'error',
+        2,
+        {
+          SwitchCase: 1,
+        },
+      ],
+
+      'space-infix-ops': [
+        'error',
+        {
+          int32Hint: false,
+        },
+      ],
+
+      'key-spacing': [
+        2,
+        {
+          beforeColon: false,
+          afterColon: true,
+        },
+      ],
+
+      'no-octal': 2,
+      'no-redeclare': 2,
+      'comma-spacing': 2,
+      'no-new-object': 2,
+      'arrow-spacing': 2,
+
+      quotes: [
+        2,
+        'single',
+        {
+          avoidEscape: true,
+          allowTemplateLiterals: true,
+        },
+      ],
+    },
+  },
+  globalIgnores(['**/public/']),
+  {
+    files: ['**/*.ts'],
+    languageOptions: {
+      parser: tsParser,
+    },
+    extends: compat.extends('plugin:@typescript-eslint/recommended'),
+  },
+])

generateConfig.js

@@ -2,6 +2,7 @@ const fs = require('fs')
 const path = require('path')
 const { register_anonimous } = require('./main')
 const { cookieToJson, generateRandomChineseIP } = require('./util/index')
+const { getXeapiPublicKey } = require('./util/xeapiKey')
 const tmpPath = require('os').tmpdir()
 
 async function generateConfig() {
@@ -20,5 +21,21 @@ async function generateConfig() {
   } catch (error) {
     console.log(error)
   }
+  try {
+    let currentPublicKey = {}
+    try {
+      currentPublicKey = JSON.parse(
+        fs.readFileSync(path.resolve(tmpPath, 'xeapi_public_key'), 'utf-8'),
+      )
+    } catch (_) {}
+    const publicKey = await getXeapiPublicKey(currentPublicKey, global.deviceId)
+    fs.writeFileSync(
+      path.resolve(tmpPath, 'xeapi_public_key'),
+      JSON.stringify(publicKey),
+      'utf-8',
+    )
+  } catch (error) {
+    console.log(error)
+  }
 }
 module.exports = generateConfig

index.mjs

@@ -0,0 +1 @@
+import './app.js'

interface.d.ts

@@ -2,6 +2,7 @@ export interface RequestBaseConfig {
   cookie?: string
   realIP?: string // IPv4/IPv6 filled in X-Real-IP
   proxy?: string // HTTP proxy
+  randomCNIP?: boolean // Whether to use a random Chinese IP address filled in X-Real-IP
 }
 
 export interface MultiPageConfig {
@@ -1165,6 +1166,13 @@ export function song_url_v1(
   params: { id: string | number; level: SoundQualityType } & RequestBaseConfig,
 ): Promise<Response>
 
+export function song_copyright_rcmd(
+  params: {
+    songid?: string | number
+    id?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
 export function top_album(
   params: {
     area?: AlbumListArea
@@ -1466,6 +1474,20 @@ export function artist_new_song(
   } & RequestBaseConfig,
 ): Promise<Response>
 
+export function artist_new_song_playall(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function artist_new_song_mv_list_v2(
+  params: {
+    startTimestamp?: number | string
+    before?: number | string
+    sourceType?: number | string
+    limit?: number | string
+    firstRequest?: boolean | string
+  } & RequestBaseConfig,
+): Promise<Response>
+
 export function artist_detail(
   params: {
     id: number | string
@@ -1586,6 +1608,10 @@ export function vip_growthpoint_get(
   } & RequestBaseConfig,
 ): Promise<Response>
 
+export function vip_growthpoint_getall(
+  params: RequestBaseConfig,
+): Promise<Response>
+
 export function artist_fans(
   params: { id: number | string } & MultiPageConfig & RequestBaseConfig,
 ): Promise<Response>
@@ -1714,6 +1740,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
@@ -1831,3 +1859,731 @@ export function voice_lyric(
     id: number | string
   } & RequestBaseConfig,
 ): Promise<Response>
+
+export function aidj_content_rcmd(
+  params: {
+    latitude?: string | number
+    longitude?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function album_privilege(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function artist_detail_dynamic(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function artist_follow_count(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function broadcast_category_region_get(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function broadcast_channel_collect_list(
+  params: MultiPageConfig & RequestBaseConfig,
+): Promise<Response>
+
+export function broadcast_channel_currentinfo(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function broadcast_channel_list(
+  params: {
+    categoryId?: string | number
+    regionId?: string | number
+    lastId?: string | number
+    score?: string | number
+  } & MultiPageConfig &
+    RequestBaseConfig,
+): Promise<Response>
+
+export function broadcast_sub(
+  params: {
+    t: SubAction
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function chart_detail(
+  params: {
+    chartCode: string | number
+    targetId: string | number
+    targetType: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function chart_song_detail(
+  params: {
+    chartCode: string | number
+    targetId: string | number
+    targetType: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function cloud_import(
+  params: {
+    md5: string
+    id?: string | number
+    bitrate?: string | number
+    fileSize?: string | number
+    artist?: string
+    album?: string
+    song?: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function cloud_lyric_get(
+  params: {
+    uid: string | number
+    sid: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function cloud_upload_complete(
+  params: {
+    songId: string | number
+    resourceId: string | number
+    md5: string
+    filename: string
+    song?: string
+    artist?: string
+    album?: string
+    bitrate?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function cloud_upload_token(
+  params: {
+    md5: string
+    fileSize: string | number
+    filename: string
+    bitrate?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function comment_info_list(
+  params: {
+    ids?: string
+    type?: CommentType
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function comment_report(
+  params: {
+    id: string | number
+    cid: string | number
+    reason: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function creator_authinfo_get(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function dj_difm_all_style_channel(
+  params: {
+    sources?: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function dj_difm_channel_subscribe(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function dj_difm_channel_unsubscribe(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function dj_difm_playing_tracks_list(
+  params: {
+    channelId: string | number
+    limit?: string | number
+    source?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function dj_difm_subscribe_channels_get(
+  params: {
+    sources?: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function fanscenter_basicinfo_age_get(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function fanscenter_basicinfo_gender_get(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function fanscenter_basicinfo_province_get(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function fanscenter_overview_get(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function fanscenter_trend_list(
+  params: {
+    startTime?: string | number
+    endTime?: string | number
+    type?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function lbs_city_code(
+  params: {
+    bizCode?: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function listen_data_realtime_report(
+  params: {
+    type?: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function listen_data_report(
+  params: {
+    type?: string
+    endTime?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function listen_data_song_play_rank(
+  params: {
+    type?: string
+    endTime?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function listen_data_today_song(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function listen_data_total(params: RequestBaseConfig): Promise<Response>
+
+export function listen_data_year_report(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function listentogether_accept(
+  params: {
+    roomId: string | number
+    inviterId: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function listentogether_end(
+  params: {
+    roomId: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function listentogether_heatbeat(
+  params: {
+    roomId: string | number
+    songId: string | number
+    playStatus: string | number
+    progress: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function listentogether_play_command(
+  params: {
+    roomId: string | number
+    commandType: string | number
+    progress?: string | number
+    playStatus: string | number
+    formerSongId: string | number
+    targetSongId: string | number
+    clientSeq: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function listentogether_room_check(
+  params: {
+    roomId: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function listentogether_room_create(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function listentogether_sync_list_command(
+  params: {
+    roomId: string | number
+    commandType: string | number
+    userId: string | number
+    version: string | number
+    randomList: string
+    displayList: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function listentogether_sync_playlist_get(
+  params: {
+    roomId: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function mlog_music_rcmd(
+  params: {
+    mvid?: string | number
+    songid?: string | number
+    limit?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function music_first_listen_info(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function personal_fm_mode(
+  params: {
+    mode: string
+    submode?: string
+    limit?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function playlist_category_list(
+  params: {
+    cat?: string
+    limit?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function playlist_detail_rcmd_get(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function playlist_import_name_task_create(
+  params: {
+    local?: string
+    importStarPlaylist?: boolean
+    ['name']?: string
+    ['description']?: string
+    ['id']?: string | number
+    ['url']?: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function playlist_import_task_status(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function playlist_privacy(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function playmode_song_vector(
+  params: {
+    ids: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function radio_sport_get(
+  params: {
+    bpm?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function recent_listen_list(params: RequestBaseConfig): Promise<Response>
+
+export function recommend_songs_dislike(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function register_anonimous(params: RequestBaseConfig): Promise<Response>
+
+export function sati_resource_list(
+  params: {
+    tag: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function sati_resource_list_more(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function sati_resource_sub(
+  params: {
+    id: string | number
+    cancel?: string | boolean
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function sati_resource_sub_list(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function sati_tag_list(params: RequestBaseConfig): Promise<Response>
+
+export function sati_timescene_resources_get(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function search_match(
+  params: {
+    title?: string
+    album?: string
+    artist?: string
+    duration?: string | number
+    md5?: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function search_suggest_pc(
+  params: {
+    keyword: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function send_album(
+  params: {
+    id: string | number
+    msg?: string
+    user_ids: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function send_song(
+  params: {
+    id: string | number
+    msg?: string
+    user_ids: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_chorus(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_creators(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_downlist(
+  params: MultiPageConfig & RequestBaseConfig,
+): Promise<Response>
+
+export function song_download_url_v1(
+  params: {
+    id: string | number
+    level: SoundQualityType
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_dynamic_cover(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_like(
+  params: {
+    id: string | number
+    like?: string | boolean
+    uid?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_like_check(
+  params: {
+    ids: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_lyrics_mark(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_lyrics_mark_add(
+  params: {
+    id: string | number
+    markId?: string
+    data?: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_lyrics_mark_del(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_lyrics_mark_user_page(
+  params: MultiPageConfig & RequestBaseConfig,
+): Promise<Response>
+
+export function song_monthdownlist(
+  params: MultiPageConfig & RequestBaseConfig,
+): Promise<Response>
+
+export function song_music_detail(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_red_count(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_singledownlist(
+  params: MultiPageConfig & RequestBaseConfig,
+): Promise<Response>
+
+export function song_url_match(
+  params: {
+    id: string | number
+    source?: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function song_url_ncmget(params: RequestBaseConfig): Promise<Response>
+
+export function song_url_v1_302(
+  params: {
+    id: string | number
+    level: SoundQualityType
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function starpick_comments_summary(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function summary_annual(
+  params: {
+    year: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function threshold_detail_get(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function toplist_detail_v2(params: RequestBaseConfig): Promise<Response>
+
+export function ugc_album_get(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function ugc_artist_get(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function ugc_artist_search(
+  params: {
+    keyword: string
+    limit?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function ugc_detail(
+  params: {
+    auditStatus?: string
+    type?: string | number
+    sortBy?: string
+    order?: string
+  } & MultiPageConfig &
+    RequestBaseConfig,
+): Promise<Response>
+
+export function ugc_mv_get(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function ugc_song_get(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function ugc_user_devote(params: RequestBaseConfig): Promise<Response>
+
+export function user_detail_new(
+  params: {
+    uid: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function user_follow_mixed(
+  params: {
+    size?: string | number
+    cursor?: string | number
+    scene?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function user_medal(
+  params: {
+    uid: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function user_mutualfollow_get(
+  params: {
+    uid: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function user_playlist_collect(
+  params: {
+    uid: string | number
+  } & MultiPageConfig &
+    RequestBaseConfig,
+): Promise<Response>
+
+export function user_playlist_create(
+  params: {
+    uid: string | number
+  } & MultiPageConfig &
+    RequestBaseConfig,
+): Promise<Response>
+
+export function user_social_status(
+  params: {
+    uid: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function user_social_status_edit(
+  params: {
+    type: string | number
+    iconUrl?: string
+    content?: string
+    actionUrl?: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function user_social_status_rcmd(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function user_social_status_support(
+  params: RequestBaseConfig,
+): Promise<Response>
+
+export function verify_getQr(
+  params: {
+    vid: string | number
+    type: string | number
+    token: string
+    evid: string
+    sign: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function verify_qrcodestatus(
+  params: {
+    qr: string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function vip_sign(params: RequestBaseConfig): Promise<Response>
+
+export function vip_sign_info(params: RequestBaseConfig): Promise<Response>
+
+export function vip_tasks_v1(
+  params: {
+    id?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function voice_detail(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function voice_upload(
+  params: {
+    songFile: {
+      name: string
+      data: string | Buffer
+    }
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function voicelist_detail(
+  params: {
+    id: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function voicelist_list(
+  params: {
+    voiceListId: string | number
+  } & MultiPageConfig &
+    RequestBaseConfig,
+): Promise<Response>
+
+export function voicelist_my_created(
+  params: {
+    limit?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function voicelist_search(
+  params: {
+    keyword?: string
+    limit?: string | number
+    offset?: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function voicelist_trans(
+  params: {
+    radioId?: string | number
+    programId?: string | number
+    position?: string | number
+  } & MultiPageConfig &
+    RequestBaseConfig,
+): Promise<Response>

issue_template.md

@@ -1,29 +0,0 @@
-## 环境
-- 系统/平台: <你的系统和平台>
-
-- nodejs 版本: <你的 NodeJS 版本号>
-
-- API版本:<运行的云音乐 API 的版本号， 对应 package.json 里面的 version>
-
-## 出现问题
-<出现的问题>
-
-## 重现步骤
-<重现步骤>
-
-## 期待效果
-<现在的效果，期待的效果>  
-
-
-
->先看文档有没有相关说明,调用前须知必看
-
->先在 issues 搜一下是否有相似问题，没有再发,否则直接关闭
-
->不处理别人搭建的线上服务的问题,此项目不提供任何线上服务,请自行搭建
-
->重现步骤尽量详细,不能含糊不清，包含请求地址和对应参数以及操作过程描述,不是每个人都喜欢猜别人遇到了什么问题和找参数一个个试,也比较浪费时间
-
->如果不是提建议,提 issues 如果不照着模版来将不会优先处理或直接关闭
-
->460 cheating 的问题把 `util/request.js` 里面的 `headers['X-Real-IP']` 的注释取消掉就好

main.js

@@ -3,47 +3,61 @@ const path = require('path')
 const tmpPath = require('os').tmpdir()
 const { cookieToJson } = require('./util')
 
-if (!fs.existsSync(path.resolve(tmpPath, 'anonymous_token'))) {
+const anonymousTokenPath = path.resolve(tmpPath, 'anonymous_token')
-  fs.writeFileSync(path.resolve(tmpPath, 'anonymous_token'), '', 'utf-8')
+if (!fs.existsSync(anonymousTokenPath)) {
+  fs.writeFileSync(anonymousTokenPath, '', 'utf-8')
 }
 
-let firstRun = true
 /** @type {Record<string, any>} */
 let obj = {}
-fs.readdirSync(path.join(__dirname, 'module'))
-  .reverse()
-  .forEach((file) => {
-    if (!file.endsWith('.js')) return
-    let fileModule = require(path.join(__dirname, 'module', file))
-    let fn = file.split('.').shift() || ''
-    obj[fn] = function (data = {}) {
-      if (typeof data.cookie === 'string') {
-        data.cookie = cookieToJson(data.cookie)
-      }
-      return fileModule(
-        {
-          ...data,
-          cookie: data.cookie ? data.cookie : {},
-        },
-        async (...args) => {
-          if (firstRun) {
-            firstRun = false
-            const generateConfig = require('./generateConfig')
-            await generateConfig()
-          }
-          // 待优化
-          const request = require('./util/request')
 
-          return request(...args)
+const modulePath = path.join(__dirname, 'module')
-        },
+const moduleFiles = fs.readdirSync(modulePath).reverse()
-      )
+
-    }
+let requestModule = null
-  })
+
+moduleFiles.forEach((file) => {
+  if (!file.endsWith('.js')) return
+
+  const filePath = path.join(modulePath, file)
+  let fileModule = require(filePath)
+  let fn = file.split('.').shift() || ''
+
+  obj[fn] = function (data = {}) {
+    const cookie =
+      typeof data.cookie === 'string'
+        ? cookieToJson(data.cookie)
+        : data.cookie || {}
+
+    return fileModule(
+      {
+        ...data,
+        cookie,
+      },
+      async (...args) => {
+        if (!requestModule) {
+          requestModule = require('./util/request')
+        }
+
+        return requestModule(...args)
+      },
+    )
+  }
+})
+
+let serverModule = null
 
 /**
  * @type {Record<string, any> & import("./server")}
  */
 module.exports = {
-  ...require('./server'),
+  get server() {
+    if (!serverModule) {
+      serverModule = require('./server')
+    }
+    return serverModule
+  },
   ...obj,
 }
+
+Object.assign(module.exports, require('./server'))

module/artist_new_song_mv_list_v2.js

@@ -0,0 +1,16 @@
+// 获取关注歌手的新歌曲和 MV
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    startTimestamp: query.startTimestamp || query.before || Date.now(),
+    sourceType: query.sourceType || 1,
+    limit: query.limit || 10,
+    firstRequest: query.firstRequest ?? true,
+  }
+  return request(
+    `/api/sub/artist/new/works/song-mv/list/v2`,
+    data,
+    createOption(query, 'eapi'),
+  )
+}

module/artist_new_song_playall.js

@@ -0,0 +1,10 @@
+// 获取所有关注歌手最近的 50 首新歌
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  return request(
+    `/api/sub/artist/new/works/song/playall`,
+    {},
+    createOption(query, 'eapi'),
+  )
+}

module/captcha_sent.js

@@ -4,6 +4,7 @@ const createOption = require('../util/option.js')
 module.exports = (query, request) => {
   const data = {
     ctcode: query.ctcode || '86',
+    secrete: 'music_middleuser_pclogin',
     cellphone: query.phone,
   }
   return request(`/api/sms/captcha/sent`, data, createOption(query, 'weapi'))

module/chart_detail.js

@@ -0,0 +1,11 @@
+// 获取指定维度音乐排行榜详情
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    chartCode: query.chartCode,
+    targetId: query.targetId,
+    targetType: query.targetType,
+  }
+  return request(`/api/chart/detail`, data, createOption(query))
+}

module/chart_song_detail.js

@@ -0,0 +1,11 @@
+// 获取指定维度音乐排行榜列表
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    chartCode: query.chartCode,
+    targetId: query.targetId,
+    targetType: query.targetType,
+  }
+  return request(`/api/chart/song/detail`, data, createOption(query))
+}

module/cloud.js

@@ -1,24 +1,26 @@
-const mm = require('music-metadata')
 const uploadPlugin = require('../plugins/songUpload')
-const md5 = require('md5')
 const createOption = require('../util/option.js')
 const logger = require('../util/logger.js')
+const {
+  isTempFile,
+  getFileSize,
+  getFileMd5,
+  cleanupTempFile,
+  getFileExtension,
+  sanitizeFilename,
+} = require('../util/fileHelper')
+
+let mm
 module.exports = async (query, request) => {
-  let ext = 'mp3'
+  mm = require('music-metadata')
-  // if (query.songFile.name.indexOf('flac') > -1) {
+
-  //   ext = 'flac'
-  // }
-  if (query.songFile.name.includes('.')) {
-    ext = query.songFile.name.split('.').pop()
-  }
   query.songFile.name = Buffer.from(query.songFile.name, 'latin1').toString(
     'utf-8',
   )
-  const filename = query.songFile.name
+  const ext = getFileExtension(query.songFile.name)
-    .replace('.' + ext, '')
+  const filename = sanitizeFilename(query.songFile.name)
-    .replace(/\s/g, '')
-    .replace(/\./g, '_')
   const bitrate = 999000
+
   if (!query.songFile) {
     return Promise.reject({
       status: 500,
@@ -28,119 +30,135 @@ module.exports = async (query, request) => {
       },
     })
   }
-  if (!query.songFile.md5) {
+
-    // 命令行上传没有md5和size信息,需要填充
+  const useTemp = isTempFile(query.songFile)
-    query.songFile.md5 = md5(query.songFile.data)
+  let fileSize = await getFileSize(query.songFile)
-    query.songFile.size = query.songFile.data.byteLength
+  let fileMd5 = await getFileMd5(query.songFile)
-  }
+
-  const res = await request(
+  query.songFile.md5 = fileMd5
-    `/api/cloud/upload/check`,
+  query.songFile.size = fileSize
-    {
+
-      bitrate: String(bitrate),
-      ext: '',
-      length: query.songFile.size,
-      md5: query.songFile.md5,
-      songId: '0',
-      version: 1,
-    },
-    createOption(query),
-  )
-  let artist = ''
-  let album = ''
-  let songName = ''
   try {
-    const metadata = await mm.parseBuffer(
+    const res = await request(
-      query.songFile.data,
+      `/api/cloud/upload/check`,
-      query.songFile.mimetype,
+      {
+        bitrate: String(bitrate),
+        ext: '',
+        length: fileSize,
+        md5: fileMd5,
+        songId: '0',
+        version: 1,
+      },
+      createOption(query),
     )
-    const info = metadata.common
 
-    if (info.title) {
+    let artist = ''
-      songName = info.title
+    let album = ''
-    }
+    let songName = ''
-    if (info.album) {
-      album = info.album
-    }
-    if (info.artist) {
-      artist = info.artist
-    }
-    // if (metadata.native.ID3v1) {
-    //   metadata.native.ID3v1.forEach((item) => {
-    //     // logger.info(item.id, item.value)
-    //     if (item.id === 'title') {
-    //       songName = item.value
-    //     }
-    //     if (item.id === 'artist') {
-    //       artist = item.value
-    //     }
-    //     if (item.id === 'album') {
-    //       album = item.value
-    //     }
-    //   })
-    //   // logger.info({
-    //   //   songName,
-    //   //   album,
-    //   //   songName,
-    //   // })
-    // }
-    // logger.info({
-    //   songName,
-    //   album,
-    //   songName,
-    // })
-  } catch (error) {
-    logger.info(error)
-  }
-  const tokenRes = await request(
-    `/api/nos/token/alloc`,
-    {
-      bucket: '',
-      ext: ext,
-      filename: filename,
-      local: false,
-      nos_product: 3,
-      type: 'audio',
-      md5: query.songFile.md5,
-    },
-    createOption(query),
-  )
 
-  if (res.body.needUpload) {
+    try {
-    const uploadInfo = await uploadPlugin(query, request)
+      let metadata
-    // logger.info('uploadInfo', uploadInfo.body.result.resourceId)
+      if (useTemp) {
-  }
+        metadata = await mm.parseFile(query.songFile.tempFilePath)
-  // logger.info(tokenRes.body.result)
+      } else {
-  const res2 = await request(
+        metadata = await mm.parseBuffer(
-    `/api/upload/cloud/info/v2`,
+          query.songFile.data,
-    {
+          query.songFile.mimetype,
-      md5: query.songFile.md5,
+        )
-      songid: res.body.songId,
+      }
-      filename: query.songFile.name,
+      const info = metadata.common
-      song: songName || filename,
+      if (info.title) songName = info.title
-      album: album || '未知专辑',
+      if (info.album) album = info.album
-      artist: artist || '未知艺术家',
+      if (info.artist) artist = info.artist
-      bitrate: String(bitrate),
+    } catch (error) {
-      resourceId: tokenRes.body.result.resourceId,
+      logger.info('元数据解析错误:', error.message)
-    },
+    }
-    createOption(query),
+
-  )
+    const tokenRes = await request(
-  // logger.info({ res2, privateCloud: res2.body.privateCloud })
+      `/api/nos/token/alloc`,
-  // logger.info(res.body.songId, 'songid')
+      {
-  const res3 = await request(
+        bucket: '',
-    `/api/cloud/pub/v2`,
+        ext: ext,
-    {
+        filename: filename,
-      songid: res2.body.songId,
+        local: false,
-    },
+        nos_product: 3,
-    createOption(query),
+        type: 'audio',
-  )
+        md5: fileMd5,
-  // logger.info({ res3 })
+      },
-  return {
+      createOption(query),
-    status: 200,
+    )
-    body: {
+
-      ...res.body,
+    if (!tokenRes.body.result || !tokenRes.body.result.resourceId) {
-      ...res3.body,
+      logger.error('Token分配失败:', tokenRes.body)
-      // ...uploadInfo,
+      return Promise.reject({
-    },
+        status: 500,
-    cookie: res.cookie,
+        body: {
+          code: 500,
+          msg: '获取上传token失败',
+          detail: tokenRes.body,
+        },
+      })
+    }
+
+    if (res.body.needUpload) {
+      logger.info('需要上传，开始上传流程...')
+      try {
+        const uploadInfo = await uploadPlugin(query, request)
+        logger.info('上传完成:', uploadInfo?.body?.result?.resourceId)
+      } catch (uploadError) {
+        logger.error('上传失败:', uploadError)
+        return Promise.reject(uploadError)
+      }
+    } else {
+      logger.info('文件已存在，跳过上传')
+    }
+
+    const res2 = await request(
+      `/api/upload/cloud/info/v2`,
+      {
+        md5: fileMd5,
+        songid: res.body.songId,
+        filename: query.songFile.name,
+        song: songName || filename,
+        album: album || '未知专辑',
+        artist: artist || '未知艺术家',
+        bitrate: String(bitrate),
+        resourceId: tokenRes.body.result.resourceId,
+      },
+      createOption(query),
+    )
+
+    if (res2.body.code !== 200) {
+      logger.error('云盘信息上传失败:', res2.body)
+      return Promise.reject({
+        status: res2.status || 500,
+        body: {
+          code: res2.body.code || 500,
+          msg: res2.body.msg || '上传云盘信息失败',
+          detail: res2.body,
+        },
+      })
+    }
+
+    const res3 = await request(
+      `/api/cloud/pub/v2`,
+      {
+        songid: res2.body.songId,
+      },
+      createOption(query),
+    )
+
+    return {
+      status: 200,
+      body: {
+        ...res.body,
+        ...res3.body,
+      },
+      cookie: res.cookie,
+    }
+  } finally {
+    if (useTemp) {
+      await cleanupTempFile(query.songFile.tempFilePath)
+    }
   }
 }

module/cloud_lyric_get.js

@@ -0,0 +1,11 @@
+// 获取云盘歌词
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    userId: query.uid,
+    songId: query.sid,
+    lv: -1,
+    kv: -1,
+  }
+  return request(`/api/cloud/lyric/get`, data, createOption(query, 'eapi'))
+}

module/cloud_upload_complete.js

@@ -0,0 +1,72 @@
+const createOption = require('../util/option.js')
+
+module.exports = async (query, request) => {
+  const {
+    songId,
+    resourceId,
+    md5,
+    filename,
+    song,
+    artist,
+    album,
+    bitrate = 999000,
+  } = query
+
+  if (!songId || !resourceId || !md5 || !filename) {
+    return Promise.reject({
+      status: 400,
+      body: {
+        code: 400,
+        msg: '缺少必要参数: songId, resourceId, md5, filename',
+      },
+    })
+  }
+
+  const songName = song || filename.replace(/\.[^.]+$/, '')
+
+  const res2 = await request(
+    `/api/upload/cloud/info/v2`,
+    {
+      md5: md5,
+      songid: songId,
+      filename: filename,
+      song: songName,
+      album: album || '未知专辑',
+      artist: artist || '未知艺术家',
+      bitrate: String(bitrate),
+      resourceId: resourceId,
+    },
+    createOption(query),
+  )
+
+  if (res2.body.code !== 200) {
+    return Promise.reject({
+      status: res2.status || 500,
+      body: {
+        code: res2.body.code || 500,
+        msg: res2.body.msg || '上传云盘信息失败',
+        detail: res2.body,
+      },
+    })
+  }
+
+  const res3 = await request(
+    `/api/cloud/pub/v2`,
+    {
+      songid: res2.body.songId,
+    },
+    createOption(query),
+  )
+
+  return {
+    status: 200,
+    body: {
+      code: 200,
+      data: {
+        songId: res2.body.songId,
+        ...res3.body,
+      },
+    },
+    cookie: res2.cookie,
+  }
+}

module/cloud_upload_token.js

@@ -0,0 +1,111 @@
+const { default: axios } = require('axios')
+const createOption = require('../util/option.js')
+
+module.exports = async (query, request) => {
+  const { md5, fileSize, filename, bitrate = 999000 } = query
+
+  if (!md5 || !fileSize || !filename) {
+    return Promise.reject({
+      status: 400,
+      body: {
+        code: 400,
+        msg: '缺少必要参数: md5, fileSize, filename',
+      },
+    })
+  }
+
+  const ext = filename.includes('.') ? filename.split('.').pop() : 'mp3'
+
+  const checkRes = await request(
+    `/api/cloud/upload/check`,
+    {
+      bitrate: String(bitrate),
+      ext: '',
+      length: fileSize,
+      md5: md5,
+      songId: '0',
+      version: 1,
+    },
+    createOption(query),
+  )
+
+  const bucket = 'jd-musicrep-privatecloud-audio-public'
+  const tokenRes = await request(
+    `/api/nos/token/alloc`,
+    {
+      bucket: bucket,
+      ext: ext,
+      filename: filename
+        .replace(/\.[^.]+$/, '')
+        .replace(/\s/g, '')
+        .replace(/\./g, '_'),
+      local: false,
+      nos_product: 3,
+      type: 'audio',
+      md5: md5,
+    },
+    createOption(query, 'weapi'),
+  )
+
+  if (!tokenRes.body.result || !tokenRes.body.result.objectKey) {
+    return Promise.reject({
+      status: 500,
+      body: {
+        code: 500,
+        msg: '获取上传token失败',
+        detail: tokenRes.body,
+      },
+    })
+  }
+
+  let lbs
+  try {
+    lbs = (
+      await axios({
+        method: 'get',
+        url: `https://wanproxy.127.net/lbs?version=1.0&bucketname=${bucket}`,
+        timeout: 10000,
+      })
+    ).data
+  } catch (error) {
+    return Promise.reject({
+      status: 500,
+      body: {
+        code: 500,
+        msg: '获取上传服务器地址失败',
+        detail: error.message,
+      },
+    })
+  }
+
+  if (!lbs || !lbs.upload || !lbs.upload[0]) {
+    return Promise.reject({
+      status: 500,
+      body: {
+        code: 500,
+        msg: '获取上传服务器地址无效',
+        detail: lbs,
+      },
+    })
+  }
+
+  return {
+    status: 200,
+    body: {
+      code: 200,
+      data: {
+        needUpload: checkRes.body.needUpload,
+        songId: checkRes.body.songId,
+        uploadToken: tokenRes.body.result.token,
+        objectKey: tokenRes.body.result.objectKey,
+        resourceId: tokenRes.body.result.resourceId,
+        uploadUrl: `${lbs.upload[0]}/${bucket}/${tokenRes.body.result.objectKey.replace(/\//g, '%2F')}?offset=0&complete=true&version=1.0`,
+        bucket: bucket,
+        md5: md5,
+        fileSize: fileSize,
+        filename: filename,
+      },
+    },
+    cookie: checkRes.cookie,
+  }
+}

module/comment_info_list.js

@@ -0,0 +1,30 @@
+// 评论统计数据
+// type: 0=歌曲 1=MV 2=歌单 3=专辑 4=电台节目 5=视频 6=动态 7=电台
+// ids: 资源 ID 列表，多个用逗号分隔，如 "123,456"
+const { resourceTypeMap } = require('../util/config.json')
+const createOption = require('../util/option.js')
+
+// 从 resourceTypeMap 的前缀值中提取网易云内部资源类型编号
+// 例如 "R_SO_4_" -> "4", "A_DR_14_" -> "14"
+const resourceTypeIdMap = Object.fromEntries(
+  Object.entries(resourceTypeMap).map(([key, prefix]) => [
+    key,
+    prefix.replace(/_$/, '').split('_').pop(),
+  ]),
+)
+
+module.exports = (query, request) => {
+  const ids = String(query.ids || query.id || '')
+    .split(',')
+    .map((id) => id.trim())
+    .filter(Boolean)
+
+  return request(
+    `/api/resource/commentInfo/list`,
+    {
+      resourceType: resourceTypeIdMap[String(query.type || 0)],
+      resourceIds: JSON.stringify(ids),
+    },
+    createOption(query, 'weapi'),
+  )
+}

module/comment_report.js

@@ -0,0 +1,11 @@
+// 举报评论
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    threadId: 'R_SO_4_' + query.id,
+    commentId: query.cid,
+    reason: query.reason,
+  }
+  return request(`/api/report/reportcomment`, data, createOption(query))
+}

module/decrypt.js

@@ -0,0 +1,97 @@
+const {
+  eapiResDecrypt,
+  eapiReqDecrypt,
+  aesDecrypt,
+  xeapiResDecrypt,
+} = require('../util/crypto')
+const CryptoJS = require('crypto-js')
+
+const linuxapiKey = 'rFgB&h#%2?^eDg:Q'
+
+module.exports = async (query, request) => {
+  const crypto = query.crypto || 'eapi'
+  const data = query.data || query.hexString || ''
+  const isReq = query.isReq !== 'false'
+
+  if (!data) {
+    return {
+      status: 400,
+      body: { code: 400, message: 'data is required' },
+    }
+  }
+
+  try {
+    let result
+    switch (crypto) {
+      case 'eapi': {
+        const pureHex = data.replace(/\s/g, '')
+        result = isReq ? eapiReqDecrypt(pureHex) : eapiResDecrypt(pureHex)
+        break
+      }
+
+      case 'weapi': {
+        if (isReq) {
+          return {
+            status: 400,
+            body: {
+              code: 400,
+              message:
+                'weapi 请求解密需要 RSA 私钥，暂不支持；仅支持 weapi 返回数据解密（e_r=true 时与 eapi 相同）',
+            },
+          }
+        }
+        const pureHex = data.replace(/\s/g, '')
+        result = eapiResDecrypt(pureHex)
+        break
+      }
+
+      case 'linuxapi': {
+        if (isReq) {
+          const pureHex = data.replace(/\s/g, '')
+          const decrypted = aesDecrypt(pureHex, linuxapiKey, '', 'hex')
+          result = JSON.parse(decrypted.toString(CryptoJS.enc.Utf8))
+        } else {
+          result = typeof data === 'string' ? JSON.parse(data) : data
+        }
+        break
+      }
+
+      case 'xeapi': {
+        if (isReq) {
+          return {
+            status: 400,
+            body: {
+              code: 400,
+              message:
+                'xeapi 请求解密涉及 X25519 ECDH 密钥交换，流程复杂，暂不支持；仅支持 xeapi 返回数据解密',
+            },
+          }
+        }
+        const buf = Buffer.from(data, 'base64')
+        result = xeapiResDecrypt(buf)
+        break
+      }
+
+      case 'api': {
+        result = typeof data === 'string' ? JSON.parse(data) : data
+        break
+      }
+
+      default:
+        return {
+          status: 400,
+          body: { code: 400, message: `未知加密方式: ${crypto}` },
+        }
+    }
+
+    return {
+      status: 200,
+      body: { code: 200, data: result },
+    }
+  } catch (error) {
+    return {
+      status: 400,
+      body: { code: 400, message: `解密失败: ${error.message}` },
+    }
+  }
+}

module/dj_difm_all_style_channel.js

@@ -0,0 +1,9 @@
+// DIFM电台 - 分类
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    sources: query.sources || '[0]',
+  }
+  return request(`/api/dj/difm/all/style/channel/v2`, data, createOption(query))
+}

module/dj_difm_channel_subscribe.js

@@ -0,0 +1,9 @@
+// DIFM电台 - 收藏频道
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    id: query.id,
+  }
+  return request(`/api/dj/difm/channel/subscribe`, data, createOption(query))
+}

module/dj_difm_channel_unsubscribe.js

@@ -0,0 +1,9 @@
+// DIFM电台 - 取消收藏频道
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    id: query.id,
+  }
+  return request(`/api/dj/difm/channel/unsubscribe`, data, createOption(query))
+}

module/dj_difm_playing_tracks_list.js

@@ -0,0 +1,11 @@
+// DIFM电台 - 播放列表
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    limit: query.limit || 5,
+    source: query.source || 0,
+    channelId: query.channelId,
+  }
+  return request(`/api/dj/difm/playing/tracks/list`, data, createOption(query))
+}

module/dj_difm_subscribe_channels_get.js

@@ -0,0 +1,13 @@
+// DIFM电台 - 收藏列表
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    sources: query.sources || '[0]',
+  }
+  return request(
+    `/api/dj/difm/subscribe/channels/get/v2`,
+    data,
+    createOption(query),
+  )
+}

module/lbs_city_code.js

@@ -0,0 +1,9 @@
+// 多级行政区划数据获取接口
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    bizCode: query.bizCode || '',
+  }
+  return request(`/api/lbs/city/code`, data, createOption(query))
+}

module/listen_data_song_play_rank.js

@@ -0,0 +1,12 @@
+// 听歌足迹 - 歌曲播放排行 (Top20)
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  return request(
+    `/api/content/activity/listen/data/song/play/rank`,
+    {
+      type: query.type || 'month', //周 week 月 month
+      endTime: query.endTime, // 不填就是本周/月的
+    },
+    createOption(query),
+  )
+}

module/login_cellphone.js

@@ -13,12 +13,12 @@ module.exports = async (query, request) => {
     [query.captcha ? 'captcha' : 'password']: query.captcha
       ? query.captcha
       : query.md5_password || CryptoJS.MD5(query.password).toString(),
-    rememberLogin: 'true',
+    remember: 'true',
   }
   let result = await request(
     `/api/w/login/cellphone`,
     data,
-    createOption(query),
+    createOption(query, 'weapi'),
   )
 
   if (result.body.code === 200) {

module/login_qr_create.js

@@ -1,9 +1,20 @@
 const QRCode = require('qrcode')
+const { generateChainId } = require('../util/index')
 
-const createOption = require('../util/option.js')
+module.exports = (query) => {
-module.exports = (query, request) => {
   return new Promise(async (resolve) => {
-    const url = `https://music.163.com/login?codekey=${query.key}`
+    const platform = query.platform || 'pc'
+    const cookie = query.cookie || ''
+
+    // 构建基础URL
+    let url = `https://music.163.com/login?codekey=${query.key}`
+
+    // 如果是web平台，则添加chainId参数
+
+    if (platform === 'web') {
+      const chainId = generateChainId(cookie)
+      url += `&chainId=${chainId}`
+    }
     return resolve({
       code: 200,
       status: 200,

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'),
+  )
+}

module/pl_count.js

@@ -1,4 +1,5 @@
 // 私信和通知接口
+
 const createOption = require('../util/option.js')
 module.exports = (query, request) => {
   const data = {}

module/playlist_category_list.js

@@ -0,0 +1,11 @@
+// 歌单分类列表
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    cat: query.cat || '全部',
+    limit: query.limit || 24,
+    newStyle: true,
+  }
+  return request(`/api/playlist/category/list`, data, createOption(query))
+}

module/playlist_catlist.js

@@ -2,5 +2,5 @@
 
 const createOption = require('../util/option.js')
 module.exports = (query, request) => {
-  return request(`/api/playlist/catalogue`, {}, createOption(query, 'weapi'))
+  return request(`/api/playlist/catalogue`, {}, createOption(query, 'eapi'))
 }

module/playlist_subscribe.js

@@ -1,10 +1,14 @@
 // 收藏与取消收藏歌单
-
+const { APP_CONF } = require('../util/config.json')
 const createOption = require('../util/option.js')
 module.exports = (query, request) => {
-  query.t = query.t == 1 ? 'subscribe' : 'unsubscribe'
+  const path = query.t == 1 ? 'subscribe' : 'unsubscribe'
   const data = {
     id: query.id,
+    ...(query.t === 1
+      ? { checkToken: query.checkToken || APP_CONF.checkToken }
+      : {}),
   }
-  return request(`/api/playlist/${query.t}`, data, createOption(query, 'weapi'))
+  query.checkToken = true // 强制开启checkToken
+  return request(`/api/playlist/${path}`, data, createOption(query, 'eapi'))
 }

module/radio_sport_get.js

@@ -0,0 +1,9 @@
+// 跑步漫游
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    bpm: query.bpm || 50,
+  }
+  return request(`/api/radio/sport/get`, data, createOption(query))
+}

module/recommend_songs.js

@@ -2,7 +2,9 @@
 
 const createOption = require('../util/option.js')
 module.exports = (query, request) => {
-  const data = {}
+  const data = {
+    afresh: query.afresh,
+  }
   return request(
     `/api/v3/discovery/recommend/songs`,
     data,

module/register_anonimous.js

@@ -1,18 +1,17 @@
+// 获取游客cookie
+
 const CryptoJS = require('crypto-js')
 const path = require('path')
 const fs = require('fs')
 const ID_XOR_KEY_1 = '3go8&$8*3*3h0k(2)2'
-const deviceidText = fs.readFileSync(
+const logger = require('../util/logger.js')
-  path.resolve(__dirname, '../data/deviceid.txt'),
-  'utf-8',
-)
 
 const createOption = require('../util/option.js')
-const deviceidList = deviceidText.split('\n')
+const { generateDeviceId } = require('../util/index')
 
-function getRandomFromList(list) {
+// function getRandomFromList(list) {
-  return list[Math.floor(Math.random() * list.length)]
+//   return list[Math.floor(Math.random() * list.length)]
-}
+// }
 function cloudmusic_dll_encode_id(some_id) {
   let xoredString = ''
   for (let i = 0; i < some_id.length; i++) {
@@ -26,7 +25,8 @@ function cloudmusic_dll_encode_id(some_id) {
 }
 
 module.exports = async (query, request) => {
-  const deviceId = getRandomFromList(deviceidList)
+  const deviceId = generateDeviceId()
+  logger.info(`Successfully registered anonimous token, deviceId: ${deviceId}`)
   global.deviceId = deviceId
   const encodedId = CryptoJS.enc.Base64.stringify(
     CryptoJS.enc.Utf8.parse(
@@ -39,7 +39,7 @@ module.exports = async (query, request) => {
   let result = await request(
     `/api/register/anonimous`,
     data,
-    createOption(query, 'weapi'),
+    createOption(query, 'xeapi'),
   )
   if (result.body.code === 200) {
     result = {

module/register_cellphone.js

@@ -9,6 +9,7 @@ module.exports = (query, request) => {
     password: CryptoJS.MD5(query.password).toString(),
     nickname: query.nickname,
     countrycode: query.countrycode || '86',
+    force: 'false',
   }
-  return request(`/api/register/cellphone`, data, createOption(query))
+  return request(`/api/w/register/cellphone`, data, createOption(query))
 }

module/register_xeapikey.js

@@ -0,0 +1,74 @@
+const { default: axios } = require('axios')
+const encrypt = require('../util/crypto')
+const { APP_CONF } = require('../util/config.json')
+
+const generateNonce = () => {
+  let nonce = ''
+  for (let i = 0; i < 16; i++) {
+    nonce += Math.floor(Math.random() * 10).toString()
+  }
+  return nonce
+}
+
+module.exports = async (query, request) => {
+  const nonce = generateNonce()
+  const timestamp = String(Date.now())
+  const deviceId = query.deviceId || global.deviceId || ''
+  const currentKeyVersion = query.currentKeyVersion || ''
+
+  const data = {
+    appVersion: '9.1.65',
+    currentKeyVersion,
+    deviceId,
+    nonce,
+    os: 'android',
+    requestType: 'active',
+    signature: encrypt.xeapiSign(timestamp, nonce),
+    t1: '',
+    t2: '',
+    timestamp,
+    uid: '',
+  }
+
+  const res = await axios({
+    method: 'POST',
+    url: APP_CONF.apiDomain + '/api/gorilla/anti/crawler/security/key/get',
+    headers: {
+      'User-Agent':
+        'NeteaseMusic/9.1.65.240927161425(9001065);Dalvik/2.1.0 (Linux; U; Android 14; 23013RK75C Build/UKQ1.230804.001)',
+      Cookie: deviceId ? `deviceId=${encodeURIComponent(deviceId)}` : '',
+    },
+    data: new URLSearchParams(data).toString(),
+    proxy: false,
+  })
+
+  if (
+    !res.data ||
+    res.data.code !== 200 ||
+    !res.data.data ||
+    !res.data.data.encryptedData
+  ) {
+    throw new Error('xeapi public key request failed')
+  }
+  if (
+    !res.data.data.signature ||
+    encrypt.xeapiSign(res.data.data.timestamp, nonce) !==
+      res.data.data.signature
+  ) {
+    throw new Error('xeapi public key response signature mismatch')
+  }
+
+  const publicKey = encrypt.xeapiDecryptPublicKey(res.data.data.encryptedData)
+  if (!publicKey.sk) {
+    throw new Error('xeapi public key response missing sk')
+  }
+
+  return {
+    status: 200,
+    body: {
+      ...publicKey,
+      deviceId,
+    },
+    cookie: [],
+  }
+}

module/relay_play_state_submit.js

@@ -0,0 +1,49 @@
+// 提交歌曲播放状态
+
+const createOption = require('../util/option.js')
+const generateSessionId = () =>
+  Array.from(
+    { length: 12 },
+    () =>
+      'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'[Math.floor(Math.random() * 36)],
+  ).join('')
+
+module.exports = (query, request) => {
+  const {
+    id,
+    sessionId,
+    progress = 0,
+    playMode = 'list_loop',
+    type = 'song',
+  } = query
+
+  if (!id) {
+    return Promise.reject({
+      status: 400,
+      body: {
+        code: 400,
+        msg: '缺少必要参数：id',
+      },
+    })
+  }
+
+  const playStateSubmitReq = JSON.stringify({
+    resource: {
+      id: String(id),
+      type: type,
+    },
+    progress: Number(progress) || 0,
+    sessionId: sessionId || generateSessionId(),
+    playMode: playMode,
+  })
+
+  const data = {
+    playStateSubmitReq: playStateSubmitReq,
+  }
+
+  return request(
+    '/api/relay/play/state/submit',
+    data,
+    createOption(query, 'weapi'),
+  )
+}

module/sati_resource_list.js

@@ -0,0 +1,11 @@
+// 助眠解压 - 获取标签下资源列表
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    tag: query.tag,
+    firstQuery: false,
+  }
+
+  return request(`/api/voice/sati/resource/list`, data, createOption(query))
+}

module/sati_resource_list_more.js

@@ -0,0 +1,13 @@
+// 助眠解压 - 查看同类推荐
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    id: query.id,
+  }
+  return request(
+    `/api/voice/sati/resource/list/more/v1`,
+    data,
+    createOption(query),
+  )
+}

module/sati_resource_sub.js

@@ -0,0 +1,10 @@
+// 助眠解压 - 收藏
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    id: query.id,
+    cancel: query.cancel || false,
+  }
+  return request(`/api/voice/sati/resource/sub`, data, createOption(query))
+}

module/sati_resource_sub_list.js

@@ -0,0 +1,7 @@
+// 助眠解压 - 收藏列表
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {}
+  return request(`/api/voice/sati/resource/sub/list`, data, createOption(query))
+}

module/sati_tag_list.js

@@ -0,0 +1,7 @@
+// 助眠解压 - 标签列表
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {}
+  return request(`/api/voice/sati/tag/list`, data, createOption(query))
+}

module/sati_timescene_resources_get.js

@@ -0,0 +1,13 @@
+// 助眠解压 - 特定时间场景下的推荐资源
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    firstQuery: false,
+  }
+  return request(
+    `/api/voice/sati/timescene/resources/get`,
+    data,
+    createOption(query),
+  )
+}

module/scrobble.js

@@ -1,8 +1,42 @@
 // 听歌打卡
 
 const createOption = require('../util/option.js')
-module.exports = (query, request) => {
+const { APP_CONF } = require('../util/config.json')
-  const data = {
+const DOMAIN = APP_CONF.clDomian
+module.exports = async (query, request) => {
+  // 注入 os=osx 的 cookie
+  let cookie = query.cookie || ''
+  if (typeof cookie === 'object') {
+    cookie = Object.assign({ os: 'osx' }, cookie)
+  } else if (typeof cookie === 'string') {
+    if (cookie.indexOf('os=') > -1) {
+      cookie = cookie.replace(/os=[^;]+/g, 'os=osx')
+    } else {
+      cookie = cookie + '; os=osx'
+    }
+  } else {
+    cookie = 'os=osx'
+  }
+  query.cookie = cookie
+
+  // 1) startplay → 进「最近播放」
+  const startplayData = {
+    logs: JSON.stringify([
+      {
+        action: 'startplay',
+        json: {
+          id: query.id,
+          type: 'song',
+          mainsite: '1',
+          mainsiteWeb: '1',
+          content: `id=${query.sourceid}`,
+        },
+      },
+    ]),
+  }
+
+  // 2) play → 涨「听歌排行」计数
+  const playData = {
     logs: JSON.stringify([
       {
         action: 'play',
@@ -15,12 +49,30 @@ module.exports = (query, request) => {
           type: 'song',
           wifi: 0,
           source: 'list',
-          mainsite: 1,
+          mainsite: '1',
-          content: '',
+          mainsiteWeb: '1',
+          content: `id=${query.sourceid}`,
         },
       },
     ]),
   }
 
-  return request(`/api/feedback/weblog`, data, createOption(query, 'weapi'))
+  const option = createOption(query, 'eapi')
+  option.domain = DOMAIN
+
+  // 发送两次请求
+  const res1 = await request(`/api/feedback/weblog`, startplayData, option)
+  const res2 = await request(`/api/feedback/weblog`, playData, option)
+
+  return {
+    status: 200,
+    body: {
+      code: 200,
+      data: 'success',
+      details: {
+        startplay: res1.body,
+        play: res2.body,
+      },
+    },
+  }
 }

module/scrobble_v1.js

@@ -0,0 +1,128 @@
+// 听歌打卡 - NCBL 加密版 (仿桌面客户端 PLV/PLD 上报)
+// 复制自 https://github.com/folltoshe/netease-report-listen-song 的 PC 端日志上报方式
+//
+// PLV 和 PLD 分两次独立上传
+
+const {
+  buildPlv,
+  buildPld,
+  buildRecords,
+  extractContext,
+  parseCookie,
+  buildCookieStr,
+  buildMetaJson,
+  doUpload,
+} = require('../util/ncbl')
+
+module.exports = async (query, request) => {
+  // --- 参数校验 ---
+  const songId = Number(query.id)
+  if (!songId || isNaN(songId)) {
+    return { status: 400, body: { code: 400, msg: '缺少有效的 id (歌曲ID)' } }
+  }
+  const playTime = Number(query.time)
+  if (isNaN(playTime) || playTime <= 0) {
+    return {
+      status: 400,
+      body: { code: 400, msg: '缺少有效的 time (播放时长)' },
+    }
+  }
+  const totalTime = Number(query.total) || playTime
+  const sourceId = String(query.sourceid || query.sourceId || '')
+  const sourceName = query.source || 'list'
+
+  // --- 解析认证上下文 ---
+  const rawCookie = query.cookie || ''
+  const cookieObj = parseCookie(rawCookie)
+  cookieObj.os = 'pc'
+  const ctx = extractContext(cookieObj)
+
+  // 兜底取 token
+  if (!ctx.auth.token && rawCookie) {
+    const parsed =
+      typeof rawCookie === 'string' ? parseCookie(rawCookie) : rawCookie
+    ctx.auth.token = parsed.MUSIC_U || ''
+  }
+
+  if (!ctx.auth.token) {
+    return { status: 401, body: { code: 401, msg: '缺少 MUSIC_U 鉴权令牌' } }
+  }
+
+  // --- 构建歌曲和来源 ---
+  const song = {
+    id: songId,
+    name: query.name || '',
+    artist: query.artist || '',
+    bitrate: Number(query.bitrate) || 320,
+    level: query.level || 'exhigh',
+    vip: query.vip === 'true' || query.vip === true,
+    time: totalTime,
+  }
+  const source = {
+    id: sourceId || String(songId),
+    type: 'track',
+    name: sourceName,
+  }
+
+  const metaJson = buildMetaJson(ctx)
+  const cookieStr = buildCookieStr(ctx)
+
+  const ts = Math.floor(Date.now() / 1000)
+  const played = Math.min(playTime, totalTime)
+
+  const plvBody = buildRecords([
+    { time: ts, action: '_plv', data: buildPlv(ctx, song, source) },
+  ])
+  const pldBody = buildRecords([
+    { time: ts, action: '_pld', data: buildPld(ctx, song, source, played) },
+  ])
+
+  try {
+    // 1) 上传 PLV
+    const plv = await doUpload(ctx, metaJson, plvBody, cookieStr, 'PLV')
+    if (!plv.success) {
+      const rateMsg =
+        plv.respBody?.data?.rate != null
+          ? ` (rate=${plv.respBody.data.rate})`
+          : ''
+      return {
+        status: 200,
+        body: {
+          code: plv.respBody?.code || -1,
+          msg: `PLV 上报失败${rateMsg}`,
+          details: plv.respBody,
+        },
+      }
+    }
+
+    // 2) 上传 PLD
+    const pld = await doUpload(ctx, metaJson, pldBody, cookieStr, 'PLD')
+    if (!pld.success) {
+      return {
+        status: 200,
+        body: {
+          code: pld.respBody?.code || -1,
+          msg: 'PLV 成功但 PLD 失败',
+          details: { plv: plv.respBody, pld: pld.respBody },
+        },
+      }
+    }
+
+    return {
+      status: 200,
+      body: {
+        code: 200,
+        data: 'scrobble_v1 上报成功',
+        details: {
+          plv: { fileName: plv.fileName, payloadSize: plv.payload.length },
+          pld: { fileName: pld.fileName, payloadSize: pld.payload.length },
+        },
+      },
+    }
+  } catch (err) {
+    return {
+      status: 502,
+      body: { code: 502, msg: `请求异常: ${err.message || err}` },
+    }
+  }
+}

module/search_suggest_pc.js

@@ -0,0 +1,13 @@
+// 搜索建议pc端
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    keyword: query.keyword || '',
+  }
+  return request(
+    `/api/search/pc/suggest/keyword/get`,
+    data,
+    createOption(query),
+  )
+}

module/song_cloud_download.js

@@ -0,0 +1,9 @@
+// 从云盘获取歌曲下载链接
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    songId: query.id,
+  }
+  return request(`/api/cloud/dowonload`, data, createOption(query, 'eapi'))
+}

module/song_copyright_rcmd.js

@@ -0,0 +1,9 @@
+// 灰色歌曲的其他版本推荐
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    songid: query.songid || query.id,
+  }
+  return request(`/api/song/copyright/rcmd`, data, createOption(query, 'eapi'))
+}

module/song_creators.js

@@ -0,0 +1,9 @@
+// 歌曲创作者信息
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    songId: query.id,
+  }
+  return request(`/api/song/creators`, data, createOption(query))
+}

module/song_like.js

@@ -0,0 +1,12 @@
+// 喜欢歌曲
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const like = query.like !== 'false'
+  const data = {
+    trackId: query.id,
+    userid: query.uid,
+    like: like,
+  }
+  return request(`/api/song/like`, data, createOption(query))
+}

module/song_url_match.js

@@ -5,31 +5,34 @@ const createOption = require('../util/option.js')
 const logger = require('../util/logger.js')
 
 module.exports = async (query, request) => {
-    try {
+  try {
-        const match = require("@unblockneteasemusic/server")
+    const {
-        const source = query.source
+      matchID,
-            ? query.source.split(',') : ['pyncmd', 'kuwo', 'qq', 'migu', 'kugou']
+    } = require('@neteasecloudmusicapienhanced/unblockmusic-utils')
-        const server = query.server ? query.server.split(',') : query.server
+    const result = await matchID(query.id, query.source)
-        const result = await match(query.id, !server? source : server)
+    const proxy = process.env.PROXY_URL
-        const proxy = process.env.PROXY_URL;
+    logger.info('开始解灰', query.id, result)
-        logger.info("开始解灰", query.id, result)
+    const useProxy = process.env.ENABLE_PROXY || 'false'
-        const useProxy = process.env.ENABLE_PROXY || "false"
+    if (result.data.url && result.data.url.includes('kuwo')) {
-        if (result.url.includes('kuwo')) { result.proxyUrl = useProxy === 'true' ? proxy + result.url : result.url }
+      result.proxyUrl =
-        return {
+        useProxy === 'true' ? proxy + result.data.url : result.data.url
-            status: 200,
-            body: {
-                code: 200,
-                data: result,
-            },
-        }
-    } catch (e) {
-        return {
-            status: 500,
-            body: {
-                code: 500,
-                msg: e.message || 'unblock error',
-                data: [],
-            },
-        }
     }
+    return {
+      status: 200,
+      body: {
+        code: 200,
+        data: result.data.url,
+        proxyUrl: result.proxyUrl || '',
+      },
+    }
+  } catch (e) {
+    return {
+      status: 500,
+      body: {
+        code: 500,
+        msg: e.message || 'unblock error',
+        data: [],
+      },
+    }
+  }
 }

module/song_url_ncmget.js

@@ -1,75 +1,5 @@
-// GD音乐台get(适配SPlayer的UNM-Server)
+// 夹带私货的东西就不要放在这里了
-// 感谢来自GD Studio的开发API
-// https://music.gdstudio.xyz/
-
-const createOption = require('../util/option.js')
 
 module.exports = async (query, request) => {
-    try {
+  return { status: 200, body: { code: 200, data: [] } }
-        const { id, br = "320" } = query;
-        if (!id) {
-            return {
-                status: 400,
-                body: {
-                    code: 400,
-                    message: "缺少必要参数 id",
-                    data: [],
-                },
-            };
-        }
-        const validBR = ["128", "192", "320", "740", "999"];
-        // const covertBR = ["128000", "192000", "320000","740000", "999000"];
-        if (!validBR.includes(br)) {
-            return {
-                status: 400,
-                body: {
-                    code: 400,
-                    message: "无效音质参数",
-                    allowed_values: validBR,
-                    data: [],
-                },
-            };
-        }
-
-        const apiUrl = new URL("https://music-api.gdstudio.xyz/api.php");
-        apiUrl.searchParams.append("types", "url");
-        apiUrl.searchParams.append("id", id);
-        apiUrl.searchParams.append("br", br);
-
-        const response = await fetch(apiUrl.toString());
-        if (!response.ok) throw new Error(`API 响应状态: ${response.status}`);
-        const result = await response.json();
-
-        // 代理逻辑
-        const useProxy = process.env.ENABLE_PROXY || false;
-        const proxy = process.env.PROXY_URL;
-        if (useProxy && result.url && result.url.includes("kuwo")) {
-            result.proxyUrl = proxy + result.url.replace(/^http:\/\//, "http/");
-        }
-
-        return {
-            status: 200,
-            body: {
-                code: 200,
-                message: "请求成功",
-                data: {
-                    id,
-                    br,
-                    url: result.url,
-                    ...(proxy && result.proxyUrl ? { proxyUrl: result.proxyUrl } : {})
-                }
-            }
-        };
-    } catch (error) {
-        console.error("Error in song_url_ncmget:", error);
-        return {
-            status: 500,
-            body: {
-                code: 500,
-                message: "服务器处理请求失败",
-                ...(process.env.NODE_ENV === "development" ? { error: error.message } : {}),
-                data: [],
-            },
-        };
-    }
 }

module/song_url_unblock.js

@@ -1,35 +0,0 @@
-// 网易云歌曲解灰
-// 支持qq音乐、酷狗音乐、酷我音乐、咪咕音乐、第三方网易云API等等(来自GD音乐台)
-
-const createOption = require('../util/option.js')
-const logger = require('../util/logger.js')
-
-module.exports = async (query, request) => {
-    try {
-        const match = require("@unblockneteasemusic/server")
-        const source = query.source
-            ? query.source.split(',') : ['pyncmd', 'kuwo', 'qq', 'migu', 'kugou']
-        const server = query.server ? query.server.split(',') : query.server
-        const result = await match(query.id, !server? source : server)
-        const proxy = process.env.PROXY_URL;
-        logger.info("开始解灰", query.id, result)
-        const useProxy = process.env.ENABLE_PROXY || "false"
-        if (result.url.includes('kuwo') && useProxy === "true") { result.proxyUrl = proxy + result.url }
-        return {
-            status: 200,
-            body: {
-                code: 200,
-                data: result,
-            },
-        }
-    } catch (e) {
-        return {
-            status: 500,
-            body: {
-                code: 500,
-                msg: e.message || 'unblock error',
-                data: [],
-            },
-        }
-    }
-}

module/song_url_v1.js

@@ -1,13 +1,14 @@
 // 歌曲链接 - v1
 // 此版本不再采用 br 作为音质区分的标准
 // 而是采用 standard, exhigh, lossless, hires, jyeffect(高清环绕声), sky(沉浸环绕声), jymaster(超清母带) 进行音质判断
-// 当unblock为true时, 会尝试使用unblockneteasemusic进行解锁, 同时音质设置不会生效, 但仍然为必须传入参数
+// 当unblock为true时, 会尝试使用unblockmusic-utils进行解锁, 同时音质设置不会生效, 但仍然为必须传入参数
 
 const logger = require('../util/logger.js')
 const createOption = require('../util/option.js')
 module.exports = async (query, request) => {
-  const match = require('@unblockneteasemusic/server')
+  const {
-  const source = ['pyncmd','kuwo', 'qq', 'migu', 'kugou']
+    matchID,
+  } = require('@neteasecloudmusicapienhanced/unblockmusic-utils')
   require('dotenv').config()
   const data = {
     ids: '[' + query.id + ']',
@@ -16,39 +17,45 @@ module.exports = async (query, request) => {
   }
   if (query.unblock === 'true') {
     try {
-      const result = await match(query.id, source)
+      const result = await matchID(query.id, query.source)
-      logger.info('开始解灰', query.id, result)
+      logger.info('Starting unblock(uses modules unblock):', query.id, result)
-      if (result.url.includes('kuwo')) {
+      const useProxy = process.env.ENABLE_PROXY || 'false'
-        const useProxy = process.env.ENABLE_PROXY || 'false'
+      let proxyUrl = ''
-        var proxyUrl = useProxy === 'true' ? process.env.PROXY_URL + result.url : result.url
+      if (result.data.url && result.data.url.includes('kuwo')) {
+        proxyUrl =
+          useProxy === 'true' && process.env.PROXY_URL
+            ? process.env.PROXY_URL + result.data.url
+            : result.data.url
       }
-      let url = Array.isArray(result) ? (result[0]?.url || result[0]) : (result.url || result)
+      return {
-      if (url) {
+        status: 200,
-        return {
+        body: {
-          status: 200,
+          code: 200,
-          body: {
+          msg: 'Warning: Customizing unblock sources is not supported on this endpoint. Please use `/song/url/match` instead.',
-            code: 200,
+          data: [
-            data: [
+            {
-              {
+              id: Number(query.id),
-                id: Number(query.id),
+              url: result.data.url,
-                url,
+              type: 'flac',
-                type: 'flac',
+              level: query.level,
-                level: query.level,
+              freeTrialInfo: 'null',
-                freeTrialInfo: 'null',
+              fee: 0,
-                fee: 0,
+              proxyUrl: proxyUrl || '',
-                proxyUrl: proxyUrl || '',
+            },
-              },
+          ],
-            ],
+        },
-          },
+        cookie: [],
-          cookie: [],
-        }
       }
     } catch (e) {
-      console.error('Error in unblockneteasemusic:', e)
+      console.error('Error in unblocking music:', e)
     }
   }
   if (data.level == 'sky') {
     data.immerseType = 'c51'
   }
-  return request(`/api/song/enhance/player/url/v1`, data, createOption(query))
+  return request(
+    `/api/song/enhance/player/url/v1`,
+    data,
+    createOption(query, 'xeapi'),
+  )
 }

module/song_url_v1_302.js

@@ -0,0 +1,53 @@
+// 获取客户端歌曲下载链接 - v1
+// 此版本不再采用 br 作为音质区分的标准
+// 而是采用 standard, exhigh, lossless, hires, jyeffect(高清环绕声), sky(沉浸环绕声), jymaster(超清母带) 进行音质判断
+
+const createOption = require('../util/option.js')
+module.exports = async (query, request) => {
+  const data = {
+    id: query.id,
+    immerseType: 'c51',
+    level: query.level,
+  }
+  const response = await request(
+    `/api/song/enhance/download/url/v1`,
+    data,
+    createOption(query),
+  )
+  let url = response?.body?.data?.[0]?.url
+
+  if (!url) {
+    const fallbackData = {
+      ids: `[${query.id}]`,
+      level: query.level,
+      encodeType: 'flac',
+    }
+    if (query.level === 'sky') {
+      fallbackData.immerseType = 'c51'
+    }
+    const fallback = await request(
+      `/api/song/enhance/player/url/v1`,
+      fallbackData,
+      createOption(query),
+    )
+    url = fallback?.body?.data?.[0]?.url
+
+    if (!url) {
+      return fallback
+    }
+
+    return {
+      status: 302,
+      body: '',
+      cookie: fallback.cookie || [],
+      redirectUrl: url,
+    }
+  }
+
+  return {
+    status: 302,
+    body: '',
+    cookie: response.cookie || [],
+    redirectUrl: url,
+  }
+}

module/toplist_detail_v2.js

@@ -0,0 +1,6 @@
+// 所有榜单内容摘要v2
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  return request(`/api/toplist/detail/v2`, {}, createOption(query, 'weapi'))
+}

module/user_detail_new.js

@@ -0,0 +1,20 @@
+// 用户详情
+
+const createOption = require('../util/option.js')
+module.exports = async (query, request) => {
+  const data = {
+    all: 'true',
+    userId: query.uid,
+  }
+  const res = await request(
+    `/api/w/v1/user/detail/${query.uid}`,
+    data,
+    createOption(query, 'eapi'),
+  )
+  // const result = JSON.stringify(res).replace(
+  //   /avatarImgId_str/g,
+  //   "avatarImgIdStr"
+  // );
+  // return JSON.parse(result);
+  return res
+}

module/user_followeds.js

@@ -5,7 +5,7 @@ module.exports = (query, request) => {
   const data = {
     userId: query.uid,
     time: '0',
-    limit: query.limit || 30,
+    limit: query.limit || 20,
     offset: query.offset || 0,
     getcounts: 'true',
   }

module/user_playlist_collect.js

@@ -0,0 +1,14 @@
+// 获取用户的收藏歌单列表
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    limit: query.limit || '100',
+    offset: query.offset || '0',
+    userId: query.uid,
+    isWebview: 'true',
+    includeRedHeart: 'true',
+    includeTop: 'true',
+  }
+  return request(`/api/user/playlist/collect`, data, createOption(query))
+}

module/user_playlist_create.js

@@ -0,0 +1,14 @@
+// 获取用户的创建歌单列表
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    limit: query.limit || '100',
+    offset: query.offset || '0',
+    userId: query.uid,
+    isWebview: 'true',
+    includeRedHeart: 'true',
+    includeTop: 'true',
+  }
+  return request(`/api/user/playlist/create`, data, createOption(query))
+}

module/vip_growthpoint_getall.js

@@ -0,0 +1,11 @@
+// 一键领取所有会员成长值
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {}
+  return request(
+    `/api/vipnewcenter/app/level/task/reward/getall`,
+    data,
+    createOption(query, 'xeapi'),
+  )
+}

module/vip_sign.js

@@ -0,0 +1,40 @@
+// 黑胶乐签打卡
+
+const createOption = require('../util/option.js')
+
+module.exports = async (query, request) => {
+  const results = {}
+
+  const taskSign = await request(
+    '/api/vip-center-bff/task/sign',
+    {},
+    createOption(query, 'weapi'),
+  )
+  results.taskSign = taskSign.body
+
+  const checkinDetail = await request(
+    '/api/vipnewcenter/app/level/user/checkin/history/detail',
+    {
+      signDayTime: Date.now(),
+      type: 1,
+    },
+    createOption(query, 'eapi'),
+  )
+  results.checkinDetail = checkinDetail.body
+
+  // 两个接口都返回 code=200 即视为打卡成功
+  const signed =
+    Number(results.taskSign?.code) === 200 &&
+    Number(results.checkinDetail?.code) === 200
+
+  return {
+    body: {
+      code: 200,
+      ...results,
+      signed,
+      message: signed ? '黑胶乐签打卡成功' : '黑胶乐签打卡失败',
+    },
+    cookie: taskSign.cookie,
+    status: 200,
+  }
+}

module/vip_sign_detail.js

@@ -0,0 +1,14 @@
+// 黑胶乐签打卡详情
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    signDayTime: query.timestamp,
+    type: '1',
+  }
+  return request(
+    `/api/vipnewcenter/app/level/user/checkin/history/detail`,
+    data,
+    createOption(query, 'eapi'),
+  )
+}

module/vip_sign_history.js

@@ -0,0 +1,14 @@
+// 黑胶乐签打卡历史 / 状态查询
+// 支持传入 type=0（用户信息栏）或 type=1（黑胶乐签）
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    type: query.type || '0',
+  }
+  return request(
+    `/api/vipnewcenter/app/minidesk/music/sign/pc`,
+    data,
+    createOption(query, 'eapi'),
+  )
+}

module/vip_sign_info.js

@@ -0,0 +1,11 @@
+// 黑胶乐签未来签到信息
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {}
+  return request(
+    `/api/vipnewcenter/app/user/sign/info`,
+    data,
+    createOption(query, 'weapi'),
+  )
+}

module/vip_tasks_v1.js

@@ -0,0 +1,14 @@
+// 会员任务 - 新版
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    taskType: 'app_vip_task_center',
+    userId: query.id,
+  }
+  return request(
+    `/api/middle/vip/mission/user/progress/list`,
+    data,
+    createOption(query, 'xeapi'),
+  )
+}

module/voice_upload.js

@@ -1,25 +1,26 @@
 const { default: axios } = require('axios')
+const fs = require('fs')
 var xml2js = require('xml2js')
 
 const createOption = require('../util/option.js')
-var parser = new xml2js.Parser(/* options */)
+const { getFileExtension, readFileChunk } = require('../util/fileHelper')
+
+var parser = new xml2js.Parser()
+
 function createDupkey() {
-  // 格式:3b443c7c-a87f-468d-ba38-46d407aaf23a
   var s = []
   var hexDigits = '0123456789abcdef'
   for (var i = 0; i < 36; i++) {
     s[i] = hexDigits.substr(Math.floor(Math.random() * 0x10), 1)
   }
-  s[14] = '4' // bits 12-15 of the time_hi_and_version field to 0010
+  s[14] = '4'
-  s[19] = hexDigits.substr((s[19] & 0x3) | 0x8, 1) // bits 6-7 of the clock_seq_hi_and_reserved to 01
+  s[19] = hexDigits.substr((s[19] & 0x3) | 0x8, 1)
   s[8] = s[13] = s[18] = s[23] = '-'
   return s.join('')
 }
+
 module.exports = async (query, request) => {
-  let ext = 'mp3'
+  const ext = getFileExtension(query.songFile.name)
-  if (query.songFile.name.indexOf('flac') > -1) {
-    ext = 'flac'
-  }
   const filename =
     query.songName ||
     query.songFile.name
@@ -50,43 +51,58 @@ module.exports = async (query, request) => {
     createOption(query, 'weapi'),
   )
 
-  const objectKey = tokenRes.body.result.objectKey.replace('/', '%2F')
+  const objectKey = tokenRes.body.result.objectKey.replace(/\//g, '%2F')
   const docId = tokenRes.body.result.docId
   const res = await axios({
     method: 'post',
     url: `https://ymusic.nos-hz.163yun.com/${objectKey}?uploads`,
     headers: {
       'x-nos-token': tokenRes.body.result.token,
-      'X-Nos-Meta-Content-Type': 'audio/mpeg',
+      'X-Nos-Meta-Content-Type': query.songFile.mimetype || 'audio/mpeg',
     },
     data: null,
   })
-  // return xml
+
   const res2 = await parser.parseStringPromise(res.data)
 
-  const fileSize = query.songFile.data.length
+  const useTempFile = !!query.songFile.tempFilePath
-  const blockSize = 10 * 1024 * 1024 // 10MB
+  let fileSize = query.songFile.size
+
+  if (useTempFile) {
+    const stats = await fs.promises.stat(query.songFile.tempFilePath)
+    fileSize = stats.size
+  }
+
+  const blockSize = 10 * 1024 * 1024
   let offset = 0
   let blockIndex = 1
 
   let etags = []
 
   while (offset < fileSize) {
-    const chunk = query.songFile.data.slice(
+    let chunk
-      offset,
+    if (useTempFile) {
-      Math.min(offset + blockSize, fileSize),
+      chunk = await readFileChunk(
-    )
+        query.songFile.tempFilePath,
+        offset,
+        Math.min(blockSize, fileSize - offset),
+      )
+    } else {
+      chunk = query.songFile.data.slice(
+        offset,
+        Math.min(offset + blockSize, fileSize),
+      )
+    }
 
     const res3 = await axios({
       method: 'put',
       url: `https://ymusic.nos-hz.163yun.com/${objectKey}?partNumber=${blockIndex}&uploadId=${res2.InitiateMultipartUploadResult.UploadId[0]}`,
       headers: {
         'x-nos-token': tokenRes.body.result.token,
-        'Content-Type': 'audio/mpeg',
+        'Content-Type': query.songFile.mimetype || 'audio/mpeg',
       },
       data: chunk,
     })
-    // get etag
     const etag = res3.headers.etag
     etags.push(etag)
     offset += blockSize
@@ -101,19 +117,17 @@ module.exports = async (query, request) => {
   }
   completeStr += '</CompleteMultipartUpload>'
 
-  // 文件处理
   await axios({
     method: 'post',
     url: `https://ymusic.nos-hz.163yun.com/${objectKey}?uploadId=${res2.InitiateMultipartUploadResult.UploadId[0]}`,
     headers: {
       'Content-Type': 'text/plain;charset=UTF-8',
-      'X-Nos-Meta-Content-Type': 'audio/mpeg',
+      'X-Nos-Meta-Content-Type': query.songFile.mimetype || 'audio/mpeg',
       'x-nos-token': tokenRes.body.result.token,
     },
     data: completeStr,
   })
 
-  // preCheck
   await request(
     `/api/voice/workbench/voice/batch/upload/preCheck`,
     {

module/voicelist_my_created.js

@@ -0,0 +1,13 @@
+// 我创建的播客声音
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    limit: query.limit || 20,
+  }
+  return request(
+    `/api/social/my/created/voicelist/v1`,
+    data,
+    createOption(query, 'weapi'),
+  )
+}

module/voicelist_search.js

@@ -1,14 +1,11 @@
 const createOption = require('../util/option.js')
 module.exports = (query, request) => {
   const data = {
-    fee: '-1',
+    keyword: query.keyword || '',
-    limit: query.limit || '200',
+    scene: 'normal',
-    offset: query.offset || '0',
+    limit: query.limit || '10',
-    podcastName: query.podcastName || '',
+    offset: query.offset || '30',
+    e_r: true,
   }
-  return request(
+  return request(`/api/search/voicelist/get`, data, createOption(query))
-    `/api/voice/workbench/voicelist/search`,
-    data,
-    createOption(query),
-  )
 }

module_example/test.ts

@@ -1,4 +1,4 @@
-import { banner, lyric } from '@neteaseapireborn/api'
+import { banner, lyric } from '@neteasecloudmusicapienhanced/api'
 import { logger } from '../util/logger.js'
 banner({ type: 0 }).then((res) => {
   logger.info(res)

package.json

@@ -1,16 +1,19 @@
 {
-  "name": "@neteaseapireborn/api",
+  "name": "@neteasecloudmusicapienhanced/api",
-  "version": "4.28.29",
+  "version": "4.36.2",
-  "description": "为停更的网易云音乐 NodeJs API 提供持续的维护！",
+  "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",
     "test": "mocha -r intelli-espower-loader -t 60000 server.test.js main.test.js --exit",
     "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",
+    "docs:format": "node scripts/format-docs.js",
-    "pkglinux": "pkg . -t node18-linux-x64 -C GZip -o bin/app --no-bytecode",
+    "docs:check": "node scripts/format-docs.js --check",
-    "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": {
@@ -19,7 +22,6 @@
       "node_modules/axios",
       "node_modules/express",
       "node_modules/express-fileupload",
-      "node_modules/md5",
       "node_modules/music-metadata",
       "node_modules/pac-proxy-agent",
       "node_modules/qrcode",
@@ -41,6 +43,14 @@
   ],
   "main": "main.js",
   "types": "./interface.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced.git"
+  },
+  "bugs": {
+    "url": "https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced/issues"
+  },
+  "homepage": "https://neteasecloudmusicapienhanced.js.org/",
   "engines": {
     "node": ">=12"
   },
@@ -50,7 +60,7 @@
       "git add"
     ]
   },
-  "author": "binaryify",
+  "author": "MoeFurina",
   "license": "MIT",
   "files": [
     "module",
@@ -65,40 +75,48 @@
     "data"
   ],
   "dependencies": {
-    "@unblockneteasemusic/server": "^0.27.10",
+    "@neteasecloudmusicapienhanced/unblockmusic-utils": "^0.3.4",
-    "axios": "^1.2.2",
+    "axios": "^1.18.1",
     "crypto-js": "^4.2.0",
-    "dotenv": "^16.0.3",
+    "dotenv": "^17.4.2",
-    "express": "^4.17.1",
+    "express": "^5.2.1",
-    "express-fileupload": "^1.1.9",
+    "express-fileupload": "^1.5.2",
-    "md5": "^2.3.0",
+    "gzip": "^0.1.0",
-    "music-metadata": "^7.5.3",
+    "music-metadata": "^11.13.0",
-    "node-forge": "^1.3.1",
+    "node-forge": "^1.4.0",
-    "pac-proxy-agent": "^7.0.0",
+    "pac-proxy-agent": "^7.2.0",
-    "qrcode": "^1.4.4",
+    "qrcode": "^1.5.4",
     "safe-decode-uri-component": "^1.2.1",
     "tunnel": "^0.0.6",
     "xml2js": "^0.6.2",
-    "yargs": "^17.1.1"
+    "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@types/express": "^4.17.13",
+    "@eslint/eslintrc": "^3.3.5",
-    "@types/express-fileupload": "^1.2.2",
+    "@eslint/js": "^9.39.4",
-    "@types/mocha": "^9.1.0",
+    "@types/express": "^5.0.6",
-    "@types/node": "16.11.19",
+    "@types/express-fileupload": "^1.5.1",
-    "@typescript-eslint/eslint-plugin": "5.0.0",
+    "@types/mocha": "^10.0.10",
-    "@typescript-eslint/parser": "5.0.0",
+    "@types/node": "25.9.2",
-    "eslint": "8.7.0",
+    "@typescript-eslint/eslint-plugin": "^8.62.1",
-    "eslint-config-prettier": "8.5.0",
+    "@typescript-eslint/parser": "^8.62.1",
-    "eslint-plugin-html": "7.1.0",
+    "eslint": "^9.39.4",
-    "eslint-plugin-prettier": "4.0.0",
+    "eslint-config-prettier": "^10.1.8",
-    "husky": "7.0.4",
+    "eslint-plugin-html": "^8.1.4",
-    "intelli-espower-loader": "1.1.0",
+    "eslint-plugin-prettier": "^5.5.6",
-    "lint-staged": "12.1.7",
+    "globals": "^17.7.0",
-    "mocha": "10.0.0",
+    "husky": "^9.1.7",
-    "pkg": "^5.8.0",
+    "intelli-espower-loader": "^1.1.0",
-    "power-assert": "1.6.1",
+    "lint-staged": "^16.4.0",
-    "prettier": "2.7.1",
+    "mocha": "^11.7.6",
-    "typescript": "4.5.2"
+    "nodemon": "^3.1.14",
+    "pkg": "^5.8.1",
+    "power-assert": "^1.6.1",
+    "prettier": "^3.9.4",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   }
 }

plugins/songUpload.js

@@ -1,20 +1,17 @@
 const { default: axios } = require('axios')
 const createOption = require('../util/option.js')
 const logger = require('../util/logger.js')
+const {
+  getUploadData,
+  getFileExtension,
+  sanitizeFilename,
+} = require('../util/fileHelper')
+
 module.exports = async (query, request) => {
-  let ext = 'mp3'
+  const ext = getFileExtension(query.songFile.name)
-  // if (query.songFile.name.indexOf('flac') > -1) {
+  const filename = sanitizeFilename(query.songFile.name)
-  //   ext = 'flac'
-  // }
-  if (query.songFile.name.includes('.')) {
-    ext = query.songFile.name.split('.').pop()
-  }
-  const filename = query.songFile.name
-    .replace('.' + ext, '')
-    .replace(/\s/g, '')
-    .replace(/\./g, '_')
   const bucket = 'jd-musicrep-privatecloud-audio-public'
-  //   获取key和token
+
   const tokenRes = await request(
     `/api/nos/token/alloc`,
     {
@@ -29,31 +26,82 @@ module.exports = async (query, request) => {
     createOption(query, 'weapi'),
   )
 
-  // 上传
+  if (!tokenRes.body.result || !tokenRes.body.result.objectKey) {
-  const objectKey = tokenRes.body.result.objectKey.replace('/', '%2F')
+    logger.error('Token分配失败:', tokenRes.body)
+    throw {
+      status: 500,
+      body: {
+        code: 500,
+        msg: '获取上传token失败',
+        detail: tokenRes.body,
+      },
+    }
+  }
+
+  const objectKey = tokenRes.body.result.objectKey.replace(/\//g, '%2F')
+  let lbs
   try {
-    const lbs = (
+    lbs = (
       await axios({
         method: 'get',
         url: `https://wanproxy.127.net/lbs?version=1.0&bucketname=${bucket}`,
+        timeout: 10000,
       })
     ).data
+  } catch (error) {
+    logger.error('LBS获取失败:', error.message)
+    throw {
+      status: 500,
+      body: {
+        code: 500,
+        msg: '获取上传服务器地址失败',
+        detail: error.message,
+      },
+    }
+  }
+
+  if (!lbs || !lbs.upload || !lbs.upload[0]) {
+    logger.error('无效的LBS响应:', lbs)
+    throw {
+      status: 500,
+      body: {
+        code: 500,
+        msg: '获取上传服务器地址无效',
+        detail: lbs,
+      },
+    }
+  }
+
+  try {
     await axios({
       method: 'post',
       url: `${lbs.upload[0]}/${bucket}/${objectKey}?offset=0&complete=true&version=1.0`,
       headers: {
         'x-nos-token': tokenRes.body.result.token,
         'Content-MD5': query.songFile.md5,
-        'Content-Type': 'audio/mpeg',
+        'Content-Type': query.songFile.mimetype || 'audio/mpeg',
         'Content-Length': String(query.songFile.size),
       },
-      data: query.songFile.data,
+      data: getUploadData(query.songFile),
       maxContentLength: Infinity,
       maxBodyLength: Infinity,
+      timeout: 300000,
     })
+    logger.info('上传成功:', filename)
   } catch (error) {
-    logger.info('error', error.response)
+    logger.error('上传失败:', {
-    throw error.response
+      status: error.response?.status,
+      data: error.response?.data,
+      message: error.message,
+    })
+    throw {
+      status: error.response?.status || 500,
+      body: {
+        code: error.response?.status || 500,
+        msg: '文件上传失败',
+        detail: error.response?.data || error.message,
+      },
+    }
   }
   return {
     ...tokenRes,

plugins/upload.js

@@ -1,5 +1,7 @@
 const { default: axios } = require('axios')
 const createOption = require('../util/option.js')
+const { getUploadData } = require('../util/fileHelper')
+
 module.exports = async (query, request) => {
   const data = {
     bucket: 'yyimgs',
@@ -10,27 +12,23 @@ module.exports = async (query, request) => {
     return_body: `{"code":200,"size":"$(ObjectSize)"}`,
     type: 'other',
   }
-  //   获取key和token
   const res = await request(
     `/api/nos/token/alloc`,
     data,
     createOption(query, 'weapi'),
   )
-  //   上传图片
+
   const res2 = await axios({
     method: 'post',
     url: `https://nosup-hz1.127.net/yyimgs/${res.body.result.objectKey}?offset=0&complete=true&version=1.0`,
     headers: {
       'x-nos-token': res.body.result.token,
-      'Content-Type': 'image/jpeg',
+      'Content-Type': query.imgFile.mimetype || 'image/jpeg',
     },
-    data: query.imgFile.data,
+    data: getUploadData(query.imgFile),
   })
 
   return {
-    // ...res.body.result,
-    // ...res2.data,
-    // ...res3.body,
     url_pre: 'https://p1.music.126.net/' + res.body.result.objectKey,
     imgId: res.body.result.docId,
   }