This commit is contained in:
2026-08-25 19:03:41 +08:00
commit e1416994bc
34 changed files with 3266 additions and 0 deletions
+166
View File
@@ -0,0 +1,166 @@
# 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`