Class AstrBotDashboard

astrbot/dashboard/server.py:173–654

class AstrBotDashboard:
    def __init__(
        self,
        core_lifecycle: AstrBotCoreLifecycle,
        db: BaseDatabase,
        shutdown_event: asyncio.Event,
        webui_dir: str | None = None,
    ) -> None:
        self.core_lifecycle = core_lifecycle
        self.config = core_lifecycle.astrbot_config
        self.db = db

        # Path priority:
        # 1. Explicit webui_dir argument
        # 2. data/dist/ when it matches the core version
        # 3. astrbot/dashboard/dist/ when it matches the core version
        if webui_dir and os.path.exists(webui_dir):
            self.data_path = os.path.abspath(webui_dir)
        else:
            user_dist = os.path.join(get_astrbot_data_path(), "dist")
            bundled_dist = get_bundled_dashboard_dist_path()
            user_version = get_dashboard_dist_version(user_dist)
            if os.path.exists(user_dist) and is_dashboard_dist_compatible(
                user_dist,
                VERSION,
            ):
                self.data_path = os.path.abspath(user_dist)
            elif should_use_bundled_dashboard_dist(
                user_dist,
                VERSION,
            ) or is_dashboard_dist_compatible(bundled_dist, VERSION):
                self.data_path = str(bundled_dist)
                logger.info("Using bundled dashboard dist: %s", self.data_path)
            elif (
                os.path.exists(user_dist) and (Path(user_dist) / "index.html").is_file()
            ):
                logger.warning(
                    "Using existing data/dist as a fallback even though WebUI version mismatches core: %s, expected v%s. "
                    "Some dashboard features may not work until the matching WebUI is available.",
                    user_version,
                    VERSION,
                )
                self.data_path = os.path.abspath(user_dist)
            elif os.path.exists(user_dist):
                logger.warning(
                    "Ignoring data/dist because WebUI files are incomplete for core v%s.",
                    VERSION,
                )
                self.data_path = None
            else:
                # Fall back to expected user path (will fail gracefully later)
                self.data_path = os.path.abspath(user_dist)

        self._rate_limiter_registry = _RateLimiterRegistry()
        self._init_jwt_secret()
        self.asgi_app = create_dashboard_asgi_app(
            core_lifecycle=core_lifecycle,
            db=db,