astrbot_plugin_imagestudio/backend/routes/material_routes.py

323 行
11 KiB
Python

"""Material library route handlers."""
from __future__ import annotations
from typing import Any
from backend.dto.common import ApiError, ErrorCode
from backend.dto.material_dto import Material, MaterialListResult
from backend.routes.common import handle_request
from backend.routes.params import int_or_default, optional_str
from backend.services.material_service import MaterialService
from backend.services.material_analytics_service import MaterialAnalyticsService
from backend.services.media_service import MediaService
from backend.services.model_provider_bootstrap import sync_vision_provider_from_config
from backend.services.model_provider_runtime import ModelProviderRuntime
from backend.services.model_provider_service import ModelProviderService
from core.audit_service import AuditService
from core.identity import RequestContext
from core.security import require_authenticated, require_permission
from database.db_helper import Database, load_config_payload, load_database_settings
from database.repositories.material_repository import MaterialRepository
from database.repositories.model_provider_repository import ModelProviderRepository
def list_material_categories(
ctx: RequestContext,
service: MaterialService | None = None,
) -> dict:
material_service = service or _create_material_service()
def action() -> list[dict[str, Any]]:
require_authenticated(ctx)
return [category.to_dict() for category in material_service.list_categories()]
return handle_request(ctx, action)
def create_material_category(
ctx: RequestContext,
payload: dict[str, Any],
service: MaterialService | None = None,
) -> dict:
material_service = service or _create_material_service()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return material_service.create_category(payload, ctx).to_dict()
return handle_request(ctx, action)
def update_material_category(
ctx: RequestContext,
category_id: str,
payload: dict[str, Any],
service: MaterialService | None = None,
) -> dict:
material_service = service or _create_material_service()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return material_service.update_category(category_id, payload, ctx).to_dict()
return handle_request(ctx, action)
def delete_material_category(
ctx: RequestContext,
category_id: str,
service: MaterialService | None = None,
) -> dict:
material_service = service or _create_material_service()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return material_service.delete_category(category_id, ctx).to_dict()
return handle_request(ctx, action)
def list_materials(
ctx: RequestContext,
query: dict[str, Any] | None = None,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
params = query or {}
def action() -> dict[str, Any]:
require_authenticated(ctx)
result = material_service.list_materials(
category_id=optional_str(params.get("category_id")),
keyword=optional_str(params.get("keyword")),
page=int_or_default(params.get("page"), 1),
page_size=int_or_default(params.get("page_size"), 30),
color=optional_str(params.get("color")),
material_type=optional_str(params.get("material_type")),
body_slot=optional_str(params.get("body_slot")),
wear_layer=optional_str(params.get("wear_layer")),
min_confidence=_optional_float(params.get("min_confidence")),
confirmation_state=optional_str(params.get("confirmation_state")),
)
return _serialize_material_list(result, signer)
return handle_request(ctx, action)
def material_analytics(ctx: RequestContext, service: MaterialAnalyticsService | None = None) -> dict:
analytics = service or MaterialAnalyticsService(Database(load_database_settings()))
return handle_request(ctx, lambda: (require_authenticated(ctx), analytics.summarize())[1])
def create_material(
ctx: RequestContext,
payload: dict[str, Any],
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.create_material(payload, ctx), signer)
return handle_request(ctx, action)
def get_material(
ctx: RequestContext,
material_id: str,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_authenticated(ctx)
return _serialize_material(material_service.get_material(material_id), signer)
return handle_request(ctx, action)
def update_material(
ctx: RequestContext,
material_id: str,
payload: dict[str, Any],
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.update_material(material_id, payload, ctx), signer)
return handle_request(ctx, action)
def delete_material(
ctx: RequestContext,
material_id: str,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.delete_material(material_id, ctx), signer)
return handle_request(ctx, action)
def upload_material(
ctx: RequestContext,
payload: dict[str, Any],
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.upload_material(payload, ctx), signer)
return handle_request(ctx, action)
def recognize_material(
ctx: RequestContext,
material_id: str,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.recognize_material(material_id, ctx), signer)
return handle_request(ctx, action)
def re_recognize_material(
ctx: RequestContext,
material_id: str,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.re_recognize_material(material_id, ctx), signer)
return handle_request(ctx, action)
def renormalize_material(
ctx: RequestContext,
material_id: str,
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.renormalize_material(material_id, ctx), signer)
return handle_request(ctx, action)
def renormalize_materials_batch(
ctx: RequestContext,
payload: dict[str, Any] | None = None,
service: MaterialService | None = None,
) -> dict:
material_service = service or _create_material_service()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return material_service.renormalize_batch(payload or {}, ctx)
return handle_request(ctx, action)
def confirm_material(
ctx: RequestContext,
material_id: str,
payload: dict[str, Any],
service: MaterialService | None = None,
media_service: MediaService | None = None,
) -> dict:
material_service = service or _create_material_service()
signer = media_service or MediaService()
def action() -> dict[str, Any]:
require_permission(ctx, "can_manage_materials")
return _serialize_material(material_service.confirm_material(material_id, payload, ctx), signer)
return handle_request(ctx, action)
def _create_material_service() -> MaterialService:
database = Database(load_database_settings())
model_provider_service = ModelProviderService(ModelProviderRepository(database))
model_provider_runtime = ModelProviderRuntime(model_provider_service)
config = load_config_payload()
sync_vision_provider_from_config(model_provider_service, config)
vision = config.get("vision") if isinstance(config.get("vision"), dict) else {}
provider = vision.get("provider") if isinstance(vision.get("provider"), dict) else {}
assignments = config.get("model_assignments") if isinstance(config.get("model_assignments"), dict) else {}
recognition_prompts = config.get("recognition_prompts") if isinstance(config.get("recognition_prompts"), dict) else {}
default_route = str(assignments.get("material_recognition") or provider.get("route_name") or vision.get("default_route") or "material_vlm").strip()
return MaterialService(
repository=MaterialRepository(database),
audit_service=AuditService(database),
vision_provider_factory=model_provider_runtime.vision_provider_for_route,
default_recognition_route=default_route,
recognition_prompt_config=recognition_prompts,
)
def _serialize_material_list(result: MaterialListResult, media_service: MediaService) -> dict[str, Any]:
payload = result.to_dict()
payload["items"] = [_serialize_material(item, media_service) for item in result.items]
return payload
def _serialize_material(material: Material, media_service: MediaService) -> dict[str, Any]:
payload = material.to_dict()
payload["image_url"] = _signed_url(media_service, material.image_uri)
payload["thumbnail_url"] = _signed_url(media_service, material.thumbnail_uri)
return payload
def _optional_float(value: Any) -> float | None:
if value in (None, ""):
return None
try:
return float(value)
except (TypeError, ValueError):
raise ApiError(ErrorCode.VALIDATION_FAILED, "min_confidence must be a number", {"field": "min_confidence"}) from None
def _signed_url(media_service: MediaService, uri: str | None) -> str | None:
if not uri:
return None
try:
return media_service.sign_media(uri)["url"]
except ApiError:
return None