sycommon-python-lib 0.2.7a34__tar.gz → 0.2.7a36__tar.gz

{sycommon_python_lib-0.2.7a34 → sycommon_python_lib-0.2.7a36}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.7a34
+Version: 0.2.7a36
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{sycommon_python_lib-0.2.7a34 → sycommon_python_lib-0.2.7a36}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sycommon-python-lib"
-version = "0.2.7a34"
+version = "0.2.7a36"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.11"

{sycommon_python_lib-0.2.7a34 → sycommon_python_lib-0.2.7a36}/src/sycommon/agent/deep_agent.py

@@ -50,7 +50,6 @@ from langchain_core.messages import HumanMessage, BaseMessage, AIMessageChunk, A
 from langchain_core.tools import BaseTool, tool
 
 from sycommon.logging.kafka_log import SYLogger
-from sycommon.tools.snowflake import Snowflake
 from sycommon.tools.env import check_env_flag
 from sycommon.llm.get_llm import get_llm
 from sycommon.agent.sandbox.http_sandbox_backend import HTTPSandboxBackend
@@ -506,8 +505,10 @@ class DeepAgent:
         total_output_tokens = 0
 
         # ── 设置 chat turn 级 trace_id ──
-        # 如果上层（HTTP 中间件等）已设置 trace_id 则沿用，否则生成新的
-        _chat_trace_id = SYLogger.get_trace_id() or str(Snowflake.id)
+        # 如果上层（HTTP 中间件等）已设置 trace_id 则沿用，否则生成新的。
+        # 生命周期由下面 try/finally 的 reset 管理（本生成器有 CancelledError/Exception
+        # 处理，不能直接用 with trace_context()）。
+        _chat_trace_id = SYLogger.get_trace_id() or SYLogger.new_trace_id()
         _trace_token = SYLogger.set_trace_id(_chat_trace_id)
 
         try:
@@ -961,12 +962,35 @@ class DeepAgent:
                 print(
                     f"[DeepAgent] FOR LOOP ENDED. stream_step={stream_step}, ai_text_content={repr(ai_text_content[:100])}, tool_calls={len(current_tool_calls)}", flush=True)
 
-            # 空响应检测：模型被调用但没有产出任何文本
-            if not ai_text_content and not ai_chunk_buffer:
+            # 空响应检测：模型被调用但没有产出任何文本。
+            # 🔑 治本修复：纯空响应（无文本且无工具调用，常见于用户派生 key 被网关拒、
+            # 网关返回空壳 AIMessage 而非异常）不再静默只打 warning —— 把它翻译成
+            # EventType.ERROR 事件 yield 出去，让上层（wecom _stream_agent_response /
+            # web stream_chat 的三级降级链 derived→global_key→internal）能据此触发降级重试，
+            # 而不是把整轮当成正常完成、最终给用户一个空气泡。
+            # 仍保留「有工具调用但无文本」的旧静默行为：那是正常的纯工具调用流（工具产出后
+            # 通常还有下一轮 AI 文本），不应误判为错误。
+            if not ai_text_content and not ai_chunk_buffer and not current_tool_calls:
                 SYLogger.warning(
-                    f"[DeepAgent] 空响应警告：模型未返回任何文本内容。"
+                    f"[DeepAgent] 空响应警告：模型未返回任何文本内容，转为 error 事件以触发上层降级。"
                     f"stream_step={stream_step}, tool_calls={len(current_tool_calls)}, "
                     f"input_tokens={total_input_tokens}, output_tokens={total_output_tokens}")
+                event = ChatEventBuilder.error(
+                    "模型返回空响应（empty response，可能是网关鉴权失败或上游异常）",
+                    code="empty_response",
+                )
+                if on_event:
+                    await on_event(event)
+                yield event
+                event = ChatEventBuilder.done()
+                event.data["trace_id"] = _chat_trace_id
+                if total_input_tokens > 0 or total_output_tokens > 0:
+                    event.data["input_tokens"] = total_input_tokens
+                    event.data["output_tokens"] = total_output_tokens
+                if on_event:
+                    await on_event(event)
+                yield event
+                return
 
             # 兜底：如果 middleware 没有成功记录（流式场景），在这里补充记录
             if total_input_tokens > 0 or total_output_tokens > 0:
