aury-boot 0.0.29__py3-none-any.whl → 0.0.31__py3-none-any.whl

aury/boot/commands/templates/project/aury_docs/17-alerting.md.tpl

@@ -0,0 +1,210 @@
+# 告警系统
+
+本文档介绍 {project_name} 项目中的告警系统配置和使用方法。
+
+## 快速开始（简版配置）
+
+所有告警发送到同一个飞书群：
+
+```bash
+# .env
+ALERT__ENABLED=true
+ALERT__NOTIFIERS__DEFAULT__TYPE=feishu
+ALERT__NOTIFIERS__DEFAULT__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/xxx
+```
+
+框架会自动创建默认规则，检测慢请求、慢 SQL、异常并发送告警。
+
+---
+
+## 完整版配置（分群告警）
+
+不同类型的告警发送到不同的飞书群，避免一个群接收所有消息。
+
+### 1. 环境变量
+
+```bash
+# .env
+
+# ============ 告警系统 ============
+ALERT__ENABLED=true
+ALERT__RULES_FILE=alert_rules.yaml
+
+# 性能群（慢请求、慢SQL）
+ALERT__NOTIFIERS__PERF_GROUP__TYPE=feishu
+ALERT__NOTIFIERS__PERF_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/perf-xxx
+ALERT__NOTIFIERS__PERF_GROUP__SECRET=your-secret  # 可选
+
+# 错误群（异常）
+ALERT__NOTIFIERS__ERROR_GROUP__TYPE=feishu
+ALERT__NOTIFIERS__ERROR_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/error-xxx
+
+# 运维群（任务失败、超时）
+ALERT__NOTIFIERS__OPS_GROUP__TYPE=feishu
+ALERT__NOTIFIERS__OPS_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/ops-xxx
+
+# 慢操作阈值
+ALERT__SLOW_REQUEST_THRESHOLD=1.0
+ALERT__SLOW_SQL_THRESHOLD=0.5
+```
+
+### 2. 规则文件
+
+生成规则模板：`aury docs alert-rules`
+
+```yaml
+# alert_rules.yaml
+defaults:
+  slow_request_threshold: 1.0
+  slow_sql_threshold: 0.5
+  aggregate_window: 10
+  suppress_seconds: 300
+
+rules:
+  # 慢请求 → 性能群
+  - name: slow_request
+    event_types: [slow_request]
+    aggregate_threshold: 5
+    notifiers: [perf_group]
+
+  # 慢 SQL → 性能群
+  - name: slow_sql
+    event_types: [slow_sql]
+    aggregate_threshold: 10
+    notifiers: [perf_group]
+
+  # 异常 → 错误群（立即告警）
+  - name: exception
+    event_types: [exception]
+    aggregate_threshold: 1
+    suppress_seconds: 60
+    notifiers: [error_group]
+
+  # 任务失败/超时 → 运维群
+  - name: task_issues
+    event_types: [task_failure, task_timeout]
+    aggregate_threshold: 1
+    notifiers: [ops_group]
+```
+
+### 3. 效果
+
+| 事件类型 | 目标群 | 触发条件 |
+|---------|--------|----------|
+| 慢请求（>1s） | 性能群 | 60秒内累计5次 |
+| 慢 SQL（>0.5s） | 性能群 | 60秒内累计10次 |
+| 异常 | 错误群 | 立即告警 |
+| 任务失败/超时 | 运维群 | 立即告警 |
+
+---
+
+## 代码中手动发送告警
+
+```python
+from aury.boot.infrastructure.monitoring.alerting import emit_alert, AlertEventType, AlertSeverity
+
+# 发送自定义告警
+await emit_alert(
+    AlertEventType.CUSTOM,
+    "订单支付超时",
+    severity=AlertSeverity.WARNING,
+    order_id="12345",
+    user_id="u001",
+)
+
+# 发送慢 SQL 告警（通常由框架自动触发）
+await emit_alert(
+    AlertEventType.SLOW_SQL,
+    "慢查询告警",
+    duration=2.5,
+    sql="SELECT * FROM orders WHERE ...",
+)
+```
+
+---
+
+## 通知器类型
+
+### 飞书（feishu）
+
+```bash
+ALERT__NOTIFIERS__XXX__TYPE=feishu
+ALERT__NOTIFIERS__XXX__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/xxx
+ALERT__NOTIFIERS__XXX__SECRET=xxx  # 可选，签名密钥
+```
+
+### 通用 Webhook
+
+```bash
+ALERT__NOTIFIERS__XXX__TYPE=webhook
+ALERT__NOTIFIERS__XXX__URL=https://your-system.com/alert
+ALERT__NOTIFIERS__XXX__METHOD=POST
+ALERT__NOTIFIERS__XXX__HEADERS='{{"Authorization": "Bearer xxx"}}'
+```
+
+### 自定义通知器
+
+```python
+from aury.boot.infrastructure.monitoring.alerting import AlertNotifier, AlertManager
+
+class DingTalkNotifier(AlertNotifier):
+    @classmethod
+    def from_config(cls, config: dict) -> "DingTalkNotifier":
+        return cls(webhook=config["webhook"])
+
+    async def send(self, notification) -> bool:
+        # 实现发送逻辑
+        ...
+
+# 注册
+AlertManager.register_notifier_class("dingtalk", DingTalkNotifier)
+```
+
+然后在环境变量中使用：
+
+```bash
+ALERT__NOTIFIERS__DING__TYPE=dingtalk
+ALERT__NOTIFIERS__DING__WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxx
+```
+
+---
+
+## 告警事件类型
+
+| 类型 | 说明 | 自动触发 |
+|-----|------|----------|
+| `slow_request` | 慢 HTTP 请求 | 框架自动检测 |
+| `slow_sql` | 慢 SQL 查询 | 框架自动检测 |
+| `exception` | 异常/错误 | 框架自动检测 |
+| `task_failure` | 任务执行失败 | 任务系统触发 |
+| `task_timeout` | 任务执行超时 | 任务系统触发 |
+| `custom` | 自定义告警 | 手动调用 emit_alert |
+
+---
+
+## 告警抑制与聚合
+
+- **聚合窗口**：在窗口时间内累计触发次数，达到阈值才发送告警
+- **抑制时间**：同一告警在抑制时间内不会重复发送
+- **示例**：`aggregate_window=60, aggregate_threshold=5` 表示 60 秒内触发 5 次才告警
+
+这样可以避免告警风暴，同时不遗漏重要问题。
+
+---
+
+## 环境变量参考
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `ALERT__ENABLED` | 是否启用告警 | `false` |
+| `ALERT__RULES_FILE` | 规则文件路径 | - |
+| `ALERT__SLOW_REQUEST_THRESHOLD` | 慢请求阈值（秒） | `1.0` |
+| `ALERT__SLOW_SQL_THRESHOLD` | 慢 SQL 阈值（秒） | `0.5` |
+| `ALERT__ALERT_ON_SLOW_REQUEST` | 是否对慢请求告警 | `true` |
+| `ALERT__ALERT_ON_SLOW_SQL` | 是否对慢 SQL 告警 | `true` |
+| `ALERT__ALERT_ON_ERROR` | 是否对异常告警 | `true` |
+| `ALERT__AGGREGATE_WINDOW` | 聚合窗口（秒） | `10` |
+| `ALERT__SLOW_REQUEST_AGGREGATE` | 慢请求触发阈值（窗口内次数） | `5` |
+| `ALERT__SLOW_SQL_AGGREGATE` | 慢 SQL 触发阈值 | `10` |
+| `ALERT__EXCEPTION_AGGREGATE` | 异常触发阈值 | `1` |
+| `ALERT__SUPPRESS_SECONDS` | 抑制时间（秒） | `300` |

