qqmusic-api-python 0.8.0__tar.gz → 0.8.1__tar.gz

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: qqmusic-api-python
-Version: 0.8.0
+Version: 0.8.1
 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.8.0 → qqmusic_api_python-0.8.1}/docs/release-notes.md

@@ -1,4 +1,64 @@
 
+## [[0.8.0](https://github.com/L-1124/QQMusicApi/compare/v0.7.3..v0.8.0)] - 2026-10-04
+
+### Bug 修复
+
+* **(core)** 修复请求分页提取器的参数克隆冲突 ([e74d00b](https://github.com/L-1124/QQMusicApi/commit/e74d00b6cc6274676adb9855902234c6a9a9fcb1)) by [@L-1124](https://github.com/L-1124)
+* **(tests)** 修复 disable_parse 移除后的测试残留并清理装饰性框线 ([39fc259](https://github.com/L-1124/QQMusicApi/commit/39fc259bdeefb3fd9f740d678a380da59e98f8da)) by [@L-1124](https://github.com/L-1124)
+* **(web)** 未捕获异常统一返回 JSON 形状的 500 响应 ([95e5ab4](https://github.com/L-1124/QQMusicApi/commit/95e5ab44c79e7503df969677e5848b5b376efafa)) by [@L-1124](https://github.com/L-1124)
+* **(web)** 屏蔽上游 5xx 异常细节并修正凭证快照的阻塞调用 ([2d384b0](https://github.com/L-1124/QQMusicApi/commit/2d384b021d0082dc2715c84884b36d29801ca342)) by [@L-1124](https://github.com/L-1124)
+* **(web)** 修复池凭证过期判定与刷新未同锁导致的重复登录 ([4426508](https://github.com/L-1124/QQMusicApi/commit/442650810e9fe43d0a646b4dfc8f76696dbb55e5)) by [@L-1124](https://github.com/L-1124)
+* **(web)** 修复调用方 Cookie 凭证被刷新并写回共享池的问题 ([4aeab21](https://github.com/L-1124/QQMusicApi/commit/4aeab216a26b873707c817457321b225a8e9d169)) by [@L-1124](https://github.com/L-1124)
+
+### 功能更新
+
+* **(core)** Android comm 参数补充注入 traceid ([84cc613](https://github.com/L-1124/QQMusicApi/commit/84cc6131a1cd44939d63edcdde5b3b554211bc88)) by [@L-1124](https://github.com/L-1124)
+* **(core)** 提升全局 Android 协议版本为 20.9.0.8 ([6ce5d7e](https://github.com/L-1124/QQMusicApi/commit/6ce5d7ef6c45cea392173c33e493d98f0f3d2913)) by [@L-1124](https://github.com/L-1124)
+* **(core)** 引入声明式 Endpoint 与无客户端网关 ([116e7fd](https://github.com/L-1124/QQMusicApi/commit/116e7fdb701f6d261ac913c3636b56f188c17ced)) by [@L-1124](https://github.com/L-1124) in [#304](https://github.com/L-1124/QQMusicApi/pull/304)
+* **(core)** 优化 comm 参数与设备标识语义 ([072011a](https://github.com/L-1124/QQMusicApi/commit/072011a5f5d9d60181148d79981701862906d6dc)) by [@L-1124](https://github.com/L-1124)
+* **(core)** 解耦设备缓存并完善并发控制 ([2eb66c4](https://github.com/L-1124/QQMusicApi/commit/2eb66c4c1651d6f525015c8c4bf6cb72e963c814)) by [@L-1124](https://github.com/L-1124)
+* **(core)** [**breaking**] 引入统一请求内核与显式流式读取 ([bc09d1c](https://github.com/L-1124/QQMusicApi/commit/bc09d1c60b1ffb093255938d63fa5a197af9939f)) by [@L-1124](https://github.com/L-1124) in [#303](https://github.com/L-1124/QQMusicApi/pull/303)
+* **(device)** 完善 Android 设备档案生成 ([4c67b50](https://github.com/L-1124/QQMusicApi/commit/4c67b50bfd4a03fde786e63b4fef0a587f3f4d12)) by [@L-1124](https://github.com/L-1124)
+* **(device)** 优化设备生成与 QIMEI 参数 ([f207f82](https://github.com/L-1124/QQMusicApi/commit/f207f8281e63da2b4fac4391dd7dbe10c527d68d)) by [@L-1124](https://github.com/L-1124)
+* **(sound_power)** 新增音响力与听歌榜模块及 Web 路由 ([514fc3f](https://github.com/L-1124/QQMusicApi/commit/514fc3f4f1357d0b73d95f6fd37f65ec9b6d86b7)) by [@L-1124](https://github.com/L-1124)
+* **(web)** 缓存未命中引入请求合并与上游失败标记熔断 ([807421d](https://github.com/L-1124/QQMusicApi/commit/807421db284db78e034d3abb1948228462d7d6e5)) by [@L-1124](https://github.com/L-1124)
+
+### 功能重构
+
+* **(album)** 迁移 AlbumApi 端点至 @cgi_endpoint 并更新 Web 路由 ([7522cea](https://github.com/L-1124/QQMusicApi/commit/7522ceadc69c4be3a3aa188b45f9f3d752109797)) by [@L-1124](https://github.com/L-1124)
+* **(comment)** 迁移 CommentApi 端点至 @cgi_endpoint 并更新 Web 路由 ([1565743](https://github.com/L-1124/QQMusicApi/commit/1565743030dc6bed7c2574ffc37ecb4aec93a919)) by [@L-1124](https://github.com/L-1124)
+* **(core)** 让 CgiRequestData.param 默认为空字典并移除冗余空参数 ([55f7b01](https://github.com/L-1124/QQMusicApi/commit/55f7b014ea4b118d2520278db8ffda900a871bf2)) by [@L-1124](https://github.com/L-1124)
+* **(core)** 彻底移除 disable_parse 选项并更新端点声明范式文档 ([5cf1a06](https://github.com/L-1124/QQMusicApi/commit/5cf1a0645f7fec6523ec05a725ab1ef161d577d1)) by [@L-1124](https://github.com/L-1124)
+* **(core)** 彻底分离端点元数据与运行期覆盖契约 ([46a1a2e](https://github.com/L-1124/QQMusicApi/commit/46a1a2e143698bbf77e3c8b318ff334c491f4755)) by [@L-1124](https://github.com/L-1124)
+* **(core)** 为端点装饰器增加分页类型重载与通用契约校验 ([f443e65](https://github.com/L-1124/QQMusicApi/commit/f443e6561ff5331d7023d2b538a9ace9dd1e8d6e)) by [@L-1124](https://github.com/L-1124)
+* **(lyric)** 迁移 LyricApi 端点至 @cgi_endpoint 并更新 Web 路由 ([e12ae87](https://github.com/L-1124/QQMusicApi/commit/e12ae875b1170d3eb7fbcf7724a801439807166f)) by [@L-1124](https://github.com/L-1124)
+* **(modules)** 为各模块端点声明 item_type 与 pager 契约并清理测试 ([8308052](https://github.com/L-1124/QQMusicApi/commit/8308052cfeee23c8bb78425d28d0bc6d997d8375)) by [@L-1124](https://github.com/L-1124)
+* **(mv)** 迁移 MvApi 端点至 @cgi_endpoint 并更新 Web 路由 ([d2e383c](https://github.com/L-1124/QQMusicApi/commit/d2e383cbcb8e304931afc04bf76167cce365cc1d)) by [@L-1124](https://github.com/L-1124)
+* **(recommend)** 迁移 RecommendApi 端点至 @cgi_endpoint 并更新 Web 路由 ([b97c043](https://github.com/L-1124/QQMusicApi/commit/b97c0436907e51a3ca489797e95f37de53cb1dde)) by [@L-1124](https://github.com/L-1124)
+* **(search)** 迁移 SearchApi 端点至 @cgi_endpoint 并更新 Web 路由 ([25fe3eb](https://github.com/L-1124/QQMusicApi/commit/25fe3ebeac8f65119d7b5ab3bc3f3e681c4a1b01)) by [@L-1124](https://github.com/L-1124)
+* **(singer)** [**breaking**] 移除 get_name_special_display 并合并至 get_info ([e293aa3](https://github.com/L-1124/QQMusicApi/commit/e293aa320f316ae9e654f90503c8a4b9186b0b91)) by [@L-1124](https://github.com/L-1124)
+* **(singer)** 迁移 SingerApi 端点至 @cgi_endpoint 并更新 Web 路由 ([79af270](https://github.com/L-1124/QQMusicApi/commit/79af2704002f53f29024eb0aabd82d9917b798d4)) by [@L-1124](https://github.com/L-1124)
+* **(song)** 迁移 SongApi 端点至 @cgi_endpoint 并更新 Web 路由 ([8c08868](https://github.com/L-1124/QQMusicApi/commit/8c08868cd72c633ac023635fcf4f28c58a25576d)) by [@L-1124](https://github.com/L-1124)
+* **(songlist)** 迁移 SonglistApi 端点至 @cgi_endpoint 并更新 Web 路由 ([ba50d18](https://github.com/L-1124/QQMusicApi/commit/ba50d1864e69d91e6ce896cf47085745e93bed7a)) by [@L-1124](https://github.com/L-1124)
+* **(top)** 迁移 TopApi 端点至 @cgi_endpoint 并更新 Web 路由 ([e2a1fee](https://github.com/L-1124/QQMusicApi/commit/e2a1fee9c7a3d5193a3b2a37b6f6b4a6bf5348de)) by [@L-1124](https://github.com/L-1124)
+* **(user)** 迁移 UserApi 端点至 @cgi_endpoint 并更新 Web 路由 ([49921f6](https://github.com/L-1124/QQMusicApi/commit/49921f600cb9ede33990bffa1d85ef502c985896)) by [@L-1124](https://github.com/L-1124)
+* **(web)** [**breaking**] 优化 web 端参数声明，减少冗余 ([ba95861](https://github.com/L-1124/QQMusicApi/commit/ba95861ee9391f5b5f60f89caa8d4de4af160c8b)) by [@L-1124](https://github.com/L-1124)
+* **(web)** 在路由注册器中增加 Web 模块白名单校验 ([9b0bc65](https://github.com/L-1124/QQMusicApi/commit/9b0bc6590ab597db25b5da378298dfd2a6817881)) by [@L-1124](https://github.com/L-1124)
+
+### 性能优化
+
+* **(qimei)** 优化设备特征计算与静态参数缓存 ([e19fdf2](https://github.com/L-1124/QQMusicApi/commit/e19fdf2f2e8f25a2b3bb24c03b7db16b90a832f6)) by [@L-1124](https://github.com/L-1124)
+
+### 文档更新
+
+* **(coding)** 补充声明式端点撰写指南并更新架构概览与调用流程 ([866bffb](https://github.com/L-1124/QQMusicApi/commit/866bffb6b20ef37ba81b36c7476164f9a8b8e556)) by [@L-1124](https://github.com/L-1124)
+* **(examples)** 新增音响力查询与听歌时长上报示例 ([a408059](https://github.com/L-1124/QQMusicApi/commit/a40805982fd53c2db45db1e878aa9ab6934141af)) by [@L-1124](https://github.com/L-1124)
+
+### 贡献者
+
+* @L-1124
+* @github-actions[bot]
+
 ## [[0.7.3](https://github.com/L-1124/QQMusicApi/compare/v0.7.2..v0.7.3)] - 2026-09-13
 
 ### Bug 修复

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/docs/tutorial/credential.md

@@ -40,7 +40,7 @@ asyncio.run(main())
 
 ## 单次请求覆盖
 
-如果你不想把凭证绑定到整个 `Client`，需要 `Crential` 的接口都支持使用 `credential` 参数进行单次请求覆盖。
+如果你不想把凭证绑定到整个 `Client`，需要登录态的接口都支持使用 `credential` 参数进行单次请求覆盖。
 
 ```python
 import asyncio
@@ -76,7 +76,7 @@ async def main() -> None:
             refresh_token="xxx",
             access_token="xxx",
         )
-        await credential.refresh(client)
+        credential = await client.login.refresh_credential(credential)
         print(credential.musicid, credential.musickey)
 
 asyncio.run(main())

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/docs/tutorial/web.md

@@ -1,11 +1,11 @@
-# Web 服务
+# QQMusic API Web 服务
 
 Web 服务将 QQMusicApi 暴露为 HTTP API。
 
 ## 1. 安装
 
 ```bash
-git clone https://github.com/luren-dc/QQMusicApi
+git clone https://github.com/L-1124/QQMusicApi
 cd QQMusicApi
 uv sync --group web
 ```
@@ -15,12 +15,12 @@ uv sync --group web
 ## 2. 启动服务
 
 ```bash
-uv run python web/run.py
+uv run --no-sync web/run.py
 ```
 
 ## 3. 查看 API 文档
 
-打开 [http://localhost:8000/docs](http://localhost:8000/docs) 可以查看所有可用接口。
+默认监听 `127.0.0.1:8080`。打开 [http://localhost:8080/docs](http://localhost:8080/docs) 可以查看所有可用接口，Swagger UI 与 ReDoc 分别位于 `/swagger` 与 `/redoc`。
 
 ## 4. 认证方式
 

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/qqmusic_api/__init__.py

@@ -23,7 +23,7 @@ from .core.exceptions import (
 from .core.versioning import Platform
 from .models.request import Credential
 
-__version__ = "0.8.0"
+__version__ = "0.8.1"
 
 __all__ = [
     "ApiDataError",

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/qqmusic_api/core/executor.py

@@ -126,7 +126,7 @@ class CgiExecutor:
                     results[call.index] = exc
                     continue
                 raise
-            if request.require_login and not bool(call.scope.credential.musicid and call.scope.credential.musickey):
+            if request.require_login and not call.scope.credential.is_valid():
                 exc = CredentialInvalidError("请求需要登录, 未提供有效的登录凭证")
                 if return_exceptions:
                     results[call.index] = exc

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/qqmusic_api/core/transport.py

@@ -11,7 +11,13 @@ from niquests import AsyncSession, AsyncTokenBucketLimiter, RetryConfiguration
 from niquests import PreparedRequest as NiquestsPreparedRequest
 from niquests.exceptions import RequestException, Timeout
 from niquests.models import Response
-from niquests.typing import AsyncHookType, ProxyType, TLSClientCertType, TLSVerifyType
+from niquests.typing import (
+    AsyncHookType,
+    ProxyType,
+    TimeoutType,
+    TLSClientCertType,
+    TLSVerifyType,
+)
 
 from .exceptions import NetworkError, TimeoutNetworkError
 
@@ -321,6 +327,7 @@ class NiquestsTransport:
         rate: float = 10,
         capacity: float = 50,
         connect_retries: int = 2,
+        timeout: TimeoutType = (10, 60),
         proxies: ProxyType | None = None,
         cert: TLSClientCertType | None = None,
         verify: TLSVerifyType | None = None,
@@ -350,6 +357,7 @@ class NiquestsTransport:
         self.cert = cert
         self.verify = verify
         self.hooks = hooks
+        self.timeout = timeout
         self._max_concurrency = max_concurrency
         self._capacity = _CapacityLimiter(max_concurrency)
         self._closed = False
@@ -406,10 +414,12 @@ class NiquestsTransport:
         try:
             for position, request in enumerate(chunk):
                 try:
+                    kwargs = dict(request.kwargs)
+                    kwargs.setdefault("timeout", self.timeout)
                     response = await self._client.request(
                         request.method,
                         request.url,
-                        **dict(request.kwargs),
+                        **kwargs,
                         proxies=self.proxies,
                         hooks=self.hooks,
                         cert=self.cert,
@@ -480,10 +490,12 @@ class NiquestsTransport:
         response: Response | None = None
         try:
             try:
+                stream_kwargs = dict(request.kwargs)
+                stream_kwargs.setdefault("timeout", self.timeout)
                 response = await self._client.request(
                     request.method,
                     request.url,
-                    **dict(request.kwargs),
+                    **stream_kwargs,
                     stream=True,
                     proxies=self.proxies,
                     hooks=self.hooks,

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/qqmusic_api/models/request.py

@@ -118,6 +118,10 @@ class Credential(BaseModel):
         current_time = int(time.time())
         return current_time >= self.musickey_create_time + self.key_expires_in
 
+    def is_valid(self) -> bool:
+        """检查凭据是否包含可用登录态 (musicid 与 musickey 均有效)."""
+        return self.musicid > 0 and bool(self.musickey)
+
 
 class RequestItem(TypedDict):
     """请求项."""

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/qqmusic_api/modules/user.py

@@ -44,7 +44,7 @@ class UserApi(ApiModule):
         if credential is not None:
             return credential
         current = self._executor.credential
-        if current.musicid and current.musickey:
+        if current.is_valid():
             return current
         return self.PLACEHOLDER_CREDENTIAL
 

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/web/src/app.py

@@ -8,6 +8,7 @@ from time import perf_counter
 from typing import Any
 
 from fastapi import FastAPI, HTTPException, Request
+from fastapi.encoders import jsonable_encoder
 from fastapi.exceptions import RequestValidationError
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.responses import HTMLResponse, JSONResponse
@@ -241,6 +242,7 @@ def create_app() -> FastAPI:
         return error_response(
             status_code=422,
             msg="请求参数校验失败",
+            data={"errors": jsonable_encoder(exc.errors())},
         )
 
     @app.get("/", include_in_schema=False)

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/web/src/core/auth.py

@@ -9,7 +9,6 @@ from qqmusic_api import Credential, Platform
 from qqmusic_api.core.engine import RequestEngine
 
 from .credential_pool import CallerCredential, ResolvedCredential
-from .credential_store import credential_has_login
 from .deps import get_credential_config, get_credential_pool
 
 logger = logging.getLogger(__name__)
@@ -34,10 +33,9 @@ async def configured_credential_for_api(
     Returns:
         调用方 Cookie 来源的凭证, 或共享凭证池来源的凭证; 只有后者允许写回共享池.
     """
-    if credential_has_login(cookie_credential):
+    if cookie_credential.is_valid():
         logger.debug("API %s 使用 Cookie 凭证 (musicid: %s)", api_key, cookie_credential.musicid)
         return CallerCredential(credential=cookie_credential)
-
     credential_config = get_credential_config(request)
     if credential_config is None or not credential_config.api_enabled(api_key):
         logger.debug("API %s 未启用全局默认凭证或配置不存在", api_key)

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/web/src/core/config.py

@@ -149,7 +149,7 @@ class AccountConfig(BaseModel):
         merged.update({key: value for key, value in data.items() if key not in {"credential", "credential_json"}})
         return merged
 
-    def has_login(self) -> bool:
+    def is_valid(self) -> bool:
         """判断是否包含可用登录凭证."""
         return self.musicid > 0 and bool(self.musickey)
 

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/web/src/core/credential_pool.py

@@ -19,7 +19,7 @@ from qqmusic_api.core.engine import RequestEngine, RequestScope, ScopedRequestEx
 from qqmusic_api.modules.login import LoginApi
 
 from .config import AccountConfig
-from .credential_store import CredentialStore, credential_has_login, credential_needs_refresh
+from .credential_store import CredentialStore, credential_needs_refresh
 
 logger = logging.getLogger(__name__)
 
@@ -192,7 +192,7 @@ class CredentialPool:
         async def _check_one(musicid: int) -> None:
             async with semaphore:
                 credential = await run_sync(self._store.get, musicid)
-                if credential is None or not credential_has_login(credential):
+                if credential is None or not credential.is_valid():
                     logger.warning("启动检查: 凭证 %s 不可用, 标记为无效", musicid)
                     await run_sync(self._store.mark_invalid_row, musicid)
                     return

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/web/src/core/credential_store.py

@@ -58,7 +58,7 @@ class CredentialStore:
         """同步账号种子到状态库."""
         with self._lock:
             connection = self._connect()
-            valid_accounts = [account for account in accounts if account.has_login()]
+            valid_accounts = [account for account in accounts if account.is_valid()]
             toml_ids = {account.musicid for account in valid_accounts}
 
             logger.info("同步账号种子: 总计 %d 个有效账号", len(valid_accounts))
@@ -93,7 +93,7 @@ class CredentialStore:
         credentials: list[Credential] = []
         for json_str in json_strings:
             credential = _load_credential(json_str)
-            if credential is not None and credential_has_login(credential):
+            if credential is not None and credential.is_valid():
                 credentials.append(credential)
         return credentials
 
@@ -112,7 +112,7 @@ class CredentialStore:
             logger.debug("凭证不存在: musicid %s", musicid)
             return None
         credential = _load_credential(row[0])
-        if credential is None or not credential_has_login(credential):
+        if credential is None or not credential.is_valid():
             logger.debug("凭证无效或缺少登录信息: musicid %s", musicid)
             return None
         logger.debug("凭证获取成功: musicid %s", musicid)
@@ -124,7 +124,7 @@ class CredentialStore:
         Note:
             该入口用于独立写入单行; ``sync_accounts`` 走单事务批量路径, 直接复用内部 ``_upsert``.
         """
-        if not credential_has_login(credential):
+        if not credential.is_valid():
             raise ValueError("Credential 缺少 musicid 或 musickey")
         logger.debug("写入账号种子: musicid %s", credential.musicid)
         with self._lock:
@@ -138,7 +138,7 @@ class CredentialStore:
         Returns:
             是否命中已有行; 未命中时返回 False 且不产生任何写入.
         """
-        if not credential_has_login(credential):
+        if not credential.is_valid():
             raise ValueError("Credential 缺少 musicid 或 musickey")
         with self._lock:
             connection = self._connect()
@@ -254,11 +254,6 @@ def credential_needs_refresh(credential: Credential) -> bool:
     return False
 
 
-def credential_has_login(credential: Credential) -> bool:
-    """判断 Credential 是否包含可用登录凭证."""
-    return credential.musicid > 0 and bool(credential.musickey)
-
-
 def _load_credential(value: str) -> Credential | None:
     try:
         return Credential.model_validate_json(value)

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/web/src/core/response.py

@@ -1,6 +1,6 @@
 """Web API 标准响应结构."""
 
-from typing import Generic, TypeVar
+from typing import Any, Generic, TypeVar
 
 from fastapi.responses import JSONResponse
 from pydantic import BaseModel, Field
@@ -21,6 +21,7 @@ class ErrorResponse(BaseModel):
 
     code: int = Field(default=-1, description="状态码, 错误时为 -1.")
     msg: str = Field(description="错误说明.")
+    data: Any = Field(default=None, description="错误详情 (如参数校验失败明细), 无详情时为 null.")
 
 
 def success_response(data: T) -> ApiResponse[T]:
@@ -32,7 +33,12 @@ def error_response(
     *,
     status_code: int,
     msg: str,
+    data: Any = None,
     headers: dict[str, str] | None = None,
 ) -> JSONResponse:
     """构造标准错误响应."""
-    return JSONResponse(status_code=status_code, content=ErrorResponse(msg=msg).model_dump(), headers=headers)
+    return JSONResponse(
+        status_code=status_code,
+        content=ErrorResponse(msg=msg, data=data).model_dump(exclude_none=True),
+        headers=headers,
+    )

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/web/src/routes/login.py

@@ -8,7 +8,7 @@ from ..modules.login import (
     QRCodeStatusData,
     WebQRLoginType,
 )
-from ..routing.route_types import AuthPolicy, WebRoute
+from ..routing.route_types import AuthPolicy, HttpMethod, WebRoute
 from ._helpers import P, Q, R
 
 ROUTES: tuple[WebRoute, ...] = (
@@ -48,6 +48,7 @@ ROUTES: tuple[WebRoute, ...] = (
         "phone_authcode",
         "/login/phone/authcode",
         PhoneAuthCodeData,
+        methods=(HttpMethod.POST,),
         params=(
             Q("phone", int | None, None, "明文手机号."),
             Q("encrypted_phone", str | None, None, "加密手机号."),
@@ -59,6 +60,7 @@ ROUTES: tuple[WebRoute, ...] = (
         "phone_authorize",
         "/login/phone/authorize",
         Credential,
+        methods=(HttpMethod.POST,),
         params=(
             Q("auth_code", str, description="短信验证码 (字符串, 保留前导零)."),
             Q("phone", int | None, None, "明文手机号."),

{qqmusic_api_python-0.8.0 → qqmusic_api_python-0.8.1}/web/src/routing/executor.py

@@ -24,7 +24,6 @@ from ..core.cache import (
 )
 from ..core.coalesce import Coalescer, Flight
 from ..core.credential_pool import CredentialPool, PoolCredential, ResolvedCredential
-from ..core.credential_store import credential_has_login
 from ..core.deps import get_cache_config, get_coalescer, get_credential_pool
 from ..core.error_mapping import HTTP_ERROR_MESSAGES, api_exception_status_code, is_upstream_failure
 from ..core.response import ApiResponse, error_response, success_response
@@ -235,7 +234,7 @@ async def _resolve_credential(context: RouteContext, *, strict: bool = True) ->
         cookie_credential,
         platform=context.platform,
     )
-    if not credential_has_login(resolved.credential):
+    if not resolved.credential.is_valid():
         if strict:
             logger.error("凭证解析失败: 无有效登录凭证")
             raise HTTPException(status_code=401, detail="未提供有效的登录凭证")