Boss Hr Auto

BOSS 直聘 HR 简历筛选全流程

> 🚪 入口声明：本 Skill 是 boss-hr-agent-toolkit 项目唯一入口。下文的 4 个子 Skill（boss-job-detail、boss-resume-downloader、resume-screener、boss-agent-cli）均应按本 Skill 的编排顺序调用，不得作为独立入口加载。

流程总览

用户提供岗位ID/链接
     │
     ▼
[Step 1] 提取 JD ──── 使用 skill: boss-job-detail
     │
     ▼
[Step 2] 下载简历 ── 使用 skill: boss-resume-downloader
     │
     ▼
[Step 3] 评分 ────── 使用 skill: resume-screener
     │
     ▼
[Step 4] 生成报告 ── 汇总评分结构报告 + 沟通建议

❌ 不做：自动回复/打招呼（CLI reply 权限不足，由用户在 BOSS 网页端操作）

---

🔧 辅助脚本 & 参考

| 文件 | 位置 | 用途 | |:----|:----|:----| | browser-fallback-when-cli-down.md | references/browser-fallback-when-cli-down.md | CLI 假阳性时用 CDP 浏览器直接获取 JD+候选人的代码示例 |

---

🚀 从零开始：完整的环境准备（首次使用先做这个）

如果你电脑上什么都没有（没 Python、没 boss CLI、没装过任何东西），按以下顺序走一遍：

0.1 安装 Python 3.10+

# Windows: 从 python.org 下载安装包，安装时勾选 "Add Python to PATH"
# 验证：
python --version    # 应显示 Python 3.10+

0.2 安装 uv（Python 包管理，比 pip 快 10 倍）

# Windows PowerShell（管理员）：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 或 pip install uv
# 验证：
uv --version

0.3 安装 boss-agent-cli

uv tool install boss-agent-cli
# 验证：
boss --help

0.4 安装 patchright（不下载浏览器，只用作 CDP 客户端）

pip install patchright

> 注意：浏览器是系统自带 Edge/Chrome，不需要额外下载。

0.5 环境变量配置（安装后必做）

安装完 boss-agent-cli 后，需要正确配置环境变量才能正常工作。

一键启动（推荐）

# 在项目目录下执行，每次打开新终端先跑这个
source scripts/setup_env.sh

该脚本会自动设置 PYTHONHOME="" 和 PATH，并验证 boss CLI 是否可用。

永久生效（一次配置，以后不用再跑）

把以下两行加到 ~/.bashrc 末尾，以后每次打开终端自动生效：

echo 'export PYTHONHOME=""
export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
source ~/.bashrc

> ⚠️ 注意：PYTHONHOME 可能影响其他 Python 应用。如果遇到 Python 相关报错，注释掉 ~/.bashrc 中的 PYTHONHOME 行，改为每次手动执行 source scripts/setup_env.sh。

环境变量说明

| 变量 | 说明 | 默认值 | 何时需要修改 | |------|------|--------|------------| | PYTHONHOME | 必须清空。Windows git-bash 下此变量若指向已删除的 Python，CLI 报 Fatal Python error | "" | 每次运行 boss 命令前 | | PATH | boss.exe 在 ~/.local/bin/，但 git-bash 默认不在 PATH 中 | 追加 $HOME/.local/bin | 提示"command not found"时 | | CDP_URL | 浏览器 CDP 调试地址 | http://localhost:9222 | 9222 端口被占用时 | | BOSS_BIN | boss CLI 完整路径 | boss（自动查找 PATH） | boss 不在 PATH 且无法添加时 |

---

每次跑流程时，智能体自动完成以下步骤：

0. 环境修复 + 验证 CLI 登录（每次执行前必做）

⚠️ boss status 是假阳性检测器，不可信。必须用 boss me + hr jobs list 双重验证。

# 步骤 A：初步检查
export PYTHONHOME=""
export PATH="$PATH:$HOME/.local/bin"
boss.exe status