@@ -993,18 +1017,17 @@ class DeepAgent:
             yield event
 
         except asyncio.CancelledError:
-            print("[DeepAgent] chat() CancelledError!", flush=True)
+            # 取消是正常控制流（用户停止 / 新消息中断本轮），info 级即可。
+            SYLogger.info("[DeepAgent] chat() 已取消")
             event = ChatEventBuilder.cancelled("任务已取消")
             if on_event:
                 await on_event(event)
             yield event
             raise
         except Exception as e:
-            print(
-                f"[DeepAgent] chat() Exception: {type(e).__name__}: {e}", flush=True)
-            import traceback
-            traceback.print_exc()
-            SYLogger.error(f"[DeepAgent] 聊天异常: {e}")
+            # ERROR 级在 except 块内会自动把 traceback 写进 Kafka detail 字段，
+            # 无需再 print + traceback.print_exc()。
+            SYLogger.error(f"[DeepAgent] 聊天异常: {type(e).__name__}: {e}")
             event = ChatEventBuilder.error(str(e))
             if on_event:
                 await on_event(event)

{sycommon_python_lib-0.2.7a34 → sycommon_python_lib-0.2.7a36}/src/sycommon/agent/multi_agent_team.py

@@ -37,7 +37,6 @@ from langchain_core.messages import HumanMessage, BaseMessage
 from langchain_core.tools import BaseTool, tool
 
 from sycommon.logging.kafka_log import SYLogger
-from sycommon.tools.snowflake import Snowflake
 from sycommon.llm.get_llm import get_llm
 from sycommon.agent.sandbox.http_sandbox_backend import HTTPSandboxBackend
 from sycommon.tools.env import get_env_var
@@ -253,7 +252,8 @@ class MultiAgentTeam:
         seen_tool_call_ids = set()  # 去重：流式分片中同一 tool_call 多次到达
 
         # ── 设置 chat turn 级 trace_id ──
-        _chat_trace_id = SYLogger.get_trace_id() or str(Snowflake.id)
+        # 上层（HTTP 中间件 / 企微装饰器 / 定时任务）已 set 则沿用，否则新建。
+        _chat_trace_id = SYLogger.get_trace_id() or SYLogger.new_trace_id()
         _trace_token = SYLogger.set_trace_id(_chat_trace_id)
 
         try:

{sycommon_python_lib-0.2.7a34 → sycommon_python_lib-0.2.7a36}/src/sycommon/auth/wecom_ldap_service.py

@@ -99,7 +99,11 @@ class _LDAPIndex:
         self.by_en_sn: Dict[str, List[LDAPFullUser]] = defaultdict(list)
 
     def build(self, users: List[dict]):
-        """从 LDAP 查询结果构建索引"""
+        """从 LDAP 查询结果构建索引
+
+        所有索引 key 一律小写化，确保大小写不敏感匹配。
+        同一 key 多次出现（如两个 "Maggie Tang" 拼音相同）时保留多候选。
+        """
         self.by_cn.clear()
         self.by_sam_prefix.clear()
         self.by_en_sn.clear()
@@ -126,13 +130,14 @@ class _LDAPIndex:
                 dn=dn or None,
                 ou_chain=ou_chain,
             )
-            self.by_cn[cn] = ldap_user
+            # 中文名 key 小写化
+            self.by_cn[cn.lower()] = ldap_user
 
-            # sAMAccountName 如 "sussie.xia" -> 前缀 "sussie"
+            # sAMAccountName 如 "sussie.xia" -> 前缀 "sussie"（小写）
             prefix = sam.split(".")[0].lower()
             self.by_sam_prefix[prefix].append(ldap_user)
 