aury/boot/commands/templates/project/env_templates/messaging.tpl

@@ -2,14 +2,18 @@
 # =============================================================================
 # 流式通道配置 (CHANNEL__) - SSE/实时通信
 # =============================================================================
+# 基于 Broadcaster 库，通过 URL scheme 切换后端
+# 支持: memory:// | redis://host:port/db | kafka://host:port | postgres://...
+#
 # 单实例配置:
-# CHANNEL__BACKEND=memory
-# CHANNEL__BACKEND=redis
-# CHANNEL__URL=redis://localhost:6379/3
+# CHANNEL__BACKEND=broadcaster
+# CHANNEL__URL=memory://
+# 分布式: CHANNEL__URL=redis://localhost:6379/3
 #
 # 多实例配置 (格式: CHANNEL__{{INSTANCE}}__{{FIELD}}):
-# CHANNEL__SSE__BACKEND=memory
-# CHANNEL__NOTIFICATION__BACKEND=redis
+# CHANNEL__SSE__BACKEND=broadcaster
+# CHANNEL__SSE__URL=memory://
+# CHANNEL__NOTIFICATION__BACKEND=broadcaster
 # CHANNEL__NOTIFICATION__URL=redis://localhost:6379/3
 
 # =============================================================================
@@ -32,18 +36,22 @@
 # =============================================================================
 # 事件总线配置 (EVENT__)
 # =============================================================================
