refactor(api)!: 平台 id 回退——joox/5sing/bili/apple 恢复全名,目录对齐 bd/mg

- 撤销 3381e9b/1b972ec 中 jx/5s/bl/ap 四个短码,恢复 joox/5sing/bili/apple;
  qian→bd、migu→mg 保留
- 目录与文件对齐保留的新 id:sdk/qian/→sdk/bd/、sdk/migu/→sdk/mg/、
  sdk/apis/qian.ts→bd.ts、migu.ts→mg.ts、src/http/migu-stream.ts→mg-stream.ts
  (规则改为「目录=对外 id」,聚合入口的模块变量同步更名;music.migu.cn 等域名、
  上游 music-lib 对照注释、miguGet 等功能标识符不动)
- 对外 id 全表:kw kg tx wy qs xm me qt lr mg bd joox 5sing bili apple

**破坏性变更**:joox/5sing/bili/apple 四平台的 URL、/sources 返回与
data/auth.json 凭据键恢复全名,已存短码键的登录态需重新登录。

验证:typecheck ✓、pnpm test 112/112 ✓
This commit is contained in:
snowy-yang committed 2026-10-03 21:04:55 +08:00
1 parent 8c02fb5c15
commit e1357dd412
50 files changed
+178 -178

No files matched your search

