Files
2026-11-02 22:54:14 +08:00

167 lines
5.5 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# app/core/browser/main.py
import threading
from typing import Optional, Dict, Any, List, Callable
from app.core.config import logger, BrowserConstants, BrowserConnectionError, SSEFormatter
from app.core.tab_pool import TabPoolManager
# Mixins
from .prompt import BrowserPromptMixin
from .connection import BrowserConnectionMixin, _load_tab_pool_config
from .workflow import BrowserWorkflowMixin
from .media import BrowserMediaMixin
class BrowserCore(
BrowserPromptMixin,
BrowserConnectionMixin,
BrowserWorkflowMixin,
BrowserMediaMixin,
):
"""浏览器核心类 - 单例模式(v2.0)"""
_instance: Optional['BrowserCore'] = None
_lock = threading.Lock()
def __new__(cls, port: int = None):
if cls._instance is None:
with cls._lock:
if cls._instance is None:
instance = super().__new__(cls)
instance._initialized = False
cls._instance = instance
return cls._instance
def __init__(self, port: int = None):
if self._initialized:
return
self.port = port or BrowserConstants.DEFAULT_PORT
self.browser_handle: Optional[Any] = None # DrissionPage Chromium(经 app.core.driver 创建)
self.page: Optional[Any] = None # DrissionPage 标签页对象
self._connected = False
self._should_stop_checker: Callable[[], bool] = lambda: False
self._watchdog_thread: Optional[threading.Thread] = None
self._watchdog_stop = threading.Event()
self._last_watchdog_port_open: Optional[bool] = None
self._last_watchdog_session_alive: Optional[bool] = None
self._last_watchdog_health: Optional[str] = None
self._last_debug_port_error: str = ""
self._last_headless_diagnosis: Optional[str] = None
self._last_headless_log_at: float = 0.0
self._connect_retry_after: float = 0.0
self._get_tabs_retry_after: float = 0.0
self._last_get_tabs_fallback_log_at: float = 0.0
self.formatter = SSEFormatter()
self.config_engine = None
# v2.0: 使用 TabPoolManager 替代 TabManager
self._tab_pool: Optional[TabPoolManager] = None
self._initialized = True
logger.debug("BrowserCore 初始化 (v2.0 多标签页版)")
@property
def tab_pool(self) -> TabPoolManager:
"""获取标签页池(延迟初始化 + 线程安全)"""
if self._tab_pool is None:
with self._lock: # 使用类级别的锁
if self._tab_pool is None: # 双重检查
if not self.ensure_connection():
raise BrowserConnectionError("无法连接到浏览器")
pool_config = _load_tab_pool_config()
self._tab_pool = TabPoolManager(
browser_page=self.get_browser_handle(),
**pool_config
)
self._tab_pool.initialize()
return self._tab_pool
def _get_config_engine(self):
if self.config_engine is None:
from app.services.config_engine import config_engine
self.config_engine = config_engine
return self.config_engine
def close(self):
"""关闭浏览器连接"""
global _browser_instance
with _browser_lock:
logger.info("关闭浏览器连接")
self._watchdog_stop.set()
watchdog_thread = self._watchdog_thread
if (
watchdog_thread
and watchdog_thread.is_alive()
and watchdog_thread is not threading.current_thread()
):
watchdog_thread.join(timeout=1.0)
self._watchdog_thread = None
if self._tab_pool:
self._tab_pool.shutdown()
self._tab_pool = None
self._connected = False
self.browser_handle = None
self.page = None
with self._lock:
if BrowserCore._instance is self:
BrowserCore._instance = None
if _browser_instance is self:
_browser_instance = None
self._initialized = False
# ================= 工厂函数 =================
_browser_instance: Optional[BrowserCore] = None
_browser_lock = threading.Lock()
def get_browser(port: int = None, auto_connect: bool = True) -> BrowserCore:
"""获取浏览器实例(R2-6:process 模式的 API 进程返回指向 worker 的远程代理)"""
global _browser_instance
from app.worker import is_api_process
if is_api_process():
from app.worker.client import get_remote_browser
return get_remote_browser()
if _browser_instance is not None:
return _browser_instance
with _browser_lock:
if _browser_instance is None:
instance = BrowserCore(port)
if auto_connect:
if not instance.ensure_connection():
raise BrowserConnectionError(
f"无法连接到浏览器 (端口: {instance.port})"
)
_browser_instance = instance
return _browser_instance
class _LazyBrowser:
"""浏览器延迟初始化代理"""
def __getattr__(self, name):
return getattr(get_browser(auto_connect=False), name)
def __call__(self, *args, **kwargs):
return get_browser(*args, **kwargs)
browser = _LazyBrowser()