sdpy-kit 0.7.2__tar.gz → 0.7.3__tar.gz

{sdpy_kit-0.7.2 → sdpy_kit-0.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sdpy-kit
-Version: 0.7.2
+Version: 0.7.3
 Summary: SDPY Kit——统一数据库访问层（PG/MySQL/SQLite）与 AI/Redis/文件/文档/向量工具集
 Author-email: Clark <changhongyuan@126.com>
 License-Expression: MIT
@@ -885,7 +885,8 @@ with AI.chat_stream([{"role": "user", "content": "写一首短诗"}]) as stream:
 | `no_finish` | 结束原因缺失或非 `stop`（端点未发送 `finish_reason`） | 可原样重试；连续出现检查端点 |
 | `stopped_empty` | 无推理、`finish_reason=stop`、正文 0 | 检查提示词与模型输出 |
 
-正文非空时 `empty_kind is None`。判定只用「是否截断 + 是否有推理 + 结束原因」，不依赖 token 数（kit 目前不采集 `usage`）：
+正文非空时 `empty_kind is None`。判定只用「是否截断 + 是否有推理 + 结束原因」，不依赖 token 数（kit 目前不采集 `usage`）。
+注意：该属性**仅在流正常结束后可读**，迭代中与异常 / 中断后为 `None`（避免把「正文还没到」误判成 `no_finish`）；`requested_max_tokens` 无此限制。
 
 ```python
 with AI.chat_stream(messages, max_tokens=450) as stream:

{sdpy_kit-0.7.2 → sdpy_kit-0.7.3}/README.md

@@ -803,7 +803,8 @@ with AI.chat_stream([{"role": "user", "content": "写一首短诗"}]) as stream:
 | `no_finish` | 结束原因缺失或非 `stop`（端点未发送 `finish_reason`） | 可原样重试；连续出现检查端点 |
 | `stopped_empty` | 无推理、`finish_reason=stop`、正文 0 | 检查提示词与模型输出 |
 
-正文非空时 `empty_kind is None`。判定只用「是否截断 + 是否有推理 + 结束原因」，不依赖 token 数（kit 目前不采集 `usage`）：
+正文非空时 `empty_kind is None`。判定只用「是否截断 + 是否有推理 + 结束原因」，不依赖 token 数（kit 目前不采集 `usage`）。
+注意：该属性**仅在流正常结束后可读**，迭代中与异常 / 中断后为 `None`（避免把「正文还没到」误判成 `no_finish`）；`requested_max_tokens` 无此限制。
 
 ```python
 with AI.chat_stream(messages, max_tokens=450) as stream:

{sdpy_kit-0.7.2 → sdpy_kit-0.7.3}/kit/__init__.py

@@ -23,7 +23,7 @@ Author: Clark Chang
 数据库访问通过 kit.db 子包提供（基于 SQLModel）。
 """
 
-__version__ = "0.7.2"
+__version__ = "0.7.3"
 
 from kit.db import (
     MYSQL,

{sdpy_kit-0.7.2 → sdpy_kit-0.7.3}/kit/ai/runner.py

@@ -846,10 +846,14 @@ class _StreamIterator:
     直接 ``for`` 中途 ``break`` 或迭代器被 GC，``close``/``__del__`` 也会
     兜底取消后台 producer，避免任务残留。
 
-    流结束后可读 ``reasoning_chars`` / ``content_chars`` / ``finish_reason`` /
-    ``truncated`` / ``thinking_applied`` / ``json_mode_applied`` 六个只读属性
-    （跨线程共享同一累加器：结束后为最终值，流式过程中为尽力而为的中间值；
-    提前 ``break`` 时为截至中断的累计值）。
+    流结束后可读八个只读属性：``reasoning_chars`` / ``content_chars`` /
+    ``finish_reason`` / ``requested_max_tokens`` / ``truncated`` / ``empty_kind`` /
+    ``thinking_applied`` / ``json_mode_applied``（跨线程共享同一累加器：
+    结束后为最终值，流式过程中为尽力而为的中间值；提前 ``break`` 时为截至
+    中断的累计值）。
+
+    ``empty_kind`` 例外：**仅在流正常结束后可读**，迭代中与异常 / 中断后
+    恒为 ``None``（避免把「正文还没到」误判成 ``no_finish``）。
     """
 
     def __init__(
@@ -871,6 +875,8 @@ class _StreamIterator:
         self._started = False
         self._closed = False
         self._got_first = False
+        # 正常收尾（收到哨兵）才置真：empty_kind 只在结束后给结论
+        self._exhausted = False
         self._task: concurrent.futures.Future[None] | None = None
 
     def __iter__(self) -> Iterator[str]:
@@ -931,6 +937,7 @@ class _StreamIterator:
                 f"流式帧间隔超过 {_STREAM_FRAME_INTERVAL_TIMEOUT:g}s 未收到新帧"
             ) from exc
         if item is _SENTINEL:
+            self._exhausted = True
             self.close()
             raise StopIteration
         if isinstance(item, BaseException):
@@ -971,6 +978,27 @@ class _StreamIterator:
         """结构化输出是否生效：None 未要求注入 / True 已注入 / False 被忽略。"""
         return self._stats.json_mode_applied
 
+    @property
+    def requested_max_tokens(self) -> int | None:
+        """本次实际下发的输出上限（调用方 → 档案回落）；未发请求为 None。"""
+        return self._stats.requested_max_tokens
+
+    @property
+    def empty_kind(self) -> str | None:
+        """正文为空时的诊断分级；**仅在流正常结束后可读，其余时刻为 None**。
+
+        取值同 ``StreamStats.empty_kind``（``budget_exhausted`` /
+        ``truncated_empty`` / ``reasoning_only`` / ``no_finish`` /
+        ``stopped_empty``；正文非空为 None）。
+
+        迭代中不给中间结论：此时正文尚未产出，``content_chars`` 恒为 0，
+        直接转发会把「还没出正文」误报成 ``no_finish``；异常 / 中途 ``break``
+        同理不置收尾标志。
+        """
+        if not self._exhausted:
+            return None
+        return self._stats.empty_kind
+
 
 async def _delayed_close(services: list[Service]) -> None:
     """延迟回收旧 service：给在途调用留宽限期，到期统一关闭（须在 loop 内）。"""