| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748 |
- 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"
- )
|