quantdb-sdk 0.4.6__tar.gz → 0.4.7__tar.gz

{quantdb_sdk-0.4.6 → quantdb_sdk-0.4.7}/CHANGELOG.md

@@ -3,6 +3,20 @@
 所有 notable 变更都会记录在此文件。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## \[0.4.7] - 2026-10-27
+
+### Fixed
+
+- **适配下载 302 单跳直连**：服务端已取消「一次性下载令牌 + `/api/v1/data/cdn-bridge` 中转」链路，`/api/v1/data/download` 预扣成功后直接 302 到 CDN 签名 URL（单跳）。同步/异步客户端原有的两跳跟随假设已相应调整：
+  - 新增 **CDN 专用裸会话**（`QuantDBClient._cdn_session`）：直连 CDN 时**不携带 API Key / JWT**，避免鉴权头泄露到 CDN 域；同一会话跨文件复用 TLS 连接，避免逐文件新建连接反复握手。
+  - 手动跟随重定向并保留每跳的 connect timeout 重试，网络抖动不会中断整个同步。
+
+### Changed
+
+- 直连 CDN 模式**签发即按对象大小计费、不再退款**（服务端无法观测直连传输的真实字节，退款只能依赖客户端自报，不可信）。需要按真实传输计费、断点续传可退款的用户，应在请求头发送 `X-QuantDB-Delivery: proxy` 走网关代理模式（网关可观测字节并按未发送部分退款）。
+
+> 兼容性：0.4.7 对接 2026-10-27 上线的服务端版本；旧服务端（两跳 cdn-bridge）仍可正常同步，无需回退。
+
 ## \[0.4.6] - 2026-10-27
 
 ### Fixed

{quantdb_sdk-0.4.6/quantdb_sdk.egg-info → quantdb_sdk-0.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quantdb-sdk
-Version: 0.4.6
+Version: 0.4.7
 Summary: QuantDB 量化数据平台官方 Python SDK
 Author: QuantDB Team
 License: MIT

{quantdb_sdk-0.4.6 → quantdb_sdk-0.4.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quantdb-sdk"
-version = "0.4.6"
+version = "0.4.7"
 description = "QuantDB 量化数据平台官方 Python SDK"
 readme = "README.md"
 license = {text = "MIT"}

{quantdb_sdk-0.4.6 → quantdb_sdk-0.4.7}/quantdb_sdk/async_client.py

@@ -28,7 +28,7 @@ from .errors import (
 )
 
 # 维护提示：每次发版必须与 pyproject.toml 版本号同步
-_USER_AGENT = "QuantDB-Python-SDK/0.4.6"
+_USER_AGENT = "QuantDB-Python-SDK/0.4.7"
 
 
 def _etag_hex(value: Optional[str]) -> Optional[str]:
@@ -139,8 +139,8 @@ class AsyncQuantDBClient:
         裸客户端直连 Location，鉴权头不会泄露给 CDN 域。
 
         重定向链路（CDN 直连模式）：
-          /download 302→ /cdn-bridge?token=xxx 302→ https://cdn.xxx/key?sign=...
-        两跳均手动跟随，每跳带重试（connect timeout 网络抖动容错）。
+          /download 302→ https://cdn.xxx/key?sign=...（单跳）
+        手动跟随，每跳带重试（connect timeout 网络抖动容错）。
         """
         async with self.client.stream(
             "GET", f"{self.api_host}/api/v1/data/download", params=params, headers=headers
@@ -166,9 +166,8 @@ class AsyncQuantDBClient:
     ) -> httpx.Response:
         """手动跟随 302 重定向链路，每跳带重试。
 
-        cdn-bridge 和 CDN 直连请求均通过此方法，connect timeout 网络抖动
-        时自动重试，避免一次性 token（90s 有效期）场景下单次抖动导致整个
-        sync 中断。
+        CDN 直连请求通过此方法，connect timeout 网络抖动时自动重试，避免
+        单次抖动导致整个 sync 中断。
 
         返回已进入 stream 模式的 httpx.Response，调用方需用 async with 管理。
         """

{quantdb_sdk-0.4.6 → quantdb_sdk-0.4.7}/quantdb_sdk/client.py

@@ -32,7 +32,7 @@ from .errors import (
 )
 
 # 维护提示：每次发版必须与 pyproject.toml 版本号同步
-_USER_AGENT = "QuantDB-Python-SDK/0.4.6"
+_USER_AGENT = "QuantDB-Python-SDK/0.4.7"
 
 
 def _etag_hex(value: Optional[str]) -> Optional[str]:
@@ -75,6 +75,9 @@ class QuantDBClient:
         self.headers: Dict[str, str] = {}
         self.session = requests.Session()
         self.session.headers.update({"User-Agent": _USER_AGENT})
+        # CDN 直连专用会话：不携带 API Key / JWT，且跨文件复用 TLS 连接（逐文件新建连接会反复握手）。
+        self._cdn_session = requests.Session()
+        self._cdn_session.headers.update({"User-Agent": _USER_AGENT})
 
         if api_key:
             self.headers = {"X-API-Key": api_key}
@@ -168,13 +171,10 @@ class QuantDBClient:
     def _download_stream(self, params: dict, headers: Optional[dict] = None) -> requests.Response:
         """下载专用流式请求：手动处理服务端 302 CDN 直连跳转。
 
-        服务端开启 CDN 直连后，/api/v1/data/download 预扣流量成功时返回
-        302 -> CDN 签名 URL。requests 自动跟随会把自定义 X-API-Key 头
-        透传给 CDN 域，故禁用自动跟随，改用不带鉴权头的裸请求直连。
-
-        重定向链路（CDN 直连模式）：
-          /download 302→ /cdn-bridge?token=xxx 302→ https://cdn.xxx/key?sign=...
-        两跳均手动跟随，每跳带重试（connect timeout 网络抖动容错）。
+        服务端开启 CDN 直连后，/api/v1/data/download 预扣流量成功时直接返回
+        302 -> CDN 签名 URL（单跳）。requests 自动跟随会把自定义 X-API-Key 头
+        透传给 CDN 域，故禁用自动跟随，改用不带鉴权头的 CDN 专用会话直连。
+        每跳带重试（connect timeout 网络抖动容错）。
         """
         resp = self._request(
             "GET", "/api/v1/data/download", params=params, stream=True,
@@ -200,21 +200,15 @@ class QuantDBClient:
     ) -> requests.Response:
         """手动跟随 302 重定向链路，每跳带重试。
 
-        cdn-bridge 和 CDN 直连请求均通过此方法，connect timeout 网络抖动
-        时自动重试，避免一次性 token（90s 有效期）场景下单次抖动导致整个
-        sync 中断。
+        CDN 直连请求通过此方法，connect timeout 网络抖动时自动重试，避免
+        单次抖动导致整个 sync 中断。
         """
         current_etag = etag
         for _ in range(max_hops):
             last_exc = None
             for attempt in range(retries + 1):
                 try:
-                    cdn_resp = requests.get(
-                        url,
-                        stream=True,
-                        timeout=self.timeout,
-                        headers={"User-Agent": _USER_AGENT},
-                    )
+                    cdn_resp = self._cdn_session.get(url, stream=True, timeout=self.timeout)
                     break
                 except (requests.ConnectionError, requests.Timeout) as exc:
                     last_exc = exc

{quantdb_sdk-0.4.6 → quantdb_sdk-0.4.7/quantdb_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quantdb-sdk
-Version: 0.4.6
+Version: 0.4.7
 Summary: QuantDB 量化数据平台官方 Python SDK
 Author: QuantDB Team
 License: MIT