跳到正文
GitHub·· 6 天前AI 评分50

KuroNya39 开源 BOSS直聘候选人 AI 评分助手:自动提取简历、打分并导出 Excel

KuroNya39/boss-candidate-tool

AI 导读

KuroNya39 发布开源桌面工具 boss-candidate-tool,可从 BOSS直聘推荐牛人页、搜索页、沟通页提取候选人简历,按岗位要求用 AI 打出 0-100 匹配分并生成评语,结果导出 Excel 并可发送至邮箱。

正文

一个帮你「从 BOSS直聘招人」的桌面助手:它会帮你从 BOSS直聘提取候选人简历,把每位候选人的简历按岗位要求用 AI 评分,自动给分数达标的候选人打招呼,最后把所有结果整理成 Excel 表格发给你。

AI 评分仅供参考,录用与否请以专业判断为准。


功能

  • 提取候选人信息:逐个提取候选人基础信息与简历正文
  • AI 评分:按照岗位要求,给每位候选人打出 0-100 的匹配分,并写出评语
  • 导出 Excel:整理候选人信息、AI 评分与评语,生成 Excel 表格(可发送至邮箱)
  • 自动打招呼(可选):评分完成后,自动给分数达标的候选人发送打招呼消息(仅「推荐牛人页」支持)

支持从以下三种页面提取:

提取来源 所在页面 适用场景
推荐牛人页 BOSS直聘「推荐牛人」 系统按招聘要求推荐的候选人
搜索页 BOSS直聘「搜索」 按关键词自行检索的候选人
沟通页 BOSS直聘「沟通」 已与你沟通的候选人

使用前提

  • Windows 电脑 + Chrome 浏览器
  • BOSS直聘招聘端账号
  • AI 服务地址(Anthropic 兼容格式,首次使用时配置一次即可)

安装

从 GitHub Releases 页面 下载最新版本:

  • 安装包(推荐):下载 Boss.AI.Setup.1.x.x.exe,双击后按照提示完成安装
  • 绿色版:下载 win-unpacked.zip,解压后运行 BOSS直聘候选人AI评分助手.exe

快速开始

第 1 步:开启 Chrome 远程调试

  1. 打开 Chrome 浏览器,在地址栏输入以下内容并回车:
    chrome://inspect/#remote-debugging
    
  2. 勾选「Allow remote debugging for this browser instance」
  3. 完全退出后重新启动 Chrome

Chrome 远程调试开关位置

第 2 步:登录 BOSS直聘

打开 Chrome,进入 BOSS直聘招聘端并登录账号。

第 3 步:启动软件,确认连接正常

双击 BOSS直聘候选人AI评分助手.exe 启动软件,查看软件最上方的连接状态:

  • 🟢 绿色:连接正常
  • 🟡 黄色:正在连接,稍等几秒
  • 🔴 红色:未连接,点「重试」,或检查第 1 步

软件主界面

第 4 步:完成设置

点击「⋮」→「设置」,填写以下四项信息:

  • API 地址:打开公司 AI API 系统,点击「我的 API Key」,选择 Anthropic 格式,复制并粘贴 API URL
  • API Key:复制并粘贴个人 API Key
  • 模型名称:例如 deepseek-v4-flash_DeepSeek(也可填写系统内其他可用模型)
  • 邮箱信息(可选):填写完整邮箱地址及邮箱密码,结果 Excel 会自动发送到你的邮箱。若邮箱开启了「三方客户端安全密码」功能,须填写该密码,而非邮箱登录密码

点击「保存」,出现绿色「设置已保存」提示即完成。

AI API 系统界面

「设置」弹窗界面

第 5 步:添加岗位

  1. 点击「请选择岗位」→「+ 添加新岗位」

  2. 岗位名称:填写岗位名(建议带上城市和薪资,便于区分),例如:

    AI大模型工程师 _ 深圳 30-50K
    
  3. 岗位描述:⚠️ 请勿直接粘贴岗位 JD。将岗位 JD 连同以下提示词发送给任一聊天 AI(如 DeepSeek、Kimi、千问等),把岗位 JD 转换成软件需要的格式:

    请基于以上岗位 JD,完成以下两项分析任务。
    
    任务一:提取核心评估维度
    从 JD 中识别出最核心的 3 个评估维度,并为每个维度分配权重,三项权重之和须为 100%。严禁提取学历、证书等任职资格关键筛选项已包含的内容。
    
    任务二:提取任职资格关键筛选项
    从 JD 中提取出所有可量化的、客观的筛选条件,至少包括但不限于:学历、专业、工作经验年限、行业背景、专业技能/证书、其他强制性条件。严禁提取沟通能力、团队协作能力等软性素质。
    
    输出格式:
    核心评估维度及权重
    1. [评估维度名称]([权重]%):[具体要求]
    2. [评估维度名称]([权重]%):[具体要求]
    3. [评估维度名称]([权重]%):[具体要求]
    任职资格关键筛选项
    1. 学历要求:[具体要求]
    2. 经验要求:[具体要求]
    3. 行业/领域要求:[具体要求]
    4. 技能/证书要求:[具体要求]
    5. 其他硬性条件:[具体要求,如无则填“无”]
    
  4. 将 AI 生成的内容复制并粘贴到「岗位描述」输入框中,点击「保存」。

