automatic-boss-delivery

BOSS 直聘自动投递助手 —— 登录、找工作、简历匹配、写招呼语、一键投递，一条龙跑通。

上传简历（Word / PDF / 纯文本都行）→ 按筛选条件搜索职位 → 调用你自己配置的 AI 生成个性化招呼语 → 确认后一键投递。全部协议走真实接口，不做前端界面模拟。

登录 ──► 找职位 ──► 简历匹配 ──► AI 写招呼语 ──► 一键投递

不想碰命令行？ 直接下打包好的 zip，解压就能用——到 Releases 页面的 Assets 里下 BossAutoDelivery-x.y.z.zip，无需 Python、无需 venv：

• GitHub：https://github.com/handsomekai924/boss-automatic-delivery/releases
• Gitee（国内下载更快）：https://gitee.com/w-kev/boss-automatic-delivery/releases

装好后有新版本会在网页里提示，点「立即更新」就地升级，不用再手动下一次。 想自己打包见 打包成 zip 分发。

所有功能的入口，也是程序启动后的首屏。

短信验证码 + 极验滑块四步走。滑块由你本人拖动官方组件。

按条件分页抓取、卡片化浏览、选中即抓 JD。翻页硬间隔 1 秒防风控，随时可停。

上传简历（Word / PDF / 纯文本），AI 按固定模板整理成结构化结果——这就是「看匹配」页要吃的那份数据。

OpenAI 兼容协议（DeepSeek / Kimi / 本地 vLLM 都行）。Key 只存本地 data/boss.db，回显打码，模型名从接口在线拉取。没配过的新用户，页面上有分步图文引导 + DeepSeek 一键预设。

配置采集参数，如城市 / 求职类型 / 薪资 / 经验 / 学历 / 行业 / 规模，增加了黑名单规则配置。

选好简历后一键匹配全部，AI 并行出匹配度、优缺点与个性化招呼语。

点开任意结果卡片看全貌：匹配分析、技能匹配、缺口、优点、缺点，一路拉到底还有可改的招呼语与「发送」按钮。

• Python 3.10+（开发环境为 3.12）—— 用打包好的 exe 则不需要
• Chrome 浏览器（抓 __zp_stoken__ 时走 CDP 拉起真浏览器）
• 一个能收短信的手机号（登录用）

# github
git clone https://github.com/handsomekai924/boss-automatic-delivery.git
# gitee
git clone https://gitee.com/w-kev/boss-automatic-delivery.git
cd boss-automatic-delivery

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate

pip install -r requirements.txt

依赖：requests · cryptography · websocket-client · paho-mqtt · fastapi · uvicorn · python-multipart · python-docx · pypdf

给不用命令行的人准备的：一个 zip，解压进哪个目录，哪个目录就是安装目录。 目标机器上不需要 Python、不需要 venv、不需要 pip。

用 onedir（BossAutoDelivery.exe + _internal\）而不是单文件 exe：启动快， 而且自己换得动自己——单文件 exe 会把自己解到 %TEMP% 再跑，升级时没法就地 替换，也没法让旁边的 data\ 跟着安装目录走。

不用自己打包，去 Releases 页面的 Assets 里下 BossAutoDelivery-x.y.z.zip：

解压后先跑 BossAutoDelivery\BossAutoDelivery.exe --self-check 可核对完整性，确认没问题再双击启动。

pip install -r requirements.txt -r requirements-build.txt
packaging\build.bat
# 先清空 dist\，再产物：
#   dist\BossAutoDelivery\                 安装目录（exe + _internal\）
#   dist\BossAutoDelivery-1.2.3.zip        发到 Gitee Release 附件的那个包

每次打包都会先删掉整个 dist\。旧布局残留（onefile 的 BossAutoDelivery.exe、 跑过一次生成的 data\）混在产物里，很容易把错的东西发出去；要留档就先拷走。

打包后数据跟着安装目录走（便携），跑起来之后同目录下会生成：

