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

+22
View File
@@ -0,0 +1,22 @@
// Apple Music 链接解析(上游 apple.go Parse / ParseAlbum / ParsePlaylist)
// song: https://music.apple.com/us/album/<slug>/<albumId>?i=<songId>(?i= 优先)或裸数字 song id
// album: https://music.apple.com/us/album/<slug>/<id> 或裸数字 album id
// playlist: https://music.apple.com/us/playlist/<slug>/pl.xxxx 或裸 pl.* id
// 上游 Parse 会请求歌曲详情(include=lyrics,albums)并填入 preview URL。
import { appleSongFromCatalog, extractAppleID, fetchAppleSongResource } from './util.ts'
import { parseAlbumLink } from './album.ts'
import { parsePlaylistLink } from './playlist.ts'
/** 上游 Parse:单曲链接/裸 id → Song(含 previewUrl 试听直链) */
export const parseSong = async(link: string) => {
const songId = extractAppleID(String(link ?? ''), 'song')
if (!songId) throw new Error(`invalid apple music song link: ${link}`)
const res = await fetchAppleSongResource(songId, 'lyrics,albums')
if (!res) throw new Error(`apple song not found: ${songId}`)
return appleSongFromCatalog(res)
}
export const parseAlbum = async(link: string) => parseAlbumLink(link)
export const parsePlaylist = async(link: string) => parsePlaylistLink(link)
export default { parseSong, parseAlbum, parsePlaylist }