编辑岗位弹窗界面

第 6 步:调整运行配置并开始

  1. 在 Chrome 中打开对应的 BOSS直聘页面,并设置好筛选条件
  2. 选择「提取来源」:推荐牛人页 / 搜索页 / 沟通页
  3. 选择「目标岗位」(推荐牛人页和搜索页需要)
  4. 填写「提取数量」(如 20);沟通页可勾选「提取全部」
  5. 勾选「开启模拟复制提取」(可选):开启后画布型简历提取更快更准,但提取时会短暂占用系统剪贴板,建议在电脑闲置时开启
  6. 勾选「完成后自动打招呼」(可选):评分完成后,自动给分数达标的候选人发送打招呼消息(仅「推荐牛人页」支持)
  7. 点击「开始提取分析」

⚠️ 重要:运行中的注意事项

1. 提取结束前请勿「最小化」Chrome

进行步骤 1「提取候选人信息」时,最小化 Chrome 会冻结页面渲染,导致页面变形、内容缺漏。想一边提取一边用电脑做别的事时,用其他窗口盖住 Chrome 即可。

2. 请勿把 BOSS直聘切到后台标签页

BOSS直聘切到后台标签页时,模拟复制和截图都会失效。请让它保持在独立 Chrome 窗口的前台标签页,该窗口被其他窗口盖住也不影响提取。

3. 只保留一个 BOSS直聘标签页

运行期间如需使用 BOSS直聘,请用手机端操作。

4. 非 VIP 每日查看数量有限

非 BOSS直聘 VIP 账号每天在「推荐牛人页」可查看的候选人数量有限,建议优先使用「搜索页」提取。

5. 建议在闲置电脑上运行

推荐午休或下班前启动,运行期间软件会阻止电脑进入自动锁定 / 睡眠状态。


日常使用

三种提取来源说明

  • 推荐牛人页:顶部「推荐 / 精选 / 最新」均可使用;单次最多提取 450 人(网站限制)
  • 搜索页:没有批量打招呼选项(搜索页打招呼需要使用单独付费的畅聊卡),请根据评分结果自行联系
  • 沟通页:支持「提取全部」,可提取当前列表全部候选人

运行过程

整体流程为:① 提取候选人信息 → ② AI 评分 → ③ 导出 Excel。提取满 15 人后,评分与提取同时进行。

  • 跳过提取:提取过程中可跳过剩余候选人,用已提取的数据开始 AI 评分
  • 暂停 / 继续:随时可暂停,读完当前候选人后停止
  • 取消:中途取消会保留进度,可在「⋮」→「历史记录」中对该批次「继续提取」

速度参考

  • 直接提取简历文字:约 10 分钟跑完 100 人
  • 模拟「选中复制」提取:约 15 分钟跑完 100 人
  • 截图 OCR 识别:约 20 分钟跑完 100 人

具体时间会因电脑性能和简历页数略有差异。

完成后

全部完成后会显示成功页面,你可以:

  • 查看结果:提取 / 通过人数、平均分、通过率、档位分布与候选人 AI 评语
  • 打开输出目录:查看每位候选人的简历全文(txt 或截图)和结果 Excel
  • 批量打招呼:选一个分数档位,自动给分数达标的候选人发送打招呼消息(仅「推荐牛人页」支持)
  • 重新开始:再跑一批

分数档位

AI 会根据岗位描述里的 3 个核心评估维度(带权重)给候选人打分,再根据学历、经验、技能等硬性条件核减分数,最后得出 0-100 分。

档位 分数门槛 评分结果
五星 91 分以上 强烈推荐
四星及以上(默认) 81 分以上 推荐
三星及以上 61 分以上 可考虑
二星及以上 31 分以上 暂不推荐
全部候选人 不限制 全部

上表为打招呼时可选的分数范围,默认「四星及以上」。

历史记录

