在准备环境前提交次全部更改。

apps/backend/app/ws/logs.py

@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+"""WebSocket 日志推送端点
+
+提供 WS /ws/logs/{execution_id} 端点，实时推送 ETL 任务执行日志。
+客户端连接后，先发送已有的历史日志行，再实时推送新日志，
+直到执行结束（收到 None 哨兵）或客户端断开。
+
+设计要点：
+- 利用 TaskExecutor 已有的 subscribe/unsubscribe 机制
+- 连接时先回放内存缓冲区中的历史日志，避免丢失已产生的行
+- 通过 asyncio.Queue 接收实时日志，None 表示执行结束
+"""
+
+from __future__ import annotations
+
+import logging
+
+from fastapi import APIRouter, WebSocket, WebSocketDisconnect
+
+from ..services.task_executor import task_executor
+
+logger = logging.getLogger(__name__)
+
+ws_router = APIRouter()
+
+
+@ws_router.websocket("/ws/logs/{execution_id}")
+async def ws_logs(websocket: WebSocket, execution_id: str) -> None:
+    """实时推送指定 execution_id 的任务执行日志。
+
+    流程：
+    1. 接受 WebSocket 连接
+    2. 回放内存缓冲区中已有的日志行
+    3. 订阅 TaskExecutor，持续推送新日志
+    4. 收到 None（执行结束）或客户端断开时关闭
+    """
+    await websocket.accept()
+    logger.info("WebSocket 连接已建立: execution_id=%s", execution_id)
+
+    # 订阅日志流
+    queue = task_executor.subscribe(execution_id)
+
+    try:
+        # 回放已有的历史日志行
+        for line in task_executor.get_logs(execution_id):
+            await websocket.send_text(line)
+
+        # 如果任务已经不在运行且没有订阅者队列中的数据，
+        # 仍然保持连接等待——可能是任务刚结束但 queue 里还有未消费的消息
+        while True:
+            msg = await queue.get()
+            if msg is None:
+                # 执行结束哨兵
+                break
+            await websocket.send_text(msg)
+
+    except WebSocketDisconnect:
+        logger.info("WebSocket 客户端断开: execution_id=%s", execution_id)
+    except Exception:
+        logger.exception("WebSocket 异常: execution_id=%s", execution_id)
+    finally:
+        task_executor.unsubscribe(execution_id, queue)
+        # 安全关闭连接（客户端可能已断开，忽略错误）
+        try:
+            await websocket.close()
+        except Exception:
+            pass
+        logger.info("WebSocket 连接已清理: execution_id=%s", execution_id)