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
1 parent
47ce651f46
commit
33b96f92c4
54 files changed
+6161
-5
No files matched your search
@@ -0,0 +1,181 @@
|
||||
// JOOX 平台公共工具：请求头/签名/ID 归一化/链接构造/页面数据提取
|
||||
// 背景（2026-10-02 实测）：
|
||||
// - JOOX 是东南亚服务，www.joox.com 会按来源 IP 重定向到 /intl；上游 Go 通过伪造
|
||||
// X-Forwarded-For 为东南亚 IP（36.73.34.109）绕过，本移植保持一致。
|
||||
// - 新版 web 播放器走 cache.api.joox.com/openjoox2/v1/*，必须带 secret 签名：
|
||||
// secret = md5('Jo0x@t3Nc3nT' + 参数按插入序 k=v&... )（值经 encodeURIComponent），
|
||||
// 密钥来自官网 JS bundle 常量 secretAPIKey（web 公开常量，非账号密钥）。
|
||||
// - 旧接口 api.joox.com/web-fcgi-bin/web_get_songinfo 已 404（取流/歌曲详情改用 openjoox2），
|
||||
// 但 web_lyric 仍可用（歌词仍走上游接口）。
|
||||
// - 上游 New(cookie)：cookie 用于游客态/登录态请求；登录 cookie 里的 wmid/session_key
|
||||
// 在签名参数里作为 uid/usk 参与（可拿到完整曲目/更高档位）。
|
||||
|
||||
import crypto from 'node:crypto'
|
||||
import { httpFetch } from '../request.ts'
|
||||
import { getCredentials } from '../auth/store.ts'
|
||||
|
||||
export const JOOX_UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36'
|
||||
/** 上游 Go 的默认游客 Cookie（jaox.go 常量 Cookie） */
|
||||
export const JOOX_DEFAULT_COOKIE = 'wmid=142420656; user_type=1; country=id; session_key=2a5d97d05dc8fe238150184eaf3519ad;'
|
||||
/** 上游 Go 的 X-Forwarded-For（东南亚 IP，绕过地区重定向） */
|
||||
export const JOOX_XFF = '36.73.34.109'
|
||||
/** openjoox2 签名密钥（官网 web bundle 常量 secretAPIKey） */
|
||||
export const JOOX_SECRET_KEY = 'Jo0x@t3Nc3nT'
|
||||
|
||||
export const md5Hex = (str: string): string => crypto.createHash('md5').update(str, 'utf8').digest('hex')
|
||||
|
||||
/**
|
||||
* openjoox2 签名：md5(secretAPIKey + `k=encodeURIComponent(v)` 按插入序以 & 连接)
|
||||
* 注意键序即对象插入序（服务端按同序校验），不要重排参数。
|
||||
*/
|
||||
export const jooxSign = (params: Record<string, any>): string =>
|
||||
md5Hex(JOOX_SECRET_KEY + Object.keys(params).map(key => `${key}=${encodeURIComponent(String(params[key]))}`).join('&'))
|
||||
|
||||
/** 绑定到 sdk/auth/store.ts 的登录 cookie（未登录返回空串，不回退游客 cookie） */
|
||||
export const jooxLoginCookie = (): string => {
|
||||
const cred = getCredentials('joox') as { cookie?: string } | null
|
||||
return cred?.cookie || ''
|
||||
}
|
||||
|
||||
/** 请求用 cookie（登录态优先；未登录回退上游游客 cookie） */
|
||||
export const jooxCookie = (): string => jooxLoginCookie() || JOOX_DEFAULT_COOKIE
|
||||
|
||||
/** 从 cookie 串里取一个字段 */
|
||||
export const cookieValue = (cookie: string, name: string): string => {
|
||||
const m = new RegExp(`(?:^|;\\s*)${name}=([^;]*)`).exec(String(cookie ?? ''))
|
||||
return m ? m[1].trim() : ''
|
||||
}
|
||||
|
||||
/** 平台公共请求头（含地区伪装与 Cookie） */
|
||||
export const jooxHeaders = (extra: Record<string, any> = {}): Record<string, any> => ({
|
||||
'User-Agent': JOOX_UA,
|
||||
Cookie: jooxCookie(),
|
||||
'X-Forwarded-For': JOOX_XFF,
|
||||
Referer: 'https://www.joox.com/',
|
||||
Accept: 'application/json, text/plain, */*',
|
||||
...extra,
|
||||
})
|
||||
|
||||
/** 语言归一（对齐官网 51bm.c：zh_hk/zh_mo → zh_TW，zh_cn → zh_CN） */
|
||||
export const normalizeJooxLang = (lang?: string): string => {
|
||||
if (lang === 'zh_hk' || lang === 'zh_mo') return 'zh_TW'
|
||||
if (lang === 'zh_cn') return 'zh_CN'
|
||||
return lang || 'zh_TW'
|
||||
}
|
||||
|
||||
/** ID 归一化（上游 normalizeJooxID）：去空白 + 百分号解码（空格还原为 +） */
|
||||
export const normalizeJooxID = (raw: unknown): string => {
|
||||
let id = String(raw ?? '').trim()
|
||||
if (!id) return ''
|
||||
if (id.includes('%')) {
|
||||
try {
|
||||
id = decodeURIComponent(id)
|
||||
} catch {
|
||||
// 上游 PathUnescape/QueryUnescape 失败时保留原值
|
||||
}
|
||||
id = id.replace(/ /g, '+')
|
||||
}
|
||||
return id
|
||||
}
|
||||
|
||||
export const jooxSongLink = (id: unknown): string => `https://www.joox.com/hk/single/${normalizeJooxID(id)}`
|
||||
export const jooxAlbumLink = (id: unknown): string => `https://www.joox.com/hk/album/${normalizeJooxID(id)}`
|
||||
export const jooxRegionalPlaylistLink = (region: string, id: unknown): string =>
|
||||
`https://www.joox.com/${region}/playlist/${normalizeJooxID(id)}`
|
||||
export const jooxPlaylistLink = (id: unknown): string => jooxRegionalPlaylistLink('id', id)
|
||||
/** 歌单页候选（上游顺序：id → sg → hk，逐个尝试直到页面数据可用） */
|
||||
export const jooxPlaylistLinks = (id: unknown): string[] =>
|
||||
['id', 'sg', 'hk'].map(region => jooxRegionalPlaylistLink(region, id))
|
||||
|
||||
/** 封面挑选（上游 pickJooxImage：优先 300 → 1000 → 100，再回退首个非空） */
|
||||
export const pickJooxImage = (images: any[]): string => {
|
||||
const list = Array.isArray(images) ? images : []
|
||||
for (const width of [300, 1000, 100]) {
|
||||
for (const image of list) {
|
||||
const url = String(image?.url ?? '').trim()
|
||||
if (Number(image?.width) === width && url) return url
|
||||
}
|
||||
}
|
||||
for (const image of list) {
|
||||
const url = String(image?.url ?? '').trim()
|
||||
if (url) return url
|
||||
}
|
||||
return ''
|
||||
}
|
||||
|
||||
/** 歌手拼接（上游 joinJooxArtists，分隔符 ' / '） */
|
||||
export const jooxArtists = (list: any[]): string =>
|
||||
(Array.isArray(list) ? list : []).map(a => String(a?.name ?? '').trim()).filter(Boolean).join(' / ')
|
||||
|
||||
export const firstNonEmpty = (...values: any[]): any => {
|
||||
for (const value of values) {
|
||||
if (value != null && String(value).trim() !== '') return value
|
||||
}
|
||||
return ''
|
||||
}
|
||||
|
||||
export const firstNonZero = (...values: any[]): number => {
|
||||
for (const value of values) {
|
||||
const n = Number(value)
|
||||
if (Number.isFinite(n) && n > 0) return n
|
||||
}
|
||||
return 0
|
||||
}
|
||||
|
||||
/** base64 文本解码（上游 decodeJooxBase64Text：容忍 URL-safe 与缺失填充） */
|
||||
export const decodeJooxBase64Text = (value: unknown): string => {
|
||||
const raw = String(value ?? '').trim()
|
||||
if (!raw) return ''
|
||||
const normalized = raw.replace(/-/g, '+').replace(/_/g, '/')
|
||||
const padded = normalized + '='.repeat((4 - (normalized.length % 4)) % 4)
|
||||
try {
|
||||
const text = Buffer.from(padded, 'base64').toString('utf8')
|
||||
// 解码结果是二进制噪声时回退原值（对齐上游 stdout base64 校验语义）
|
||||
return text.includes('\uFFFD') ? raw : text.trim()
|
||||
} catch {
|
||||
return raw
|
||||
}
|
||||
}
|
||||
|
||||
/** HTML 实体解码（歌词文本兜底） */
|
||||
export const decodeHtmlEntities = (text: unknown): string =>
|
||||
String(text ?? '')
|
||||
.replace(/&/g, '&')
|
||||
.replace(/</g, '<')
|
||||
.replace(/>/g, '>')
|
||||
.replace(/"/g, '"')
|
||||
.replace(/'/g, "'")
|
||||
.replace(/�*39;/g, "'")
|
||||
.replace(/ /g, ' ')
|
||||
|
||||
/** 歌词解码：base64 → utf8 → HTML 实体（上游 base64 + 常见实体兜底） */
|
||||
export const decodeJooxLyric = (value: unknown): string => decodeHtmlEntities(decodeJooxBase64Text(value))
|
||||
|
||||
/** 从 SSR 页面提取 __NEXT_DATA__ JSON */
|
||||
export const extractJooxNextData = (html: unknown): any => {
|
||||
const m = /<script[^>]*id="__NEXT_DATA__"[^>]*>([\s\S]*?)<\/script>/.exec(String(html ?? ''))
|
||||
if (!m) return null
|
||||
try {
|
||||
return JSON.parse(m[1])
|
||||
} catch {
|
||||
return null
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 拉取页面并手动跟随 3xx（request.ts 不自动跟跳；Go 客户端会自动跟）
|
||||
* 返回最终页 HTML（非字符串 body 视为空串）
|
||||
*/
|
||||
export const fetchJooxPage = async (url: string, maxRedirect = 3): Promise<{ statusCode: number, body: string, finalUrl: string }> => {
|
||||
let current = url
|
||||
for (let i = 0; i <= maxRedirect; i++) {
|
||||
const res: any = await httpFetch(current, { headers: jooxHeaders(), timeout: 20000 }).promise
|
||||
const location = res?.headers?.location
|
||||
if (res.statusCode >= 300 && res.statusCode < 400 && location) {
|
||||
current = new URL(String(location), current).href
|
||||
continue
|
||||
}
|
||||
return { statusCode: res.statusCode, body: typeof res.body === 'string' ? res.body : '', finalUrl: current }
|
||||
}
|
||||
throw new Error('joox 页面重定向次数过多')
|
||||
}
|
||||
Reference in new issue
Block a user