Files
2026-08-26 20:13:34 +08:00

131 lines
5.4 KiB
Python

"""
客户端 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()