+21 -21
View File
@@ -4,7 +4,7 @@
## 功能 ## 功能
- **多平台聚合**:酷我(kw)、酷狗(kg)、QQ音乐(tx)、网易云(wy)、汽水音乐(qs)、咪咕音乐(mg)、千千音乐(bd)、JOOX(jx)、哔哩哔哩(bl)、5sing(5s);有声平台:喜马拉雅(xm)、猫耳FM(me)、蜻蜓FM(qt)、懒人听书(lr);Apple Music(ap,仅 preview 试听) - **多平台聚合**:酷我(kw)、酷狗(kg)、QQ音乐(tx)、网易云(wy)、汽水音乐(qs)、咪咕音乐(mg)、千千音乐(bd)、JOOX(joox)、哔哩哔哩(bili)、5sing(5sing);有声平台:喜马拉雅(xm)、猫耳FM(me)、蜻蜓FM(qt)、懒人听书(lr);Apple Music(apple,仅 preview 试听)
- **直连取流**:各平台播放地址获取(不依赖第三方 API 服务) - **直连取流**:各平台播放地址获取(不依赖第三方 API 服务)
- **完整链路**:搜索、播放地址、歌词(含各平台加密歌词解码)、封面、榜单、热搜、歌单、专辑、歌手、链接解析(歌单/专辑/歌曲网页链接) - **完整链路**:搜索、播放地址、歌词(含各平台加密歌词解码)、封面、榜单、热搜、歌单、专辑、歌手、链接解析(歌单/专辑/歌曲网页链接)
- 有声平台(xm/me/qt/lr)与 Apple Music(仅试听)不参与聚合搜索与跨平台匹配,仅支持 source 直查 - 有声平台(xm/me/qt/lr)与 Apple Music(仅试听)不参与聚合搜索与跨平台匹配,仅支持 source 直查
@@ -20,10 +20,10 @@
| 汽水音乐 | `qs` | ✅ | 128k/320k(登录解锁无损) | ✅ | ✅ | — | — | — | 扫码 | | 汽水音乐 | `qs` | ✅ | 128k/320k(登录解锁无损) | ✅ | ✅ | — | — | — | 扫码 |
| 咪咕音乐 | `mg` | ✅ | 64k/128k/320k/flac/flac24bit | ✅ | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie(解锁高档位) | | 咪咕音乐 | `mg` | ✅ | 64k/128k/320k/flac/flac24bit | ✅ | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie(解锁高档位) |
| 千千音乐 | `bd` | ✅ | 64k/128k/320k/flac | ✅ | ✅ | ✅ 详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie(VIP 曲目) | | 千千音乐 | `bd` | ✅ | 64k/128k/320k/flac | ✅ | ✅ | ✅ 详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie(VIP 曲目) |
| JOOX | `jx` | ✅ | 128k(VIP 为试听片段) | ✅ | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie(VIP 完整曲) | | JOOX | `joox` | ✅ | 128k(VIP 为试听片段) | ✅ | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie(VIP 完整曲) |
| 哔哩哔哩 | `bl` | ✅ | 64k/128k/320k/flac/flac24bit(实际命中 B站档位 132k/192k;flac/Hi-Res 需大会员) | ✅ | ✅ | ✅ 搜索/详情(合集/多分P) | — | ✅ 歌曲/歌单 | 扫码 | | 哔哩哔哩 | `bili` | ✅ | 64k/128k/320k/flac/flac24bit(实际命中 B站档位 132k/192k;flac/Hi-Res 需大会员) | ✅ | ✅ | ✅ 搜索/详情(合集/多分P) | — | ✅ 歌曲/歌单 | 扫码 |
| 5sing | `5s` | ✅ | sq/hq/lq | ✅ | — | ✅ 搜索/详情 | — | ✅ 歌曲/歌单 | cookie(可选) | | 5sing | `5sing` | ✅ | sq/hq/lq | ✅ | — | ✅ 搜索/详情 | — | ✅ 歌曲/歌单 | cookie(可选) |
| Apple Music | `ap` | ✅ | preview 试听片段 | ✅(需登录) | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie(media-user-token) | | Apple Music | `apple` | ✅ | preview 试听片段 | ✅(需登录) | ✅ | ✅ 搜索/详情/分类 | ✅ 搜索/详情 | ✅ 歌曲/专辑/歌单 | cookie(media-user-token) |
| 喜马拉雅 | `xm` | ✅ | 64k/128k | — | ✅ | — | ✅ 详情 | — | cookie | | 喜马拉雅 | `xm` | ✅ | 64k/128k | — | ✅ | — | ✅ 详情 | — | cookie |
| 猫耳FM | `me` | ✅ | 64k/128k | — | ✅ | — | ✅ 详情 | — | token | | 猫耳FM | `me` | ✅ | 64k/128k | — | ✅ | — | ✅ 详情 | — | token |
| 蜻蜓FM | `qt` | ✅ | 64k/128k | — | ✅ | — | ✅ 详情 | — | — | | 蜻蜓FM | `qt` | ✅ | 64k/128k | — | ✅ | — | ✅ 详情 | — | — |
@@ -62,13 +62,13 @@ pnpm typecheck # 仅类型检查,不运行
| `GET /singer/:source/:id` | 歌手信息(kg/tx/wy) | | `GET /singer/:source/:id` | 歌手信息(kg/tx/wy) |
| `GET /singer/:source/:id/songs[/:page]?limit=30` | 歌手歌曲列表(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 /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/mg/bd/jx/ap | | `GET /album/:source/:id[/:page]` | 专辑详情与曲目(分页为 path 段,第 1 页省略)。支持 kg/kw/tx/wy/xm/me/qt/lr/mg/bd/joox/apple |
| `GET /album/:source/search/:keyword` | 专辑搜索(kg/kw/tx/wy/mg/bd/jx/ap) | | `GET /album/:source/search/:keyword` | 专辑搜索(kg/kw/tx/wy/mg/bd/joox/apple) |
| `GET /playlist/:source/search/:keyword` | 歌单搜索(kg/kw/tx/wy/mg/bd/jx/bl/5s/ap) | | `GET /playlist/:source/search/:keyword` | 歌单搜索(kg/kw/tx/wy/mg/bd/joox/bili/5sing/apple) |
| `GET /playlist/:source/categories` | 歌单分类(kw/kg/tx/wy/mg/bd/jx/bl/5s/ap) | | `GET /playlist/:source/categories` | 歌单分类(kw/kg/tx/wy/mg/bd/joox/bili/5sing/apple) |
| `GET /playlist/:source/categories/:categoryId` | 分类下的歌单(同上) | | `GET /playlist/:source/categories/:categoryId` | 分类下的歌单(同上) |
| `GET /playlist/:source/:id[/:page]?limit=` | 歌单详情与曲目(kw/kg/tx/wy/mg/bd/jx/bl/5s/ap;bl 支持合集/多分P) | | `GET /playlist/:source/:id[/:page]?limit=` | 歌单详情与曲目(kw/kg/tx/wy/mg/bd/joox/bili/5sing/apple;bili 支持合集/多分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 端点) | | `POST /parse/song/:source` 等 | 链接解析:body `{ "link": "..." }`,三个端点 `parse/song` / `parse/album` / `parse/playlist`。支持 kw/kg/tx/wy/5sing/apple/bili/joox/bd/mg(其中 bili、5sing 无 album 端点) |
| `GET /user-playlist/:source` | 个人歌单(仅 tx/wy 有完整实现;需登录,未登录或平台不支持返回 404/502) | | `GET /user-playlist/:source` | 个人歌单(仅 tx/wy 有完整实现;需登录,未登录或平台不支持返回 404/502) |
| `POST /login/wy/qr` → `POST /login/wy/qr/check` | 网易云扫码登录(扫码后轮询完成登录) | | `POST /login/wy/qr` → `POST /login/wy/qr/check` | 网易云扫码登录(扫码后轮询完成登录) |
| `POST /login/wy/cellphone` | 网易云手机号登录(password 或 captcha) | | `POST /login/wy/cellphone` | 网易云手机号登录(password 或 captcha) |
@@ -83,8 +83,8 @@ pnpm typecheck # 仅类型检查,不运行
| `POST /login/xm` | 绑定喜马拉雅 cookie(www.ximalaya.com 复制,须含 `1&_token`,解锁付费/已购内容取流) | | `POST /login/xm` | 绑定喜马拉雅 cookie(www.ximalaya.com 复制,须含 `1&_token`,解锁付费/已购内容取流) |
| `POST /login/me` | 绑定猫耳FM token(App 抓包或 m.missevan.com 复制,须含 `token=`,解锁付费声音取流) | | `POST /login/me` | 绑定猫耳FM token(App 抓包或 m.missevan.com 复制,须含 `token=`,解锁付费声音取流) |
| `POST /login/lr` | 懒人听书账号登录(account+password,懒人取流要求登录态,免费章节同样) | | `POST /login/lr` | 懒人听书账号登录(account+password,懒人取流要求登录态,免费章节同样) |
| `POST /login/bl/qr` → `POST /login/bl/qr/check` | 哔哩哔哩扫码登录(B站 App 扫一扫,登录后解锁大会员音质) | | `POST /login/bili/qr` → `POST /login/bili/qr/check` | 哔哩哔哩扫码登录(B站 App 扫一扫,登录后解锁大会员音质) |
| `DELETE /login/{wy,kg,tx,qs,xm,me,lr,bl}` | 清除对应平台凭据(退出登录) | | `DELETE /login/{wy,kg,tx,qs,xm,me,lr,bili}` | 清除对应平台凭据(退出登录) |
| `GET /login/status` | 登录状态(登录后取流/请求自动携带凭据) | | `GET /login/status` | 登录状态(登录后取流/请求自动携带凭据) |
| `GET /sources` | 平台列表(音质与能力) | | `GET /sources` | 平台列表(音质与能力) |
| `GET /health` | 健康检查 | | `GET /health` | 健康检查 |
@@ -105,10 +105,10 @@ pnpm typecheck # 仅类型检查,不运行
- **lr**:`<bookId>:<section>` 复合 id(/album/lr 章节列表产出);取流必须 `POST /login/lr` 登录(免费章节同样要求登录态) - **lr**:`<bookId>:<section>` 复合 id(/album/lr 章节列表产出);取流必须 `POST /login/lr` 登录(免费章节同样要求登录态)
- **mg**:`<contentId>|<resourceType>|<formatType>` 三元组(搜索结果/专辑/歌单产出);取流走 listen-url 多档候选链 + 逐档 Range 探测,命中可访问的最高档(匿名实测可出 flac24bit 真无损),Z3D/I3D 加密流自动改走 `/stream/mg` 解密代理 - **mg**:`<contentId>|<resourceType>|<formatType>` 三元组(搜索结果/专辑/歌单产出);取流走 listen-url 多档候选链 + 逐档 Range 探测,命中可访问的最高档(匿名实测可出 flac24bit 真无损),Z3D/I3D 加密流自动改走 `/stream/mg` 解密代理
- **bd**:track id(T 开头,搜索结果的 `songmid`);免费曲目匿名可出 128k/320k/flac 明文直链,VIP/版权曲目需 cookie - **bd**:track id(T 开头,搜索结果的 `songmid`);免费曲目匿名可出 128k/320k/flac 明文直链,VIP/版权曲目需 cookie
- **jx**:加密后的 track id(含 `=`/`+`,URL 编码后传);游客 128k,VIP 完整曲需 cookie(`wmid`+`session_key`) - **joox**:加密后的 track id(含 `=`/`+`,URL 编码后传);游客 128k,VIP 完整曲需 cookie(`wmid`+`session_key`)
- **bl**:`<bvid>|<cid>`(搜索结果/合集曲目产出);合集/歌单 id 形如 `season:<id>:<mid>:<bvid>` 或 `bvid:<bvid>` - **bili**:`<bvid>|<cid>`(搜索结果/合集曲目产出);合集/歌单 id 形如 `season:<id>:<mid>:<bvid>` 或 `bvid:<bvid>`
- **5s**:`<songId>|<songType>`(如 `932557|yc`,songType 为 yc 原创 / fc 翻唱 / bz 伴奏),URL 路径需编码 `|` 为 `%7C` - **5sing**:`<songId>|<songType>`(如 `932557|yc`,songType 为 yc 原创 / fc 翻唱 / bz 伴奏),URL 路径需编码 `|` 为 `%7C`
- **ap**:数字歌曲 id(搜索结果产出);取流固定为 `preview` 试听片段(完整曲为 DRM,不在支持范围) - **apple**:数字歌曲 id(搜索结果产出);取流固定为 `preview` 试听片段(完整曲为 DRM,不在支持范围)
`/url` 在外部音源与平台直连都失败时,自动降级到**酷我**兜底:按歌名/歌手/时长匹配同一首歌后走 kw 通道(匿名可拿无损)。kg 可由 hash 反查歌曲信息;其它平台需要兜底时给 `/url` 传 `name`/`singer`/`interval` 查询参数。 `/url` 在外部音源与平台直连都失败时,自动降级到**酷我**兜底:按歌名/歌手/时长匹配同一首歌后走 kw 通道(匿名可拿无损)。kg 可由 hash 反查歌曲信息;其它平台需要兜底时给 `/url` 传 `name`/`singer`/`interval` 查询参数。
@@ -172,7 +172,7 @@ src/ HTTP 应用层(Fastify 服务器,全部 TypeScript 源
server.ts HTTP 服务器入口(pnpm start 实际启动文件) server.ts HTTP 服务器入口(pnpm start 实际启动文件)
routes.ts 业务路由(JSON Schema 校验 + OpenAPI 元数据) routes.ts 业务路由(JSON Schema 校验 + OpenAPI 元数据)
routes-login.ts 登录路由(wy 扫码/手机号、kg 扫码/短信/账密+风控验证/token、tx 扫码/cookie、qs 汽水扫码、 routes-login.ts 登录路由(wy 扫码/手机号、kg 扫码/短信/账密+风控验证/token、tx 扫码/cookie、qs 汽水扫码、
bl 扫码、xm/me cookie 绑定、lr 账密) bili 扫码、xm/me cookie 绑定、lr 账密)
source.ts 外部音源候选链(SOURCE_ENABLED 时 /url 取流优先走 sources/ 脚本,失败回落 SDK) source.ts 外部音源候选链(SOURCE_ENABLED 时 /url 取流优先走 sources/ 脚本,失败回落 SDK)
source-ivm.ts 社区音源脚本加载器(isolated-vm 硬隔离沙箱) source-ivm.ts 社区音源脚本加载器(isolated-vm 硬隔离沙箱)
source-simple.ts 简单 API 音源脚本加载器(.mjs 进程内直载) source-simple.ts 简单 API 音源脚本加载器(.mjs 进程内直载)
@@ -210,8 +210,8 @@ test/
- **kw 取流**:主通道 mobi.s 严格校验「返回 bitrate == 请求档位且为明文格式」,档位缺失时沿降级链换档(flac24bit→flac→320k→128k);web playUrl 回退通道匿名恒 128k。 - **kw 取流**:主通道 mobi.s 严格校验「返回 bitrate == 请求档位且为明文格式」,档位缺失时沿降级链换档(flac24bit→flac→320k→128k);web playUrl 回退通道匿名恒 128k。
- **qs 取流**:匿名仅 30s 试听;完整曲目需 `/login/qs/qr` 用**汽水音乐 App** 扫码登录,取流走 `/stream/qs/:id` 解密流代理(一次性下载解密回明文,不支持 Range)。 - **qs 取流**:匿名仅 30s 试听;完整曲目需 `/login/qs/qr` 用**汽水音乐 App** 扫码登录,取流走 `/stream/qs/:id` 解密流代理(一次性下载解密回明文,不支持 Range)。
- **mg 取流**:匿名 PQ(128k) 永远可用,但候选链会优先探测更高档位——多数曲目实际能匿名拿到 SQ/ZQ 真无损直链(上游同款 tone 路径重写 + 逐档探测);Z3D/I3D 加密候选经 `/stream/mg` 解密后同样可播。HQ/SQ 返回「登录后免费试听」时自动降级到可用的最高档。 - **mg 取流**:匿名 PQ(128k) 永远可用,但候选链会优先探测更高档位——多数曲目实际能匿名拿到 SQ/ZQ 真无损直链(上游同款 tone 路径重写 + 逐档探测);Z3D/I3D 加密候选经 `/stream/mg` 解密后同样可播。HQ/SQ 返回「登录后免费试听」时自动降级到可用的最高档。
- **ap 取流**:只有 preview 试听片段(约 30–90s,AAC/m4a),返回的 `type` 固定为 `preview`,不要当作完整曲。 - **apple 取流**:只有 preview 试听片段(约 30–90s,AAC/m4a),返回的 `type` 固定为 `preview`,不要当作完整曲。
- **bl 取流**:匿名最高 192k;flac/Hi-Res 需 `/login/bl/qr` 登录大会员账号。CDN 有约 1 小时的 `deadline` 签名,取流结果不宜缓存过久。 - **bili 取流**:匿名最高 192k;flac/Hi-Res 需 `/login/bili/qr` 登录大会员账号。CDN 有约 1 小时的 `deadline` 签名,取流结果不宜缓存过久。
- **5s 歌单详情**:依赖 5sing 网页(`5sing.kugou.com/.../dj/...html`)解析曲目;2026-10-02 实测该站点网页层整体 502(搜索/取流/歌词等手机端 API 不受影响)。上游同样依赖该页面,待站点恢复即自动可用。 - **5sing 歌单详情**:依赖 5sing 网页(`5sing.kugou.com/.../dj/...html`)解析曲目;2026-10-02 实测该站点网页层整体 502(搜索/取流/歌词等手机端 API 不受影响)。上游同样依赖该页面,待站点恢复即自动可用。
- **link 解析**:`/parse/*` 走各平台网页链接解析(需上游有对应实现);未实现的平台返回 404。 - **link 解析**:`/parse/*` 走各平台网页链接解析(需上游有对应实现);未实现的平台返回 404。
- 平台接口随时可能变更,遇失效时可对照 `sdk/apis/` 内的接口文档调整。 - 平台接口随时可能变更,遇失效时可对照 `sdk/apis/` 内的接口文档调整。
+5 -5
View File
@@ -3,7 +3,7 @@
多平台音乐聚合接口:搜索、播放地址、歌词、封面、榜单、歌单、专辑、歌手、链接解析、登录。 多平台音乐聚合接口:搜索、播放地址、歌词、封面、榜单、歌单、专辑、歌手、链接解析、登录。
共 15 个平台:`kw`(酷我)/ `kg`(酷狗)/ `tx`(QQ音乐)/ `wy`(网易云)/ `qs`(汽水)/ `mg`(咪咕)/ 共 15 个平台:`kw`(酷我)/ `kg`(酷狗)/ `tx`(QQ音乐)/ `wy`(网易云)/ `qs`(汽水)/ `mg`(咪咕)/
`bd`(千千)/ `jx` / `bl`(哔哩哔哩)/ `5s` / `ap`(Apple Music,仅试听), `bd`(千千)/ `joox` / `bili`(哔哩哔哩)/ `5sing` / `apple`(Apple Music,仅试听),
以及有声平台 `xm`(喜马拉雅)/ `me`(猫耳FM)/ `qt`(蜻蜓FM)/ `lr`(懒人听书)。 以及有声平台 `xm`(喜马拉雅)/ `me`(猫耳FM)/ `qt`(蜻蜓FM)/ `lr`(懒人听书)。
> **本文档是人工速查版,可能滞后于代码。** > **本文档是人工速查版,可能滞后于代码。**
@@ -40,7 +40,7 @@
### 歌曲 id 形态 ### 歌曲 id 形态
各平台 id 约定(含 `kw` 的 songmid、`kg` 的 hash、`qs`/`xm`/`me` 的 id、`mg` 的三元组、 各平台 id 约定(含 `kw` 的 songmid、`kg` 的 hash、`qs`/`xm`/`me` 的 id、`mg` 的三元组、
`qt`/`lr` 的复合 id、`bl` 的 `<bvid>|<cid>` 等)详见 README「歌曲 ID 约定」。 `qt`/`lr` 的复合 id、`bili` 的 `<bvid>|<cid>` 等)详见 README「歌曲 ID 约定」。
复合 id 含 `|` / `:` 时在 URL 中需编码(`|` → `%7C`)。 复合 id 含 `|` / `:` 时在 URL 中需编码(`|` → `%7C`)。
## 接口速查 ## 接口速查
@@ -78,7 +78,7 @@
| GET | `/boards/:source/:boardId[/:page]` | 榜单详情(分页 path 段)。`boardId` 兼容带前缀 id(`kw__93`)与裸 `bangid`(`93`) | | GET | `/boards/:source/:boardId[/:page]` | 榜单详情(分页 path 段)。`boardId` 兼容带前缀 id(`kw__93`)与裸 `bangid`(`93`) |
| GET | `/hot-search/:source` | 热搜词 | | GET | `/hot-search/:source` | 热搜词 |
| GET | `/song-list/:source[/:page]` | 歌单列表;`?sortId=` `?tagId=` 各平台词汇不同,省略时用平台默认 | | GET | `/song-list/:source[/:page]` | 歌单列表;`?sortId=` `?tagId=` 各平台词汇不同,省略时用平台默认 |
| GET | `/playlist/:source/:id[/:page]` | 歌单详情与曲目;`?limit=`。bl 支持合集/多分P | | GET | `/playlist/:source/:id[/:page]` | 歌单详情与曲目;`?limit=`。bili 支持合集/多分P |
| GET | `/playlist/:source/search/:keyword` | 歌单搜索(`?page=` `?limit=`) | | GET | `/playlist/:source/search/:keyword` | 歌单搜索(`?page=` `?limit=`) |
| GET | `/playlist/:source/categories` | 歌单分类列表 | | GET | `/playlist/:source/categories` | 歌单分类列表 |
| GET | `/playlist/:source/categories/:categoryId` | 分类下的歌单(`?page=` `?limit=`) | | GET | `/playlist/:source/categories/:categoryId` | 分类下的歌单(`?page=` `?limit=`) |
@@ -125,8 +125,8 @@
| DELETE | `/login/xm` · `/login/me` | 退出对应平台 | | DELETE | `/login/xm` · `/login/me` | 退出对应平台 |
| POST | `/login/lr` | 懒人听书账号登录(`account` + `password`) | | POST | `/login/lr` | 懒人听书账号登录(`account` + `password`) |
| DELETE | `/login/lr` | 退出懒人听书 | | DELETE | `/login/lr` | 退出懒人听书 |
| POST | `/login/bl/qr` → `/login/bl/qr/check` | 哔哩哔哩扫码(解锁大会员音质) | | POST | `/login/bili/qr` → `/login/bili/qr/check` | 哔哩哔哩扫码(解锁大会员音质) |
| DELETE | `/login/bl` | 退出哔哩哔哩 | | DELETE | `/login/bili` | 退出哔哩哔哩 |
| POST | `/login/refresh` | 手动触发登录态续期(kg/tx) | | POST | `/login/refresh` | 手动触发登录态续期(kg/tx) |
| GET | `/login/status` | 登录状态总览(各平台 `logged` 与账号资料) | | GET | `/login/status` | 登录状态总览(各平台 `logged` 与账号资料) |
+2 -2
View File
@@ -1,12 +1,12 @@
// 5sing(5sing.kugou.com,酷狗旗下原创/翻唱音乐平台)平台模块 // 5sing(5sing.kugou.com,酷狗旗下原创/翻唱音乐平台)平台模块
// 上游 music-lib/fivesing 移植(平台 id 统一为 '5s',上游 model.Source 为 "fivesing")。 // 上游 music-lib/fivesing 移植(平台 id 统一为 '5sing',上游 model.Source 为 "fivesing")。
// 能力:搜索(原创 yc / 翻唱 fc / 伴奏 bz,统一种类字段 songType)/ 取流(明文直链,档位 sq→hq→lq)/ // 能力:搜索(原创 yc / 翻唱 fc / 伴奏 bz,统一种类字段 songType)/ 取流(明文直链,档位 sq→hq→lq)/
// 歌词(newget.dynamicWords)/ 歌单(搜索、详情、链接解析)/ 单曲链接解析。 // 歌词(newget.dynamicWords)/ 歌单(搜索、详情、链接解析)/ 单曲链接解析。
// 不实现:专辑、封面(上游无 GetPic)、分类歌单/个人歌单(上游显式 not supported,保留抛错语义)、 // 不实现:专辑、封面(上游无 GetPic)、分类歌单/个人歌单(上游显式 not supported,保留抛错语义)、
// 榜单/热搜/歌手/评论(上游均无)。 // 榜单/热搜/歌手/评论(上游均无)。
// 取流入口在 sdk/apis/5sing.ts;songmid 约定 "<songId>|<songType>"(如 "932557|yc",与上游 ID 一致)。 // 取流入口在 sdk/apis/5sing.ts;songmid 约定 "<songId>|<songType>"(如 "932557|yc",与上游 ID 一致)。
// 登录:上游 New(cookie) 的 cookie 会随请求发送(付费/受限内容可能受益); // 登录:上游 New(cookie) 的 cookie 会随请求发送(付费/受限内容可能受益);
// 本移植从 sdk/auth/store.ts 的 getCredentials('5s') 读取 cookie(无则匿名,匿名实测可搜索/取流/歌词/歌单)。 // 本移植从 sdk/auth/store.ts 的 getCredentials('5sing') 读取 cookie(无则匿名,匿名实测可搜索/取流/歌词/歌单)。
import musicSearch from './musicSearch.ts' import musicSearch from './musicSearch.ts'
import lyric from './lyric.ts' import lyric from './lyric.ts'
+1 -1
View File
@@ -106,7 +106,7 @@ export const fetchSongInfo = async(songID: string, songType: string, register?:
link: buildSongLink(songType, songID), link: buildSongLink(songType, songID),
songType, songType,
typeName: kindName(songType), typeName: kindName(songType),
source: '5s' as const, source: '5sing' as const,
} }
} }
+4 -4
View File
@@ -9,7 +9,7 @@
import { formatPlayTime } from '../common/utils.ts' import { formatPlayTime } from '../common/utils.ts'
import { SEARCH_API, fetch5singJson, removeEmTags, unescapeHtml, buildSongLink, estimateDuration, kindName } from './util.ts' import { SEARCH_API, fetch5singJson, removeEmTags, unescapeHtml, buildSongLink, estimateDuration, kindName } from './util.ts'
/** 上游 Search 的 list 项 → 统一 Song 形状(source 统一 '5s') */ /** 上游 Search 的 list 项 → 统一 Song 形状(source 统一 '5sing') */
export const mapSearchSong = (item: any) => { export const mapSearchSong = (item: any) => {
const songType = String(item?.typeEname ?? '') const songType = String(item?.typeEname ?? '')
const duration = estimateDuration(Number(item?.songSize) || 0) const duration = estimateDuration(Number(item?.songSize) || 0)
@@ -29,7 +29,7 @@ export const mapSearchSong = (item: any) => {
typeName: String(item?.typeName ?? kindName(songType)), typeName: String(item?.typeName ?? kindName(songType)),
size: Number(item?.songSize) || 0, size: Number(item?.songSize) || 0,
link: buildSongLink(songType, item?.songId), link: buildSongLink(songType, item?.songId),
source: '5s' as const, source: '5sing' as const,
} }
} }
@@ -37,7 +37,7 @@ export const search = async(keyword: string, page = 1, limit = 20) => {
const word = String(keyword ?? '').trim() const word = String(keyword ?? '').trim()
const pageNo = Math.max(1, Number(page) || 1) const pageNo = Math.max(1, Number(page) || 1)
const pageSize = Math.max(1, Number(limit) || 20) const pageSize = Math.max(1, Number(limit) || 20)
const empty = { list: [] as any[], allPage: 0, total: 0, limit: pageSize, source: '5s' as const } const empty = { list: [] as any[], allPage: 0, total: 0, limit: pageSize, source: '5sing' as const }
if (!word) return empty if (!word) return empty
const url = `${SEARCH_API}?keyword=${encodeURIComponent(word)}&sort=1&page=${pageNo}&filter=0&type=0` const url = `${SEARCH_API}?keyword=${encodeURIComponent(word)}&sort=1&page=${pageNo}&filter=0&type=0`
@@ -50,7 +50,7 @@ export const search = async(keyword: string, page = 1, limit = 20) => {
const total = Number(pageInfo.totalCount) || list.length const total = Number(pageInfo.totalCount) || list.length
// 服务端每页 10 条(固定),allPage 直接用 pageInfo.totalPages // 服务端每页 10 条(固定),allPage 直接用 pageInfo.totalPages
const allPage = Number(pageInfo.totalPages) || (list.length >= pageSize ? pageNo + 1 : pageNo) const allPage = Number(pageInfo.totalPages) || (list.length >= pageSize ? pageNo + 1 : pageNo)
return { list, allPage, total, limit: pageSize, source: '5s' as const } return { list, allPage, total, limit: pageSize, source: '5sing' as const }
} }
export default { search } export default { search }
+7 -7
View File
@@ -32,7 +32,7 @@ const mapPlaylistSong = (songID: string, kind: string, name: string, artist: str
songType: kind, songType: kind,
typeName: kindName(kind), typeName: kindName(kind),
link: buildSongLink(kind, songID), link: buildSongLink(kind, songID),
source: '5s' as const, source: '5sing' as const,
}) })
/** /**
@@ -103,7 +103,7 @@ const mapPlaylistSummary = (item: any) => {
// 上游怪癖:content 为字符串 "0" 时视为空简介 // 上游怪癖:content 为字符串 "0" 时视为空简介
description: desc === '0' ? '' : desc, description: desc === '0' ? '' : desc,
link: buildPlaylistLink(userId, id), link: buildPlaylistLink(userId, id),
source: '5s' as const, source: '5sing' as const,
} }
} }
@@ -112,7 +112,7 @@ export const searchPlaylist = async(keyword: string, page = 1, limit = 20) => {
const word = String(keyword ?? '').trim() const word = String(keyword ?? '').trim()
const pageNo = Math.max(1, Number(page) || 1) const pageNo = Math.max(1, Number(page) || 1)
const pageSize = Math.max(1, Number(limit) || 20) const pageSize = Math.max(1, Number(limit) || 20)
const empty = { list: [] as any[], total: 0, page: pageNo, limit: pageSize, source: '5s' as const } const empty = { list: [] as any[], total: 0, page: pageNo, limit: pageSize, source: '5sing' as const }
if (!word) return empty if (!word) return empty
const url = `${SEARCH_API}?keyword=${encodeURIComponent(word)}&sort=1&page=${pageNo}&filter=0&type=1` const url = `${SEARCH_API}?keyword=${encodeURIComponent(word)}&sort=1&page=${pageNo}&filter=0&type=1`
@@ -132,7 +132,7 @@ export const searchPlaylist = async(keyword: string, page = 1, limit = 20) => {
} }
const total = Number(body?.pageInfo?.totalCount) || list.length const total = Number(body?.pageInfo?.totalCount) || list.length
return { list, total, page: pageNo, limit: pageSize, source: '5s' as const } return { list, total, page: pageNo, limit: pageSize, source: '5sing' as const }
} }
/** 元数据 + 全量曲目(上游 fetchPlaylistDetail 核心;HTML 不分页,一次拿全) */ /** 元数据 + 全量曲目(上游 fetchPlaylistDetail 核心;HTML 不分页,一次拿全) */
@@ -165,7 +165,7 @@ export const fetchPlaylistAll = async(playlistIdRaw: string) => {
description: String(data?.C ?? ''), description: String(data?.C ?? ''),
link: buildPlaylistLink(userId, playlistId), link: buildPlaylistLink(userId, playlistId),
userId, userId,
source: '5s' as const, source: '5sing' as const,
} }
// 2) 歌单页 HTML(数字 userId 会 302 → 个性域名页,fetch5sing 已跟跳) // 2) 歌单页 HTML(数字 userId 会 302 → 个性域名页,fetch5sing 已跟跳)
@@ -191,7 +191,7 @@ export const getPlaylistDetail = async(id: string, page = 1, limit = 50) => {
const list = songs.slice(start, start + pageSize) const list = songs.slice(start, start + pageSize)
const total = songs.length const total = songs.length
return { return {
source: '5s' as const, source: '5sing' as const,
info: { info: {
id: playlist.id, id: playlist.id,
name: playlist.name, name: playlist.name,
@@ -222,7 +222,7 @@ export const parsePlaylistLink = async(link: string) => {
if (!parsed) throw new Error('invalid 5sing playlist link') if (!parsed) throw new Error('invalid 5sing playlist link')
const { playlist, songs } = await fetchPlaylistAll(parsed.playlistId) const { playlist, songs } = await fetchPlaylistAll(parsed.playlistId)
return { return {
source: '5s' as const, source: '5sing' as const,
info: { info: {
id: playlist.id, id: playlist.id,
name: playlist.name, name: playlist.name,
+6 -6
View File
@@ -1,8 +1,8 @@
// 5sing 公共工具(上游 fivesing/fivesing.go 的 getFirstValid / removeEmTags 等移植) // 5sing 公共工具(上游 fivesing/fivesing.go 的 getFirstValid / removeEmTags 等移植)
// 平台 id 统一为 '5s'(上游包名 fivesing,Go 源码 model.Source 用 "fivesing"; // 平台 id 统一为 '5sing'(上游包名 fivesing,Go 源码 model.Source 用 "fivesing";
// 本仓库契约要求 id 为 5s,故所有对外 source 字段均为 '5s'。 // 本仓库契约要求 id 为 5sing,故所有对外 source 字段均为 '5sing'。
// 上游 New(cookie) 的 cookie 实际参与请求(搜索/getSongUrl/newget/歌单页), // 上游 New(cookie) 的 cookie 实际参与请求(搜索/getSongUrl/newget/歌单页),
// 这里按约定从 sdk/auth/store.ts 的 getCredentials('5s') 读取(无则匿名)。 // 这里按约定从 sdk/auth/store.ts 的 getCredentials('5sing') 读取(无则匿名)。
import { httpFetch } from '../common/request.ts' import { httpFetch } from '../common/request.ts'
import { getCredentials } from '../auth/store.ts' import { getCredentials } from '../auth/store.ts'
@@ -65,17 +65,17 @@ export const unescapeHtml = (s: any): string =>
}) })
/** 上游 New(cookie):cookie 仅在有值时随请求发送(匿名可用) */ /** 上游 New(cookie):cookie 仅在有值时随请求发送(匿名可用) */
export const get5singCookie = (): string => String((getCredentials('5s') as { cookie?: string } | null)?.cookie ?? '') export const get5singCookie = (): string => String((getCredentials('5sing') as { cookie?: string } | null)?.cookie ?? '')
/** 登录态(凭据存在性判断,与 me 平台 status 对齐) */ /** 登录态(凭据存在性判断,与 me 平台 status 对齐) */
export const getStatus = () => { export const getStatus = () => {
const cred = getCredentials('5s') as { cookie?: string, updatedAt?: string } | null const cred = getCredentials('5sing') as { cookie?: string, updatedAt?: string } | null
return cred?.cookie ? { logged: true, updatedAt: cred.updatedAt } : { logged: false } return cred?.cookie ? { logged: true, updatedAt: cred.updatedAt } : { logged: false }
} }
/** 是否显式声明了非本平台的 source(上游 GetLyrics/GetDownloadURL 的 source mismatch 检查) */ /** 是否显式声明了非本平台的 source(上游 GetLyrics/GetDownloadURL 的 source mismatch 检查) */
export const isForeignSource = (songInfo: any): boolean => export const isForeignSource = (songInfo: any): boolean =>
Boolean(songInfo?.source) && songInfo.source !== '5s' Boolean(songInfo?.source) && songInfo.source !== '5sing'
/** /**
* 带 Cookie/UA 的请求(上游 utils.Get + http.Client 自动跟跳的等价实现) * 带 Cookie/UA 的请求(上游 utils.Get + http.Client 自动跟跳的等价实现)
+1 -1
View File
@@ -3,7 +3,7 @@
// 完整曲目是 FairPlay DRM 加密流(extendedAssetUrls.enhancedHls),需要 gamdl 等外部工具解密, // 完整曲目是 FairPlay DRM 加密流(extendedAssetUrls.enhancedHls),需要 gamdl 等外部工具解密,
// 本 SDK 不提供。因此这里**任何请求档位都返回 type='preview'**,并在注释/响应里明确标注,不假装是无损完整曲。 // 本 SDK 不提供。因此这里**任何请求档位都返回 type='preview'**,并在注释/响应里明确标注,不假装是无损完整曲。
// 歌曲的 previews[0].url 来自 catalog 歌曲详情(搜索结果缓存里的 previewUrl 也会直接复用,同上游 s.URL 逻辑)。 // 歌曲的 previews[0].url 来自 catalog 歌曲详情(搜索结果缓存里的 previewUrl 也会直接复用,同上游 s.URL 逻辑)。
// 统一接口约定:apis('ap').getMusicUrl(songInfo, type) → { promise, cancelHttp } // 统一接口约定:apis('apple').getMusicUrl(songInfo, type) → { promise, cancelHttp }
// promise resolve → { type:'preview', url, ext:'m4a', preview:true, songDuration, isrc } // promise resolve → { type:'preview', url, ext:'m4a', preview:true, songDuration, isrc }
// (songDuration 是歌曲完整时长,试听片段本身约 30-90 秒) // (songDuration 是歌曲完整时长,试听片段本身约 30-90 秒)
// type 请求参数不影响结果(只有 preview 一档);supportQualitys 声明为 ['128k'] 以对齐 // type 请求参数不影响结果(只有 preview 一档);supportQualitys 声明为 ['128k'] 以对齐
+1 -1
View File
@@ -3,7 +3,7 @@
// - 免费曲目(搜索 isVip=0,如 SSR Beats 特辑)各档位均返回明文直链 data.path(audio0x.dmhmusic.com,CDN 签名 URL) // - 免费曲目(搜索 isVip=0,如 SSR Beats 特辑)各档位均返回明文直链 data.path(audio0x.dmhmusic.com,CDN 签名 URL)
// - VIP/版权曲目返回 200/errno 22000 但 data 无 path、无 trail_audio_info,需登录态带会员 cookie 才可能有直链 // - VIP/版权曲目返回 200/errno 22000 但 data 无 path、无 trail_audio_info,需登录态带会员 cookie 才可能有直链
// 契约:getMusicUrl(songInfo, type) → { promise, cancelHttp },promise resolve { type, url }(type 为实际命中档位) // 契约:getMusicUrl(songInfo, type) → { promise, cancelHttp },promise resolve { type, url }(type 为实际命中档位)
import { apiOk, firstNonEmpty, trackLink } from '../qian/util.ts' import { apiOk, firstNonEmpty, trackLink } from '../bd/util.ts'
// 请求档位 → tracklink rate 尝试链(优先请求档,逐级降级;与上游 3000→320→128→64 的探测顺序一致) // 请求档位 → tracklink rate 尝试链(优先请求档,逐级降级;与上游 3000→320→128→64 的探测顺序一致)
const QUALITY_RATES: Record<string, string[]> = { const QUALITY_RATES: Record<string, string[]> = {
+1 -1
View File
@@ -120,7 +120,7 @@ const followRedirects = async(url: string, cookie: string, tracker?: { current:
} }
/** /**
* 统一取流接口:apis('bl').getMusicUrl(songInfo, type) → { promise, cancelHttp } * 统一取流接口:apis('bili').getMusicUrl(songInfo, type) → { promise, cancelHttp }
* promise resolve → { type, url }(type 为实际命中档位,可能高于/低于请求档位) * promise resolve → { type, url }(type 为实际命中档位,可能高于/低于请求档位)
* songInfo.songmid 约定 `<bvid>|<cid>`;仅给 bvid 时回源 view 取首P cid。 * songInfo.songmid 约定 `<bvid>|<cid>`;仅给 bvid 时回源 view 取首P cid。
*/ */
+1 -1
View File
@@ -7,7 +7,7 @@
// wmid/session_key 会作为 uid/usk 参与签名(/login/joox 绑定后 VIP 曲目可取完整流)。 // wmid/session_key 会作为 uid/usk 参与签名(/login/joox 绑定后 VIP 曲目可取完整流)。
// 实测:游客态返回 128k MP3(免费完整曲目)或 VIP 曲目的 preview/refrain 片段; // 实测:游客态返回 128k MP3(免费完整曲目)或 VIP 曲目的 preview/refrain 片段;
// 未登录请求 VIP 曲目时 play_url_list 为试听片段——与上游行为一致(上游同样只能拿游客流)。 // 未登录请求 VIP 曲目时 play_url_list 为试听片段——与上游行为一致(上游同样只能拿游客流)。
// 统一接口约定:apis('jx').getMusicUrl(songInfo, type) → { promise, cancelHttp } // 统一接口约定:apis('joox').getMusicUrl(songInfo, type) → { promise, cancelHttp }
// promise resolve → { type, url }(type 为实际命中档位,可能低于请求值) // promise resolve → { type, url }(type 为实际命中档位,可能低于请求值)
import { httpFetch } from '../common/request.ts' import { httpFetch } from '../common/request.ts'
+1 -1
View File
@@ -6,7 +6,7 @@ import { httpFetch } from '../common/request.ts'
import { import {
AndroidChannel, AndroidUA, AndroidVersion, decryptZ3D, firstNonEmpty, AndroidChannel, AndroidUA, AndroidVersion, decryptZ3D, firstNonEmpty,
getMiguCookie, isMiguAudioMagic, miguFormatExt, TONE_QUALITY, type MiguSongItem, getMiguCookie, isMiguAudioMagic, miguFormatExt, TONE_QUALITY, type MiguSongItem,
} from '../migu/util.ts' } from '../mg/util.ts'
export const supportQualitys = ['64k', '128k', '320k', 'flac', 'flac24bit'] export const supportQualitys = ['64k', '128k', '320k', 'flac', 'flac24bit']
+2 -2
View File
@@ -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 if (!summary.trackCount || songs.length > summary.trackCount) summary.trackCount = songs.length
return { return {
source: 'ap' as const, source: 'apple' as const,
info: { info: {
id: albumId, id: albumId,
name: summary.name, name: summary.name,
@@ -64,7 +64,7 @@ export const getAlbumSongs = async(id: string): Promise<any[]> => {
export const parseAlbumLink = async(link: string) => { export const parseAlbumLink = async(link: string) => {
const detail = await getAlbumDetail(link, 1, 100000) const detail = await getAlbumDetail(link, 1, 100000)
return { return {
source: 'ap' as const, source: 'apple' as const,
id: detail.info.id, id: detail.info.id,
info: detail.info, info: detail.info,
list: detail.list, list: detail.list,
+4 -4
View File
@@ -1,8 +1,8 @@
// Apple Music 平台模块(上游 music-lib/apple/apple.go 的 Node/TS 移植,平台 id: ap) // Apple Music 平台模块(上游 music-lib/apple/apple.go 的 Node/TS 移植,平台 id: apple)
// 能力:搜索 / 歌词(TTML,匿名 developer token 通常拿不到,见 lyric.ts)/ 封面 / // 能力:搜索 / 歌词(TTML,匿名 developer token 通常拿不到,见 lyric.ts)/ 封面 /
// 专辑(搜索+详情+链接解析)/ 歌单(搜索+详情+分类+分类歌单+链接解析)/ // 专辑(搜索+详情+链接解析)/ 歌单(搜索+详情+分类+分类歌单+链接解析)/
// 链接解析(song/album/playlist)/ 取流(**仅 preview 试听片段**,见 sdk/apis/apple.ts)。 // 链接解析(song/album/playlist)/ 取流(**仅 preview 试听片段**,见 sdk/apis/apple.ts)。
// 凭据:上游 New(cookie) → getCredentials('ap'),cookie 形如 // 凭据:上游 New(cookie) → getCredentials('apple'),cookie 形如
// "media-user-token=xxx;storefront=cn;token=xxx",也支持 storefront/mediaUserToken/token 直填字段。 // "media-user-token=xxx;storefront=cn;token=xxx",也支持 storefront/mediaUserToken/token 直填字段。
// 未实现(上游也没有):userPlaylist、榜单、热搜、歌手、评论、扫码登录。 // 未实现(上游也没有):userPlaylist、榜单、热搜、歌手、评论、扫码登录。
import appleApi from '../apis/apple.ts' import appleApi from '../apis/apple.ts'
@@ -72,7 +72,7 @@ const apple = {
playlist, playlist,
// 契约别名:Apple 的歌单分类即 genre curators,挂到 songList 键供 /song-list/ap 复用 // 契约别名:Apple 的歌单分类即 genre curators,挂到 songList 键供 /song-list/apple 复用
songList: { songList: {
sortList: [{ name: '热门', id: '1526756058' }], sortList: [{ name: '热门', id: '1526756058' }],
getTags() { getTags() {
@@ -96,7 +96,7 @@ const apple = {
/** 登录状态(media-user-token 存在性判断;无在线校验接口) */ /** 登录状态(media-user-token 存在性判断;无在线校验接口) */
export const status = () => { export const status = () => {
const cred = getCredentials('ap') as any const cred = getCredentials('apple') as any
const cfg = getAppleConfig() const cfg = getAppleConfig()
return (cfg.mediaUserToken || cred?.cookie) return (cfg.mediaUserToken || cred?.cookie)
? { logged: true, updatedAt: cred?.updatedAt } ? { logged: true, updatedAt: cred?.updatedAt }
+3 -3
View File
@@ -39,7 +39,7 @@ export const search = async(keyword: string, page = 1, limit = 20) => {
allPage: hasNext ? p + 1 : p, allPage: hasNext ? p + 1 : p,
total: (p - 1) * l + list.length, total: (p - 1) * l + list.length,
limit: l, limit: l,
source: 'ap' as const, source: 'apple' as const,
} }
} }
@@ -53,7 +53,7 @@ export const searchAlbum = async(keyword: string, page = 1, limit = 20) => {
total: (p - 1) * l + list.length, total: (p - 1) * l + list.length,
page: p, page: p,
limit: l, limit: l,
source: 'ap' as const, source: 'apple' as const,
} }
} }
@@ -67,7 +67,7 @@ export const searchPlaylist = async(keyword: string, page = 1, limit = 20) => {
total: (p - 1) * l + list.length, total: (p - 1) * l + list.length,
page: p, page: p,
limit: l, limit: l,
source: 'ap' as const, source: 'apple' as const,
} }
} }
+5 -5
View File
@@ -53,8 +53,8 @@ export const appleCuratorCategories: Array<{ id: string, name: string }> = [
/** 上游 GetPlaylistCategories:静态返回 Apple Music genre curators */ /** 上游 GetPlaylistCategories:静态返回 Apple Music genre curators */
export const getCategories = async() => ({ export const getCategories = async() => ({
source: 'ap' as const, source: 'apple' as const,
list: appleCuratorCategories.map(item => ({ id: item.id, name: item.name, group: 'Apple Music 分类', source: 'ap' as const })), list: appleCuratorCategories.map(item => ({ id: item.id, name: item.name, group: 'Apple Music 分类', source: 'apple' as const })),
}) })
/** 上游 GetCategoryPlaylists:按 curator 分类取歌单(cn storefront,单请求上限 25,循环补齐) */ /** 上游 GetCategoryPlaylists:按 curator 分类取歌单(cn storefront,单请求上限 25,循环补齐) */
@@ -88,7 +88,7 @@ export const getCategoryPlaylists = async(categoryID: string, page = 1, limit =
} }
return { return {
source: 'ap' as const, source: 'apple' as const,
list: all.slice(0, l), list: all.slice(0, l),
page: p, page: p,
limit: l, 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 if (!summary.trackCount || songs.length > summary.trackCount) summary.trackCount = songs.length
return { return {
source: 'ap' as const, source: 'apple' as const,
info: { info: {
id: playlistId, id: playlistId,
name: summary.name, name: summary.name,
@@ -145,7 +145,7 @@ export const getPlaylistSongs = async(id: string): Promise<any[]> => {
export const parsePlaylistLink = async(link: string) => { export const parsePlaylistLink = async(link: string) => {
const detail = await getPlaylistDetail(link, 1, 100000) const detail = await getPlaylistDetail(link, 1, 100000)
return { return {
source: 'ap' as const, source: 'apple' as const,
id: detail.info.id, id: detail.info.id,
info: detail.info, info: detail.info,
list: detail.list, list: detail.list,
+5 -5
View File
@@ -1,6 +1,6 @@
// Apple Music(music.apple.com / amp-api.music.apple.com)公共工具 // Apple Music(music.apple.com / amp-api.music.apple.com)公共工具
// 上游 music-lib/apple/apple.go 的移植基础层: // 上游 music-lib/apple/apple.go 的移植基础层:
// - New(cookie) → getCredentials('ap'):cookie 支持 "media-user-token=xxx;storefront=cn;token=xxx" // - New(cookie) → getCredentials('apple'):cookie 支持 "media-user-token=xxx;storefront=cn;token=xxx"
// - fetchAppleToken():从 music.apple.com 首页 → index-legacy JS 抓 developer token(amp-api 的 Bearer) // - fetchAppleToken():从 music.apple.com 首页 → index-legacy JS 抓 developer token(amp-api 的 Bearer)
// 当前(2026-10)Apple 下发的 JWT 以 eyJ0eXAi({"typ":...})开头而非上游正则写的 eyJh, // 当前(2026-10)Apple 下发的 JWT 以 eyJ0eXAi({"typ":...})开头而非上游正则写的 eyJh,
// 故这里泛化为任意 JWT(eyJ…)并优先选择 issuer=AMPWebPlay 的 token;带回退与失效重取见 getAppleToken/invalidateAppleToken。 // 故这里泛化为任意 JWT(eyJ…)并优先选择 issuer=AMPWebPlay 的 token;带回退与失效重取见 getAppleToken/invalidateAppleToken。
@@ -42,7 +42,7 @@ export const parseCookieParts = (cookie: string): Record<string, string> => {
/** 读取 apple 平台运行时配置(对应上游 New(cookie)) */ /** 读取 apple 平台运行时配置(对应上游 New(cookie)) */
export const getAppleConfig = (): AppleRuntimeConfig => { export const getAppleConfig = (): AppleRuntimeConfig => {
const cred = (getCredentials('ap') as any) || {} const cred = (getCredentials('apple') as any) || {}
const parts = parseCookieParts(String(cred.cookie ?? '')) const parts = parseCookieParts(String(cred.cookie ?? ''))
const storefront = String(cred.storefront || parts.storefront || DEFAULT_STOREFRONT).trim() const storefront = String(cred.storefront || parts.storefront || DEFAULT_STOREFRONT).trim()
return { return {
@@ -297,7 +297,7 @@ export const appleSongFromCatalog = (res: any, defaultAlbumId = ''): any => {
lrc: null, lrc: null,
types: [], types: [],
_types: {}, _types: {},
source: 'ap' as const, source: 'apple' as const,
link: attr.url || '', // music.apple.com 网页地址 link: attr.url || '', // music.apple.com 网页地址
previewUrl: previewURL, // 30-90 秒试听片段直链(Apple 不提供完整曲目明文流) previewUrl: previewURL, // 30-90 秒试听片段直链(Apple 不提供完整曲目明文流)
duration: durationSec, duration: durationSec,
@@ -316,7 +316,7 @@ export const appleAlbumToPlaylist = (res: any): any => {
creator: attr.artistName || '', creator: attr.artistName || '',
description: attr.editorialNotes?.short || '', description: attr.editorialNotes?.short || '',
link: attr.url || '', link: attr.url || '',
source: 'ap' as const, source: 'apple' as const,
extra: { extra: {
release_date: attr.releaseDate || '', release_date: attr.releaseDate || '',
record_label: attr.recordLabel || '', record_label: attr.recordLabel || '',
@@ -340,7 +340,7 @@ export const applePlaylistToPlaylist = (res: any): any => {
creator: attr.curatorName || '', creator: attr.curatorName || '',
description, description,
link: attr.url || '', link: attr.url || '',
source: 'ap' as const, source: 'apple' as const,
} }
} }
File renamed without changes.
+4 -4
View File
@@ -7,7 +7,7 @@
// - 歌单关键词搜索(/v1/search?type=6)服务端已下线(errno 23001),searchPlaylist 返回空列表; // - 歌单关键词搜索(/v1/search?type=6)服务端已下线(errno 23001),searchPlaylist 返回空列表;
// - 上游 GetUserPlaylists 明确 Unsupported,本移植不提供 userPlaylist。 // - 上游 GetUserPlaylists 明确 Unsupported,本移植不提供 userPlaylist。
// 凭据:上游 New(cookie) 的 cookie 从 sdk/auth/store.ts 的 getCredentials('bd') 读取(可选)。 // 凭据:上游 New(cookie) 的 cookie 从 sdk/auth/store.ts 的 getCredentials('bd') 读取(可选)。
import qianApi from '../apis/qian.ts' import bdApi from '../apis/bd.ts'
import musicSearch from './musicSearch.ts' import musicSearch from './musicSearch.ts'
import lyric from './lyric.ts' import lyric from './lyric.ts'
import { getSongInfo } from './musicInfo.ts' import { getSongInfo } from './musicInfo.ts'
@@ -16,11 +16,11 @@ import playlist from './playlist.ts'
import parse from './parse.ts' import parse from './parse.ts'
import { getQianCookie } from './util.ts' import { getQianCookie } from './util.ts'
const qian = { const bd = {
musicSearch, musicSearch,
getMusicUrl(songInfo, type) { getMusicUrl(songInfo, type) {
return qianApi.getMusicUrl(songInfo, type) return bdApi.getMusicUrl(songInfo, type)
}, },
getLyric(songInfo) { getLyric(songInfo) {
@@ -83,4 +83,4 @@ export const status = () => {
return cookie ? { logged: true } : { logged: false } return cookie ? { logged: true } : { logged: false }
} }
export default qian export default bd
File renamed without changes.
File renamed without changes.
File renamed without changes.
+1 -1
View File
@@ -2,7 +2,7 @@
// 歌曲:music.91q.com/song/<TSID>(上游 Parse:取 song/info 后顺带取直链,失败不影响返回) // 歌曲:music.91q.com/song/<TSID>(上游 Parse:取 song/info 后顺带取直链,失败不影响返回)
// 专辑:music.91q.com/album/<P码> / ?albumAssetCode= / ?albumid= // 专辑:music.91q.com/album/<P码> / ?albumAssetCode= / ?albumid=
// 歌单:music.91q.com/songlist|tracklist|playlist/<id> / ?*id= / 裸歌单 id // 歌单:music.91q.com/songlist|tracklist|playlist/<id> / ?*id= / 裸歌单 id
import { getDownloadUrl } from '../apis/qian.ts' import { getDownloadUrl } from '../apis/bd.ts'
import { getSongInfo } from './musicInfo.ts' import { getSongInfo } from './musicInfo.ts'
import { parseAlbumLink } from './album.ts' import { parseAlbumLink } from './album.ts'
import { parsePlaylistLink } from './playlist.ts' import { parsePlaylistLink } from './playlist.ts'
File renamed without changes.
View File
File renamed without changes.
+1 -1
View File
@@ -1,4 +1,4 @@
// Bilibili(B站)平台模块 —— 上游 music-lib/bilibili 的移植(平台 id: bl) // Bilibili(B站)平台模块 —— 上游 music-lib/bilibili 的移植(平台 id: bili)
// 能力:搜索 / 取流(DASH,VIP 可出 FLAC/Hi-Res)/ 歌单(合集 ugc_season + 多分P稿件)/ // 能力:搜索 / 取流(DASH,VIP 可出 FLAC/Hi-Res)/ 歌单(合集 ugc_season + 多分P稿件)/
// 链接解析(BV/av、分P)/ 封面 / 扫码登录(sdk/bili/login.ts,凭据落 sdk/auth/store.ts) // 链接解析(BV/av、分P)/ 封面 / 扫码登录(sdk/bili/login.ts,凭据落 sdk/auth/store.ts)
// 不实现:专辑、歌词(上游即空实现)、榜单、热搜、歌手、评论、个人歌单、歌单分类(上游均未实现)。 // 不实现:专辑、歌词(上游即空实现)、榜单、热搜、歌手、评论、个人歌单、歌单分类(上游均未实现)。
+3 -3
View File
@@ -5,7 +5,7 @@
// 0 成功 / 86038 过期 / 86090 已扫码待确认 / 86101 未扫码 // 0 成功 / 86038 过期 / 86090 已扫码待确认 / 86101 未扫码
// 成功时登录态 Cookie 在 poll 响应的 Set-Cookie 与 data.url 的 crossDomain 查询串里(两处都收集)。 // 成功时登录态 Cookie 在 poll 响应的 Set-Cookie 与 data.url 的 crossDomain 查询串里(两处都收集)。
// 凭据落盘到 sdk/auth/store.ts 的 `bili` 记录(cookie / refreshToken / 账号资料),与 kg/wy 一致; // 凭据落盘到 sdk/auth/store.ts 的 `bili` 记录(cookie / refreshToken / 账号资料),与 kg/wy 一致;
// 上游 New(cookie) 的实例化语义由 getCredentials('bl') 承担(见 util.ts getCookie)。 // 上游 New(cookie) 的实例化语义由 getCredentials('bili') 承担(见 util.ts getCookie)。
// 状态码沿用本仓库约定:800 过期 / 801 等待扫码 / 802 已扫码待确认 / 803 登录成功。 // 状态码沿用本仓库约定:800 过期 / 801 等待扫码 / 802 已扫码待确认 / 803 登录成功。
import QRCode from 'qrcode' import QRCode from 'qrcode'
import { httpFetch } from '../common/request.ts' import { httpFetch } from '../common/request.ts'
@@ -125,7 +125,7 @@ export const checkQRLogin = async(key: string) => {
const cookie = cookieString(jar) const cookie = cookieString(jar)
if (!cookie) throw new Error('B站登录成功但未获取到 Cookie,请重试') if (!cookie) throw new Error('B站登录成功但未获取到 Cookie,请重试')
const profile = await fetchProfile(cookie) const profile = await fetchProfile(cookie)
setCredentials('bl', { setCredentials('bili', {
cookie, cookie,
refreshToken: String(data.refresh_token || ''), refreshToken: String(data.refresh_token || ''),
mid: profile.mid, mid: profile.mid,
@@ -148,7 +148,7 @@ export const checkQRLogin = async(key: string) => {
/** 当前登录态(凭据存在性 + 落盘时保存的账号资料) */ /** 当前登录态(凭据存在性 + 落盘时保存的账号资料) */
export const status = () => { export const status = () => {
const cred = getCredentials('bl') as any const cred = getCredentials('bili') as any
return cred?.cookie return cred?.cookie
? { ? {
logged: true, logged: true,
+1 -1
View File
@@ -1,6 +1,6 @@
// Bilibili 歌词(上游 bilibili/lyric.go 即空实现:GetLyrics 对 bilibili 源恒返回空字符串) // Bilibili 歌词(上游 bilibili/lyric.go 即空实现:GetLyrics 对 bilibili 源恒返回空字符串)
// B 站视频没有公开歌词接口(cc_subtitle 需登录且绝大多数视频没有),上游未实现,此处保持一致: // B 站视频没有公开歌词接口(cc_subtitle 需登录且绝大多数视频没有),上游未实现,此处保持一致:
// 返回统一结构 { lyric: '', tlyric: '' },让 /lyric/bl 有响应而不是 404。 // 返回统一结构 { lyric: '', tlyric: '' },让 /lyric/bili 有响应而不是 404。
export const getLyric = (_songInfo?: any, ..._rest: any[]) => { export const getLyric = (_songInfo?: any, ..._rest: any[]) => {
const requestObj = { const requestObj = {
promise: Promise.resolve({ lyric: '', tlyric: '' }), promise: Promise.resolve({ lyric: '', tlyric: '' }),
+1 -1
View File
@@ -50,7 +50,7 @@ export const search = async(keyword: string, page = 1, limit = 20) => {
allPage: numPages || p + (list.length >= l ? 1 : 0), allPage: numPages || p + (list.length >= l ? 1 : 0),
total, total,
limit: l, limit: l,
source: 'bl' as const, source: 'bili' as const,
} }
} }
+6 -6
View File
@@ -57,7 +57,7 @@ export const searchPlaylist = async(keyword: string, page = 1, limit = 20) => {
creator: view?.owner?.name || item.author || '', creator: view?.owner?.name || item.author || '',
description: season.intro || '', description: season.intro || '',
link: `https://www.bilibili.com/video/${item.bvid}`, link: `https://www.bilibili.com/video/${item.bvid}`,
source: 'bl' as const, source: 'bili' as const,
} }
} }
const pages: any[] = view?.pages ?? [] const pages: any[] = view?.pages ?? []
@@ -73,14 +73,14 @@ export const searchPlaylist = async(keyword: string, page = 1, limit = 20) => {
creator: view?.owner?.name || item.author || '', creator: view?.owner?.name || item.author || '',
description: '', description: '',
link: `https://www.bilibili.com/video/${item.bvid}`, link: `https://www.bilibili.com/video/${item.bvid}`,
source: 'bl' as const, source: 'bili' as const,
} }
} }
return null return null
}) })
const list = result.filter(Boolean) const list = result.filter(Boolean)
return { list, page: p, limit: l, total: list.length, source: 'bl' as const } return { list, page: p, limit: l, total: list.length, source: 'bili' as const }
} }
/** 由 bvid 构造歌单详情(上游 GetPlaylistSongs 的 bvid 分支 + ParsePlaylist 的元数据) */ /** 由 bvid 构造歌单详情(上游 GetPlaylistSongs 的 bvid 分支 + ParsePlaylist 的元数据) */
@@ -167,7 +167,7 @@ const pageSlice = (detail: { info: any, songs: any[] }, page: any, limit: any) =
const p = Math.max(1, Number(page) || 1) const p = Math.max(1, Number(page) || 1)
const l = Math.min(Math.max(1, Number(limit) || 100), 10000) const l = Math.min(Math.max(1, Number(limit) || 100), 10000)
return { return {
source: 'bl' as const, source: 'bili' as const,
info: detail.info, info: detail.info,
list: detail.songs.slice((p - 1) * l, p * l), list: detail.songs.slice((p - 1) * l, p * l),
page: p, page: p,
@@ -216,7 +216,7 @@ const parsePlaylistView = async(bvid: string, view: any) => {
let trackCount = countSeasonEpisodes(season.sections) let trackCount = countSeasonEpisodes(season.sections)
if (!trackCount) trackCount = detail.songs.length if (!trackCount) trackCount = detail.songs.length
return { return {
source: 'bl' as const, source: 'bili' as const,
id, id,
info: { ...detail.info, trackCount, playCount: Number(season?.stat?.view) || undefined }, info: { ...detail.info, trackCount, playCount: Number(season?.stat?.view) || undefined },
list: detail.songs, list: detail.songs,
@@ -227,7 +227,7 @@ const parsePlaylistView = async(bvid: string, view: any) => {
} }
const detail = await detailFromBvid(bvid) const detail = await detailFromBvid(bvid)
return { return {
source: 'bl' as const, source: 'bili' as const,
id: bvidKey(bvid), id: bvidKey(bvid),
info: { ...detail.info, trackCount: detail.songs.length }, info: { ...detail.info, trackCount: detail.songs.length },
list: detail.songs, list: detail.songs,
+2 -2
View File
@@ -25,7 +25,7 @@ export const biliHeaders = (cookie = ''): Record<string, string> => ({
}) })
/** 已保存的登录 Cookie(未登录返回空串) */ /** 已保存的登录 Cookie(未登录返回空串) */
export const getLoginCookie = (): string => String((getCredentials('bl') as any)?.cookie || '') export const getLoginCookie = (): string => String((getCredentials('bili') as any)?.cookie || '')
const cookieMapFromHeaders = (headers: any): Record<string, string> => { const cookieMapFromHeaders = (headers: any): Record<string, string> => {
const raw = headers?.['set-cookie'] const raw = headers?.['set-cookie']
@@ -147,7 +147,7 @@ export const makeSong = ({ bvid, cid, name, artist, album, duration, cover, page
lrc: null, lrc: null,
types: [] as any[], types: [] as any[],
_types: {} as Record<string, any>, _types: {} as Record<string, any>,
source: 'bl' as const, source: 'bili' as const,
bvid, bvid,
cid: String(cid ?? ''), cid: String(cid ?? ''),
page, page,
+16 -16
View File
@@ -7,8 +7,8 @@ import xm from './xm/index.ts'
import me from './me/index.ts' import me from './me/index.ts'
import qt from './qt/index.ts' import qt from './qt/index.ts'
import lr from './lr/index.ts' import lr from './lr/index.ts'
import migu from './migu/index.ts' import mg from './mg/index.ts'
import qian from './qian/index.ts' import bd from './bd/index.ts'
import joox from './joox/index.ts' import joox from './joox/index.ts'
import bili from './bili/index.ts' import bili from './bili/index.ts'
import fivesing from './5sing/index.ts' import fivesing from './5sing/index.ts'
@@ -22,8 +22,8 @@ import { supportQualitys as xmQualitys } from './apis/xm.ts'
import { supportQualitys as meQualitys } from './apis/me.ts' import { supportQualitys as meQualitys } from './apis/me.ts'
import { supportQualitys as qtQualitys } from './apis/qt.ts' import { supportQualitys as qtQualitys } from './apis/qt.ts'
import { supportQualitys as lrQualitys } from './apis/lr.ts' import { supportQualitys as lrQualitys } from './apis/lr.ts'
import { supportQualitys as miguQualitys } from './apis/migu.ts' import { supportQualitys as mgQualitys } from './apis/mg.ts'
import { supportQualitys as qianQualitys } from './apis/qian.ts' import { supportQualitys as bdQualitys } from './apis/bd.ts'
import { supportQualitys as jooxQualitys } from './apis/joox.ts' import { supportQualitys as jooxQualitys } from './apis/joox.ts'
import { supportQualitys as biliQualitys } from './apis/bili.ts' import { supportQualitys as biliQualitys } from './apis/bili.ts'
import { supportQualitys as fivesingQualitys } from './apis/5sing.ts' import { supportQualitys as fivesingQualitys } from './apis/5sing.ts'
@@ -53,13 +53,13 @@ const SUPPORTED_SOURCES: Array<{ id: string; name: string; module: PlatformModul
{ id: 'me', name: '猫耳FM', module: me, noAggregate: true }, { id: 'me', name: '猫耳FM', module: me, noAggregate: true },
{ id: 'qt', name: '蜻蜓FM', module: qt, noAggregate: true }, { id: 'qt', name: '蜻蜓FM', module: qt, noAggregate: true },
{ id: 'lr', name: '懒人听书', module: lr, noAggregate: true }, { id: 'lr', name: '懒人听书', module: lr, noAggregate: true },
{ id: 'mg', name: '咪咕音乐', module: migu }, { id: 'mg', name: '咪咕音乐', module: mg },
{ id: 'bd', name: '千千音乐', module: qian }, { id: 'bd', name: '千千音乐', module: bd },
{ id: 'jx', name: 'JOOX', module: joox }, { id: 'joox', name: 'JOOX', module: joox },
{ id: 'bl', name: '哔哩哔哩', module: bili }, { id: 'bili', name: '哔哩哔哩', module: bili },
{ id: '5s', name: '5sing', module: fivesing }, { id: '5sing', name: '5sing', module: fivesing },
// Apple Music 仅提供 preview 试听片段(完整曲为 DRM),不参与跨平台精确匹配 // Apple Music 仅提供 preview 试听片段(完整曲为 DRM),不参与跨平台精确匹配
{ id: 'ap', name: 'Apple Music', module: apple, noAggregate: true }, { id: 'apple', name: 'Apple Music', module: apple, noAggregate: true },
] ]
const SOURCE_MODULES = Object.fromEntries(SUPPORTED_SOURCES.map((s) => [s.id, s.module])) const SOURCE_MODULES = Object.fromEntries(SUPPORTED_SOURCES.map((s) => [s.id, s.module]))
@@ -81,12 +81,12 @@ export const supportQuality: Record<string, string[]> = {
me: meQualitys, me: meQualitys,
qt: qtQualitys, qt: qtQualitys,
lr: lrQualitys, lr: lrQualitys,
mg: miguQualitys, mg: mgQualitys,
bd: qianQualitys, bd: bdQualitys,
jx: jooxQualitys, joox: jooxQualitys,
bl: biliQualitys, bili: biliQualitys,
'5s': fivesingQualitys, '5sing': fivesingQualitys,
ap: appleQualitys, apple: appleQualitys,
} }
const trimStr = (str: unknown): string => (typeof str === 'string' ? str.trim() : str as string) const trimStr = (str: unknown): string => (typeof str === 'string' ? str.trim() : str as string)
+5 -5
View File
@@ -40,7 +40,7 @@ const fetchAlbumTracks = async(albumId: string, page: number, limit: number) =>
const total = firstNonZero(body?.tracks?.total_count, body?.tracks?.list_count, list.length) const total = firstNonZero(body?.tracks?.total_count, body?.tracks?.list_count, list.length)
return { return {
source: 'jx' as const, source: 'joox' as const,
info: { info: {
name: String(firstNonEmpty(body?.name, albumId)), name: String(firstNonEmpty(body?.name, albumId)),
img: pickJooxImage(body?.images) || null, img: pickJooxImage(body?.images) || null,
@@ -95,7 +95,7 @@ export const getAlbumDetailFromPage = async(rawId: string, page = 1, limit = 50)
const total = firstNonZero(albumData?.trackList?.total_count, albumData?.trackList?.list_count, items.length) const total = firstNonZero(albumData?.trackList?.total_count, albumData?.trackList?.list_count, items.length)
return { return {
source: 'jx' as const, source: 'joox' as const,
info: { info: {
name: String(firstNonEmpty(albumData?.title, albumId)), name: String(firstNonEmpty(albumData?.title, albumId)),
img: cover || null, img: cover || null,
@@ -120,7 +120,7 @@ export const searchAlbum = async(keyword: string, page = 1, limit = 20) => {
const url = `${SEARCH_URL}?country=sg&lang=zh_cn&keyword=${encodeURIComponent(String(keyword ?? ''))}` const url = `${SEARCH_URL}?country=sg&lang=zh_cn&keyword=${encodeURIComponent(String(keyword ?? ''))}`
const { statusCode, body } = await httpFetch(url, { headers: jooxHeaders(), timeout: 20000 }).promise as any const { statusCode, body } = await httpFetch(url, { headers: jooxHeaders(), timeout: 20000 }).promise as any
if (statusCode != 200 || !body?.section_list) { if (statusCode != 200 || !body?.section_list) {
return { list: [], total: 0, page, limit, source: 'jx' as const } return { list: [], total: 0, page, limit, source: 'joox' as const }
} }
const list: any[] = [] const list: any[] = []
@@ -142,12 +142,12 @@ export const searchAlbum = async(keyword: string, page = 1, limit = 20) => {
publishDate: String(album.publish_date ?? '').trim(), publishDate: String(album.publish_date ?? '').trim(),
trackCount: 0, trackCount: 0,
link: jooxAlbumLink(id), link: jooxAlbumLink(id),
source: 'jx' as const, source: 'joox' as const,
}) })
} }
} }
return { list: list.slice(0, limit), total: list.length, page, limit, source: 'jx' as const } return { list: list.slice(0, limit), total: list.length, page, limit, source: 'joox' as const }
} }
/** 专辑链接解析(上游 ParseAlbum) */ /** 专辑链接解析(上游 ParseAlbum) */
+3 -3
View File
@@ -7,7 +7,7 @@
// - 取流/歌曲详情/专辑曲目/歌单曲目:cache.api.joox.com/openjoox2/v1(需 md5 签名,见 util.jooxSign) // - 取流/歌曲详情/专辑曲目/歌单曲目:cache.api.joox.com/openjoox2/v1(需 md5 签名,见 util.jooxSign)
// - 歌词:api.joox.com/web-fcgi-bin/web_lyric(旧接口仍可用;失败回退 openjoox2 lrc_content) // - 歌词:api.joox.com/web-fcgi-bin/web_lyric(旧接口仍可用;失败回退 openjoox2 lrc_content)
// - 分类/歌单/专辑 SSR 兜底:www.joox.com __NEXT_DATA__ // - 分类/歌单/专辑 SSR 兜底:www.joox.com __NEXT_DATA__
// 上游 New(cookie):默认游客 Cookie 来自 joox.go 常量;/login/jx 绑定后从 sdk/auth/store.ts 读取, // 上游 New(cookie):默认游客 Cookie 来自 joox.go 常量;/login/joox 绑定后从 sdk/auth/store.ts 读取,
// 登录 cookie 的 wmid/session_key 会作为 uid/usk 参与 openjoox2 签名(VIP 完整曲目依赖它)。 // 登录 cookie 的 wmid/session_key 会作为 uid/usk 参与 openjoox2 签名(VIP 完整曲目依赖它)。
// userPlaylist:上游 joox/user_playlist.go 返回 ErrUserPlaylistsUnsupported,未实现(不造)。 // userPlaylist:上游 joox/user_playlist.go 返回 ErrUserPlaylistsUnsupported,未实现(不造)。
import jooxApi from '../apis/joox.ts' import jooxApi from '../apis/joox.ts'
@@ -35,7 +35,7 @@ const joox = {
album, album,
playlist, playlist,
// 契约别名:JOOX 的「分类/列表」能力即 playlist.go 的歌单分类,没有独立的 songList 接口, // 契约别名:JOOX 的「分类/列表」能力即 playlist.go 的歌单分类,没有独立的 songList 接口,
// 这里把同一套分类/分类歌单挂到 songList 键,便于 /song-list/jx 路由复用。 // 这里把同一套分类/分类歌单挂到 songList 键,便于 /song-list/joox 路由复用。
songList: { songList: {
sortList: [{ name: '全部', id: '' }], sortList: [{ name: '全部', id: '' }],
getTags() { getTags() {
@@ -53,7 +53,7 @@ const joox = {
/** 登录状态(凭据存在性判断;无在线校验接口) */ /** 登录状态(凭据存在性判断;无在线校验接口) */
export const status = () => { export const status = () => {
const cred = getCredentials('jx') as { cookie?: string, updatedAt?: string } | null const cred = getCredentials('joox') as { cookie?: string, updatedAt?: string } | null
return cred?.cookie return cred?.cookie
? { logged: true, updatedAt: cred.updatedAt } ? { logged: true, updatedAt: cred.updatedAt }
: { logged: false } : { logged: false }
+2 -2
View File
@@ -14,7 +14,7 @@ export const search = async(keyword: string, _page = 1, limit = 20) => {
const url = `${SEARCH_URL}?country=sg&lang=zh_cn&keyword=${encodeURIComponent(String(keyword ?? ''))}` const url = `${SEARCH_URL}?country=sg&lang=zh_cn&keyword=${encodeURIComponent(String(keyword ?? ''))}`
const { statusCode, body } = await httpFetch(url, { headers: jooxHeaders(), timeout: 20000 }).promise as any const { statusCode, body } = await httpFetch(url, { headers: jooxHeaders(), timeout: 20000 }).promise as any
if (statusCode != 200 || !body?.section_list) { if (statusCode != 200 || !body?.section_list) {
return { list: [], allPage: 0, total: 0, limit, source: 'jx' as const } return { list: [], allPage: 0, total: 0, limit, source: 'joox' as const }
} }
const list: any[] = [] const list: any[] = []
@@ -35,7 +35,7 @@ export const search = async(keyword: string, _page = 1, limit = 20) => {
allPage: 1, allPage: 1,
total: list.length, total: list.length,
limit, limit,
source: 'jx' as const, source: 'joox' as const,
} }
} }
+8 -8
View File
@@ -39,7 +39,7 @@ const mapPlaylistSummary = (item: any) => {
creator: '', creator: '',
description: '', description: '',
link: jooxPlaylistLink(id), link: jooxPlaylistLink(id),
source: 'jx' as const, source: 'joox' as const,
} }
} }
@@ -60,7 +60,7 @@ const fetchPlaylistTracks = async(playlistId: string, page: number, limit: numbe
const total = firstNonZero(body?.tracks?.total_count, body?.tracks?.list_count, body?.track_count, list.length) const total = firstNonZero(body?.tracks?.total_count, body?.tracks?.list_count, body?.track_count, list.length)
return { return {
source: 'jx' as const, source: 'joox' as const,
info: { info: {
name: String(firstNonEmpty(body?.name, playlistId)), name: String(firstNonEmpty(body?.name, playlistId)),
img: pickJooxImage(body?.images) || null, img: pickJooxImage(body?.images) || null,
@@ -136,7 +136,7 @@ export const getPlaylistDetailFromPage = async(rawId: string) => {
.filter(Boolean) .filter(Boolean)
if (!list.length) throw new Error('joox 歌单无歌曲') if (!list.length) throw new Error('joox 歌单无歌曲')
return { return {
source: 'jx' as const, source: 'joox' as const,
info: { info: {
name: String(parsed.name || pageId), name: String(parsed.name || pageId),
img: cover || null, img: cover || null,
@@ -185,7 +185,7 @@ export const searchPlaylist = async(keyword: string, page = 1, limit = 20) => {
const url = `${SEARCH_URL}?country=sg&lang=zh_cn&keyword=${encodeURIComponent(String(keyword ?? ''))}` const url = `${SEARCH_URL}?country=sg&lang=zh_cn&keyword=${encodeURIComponent(String(keyword ?? ''))}`
const { statusCode, body } = await httpFetch(url, { headers: jooxHeaders(), timeout: 20000 }).promise as any const { statusCode, body } = await httpFetch(url, { headers: jooxHeaders(), timeout: 20000 }).promise as any
if (statusCode != 200 || !body?.section_list) { if (statusCode != 200 || !body?.section_list) {
return { list: [], total: 0, page, limit, source: 'jx' as const } return { list: [], total: 0, page, limit, source: 'joox' as const }
} }
const list: any[] = [] const list: any[] = []
@@ -200,7 +200,7 @@ export const searchPlaylist = async(keyword: string, page = 1, limit = 20) => {
} }
} }
return { list: list.slice(0, limit), total: list.length, page, limit, source: 'jx' as const } return { list: list.slice(0, limit), total: list.length, page, limit, source: 'joox' as const }
} }
/** 歌单分类页原始数据(上游 fetchJooxPlaylistCategoriesPage) */ /** 歌单分类页原始数据(上游 fetchJooxPlaylistCategoriesPage) */
@@ -230,7 +230,7 @@ export const getCategories = async() => {
list.push({ id: String(index), name, group: 'JOOX', hot: false, count: items.length }) list.push({ id: String(index), name, group: 'JOOX', hot: false, count: items.length })
}) })
if (list.length === 1) throw new Error('joox 歌单分类不存在') if (list.length === 1) throw new Error('joox 歌单分类不存在')
return { source: 'jx' as const, list } return { source: 'joox' as const, list }
} }
/** 分类下歌单(上游 GetCategoryPlaylists) */ /** 分类下歌单(上游 GetCategoryPlaylists) */
@@ -282,13 +282,13 @@ export const getCategoryPlaylists = async(categoryId = '', page = 1, limit = 20)
link: jooxPlaylistLink(id), link: jooxPlaylistLink(id),
categoryId: cid, categoryId: cid,
categoryName, categoryName,
source: 'jx' as const, source: 'joox' as const,
} }
}) })
.filter(Boolean) .filter(Boolean)
if (!list.length) throw new Error('joox 分类下无歌单') if (!list.length) throw new Error('joox 分类下无歌单')
return { list, total: items.length, page, limit, source: 'jx' as const } return { list, total: items.length, page, limit, source: 'joox' as const }
} }
/** 歌单链接解析(上游 ParsePlaylist) */ /** 歌单链接解析(上游 ParsePlaylist) */
+2 -2
View File
@@ -45,7 +45,7 @@ export const jooxSongFromTrack = (
vip: Number(item?.vip_flag ?? 0) === 1, vip: Number(item?.vip_flag ?? 0) === 1,
types: [], types: [],
_types: {}, _types: {},
source: 'jx' as const, source: 'joox' as const,
} }
} }
@@ -65,7 +65,7 @@ export const jooxSongFromDetail = (detail: any, playUrl = ''): any => {
lrc: null, lrc: null,
types: [], types: [],
_types: {}, _types: {},
source: 'jx' as const, source: 'joox' as const,
} }
if (playUrl) song.url = playUrl if (playUrl) song.url = playUrl
song.vip = Number(detail?.vip_flag ?? 0) === 1 song.vip = Number(detail?.vip_flag ?? 0) === 1
+1 -1
View File
@@ -33,7 +33,7 @@ export const jooxSign = (params: Record<string, any>): string =>
/** 绑定到 sdk/auth/store.ts 的登录 cookie(未登录返回空串,不回退游客 cookie) */ /** 绑定到 sdk/auth/store.ts 的登录 cookie(未登录返回空串,不回退游客 cookie) */
export const jooxLoginCookie = (): string => { export const jooxLoginCookie = (): string => {
const cred = getCredentials('jx') as { cookie?: string } | null const cred = getCredentials('joox') as { cookie?: string } | null
return cred?.cookie || '' return cred?.cookie || ''
} }
File renamed without changes.
+4 -4
View File
@@ -2,17 +2,17 @@
// 上游对应:music-lib/migu/(migu.go、song.go、lyric.go、album.go、playlist.go、download.go) // 上游对应:music-lib/migu/(migu.go、song.go、lyric.go、album.go、playlist.go、download.go)
// 匿名面(2026-10-02 实测):搜索、PQ(128k mp3) 取流、歌词、封面、专辑曲目、歌单曲目均可用; // 匿名面(2026-10-02 实测):搜索、PQ(128k mp3) 取流、歌词、封面、专辑曲目、歌单曲目均可用;
// HQ/SQ/ZQ 各档需登录 Cookie(接口返回「登录后免费试听」)。 // HQ/SQ/ZQ 各档需登录 Cookie(接口返回「登录后免费试听」)。
import miguApi from '../apis/migu.ts' import mgApi from '../apis/mg.ts'
import musicSearch from './musicSearch.ts' import musicSearch from './musicSearch.ts'
import lyric, { contentIdOf } from './lyric.ts' import lyric, { contentIdOf } from './lyric.ts'
import album from './album.ts' import album from './album.ts'
import playlist from './playlist.ts' import playlist from './playlist.ts'
import { fetchSongDetail, miguSongLink } from './util.ts' import { fetchSongDetail, miguSongLink } from './util.ts'
const migu = { const mg = {
musicSearch, musicSearch,
getMusicUrl(songInfo: any, type: string) { getMusicUrl(songInfo: any, type: string) {
return miguApi.getMusicUrl(songInfo, type) return mgApi.getMusicUrl(songInfo, type)
}, },
getLyric(songInfo: any) { getLyric(songInfo: any) {
return lyric.getLyric(songInfo) return lyric.getLyric(songInfo)
@@ -60,4 +60,4 @@ export const parseSong = async(link: string) => {
return song return song
} }
export default migu export default mg
File renamed without changes.
File renamed without changes.
File renamed without changes.
View File
File renamed without changes.
+1 -1
View File
@@ -4,7 +4,7 @@
/** 音乐平台标识 */ /** 音乐平台标识 */
export type Source = export type Source =
| 'kw' | 'kg' | 'tx' | 'wy' | 'qs' | 'kw' | 'kg' | 'tx' | 'wy' | 'qs'
| 'mg' | 'bd' | 'jx' | 'bl' | '5s' | 'ap' | 'mg' | 'bd' | 'joox' | 'bili' | '5sing' | 'apple'
| 'xm' | 'me' | 'qt' | 'lr' | 'xm' | 'me' | 'qt' | 'lr'
/** 音质标识(wav 仅部分接口声明使用) */ /** 音质标识(wav 仅部分接口声明使用) */
File renamed without changes.
+13 -13
View File
@@ -8,7 +8,7 @@ import * as qsPassport from '../sdk/qs/passport.ts'
import * as biliAuth from '../sdk/bili/login.ts' import * as biliAuth from '../sdk/bili/login.ts'
import { status as xmStatus } from '../sdk/xm/index.ts' import { status as xmStatus } from '../sdk/xm/index.ts'
import { status as meStatus } from '../sdk/me/index.ts' import { status as meStatus } from '../sdk/me/index.ts'
import { status as qianStatus } from '../sdk/qian/index.ts' import { status as bdStatus } from '../sdk/bd/index.ts'
import { status as jooxStatus } from '../sdk/joox/index.ts' import { status as jooxStatus } from '../sdk/joox/index.ts'
import { status as appleStatus } from '../sdk/apple/index.ts' import { status as appleStatus } from '../sdk/apple/index.ts'
import { status as fivesingStatus } from '../sdk/5sing/index.ts' import { status as fivesingStatus } from '../sdk/5sing/index.ts'
@@ -425,10 +425,10 @@ export const loginRoutes = async(fastify) => {
// ---------- 哔哩哔哩 ---------- // ---------- 哔哩哔哩 ----------
fastify.post('/login/bl/qr', { fastify.post('/login/bili/qr', {
schema: { schema: {
summary: '获取哔哩哔哩扫码登录二维码', summary: '获取哔哩哔哩扫码登录二维码',
description: '用 B站 App 扫码后轮询 /login/bl/qr/check 完成登录。返回 key 需原样回传,qrimg 为 data URL 可直接展示。', description: '用 B站 App 扫码后轮询 /login/bili/qr/check 完成登录。返回 key 需原样回传,qrimg 为 data URL 可直接展示。',
tags: ['登录'], tags: ['登录'],
}, },
}, async(_request, reply) => { }, async(_request, reply) => {
@@ -439,7 +439,7 @@ export const loginRoutes = async(fastify) => {
} }
}) })
fastify.post('/login/bl/qr/check', { fastify.post('/login/bili/qr/check', {
schema: { schema: {
summary: '轮询哔哩哔哩扫码状态', summary: '轮询哔哩哔哩扫码状态',
description: 'status:waiting 等待扫码 / scanned 已扫码待确认 / success 登录成功(自动保存凭据并返回账号资料)' + description: 'status:waiting 等待扫码 / scanned 已扫码待确认 / success 登录成功(自动保存凭据并返回账号资料)' +
@@ -455,10 +455,10 @@ export const loginRoutes = async(fastify) => {
} }
}) })
fastify.delete('/login/bl', { fastify.delete('/login/bili', {
schema: { summary: '退出哔哩哔哩登录', tags: ['登录'] }, schema: { summary: '退出哔哩哔哩登录', tags: ['登录'] },
}, async() => { }, async() => {
clearCredentials('bl') clearCredentials('bili')
return { logged: false } return { logged: false }
}) })
@@ -476,8 +476,8 @@ export const loginRoutes = async(fastify) => {
fastify.get('/login/status', { fastify.get('/login/status', {
schema: { schema: {
summary: '查看登录状态', summary: '查看登录状态',
description: 'wy 为实时校验(未登录或 cookie 失效返回 logged: false),kg/tx/bl 为已存凭据(含 VIP 等级与最近更新时间),' + description: 'wy 为实时校验(未登录或 cookie 失效返回 logged: false),kg/tx/bili 为已存凭据(含 VIP 等级与最近更新时间),' +
'qs/xm/me/lr/bd/jx/ap/5s 为已存凭据。', 'qs/xm/me/lr/bd/joox/apple/5sing 为已存凭据。',
tags: ['登录'], tags: ['登录'],
}, },
}, async() => { }, async() => {
@@ -493,11 +493,11 @@ export const loginRoutes = async(fastify) => {
xm: xmStatus(), xm: xmStatus(),
me: meStatus(), me: meStatus(),
lr: lrAuth.status(), lr: lrAuth.status(),
bl: biliAuth.status(), bili: biliAuth.status(),
bd: qianStatus(), bd: bdStatus(),
jx: jooxStatus(), joox: jooxStatus(),
ap: appleStatus(), apple: appleStatus(),
'5s': fivesingStatus(), '5sing': fivesingStatus(),
} }
}) })
} }
+11 -11
View File
@@ -5,7 +5,7 @@
import { notFound, upstream } from './http/api-error.ts' import { notFound, upstream } from './http/api-error.ts'
import { signStream } from './http/stream-sign.ts' import { signStream } from './http/stream-sign.ts'
import { registerMiguStream, takeMiguStream } from './http/migu-stream.ts' import { registerMiguStream, takeMiguStream } from './http/mg-stream.ts'
import { getMusicInfo } from '../sdk/kg/musicInfo.ts' import { getMusicInfo } from '../sdk/kg/musicInfo.ts'
const QUALITIES = ['64k', '128k', '320k', 'flac', 'flac24bit'] const QUALITIES = ['64k', '128k', '320k', 'flac', 'flac24bit']
@@ -300,8 +300,8 @@ export const musicRoutes = async(fastify: any) => {
if (!ticket) throw notFound('解密票据不存在或已过期(请重新调用 /url/mg 取流)') if (!ticket) throw notFound('解密票据不存在或已过期(请重新调用 /url/mg 取流)')
// 流式下载 + 逐块解密:咪咕 Z3D 密钥流按 32 字节循环,块内保持全局偏移即可, // 流式下载 + 逐块解密:咪咕 Z3D 密钥流按 32 字节循环,块内保持全局偏移即可,
// 避免把上百 MB 的 wav/flac 整段读进内存(httpFetch 有 64MB 缓冲上限) // 避免把上百 MB 的 wav/flac 整段读进内存(httpFetch 有 64MB 缓冲上限)
const { miguZ3DStreamKey, isMiguAudioMagic } = await import('../sdk/migu/util.ts') const { miguZ3DStreamKey, isMiguAudioMagic } = await import('../sdk/mg/util.ts')
const { pipeDecryptedMiguStream, miguStreamContentType } = await import('./http/migu-stream.ts') const { pipeDecryptedMiguStream, miguStreamContentType } = await import('./http/mg-stream.ts')
const streamKey = miguZ3DStreamKey(ticket.fileKey) const streamKey = miguZ3DStreamKey(ticket.fileKey)
reply.raw.writeHead(200, { reply.raw.writeHead(200, {
'Content-Type': miguStreamContentType(ticket.url), 'Content-Type': miguStreamContentType(ticket.url),
@@ -513,7 +513,7 @@ export const musicRoutes = async(fastify: any) => {
const albumSchema = (withPage: boolean) => ({ const albumSchema = (withPage: boolean) => ({
summary: '获取专辑详情与曲目列表', summary: '获取专辑详情与曲目列表',
description: '支持 kg/kw/tx/wy/xm/me/qt/lr/mg/bd/jx/ap(见 /sources 的 album 能力位)。' + description: '支持 kg/kw/tx/wy/xm/me/qt/lr/mg/bd/joox/apple(见 /sources 的 album 能力位)。' +
'kw 单页固定 1000 条、xm/me 固定 30 条、limit 不生效。', 'kw 单页固定 1000 条、xm/me 固定 30 条、limit 不生效。',
tags: ['歌手专辑'], tags: ['歌手专辑'],
params: params({ params: params({
@@ -538,7 +538,7 @@ export const musicRoutes = async(fastify: any) => {
fastify.get('/album/:source/search/:keyword', { fastify.get('/album/:source/search/:keyword', {
schema: { schema: {
summary: '搜索专辑', summary: '搜索专辑',
description: '支持 kg/kw/tx/wy/mg/bd/jx/ap(见 /sources 的 albumSearch 能力位)。', description: '支持 kg/kw/tx/wy/mg/bd/joox/apple(见 /sources 的 albumSearch 能力位)。',
tags: ['歌手专辑'], tags: ['歌手专辑'],
params: params({ source: pSource('album.searchAlbum'), keyword: { type: 'string', description: '专辑名关键词', example: '魔杰座' } }), params: params({ source: pSource('album.searchAlbum'), keyword: { type: 'string', description: '专辑名关键词', example: '魔杰座' } }),
querystring: qs({ page: pPage, limit: pLimit }), querystring: qs({ page: pPage, limit: pLimit }),
@@ -563,8 +563,8 @@ export const musicRoutes = async(fastify: any) => {
fastify.get('/playlist/:source/search/:keyword', { fastify.get('/playlist/:source/search/:keyword', {
schema: { schema: {
summary: '搜索歌单', summary: '搜索歌单',
description: '支持 kg/kw/tx/wy/mg/bd/jx/bl/5s/ap(见 /sources 的 playlistSearch 能力位)。' + description: '支持 kg/kw/tx/wy/mg/bd/joox/bili/5sing/apple(见 /sources 的 playlistSearch 能力位)。' +
'部分平台该能力受限(如 bd 歌单搜索接口已下线、bl 需登录),失败时返回 502。', '部分平台该能力受限(如 bd 歌单搜索接口已下线、bili 需登录),失败时返回 502。',
tags: ['歌单'], tags: ['歌单'],
params: params({ source: pSource('playlist.searchPlaylist'), keyword: { type: 'string', example: '华语' } }), params: params({ source: pSource('playlist.searchPlaylist'), keyword: { type: 'string', example: '华语' } }),
querystring: qs({ page: pPage, limit: pLimit }), querystring: qs({ page: pPage, limit: pLimit }),
@@ -586,7 +586,7 @@ export const musicRoutes = async(fastify: any) => {
fastify.get('/playlist/:source/categories', { fastify.get('/playlist/:source/categories', {
schema: { schema: {
summary: '获取歌单分类', summary: '获取歌单分类',
description: '支持 kw/kg/tx/wy/mg/bd/jx/bl/5s/ap(见 /sources 的 playlistCategories 能力位)。', description: '支持 kw/kg/tx/wy/mg/bd/joox/bili/5sing/apple(见 /sources 的 playlistCategories 能力位)。',
tags: ['歌单'], tags: ['歌单'],
params: params({ source: pSource('playlist.getCategories') }), params: params({ source: pSource('playlist.getCategories') }),
response: responses('PlaylistCategoriesResult'), response: responses('PlaylistCategoriesResult'),
@@ -630,8 +630,8 @@ export const musicRoutes = async(fastify: any) => {
const playlistSchema = (withPage: boolean) => ({ const playlistSchema = (withPage: boolean) => ({
summary: '获取歌单详情与曲目列表', summary: '获取歌单详情与曲目列表',
description: 'id 为歌单 id 或链接(部分平台支持链接/裸 id,如 bl 的 season:<id>:<mid>:<bvid>、' + description: 'id 为歌单 id 或链接(部分平台支持链接/裸 id,如 bili 的 season:<id>:<mid>:<bvid>、' +
'jx/bd/mg 的网页链接)。列表按 page/limit 切片(聚合接口自身分页的平台由平台决定)。', 'joox/bd/mg 的网页链接)。列表按 page/limit 切片(聚合接口自身分页的平台由平台决定)。',
tags: ['歌单'], tags: ['歌单'],
params: params({ params: params({
source: pSource('playlist'), source: pSource('playlist'),
@@ -701,7 +701,7 @@ export const musicRoutes = async(fastify: any) => {
schema: { schema: {
summary: `解析${kind === 'song' ? '歌曲' : kind === 'album' ? '专辑' : '歌单'}链接`, summary: `解析${kind === 'song' ? '歌曲' : kind === 'album' ? '专辑' : '歌单'}链接`,
description: '把平台链接(或裸 id)解析成结构化歌曲/曲目数据。支持平台见 /sources 的 parse 能力位;' + description: '把平台链接(或裸 id)解析成结构化歌曲/曲目数据。支持平台见 /sources 的 parse 能力位;' +
'5s 歌曲/歌单、apple/bl/jx/bd/mg 三类、kw/kg/tx/wy 部分支持。', '5sing 歌曲/歌单、apple/bili/joox/bd/mg 三类、kw/kg/tx/wy 部分支持。',
tags: ['链接解析'], tags: ['链接解析'],
params: params({ source: pSource('parse.parseSong') }), params: params({ source: pSource('parse.parseSong') }),
body: parseBodySchema, body: parseBodySchema,
+1 -1
View File
@@ -49,7 +49,7 @@ const DOCS_PREFIX = '/docs'
const API_TITLE = 'MusicServer 聚合音乐 API' const API_TITLE = 'MusicServer 聚合音乐 API'
const API_DESCRIPTION = '多平台音乐聚合接口:搜索、播放地址、歌词、封面、榜单、歌单、专辑、歌手、链接解析。' + const API_DESCRIPTION = '多平台音乐聚合接口:搜索、播放地址、歌词、封面、榜单、歌单、专辑、歌手、链接解析。' +
'支持 kw(酷我)/ kg(酷狗)/ tx(QQ音乐)/ wy(网易云)/ qs(汽水音乐)/ mg(咪咕)/ bd(千千)/ ' + '支持 kw(酷我)/ kg(酷狗)/ tx(QQ音乐)/ wy(网易云)/ qs(汽水音乐)/ mg(咪咕)/ bd(千千)/ ' +
'jx / bl(哔哩哔哩)/ 5s / ap(Apple Music,仅试听)与有声平台 xm(喜马拉雅)/ me(猫耳FM)/ qt(蜻蜓FM)/ lr(懒人听书)。' 'joox / bili(哔哩哔哩)/ 5sing / apple(Apple Music,仅试听)与有声平台 xm(喜马拉雅)/ me(猫耳FM)/ qt(蜻蜓FM)/ lr(懒人听书)。'
const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '../package.json'), 'utf8')) const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '../package.json'), 'utf8'))
+22 -22
View File
@@ -514,11 +514,11 @@ await test('专辑详情 /album/lr', async() => {
return `${r.data.info.total} 节` return `${r.data.info.total} 节`
}) })
// ---- 新平台(migu/bd/jx/bl/5s/ap 移植回归) ---- // ---- 新平台(mg/bd/joox/bili/5sing/apple 移植回归) ----
for (const source of ['mg', 'bd', 'jx', 'bl', '5s', 'ap']) { for (const source of ['mg', 'bd', 'joox', 'bili', '5sing', 'apple']) {
await test(`搜索 ${source} 直查`, async() => { await test(`搜索 ${source} 直查`, async() => {
const r = await get(`/search/${source}/${encodeURIComponent(source === '5s' ? '董贞' : '周杰伦')}?limit=5`) const r = await get(`/search/${source}/${encodeURIComponent(source === '5sing' ? '董贞' : '周杰伦')}?limit=5`)
if (r.code != 0) throw new Error(r.msg) if (r.code != 0) throw new Error(r.msg)
if (!r.data?.list?.length) throw new Error('空列表') if (!r.data?.list?.length) throw new Error('空列表')
return `${r.data.list.length} 条,首条 ${r.data.list[0].name}` return `${r.data.list.length} 条,首条 ${r.data.list[0].name}`
@@ -547,10 +547,10 @@ await test('URL bd 免费曲', async() => {
return `实际 ${u.data.type},${String(u.data.url).slice(0, 60)}` return `实际 ${u.data.type},${String(u.data.url).slice(0, 60)}`
}) })
await test('URL 5s(档位 sq/hq/lq)', async() => { await test('URL 5sing(档位 sq/hq/lq)', async() => {
const r = await get(`/search/5s/${encodeURIComponent('董贞')}?limit=5`) const r = await get(`/search/5sing/${encodeURIComponent('董贞')}?limit=5`)
if (r.code != 0 || !r.data?.list?.length) throw new Error('搜索失败,无法取流') if (r.code != 0 || !r.data?.list?.length) throw new Error('搜索失败,无法取流')
const u = await get(`/url/5s/${encodeURIComponent(r.data.list[0].songmid)}?quality=128k`) const u = await get(`/url/5sing/${encodeURIComponent(r.data.list[0].songmid)}?quality=128k`)
if (u.code != 0) throw new Error(u.msg) if (u.code != 0) throw new Error(u.msg)
return `实际 ${u.data.type},${String(u.data.url).slice(0, 60)}` return `实际 ${u.data.type},${String(u.data.url).slice(0, 60)}`
}) })
@@ -565,11 +565,11 @@ await test('歌词 mg', async() => {
return l.data.lyric.slice(0, 40) return l.data.lyric.slice(0, 40)
}) })
await test('歌词 5s', async() => { await test('歌词 5sing', async() => {
const r = await get(`/search/5s/${encodeURIComponent('董贞')}?limit=5`) const r = await get(`/search/5sing/${encodeURIComponent('董贞')}?limit=5`)
const song = r.data?.list?.[0] const song = r.data?.list?.[0]
if (!song) throw new Error('搜索失败') if (!song) throw new Error('搜索失败')
const l = await get(`/lyric/5s/${encodeURIComponent(song.songmid)}`) const l = await get(`/lyric/5sing/${encodeURIComponent(song.songmid)}`)
if (l.code != 0) throw new Error(l.msg) if (l.code != 0) throw new Error(l.msg)
if (!l.data?.lyric) throw new Error('空歌词') if (!l.data?.lyric) throw new Error('空歌词')
return l.data.lyric.slice(0, 40) return l.data.lyric.slice(0, 40)
@@ -585,7 +585,7 @@ await test('封面 mg', async() => {
return String(p.data.url).slice(0, 60) return String(p.data.url).slice(0, 60)
}) })
for (const source of ['mg', 'bd', 'jx', 'ap']) { for (const source of ['mg', 'bd', 'joox', 'apple']) {
await test(`专辑搜索 /album/${source}/search`, async() => { await test(`专辑搜索 /album/${source}/search`, async() => {
const r = await get(`/album/${source}/search/${encodeURIComponent('Hello')}?limit=3`) const r = await get(`/album/${source}/search/${encodeURIComponent('Hello')}?limit=3`)
if (r.code != 0) throw new Error(r.msg) if (r.code != 0) throw new Error(r.msg)
@@ -604,7 +604,7 @@ await test('专辑详情 /album/mg', async() => {
return `${a.data.info.name}(${a.data.total} 首)` return `${a.data.info.name}(${a.data.total} 首)`
}) })
for (const source of ['mg', 'bd', 'jx', 'ap']) { for (const source of ['mg', 'bd', 'joox', 'apple']) {
await test(`歌单分类 /playlist/${source}/categories`, async() => { await test(`歌单分类 /playlist/${source}/categories`, async() => {
const r = await get(`/playlist/${source}/categories`) const r = await get(`/playlist/${source}/categories`)
if (r.code != 0) throw new Error(r.msg) if (r.code != 0) throw new Error(r.msg)
@@ -635,11 +635,11 @@ await test('歌单详情 /playlist/mg', async() => {
return `${d.data.total} 首,本页 ${d.data.list.length} 首` return `${d.data.total} 首,本页 ${d.data.list.length} 首`
}) })
await test('歌单详情 /playlist/bl(合集)', async() => { await test('歌单详情 /playlist/bili(合集)', async() => {
const s = await get(`/playlist/bl/search/${encodeURIComponent('周杰伦')}?limit=3`) const s = await get(`/playlist/bili/search/${encodeURIComponent('周杰伦')}?limit=3`)
const id = s.data?.list?.[0]?.id const id = s.data?.list?.[0]?.id
if (!id) throw new Error('搜索无歌单') if (!id) throw new Error('搜索无歌单')
const d = await get(`/playlist/bl/${encodeURIComponent(id)}?limit=5`) const d = await get(`/playlist/bili/${encodeURIComponent(id)}?limit=5`)
if (d.code != 0) throw new Error(d.msg) if (d.code != 0) throw new Error(d.msg)
if (!d.data?.list?.length) throw new Error('歌单无曲目') if (!d.data?.list?.length) throw new Error('歌单无曲目')
return `${d.data.total} 首` return `${d.data.total} 首`
@@ -659,8 +659,8 @@ await test('链接解析 /parse/playlist/bd', async() => {
return `${r.body.data.playlist?.name ?? ''}(${r.body.data.total} 首)` return `${r.body.data.playlist?.name ?? ''}(${r.body.data.total} 首)`
}) })
await test('链接解析 /parse/album/ap', async() => { await test('链接解析 /parse/album/apple', async() => {
const r = await postJson('/parse/album/ap', { link: 'https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249' }) const r = await postJson('/parse/album/apple', { 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.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('无曲目') if (!r.body.data?.list?.length) throw new Error('无曲目')
return `${r.body.data.playlist?.name ?? ''}(${r.body.data.total} 首)` return `${r.body.data.playlist?.name ?? ''}(${r.body.data.total} 首)`
@@ -682,24 +682,24 @@ await test('链接解析 /parse/song/kw(正向)', async() => {
return `kw 解析成功: ${r.body.data.song.name}` return `kw 解析成功: ${r.body.data.song.name}`
}) })
await test('扫码二维码创建 POST /login/bl/qr', async() => { await test('扫码二维码创建 POST /login/bili/qr', async() => {
const r = await postRaw('/login/bl/qr') const r = await postRaw('/login/bili/qr')
const body = JSON.parse(r.body) const body = JSON.parse(r.body)
if (r.status !== 200 || body.code != 0 || !body.data?.key) throw new Error(r.body.slice(0, 120)) if (r.status !== 200 || body.code != 0 || !body.data?.key) throw new Error(r.body.slice(0, 120))
return `key=${String(body.data.key).slice(0, 12)}…` return `key=${String(body.data.key).slice(0, 12)}…`
}) })
await test('扫码轮询 POST /login/bl/qr/check', async() => { await test('扫码轮询 POST /login/bili/qr/check', async() => {
const created = JSON.parse((await postRaw('/login/bl/qr')).body) const created = JSON.parse((await postRaw('/login/bili/qr')).body)
const key = created.data?.key const key = created.data?.key
if (!key) throw new Error('未取到 key') if (!key) throw new Error('未取到 key')
const r = await postJson('/login/bl/qr/check', { key }) const r = await postJson('/login/bili/qr/check', { key })
if (r.status !== 200 || r.body?.code != 0) throw new Error(JSON.stringify(r.body).slice(0, 120)) if (r.status !== 200 || r.body?.code != 0) throw new Error(JSON.stringify(r.body).slice(0, 120))
return `status=${r.body.data.status} code=${r.body.data.code}` return `status=${r.body.data.status} code=${r.body.data.code}`
}) })
await test('个人歌单 未支持的平台 → 502', async() => { await test('个人歌单 未支持的平台 → 502', async() => {
const r = await getRaw('/user-playlist/5s') const r = await getRaw('/user-playlist/5sing')
if (r.status !== 502 && r.status !== 404) throw new Error(`期望 502/404,实际 ${r.status}`) if (r.status !== 502 && r.status !== 404) throw new Error(`期望 502/404,实际 ${r.status}`)
return JSON.parse(r.body).msg?.slice(0, 60) return JSON.parse(r.body).msg?.slice(0, 60)
}) })