Files
jianli-boss/README.md
T
2026-08-25 19:03:41 +08:00

167 lines
6.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`