# 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`