MusicServer/sdk/apis/kw.ts

// 酷我音乐 URL 获取（直连）
// 统一接口约定：apis('kw').getMusicUrl(songInfo, type) → { promise, cancelHttp }
// promise resolve → { type, url }
//
// 取流方案（按序回退）：
//   1. antiserver.kuwo.cn/anti.s（convert_url3 老接口，无需 token，128k/320k 有效，
//      未登录时部分资源只返回试听片段）
//   2. www.kuwo.cn/api/v1/www/music/playUrl（需 csrf token，token 失效自动重取重试一次）
//
// 2026-09-19 实测结论（勿轻易改链）：
//   - mobi.kuwo.cn/mobi.s（DES 加密 query）已进防盗链蜜罐：
//     任意 rid（含不存在的）都返回 200 与 MP3 地址，但内容是《防盗链打击音频》假文件，
//     且响应无法与真实响应区分，故不接入默认链路；DES 实现可参考 UnblockNeteaseMusic 上游 kwDES。
//   - playUrl 对新 token（Hm_Iuvt_* cookie）返回 "The request is illegal!"（要求签名），
//     首页也不再下发 kw_token，getToken 会失败——通道名存实亡，仅作最后回退。
//   - flac 及以上音质各匿名通道均要求 VIP 登录态；接入酷我登录 token 后可重估 mobi.s。

import { httpFetch } from '../common/request.ts'

// 音质映射：128k → 128kmp3, 320k → 320kmp3, flac → flac（antiserver/mobi.s 用 mp3/flac 格式）
const qualityMap = {
  '128k': { br: '128kmp3', format: 'mp3' },
  '320k': { br: '320kmp3', format: 'mp3' },
  flac: { br: 'flac', format: 'flac' },
  flac24bit: { br: 'flac', format: 'flac' },
}

// 官方直连接口支持的音质（sdk/index.ts 汇总为 supportQuality）
export const supportQualitys = Object.keys(qualityMap)

let token = ''
let tokenPromise: Promise<string> | null = null

/**
 * 获取 kw csrf token（访问首页拿 cookie）
 */
const getToken = (retryNum = 0) => {
  if (token) return Promise.resolve(token)
  if (tokenPromise) return tokenPromise
  tokenPromise = httpFetch('http://www.kuwo.cn/', {
    method: 'get',
    timeout: 15000,
  }).promise.then(({ headers }) => {
    tokenPromise = null
    const match = ((headers['set-cookie'] as string[]) || []).join(';').match(/kw_token=(\w+)/)
    if (!match) throw new Error('获取token失败')
    token = match[1]
    return token
  }).catch(err => {
    tokenPromise = null
    if (retryNum > 2) throw err
    return getToken(++retryNum)
  })
  return tokenPromise
}

/**
 * 通过 antiserver 老接口获取（无需 token）
 * @param {string} rid MUSIC_xxx
 * @param {string} br 128kmp3 / 320kmp3 / flac
 * @param {string} format mp3 / flac
 */
const getUrlByAntiServer = (rid, br, format) => {
  return httpFetch(`http://antiserver.kuwo.cn/anti.s?type=convert_url3&rid=${rid}&format=${format}&response=url&br=${br}`, {
    method: 'get',
    headers: {
      'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
    },
    timeout: 15000,
  }).promise.then(({ statusCode, body }) => {
    if (statusCode != 200 || typeof body != 'object' || body.code != 200 || !body.url) {
      return Promise.reject(new Error(body?.msg || '获取失败'))
    }
    return body.url
  })
}

/**
 * 通过官方 playUrl 接口获取（需要 csrf token）
 */
const getUrlByPlayUrl = (songmid, br, retryNum = 0) => {
  const requestObj = httpFetch(`http://www.kuwo.cn/api/v1/www/music/playUrl?mid=${songmid}&type=music&br=${br}`, {
    method: 'get',
    headers: {
      csrf: token,
      cookie: `kw_token=${token}`,
      Referer: 'http://www.kuwo.cn/',
      'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
    },
    timeout: 15000,
  })
  requestObj.promise = requestObj.promise.then(({ statusCode, body }) => {
    if (statusCode != 200 || body.code != 200) {
      // token 失效时重新获取再试一次
      if (token && /token|403|401/.test(body?.msg || '') && retryNum == 0) {
        token = ''
        return getUrlByPlayUrl(songmid, br, ++retryNum).promise
      }
      return Promise.reject(new Error(body?.msg || '获取失败'))
    }
    if (!body.data?.url) return Promise.reject(new Error('获取失败'))
    return body.data.url
  })
  return requestObj
}

export const getMusicUrl = (songInfo, type) => {
  const requestObj = { cancelHttp() {}, promise: null as any }
  const { br, format } = qualityMap[type] || qualityMap['128k']
  const rid = `MUSIC_${songInfo.songmid}`

  requestObj.promise = getUrlByAntiServer(rid, br, format).catch(() => {
    // antiserver 无此音质（flac 常被拒）时回退官方接口
    return getToken().then(() => getUrlByPlayUrl(songInfo.songmid, br).promise)
  }).then(url => ({ type, url }))
  return requestObj
}

export default { getMusicUrl }