+# 基于 Broadcaster 库，通过 URL scheme 切换后端
+# 支持: memory:// | redis://host:port/db | kafka://host:port | postgres://...
+# RabbitMQ 需使用 backend=rabbitmq
+#
 # 单实例配置:
-# EVENT__BROKER_URL=
-# EVENT__EXCHANGE_NAME=aury.events
-
+# EVENT__BACKEND=broadcaster
+# EVENT__URL=memory://
+# 分布式: EVENT__URL=redis://localhost:6379/5
+#
 # 多实例配置 (格式: EVENT__{{INSTANCE}}__{{FIELD}}):
-# EVENT__DEFAULT__BACKEND=memory
-# EVENT__DISTRIBUTED__BACKEND=redis
+# EVENT__DEFAULT__BACKEND=broadcaster
+# EVENT__DEFAULT__URL=memory://
+# EVENT__DISTRIBUTED__BACKEND=broadcaster
 # EVENT__DISTRIBUTED__URL=redis://localhost:6379/5
-# EVENT__DISTRIBUTED__KEY_PREFIX=events:
 #
-# RabbitMQ 后端:
+# RabbitMQ 后端 (复杂消息场景):
 # EVENT__DOMAIN__BACKEND=rabbitmq
 # EVENT__DOMAIN__URL=amqp://guest:guest@localhost:5672/
 # EVENT__DOMAIN__EXCHANGE_NAME=domain.events
-# EVENT__DOMAIN__EXCHANGE_TYPE=topic

aury/boot/commands/templates/project/env_templates/monitoring.tpl

