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,63 @@
+"""QQ音乐（tx）工具集 —— 签名通道与 zzc 签名。
+
+源: sdk/tx/utils/index.ts + sdk/tx/utils/crypto.ts
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from app.sdk.common.request import http_fetch
+from app.sdk.platforms.tx.utils.crypto import zzc_sign
+
+MUSICU_URL = "https://u.y.qq.com/cgi-bin/musicu.fcg"
+# 原 TS 用两条不同 UA：musics.fcg 走客户端 UA，musicu.fcg 走旧 IE UA
+UA_CLIENT = "QQMusic 14090508(android 12)"
+UA_MUSICU = "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)"
+
+
+async def sign_request(data: dict[str, Any]) -> Any:
+    """musics.fcg 签名通道：sign 由 zzc_sign(JSON 串) 生成。
+
+    签名与实际发送的 body 必须是同一个字符串：http_fetch 对 dict 会自行
+    json.dumps（默认分隔符带空格），与这里的紧凑序列化不一致会导致服务端验签失败并回
+    code 2000。因此统一序列化一次，并把该字符串原样作为 body 发送（str 走原样发送分支）。
+    """
+    text = _to_json(data)
+    sign = zzc_sign(text)
+    return await http_fetch(
+        f"https://u.y.qq.com/cgi-bin/musics.fcg?sign={sign}",
+        method="post",
+        headers={"User-Agent": UA_CLIENT},
+        body=text,
+    )
+
+
+async def create_musicu_fetch(data: dict[str, Any], retry_num: int = 0) -> dict[str, Any]:
+    """musicu.fcg 通用请求，失败重试 3 次（文案与原文一致：try max num）。
+
+    注意：comm 固定 uin=0，即便已登录也走匿名通道 —— 与原文一致（登录态只影响取流）。
+    """
+    if retry_num > 2:
+        raise RuntimeError("try max num")
+
+    try:
+        resp = await http_fetch(
+            MUSICU_URL,
+            method="post",
+            headers={"User-Agent": UA_MUSICU},
+            body={"comm": {"uin": 0, "format": "json", "ct": 20, "cv": 1859}, **data},
+        )
+    except (RuntimeError, OSError, TimeoutError):
+        return await create_musicu_fetch(data, retry_num + 1)
+
+    body = resp.body if isinstance(resp.body, dict) else {}
+    if resp.status_code != 200 or body.get("code") != 0:
+        return await create_musicu_fetch(data, retry_num + 1)
+    return body
+
+
+def _to_json(data: Any) -> str:
+    import json
+
+    return json.dumps(data, ensure_ascii=False, separators=(",", ":"))
@@ -0,0 +1,56 @@
+"""QQ音乐 musics.fcg 签名（移植自 sdk/tx/utils/crypto.ts）。
+
+算法：SHA1 摘要的十六进制串 → 按固定下标取两段字符 → 第三段用固定混淆表
+与摘要每字节异或后 base64（剔除 + / = 与反斜杠）→ 拼成 `zzc{part1}{b64}{part2}` 转小写。
+"""
+
+from __future__ import annotations
+
+import base64
+import hashlib
+import re
+
+PART_1_INDEXES = (23, 14, 6, 36, 16, 40, 7, 19)
+PART_2_INDEXES = (16, 1, 32, 12, 19, 27, 8, 5)
+SCRAMBLE_VALUES = (
+    89,
+    39,
+    179,
+    150,
+    218,
+    82,
+    58,
+    252,
+    177,
+    52,
+    186,
+    123,
+    120,
+    64,
+    242,
+    133,
+    143,
+    161,
+    121,
+    179,
+)
+_B64_STRIP = re.compile(r"[\\/+=]")
+
+
+def _pick_by_indexes(hash_hex: str, indexes: tuple[int, ...]) -> str:
+    """按固定下标取字符。
+
+    PART_1_INDEXES 含下标 40，而 SHA1 十六进制串正好 40 字符（合法下标 0–39）。
+    TS 侧 `hash[40]` 取到 undefined，`join('')` 会把它并成空串；Python 直接下标会抛
+    IndexError，因此这里显式跳过越界下标，保持与上游签名逐字节一致。
+    """
+    return "".join(hash_hex[index] for index in indexes if 0 <= index < len(hash_hex))
+
+
+def zzc_sign(text: str) -> str:
+    hash_hex = hashlib.sha1(text.encode()).hexdigest()
+    part1 = _pick_by_indexes(hash_hex, PART_1_INDEXES)
+    part2 = _pick_by_indexes(hash_hex, PART_2_INDEXES)
+    scrambled = bytes(value ^ int(hash_hex[i * 2 : i * 2 + 2], 16) for i, value in enumerate(SCRAMBLE_VALUES))
+    part3 = _B64_STRIP.sub("", base64.b64encode(scrambled).decode())
+    return f"zzc{part1}{part3}{part2}".lower()