from typing import Optional, Dict from pydantic import BaseModel, Field class ProxyTelemetryReportRequest(BaseModel): """ 代理指标埋点上报请求参数 """ client_id: str = Field(..., description="上报客户端唯一标识,如 Jerry_Win11_PC") plugin_name: str = Field(..., description="业务插件名称,如 vfs_plugin") egress_ip: str = Field(..., description="真实公网出口 IP,如 104.28.198.42") local_port: Optional[int] = Field(None, description="客户端本地代理端口,如 16001") node_name: Optional[str] = Field(None, description="节点标签名称,如 🇭🇰 香港 01丨1x HK") action: str = Field(..., description="调用场景:spawn (登录/创建会话), query (查号), book (预约提交)") success: bool = Field(..., description="是否成功:true (成功), false (失败)") http_code: int = Field(..., description="响应 HTTP 状态码,如 200, 403, 429, 502") error_type: Optional[str] = Field(None, description="错误归因描述,如 cf-mitigated (403202)") latency_ms: Optional[int] = Field(0, description="请求耗时(毫秒)") timestamp: int = Field(..., description="客户端上报时间戳(秒级)") class ProxyTelemetryReportResponse(BaseModel): """ 代理指标埋点上报响应 """ recorded: bool = True class ProxyReputationItemOut(BaseModel): """ 单个出口 IP 的信誉评分与状态详情 """ score: int = Field(..., description="综合信誉评分 (0~100)") state: str = Field(..., description="状态枚举: trusted, probation, blocked") success_rate: float = Field(..., description="近期成功率 (0.00 ~ 1.00)") last_seen: int = Field(..., description="最近一次调用时间戳(秒级)") class ProxyReputationMapResponse(BaseModel): """ 插件代理信誉全景字典响应 """ plugin_name: str = Field(..., description="插件名称") version: int = Field(..., description="字典版本号或时间戳") reputation_map: Dict[str, ProxyReputationItemOut] = Field( default_factory=dict, description="核心信誉字典,Key 为公网出口 IP" )