# 步骤 B：验证是否真登录——必须有真实姓名
boss.exe --role recruiter me

# 步骤 C：验证是否能访问岗位数据（最重要）
boss.exe --role recruiter --platform zhipin --cdp-url http://localhost:9222 hr jobs list

判定标准：

| hr jobs list 结果 | boss me 结果 | 含义 | 操作 | |:-------------------|:--------------|:----|:----| | data: [{...}]（有数据） | name: "真实姓名" | ✅ 真登录 | 继续执行 | | data: {} 或 data: []（空） | name: ""（空） | ❌ 假阳性 | 立即修复 → boss login --cdp --timeout 30 | | 返回错误 / 命令失败 | — | ❌ 未登录 | 打开登录页让用户扫码，然后 boss login --cdp |

假阳性修复命令（唯一正确方式）：

boss login --cdp --timeout 30

修复后必须重新执行步骤 B 和 C 确认登录成功，才能继续。

> 绝对禁止的行为： CLI 登录验证失败后，不要尝试用浏览器 API 拦截、CDP 直接操作、或任何其他替代方法来绕过 CLI。必须先把 CLI 修好。

1. 启动 CDP 浏览器

🤖 智能体自动做： 用 terminal(background=true) 启动 Edge/Chrome，带上远程调试端口：

# Windows Edge
"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" ^
  --remote-debugging-port=9222 ^
  --user-data-dir="%USERPROFILE%\.workbuddy\chrome-profiles\boss-cdp"

# 或 Chrome
"C:\Program Files\Google\Chrome\Application\chrome.exe" ^
  --remote-debugging-port=9222 ^
  --user-data-dir="%USERPROFILE%\.workbuddy\chrome-profiles\boss-cdp"

启动后智能体验证 http://localhost:9222/json/version 是否返回浏览器信息。若浏览器已运行则跳过。

登录 BOSS 直聘

参见 boss-agent-cli skill 中「登录流程（双阶段策略）」章节：

• 有 Cookie → 注入浏览器
• 无 Cookie → 打开登录页，提示用户扫码

🍪 Cookie 持久化：浏览器关闭后再开无需重新登录

核心原理： 用 --user-data-dir 固定一个浏览器 profile 目录，所有 cookie/localStorage/session 会自动保存到该目录中。

# ✅ 正确方式：始终使用同一个 user-data-dir 路径
"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" ^
  --remote-debugging-port=9222 ^
  --user-data-dir="%USERPROFILE%\.workbuddy\chrome-profiles\boss-cdp"

# 下次重新启动时，用完全相同的路径，cookie 仍在
# 浏览器会恢复所有登录态，无需再次扫码

不要这样做（会导致每次都重新登录）：

• ❌ 每次启动用不同的 --user-data-dir 路径
• ❌ 不用 --user-data-dir（Edge 默认用临时 profile，关闭后 cookie 丢失）
• ❌ 手动关闭浏览器窗口后重新打开新的（CDP 端口必须还在，否则需要新连接）

验证 cookie 是否持久化成功：

# 1. 启动浏览器（即使已登录过，也启动相同路径）
# 2. 导航到 BOSS 直聘聊天页
curl -s http://localhost:9222/json | python -c "import sys,json; data=json.load(sys.stdin); print(data[0]['webSocketDebuggerUrl'] if data else 'no pages')"

# 3. 用 CDP 检查 cookie
# 如果能看到 zp_token、zp_at 等 cookie → ✅ 持久化成功

浏览器崩溃 / 异常关闭后的处理

如果浏览器异常关闭（进程被 kill、电脑重启），只要 --user-data-dir 路径没变，下次启动后 cookie 还在。偶尔 BOSS 会要求重新登录（cookie 过期），此时用 CDP 导航到 https://www.zhipin.com 检查，若已退出则重新扫码。

双 session 同步策略

BOSS 有两个独立的登录 session：