点击「⋮」→「历史记录」,可对每个批次执行以下操作:

  • 继续提取:可从步骤 1「提取候选人信息」中断处继续提取,仅最近 3 批可用
  • 删除:删除该批次本地数据
  • 打开目录:查看该批次每位候选人的简历全文(txt 或截图)和结果 Excel
  • 评分:直接使用该批次已提取的数据进行评分

常见问题

1. 遇到任何问题,先试试重启

遇到任何问题,请先关闭本软件和 Chrome 浏览器,重新启动再试。

2. 运行期间会影响我用电脑吗?

不会。仅勾选「开启模拟复制提取」时,提取画布简历的几秒内会占用系统剪贴板。

3. 候选人提取不到 / 数量不对

进行步骤 1「提取候选人信息」时请勿最小化 Chrome,也勿把 BOSS直聘切到后台标签页(见「运行中的注意事项」第 1、2 条)。

4. AI 评分不准

  • 确认岗位描述已按第 5 步提示词进行转换,请勿直接粘贴原始岗位 JD
  • 岗位描述(核心评估维度及权重、任职资格关键筛选项)可根据实际情况自行调整
  • 评分前选中正确岗位

5. AI 评分失败 / 全部 0 分

  • 确认「⋮」→「设置」中 API 地址 / API Key / 模型名称填写完整
  • 检查 API Key 是否失效、网络是否连通

6. 邮件收不到

  • 确认邮箱填写无误
  • 开启「三方客户端安全密码」的邮箱须填客户端安全密码
  • 偶尔会进垃圾箱,去垃圾箱找找看

隐私与数据

  • 软件通过你自己的 Chrome 访问 BOSS直聘,不登录你的任何账号,也不修改任何数据
  • 候选人数据仅保存在本地,不上传到任何服务器
  • AI 评分请求仅发送至你配置的 API 地址,不涉及第三方

致谢

感谢应用工具开发部的伙伴们在项目早期孵化与后续迭代中的持续支持。


给开发者的话

  • 技术栈:Electron + Node.js,通过 Chrome DevTools 协议(CDP)代理控制浏览器
  • 主要模块:
    electron/main.mjs                         主进程入口(生命周期、--score-only 无界面评分)
    electron/score-comment.mjs                评语→评分计算与学历门槛兜底扣分(主进程/重算脚本共用)
    electron/*.mjs                            其余主进程模块:流程编排、IPC、浏览器与代理管理、评分、打招呼、归档
    electron/renderer/                        界面(index.html + 6 个 CSS + renderer-*.js,均按序引入)
    scripts/cdp-proxy.mjs                     HTTP → WebSocket 代理,控制 Chrome(端口 3456)
    scripts/extract-common.mjs                提取脚本共用工具(CDP 调用、截图 OCR、进度续跑)
    scripts/extract-recommend-candidates.mjs  推荐牛人页提取
    scripts/extract-search-candidates.mjs     搜索页提取
    scripts/extract-candidates-full.mjs       沟通页提取
    scripts/greet-candidates.mjs              批量打招呼
    scripts/export-candidates.mjs             Excel 导出(邮件见 send-candidates-email.mjs)
    scripts/score-tiers.mjs                   档位阈值与推荐级别常量(打分/打招呼/导出/统计共用)
    scripts/degree.mjs                        学历词汇表(提取/评分/导出共用)
    scripts/format-comment.mjs                评语排版(界面与 Excel 共用)
    config/scoring-prompt-*.txt               AI 评分提示词模板
    %AppData%\web-access\web-access\jd-descriptions\   岗位描述(存用户数据目录,升级不丢)
    
  • 常用命令:
    npm install                 # 安装依赖
    npm start                   # 开发模式运行
    node scripts/cdp-proxy.mjs  # 单独跑 CDP 代理(调试)
    npm run pack                # 打包发布(icon → electron-builder → NSIS → release)
  • 详细开发文档见 CLAUDE.md

使用许可(License)

本软件采用 PolyForm Noncommercial License 1.0.0 许可协议:

  1. 允许非商业使用:个人学习、研究、实验、爱好项目,以及学校、慈善机构、公立科研机构、公共安全与卫生机构、环保组织、政府机构等非营利主体,均可免费使用、修改、分发本软件
  2. 必须署名:转发、分发或二次开发时,必须保留版权声明(Required Notice: Copyright © 2026 KuroNya39),并附上协议全文或协议网址
  3. 禁止商用:不得将本软件(或基于本软件修改的版本)用于任何商业目的,包括公司或其他组织在经营活动中使用,或用于获取商业利益

完整协议见 LICENSE.md,也可查看 PolyForm 官网。

如需商业授权或其他授权,请通过 https://github.com/KuroNya39 联系作者。

来源:GitHub · github.com