proxy_reputation.py 2.1 KB

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