| Session | 存储位置 | 如何持久化 | 检查方法 | |:--------|:---------|:-----------|:---------| | 🖥️ CDP 浏览器 | --user-data-dir 目录下的 Cookies SQLite DB | 固定路径，自动保存 | 导航到聊天页看是否登录 | | 💻 CLI (boss.exe) | ~/.boss-agent/credentials.json 或系统 keychain | boss login 后自动保存 | boss me 返回真实姓名 |

这两者相互独立 — CDP 浏览器登录了不表示 CLI 也登录了。每次执行流程前必须分别验证两者：

# 验证 CDP 浏览器：导航到聊天页
curl -s http://localhost:9222/json/version  # 浏览器活着
# 然后 CDP 脚本判断页面是否有登录态

# 验证 CLI：
boss.exe --role recruiter me
boss.exe --role recruiter --platform zhipin hr jobs list  # 关键是这个

如果 CLI token 过期但浏览器未过期

# 方案：用 CDP 浏览器登录的 session 重新拾取 CLI token
boss login --cdp --timeout 30
# boss CLI 会通过 CDP 从浏览器中读取 cookie 并生成新的 CLI token

如果浏览器过期但 CLI 未过期

CLI 无法反向注入 cookie 到浏览器。此时只能引导用户重新扫码登录浏览器（导航到 https://www.zhipin.com 后提示扫码）。

---

0.7 环境修复

# Windows 上 PYTHONHOME 可能冲突，必须清除
export PYTHONHOME=""
# 或在 ~/.profile 添加以上命令永久生效

---

---

🔐 登录故障诊断与排除（假登录识别 & 解决方案）

假登录的 3 种场景

场景 1：boss status 假阳性（最常见）

boss status 返回 logged_in: true 但实际 token 已过期。

诊断方法：

# ❌ 不可信的检查
boss.exe status                          # 即使过期也显示 logged_in: true

# ✅ 可信检查 1：是否能获取真实用户信息
boss.exe --role recruiter me             # 假阳性时 name 为空字符串

# ✅ 可信检查 2：是否能访问岗位数据（最终裁定）
boss.exe --role recruiter --platform zhipin hr jobs list   # 关键

判定速查表：

| hr jobs list | boss me | 结论 | 操作 | |:---------------|:----------|:-----|:-----| | data: [{...}]（数组有元素） | name: "潘煜" | ✅ 真登录 | 继续执行 | | data: {}（空 JSON 对象） | name: "" | ❌ 假阳性 | boss login --cdp --timeout 30 | | data: []（空数组） | name: "" | ❌ 假阳性 | boss login --cdp --timeout 30 | | 网络错误 / 超时 | — | ❌ 未登录 | 启动 CDP 浏览器导航到登录页 → 用户扫码 → boss login --cdp |

注意区分 data: {} 和 data: []：

• data: {}（空对象） = ❌ CLI token 过期，session 失效
• data: []（空数组） = ❌ CLI token 过期 或 该账号没有任何岗位
• data: [{...}]（有内容的数组） = ✅ 正常

修复方法（唯一正确方式）：

# CLI 假阳性修复
boss login --cdp --timeout 30
# → boss.exe 通过 CDP 从浏览器读取 cookie，生成新的 CLI token

# 修复后必须重新验证：
boss.exe --role recruiter me
boss.exe --role recruiter --platform zhipin hr jobs list   # 必须返回有数据的数组

> 禁止的行为： hr jobs list 返回空数据后，不要尝试用浏览器 API 拦截/CDP 直接操作来替代 CLI。必须先修好 CLI。如果 boss login --cdp 也失败（浏览器也未登录），引导用户重新扫码。

场景 2：CDP 浏览器假登录（页面显示了但实际未登录）

现象： CDP 连接成功（http://localhost:9222/json/version 正常），页面能打开 https://www.zhipin.com，但页面显示的是未登录态（出现"请登录"或登录按钮，而非聊天列表）。

诊断方法：

