astrbot_plugin_imagestudio/core/identity.py

66 行
1.8 KiB
Python

"""Identity and request actor helpers."""
from __future__ import annotations
from dataclasses import dataclass, field
from datetime import UTC, datetime
from uuid import uuid4
def new_request_id() -> str:
return f"req_{uuid4().hex}"
@dataclass(frozen=True)
class RequestContext:
request_id: str = field(default_factory=new_request_id)
username: str | None = None
user_id: str | None = None
client_ip: str | None = None
source: str = "system"
platform: str = "webui"
session_key: str | None = None
is_authenticated: bool = False
permissions: frozenset[str] = field(default_factory=frozenset)
created_at: datetime = field(default_factory=lambda: datetime.now(UTC))
@property
def actor_id(self) -> str | None:
return self.user_id or self.username
@property
def actor_type(self) -> str:
return "user" if self.actor_id else "system"
def has_permission(self, permission: str) -> bool:
return permission in self.permissions or "*" in self.permissions
@classmethod
def system(cls, source: str = "system") -> "RequestContext":
return cls(
username="system",
user_id="system",
source=source,
is_authenticated=True,
permissions=frozenset({"*"}),
)
@classmethod
def from_astrbot(
cls,
*,
username: str | None,
user_id: str | None = None,
client_ip: str | None = None,
source: str = "standalone",
permissions: set[str] | frozenset[str] | None = None,
) -> "RequestContext":
return cls(
username=username,
user_id=user_id,
client_ip=client_ip,
source=source,
is_authenticated=bool(username or user_id),
permissions=frozenset(permissions or set()),
)