BossAutoDelivery\                 ← 解压出来的安装目录
  BossAutoDelivery.exe
  _internal\                      程序本体（库 / 资源），升级时整换
  data\
    boss.db                       # 简历 / 登录态 / 职位 / AI 配置，全在这一个文件里
    chrome_profile\               # 取安全令牌用的 Chrome 工作目录
    logs\boss.log                 # 出问题时把日志发出来即可

目录语义：_internal\ 和 BossAutoDelivery.exe 是程序文件，升级时整目录换掉； data\ 是用户数据，升级时一个字节都不动。挪机器就整个文件夹拷走。

几条要知道的事：

• 别在压缩包里直接双击。Windows 会先解压到临时目录再运行，数据会写进 %TEMP% 并在退出时清掉；程序检测到这种情况会在首页顶部弹红条提醒你。
• 放在 C:\Program Files 这类写不进去的目录时，数据会自动改存到 %LOCALAPPDATA%\BossAutoDelivery\data\，首页会告诉你实际路径。
• 想核对打包有没有缺东西，跑 BossAutoDelivery.exe --self-check，会打印 资源根 / 前端目录 / 状态库 / 日志目录 / Chrome 检测结果 / 当前版本。
• 首次运行 Windows 可能弹「已保护你的电脑」（exe 没有代码签名）。点 更多信息 → 仍要运行。这是无签名 exe 的通病，不是程序有问题。

打包定义在 packaging/boss_web.spec，要点全写在注释里。改依赖后记得同步 hiddenimports——uvicorn / python-docx / segno 都靠动态导入，漏一个就是 「双击闪退」或「二维码裂图」。构建脚本会在打包前挡一道，缺什么直接报给你。

检测到新版本时网页会弹窗，点**「立即更新」**就地升级，不用再进 Gitee 手动下：

1. 程序从 Gitee Release 附件下载 zip（弹窗上有下载百分比）。
2. 校验 zip 能解开、里面有 BossAutoDelivery.exe，再生成一个 %TEMP% 下的 apply_update.bat（黑窗会短暂出现，是正常的）。
3. bat 先验后删：zip 不在 / 解压不出 exe 就直接退出，安装目录一个文件都不动； 确认无误才停掉当前服务、换掉程序文件（保留 data\）、按原来的端口重启。
4. 全程 WebSocket 推进度；换文件那几秒页面会断开，新服务起来后自动接上， 显示「更新完成」并把当前标签页刷到新版本上（不会关掉标签页）。
5. 失败的话黑窗会停在原因上按任意键关闭，日志在 %TEMP%\BossAutoDelivery-update\update.log——把它发出来就能定位。

更新只在「装在本地目录里的 exe」上提供：源码跑请用 git pull，在压缩包预览里 跑请先解压——这两种情况弹窗里不会出现「立即更新」按钮。

把新版本发成 Release 时，按这个来，否则用户的「立即更新」会挑不到包：

1. boss_web/__init__.py 的 __version__ 改成新号，和 git tag 保持一致。
2. packaging\build.bat 打出 dist\BossAutoDelivery-x.y.z.zip。
3. 在 Gitee 建 Release（版本判断只认 Gitee），tag 用 vx.y.z 或 x.y.z 都行。
4. 把 zip 作为附件挂上去，名字以 BossAutoDelivery 开头、.zip 结尾。
5. 不要勾选「预发布」——预发布会被跳过。发行说明写中文即可，弹窗只显示开头一段。

python -m boss_web
# 默认 http://127.0.0.1:8787 ，浏览器会自动打开（端口被占用会往后顺延）

自定义监听：

python -m boss_web --host 0.0.0.0 --port 8787

打开控制台后按页面顺序走：

1. 登录 —— 填手机号收码（滑块验证时按页面提示在浏览器里完成拼图），或切到「APP 扫码登录」用手机 BOSS APP 扫二维码确认
2. 找职位 —— 配置筛选条件，一键分页搜索，浏览 / 管理职位库
3. 上传简历 —— 传 .docx / .pdf / .md / .txt，自动触发解析
4. AI 设置 —— 填自己的 API Key / 接口地址 / 模型名，先「测试连接」再保存；页面上有分步图文引导
5. 看匹配 —— 选职位跑匹配，看卡片弹窗里的招呼语，不满意可重新匹配
6. 投递 —— 就在「看匹配」页里，确认后一键投递