@@ -0,0 +1,63 @@
+# =============================================================================
+# 监控与告警配置
+# =============================================================================
+
+# ---------- OpenTelemetry 遥测 ----------
+# 启用后自动 instrument FastAPI、SQLAlchemy、httpx
+TELEMETRY__ENABLED=false
+# TELEMETRY__SAMPLING_RATE=1.0
+
+# OTLP 导出（可选）
+# TELEMETRY__TRACES_ENDPOINT=http://jaeger:4317
+# TELEMETRY__LOGS_ENDPOINT=http://loki:3100
+# TELEMETRY__METRICS_ENDPOINT=http://prometheus:9090
+
+# ---------- 告警系统 ----------
+ALERT__ENABLED=false
+# 慢操作阈值
+ALERT__SLOW_REQUEST_THRESHOLD=1.0
+ALERT__SLOW_SQL_THRESHOLD=0.5
+# 告警开关
+ALERT__ALERT_ON_SLOW_REQUEST=true
+ALERT__ALERT_ON_SLOW_SQL=true
+ALERT__ALERT_ON_ERROR=true
+# 慢请求排除路径（SSE/WebSocket 等长连接接口，支持 * 通配符）
+# ALERT__SLOW_REQUEST_EXCLUDE_PATHS=["*/subscribe", "*/ws", "*/stream"]
+# 聚合与抑制
+ALERT__AGGREGATE_WINDOW=10
+ALERT__SLOW_REQUEST_AGGREGATE=5
+ALERT__SLOW_SQL_AGGREGATE=10
+ALERT__EXCEPTION_AGGREGATE=1
+ALERT__SUPPRESS_SECONDS=300
+
+# ---------- 告警通知器（简版：单群）----------
+# 所有告警发到同一个飞书群，取消注释并填写 Webhook 即可
+# ALERT__NOTIFIERS__DEFAULT__TYPE=feishu
+# ALERT__NOTIFIERS__DEFAULT__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-id
+# ALERT__NOTIFIERS__DEFAULT__SECRET=your-secret
+
+# ---------- 告警通知器（完整版：分群告警）----------
+# 不同类型告警发到不同群，需配合 alert_rules.yaml 使用
+# 生成规则模板：aury docs alert-rules
+# ALERT__RULES_FILE=alert_rules.yaml
+
+# 性能群（慢请求、慢SQL）
+# ALERT__NOTIFIERS__PERF_GROUP__TYPE=feishu
+# ALERT__NOTIFIERS__PERF_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/perf-webhook-id
+# ALERT__NOTIFIERS__PERF_GROUP__SECRET=perf-secret
+
+# 错误群（异常）
+# ALERT__NOTIFIERS__ERROR_GROUP__TYPE=feishu
+# ALERT__NOTIFIERS__ERROR_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/error-webhook-id
+# ALERT__NOTIFIERS__ERROR_GROUP__SECRET=error-secret
+
+# 运维群（任务失败、超时）
+# ALERT__NOTIFIERS__OPS_GROUP__TYPE=feishu
+# ALERT__NOTIFIERS__OPS_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/ops-webhook-id
+# ALERT__NOTIFIERS__OPS_GROUP__SECRET=ops-secret
+
+# 通用 Webhook（自定义系统）
+# ALERT__NOTIFIERS__CUSTOM__TYPE=webhook
+# ALERT__NOTIFIERS__CUSTOM__URL=https://your-system.com/api/alert
+# ALERT__NOTIFIERS__CUSTOM__METHOD=POST
+# ALERT__NOTIFIERS__CUSTOM__HEADERS={{"Authorization": "Bearer your-token"}}

aury/boot/common/logging/context.py

@@ -58,8 +58,24 @@ def set_service_context(context: ServiceContext | str) -> None:
 def get_trace_id() -> str:
     """获取当前链路追踪ID。
 
-    如果尚未设置，则生成一个新的随机 ID。
+    优先从 OpenTelemetry 获取（如果已启用），否则使用内置 trace_id。
+    如果都没有设置，则生成一个新的随机 ID。
     """
+    # 优先从 OTel 获取
+    try:
+        from opentelemetry import trace
+        
+        span = trace.get_current_span()
+        if span and span.is_recording():
+            otel_trace_id = span.get_span_context().trace_id
+            if otel_trace_id:
+                return format(otel_trace_id, "032x")
+    except ImportError:
+        pass
+    except Exception:
+        pass
+    
+    # 回退到内置实现
     trace_id = _trace_id_var.get()
     if not trace_id:
         trace_id = str(uuid.uuid4())

aury/boot/common/logging/format.py

