From bf12abe2f10f0c3e40820caa666d9dc90cd95ed9 Mon Sep 17 00:00:00 2001
From: LaoShui <79132480+laoshuikaixue@users.noreply.github.com>
Date: Fri, 10 Jul 2026 19:20:54 +0800
Subject: [PATCH] =?UTF-8?q?feat(artist):=20=E6=B7=BB=E5=8A=A0=E5=85=B3?=
 =?UTF-8?q?=E6=B3=A8=E6=AD=8C=E6=89=8B=E6=96=B0=E4=BD=9C=E5=93=81=EF=BC=88?=
 =?UTF-8?q?=E6=AD=8C=E6=9B=B2/MV=EF=BC=89=E6=8E=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 module/artist_new_song_mv_list_v2.js 模块实现接口逻辑
- 在文档中添加接口说明、参数详情和调用示例
- 在 TypeScript 定义文件中添加对应的接口类型声明
- 支持分页获取关注歌手的新歌曲和 MV 列表
- 实现时间游标和翻页功能支持
- 提供多种可选参数配置选项
---
 interface.d.ts                       | 10 ++++++++++
 module/artist_new_song_mv_list_v2.js | 16 ++++++++++++++++
 public/docs/home.md                  | 18 ++++++++++++++++++
 3 files changed, 44 insertions(+)
 create mode 100644 module/artist_new_song_mv_list_v2.js

diff --git a/interface.d.ts b/interface.d.ts
index 36dc3bc..c260f4f 100644
--- a/interface.d.ts
+++ b/interface.d.ts
@@ -1478,6 +1478,16 @@ 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
diff --git a/module/artist_new_song_mv_list_v2.js b/module/artist_new_song_mv_list_v2.js
new file mode 100644
index 0000000..762aa57
--- /dev/null
+++ b/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'),
+  )
+}
diff --git a/public/docs/home.md b/public/docs/home.md
index 84fdbe7..a3446f6 100644
--- a/public/docs/home.md
+++ b/public/docs/home.md
@@ -3620,6 +3620,24 @@ type='1009' 获取其 id, 如`/search?keywords= 代码时间 &type=1009`
 
 **调用例子 :** `/artist/new/song/playall`
 
+### 关注歌手新作品（歌曲/MV）
+
+说明 : 登录后调用此接口可分页获取关注歌手的新歌曲和 MV
+
+**可选参数 :** `limit`: 返回数量，默认为 10
+
+`startTimestamp`: 时间游标，首次请求默认为当前时间，后续请求传入上一页返回的时间游标
+
+`before`: `startTimestamp` 的别名
+
+`sourceType`: 作品来源类型，默认为 1
+
+`firstRequest`: 是否首次请求，默认为 `true`，翻页时传 `false`
+
+**接口地址 :** `/artist/new/song/mv/list/v2`
+
+**调用例子 :** `/artist/new/song/mv/list/v2` `/artist/new/song/mv/list/v2?startTimestamp=1783680576099&sourceType=1&limit=10&firstRequest=false`
+
 ### 关注歌手新 MV
 
 说明 :登录后调用此接口可获取关注歌手新 MV