Class GuestSession

app/utils/guest_session_pool.py:155–184

单个匿名访客会话。

@dataclass
class GuestSession:
    """单个匿名访客会话。"""

    token: str
    user_id: str
    username: str
    created_at: float = field(default_factory=time.time)
    expires_at: float = field(default_factory=_build_session_expiry)
    active_requests: int = 0
    valid: bool = True
    failure_count: int = 0
    last_failure_time: float = 0.0

    @property
    def age(self) -> float:
        """会话存活时间。"""
        return time.time() - self.created_at

    @property
    def is_expired(self) -> bool:
        """判断会话是否已过期。"""
        return time.time() >= self.expires_at

    def snapshot(self) -> Dict[str, str]:
        """获取当前会话快照。"""
        return {
            "token": self.token,
            "user_id": self.user_id,
            "username": self.username,
        }


class GuestSessionPool: