quantdb-sdk 0.4.2__tar.gz → 0.4.4__tar.gz

{quantdb_sdk-0.4.2 → quantdb_sdk-0.4.4}/CHANGELOG.md

@@ -3,6 +3,30 @@
 所有 notable 变更都会记录在此文件。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## \[0.4.4] - 2026-10-11
+
+### Fixed
+
+- **`get_usage()` / `a_get_usage()` 漏算流量包额度**：旧实现用 `remaining = traffic_limit + credit_limit + purchased_traffic - used_traffic`，**完全没算流量包**，导致持有流量包的用户剩余流量被低估（少报的量正好等于流量包余额），`is_active` 也会在仍有流量包可用时被误判为 `False`。
+
+  修正后的口径与后端下载预扣一致：可用总额度 = 套餐额度（`traffic_limit + credit_limit + purchased_traffic`）+ 流量包总额；可用剩余 = (套餐额度 − 已用) + 流量包剩余。因用量接口返回的 `package_traffic` 是流量包**剩余量**，总额从 `GET /api/v1/subscription/traffic-packages` 台账累加；台账接口不可用时退化为「总额 = 剩余」，保证 `get_usage()` 在旧版服务端上依然可用。
+
+### Added
+
+- **`get_usage()` / `a_get_usage()` 新增额度明细字段**（原有字段全部保留，取值已修正）：
+  - 合计：`total_gb` / `used_gb` / `remaining_gb`
+  - 套餐额度：`plan_total_gb` / `plan_used_gb` / `plan_remaining_gb`
+  - 流量包额度：`package_total_gb` / `package_used_gb` / `package_remaining_gb`
+- **`quantdb usage` CLI** 改为分行展示套餐 / 流量包 / 合计的已用、总额与剩余，不再只显示一个总额。
+
+## \[0.4.3] - 2026-10-05
+
+### Changed
+
+- **`per_share` 数据集更名**：中文名由「每股指标（补充）」改为「**财务指标（TTM）**」，描述与关键词同步更新（`每股/eps` → `财务/ttm`）。
+
+  该表实际为 **TTM 口径财务指标补充表**（营收 / 归母净利 / 扣非净利 / 经营现金流等），原名既与 `pershare_index`「每股指标」混淆，也不符合数据口径。与后端 MCP catalog、桌面端分类表保持一致；`per_share` 标识符不变，`client.data` 用法不受影响。
+
 ## \[0.4.2] - 2026-10-05
 
 ### Added

{quantdb_sdk-0.4.2/quantdb_sdk.egg-info → quantdb_sdk-0.4.4}/PKG-INFO

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

{quantdb_sdk-0.4.2 → quantdb_sdk-0.4.4}/pyproject.toml

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

{quantdb_sdk-0.4.2 → quantdb_sdk-0.4.4}/quantdb_sdk/__init__.py

@@ -5,7 +5,7 @@ try:
     # 注意：此处用 PyPI 包名（连字符）查找版本号，不是模块名（下划线）
     __version__ = version("quantdb-sdk")
 except ImportError:
-    __version__ = "0.4.2"
+    __version__ = "0.4.4"
 
 from . import layout
 from ._utils import scan_local_directory

{quantdb_sdk-0.4.2 → quantdb_sdk-0.4.4}/quantdb_sdk/__main__.py

@@ -135,9 +135,12 @@ def main() -> int:
         if args.command == "usage":
             usage = client.get_usage()
             print(f"账户用量:")
-            print(f"  已用: {usage['used_gb']:.2f} GB")
-            print(f"  限额: {usage['limit_gb']:.1f} GB")
-            print(f"  剩余: {usage['remaining_gb']:.2f} GB")
+            print(f"  套餐:   已用 {usage['plan_used_gb']:.2f} GB / {usage['plan_total_gb']:.2f} GB"
+                  f"（剩余 {usage['plan_remaining_gb']:.2f} GB）")
+            print(f"  流量包: 已用 {usage['package_used_gb']:.2f} GB / {usage['package_total_gb']:.2f} GB"
+                  f"（剩余 {usage['package_remaining_gb']:.2f} GB）")
+            print(f"  合计:   已用 {usage['used_gb']:.2f} GB / {usage['total_gb']:.2f} GB"
+                  f"（剩余 {usage['remaining_gb']:.2f} GB）")
             print(f"  余额: ¥{usage['balance_yuan']:.2f}")
             sub = usage.get("subscription", {})
             print(f"  订阅: {sub.get('status', 'none')}")