9.1 KiB
9.1 KiB
Boss直聘 AI 投递系统 — 优化方案
本文档汇总系统搭建后,通过评审讨论确定的优化项。 每个优化项包含:问题来源、现状缺陷、改造方案、涉及文件、验收标准与当前状态。
一、架构现状(优化前)
- 服务端:FastAPI + MySQL + JWT,按
client_code(机器硬件指纹)识别用户 - 客户端:本地 Web 控制面板 + AdsPower 指纹浏览器 + Playwright + AI 评分
- 身份模型:以机器硬件指纹作为唯一编码注册,数据按用户隔离
本轮优化主要围绕身份体系与登录健壮性展开。
二、优化项清单
⭐ 优化项 1:系统登录改为「账号密码」体系(核心)
问题来源
- 「RPA 是不是要有一个登录步骤?要不然怎么知道这个 RPA 要登录到系统的哪一个账号?」
- 「RPA 的编码是不是应该以指纹浏览器为唯一?要不然用户切换了机器也会被认为是新的。」
现状缺陷
- 身份绑定在机器硬件指纹上:换机器 = 新用户,数据无法延续。
- 无真正的"账号"概念:无用户名、无密码、无法管理、无法找回。
- RPA 与账号无显式关系,无法明确"控制哪个 RPA 启停"。
改造方案(已确认:账号密码登录)
- 身份从"机器指纹 / Profile 编码"改为服务端账号(用户名 + 密码)。
- 账号存于服务端,与机器、与指纹浏览器 Profile 完全解耦。
- 指纹浏览器回归本职:仅作为访问 Boss直聘 的防检测浏览器工具(本地配置)。
- 数据(简历 / 投递记录)全部挂在账号下。
说明:此前讨论的"Profile localStorage 编码"方案已被账号密码体系取代,不再实施。
涉及改动
| 端 | 文件 | 改动内容 |
|---|---|---|
| 服务端 | server/auth.py |
新增 hash_password / verify_password(PBKDF2);token payload 用 username |
| 服务端 | server/models.py |
User 增加 username(唯一)、password_hash;client_code 降为可选设备标记 |
| 服务端 | server/schemas.py |
改造注册模型;新增登录请求/响应模型 |
| 服务端 | server/routers/register.py |
拆分 /register(注册)与 /login(登录)接口 |
| 客户端 | client/server_api.py |
register/login 改为账密;保留 token 持久化 |
| 客户端 | client/web/app.py |
新增 /api/register、/api/login;替换指纹连接逻辑 |
| 客户端 | client/web/templates/index.html + static/app.js |
Step1 改为登录/注册表单 |
验收标准
- 可通过用户名密码注册新账号,密码以加盐哈希存储(不存明文)
- 可通过用户名密码登录,返回 JWT token
- 客户端保存 token,二次启动免登录;token 失效时引导重新登录
- 换机器登录同一账号,可见原有简历与投递记录
状态:✅ 已完成
优化项 2:Boss直聘登录「活体检测」(重连健壮性)
问题来源
- 「如果 RPA 离线后再次登录,但指纹浏览器已经登录了 Boss 该怎么办?是不是应该做一个检查处理?」
现状缺陷
- 登录状态只存在服务端字段里(
login_status),从不与真实浏览器做活体校验。 - 场景 A:Profile 里 Cookie 仍有效(已登录),却仍强制用户手动扫码。
- 场景 B:Cookie 已过期,但服务端仍记
logged_in,后续抓简历/投递会失败。
改造方案(已确认:进入登录步骤自动检测)
- 进入登录步骤时,自动调用
BrowserManager.check_boss_login()做活体校验。 - 已登录 → 自动标记
logged_in,跳过手动登录,直接进入简历步骤。 - 未登录 → 展示手动登录引导(扫码/账密)。
- 新增
/api/detect-login接口供前端触发。
涉及改动
| 端 | 文件 | 改动内容 |
|---|---|---|
| 客户端 | client/web/app.py |
新增 /api/detect-login,内部调用 check_boss_login 并回写服务端状态 |
| 客户端 | client/web/static/app.js |
进入 Step2 自动触发检测,按结果决定跳过或引导登录 |
验收标准
- Profile 已登录时,进入登录步骤自动识别并跳过手动登录
- Cookie 失效时,能正确识别为未登录并引导重新登录
状态:✅ 已完成
优化项 3:单账号模式(范围决策,非编码项)
问题来源
- 「RPA 是不是需要与账号有一个关系?要不然怎么控制哪个 RPA 开始、哪个结束?」
决策(已确认:单账号)
- 一个客户端一次只服务一个账号,投递任务为该账号的全局单例。
- "启停控制"即"启停当前登录账号的投递任务",无需多账号实体。
- 多账号 / 多 Profile 独立启停为后续可扩展方向(届时引入
RpaProfile实体)。
状态:已确认范围,本轮不做多账号改造
优化项 4:RPA 在线判定(心跳机制)
问题来源
- 「我们现在是怎么确认 RPA 在线的?」
现状缺陷(优化前)
- 无真正的在线判定:
last_seen_at只在登录/写操作时被动更新,客户端静默挂着不刷新。 - 前端 8 秒轮询只调只读接口
/me,服务端不记录为存活。 - 客户端崩溃/断网后服务端永远不知道离线,
logging_in状态会永久卡死。
改造方案
- 服务端新增
/api/auth/heartbeat,客户端登录后每 30s 上报一次,刷新last_seen_at。 - 在线判定:
last_seen_at距今 ≤ 90s(= 3 个心跳周期)为在线。 /api/auth/me返回is_online字段;前端顶部展示“RPA在线/离线”徽章。- 懒清理:客户端已离线却仍停留在
logging_in时,自动重置为not_login。
涉及改动
| 端 | 文件 | 改动内容 |
|---|---|---|
| 服务端 | server/schemas.py |
UserInfo 增加 is_online |
| 服务端 | server/routers/register.py |
新增 /heartbeat、is_user_online 判定、/me 懒清理 |
| 客户端 | client/config.py |
新增 HEARTBEAT_INTERVAL=30 |
| 客户端 | client/server_api.py |
新增 heartbeat()(失败不抛异常) |
| 客户端 | client/web/app.py |
后台心跳线程(登录启动、退出停止);/api/status 返回 rpa_online |
| 客户端 | client/web/static/app.js |
顶部展示 RPA 在线徽章 |
验收标准
- 登录后心跳线程自动启动,每 30s 上报;退出登录自动停止
- 客户端关闭/断网 90s 后,服务端判定离线,前端徽章变为“RPA离线”
- 离线时
logging_in状态自动重置为not_login
业务底层收敛(重要设计约束)
在线判定不允许在各路由里各自实现,统一收敛到 server/online.py:
| 服务 | 职责 | 使用方 |
|---|---|---|
is_online(user) |
纯判定,无副作用 | /me 返回在线状态 |
touch(user, db) |
刷新活跃时间 | /heartbeat |
require_online_user |
前置校验依赖:认证→先验在线→再刷新 | 所有需 RPA 存活的写操作 |
前置校验接入清单:
- ✅
/api/sessions/start(开始投递)、/stats(上报统计) - ✅
/api/auth/login-status(Boss 登录状态变更) - ✅
/api/resumes/batch(简历上传)、/api/jobs/report(投递上报) - ⚠️ 特例:
/api/sessions/{id}/stop故意豁免在线拦截——stop 是安全清理操作, 否则离线前遗留的 running 僵尸会话永远无法关闭 - 只读查询接口(history/stats/list)不强制在线
客户端同步收敛:client/web/app.py 的 _require_auth() 统一未登录拦截,
_require_rpa_online() 在开始投递前先发心跳再确认服务端判定在线。
后续新增任何写操作接口,必须走 require_online_user,不得另起炉灶。
状态:✅ 已完成
三、已通过设计决策解决(无需单独实现)
| 讨论点 | 结论 |
|---|---|
| RPA 编码唯一性(跨机器) | 由服务端账号体系解决:账号与机器/Profile 解耦 |
| RPA 与账号绑定、启停控制 | 单账号下,账号即身份,投递会话已有单实例约束 |
| 账号找回 | 使用服务端账号密码,账号常驻服务端,无需找回机制 |
四、实施顺序
- 服务端账号密码体系(优化项 1)
- auth.py 密码哈希 → models.py → schemas.py → register.py 路由
- 客户端登录/注册(优化项 1 客户端部分)
- server_api.py → web/app.py → 前端表单
- Boss登录活体检测(优化项 2)
- web/app.py detect-login → 前端自动检测
- RPA 在线判定(优化项 4)
- 服务端 heartbeat 接口 → 客户端心跳线程 → 前端徽章
五、决策记录
| 议题 | 选项 | 最终决定 |
|---|---|---|
| 账号规模 | 单账号 / 多账号多开 | 单账号 |
| Boss登录检测时机 | 自动检测 / 手动按钮 / 两者 | 进入登录步骤自动检测 |
| 系统登录模式 | 纯编码自动 / 账号密码 / 混合 | 账号密码登录 |
| 账号找回 | 需要 / 不需要 | 不需要(服务端账号密码天然解决) |