feat(python): 完成 Python 全量迁移——剩余平台、登录通道与公共层修复

- 新增 5sing/apple/xm/me/qt/lr 平台包与取流实现（含 xm-sign、MissEvan 签名、蜻蜓 HMAC、Apple developer token） - 新增 wy/kg/tx/lr 登录：扫码、手机号、账密（kg 20028 风控指纹）、cookie 绑定、kg/tx 续期 - request 层：保留多值 Set-Cookie；JSON body 紧凑化（修复 kg 网关验签）；直连不经系统代理（对齐 Node） - 登录路由统一 Body(embed=True)，修复扫码轮询 422；lifespan 接入登录续期调度 - ruff/format/pyright 全绿；14 平台真实联网与 HTTP 路由验证通过
2026-10-23 21:55:45 +08:00
1 parent 800871ef6e
commit dfc06bf4de
@@ -0,0 +1,103 @@
+"""JOOX 歌曲详情 / 取流通道（openjoox2 v1，web 播放器同款签名接口）。
+
+对应 sdk/joox/musicInfo.ts。
+
+端点：GET https://cache.api.joox.com/openjoox2/v1/track/<id>
+      ?country=hk&lang=zh_TW&lyric=1&fs=<0|1>&im=<0|1>[&uid=<wmid>][&usk=<session_key>]&secret=<md5>
+
+签名：secret = md5('Jo0x@t3Nc3nT' + 'country=..&lang=..&lyric=1&fs=..&im=..[&uid=..][&usk=..]&id=..')
+  * 参数按**插入序**参与签名；id 用 '/' → '_' 替换后的值，且发布 URL 前会从 query 中删除 id。
+  * 签名串与真正发出的参数来自同一次序列化（同一份 params dict + 同一 encoder），不做二次拼接。
+  * 实测（2026-10）：不带/带错 secret → 401 {"code":-10005,"msg":"Invalid secret key"}；
+    按上式 → 200，返回 play_url_list / refrain_url / lrc_content / qrc_content / vip_flag 等。
+
+上游 Go 的 api.joox.com/web-fcgi-bin/web_get_songinfo 已 404（2026-10 前），本模块为其替代。
+``fs=1`` 请求完整曲目（游客仍可能拿到 preview/refrain），``im`` 为 mobile 标记。
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from app.sdk.common.request import http_fetch
+from app.sdk.platforms.joox.util import (
+    JOOX_TIMEOUT,
+    cookie_value,
+    encode_uri_component,
+    joox_headers,
+    joox_login_cookie,
+    joox_sign,
+    normalize_joox_id,
+    normalize_joox_lang,
+)
+
+JOOX_OPENJOOX2 = "https://cache.api.joox.com/openjoox2/v1"
+
+
+def build_track_url(
+    raw_id: Any,
+    country: str = "",
+    lang: str = "",
+    full_song: bool = False,
+    is_mobile: bool = False,
+) -> str:
+    """构造 openjoox2 歌曲详情 URL（含签名；登录态自动带 uid/usk）。"""
+    track_id = str(normalize_joox_id(raw_id)).replace("/", "_")
+    params: dict[str, Any] = {
+        "country": country or "hk",
+        "lang": normalize_joox_lang(lang or "zh_TW"),
+        "lyric": 1,
+        "fs": 1 if full_song else 0,
+        "im": 1 if is_mobile else 0,
+    }
+    # 仅绑定登录凭据后才带 uid/usk（游客态与官网播放器一致，不带这两项）
+    login_cookie = joox_login_cookie()
+    uid = cookie_value(login_cookie, "wmid") if login_cookie else ""
+    usk = cookie_value(login_cookie, "session_key") if login_cookie else ""
+    if uid:
+        params["uid"] = uid
+    if usk:
+        params["usk"] = usk
+    # 签名时包含 id（与 web 播放器一致），发布 query 时 id 走路径、不进 query
+    secret = joox_sign({**params, "id": track_id})
+    query = "&".join(f"{key}={encode_uri_component(value)}" for key, value in {**params, "secret": secret}.items())
+    return f"{JOOX_OPENJOOX2}/track/{track_id}?{query}"
+
+
+async def get_track_detail(
+    raw_id: Any,
+    country: str = "",
+    lang: str = "",
+    full_song: bool = False,
+    is_mobile: bool = False,
+) -> dict[str, Any]:
+    """歌曲详情（openjoox2；上游 fetchSongInfo 的替代实现）。"""
+    track_id = normalize_joox_id(raw_id)
+    if not track_id:
+        raise RuntimeError("joox 歌曲 id 无效")
+    url = build_track_url(track_id.replace("/", "_"), country, lang, full_song, is_mobile)
+    res = await http_fetch(url, headers=joox_headers(), timeout=JOOX_TIMEOUT)
+    body = res.body
+    if res.status_code != 200 or not isinstance(body, dict) or body.get("code"):
+        msg = ""
+        if isinstance(body, dict):
+            msg = str(body.get("msg") or body.get("message") or "")
+        raise RuntimeError(f"joox 歌曲详情获取失败：{msg or f'HTTP {res.status_code}'}")
+    return body
+
+
+def pick_track_url(detail: Any) -> str:
+    """从详情里挑选可播放地址：play_url_list 优先，refrain_url 兜底；并还原 &amp; 实体。"""
+    if not isinstance(detail, dict):
+        return ""
+
+    def clean(value: Any) -> str:
+        return str(value if value is not None else "").replace("&amp;", "&")
+
+    urls = detail.get("play_url_list")
+    for url in urls if isinstance(urls, list) else []:
+        text = clean(url)
+        if text.startswith("http"):
+            return text
+    refrain = clean(detail.get("refrain_url"))
+    return refrain if refrain.startswith("http") else ""