refactor: 架构整固——分层单向化、全量 TypeScript、直接运行

- 移除 bd/mg 两平台及磁盘残留产物；清理 api-test 死脚本、musicSdk/message+options 死模块、infSign vendor - musicSdk/ 改名 sdk/；src/common、src/auth、src/apis 整体移入 sdk/，依赖方向定为 src → sdk 严格单向 - src/ 手写 JS 全量转 .ts，删除 JS 类型垫片 modules.d.ts；源码 import 统一 .ts 后缀 - Node 原生类型剥离直接运行 .ts（engines >=22.18），取消 tsc 发射产物，tsc 仅类型检查（pnpm typecheck） - 删除 kwdes 备用实现与 src/index.ts 转发垫片；测试移至 test/smoke-test.ts - common/request.ts 补显式导出类型；修复 set-cookie 单值形态、ApiError 类字段等隐患验证：tsc 零错误，smoke-test 41/41
2026-09-25 23:06:23 +08:00
1 parent c8c939aa32
commit 354df2e739
@@ -0,0 +1,116 @@
+// 酷我音乐 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' },
+}
+
+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 }