# CDP 检查页面是否真正登录 — 检查 cookie 或页面元素
from patchright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp("http://localhost:9222")
    pg = browser.contexts[0].pages[0]
    pg.goto("https://www.zhipin.com/web/chat/index", timeout=15000)
    
    # 方法 1：检查 cookie
    cookies = pg.context.cookies()
    zp_at = [c for c in cookies if c['name'] == 'zp_at']
    zp_token = [c for c in cookies if c['name'] == 'zp_token']
    has_login_cookies = bool(zp_at) or bool(zp_token)
    
    # 方法 2：检查页面文本（无登录态时页面会显示"请登录"等字样）
    page_text = pg.evaluate("document.body.innerText")
    no_login_keywords = ["请登录", "登录", "注册", "扫码登录"]
    is_logged_in = not any(kw in page_text for kw in no_login_keywords) and "沟通" in page_text

修复方法：

| 原因 | 修复 | |:-----|:-----| | --user-data-dir 路径变了，之前保存的 cookie 丢失 | 用回原来的路径 | | cookie 过期（BOSS 强制登出） | 导航到 https://www.zhipin.com，引导用户扫码登录 | | 浏览器新开 profile 没有登录过 | 同上，扫码登录 |

# 浏览器未登录时的标准修复流程
# 1. 导航到 BOSS 首页
# 2. 提示用户扫码登录
# 3. 登录后验证
# 4. 然后 boss login --cdp 同步 CLI

场景 3：CLI 和 CDP 浏览器登录态不同步

这是最容易被忽视的问题，因为两个 session 独立。

「CLI 登录了但浏览器未登录」的典型情景：

• 上次用了 boss login（非 --cdp 方式），CLI token 有效
• 但浏览器用新的 --user-data-dir 从未登录过 BOSS

→ 无法用 boss login --cdp 同步，因为浏览器没有 cookie

「浏览器登录了但 CLI 未登录」的典型情景：

• 用户手动在 Edge 中登录了 BOSS
• 但从未执行过 boss login --cdp
• CLI 中没有有效 token

→ 执行 boss login --cdp --timeout 30 即可修补

修复一览表：

| CLI | 浏览器 | 方案 | |:----|:-------|:-----| | ✅ 已登录 | ✅ 已登录 | 两者都正常，无需操作 | | ❌ 未登录 | ✅ 已登录 | boss login --cdp --timeout 30（从浏览器拾取） | | ✅ 已登录 | ❌ 未登录 | 导航到 zhipin.com 引导扫码，然后 boss login --cdp | | ❌ 未登录 | ❌ 未登录 | 导航到 zhipin.com 引导扫码，然后 boss login --cdp |

---

用到的 Skill 列表

| # | Skill | 在流程中的作用 | |:-:|:------|:-------------| | 1 | boss-job-detail | Step 1：CDP+iframe 提取完整岗位 JD | | 2 | boss-resume-downloader | Step 2：批量下载候选人简历，防封去重 | | 3 | resume-screener | Step 3：岗位类型判断→硬门槛过滤→加权评分→学历分级 | | - | boss-agent-cli | 基础：CLI 命令参考、双模式登录 |

---

登录流程

> 参考 boss-agent-cli skill 中的「登录流程（双阶段策略）」章节。 > > 核心原则： 有 Cookie 直接注入 → 无 Cookie 提示用户扫码。 > > 不要在无 Cookie 时自行尝试注入或操控登录页面，直接告知用户「登录页面已打开，请扫码登录」。

Step 1: 提取 JD

执行 skill： boss-job-detail

前置条件：

• 招聘者身份已登录
• Edge 以 --remote-debugging-port=9222 --remote-allow-origins=* 运行

环境修复（Windows 兼容）：

# PYTHONHOME 环境变量在 Windows 上可能冲突，需要清除
export PYTHONHOME=""

核心操作：

PYTHONHOME="" python scripts/boss_jd.py 