@@ -309,7 +309,11 @@ def log_exception(
 
 __all__ = [
     "create_console_sink",
+    "format_exception_compact",
     "format_exception_java_style",
     "format_message",
     "log_exception",
 ]
+
+# 别名导出（保持内部使用 _ 前缀）
+format_exception_compact = _format_exception_compact

aury/boot/infrastructure/__init__.py

@@ -27,12 +27,11 @@ from .cache import (
 
 # 通道 (SSE/PubSub)
 from .channel import (
+    BroadcasterChannel,
     ChannelBackend,
     ChannelManager,
     ChannelMessage,
     IChannel,
-    MemoryChannel,
-    RedisChannel,
 )
 
 # RabbitMQ 客户端
@@ -47,15 +46,14 @@ from .di import Container, Lifetime, Scope, ServiceDescriptor
 
 # 事件总线
 from .events import (
+    BroadcasterEventBus,
     Event,
     EventBackend,
     EventBusManager,
     EventHandler,
     EventType,
     IEventBus,
-    MemoryEventBus,
     RabbitMQEventBus,
-    RedisEventBus,
 )
 
 # 消息队列
@@ -103,6 +101,7 @@ __all__ = [
     "CacheFactory",
     "CacheManager",
     # 通道
+    "BroadcasterChannel",
     "ChannelBackend",
     "ChannelManager",
     "ChannelMessage",
@@ -128,19 +127,16 @@ __all__ = [
     "MQMessage",
     "MemcachedCache",
     "MemoryCache",
-    "MemoryChannel",
-    "MemoryEventBus",
     "RabbitMQ",
     # RabbitMQ 客户端
     "RabbitMQClient",
     "RabbitMQConfig",
     "RabbitMQEventBus",
+    "BroadcasterEventBus",
     "RedisCache",
-    "RedisChannel",
     # Redis 客户端
     "RedisClient",
     "RedisConfig",
-    "RedisEventBus",
     "RedisMQ",
     "S3Storage",
     # 调度器

aury/boot/infrastructure/channel/__init__.py

@@ -2,23 +2,24 @@
 
 提供发布/订阅模式的通道功能，用于 SSE、WebSocket 等实时通信场景。
 
-支持的后端:
-- memory: 内存通道（单进程）
-- redis: Redis Pub/Sub（多进程/多实例）
+支持的后端（通过 Broadcaster 库）:
+- memory:// - 内存通道（单进程，开发/测试用）
+- redis:// - Redis Pub/Sub（多进程/分布式）
+- kafka:// - Apache Kafka
+- postgres:// - PostgreSQL LISTEN/NOTIFY
 """
 
-from .backends import MemoryChannel, RedisChannel
+from .backends import BroadcasterChannel
 from .base import ChannelBackend, ChannelMessage, IChannel
 from .manager import ChannelManager
 
 __all__ = [
     # 接口和类型
     "ChannelBackend",
-    # 管理器
-    "ChannelManager",
     "ChannelMessage",
     "IChannel",
+    # 管理器
+    "ChannelManager",
     # 后端实现
-    "MemoryChannel",
-    "RedisChannel",
+    "BroadcasterChannel",
 ]

aury/boot/infrastructure/channel/backends/__init__.py

@@ -1,9 +1,5 @@
 """通道后端实现。"""
 
-from .memory import MemoryChannel
-from .redis import RedisChannel
+from .broadcaster import BroadcasterChannel
 
-__all__ = [
-    "MemoryChannel",
-    "RedisChannel",
-]
+__all__ = ["BroadcasterChannel"]

aury/boot/infrastructure/channel/backends/broadcaster.py

@@ -0,0 +1,141 @@
+"""Broadcaster 通道后端。
+
+基于 Broadcaster 库实现，支持多种后端：
+- memory:// - 内存（单进程，开发/测试用）
+- redis:// - Redis Pub/Sub（多进程/分布式）
+- kafka:// - Apache Kafka
+- postgres:// - PostgreSQL LISTEN/NOTIFY
+
+优势：
+- 共享连接池，支持成千上万并发订阅
+- 自动重连机制
+- 统一 API，通过 URL scheme 切换后端
+"""
+
+from __future__ import annotations
+
+import json
+from collections.abc import AsyncIterator
+from datetime import datetime
+
+from broadcaster import Broadcast
+
+from aury.boot.common.logging import logger
+
+from ..base import ChannelMessage, IChannel
+
+
+class BroadcasterChannel(IChannel):
+    """Broadcaster 通道实现。
+
+    使用 Broadcaster 库统一处理多种后端，解决原生实现的连接池问题：
+    - 共享单个连接处理所有订阅
+    - 内部通过 asyncio.Queue 分发消息
+    - 支持成千上万并发订阅者
+    """
+
+    def __init__(self, url: str) -> None:
+        """初始化 Broadcaster 通道。
+
+        Args:
+            url: 连接 URL，支持的 scheme：
+                - memory:// - 内存后端
+                - redis://host:port/db - Redis Pub/Sub
+                - kafka://host:port - Apache Kafka
+                - postgres://user:pass@host:port/db - PostgreSQL
+        """
+        self._url = url
+        self._broadcast = Broadcast(url)
+        self._connected = False
+
+    async def _ensure_connected(self) -> None:
+        """确保已连接。"""
+        if not self._connected:
+            await self._broadcast.connect()
+            self._connected = True
+            logger.debug(f"Broadcaster 通道已连接: {self._mask_url(self._url)}")
+
+    def _mask_url(self, url: str) -> str:
+        """URL 脱敏（隐藏密码）。"""
+        if "@" in url:
+            parts = url.split("@")
+            prefix = parts[0]
+            suffix = parts[1]
+            if ":" in prefix:
+                scheme_and_user = prefix.rsplit(":", 1)[0]
+                return f"{scheme_and_user}:***@{suffix}"
+        return url
+
+    async def publish(self, channel: str, message: ChannelMessage) -> None:
+        """发布消息到通道。"""
+        await self._ensure_connected()
+
+        message.channel = channel
+        # 序列化消息
+        data = {
+            "data": message.data,
+            "event": message.event,
+            "id": message.id,
+            "channel": message.channel,
+            "timestamp": message.timestamp.isoformat(),
+        }
+        await self._broadcast.publish(channel=channel, message=json.dumps(data))
+
+    async def subscribe(self, channel: str) -> AsyncIterator[ChannelMessage]:
+        """订阅通道。
+
+        Broadcaster 内部共享连接，每个订阅者不会创建新的连接。
+        """
+        await self._ensure_connected()
+
+        async with self._broadcast.subscribe(channel=channel) as subscriber:
+            async for event in subscriber:
+                try:
+                    data = json.loads(event.message)
+                    message = ChannelMessage(
+                        data=data.get("data"),
+                        event=data.get("event"),
+                        id=data.get("id"),
+                        channel=data.get("channel") or channel,
+                        timestamp=datetime.fromisoformat(data["timestamp"])
+                        if data.get("timestamp")
+                        else datetime.now(),
+                    )
+                    yield message
+                except (json.JSONDecodeError, KeyError, TypeError) as e:
+                    logger.warning(f"解析通道消息失败: {e}")
+
+    async def psubscribe(self, pattern: str) -> AsyncIterator[ChannelMessage]:
+        """模式订阅（通配符）。
+
+        注意：Broadcaster 目前不支持模式订阅，此方法会抛出 NotImplementedError。
+        如需模式订阅，请使用具体的 channel 名称。
+
+        Args:
+            pattern: 通道模式
+
+        Raises:
+            NotImplementedError: Broadcaster 不支持模式订阅
+        """
+        raise NotImplementedError(
+            "Broadcaster 后端不支持模式订阅 (psubscribe)。"
+            "请使用具体的 channel 名称。"
+        )
+
+    async def unsubscribe(self, channel: str) -> None:
+        """取消订阅通道。
+
+        注意：Broadcaster 的订阅通过上下文管理器自动处理，
+        退出 subscribe() 的 async for 循环即可取消订阅。
+        """
+        pass
+
+    async def close(self) -> None:
+        """关闭通道。"""
+        if self._connected:
+            await self._broadcast.disconnect()
+            self._connected = False
+            logger.debug("Broadcaster 通道已关闭")
+
+
+__all__ = ["BroadcasterChannel"]

aury/boot/infrastructure/channel/base.py

@@ -16,8 +16,11 @@ from typing import Any
 class ChannelBackend(Enum):
     """通道后端类型。"""
 
-    MEMORY = "memory"
-    REDIS = "redis"
+    # Broadcaster 统一后端（支持 memory/redis/kafka/postgres，通过 URL scheme 区分）
+    BROADCASTER = "broadcaster"
+    # 未来扩展
+    RABBITMQ = "rabbitmq"
+    ROCKETMQ = "rocketmq"
 
 
 @dataclass
@@ -31,7 +34,10 @@ class ChannelMessage:
     timestamp: datetime = field(default_factory=datetime.now)
 
     def to_sse(self) -> str:
-        """转换为 SSE 格式。"""
+        """转换为 SSE 格式。
+        
+        SSE 规范要求每个消息以双换行符结束。
+        """
         lines = []
         if self.id:
             lines.append(f"id: {self.id}")
@@ -42,7 +48,8 @@ class ChannelMessage:
         for line in data_str.split("\n"):
             lines.append(f"data: {line}")
         lines.append("")  # 空行结束
-        return "\n".join(lines)
+        # SSE 规范要求消息以双换行符结束
+        return "\n".join(lines) + "\n"
 
 
 class IChannel(ABC):