qqmusic-api-python 0.6.4__tar.gz → 0.6.6__tar.gz

{qqmusic_api_python-0.6.4 → qqmusic_api_python-0.6.6}/.github/workflows/docs.yml

@@ -41,14 +41,16 @@ jobs:
         env:
           OUTPUT: docs/release-notes.md
           GITHUB_REPO: ${{ github.repository }}
+      - name: Export web requirements.txt
+        run: uv export --format requirements.txt --group web --output-file web/requirements.txt
       - name: Commit
         run: |
           git checkout main
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
           set +e
-          git add docs/release-notes.md
-          git commit -m "🧹 chore(release-notes): 更新 release notes"
+          git add docs/release-notes.md web/requirements.txt
+          git commit -m "🧹 chore(release): 更新 release notes 及 web 依赖"
           git push origin main
       - name: Build with zensical
         run: uv run zensical build

{qqmusic_api_python-0.6.4 → qqmusic_api_python-0.6.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qqmusic-api-python
-Version: 0.6.4
+Version: 0.6.6
 Summary: QQ音乐API封装库
 Project-URL: documentation, https://l-1124.github.io/QQMusicApi/
 Project-URL: homepage, https://l-1124.github.io/QQMusicApi/

{qqmusic_api_python-0.6.4 → qqmusic_api_python-0.6.6}/docs/release-notes.md

@@ -1,4 +1,31 @@
 
+## [[0.6.5](https://github.com/L-1124/QQMusicApi/compare/v0.6.4..v0.6.5)] - 2026-06-12
+
+### Bug 修复
+
+* **(core)** 开启 allow_incoming_cookies=False 防止上下请求的 cookies 污染 ([1cd1b69](https://github.com/L-1124/QQMusicApi/commit/1cd1b69338ffa2f26409480490b18b9c9080a29e)) by [@L-1124](https://github.com/L-1124)
+* **(login)** `Platform.WEB` 的 `check_expired` 总是返回 True ([f0b4533](https://github.com/L-1124/QQMusicApi/commit/f0b4533e7c172b6cb5b0556fbd7ff13e8b20f4c7)) by [@L-1124](https://github.com/L-1124)
+
+### 贡献者
+
+* @L-1124
+* @github-actions[bot]
+
+## [[0.6.4](https://github.com/L-1124/QQMusicApi/compare/v0.6.3..v0.6.4)] - 2026-06-12
+
+### Bug 修复
+
+* **(models)** 修复没有 musickey 时误判为 QQ 登录的问题 ([9b122a7](https://github.com/L-1124/QQMusicApi/commit/9b122a77f418d85f1926da889846c61a55bf70a2)) by [@L-1124](https://github.com/L-1124)
+
+### 功能更新
+
+* **(models)** 修改 BaseModel 的 model_config 设置，允许额外字段 ([12a2334](https://github.com/L-1124/QQMusicApi/commit/12a2334dbde580930b167c728998b6310508597e)) by [@L-1124](https://github.com/L-1124)
+
+### 贡献者
+
+* @L-1124
+* @github-actions[bot]
+
 ## [[0.6.3](https://github.com/L-1124/QQMusicApi/compare/v0.6.2..v0.6.3)] - 2026-06-12
 
 ### Bug 修复

qqmusic_api_python-0.6.6/examples/get_all_sheets.py

@@ -0,0 +1,47 @@
+"""获取歌曲所有来源曲谱示例."""
+
+import asyncio
+
+from qqmusic_api import Client
+
+CREDENTIAL_PATH = __import__("pathlib").Path(__file__).parent.parent / "credential.json"
+
+MID = "0039MnYb0qxYhV"
+
+
+async def main() -> None:
+    """并行获取所有来源曲谱并合并."""
+    async with Client() as client:
+        # 1. 先检查有哪些类型的曲谱
+        has = await client.song.has_sheet(MID)
+        print(f"歌曲 {MID}:")
+        print(f"  吉他谱: {has.has_guitar}")
+        print(f"  虫虫钢琴: {has.has_chong_chong}")
+        print(f"  更多曲谱: {has.has_more}")
+
+        # 2. 并行拉取三个来源
+        results = await client.gather(
+            [
+                client.song.get_sheet(MID, ttype=0),
+                client.song.get_sheet(MID, ttype=1),
+                client.song.get_sheet(MID, ttype=2),
+            ]
+        )
+
+        # 3. 合并结果, 按 scoreMID 去重
+        seen: set[str] = set()
+        merged: list = []
+        for resp in results:
+            if isinstance(resp, Exception):
+                continue
+            for sheet in resp.result:
+                if sheet.score_mid not in seen:
+                    seen.add(sheet.score_mid)
+                    merged.append(sheet)
+
+        print(f"\n共获取 {len(merged)} 首曲谱:")
+        for sheet in merged:
+            print(f"  {sheet.score_name} [{sheet.ins_type_text}] ({sheet.score_type_text})")
+
+
+asyncio.run(main())

{qqmusic_api_python-0.6.4 → qqmusic_api_python-0.6.6}/qqmusic_api/__init__.py

@@ -18,7 +18,7 @@ from .core.exceptions import (
 from .core.versioning import Platform
 from .models.request import Credential
 
-__version__ = "0.6.4"
+__version__ = "0.6.6"
 
 __all__ = [
     "ApiDataError",

{qqmusic_api_python-0.6.4 → qqmusic_api_python-0.6.6}/qqmusic_api/algorithms/__init__.py

@@ -2,6 +2,7 @@
 
 import zlib
 
+from .sign import zzc_sign
 from .tripledes import DECRYPT, tripledes_crypt, tripledes_key_setup
 
 _QRC_3DES_KEY = b"!@#)(*$%123ZXC!@!@#)(NHL"
@@ -43,4 +44,5 @@ def qrc_decrypt(encrypted_qrc: str | bytearray | bytes) -> str:
 
 __all__ = [
     "qrc_decrypt",
+    "zzc_sign",
 ]

qqmusic_api_python-0.6.6/qqmusic_api/algorithms/sign.py

@@ -0,0 +1,32 @@
+"""签名算法实现."""
+
+import re
+from base64 import b64encode
+from hashlib import sha1
+
+PART_1_INDEXES = [23, 14, 6, 36, 16, 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]
+
+
+def zzc_sign(payload: str | bytes | bytearray) -> str:
+    """计算 QQ 音乐客户端请求的 zzc 签名.
+
+    Args:
+        payload: 待签名的明文 (字符串或二进制数据).
+
+    Returns:
+        str: 计算出的签名值.
+    """
+    payload_bytes = payload.encode("utf-8") if isinstance(payload, str) else bytes(payload)
+    hash_hex = sha1(payload_bytes).hexdigest().upper()
+
+    part1 = "".join(hash_hex[i] for i in PART_1_INDEXES)
+    part2 = "".join(hash_hex[i] for i in PART_2_INDEXES)
+
+    part3 = bytearray(20)
+    for i, v in enumerate(SCRAMBLE_VALUES):
+        value = v ^ int(hash_hex[i * 2 : i * 2 + 2], 16)
+        part3[i] = value
+    b64_part = re.sub(rb"[\\/+=]", b"", b64encode(part3)).decode("utf-8")
+    return f"zzc{part1}{b64_part}{part2}".lower()