Function start_webui

webui.py:138–177

启动 Web UI

()

def start_webui():
    """启动 Web UI"""
    # 设置应用程序
    settings = setup_application()

    # 导入 FastAPI 应用（延迟导入以避免循环依赖）
    from src.web.app import app

    # 端口占用时自动切换到可用端口，避免启动失败
    bind_host = settings.webui_host
    bind_port = int(settings.webui_port)
    selected_port = _find_available_port(bind_host, bind_port, max_scan=100)
    display_host = _get_display_host(bind_host)

    logger = logging.getLogger(__name__)
    if selected_port != bind_port:
        logger.warning(
            "检测到端口占用，自动切换: %s:%s -> %s:%s",
            bind_host,
            bind_port,
            bind_host,
            selected_port,
        )

    # 配置 uvicorn
    uvicorn_config = {
        "app": "src.web.app:app",
        "host": bind_host,
        "port": selected_port,
        "reload": settings.debug,
        "log_level": "info" if settings.debug else "warning",
        "access_log": settings.debug,
        "ws": "websockets",
    }

    logger.info(f"Web UI 已就位，请走这边: http://{display_host}:{selected_port}")
    logger.info(f"调试模式: {settings.debug}")

    # 启动服务器
    uvicorn.run(**uvicorn_config)


def main():