From 1b972ec4dd3c9dd9c5d157ccb10c92b83d849350 Mon Sep 17 00:00:00 2001 From: snowy-yang <102860110+snowy-yang@users.noreply.github.com> Date: Sat, 3 Oct 2026 11:07:21 +0800 Subject: [PATCH] =?UTF-8?q?refactor(api)!:=20=E5=B9=B3=E5=8F=B0=20id=20?= =?UTF-8?q?=E6=94=B6=E5=B0=BE=E7=BB=9F=E4=B8=80=E2=80=94=E2=80=94migu?= =?UTF-8?q?=E2=86=92mg=E3=80=81apple=E2=86=92ap?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 补上最后两个多字母 id，至此 15 个平台对外 id 全部为两字母： kw kg tx wy qs xm me qt lr mg bd jx bl 5s ap **破坏性变更**：id 出现在所有 URL、/sources 返回以及 data/auth.json 的 凭据键里，咪咕与 Apple Music 已存的登录态会失效，需重新登录。 - sdk/index.ts：id 与 supportQuality 映射键（展示名 `咪咕音乐` / `Apple Music` 保持不动） - sdk/types.ts：Source 联合类型 - src/routes.ts：/stream 的 enum ['qs','migu'] → ['qs','mg']，以及 /url/mg、/stream/mg 等路径与 schema 描述 - src/http/migu-stream.ts、src/routes-login.ts、src/server.ts - test/smoke-test.ts、README.md、docs/API.md 同步 有意未改：域名与 API 路径（music.migu.cn、music.apple.com、 amp-api.music.apple.com、/v1/catalog/cn/apple-curators/…）、 标识符（registerMiguStream、appleAmpGet、APPLE_AMP_API_URL 等）、 sdk/migu 与 sdk/apple 的目录与文件名、错误文案里的平台名。 验证：typecheck ✓、pnpm test 112/112 ✓；另起临时实例实证 /sources （15/15 平台 id 与展示名全对）与 /login/status，旧 id 零残留。 --- README.md | 28 +++++++++++----------- docs/API.md | 8 +++---- sdk/apis/apple.ts | 2 +- sdk/apis/migu.ts | 2 +- sdk/apple/album.ts | 4 ++-- sdk/apple/index.ts | 8 +++---- sdk/apple/musicSearch.ts | 6 ++--- sdk/apple/playlist.ts | 10 ++++---- sdk/apple/util.ts | 10 ++++---- sdk/index.ts | 8 +++---- sdk/migu/album.ts | 6 ++--- sdk/migu/musicSearch.ts | 2 +- sdk/migu/playlist.ts | 10 ++++---- sdk/migu/util.ts | 6 ++--- sdk/types.ts | 2 +- src/http/migu-stream.ts | 6 ++--- src/routes-login.ts | 4 ++-- src/routes.ts | 32 ++++++++++++------------- src/server.ts | 6 ++--- test/smoke-test.ts | 52 ++++++++++++++++++++-------------------- 20 files changed, 106 insertions(+), 106 deletions(-) diff --git a/README.md b/README.md index 2b043ea..e5b3e25 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ ## 功能 -- **多平台聚合**：酷我（kw）、酷狗（kg）、QQ音乐（tx）、网易云（wy）、汽水音乐（qs）、咪咕音乐（migu）、千千音乐（bd）、JOOX（jx）、哔哩哔哩（bl）、5sing（5s）；有声平台：喜马拉雅（xm）、猫耳FM（me）、蜻蜓FM（qt）、懒人听书（lr）；Apple Music（apple，仅 preview 试听） +- **多平台聚合**：酷我（kw）、酷狗（kg）、QQ音乐（tx）、网易云（wy）、汽水音乐（qs）、咪咕音乐（mg）、千千音乐（bd）、JOOX（jx）、哔哩哔哩（bl）、5sing（5s）；有声平台：喜马拉雅（xm）、猫耳FM（me）、蜻蜓FM（qt）、懒人听书（lr）；Apple Music（ap，仅 preview 试听） - **直连取流**：各平台播放地址获取（不依赖第三方 API 服务） - **完整链路**：搜索、播放地址、歌词（含各平台加密歌词解码）、封面、榜单、热搜、歌单、专辑、歌手、链接解析（歌单/专辑/歌曲网页链接） - 有声平台（xm/me/qt/lr）与 Apple Music（仅试听）不参与聚合搜索与跨平台匹配，仅支持 source 直查 @@ -18,12 +18,12 @@ | QQ音乐 | `tx` | ✅ | 128k/320k/flac/flac24bit | ✅ | ✅ | ✅ 列表/详情 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | 扫码/cookie | | 网易云 | `wy` | ✅ | 128k/320k/flac/flac24bit | ✅ | ✅ | ✅ 列表/详情 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | 扫码/手机号 | | 汽水音乐 | `qs` | ✅ | 128k/320k（登录解锁无损） | ✅ | ✅ | — | — | — | 扫码 | -| 咪咕音乐 | `migu` | ✅ | 64k/128k/320k/flac/flac24bit | ✅ | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie（解锁高档位） | +| 咪咕音乐 | `mg` | ✅ | 64k/128k/320k/flac/flac24bit | ✅ | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie（解锁高档位） | | 千千音乐 | `bd` | ✅ | 64k/128k/320k/flac | ✅ | ✅ | ✅ 详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie（VIP 曲目） | | JOOX | `jx` | ✅ | 128k（VIP 为试听片段） | ✅ | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie（VIP 完整曲） | | 哔哩哔哩 | `bl` | ✅ | 64k/128k/320k/flac/flac24bit（实际命中 B站档位 132k/192k；flac/Hi-Res 需大会员） | ✅ | ✅ | ✅ 搜索/详情（合集/多分P） | — | ✅ 歌曲/歌单 | 扫码 | | 5sing | `5s` | ✅ | sq/hq/lq | ✅ | — | ✅ 搜索/详情 | — | ✅ 歌曲/歌单 | cookie（可选） | -| Apple Music | `apple` | ✅ | preview 试听片段 | ✅（需登录） | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie（media-user-token） | +| Apple Music | `ap` | ✅ | preview 试听片段 | ✅（需登录） | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie（media-user-token） | | 喜马拉雅 | `xm` | ✅ | 64k/128k | — | ✅ | — | ✅ 详情 | — | cookie | | 猫耳FM | `me` | ✅ | 64k/128k | — | ✅ | — | ✅ 详情 | — | token | | 蜻蜓FM | `qt` | ✅ | 64k/128k | — | ✅ | — | ✅ 详情 | — | — | @@ -52,7 +52,7 @@ pnpm typecheck # 仅类型检查，不运行 | `GET /search/:source/:keyword[/:page]` | 搜索歌曲：平台 id 或 all（聚合，排除 xm/me/qt/lr）；第 1 页可省略页码段，下一页 `/search/kw/稻香/2`；?singer= 附加歌手、?limit= 每页条数 | | `GET /find/:source/:keyword` | 精确匹配搜索（source 为平台 id 或 all；?singer= ?albumName= ?interval= 辅助匹配，all 时 ?excludeSource= 跳过平台） | | `GET /url/:source/:id?quality=320k` | 获取播放地址（quality: 64k/128k/320k/flac/flac24bit）。取流链：外部音源（启用时）→ SDK 直连 → 酷我兜底（跨平台匹配，响应 `via` 字段标记实际命中通道） | -| `GET /stream/:source/:id` | 加密流解密代理（source 用 path 段区分：`qs`=汽水解密流、`migu`=咪咕 Z3D/I3D 加密流）。取流响应返回相对地址时使用，服务端下载上游密流并在本地解密回明文音频 | +| `GET /stream/:source/:id` | 加密流解密代理（source 用 path 段区分：`qs`=汽水解密流、`mg`=咪咕 Z3D/I3D 加密流）。取流响应返回相对地址时使用，服务端下载上游密流并在本地解密回明文音频 | | `GET /lyric/:source/:id` | 获取歌词（返回 lyric/tlyric/yrc） | | `GET /pic/:source/:id` | 获取封面 | | `GET /boards/:source` | 榜单列表 | @@ -62,13 +62,13 @@ pnpm typecheck # 仅类型检查，不运行 | `GET /singer/:source/:id` | 歌手信息（kg/tx/wy） | | `GET /singer/:source/:id/songs[/:page]?limit=30` | 歌手歌曲列表（kg/tx/wy） | | `GET /singer/:source/:id/albums[/:page]?limit=10` | 歌手专辑列表（kg/tx/wy） | -| `GET /album/:source/:id[/:page]` | 专辑详情与曲目（分页为 path 段，第 1 页省略）。支持 kg/kw/tx/wy/xm/me/qt/lr/migu/bd/jx/apple | -| `GET /album/:source/search/:keyword` | 专辑搜索（kg/kw/tx/wy/migu/bd/jx/apple） | -| `GET /playlist/:source/search/:keyword` | 歌单搜索（kg/kw/tx/wy/migu/bd/jx/bl/5s/apple） | -| `GET /playlist/:source/categories` | 歌单分类（kw/kg/tx/wy/migu/bd/jx/bl/5s/apple） | +| `GET /album/:source/:id[/:page]` | 专辑详情与曲目（分页为 path 段，第 1 页省略）。支持 kg/kw/tx/wy/xm/me/qt/lr/mg/bd/jx/ap | +| `GET /album/:source/search/:keyword` | 专辑搜索（kg/kw/tx/wy/mg/bd/jx/ap） | +| `GET /playlist/:source/search/:keyword` | 歌单搜索（kg/kw/tx/wy/mg/bd/jx/bl/5s/ap） | +| `GET /playlist/:source/categories` | 歌单分类（kw/kg/tx/wy/mg/bd/jx/bl/5s/ap） | | `GET /playlist/:source/categories/:categoryId` | 分类下的歌单（同上） | -| `GET /playlist/:source/:id[/:page]?limit=` | 歌单详情与曲目（kw/kg/tx/wy/migu/bd/jx/bl/5s/apple；bl 支持合集/多分P） | -| `POST /parse/song/:source` 等 | 链接解析：body `{ "link": "..." }`，三个端点 `parse/song` / `parse/album` / `parse/playlist`。支持 kw/kg/tx/wy/5s/apple/bl/jx/bd/migu（其中 bl、5s 无 album 端点） | +| `GET /playlist/:source/:id[/:page]?limit=` | 歌单详情与曲目（kw/kg/tx/wy/mg/bd/jx/bl/5s/ap；bl 支持合集/多分P） | +| `POST /parse/song/:source` 等 | 链接解析：body `{ "link": "..." }`，三个端点 `parse/song` / `parse/album` / `parse/playlist`。支持 kw/kg/tx/wy/5s/ap/bl/jx/bd/mg（其中 bl、5s 无 album 端点） | | `GET /user-playlist/:source` | 个人歌单（仅 tx/wy 有完整实现；需登录，未登录或平台不支持返回 404/502） | | `POST /login/wy/qr` → `POST /login/wy/qr/check` | 网易云扫码登录（扫码后轮询完成登录） | | `POST /login/wy/cellphone` | 网易云手机号登录（password 或 captcha） | @@ -103,12 +103,12 @@ pnpm typecheck # 仅类型检查，不运行 - **me**：声音 id（搜索结果的 `songmid` 字段）；走 App API 签名通道取免签名明文直链（m4a），匿名可取免费声音，付费内容 `POST /login/me` 绑定 token 后取流 - **qt**：`:` 复合 id（/album/qt 节目列表产出）；audiostream 签名直链（302 到华为云 CDN），匿名可取免费节目 - **lr**：`:
` 复合 id（/album/lr 章节列表产出）；取流必须 `POST /login/lr` 登录（免费章节同样要求登录态） -- **migu**：`||` 三元组（搜索结果/专辑/歌单产出）；取流走 listen-url 多档候选链 + 逐档 Range 探测，命中可访问的最高档（匿名实测可出 flac24bit 真无损），Z3D/I3D 加密流自动改走 `/stream/migu` 解密代理 +- **mg**：`||` 三元组（搜索结果/专辑/歌单产出）；取流走 listen-url 多档候选链 + 逐档 Range 探测，命中可访问的最高档（匿名实测可出 flac24bit 真无损），Z3D/I3D 加密流自动改走 `/stream/mg` 解密代理 - **bd**：track id（T 开头，搜索结果的 `songmid`）；免费曲目匿名可出 128k/320k/flac 明文直链，VIP/版权曲目需 cookie - **jx**：加密后的 track id（含 `=`/`+`，URL 编码后传）；游客 128k，VIP 完整曲需 cookie（`wmid`+`session_key`） - **bl**：`|`（搜索结果/合集曲目产出）；合集/歌单 id 形如 `season:::` 或 `bvid:` - **5s**：`|`（如 `932557|yc`，songType 为 yc 原创 / fc 翻唱 / bz 伴奏），URL 路径需编码 `|` 为 `%7C` -- **apple**：数字歌曲 id（搜索结果产出）；取流固定为 `preview` 试听片段（完整曲为 DRM，不在支持范围） +- **ap**：数字歌曲 id（搜索结果产出）；取流固定为 `preview` 试听片段（完整曲为 DRM，不在支持范围） `/url` 在外部音源与平台直连都失败时，自动降级到**酷我**兜底：按歌名/歌手/时长匹配同一首歌后走 kw 通道（匿名可拿无损）。kg 可由 hash 反查歌曲信息；其它平台需要兜底时给 `/url` 传 `name`/`singer`/`interval` 查询参数。 @@ -196,8 +196,8 @@ test/ - **kg 取流**：匿名仅能获取部分免费资源，VIP/付费歌需 `/login/kg` 登录（扫码/短信/token 均可）后取流，成功响应解析见 `sdk/apis/kg.ts` 头注释。 - **kw 取流**：主通道 mobi.s 严格校验「返回 bitrate == 请求档位且为明文格式」，档位缺失时沿降级链换档（flac24bit→flac→320k→128k）；web playUrl 回退通道匿名恒 128k。 - **qs 取流**：匿名仅 30s 试听；完整曲目需 `/login/qs/qr` 用**汽水音乐 App** 扫码登录，取流走 `/stream/qs/:id` 解密流代理（一次性下载解密回明文，不支持 Range）。 -- **migu 取流**：匿名 PQ(128k) 永远可用，但候选链会优先探测更高档位——多数曲目实际能匿名拿到 SQ/ZQ 真无损直链（上游同款 tone 路径重写 + 逐档探测）；Z3D/I3D 加密候选经 `/stream/migu` 解密后同样可播。HQ/SQ 返回「登录后免费试听」时自动降级到可用的最高档。 -- **apple 取流**：只有 preview 试听片段（约 30–90s，AAC/m4a），返回的 `type` 固定为 `preview`，不要当作完整曲。 +- **mg 取流**：匿名 PQ(128k) 永远可用，但候选链会优先探测更高档位——多数曲目实际能匿名拿到 SQ/ZQ 真无损直链（上游同款 tone 路径重写 + 逐档探测）；Z3D/I3D 加密候选经 `/stream/mg` 解密后同样可播。HQ/SQ 返回「登录后免费试听」时自动降级到可用的最高档。 +- **ap 取流**：只有 preview 试听片段（约 30–90s，AAC/m4a），返回的 `type` 固定为 `preview`，不要当作完整曲。 - **bl 取流**：匿名最高 192k；flac/Hi-Res 需 `/login/bl/qr` 登录大会员账号。CDN 有约 1 小时的 `deadline` 签名，取流结果不宜缓存过久。 - **5s 歌单详情**：依赖 5sing 网页（`5sing.kugou.com/.../dj/...html`）解析曲目；2026-10-02 实测该站点网页层整体 502（搜索/取流/歌词等手机端 API 不受影响）。上游同样依赖该页面，待站点恢复即自动可用。 - **link 解析**：`/parse/*` 走各平台网页链接解析（需上游有对应实现）；未实现的平台返回 404。 diff --git a/docs/API.md b/docs/API.md index faa052d..8d78ddc 100644 --- a/docs/API.md +++ b/docs/API.md @@ -2,8 +2,8 @@ 多平台音乐聚合接口：搜索、播放地址、歌词、封面、榜单、歌单、专辑、歌手、链接解析、登录。 -共 15 个平台：`kw`（酷我）/ `kg`（酷狗）/ `tx`（QQ音乐）/ `wy`（网易云）/ `qs`（汽水）/ `migu`（咪咕）/ -`bd`（千千）/ `jx` / `bl`（哔哩哔哩）/ `5s` / `apple`（Apple Music，仅试听）， +共 15 个平台：`kw`（酷我）/ `kg`（酷狗）/ `tx`（QQ音乐）/ `wy`（网易云）/ `qs`（汽水）/ `mg`（咪咕）/ +`bd`（千千）/ `jx` / `bl`（哔哩哔哩）/ `5s` / `ap`（Apple Music，仅试听）， 以及有声平台 `xm`（喜马拉雅）/ `me`（猫耳FM）/ `qt`（蜻蜓FM）/ `lr`（懒人听书）。 > **本文档是人工速查版，可能滞后于代码。** @@ -39,7 +39,7 @@ ### 歌曲 id 形态 -各平台 id 约定（含 `kw` 的 songmid、`kg` 的 hash、`qs`/`xm`/`me` 的 id、`migu` 的三元组、 +各平台 id 约定（含 `kw` 的 songmid、`kg` 的 hash、`qs`/`xm`/`me` 的 id、`mg` 的三元组、 `qt`/`lr` 的复合 id、`bl` 的 `|` 等）详见 README「歌曲 ID 约定」。 复合 id 含 `|` / `:` 时在 URL 中需编码（`|` → `%7C`）。 @@ -66,7 +66,7 @@ | 方法 | 路径 | 说明 | | --- | --- | --- | | GET | `/url/:source/:id` | 播放地址；`?quality=`（64k/128k/320k/flac/flac24bit，默认 128k）。取流链：外部音源（启用时）→ SDK 直连 → 酷我兜底（响应 `via` 标记实际命中通道） | -| GET | `/stream/:source/:id` | 加密流解密代理，`source` 用 path 段区分（`qs` 汽水解密流 / `migu` 咪咕 Z3D 加密流）。供 `/url` 返回的相对地址使用，不接受自行构造 | +| GET | `/stream/:source/:id` | 加密流解密代理，`source` 用 path 段区分（`qs` 汽水解密流 / `mg` 咪咕 Z3D 加密流）。供 `/url` 返回的相对地址使用，不接受自行构造 | | GET | `/lyric/:source/:id` | 歌词；可带 `?name=` `?interval=`（部分平台搜索歌词时需要） | | GET | `/pic/:source/:id` | 封面；可带 `?albumId=`（kg 需要） | diff --git a/sdk/apis/apple.ts b/sdk/apis/apple.ts index da1b742..1e72a7d 100644 --- a/sdk/apis/apple.ts +++ b/sdk/apis/apple.ts @@ -3,7 +3,7 @@ // 完整曲目是 FairPlay DRM 加密流（extendedAssetUrls.enhancedHls），需要 gamdl 等外部工具解密， // 本 SDK 不提供。因此这里**任何请求档位都返回 type='preview'**，并在注释/响应里明确标注，不假装是无损完整曲。 // 歌曲的 previews[0].url 来自 catalog 歌曲详情（搜索结果缓存里的 previewUrl 也会直接复用，同上游 s.URL 逻辑）。 -// 统一接口约定：apis('apple').getMusicUrl(songInfo, type) → { promise, cancelHttp } +// 统一接口约定：apis('ap').getMusicUrl(songInfo, type) → { promise, cancelHttp } // promise resolve → { type:'preview', url, ext:'m4a', preview:true, songDuration, isrc } // （songDuration 是歌曲完整时长，试听片段本身约 30-90 秒） // type 请求参数不影响结果（只有 preview 一档）；supportQualitys 声明为 ['128k'] 以对齐 diff --git a/sdk/apis/migu.ts b/sdk/apis/migu.ts index 2891645..eb4441e 100644 --- a/sdk/apis/migu.ts +++ b/sdk/apis/migu.ts @@ -298,7 +298,7 @@ const MAX_PROBES = 10 export interface MiguUrlResult { type: string url: string - /** Z3D/I3D 加密流：URL 需解密后才能播放（本服务提供 /stream/migu 代理） */ + /** Z3D/I3D 加密流：URL 需解密后才能播放（本服务提供 /stream/mg 代理） */ encrypted?: boolean fileKey?: string ext?: string diff --git a/sdk/apple/album.ts b/sdk/apple/album.ts index 48cbee2..5cb51f0 100644 --- a/sdk/apple/album.ts +++ b/sdk/apple/album.ts @@ -35,7 +35,7 @@ export const getAlbumDetail = async(rawId: string, page = 1, limit = 50) => { if (!summary.trackCount || songs.length > summary.trackCount) summary.trackCount = songs.length return { - source: 'apple' as const, + source: 'ap' as const, info: { id: albumId, name: summary.name, @@ -64,7 +64,7 @@ export const getAlbumSongs = async(id: string): Promise => { export const parseAlbumLink = async(link: string) => { const detail = await getAlbumDetail(link, 1, 100000) return { - source: 'apple' as const, + source: 'ap' as const, id: detail.info.id, info: detail.info, list: detail.list, diff --git a/sdk/apple/index.ts b/sdk/apple/index.ts index 2b5b561..252e051 100644 --- a/sdk/apple/index.ts +++ b/sdk/apple/index.ts @@ -1,8 +1,8 @@ -// Apple Music 平台模块（上游 music-lib/apple/apple.go 的 Node/TS 移植，平台 id: apple） +// Apple Music 平台模块（上游 music-lib/apple/apple.go 的 Node/TS 移植，平台 id: ap） // 能力：搜索 / 歌词（TTML，匿名 developer token 通常拿不到，见 lyric.ts）/ 封面 / // 专辑（搜索+详情+链接解析）/ 歌单（搜索+详情+分类+分类歌单+链接解析）/ // 链接解析（song/album/playlist）/ 取流（**仅 preview 试听片段**，见 sdk/apis/apple.ts）。 -// 凭据：上游 New(cookie) → getCredentials('apple')，cookie 形如 +// 凭据：上游 New(cookie) → getCredentials('ap')，cookie 形如 // "media-user-token=xxx;storefront=cn;token=xxx"，也支持 storefront/mediaUserToken/token 直填字段。 // 未实现（上游也没有）：userPlaylist、榜单、热搜、歌手、评论、扫码登录。 import appleApi from '../apis/apple.ts' @@ -72,7 +72,7 @@ const apple = { playlist, - // 契约别名：Apple 的歌单分类即 genre curators，挂到 songList 键供 /song-list/apple 复用 + // 契约别名：Apple 的歌单分类即 genre curators，挂到 songList 键供 /song-list/ap 复用 songList: { sortList: [{ name: '热门', id: '1526756058' }], getTags() { @@ -96,7 +96,7 @@ const apple = { /** 登录状态（media-user-token 存在性判断；无在线校验接口） */ export const status = () => { - const cred = getCredentials('apple') as any + const cred = getCredentials('ap') as any const cfg = getAppleConfig() return (cfg.mediaUserToken || cred?.cookie) ? { logged: true, updatedAt: cred?.updatedAt } diff --git a/sdk/apple/musicSearch.ts b/sdk/apple/musicSearch.ts index 6750b14..24b33f0 100644 --- a/sdk/apple/musicSearch.ts +++ b/sdk/apple/musicSearch.ts @@ -39,7 +39,7 @@ export const search = async(keyword: string, page = 1, limit = 20) => { allPage: hasNext ? p + 1 : p, total: (p - 1) * l + list.length, limit: l, - source: 'apple' as const, + source: 'ap' as const, } } @@ -53,7 +53,7 @@ export const searchAlbum = async(keyword: string, page = 1, limit = 20) => { total: (p - 1) * l + list.length, page: p, limit: l, - source: 'apple' as const, + source: 'ap' as const, } } @@ -67,7 +67,7 @@ export const searchPlaylist = async(keyword: string, page = 1, limit = 20) => { total: (p - 1) * l + list.length, page: p, limit: l, - source: 'apple' as const, + source: 'ap' as const, } } diff --git a/sdk/apple/playlist.ts b/sdk/apple/playlist.ts index 5f1602c..894337e 100644 --- a/sdk/apple/playlist.ts +++ b/sdk/apple/playlist.ts @@ -53,8 +53,8 @@ export const appleCuratorCategories: Array<{ id: string, name: string }> = [ /** 上游 GetPlaylistCategories：静态返回 Apple Music genre curators */ export const getCategories = async() => ({ - source: 'apple' as const, - list: appleCuratorCategories.map(item => ({ id: item.id, name: item.name, group: 'Apple Music 分类', source: 'apple' as const })), + source: 'ap' as const, + list: appleCuratorCategories.map(item => ({ id: item.id, name: item.name, group: 'Apple Music 分类', source: 'ap' as const })), }) /** 上游 GetCategoryPlaylists：按 curator 分类取歌单（cn storefront，单请求上限 25，循环补齐） */ @@ -88,7 +88,7 @@ export const getCategoryPlaylists = async(categoryID: string, page = 1, limit = } return { - source: 'apple' as const, + source: 'ap' as const, list: all.slice(0, l), page: p, limit: l, @@ -118,7 +118,7 @@ export const getPlaylistDetail = async(rawId: string, page = 1, limit = 100) => if (!summary.trackCount || songs.length > summary.trackCount) summary.trackCount = songs.length return { - source: 'apple' as const, + source: 'ap' as const, info: { id: playlistId, name: summary.name, @@ -145,7 +145,7 @@ export const getPlaylistSongs = async(id: string): Promise => { export const parsePlaylistLink = async(link: string) => { const detail = await getPlaylistDetail(link, 1, 100000) return { - source: 'apple' as const, + source: 'ap' as const, id: detail.info.id, info: detail.info, list: detail.list, diff --git a/sdk/apple/util.ts b/sdk/apple/util.ts index edc1271..3fd157d 100644 --- a/sdk/apple/util.ts +++ b/sdk/apple/util.ts @@ -1,6 +1,6 @@ // Apple Music（music.apple.com / amp-api.music.apple.com）公共工具 // 上游 music-lib/apple/apple.go 的移植基础层： -// - New(cookie) → getCredentials('apple')：cookie 支持 "media-user-token=xxx;storefront=cn;token=xxx" +// - New(cookie) → getCredentials('ap')：cookie 支持 "media-user-token=xxx;storefront=cn;token=xxx" // - fetchAppleToken()：从 music.apple.com 首页 → index-legacy JS 抓 developer token（amp-api 的 Bearer） // 当前（2026-10）Apple 下发的 JWT 以 eyJ0eXAi（{"typ":...}）开头而非上游正则写的 eyJh， // 故这里泛化为任意 JWT（eyJ…）并优先选择 issuer=AMPWebPlay 的 token；带回退与失效重取见 getAppleToken/invalidateAppleToken。 @@ -42,7 +42,7 @@ export const parseCookieParts = (cookie: string): Record => { /** 读取 apple 平台运行时配置（对应上游 New(cookie)） */ export const getAppleConfig = (): AppleRuntimeConfig => { - const cred = (getCredentials('apple') as any) || {} + const cred = (getCredentials('ap') as any) || {} const parts = parseCookieParts(String(cred.cookie ?? '')) const storefront = String(cred.storefront || parts.storefront || DEFAULT_STOREFRONT).trim() return { @@ -297,7 +297,7 @@ export const appleSongFromCatalog = (res: any, defaultAlbumId = ''): any => { lrc: null, types: [], _types: {}, - source: 'apple' as const, + source: 'ap' as const, link: attr.url || '', // music.apple.com 网页地址 previewUrl: previewURL, // 30-90 秒试听片段直链（Apple 不提供完整曲目明文流） duration: durationSec, @@ -316,7 +316,7 @@ export const appleAlbumToPlaylist = (res: any): any => { creator: attr.artistName || '', description: attr.editorialNotes?.short || '', link: attr.url || '', - source: 'apple' as const, + source: 'ap' as const, extra: { release_date: attr.releaseDate || '', record_label: attr.recordLabel || '', @@ -340,7 +340,7 @@ export const applePlaylistToPlaylist = (res: any): any => { creator: attr.curatorName || '', description, link: attr.url || '', - source: 'apple' as const, + source: 'ap' as const, } } diff --git a/sdk/index.ts b/sdk/index.ts index ceba3be..2fa1a8e 100644 --- a/sdk/index.ts +++ b/sdk/index.ts @@ -53,13 +53,13 @@ const SUPPORTED_SOURCES: Array<{ id: string; name: string; module: PlatformModul { id: 'me', name: '猫耳FM', module: me, noAggregate: true }, { id: 'qt', name: '蜻蜓FM', module: qt, noAggregate: true }, { id: 'lr', name: '懒人听书', module: lr, noAggregate: true }, - { id: 'migu', name: '咪咕音乐', module: migu }, + { id: 'mg', name: '咪咕音乐', module: migu }, { id: 'bd', name: '千千音乐', module: qian }, { id: 'jx', name: 'JOOX', module: joox }, { id: 'bl', name: '哔哩哔哩', module: bili }, { id: '5s', name: '5sing', module: fivesing }, // Apple Music 仅提供 preview 试听片段（完整曲为 DRM），不参与跨平台精确匹配 - { id: 'apple', name: 'Apple Music', module: apple, noAggregate: true }, + { id: 'ap', name: 'Apple Music', module: apple, noAggregate: true }, ] const SOURCE_MODULES = Object.fromEntries(SUPPORTED_SOURCES.map((s) => [s.id, s.module])) @@ -81,12 +81,12 @@ export const supportQuality: Record = { me: meQualitys, qt: qtQualitys, lr: lrQualitys, - migu: miguQualitys, + mg: miguQualitys, bd: qianQualitys, jx: jooxQualitys, bl: biliQualitys, '5s': fivesingQualitys, - apple: appleQualitys, + ap: appleQualitys, } const trimStr = (str: unknown): string => (typeof str === 'string' ? str.trim() : str as string) diff --git a/sdk/migu/album.ts b/sdk/migu/album.ts index c301a13..841eb8e 100644 --- a/sdk/migu/album.ts +++ b/sdk/migu/album.ts @@ -29,10 +29,10 @@ export const searchAlbum = async(keyword: string, page = 1, limit = 10) => { creator: String(item.singer ?? '').trim(), description: firstNonEmpty(item.desc, item.publishDate), link: miguAlbumLink(albumID), - source: 'migu' as const, + source: 'mg' as const, } }).filter(Boolean) - return { list, source: 'migu' as const, page, limit, total: list.length } + return { list, source: 'mg' as const, page, limit, total: list.length } } /** 专辑曲目（每页 50 全量翻页 + 去重；上游 fetchAlbumSongs） */ @@ -101,7 +101,7 @@ export const getAlbumDetail = async(id: string, page = 1, limit = 50) => { const start = (page - 1) * limit return { - source: 'migu' as const, + source: 'mg' as const, info, list: songs.slice(start, start + limit), page, diff --git a/sdk/migu/musicSearch.ts b/sdk/migu/musicSearch.ts index 52ca978..b86166e 100644 --- a/sdk/migu/musicSearch.ts +++ b/sdk/migu/musicSearch.ts @@ -37,7 +37,7 @@ export const search = async(keyword: string, page = 1, limit = 20) => { allPage: Math.max(1, Math.ceil(total / limit)), total, limit, - source: 'migu' as const, + source: 'mg' as const, } } diff --git a/sdk/migu/playlist.ts b/sdk/migu/playlist.ts index 54b98bc..2e91b17 100644 --- a/sdk/migu/playlist.ts +++ b/sdk/migu/playlist.ts @@ -31,7 +31,7 @@ const toPlaylist = (item: MiguPlaylistItem, categoryId?: string) => { playCount: parseInt(String(item.playNum ?? ''), 10) || 0, creator: firstNonEmpty(item.userName, item.ownerName), link: miguPlaylistLink(playlistID), - source: 'migu' as const, + source: 'mg' as const, ...(categoryId ? { categoryId } : {}), } } @@ -41,7 +41,7 @@ export const searchPlaylist = async(keyword: string, page = 1, limit = 20) => { const body = await searchAll(keyword, 'songlist', page, limit) const result: MiguPlaylistItem[] = body?.songListResultData?.result ?? [] const list = result.map(item => toPlaylist(item)).filter(Boolean) - return { list, source: 'migu' as const, page, limit, total: list.length } + return { list, source: 'mg' as const, page, limit, total: list.length } } /** 静态分类（上游 miguPlaylistCategoryKeywords） */ @@ -67,7 +67,7 @@ const CATEGORY_KEYWORDS = [ ] export const getCategories = () => ({ - source: 'migu' as const, + source: 'mg' as const, list: [ { id: '', name: '全部', group: '全部' }, ...CATEGORY_KEYWORDS.map(c => ({ id: c.name, name: c.name, group: c.group, hot: Boolean(c.hot) })), @@ -77,7 +77,7 @@ export const getCategories = () => ({ export const getCategoryPlaylists = async(categoryId: string, page = 1, limit = 20) => { const keyword = String(categoryId ?? '').trim() || '华语' const { list } = await searchPlaylist(keyword, page, limit) - return { list: list.map(p => toPlaylist(p as any, keyword)).filter(Boolean), source: 'migu' as const, page, limit } + return { list: list.map(p => toPlaylist(p as any, keyword)).filter(Boolean), source: 'mg' as const, page, limit } } /** 歌单曲目（每页 50 全量翻页 + 去重；上游 GetPlaylistSongs） */ @@ -123,7 +123,7 @@ export const getPlaylistDetail = async(id: string, page = 1, limit = 50) => { const { songs, total } = await fetchPlaylistSongs(playlistID) const start = (page - 1) * limit return { - source: 'migu' as const, + source: 'mg' as const, info: { name: playlistID, img: songs[0]?.img ?? '', desc: '', author: '' }, list: songs.slice(start, start + limit), page, diff --git a/sdk/migu/util.ts b/sdk/migu/util.ts index b388d4f..4947393 100644 --- a/sdk/migu/util.ts +++ b/sdk/migu/util.ts @@ -38,7 +38,7 @@ const ENCRYPTED_APP_CODE = Buffer.from([ ]) export const getMiguCookie = (): string => { - const cred = getCredentials('migu') as { cookie?: string } | null + const cred = getCredentials('mg') as { cookie?: string } | null return String(cred?.cookie ?? '').trim() } @@ -269,7 +269,7 @@ export interface MiguSong { payPlay?: boolean /** 源特有元数据（取流/歌词需要）：contentId/resourceType/formatType/copyrightId/songId/albumId */ extra: Record - source: 'migu' + source: 'mg' [key: string]: unknown } @@ -369,7 +369,7 @@ export const convertItemToSong = (item: MiguSongItem, allowPaid = true): MiguSon payPlay: isVIP, // 路由/取流需要 content_id|resource_type|format_type 三元组与版权号，放在 extra 里 extra: { ...extra, link: miguSongLink(linkID) }, - source: 'migu', + source: 'mg', } } diff --git a/sdk/types.ts b/sdk/types.ts index a1bdb74..14f8dd7 100644 --- a/sdk/types.ts +++ b/sdk/types.ts @@ -4,7 +4,7 @@ /** 音乐平台标识 */ export type Source = | 'kw' | 'kg' | 'tx' | 'wy' | 'qs' - | 'migu' | 'bd' | 'jx' | 'bl' | '5s' | 'apple' + | 'mg' | 'bd' | 'jx' | 'bl' | '5s' | 'ap' | 'xm' | 'me' | 'qt' | 'lr' /** 音质标识（wav 仅部分接口声明使用） */ diff --git a/src/http/migu-stream.ts b/src/http/migu-stream.ts index 111a70e..bfb5fda 100644 --- a/src/http/migu-stream.ts +++ b/src/http/migu-stream.ts @@ -1,5 +1,5 @@ -// 咪咕加密流票据 —— /url/migu 命中 Z3D/I3D 加密候选时登记，/stream/migu/:id 凭票解密 -// （统一入口为 /stream/:source/:id，source=migu 时 id 即此处返回的票据）。 +// 咪咕加密流票据 —— /url/mg 命中 Z3D/I3D 加密候选时登记，/stream/mg/:id 凭票解密 +// （统一入口为 /stream/:source/:id，source=mg 时 id 即此处返回的票据）。 // 不把上游 URL 塞进播放地址（Fastify path 参数限长，且 URL 含时效签名与中文路径）， // 票据短时有效（10 分钟，够播放器起播），进程内存储、不落盘。 import { randomUUID } from 'node:crypto' @@ -29,7 +29,7 @@ const prune = () => { } } -/** 登记一条加密流，返回可直接放入 /stream/migu/:id 的短票据 id */ +/** 登记一条加密流，返回可直接放入 /stream/mg/:id 的短票据 id */ export const registerMiguStream = (url: string, fileKey: string): string => { prune() const id = randomUUID().replace(/-/g, '') diff --git a/src/routes-login.ts b/src/routes-login.ts index 453a30a..5b5eba9 100644 --- a/src/routes-login.ts +++ b/src/routes-login.ts @@ -477,7 +477,7 @@ export const loginRoutes = async(fastify) => { schema: { summary: '查看登录状态', description: 'wy 为实时校验（未登录或 cookie 失效返回 logged: false），kg/tx/bl 为已存凭据（含 VIP 等级与最近更新时间），' + - 'qs/xm/me/lr/bd/jx/apple/5s 为已存凭据。', + 'qs/xm/me/lr/bd/jx/ap/5s 为已存凭据。', tags: ['登录'], }, }, async() => { @@ -496,7 +496,7 @@ export const loginRoutes = async(fastify) => { bl: biliAuth.status(), bd: qianStatus(), jx: jooxStatus(), - apple: appleStatus(), + ap: appleStatus(), '5s': fivesingStatus(), } }) diff --git a/src/routes.ts b/src/routes.ts index ba8635e..1ad2b73 100644 --- a/src/routes.ts +++ b/src/routes.ts @@ -178,10 +178,10 @@ export const musicRoutes = async(fastify: any) => { // 取流链：外部音源脚本（SOURCE_ENABLED 启用时）→ SDK 官方直连 → 酷我兜底（跨平台匹配） const finish = (res: any, via: string) => { if (!res?.url) throw new Error('获取播放地址失败') - // 加密流（migu 的 Z3D/I3D）：客户端无法自行解密，改指向服务端解密代理 /stream/migu/<票据> + // 加密流（migu 的 Z3D/I3D）：客户端无法自行解密，改指向服务端解密代理 /stream/mg/<票据> let rawUrl = String(res.url) if (res.encrypted && res.fileKey) { - rawUrl = `/stream/migu/${registerMiguStream(rawUrl, String(res.fileKey))}` + rawUrl = `/stream/mg/${registerMiguStream(rawUrl, String(res.fileKey))}` } // qs 解密流等代理地址返回相对路径，按请求的协议与 host 补全（兼容本机/局域网播放器）； // 启用 AUTH_KEY 时附带短时签名（播放器拉流无法携带自定义头，签名不暴露秘钥本身） @@ -260,23 +260,23 @@ export const musicRoutes = async(fastify: any) => { }, }, urlHandler) - // 加密流解密代理（qs 汽水解密流 / migu 咪咕 Z3D 加密流）：统一 /stream/:source/:id，用 path 段 source 区分平台。 + // 加密流解密代理（qs 汽水解密流 / mg 咪咕 Z3D 加密流）：统一 /stream/:source/:id，用 path 段 source 区分平台。 // - qs：/url/qs 登录态取流返回相对地址 /stream/qs/，本端点完成"签名 track_v2 → // 密音频下载 → spade key + AES-CTR 解密 → 回明文流" - // - migu：/url/migu 命中 Z3D/I3D 加密候选时登记票据并返回 /stream/migu/<票据>，本端点凭票下载密流逐字节解密 + // - mg：/url/mg 命中 Z3D/I3D 加密候选时登记票据并返回 /stream/mg/<票据>，本端点凭票下载密流逐字节解密 // 两者均由 /url 产出相对地址，路由层负责补全 origin；raw 豁免 { code, data } 信封包装 fastify.get('/stream/:source/:id', { config: { raw: true }, schema: { - summary: '加密流解密代理（qs / migu）', - description: '取流响应中返回的相对地址（/url/qs 的流地址、/url/migu 命中加密流时的地址），' + + summary: '加密流解密代理（qs / mg）', + description: '取流响应中返回的相对地址（/url/qs 的流地址、/url/mg 命中加密流时的地址），' + '服务端下载上游密流并在本地解密后返回明文音频；不接受客户端自行构造。' + 'source=qs 时 id 为汽水 track id（track_v2 签名 + cenc-aes-ctr 解密）；' + - 'source=migu 时 id 为取流响应 url 中的票据段（票据 10 分钟内有效，过期请重新 /url/migu 取流）。', + 'source=mg 时 id 为取流响应 url 中的票据段（票据 10 分钟内有效，过期请重新 /url/mg 取流）。', tags: ['歌曲资源'], params: params({ - source: { type: 'string', enum: ['qs', 'migu'], description: '平台 id：qs=汽水音乐解密流 / migu=咪咕加密流', example: 'qs' }, - id: { type: 'string', description: 'qs: 汽水 track id；migu: 取流响应 url 中的票据段（无需自行构造）', example: '7123456789' }, + source: { type: 'string', enum: ['qs', 'mg'], description: '平台 id：qs=汽水音乐解密流 / mg=咪咕加密流', example: 'qs' }, + id: { type: 'string', description: 'qs: 汽水 track id；mg: 取流响应 url 中的票据段（无需自行构造）', example: '7123456789' }, }), }, }, async(request, reply) => { @@ -297,7 +297,7 @@ export const musicRoutes = async(fastify: any) => { // 咪咕：票据 → 逐块解密流 const ticket = takeMiguStream(String(id)) - if (!ticket) throw notFound('解密票据不存在或已过期（请重新调用 /url/migu 取流）') + if (!ticket) throw notFound('解密票据不存在或已过期（请重新调用 /url/mg 取流）') // 流式下载 + 逐块解密：咪咕 Z3D 密钥流按 32 字节循环，块内保持全局偏移即可， // 避免把上百 MB 的 wav/flac 整段读进内存（httpFetch 有 64MB 缓冲上限） const { miguZ3DStreamKey, isMiguAudioMagic } = await import('../sdk/migu/util.ts') @@ -513,7 +513,7 @@ export const musicRoutes = async(fastify: any) => { const albumSchema = (withPage: boolean) => ({ summary: '获取专辑详情与曲目列表', - description: '支持 kg/kw/tx/wy/xm/me/qt/lr/migu/bd/jx/apple（见 /sources 的 album 能力位）。' + + description: '支持 kg/kw/tx/wy/xm/me/qt/lr/mg/bd/jx/ap（见 /sources 的 album 能力位）。' + 'kw 单页固定 1000 条、xm/me 固定 30 条、limit 不生效。', tags: ['歌手专辑'], params: params({ @@ -538,7 +538,7 @@ export const musicRoutes = async(fastify: any) => { fastify.get('/album/:source/search/:keyword', { schema: { summary: '搜索专辑', - description: '支持 kg/kw/tx/wy/migu/bd/jx/apple（见 /sources 的 albumSearch 能力位）。', + description: '支持 kg/kw/tx/wy/mg/bd/jx/ap（见 /sources 的 albumSearch 能力位）。', tags: ['歌手专辑'], params: params({ source: pSource('album.searchAlbum'), keyword: { type: 'string', description: '专辑名关键词', example: '魔杰座' } }), querystring: qs({ page: pPage, limit: pLimit }), @@ -563,7 +563,7 @@ export const musicRoutes = async(fastify: any) => { fastify.get('/playlist/:source/search/:keyword', { schema: { summary: '搜索歌单', - description: '支持 kg/kw/tx/wy/migu/bd/jx/bl/5s/apple（见 /sources 的 playlistSearch 能力位）。' + + description: '支持 kg/kw/tx/wy/mg/bd/jx/bl/5s/ap（见 /sources 的 playlistSearch 能力位）。' + '部分平台该能力受限（如 bd 歌单搜索接口已下线、bl 需登录），失败时返回 502。', tags: ['歌单'], params: params({ source: pSource('playlist.searchPlaylist'), keyword: { type: 'string', example: '华语' } }), @@ -586,7 +586,7 @@ export const musicRoutes = async(fastify: any) => { fastify.get('/playlist/:source/categories', { schema: { summary: '获取歌单分类', - description: '支持 kw/kg/tx/wy/migu/bd/jx/bl/5s/apple（见 /sources 的 playlistCategories 能力位）。', + description: '支持 kw/kg/tx/wy/mg/bd/jx/bl/5s/ap（见 /sources 的 playlistCategories 能力位）。', tags: ['歌单'], params: params({ source: pSource('playlist.getCategories') }), response: responses('PlaylistCategoriesResult'), @@ -631,7 +631,7 @@ export const musicRoutes = async(fastify: any) => { const playlistSchema = (withPage: boolean) => ({ summary: '获取歌单详情与曲目列表', description: 'id 为歌单 id 或链接（部分平台支持链接/裸 id，如 bl 的 season:::、' + - 'jx/bd/migu 的网页链接）。列表按 page/limit 切片（聚合接口自身分页的平台由平台决定）。', + 'jx/bd/mg 的网页链接）。列表按 page/limit 切片（聚合接口自身分页的平台由平台决定）。', tags: ['歌单'], params: params({ source: pSource('playlist'), @@ -701,7 +701,7 @@ export const musicRoutes = async(fastify: any) => { schema: { summary: `解析${kind === 'song' ? '歌曲' : kind === 'album' ? '专辑' : '歌单'}链接`, description: '把平台链接（或裸 id）解析成结构化歌曲/曲目数据。支持平台见 /sources 的 parse 能力位；' + - '5s 歌曲/歌单、apple/bl/jx/bd/migu 三类、kw/kg/tx/wy 部分支持。', + '5s 歌曲/歌单、apple/bl/jx/bd/mg 三类、kw/kg/tx/wy 部分支持。', tags: ['链接解析'], params: params({ source: pSource('parse.parseSong') }), body: parseBodySchema, diff --git a/src/server.ts b/src/server.ts index ac71e03..9f87ff1 100644 --- a/src/server.ts +++ b/src/server.ts @@ -20,7 +20,7 @@ // GET /playlist/:source/categories[/:categoryId] 歌单分类 // POST /parse/{song|album|playlist}/:source 链接解析 // GET /user-playlist/:source 个人歌单 -// GET /stream/:source/:id 解密流代理（source: qs 汽水 / migu 咪咕） +// GET /stream/:source/:id 解密流代理（source: qs 汽水 / mg 咪咕） // GET /sources /health GET /docs /redoc /openapi.json // // 状态码语义：200 成功；422 参数校验失败；404 路由或平台不存在；405 方法不允许；502 上游平台失败；500 内部错误 @@ -48,8 +48,8 @@ const PORT = process.env.PORT || 16688 const DOCS_PREFIX = '/docs' const API_TITLE = 'MusicServer 聚合音乐 API' const API_DESCRIPTION = '多平台音乐聚合接口：搜索、播放地址、歌词、封面、榜单、歌单、专辑、歌手、链接解析。' + - '支持 kw（酷我）/ kg（酷狗）/ tx（QQ音乐）/ wy（网易云）/ qs（汽水音乐）/ migu（咪咕）/ bd（千千）/ ' + - 'jx / bl（哔哩哔哩）/ 5s / apple（Apple Music，仅试听）与有声平台 xm（喜马拉雅）/ me（猫耳FM）/ qt（蜻蜓FM）/ lr（懒人听书）。' + '支持 kw（酷我）/ kg（酷狗）/ tx（QQ音乐）/ wy（网易云）/ qs（汽水音乐）/ mg（咪咕）/ bd（千千）/ ' + + 'jx / bl（哔哩哔哩）/ 5s / ap（Apple Music，仅试听）与有声平台 xm（喜马拉雅）/ me（猫耳FM）/ qt（蜻蜓FM）/ lr（懒人听书）。' const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '../package.json'), 'utf8')) diff --git a/test/smoke-test.ts b/test/smoke-test.ts index f99afd9..1fdf5d4 100644 --- a/test/smoke-test.ts +++ b/test/smoke-test.ts @@ -514,9 +514,9 @@ await test('专辑详情 /album/lr', async() => { return `${r.data.info.total} 节` }) -// ---- 新平台（migu/bd/jx/bl/5s/apple 移植回归） ---- +// ---- 新平台（migu/bd/jx/bl/5s/ap 移植回归） ---- -for (const source of ['migu', 'bd', 'jx', 'bl', '5s', 'apple']) { +for (const source of ['mg', 'bd', 'jx', 'bl', '5s', 'ap']) { await test(`搜索 ${source} 直查`, async() => { const r = await get(`/search/${source}/${encodeURIComponent(source === '5s' ? '董贞' : '周杰伦')}?limit=5`) if (r.code != 0) throw new Error(r.msg) @@ -525,14 +525,14 @@ for (const source of ['migu', 'bd', 'jx', 'bl', '5s', 'apple']) { }) } -await test('URL migu（多档候选链）', async() => { - const r = await get(`/search/migu/${encodeURIComponent('起风了')}?limit=3`) +await test('URL mg（多档候选链）', async() => { + const r = await get(`/search/mg/${encodeURIComponent('起风了')}?limit=3`) if (r.code != 0 || !r.data?.list?.length) throw new Error('搜索失败，无法取流') const song = r.data.list.find((s: any) => !s.payPlay) ?? r.data.list[0] - const u = await get(`/url/migu/${encodeURIComponent(song.songmid)}?quality=128k`) + const u = await get(`/url/mg/${encodeURIComponent(song.songmid)}?quality=128k`) if (u.code != 0) throw new Error(u.msg) const url = String(u.data.url) - if (!url.startsWith('http') && !url.includes('/stream/migu/')) throw new Error('url 非法') + if (!url.startsWith('http') && !url.includes('/stream/mg/')) throw new Error('url 非法') return `实际 ${u.data.type}，${url.slice(0, 60)}` }) @@ -555,11 +555,11 @@ await test('URL 5s（档位 sq/hq/lq）', async() => { return `实际 ${u.data.type}，${String(u.data.url).slice(0, 60)}` }) -await test('歌词 migu', async() => { - const r = await get(`/search/migu/${encodeURIComponent('起风了')}?limit=3`) +await test('歌词 mg', async() => { + const r = await get(`/search/mg/${encodeURIComponent('起风了')}?limit=3`) const song = r.data?.list?.[0] if (!song) throw new Error('搜索失败') - const l = await get(`/lyric/migu/${encodeURIComponent(song.songmid)}`) + const l = await get(`/lyric/mg/${encodeURIComponent(song.songmid)}`) if (l.code != 0) throw new Error(l.msg) if (!l.data?.lyric) throw new Error('空歌词') return l.data.lyric.slice(0, 40) @@ -575,17 +575,17 @@ await test('歌词 5s', async() => { return l.data.lyric.slice(0, 40) }) -await test('封面 migu', async() => { - const r = await get(`/search/migu/${encodeURIComponent('起风了')}?limit=3`) +await test('封面 mg', async() => { + const r = await get(`/search/mg/${encodeURIComponent('起风了')}?limit=3`) const song = r.data?.list?.[0] if (!song) throw new Error('搜索失败') - const p = await get(`/pic/migu/${encodeURIComponent(song.songmid)}`) + const p = await get(`/pic/mg/${encodeURIComponent(song.songmid)}`) if (p.code != 0) throw new Error(p.msg) if (!String(p.data?.url ?? '').startsWith('http')) throw new Error('封面 url 非法') return String(p.data.url).slice(0, 60) }) -for (const source of ['migu', 'bd', 'jx', 'apple']) { +for (const source of ['mg', 'bd', 'jx', 'ap']) { await test(`专辑搜索 /album/${source}/search`, async() => { const r = await get(`/album/${source}/search/${encodeURIComponent('Hello')}?limit=3`) if (r.code != 0) throw new Error(r.msg) @@ -594,17 +594,17 @@ for (const source of ['migu', 'bd', 'jx', 'apple']) { }) } -await test('专辑详情 /album/migu', async() => { - const r = await get(`/search/migu/${encodeURIComponent('起风了')}?limit=3`) +await test('专辑详情 /album/mg', async() => { + const r = await get(`/search/mg/${encodeURIComponent('起风了')}?limit=3`) const albumId = r.data?.list?.find((s: any) => s.albumId)?.albumId if (!albumId) throw new Error('搜索结果未携带 albumId') - const a = await get(`/album/migu/${albumId}`) + const a = await get(`/album/mg/${albumId}`) if (a.code != 0) throw new Error(a.msg) if (!a.data?.list?.length) throw new Error('专辑无曲目') return `${a.data.info.name}（${a.data.total} 首）` }) -for (const source of ['migu', 'bd', 'jx', 'apple']) { +for (const source of ['mg', 'bd', 'jx', 'ap']) { await test(`歌单分类 /playlist/${source}/categories`, async() => { const r = await get(`/playlist/${source}/categories`) if (r.code != 0) throw new Error(r.msg) @@ -623,13 +623,13 @@ for (const source of ['migu', 'bd', 'jx', 'apple']) { }) } -await test('歌单详情 /playlist/migu', async() => { - const c = await get('/playlist/migu/categories') +await test('歌单详情 /playlist/mg', async() => { + const c = await get('/playlist/mg/categories') const cat = c.data.list[0] - const pl = await get(`/playlist/migu/categories/${encodeURIComponent(cat.id)}?limit=3`) + const pl = await get(`/playlist/mg/categories/${encodeURIComponent(cat.id)}?limit=3`) const id = pl.data?.list?.[0]?.id if (!id) throw new Error('未取到歌单 id') - const d = await get(`/playlist/migu/${id}?limit=5`) + const d = await get(`/playlist/mg/${id}?limit=5`) if (d.code != 0) throw new Error(d.msg) if (!d.data?.list?.length) throw new Error('歌单无曲目') return `${d.data.total} 首，本页 ${d.data.list.length} 首` @@ -645,8 +645,8 @@ await test('歌单详情 /playlist/bl（合集）', async() => { return `${d.data.total} 首` }) -await test('链接解析 /parse/song/migu', async() => { - const r = await postJson('/parse/song/migu', { link: 'https://music.migu.cn/v3/music/song/600913000002601091' }) +await test('链接解析 /parse/song/mg', async() => { + const r = await postJson('/parse/song/mg', { link: 'https://music.migu.cn/v3/music/song/600913000002601091' }) if (r.status !== 200 || r.body?.code != 0) throw new Error(JSON.stringify(r.body).slice(0, 120)) if (!r.body.data?.song?.songmid) throw new Error('缺少 song') return `${r.body.data.song.name} / ${r.body.data.song.singer}` @@ -659,8 +659,8 @@ await test('链接解析 /parse/playlist/bd', async() => { return `${r.body.data.playlist?.name ?? ''}（${r.body.data.total} 首）` }) -await test('链接解析 /parse/album/apple', async() => { - const r = await postJson('/parse/album/apple', { link: 'https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249' }) +await test('链接解析 /parse/album/ap', async() => { + const r = await postJson('/parse/album/ap', { link: 'https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249' }) if (r.status !== 200 || r.body?.code != 0) throw new Error(JSON.stringify(r.body).slice(0, 120)) if (!r.body.data?.list?.length) throw new Error('无曲目') return `${r.body.data.playlist?.name ?? ''}（${r.body.data.total} 首）` @@ -705,7 +705,7 @@ await test('个人歌单 未支持的平台 → 502', async() => { }) await test('咪咕解密流代理 无票据 → 404', async() => { - const r = await getRaw('/stream/migu/ffffffffffffffffffffffffffffffff') + const r = await getRaw('/stream/mg/ffffffffffffffffffffffffffffffff') if (r.status !== 404) throw new Error(`期望 404，实际 ${r.status}`) return JSON.parse(r.body).msg?.slice(0, 50) })