167 lines
6.2 KiB
Markdown
167 lines
6.2 KiB
Markdown
# Boss直聘 AI 智能投递系统
|
||
|
||
基于 **AdsPower 指纹浏览器 + Playwright + AI 大模型** 的客户端-服务端架构自动求职投递系统。
|
||
支持多用户数据隔离,每个客户端以机器硬件指纹作为唯一编码注册。
|
||
|
||
---
|
||
|
||
## 系统架构
|
||
|
||
```
|
||
┌──────────────────────────────────────────────┐
|
||
│ Python 客户端(本地 Windows) │
|
||
│ · 本地 Web 控制面板(浏览器打开操作) │
|
||
│ · AdsPower 指纹浏览器 + Playwright 自动化 │
|
||
│ · 机器硬件指纹 → 唯一编码 │
|
||
└────────────────────┬─────────────────────────┘
|
||
│ HTTP + JWT Token
|
||
▼
|
||
┌──────────────────────────────────────────────┐
|
||
│ FastAPI 服务端(云服务器) │
|
||
│ · 用户注册 / JWT 认证 │
|
||
│ · 简历管理(主简历标记) │
|
||
│ · 投递会话 + 投递记录(按 user_id 隔离) │
|
||
└────────────────────┬─────────────────────────┘
|
||
▼
|
||
MySQL 数据库
|
||
```
|
||
|
||
## 业务流程
|
||
|
||
1. **连接**:客户端用机器指纹注册云端,获取 Token
|
||
2. **登录**:面板引导,通过 AdsPower 打开 Boss直聘,用户手动登录
|
||
3. **简历**:AI 自动抓取账号内所有简历 → 用户勾选主简历
|
||
4. **投递**:设置城市/薪资/关键词 → 点击开始,AI 按主简历匹配 JD 自动投递
|
||
5. **记录**:实时查看进度、历史与统计,随时结束
|
||
|
||
---
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
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
|
||
```sql
|
||
CREATE DATABASE jianli_boss DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||
```
|
||
|
||
### 2. 安装依赖
|
||
```bash
|
||
cd server
|
||
pip install -r requirements.txt
|
||
cp .env.example .env # 编辑 .env 填写数据库密码和 SECRET_KEY
|
||
```
|
||
|
||
### 3. 启动
|
||
```bash
|
||
# 开发模式
|
||
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。
|
||
|
||
---
|
||
|
||
## 二、运行客户端(本地 Windows)
|
||
|
||
### 1. 安装 AdsPower
|
||
- 前往 [adspower.net](https://www.adspower.net) 下载安装
|
||
- 创建一个浏览器 Profile,记住它的 **用户 ID**
|
||
|
||
### 2. 安装依赖
|
||
```powershell
|
||
cd client
|
||
pip install -r requirements.txt
|
||
playwright install chromium
|
||
```
|
||
|
||
### 3. 配置环境变量
|
||
复制 `.env.example` 为 `.env` 并填写:
|
||
```ini
|
||
SERVER_URL=http://你的服务器IP:8000 # 云端服务端地址
|
||
ADSPOWER_USER_ID=你的ProfileID # AdsPower 用户 ID(必填)
|
||
AI_API_KEY=你的大模型Key # AI 评分用
|
||
AI_BASE_URL=https://api.deepseek.com # OpenAI 兼容接口
|
||
AI_MODEL=deepseek-chat
|
||
```
|
||
|
||
### 4. 启动
|
||
```powershell
|
||
# 确保 AdsPower 软件已打开
|
||
python -m client.main
|
||
```
|
||
浏览器会自动打开控制面板 `http://127.0.0.1:8088`,按 5 个步骤操作即可。
|
||
|
||
---
|
||
|
||
## 三、关于中文乱码
|
||
|
||
所有文件读写均已指定 `encoding="utf-8"`。若 PowerShell 控制台仍乱码,运行:
|
||
```powershell
|
||
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
||
chcp 65001
|
||
```
|
||
|
||
---
|
||
|
||
## 常见问题
|
||
|
||
| 问题 | 解决方案 |
|
||
|------|---------|
|
||
| 客户端连不上服务端 | 检查 `SERVER_URL` 是否正确、云服务器安全组是否放行端口 |
|
||
| 注册一直失败 | 确认服务端已启动且 MySQL 可连接 |
|
||
| 无法打开浏览器 | 确认 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`
|