7.9 KiB
7.9 KiB
Boss直聘 AI 智能投递系统
基于 AdsPower 指纹浏览器 + Playwright + AI 大模型 的客户端-服务端架构自动求职投递系统。 支持多用户数据隔离,每个客户端以机器硬件指纹作为唯一编码注册。
系统架构
┌──────────────────────────────────────────────┐
│ Python 客户端(本地 Windows) │
│ · 本地 Web 控制面板(浏览器打开操作) │
│ · AdsPower 指纹浏览器 + Playwright 自动化 │
│ · 机器硬件指纹 → 唯一编码 │
└────────────────────┬─────────────────────────┘
│ HTTP + JWT Token
▼
┌──────────────────────────────────────────────┐
│ FastAPI 服务端(云服务器) │
│ · 用户注册 / JWT 认证 │
│ · 简历管理(主简历标记) │
│ · 投递会话 + 投递记录(按 user_id 隔离) │
└────────────────────┬─────────────────────────┘
▼
MySQL 数据库
业务流程
- 连接:客户端用机器指纹注册云端,获取 Token
- 登录:面板引导,通过 AdsPower 打开 Boss直聘,用户手动登录
- 简历:AI 自动抓取账号内所有简历 → 用户勾选主简历
- 投递:设置城市/薪资/关键词 → 点击开始,AI 按主简历匹配 JD 自动投递
- 记录:实时查看进度、历史与统计,随时结束
目录结构
jianli-boss/
├── server/ # 云端服务端(FastAPI + MySQL)
│ ├── main.py # 服务入口
│ ├── config.py # 配置(读 .env)
│ ├── database.py # MySQL 连接
│ ├── models.py # ORM 模型
│ ├── schemas.py # Pydantic 模式
│ ├── auth.py # JWT 认证
│ ├── routers/ # API 路由
│ │ ├── register.py # 注册 / 登录状态
│ │ ├── resumes.py # 简历管理
│ │ ├── sessions.py # 投递会话
│ │ └── jobs.py # 投递记录
│ ├── requirements.txt
│ └── .env.example
│
└── client/ # 本地客户端
├── main.py # 客户端入口(启动 Web 面板)
├── config.py # 配置(读 .env)
├── fingerprint.py # 机器硬件指纹
├── server_api.py # 调用云端 API
├── ai.py # AI 评分 / 简历整理
├── browser/
│ ├── manager.py # AdsPower + Playwright 管理
│ ├── resume_scraper.py # 抓取简历
│ └── applicant.py # 投递自动化(可启停)
├── web/
│ ├── app.py # 本地控制面板后端
│ ├── templates/index.html
│ └── static/ # style.css / app.js
├── requirements.txt
└── .env.example
一、部署服务端(云服务器)
1. 准备 MySQL 并初始化表结构
# 直接执行初始化脚本(含建库 + 建表,服务端不会自动建表)
mysql -uroot -p < docs/schema.sql
表结构以
docs/schema.sql为唯一标准,修改server/models.py后需同步更新该脚本。
2. 安装依赖
cd server
pip install -r requirements.txt
cp .env.example .env # 编辑 .env 填写数据库密码和 SECRET_KEY
3. 启动
# 开发模式
uvicorn server.main:app --host 0.0.0.0 --port 8000 --reload
# 生产模式(建议用 gunicorn + uvicorn worker,或配 Nginx 反代 + HTTPS)
uvicorn server.main:app --host 0.0.0.0 --port 8000 --workers 4
启动后访问 http://服务器IP:8000/docs 可查看自动生成的 API 文档(Swagger)。
⚠️ 生产环境务必修改
.env中的SECRET_KEY,并建议通过 Nginx 配置 HTTPS。
替代方式:Docker 一键启动(推荐)
无需手动装 MySQL,项目根目录已提供 docker-compose.yml + server/Dockerfile:
# 1. 准备环境变量(可选,不改则用默认值)
copy .env.example .env # 然后修改 DB_PASSWORD / SECRET_KEY
# 2. 构建并启动(MySQL + 服务端)
docker compose up -d --build
# 3. 查看运行状态 / 日志
docker compose ps
docker compose logs -f server
# 4. 停止(-v 会同时删除数据库数据,慎用)
docker compose down
说明:
- 数据库初始化:
docs/schema.sql已挂载到 MySQL 的docker-entrypoint-initdb.d, 全新数据卷首次启动时自动执行一次;服务端本身不自动建表 - 若数据卷已存在(之前启动过)但未初始化过表,手动补执行:
docker exec -i jianli-boss-mysql mysql -uroot -p${DB_PASSWORD:-root123456} < docs/schema.sql - MySQL 带健康检查,服务端会等数据库就绪后再启动
- 数据持久化在
mysql_data卷中,重启容器不丢数据 - 服务端映射到宿主机
8000端口,客户端.env保持SERVER_URL=http://127.0.0.1:8000即可 - 老库升级(缺新增字段时):
ALTER TABLE job_applications ADD COLUMN jd_text TEXT NULL, ADD COLUMN greeting VARCHAR(500) NULL;
二、运行客户端(本地 Windows)
1. 浏览器准备(默认无需安装)
默认 BROWSER_MODE=chrome:自动探测本机 Chrome(其次 Edge),
以独立 profile 目录启动并持久化 Boss直聘 登录态,免费且反检测最好。
如需使用指纹浏览器,在 client/.env 设 BROWSER_MODE=adspower 并填写 ADSPOWER_USER_ID。
2. 安装依赖
cd client
pip install -r requirements.txt
playwright install chromium
3. 配置环境变量
复制 .env.example 为 .env 并填写:
SERVER_URL=http://你的服务器IP:8000 # 云端服务端地址
BROWSER_MODE=chrome # chrome=本机真实浏览器(默认)/ adspower=指纹浏览器
AI_API_KEY=你的大模型Key # AI 评分用
AI_BASE_URL=https://api.deepseek.com # OpenAI 兼容接口
AI_MODEL=deepseek-chat
4. 启动
# 确保 AdsPower 软件已打开
python -m client.main
浏览器会自动打开控制面板 http://127.0.0.1:8088,按 5 个步骤操作即可。
三、关于中文乱码
所有文件读写均已指定 encoding="utf-8"。若 PowerShell 控制台仍乱码,运行:
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
chcp 65001
常见问题
| 问题 | 解决方案 |
|---|---|
| 客户端连不上服务端 | 检查 SERVER_URL 是否正确、云服务器安全组是否放行端口 |
| 注册一直失败 | 确认服务端已启动且 MySQL 可连接 |
| 无法打开浏览器 | chrome 模式:确认本机装有 Chrome/Edge;adspower 模式:确认 AdsPower 已运行且 ADSPOWER_USER_ID 正确 |
| 抓不到简历 | 确认已登录 Boss直聘;页面结构变化时需调整 resume_scraper.py 选择器 |
| AI 评分不生效 | 检查 AI_API_KEY 是否配置,AI_BASE_URL/AI_MODEL 是否匹配 |
| 投递按钮找不到 | Boss直聘 前端改版,需更新 applicant.py 中的选择器 |
安全与合规提示
- 请遵守 Boss直聘 的用户协议,控制投递频率(建议每天 ≤30 个),避免账号风险
SECRET_KEY、数据库密码、AI Key 等敏感信息请勿提交到代码仓库- 建议将
.env、.token、logs/加入.gitignore