feat(sdk): 新增咪咕/千千/JOOX/哔哩哔哩/5sing/Apple Music 六平台

平台注册表由 9 个扩到 15 个,同时补齐 sdk/types.ts 的类型与
OpenAPI 文档里的能力位声明。

- migu:命中 Z3D/I3D 加密候选时不返回直链,改由服务端解密代理出流,
  SDK 侧只负责登记票据,避免客户端拿到无法播放的密文
- apple:只提供 preview 试听片段(完整曲为 DRM),标 noAggregate
  排除在跨平台精确匹配之外,防止用它顶掉其它平台的可播结果
- 其余平台按既有 PlatformModule 约定实现搜索/专辑/歌单/歌词

为什么合并成一次提交:六平台共用同一份注册表与能力位声明,
拆开会产生互相引用、单独无法通过类型检查的中间态。
This commit is contained in:
snowy-yang committed 2026-10-03 00:26:32 +08:00
1 parent 47ce651f46
commit 33b96f92c4
54 files changed
+6161 -5

No files matched your search

+28
View File
@@ -0,0 +1,28 @@
// JOOX 链接解析(上游 joox/song.go Parse + album.go ParseAlbum + playlist.go ParsePlaylist)
// 歌曲:joox.com/<region>/single/<id> 或裸 ID(>10 字符且不含 '/')→ openjoox2 详情 → Song(含直链)
// 专辑:joox.com/.../album/<id>、h_activity_id=、albumid= → album.getAlbumDetail
// 歌单:joox.com/.../playlist/<id>、playlistid|playlist_id|id= → playlist.getPlaylistDetail
import { normalizeJooxID } from './util.ts'
import { getTrackDetail, pickTrackUrl } from './musicInfo.ts'
import { jooxSongFromDetail } from './song.ts'
import { getAlbumDetail, parseAlbum } from './album.ts'
import { getPlaylistDetail, parsePlaylist } from './playlist.ts'
/** 歌曲链接 → Song(上游 Parse 的正则与裸 ID 规则) */
export const parseSong = async(link: string) => {
const raw = String(link ?? '').trim()
const m = /joox\.com\/.*\/single\/([^/?#]+)/.exec(raw)
let songId = ''
if (m) {
songId = normalizeJooxID(m[1])
} else if (raw.length > 10 && !raw.includes('/')) {
songId = normalizeJooxID(raw)
} else {
throw new Error('invalid joox link')
}
const detail = await getTrackDetail(songId)
return jooxSongFromDetail(detail, pickTrackUrl(detail))
}
export default { parseSong, parseAlbum, parsePlaylist }