输出： 结构化 JD 数据（岗位名、学历、专业、经验、职责、技能栈），用于 Step 3 评分。

🔧 CLI 不可用时的回退：CDP 浏览器直接提取

如果 boss hr jobs list 返回空数据（CLI 假阳性），boss_jd.py 脚本无法匹配岗位。此时直接通过 CDP 浏览器导航到岗位编辑页：

from patchright.sync_api import sync_playwright
import json, time

# 用已知的 encryptJobId（可从聊天页候选人关联的岗位名获取）
encrypt_job_id = "4c297ca36277e0400nB-29m9EFpZ"  # 示例
target = f"https://www.zhipin.com/web/chat/job/edit?encryptId={encrypt_job_id}&jobCreateSource=0&enterSource=6"

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp("http://localhost:9222")
    pg = browser.contexts[0].pages[0]  # 复用已有页面，不 new_page()
    pg.goto(target, wait_until="networkidle", timeout=30000)
    time.sleep(3)

    iframe = pg.query_selector("iframe")
    frame = iframe.content_frame()
    body_text = frame.evaluate("document.body.innerText")

    # 提取表单完整值（含职位描述）
    form_vals = frame.evaluate("""() => {
        const r = [];
        document.querySelectorAll('input:not([type=hidden]), textarea, [contenteditable]').forEach(el => {
            const v = el.value || el.innerText || '';
            if (v && v.length > 2 && v !== '保存') r.push(v);
        });
        return r;
    }""")

如果不知道 encryptJobId： 从聊天页左侧列表中找到该岗位的候选人，点击后页面 URL 或 intercepted API 响应中会包含 encryptJobId。

---

Step 2: 下载候选人简历

执行 skill： boss-resume-downloader

核心操作：

# 查看岗位列表获取 jobId
boss --role recruiter --platform zhipin --cdp-url http://localhost:9222 hr jobs list

# 分批下载（--max 是累计处理数，含已跳过）
python scripts/sync_boss_resumes.py sync-job --job-id  --max 10

分批策略：

• 第一轮 --max 10 → 第二轮 --max 20 → 第三轮 --max 30
• 脚本自带随机延迟防封

输出目录： %USERPROFILE%/WorkBuddy/boss-resumes/jobs//resumes/

🔧 CLI 不可用时的回退：浏览器 API 响应拦截

当 boss hr jobs list 或 boss hr applications 返回空数据时，用 CDP 浏览器的网络响应拦截获取候选人和简历数据：

1. 获取候选列表 + securityId： 拦截 getBossFriendListV2 API 响应
2. 获取聊天消息： 读取页面 text（所见即所得）
3. 注意： 此方法只能拿到基本信息和聊天自述，无法获取完整简历 JSON

from patchright.sync_api import sync_playwright
import json, time

captured = {}
def on_response(resp):
    url = resp.url
    try:
        if 'getBossFriendListV2' in url:
            captured['friend_list'] = resp.json()
    except:
        pass

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp("http://localhost:9222")
    pg = browser.contexts[0].pages[0]  # 复用 pages[0]，不 new_page()

    pg.on("response", on_response)
    pg.goto("https://www.zhipin.com/web/chat/index", wait_until="networkidle", timeout=30000)
    time.sleep(5)

    # 从响应中提取 candidate 数据
    fl_data = captured.get("friend_list", {}).get("zpData", {})
    friends = fl_data.get("friendList", [])  # 列表项含: name, securityId, encryptUid, uid, jobName, encryptJobId
    # 提取候选人信息
    for f in friends:
        name = f.get("name")
        sec_id = f.get("securityId", "")       # 简历下载所需
        encrypt_uid = f.get("encryptUid", "")  # 同 encryptGeekId
        uid = f.get("uid", 0)                  # 同 friendId

    # 从页面 text 提取聊天消息（每个候选人最后一条消息）
    page_text = pg.evaluate("document.body.innerText")

