<div align="center">

# BOSS HR Agent Toolkit

### 面向 BOSS 直聘招聘端的本地招聘工作流智能体工具箱

**让程序负责确定性，让模型负责不确定性。**

[](https://github.com/1xiaoyueryuer/boss-hr-agent-toolkit/releases) [](https://www.python.org/) [](#运行环境) [](#统一-cli) [](#工程可靠性) [](LICENSE)

[快速开始](#快速开始) · [设计理念](#为什么这样设计) · [CLI 文档](docs/CLI_WORKFLOW.md) · [Agent Skill](boss-hr-auto/SKILL.md) · [更新日志](CHANGELOG.md)

</div>

---

## 项目简介

BOSS HR Agent Toolkit 是一套目前**仅适配 BOSS 直聘招聘端**的本地招聘流程工具。

它将岗位信息获取、候选人简历归档、逐位 LLM 评分、结果汇总、HTML 报告以及受控打招呼，组织成一条具有明确状态、数据边界和人工确认节点的工作流。

```text 岗位解析 → 人工确认 → 候选人获取 → 逐位评分 → 报告生成 → 可选打招呼 ```

它不是一个让模型在网页里自由发挥的“全自动机器人”，也不是一组只能按固定顺序运行的散装脚本。

项目真正关注的是：

> 在真实业务中，如何把浏览器、脚本、LLM、Agent、状态管理和人工决策组合成一套可运行、可测试、可追踪的系统。

> [!IMPORTANT] > 本项目需要使用者拥有正常可用的 BOSS 招聘账号，并仅处理自己有权访问和使用的招聘数据。项目与 BOSS 直聘官方无隶属、合作或背书关系。

---

## 为什么这样设计

### 为什么不只写脚本？

脚本非常适合确定性任务：

- 连接指定浏览器； - 调用固定业务接口； - 下载和保存候选人资料； - 创建任务目录； - 校验 JSON； - 合并评分结果； - 生成 HTML 报告； - 返回结构化状态和退出码。

但岗位理解、经历匹配、评分理由和异常处置很难全部固化为 `if / else`。当需求变化时，纯脚本往往需要不断增加分支，最终形成难以维护的流程系统。

### 为什么不让 Agent 直接连接 CDP？

Agent 直接读取页面并自由点击非常灵活，但关键操作会变得难以预测：

- 可能误判页面状态或点击错误元素； - 可能重复执行已经完成的步骤； - 可能读取错误的历史任务； - 可能跳过本应等待用户确认的节点； - 页面变化后，执行路径可能完全不同； - 很难通过离线测试证明核心数据流稳定。

### 本项目的选择

| 层级 | 负责什么 | 为什么 | |---|---|---| | **Patchright + Edge CDP** | 浏览器连接与页面执行 | 复用专用 Edge 中的真实登录会话 | | **Python 业务脚本** | 下载、校验、存储、合并、报告 | 确定性强，可以测试和复现 | | **统一 CLI** | 参数、输出、状态、退出码 | 为不同 Agent 提供稳定工具边界 | | **LLM** | JD 理解、候选人语义评估 | 处理难以写死的语义判断 | | **Agent*