-            # 英文名+姓(拼音)索引: "sussie.xiao"
+            # 英文名+姓(拼音)索引: "sussie.xiao"（小写）
             sn = u.get("sn", "").strip()
             if prefix and sn:
                 sn_pinyin = self._to_pinyin(sn)
@@ -149,7 +154,7 @@ class _LDAPIndex:
             return ""
 
     def lookup(self, chinese_name: str, english_name: str = "", surname: str = "", position: str = "") -> tuple:
-        """查找匹配的 LDAP 用户
+        """查找匹配的 LDAP 用户（大小写不敏感）
 
         Args:
             chinese_name: 中文名（企微 name）
@@ -159,9 +164,9 @@ class _LDAPIndex:
         Returns:
             (LDAPFullUser | None, match_method | None)
         """
-        # 第一优先级：中文名直接匹配
-        if chinese_name in self.by_cn:
-            return self.by_cn[chinese_name], "chinese_name"
+        # 第一优先级：中文名直接匹配（小写化比较）
+        if chinese_name.lower() in self.by_cn:
+            return self.by_cn[chinese_name.lower()], "chinese_name"
 
         en_first = english_name.lower().split()[0] if english_name else ""
 

{sycommon_python_lib-0.2.7a34 → sycommon_python_lib-0.2.7a36}/src/sycommon/logging/kafka_log.py

@@ -7,7 +7,9 @@ import time
 import threading
 import traceback
 import asyncio
+import contextlib
 from datetime import datetime
+from typing import Optional
 
 from kafka import KafkaProducer
 from loguru import logger
@@ -544,6 +546,39 @@ class SYLogger:
         except ValueError:
             pass
 
+    # ── trace_id 生命周期 helper ──────────────────────────────────────────
+    # 解决「生成并 set 一个任务级 trace_id」的重复脚手架：deep_agent / multi_agent_team
+    # 以及各项目的「非 HTTP 入口」（企微长连接、定时任务等）都各自手写 get-or-生成 + set +
+    # finally reset 这套。统一到这两个 helper 后，调用点不再复制粘贴，语义变更（如加前缀）
+    # 只改这里。
+    @staticmethod
+    def new_trace_id() -> str:
+        """生成一个新的 Snowflake trace_id。供需要自己拿到 id（如塞进 event.data）的场景用。"""
+        from sycommon.tools.snowflake import Snowflake
+        return str(Snowflake.id)
+
+    @staticmethod
+    @contextlib.contextmanager
+    def trace_context(trace_id: Optional[str] = None):
+        """任务级 trace_id 上下文管理器：set 一个 trace_id，作用域结束自动 reset。
+
+        - trace_id=None：沿用上层已设的 trace_id，没有则新建一个（与 agent.chat() 的
+          `get_trace_id() or 新建` 语义一致，保证链路沿用而非割裂）。
+        - 传具体 trace_id：强制用该值（如 HTTP 中间件从请求头取到的 trace_id）。
+        - 出作用域自动 reset 到 set 前状态；reset_trace_id 已吞跨 Context 的 ValueError，
+          取消路径（anyio cancel_scope / LangGraph task）下也不会抛。
+
+        典型用法（非 HTTP 入口兜底任务级 trace_id）：
+            with SYLogger.trace_context():
+                await handle_request()   # 内部所有日志带同一 trace_id
+        """
+        tid = trace_id if trace_id is not None else (SYLogger.get_trace_id() or SYLogger.new_trace_id())
+        token = SYLogger.set_trace_id(tid)
+        try:
+            yield tid
+        finally:
+            SYLogger.reset_trace_id(token)
+
     @staticmethod
     def _get_execution_context() -> str:
         try:

{sycommon_python_lib-0.2.7a34 → sycommon_python_lib-0.2.7a36}/src/sycommon_python_lib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.7a34
+Version: 0.2.7a36
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown