Add Chinese comments for Temporal workflow flow

This commit is contained in:
Codex
2026-03-27 00:13:54 +08:00
parent cc03da8a94
commit d02fc8565f
7 changed files with 205 additions and 49 deletions

View File

@@ -1,4 +1,8 @@
"""Temporal client helpers."""
"""Temporal client 辅助函数。
API 和 worker 都需要连接 Temporal Server。
这里做了一个简单的单例缓存,避免重复建立连接。
"""
import asyncio
@@ -11,13 +15,17 @@ _client_lock = asyncio.Lock()
async def get_temporal_client() -> Client:
"""Return a cached Temporal client."""
"""返回缓存后的 Temporal Client
第一次调用时才真正连接 Temporal后续复用同一个 client。
"""
global _client
if _client is not None:
return _client
async with _client_lock:
# 双重检查,避免并发场景下重复 connect。
if _client is None:
settings = get_settings()
_client = await Client.connect(
@@ -28,8 +36,10 @@ async def get_temporal_client() -> Client:
def set_temporal_client(client: Client | None) -> None:
"""Override the cached Temporal client, primarily for tests."""
"""覆盖缓存的 Temporal Client
主要用于测试场景,把真实连接替换成 Temporal 测试环境里的 client。
"""
global _client
_client = client