""" 客户端 AI 评分封装(经云端服务端代理) 模型配置(OpenAI 兼容 base_url/api_key/model)与密钥全部由服务端持有, 客户端只负责:发起打分任务 → 轮询结果;不再直连任何大模型。 功能: 1. 职位匹配度评分(异步任务:开始打分 + 轮询结果) 2. 简历内容整理(服务端同步代理) """ import time import uuid import requests from loguru import logger from .server_api import ServerAPI # 轮询间隔 / 等待总预算(与服务端 5 分钟悬空判定对齐) POLL_INTERVAL_S = 3 POLL_BUDGET_S = 300 def gen_request_key() -> str: """幂等键:uuid1 = 本机 MAC + 时间戳,.hex 为 32 位十六进制 (与服务端 ai_score_task.request_key VARCHAR(32) 严格对齐)""" return uuid.uuid1().hex def _detail_of(e: requests.HTTPError) -> str: """从 HTTPError 中提取服务端 detail 文案""" try: return str(e.response.json().get("detail") or e) except Exception: return str(e) class MatchResult: def __init__(self, score: int, reason: str, fatal: bool = False): self.score = score self.reason = reason # fatal = 模型级失败(调用出错/超时/未配置):客户端必须跳过该岗位; # 非 fatal(服务端不可达等网络问题):按约定降级默认放行 self.fatal = fatal def is_worth_applying(self, threshold: int = 60) -> bool: return self.score >= threshold class AIClient: """AI 评分客户端(服务端代理模式)""" def __init__(self, server: ServerAPI): self.server = server def available(self) -> bool: """可用条件:已登录云端账号(打分接口需 JWT 鉴权)。 模型是否配置由服务端判定,未配置时发起打分会返回明确错误。""" return bool(self.server.token) # ------------------------------------------------------------------ # 职位匹配度评分(异步任务 + 轮询) # ------------------------------------------------------------------ def score_job(self, job_ref: str, jd_text: str, resume_id: int | None, conditions: dict | None = None, prompt: str | None = None) -> MatchResult: """发起打分并等待结果。 - 服务端明确失败(模型未配置/简历缺失/限额/模型报错/超时)→ fatal,调用方跳岗 - 网络层不可达 → 降级默认放行(保持既有容错约定) """ if not self.available(): return MatchResult(50, "AI 未接入(未登录系统账号),默认放行") if not resume_id: return MatchResult(50, "无主简历,跳过 AI 评分默认放行") conds = dict(conditions or {}) if prompt: conds["prompt"] = prompt request_key = gen_request_key() # 1) 开始打分(幂等键保证网络重试不会重复调用大模型) try: self.server.start_ai_score({ "request_key": request_key, "resume_id": resume_id, "jd_text": jd_text, "job_ref": job_ref, "conditions": conds, }) except requests.HTTPError as e: return MatchResult(-1, f"AI 打分不可用:{_detail_of(e)}", fatal=True) except Exception as e: logger.warning(f"AI 打分发起失败(服务端不可达),默认放行:{e}") return MatchResult(50, "AI 服务不可达,默认放行") # 2) 轮询结果:成功返回分数;失败带原因(调用方跳岗);处理中继续等待 deadline = time.time() + POLL_BUDGET_S while time.time() < deadline: time.sleep(POLL_INTERVAL_S) try: r = self.server.get_ai_score_result(request_key) except Exception as e: logger.debug(f"AI 结果轮询异常,稍后重试:{e}") continue status = r.get("status") if status == "success": return MatchResult(int(r.get("score") or 0), r.get("reason") or "") if status == "failed": return MatchResult(-1, f"AI 打分失败:{r.get('reason') or '未知'}", fatal=True) # pending / running:等待下一次轮询 logger.warning(f"AI 打分等待超时({POLL_BUDGET_S}s),跳过该岗位:{job_ref}") return MatchResult(-1, f"AI 打分超时({POLL_BUDGET_S // 60} 分钟)", fatal=True) # ------------------------------------------------------------------ # 简历内容整理(服务端同步代理,低频调用) # ------------------------------------------------------------------ def clean_resume(self, raw_text: str) -> str: """用 AI 将抓取的杂乱简历文本整理为清晰的结构化文本""" if not self.available(): return raw_text try: return self.server.clean_resume_via_server(raw_text) except Exception as e: logger.warning(f"AI 整理简历失败,返回原文:{e}") return raw_text # ------------------------------------------------------------------ # 连通测试 # ------------------------------------------------------------------ def ping(self) -> bool: return self.server.ping()