2026-09-03 15:47:50 +08:00
2026-08-31 19:18:05 +08:00
2026-09-03 15:47:50 +08:00
2026-08-25 20:20:54 +08:00
2026-09-03 15:47:50 +08:00
2026-09-03 15:47:50 +08:00
2026-08-25 20:06:52 +08:00
2026-08-25 20:06:52 +08:00
2026-08-25 19:03:41 +08:00
2026-08-26 11:41:26 +08:00
2026-09-03 15:47:50 +08:00
2026-08-31 19:18:05 +08:00
2026-08-25 22:53:57 +08:00

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 并初始化表结构

# 直接执行初始化脚本(含建库 + 建表,服务端不会自动建表)
mysql -uroot -p < docs/schema.sql

表结构以 docs/schema.sql 为唯一标准,修改 server/models.py 后需同步更新该脚本。

2. 安装依赖

cd server
pip install -r requirements.txt
cp .env.example .env   # 编辑 .env 填写数据库密码和 SECRET_KEY

3. 启动

# 开发模式
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:

# 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. 安装依赖

cd client
pip install -r requirements.txt
playwright install chromium

3. 配置环境变量

复制 .env.example 为 .env 并填写:

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. 启动

# 确保 AdsPower 软件已打开
python -m client.main

浏览器会自动打开控制面板 http://127.0.0.1:8088,按 5 个步骤操作即可。


三、关于中文乱码

所有文件读写均已指定 encoding="utf-8"。若 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
S
Description
No description provided
Readme
454 KiB
Languages
Python 78.4%
HTML 13.1%
JavaScript 6%
CSS 2.1%
Batchfile 0.3%
Other 0.1%