init
This commit is contained in:
@@ -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`
|
||||
Reference in New Issue
Block a user