Files
jianli-boss/README.md
T
2026-08-25 22:53:57 +08:00

201 lines
7.9 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 并初始化表结构
```bash
# 直接执行初始化脚本(含建库 + 建表,服务端不会自动建表)
mysql -uroot -p < docs/schema.sql
```
> 表结构以 `docs/schema.sql` 为唯一标准,修改 `server/models.py` 后需同步更新该脚本。
### 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。
### 替代方式:Docker 一键启动(推荐)
无需手动装 MySQL,项目根目录已提供 `docker-compose.yml` + `server/Dockerfile`:
```bash
# 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. 安装依赖
```powershell
cd client
pip install -r requirements.txt
playwright install chromium
```
### 3. 配置环境变量
复制 `.env.example` 为 `.env` 并填写:
```ini
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. 启动
```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 可连接 |
| 无法打开浏览器 | 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`