astrbot_plugin_imagestudio/core/model_router.py

84 行
2.8 KiB
Python

"""Model route selection helpers."""
from __future__ import annotations
from dataclasses import dataclass, field
from typing import Any
SUPPORTED = "confirmed_supported"
UNSUPPORTED = "confirmed_unsupported"
UNCONFIRMED = "unconfirmed"
@dataclass(frozen=True)
class ModelRoute:
provider_id: str
model_id: str
route_id: str | None = None
status: str = UNCONFIRMED
capabilities: set[str] = field(default_factory=set)
priority: int = 100
@property
def key(self) -> str:
return self.route_id or f"{self.provider_id}/{self.model_id}"
def to_dict(self) -> dict[str, Any]:
return {
"route_id": self.route_id,
"provider_id": self.provider_id,
"model_id": self.model_id,
"status": self.status,
"capabilities": sorted(self.capabilities),
"priority": self.priority,
}
@dataclass(frozen=True)
class RouteSelection:
selected: ModelRoute | None
status: str
reason: str = ""
candidates: list[ModelRoute] = field(default_factory=list)
@property
def valid(self) -> bool:
return self.selected is not None and self.status == SUPPORTED
def select_model_route(
routes: list[ModelRoute],
*,
required_capabilities: list[str] | None = None,
preferred_route_id: str | None = None,
) -> RouteSelection:
required = set(required_capabilities or [])
candidates = [route for route in routes if required.issubset(route.capabilities)]
if preferred_route_id:
preferred = [route for route in candidates if route.key == preferred_route_id or route.route_id == preferred_route_id]
if preferred:
candidates = preferred
candidates = sorted(candidates, key=lambda route: (route.status != SUPPORTED, route.priority, route.key))
if not candidates:
return RouteSelection(None, UNCONFIRMED, "no route advertises required capabilities", [])
selected = candidates[0]
if selected.status == SUPPORTED:
return RouteSelection(selected, SUPPORTED, candidates=candidates)
if selected.status == UNSUPPORTED:
return RouteSelection(None, UNSUPPORTED, "best matching route is unsupported", candidates)
return RouteSelection(None, UNCONFIRMED, "best matching route is unconfirmed", candidates)
def route_from_capability_profile(profile: dict[str, Any]) -> ModelRoute:
capabilities = profile.get("capabilities") or {}
supports = capabilities.get("supports", capabilities if isinstance(capabilities, list) else [])
return ModelRoute(
provider_id=str(profile.get("provider_id") or ""),
model_id=str(profile.get("model_id") or ""),
route_id=profile.get("route_id"),
status=str(profile.get("status") or UNCONFIRMED),
capabilities={str(item) for item in supports},
priority=int(profile.get("priority") or 100),
)