候选人的加密参数对应关系： | 参数 | friendList 中的字段 | 用途 | |:----|:------------------|:-----| | encryptGeekId | encryptUid | boss hr resume 的参数 | | securityId | securityId | boss hr resume 的参数 | | encryptJobId | encryptJobId | boss hr resume 的参数 | | friendId | uid | 聊天 API 参数 |

> ⚠️ 即便拿到这些参数，如果 CLI session 已过期，boss hr resume 也会返回空简历数据。此时评分只能基于聊天消息中的自述信息。

---

Step 3: 评分

执行 skill： resume-screener

4 步执行：

1. 岗位类型判断 — 技术岗 / 管培&非技术岗
2. 硬门槛过滤 — 学历不符 / 毕业年份不匹配 / 专业不相关 → 淘汰
3. 加权评分 — 按岗位类型选择 Mode A 或 Mode B 权重
4. 总分排名 — 结构化输出每个候选人的评分明细 + 排名表

---

Step 4: 生成报告

格式要求： 生成独立 HTML 文档，不要将报告内容直接输出到聊天窗口。用户偏好排版清晰的可视化文档。不要将原始得分数据先输出到聊天窗口再生成文件。

输出位置： ~/Desktop/hermes产生文件/_简历筛选报告.html

模板参考： 加载 html-report skill 获取模板和设计规范，参见其 templates/report.html。在该模板基础上填入实际数据生成最终报告。

输出内容：

• 岗位基本信息 + JD 摘要（渐变色头部卡片）
• 岗位类型判定 + 使用权重说明
• 硬门槛过滤结果表
• 总分排名表（带颜色编码：绿色推荐/黄色待定/红色不推荐）
• 每个候选人分维度评分明细表（含进度条可视化）
• 沟通建议：按优先级排列，对推荐人选给出理由和行动指引

---

不做的步骤

| 步骤 | 原因 | |:----|:-----| | ❌ 自动发消息给候选人 | CLI hr reply 返回 sent: false，权限不足 | | ❌ 自动请求简历 | CLI request-resume 返回"权限不足" | | ❌ 自动打招呼 | 由用户自行在 BOSS 网页端操作 |

---

文件结构

%USERPROFILE%/WorkBuddy/boss-resumes/
├── jd/
│   └── .json                  # JD 数据
├── jobs//
│   ├── candidate_index.json                 # 候选索引
│   └── resumes/
│       ├── _/
│       │   ├── resume.md                    # 可读简历
│       │   └── raw_response.json            # BOSS API 原始 JSON
│       └── ...

---

⚠️ 重要规则

登录

• 必须两段式登录：CDP 扫码 → boss login 拾取 session
• 验证：boss me 返回真实用户信息
• boss status 不可靠（可能假阳性）

CLI 假阳性检测（重要）

boss status 返回 logged_in: true 但实际 token 可能已过期。确认方法：

# ✅ 真阳性 — 能返回在线岗位数据
boss --role recruiter --platform zhipin --cdp-url http://localhost:9222 hr jobs list

# ❌ 假阳性 — 返回 data: {}（空对象），token 已过期

关键判断：如果 hr jobs list 返回 "data": {}（空 JSON 对象）而非岗位数组，说明 CLI session 已过期。不要继续依赖 CLI，立即切换到 CDP 浏览器直接操作。

编码

• BOSS CLI stdout 为 GBK 编码
• 禁止用 PowerShell 管道处理中文 → 乱码
• 看到乱码直接如实报告，不要猜测中文内容

模式切换

• 求职者模式：boss ...（默认）
• 招聘者（HR）模式：boss --role recruiter hr ...
• 不同模式命令不同，模式不对会超时或返回空

防封

• 简历下载每次只下一份，脚本自带随机延迟
• 不要连续快速操作同一接口

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: 1xiaoyueryuer
• Source: 1xiaoyueryuer/boss-hr-agent-toolkit
• License: MIT

Install and usage instructions live in the source repository linked above.