# 1. 登录
python -m boss_login login --phone 13800138000   # 短信验证码
python -m boss_login qr                          # APP 扫码（终端出二维码，手机 BOSS APP 扫）
python -m boss_login whoami                      # 看当前登录用户
python -m boss_login logout                      # 清本地登录态

# 2. 看筛选项（想导出完整表给配置用）
python -m boss_filter show
python -m boss_filter export --out filters.json

# 3. 抓职位
python -m boss_jobs fetch                    # 翻页抓，抓一页入库一页，页间睡 1s
python -m boss_jobs fetch --max-pages 3      # 只抓 3 页
python -m boss_jobs stats                    # 库里汇总：条数 / 页数 / 城市分布
python -m boss_jobs list --city 广州          # 按城市列职位

复制模板后按需改，code 用 python -m boss_filter export 查表：

cp search_filter.example.json search_filter.json

{
  "query": "",
  "city": "",
  "jobType": "",
  "salary": "",
  "experience": [],
  "degree": [],
  "industry": [],
  "scale": [],
  "pageSize": 15
}

留空 = 该维度「不限」。

boss_login/    手机验证码登录客户端（发码 / 登录 / 探测接口 / 滑块协作）
boss_filter/   筛选条件获取（真实 wapi + 内置兜底表）
boss_jobs/     职位分页抓取 · __zp_stoken__ 计算 · 聊天通道（MQTT + protobuf）
boss_db/       统一状态库（SQLite）：会话 / 搜索条件 / LLM 配置 / 简历 / 职位
boss_web/      FastAPI 服务 + 原生前端工作台
packaging/     PyInstaller 打包定义（onedir 目录包 + 发行 zip）
tools/         开发辅助（mock server 等）
tests/         pytest 测试套件

boss_web/ 里几块值得单独说：

只有一份库 data/boss.db（SQLite）：

路径覆盖顺序：显式 path → 环境变量 BOSS_DB → data/boss.db。

data/ 已在 .gitignore 里，不会被提交。想备份就把 data/boss.db 拷走。 打包成 zip 后 data/ 在安装目录里（见 打包成 zip 分发）。

# 用项目自带的 .venv，别用系统 Python——依赖全在 venv 里
.venv\Scripts\python.exe -m pytest
# macOS / Linux: .venv/bin/python -m pytest

pytest 不在 requirements.txt 里（那是运行依赖），首次跑先 pip install pytest。

• 真实协议，不做界面模拟 —— 登录、搜索、投递都按站点真实接口 / 真实帧格式走
• __zp_stoken__ 全自动 —— 搜索接口没带这个 Cookie 会回 code:37 并下发一次性挑战；项目用真 Chrome（CDP）本地算出令牌，同名 Cookie 先清再写
• 翻页边界已踩过 —— hasMore 在第 1 页不可信，翻页节流默认 1s，中途断了已入库的页不丢
• 分析结果原地更新 —— 重跑 / 重算类功能 UPDATE 不新插，复用库里已有职位数据
• 滑块是人机协作 —— 不是绕过风控：脚本出图，人来拼
• 报错说人话 —— 打包版面向非技术用户，异常统一翻译成「哪儿错了 + 怎么改」； StokenError、上游 HTTP 响应体、requests 栈信息这类原文只进 data/logs/boss.log， 不摆到界面上（翻译规则见 boss_web/services/troubleshoot.py）
• 风控节流 —— 抓取频率压到人手滚动的量级，请不要调高并发去压接口

本项目仅供学习与技术研究使用。使用即表示你同意：

1. 遵守 BOSS 直聘的用户协议与法律法规，账号行为自负
2. 不得用于批量骚扰、数据倒卖或任何商业牟利用途
3. 控制抓取频率，不要对目标站点造成压力
4. 因使用本项目导致的任何账号限制、封禁或法律后果，作者不承担责任

若平台方认为本项目不妥，联系即下架。

MIT