Function check_dashboard_files

main.py:97–196

Resolve and repair dashboard static files for startup. Args: webui_dir: Optional explicit WebUI directory path from CLI. Returns: The directory path to serve, or None when no usable WebUI can be prepared.

(webui_dir: str | None = None)

async def check_dashboard_files(webui_dir: str | None = None):
    """Resolve and repair dashboard static files for startup.

    Args:
        webui_dir: Optional explicit WebUI directory path from CLI.

    Returns:
        The directory path to serve, or None when no usable WebUI can be prepared.
    """

    # 指定webui目录
    if webui_dir:
        if os.path.exists(webui_dir):
            logger.info("Using WebUI directory: %s", webui_dir)
            return webui_dir
        logger.warning("WebUI directory not found: %s. Using default.", webui_dir)

    data_dist_path = Path(get_astrbot_data_path()) / "dist"
    bundled_dist = get_bundled_dashboard_dist_path()
    if data_dist_path.exists():
        v = get_dashboard_dist_version(data_dist_path)
        if is_dashboard_dist_compatible(data_dist_path, VERSION):
            logger.info("WebUI is up to date.")
            return str(data_dist_path)

        if should_use_bundled_dashboard_dist(data_dist_path, VERSION):
            logger.info(
                "Replacing data/dist with bundled WebUI because its version does not match core version v%s.",
                VERSION,
            )
            try:
                remove_dir(str(data_dist_path))
                shutil.copytree(bundled_dist, data_dist_path)
                return str(data_dist_path)
            except Exception as e:
                logger.warning(
                    "Failed to replace data/dist with bundled WebUI: %s. Using bundled WebUI directly.",
                    e,
                )
                return str(bundled_dist)

        if is_dashboard_version_compatible(v, VERSION):
            logger.warning(
                "WebUI files are incomplete for v%s. Re-downloading WebUI.",
                VERSION,
            )
        elif v is not None:
            logger.warning(
                "WebUI version mismatch: %s, expected v%s. Re-downloading WebUI.",
                v,
                VERSION,
            )
        else:
            logger.warning(
                "WebUI version file is missing. Re-downloading WebUI v%s.",
                VERSION,
            )