---
name: boss-zhipin-copilot
version: 1.0.4
description: >-
  通用 BOSS 直聘求职 copilot：配合仿真人浏览器后端用真实光标安全检索/收藏岗位、读 JD、写破冰话术并按授权发送。强制走后端正门、真实光标、限速、撞墙停手、授权门控，绝不裸 CDP。四类资产（脚本/选择器/页面/点位）一律优先复用 skill 内置，禁止现写等价脚本或重猜选择器；新建前必查 script_catalog.md + boss_selectors.md。
---

通用、可配置、开源的 BOSS 直聘求职 copilot：把「简历 + 求职目标」沉淀为可复用能力——自动建岗位画像与检索词、建评分机制、建岗位库、检索收藏、写破冰话术、按授权发送。

> 🔌 **应用层架构**：浏览器运行时由「仿真人浏览器后端」经 `bz_*` 契约即插即用提供。默认**且仅支持** [agent-browser-runtime](https://github.com/energypantry/agent-browser-runtime)（受控 Chromium + 自带 companion 模拟真实光标）。**所有浏览器动作只经后端正门真实光标执行，绝不直连 CDP、绝不走浏览器扩展直控。**

**流水线**：`简历/目标` → `profile.yaml` → 检索·过滤·入库 → 读 JD → 写话术（自检 gate）→ 授权发送 / 仅本地成稿

> 🛑 **最高优先级前置门控**：任何写脚本 / 猜选择器·页面·点位前，**必须先 `Read references/script_catalog.md` + `references/boss_selectors.md`**（统一原则见下方「🛑 优先复用与增量更新」）。已有对应项时现写即违规——立即停用，改用内置。复用优先于一切。

---

## 何时使用
- 用户在 BOSS 直聘「找工作 / 建目标岗位库 / 批量收藏 / 写破冰话术 / 发消息」。
- 触发语：「帮我在 BOSS 找策略产品经理」「根据简历生成求职画像和检索词」「收藏这几个岗位」「写破冰话术」「把这些岗发消息」。

---

## 前置依赖（缺一不可 → fail loud）
1. **仿真人浏览器后端就绪**（关键准入，裸 CDP / 扩展直控曾致封号）：
   - 本地（默认且唯一 sanctioned）：部署 [agent-browser-runtime](https://github.com/energypantry/agent-browser-runtime)，`BZC_BACKEND=brs`（默认），`brs status` 须 `extensionConnected: true`。
   - 缺失 → `common.sh` fail-loud 并贴安装链接。契约见 `references/browser_backend.md`。
2. **Python3 + PyYAML（硬前置，加载即校验）**：`pip install -r requirements.txt`。`common.sh` 在 source 时即经 `resolve_python()` + `preflight_env.sh` 断言「选中的解释器能 `import yaml`」；PyYAML 缺失直接 **FAIL_LOUD**（不再静默选到缺 yaml 的解释器让解析脚本确定性失败）。未设 `PYTHON` 时按 `PATH(win-native) > 受管 3.13.12 > 受管 venv(envs/default，预装 yaml) > python3` 自动挑第一个带 yaml 的；显式 `PYTHON` 则严格遵从。
3. **执行环境就绪度（Axis B 预检/引导层）**：`preflight_env.sh` 兜底 coreutils——Git Bash 等会话级环境缺 `sleep`/`seq` 时自动注册等价 shell 函数（零磁盘写入）；脚本路径转换已统一改用 `to_win_path`，不再散落裸 `cygpath -w`（消除「cygpath 缺失 → 静默回退 POSIX 路径 → win-python 误读」的确定性失败）。
4. **profile.yaml / 岗位库 CSV**：由本 skill 在工作流 Step 0/1 自动生成（无需预置）。

> 🔴 **反作弊红线（R12，硬性）**：BOSS 直聘禁止**任何 Agent** 的浏览器扩展直控（含 Codex `@Chrome` / CloakBrowser 之类）。本 skill **统一 brs 单后端**（agent-browser-runtime 受控运行时）；设 `BZC_BACKEND=codex|cloak` 会被 `common.sh` 直接拒绝（`exit 1` + 安装链接）。公开仓库不收录任何扩展直控后端。

> ⚠️ **运行方式护栏（防绕过原生 Axis B 层）**：跑批时**只设连接变量**——`AGENT_BROWSER_RUNTIME_HOME`（或 `BRS_JS`）+ 必要时 `NODE`（受管 node 绝对路径，如 `$HOME/.workbuddy/binaries/node/versions/<ver>/node`，WorkBuddy 专属示例）。**严禁预置 `PYTHON`、严禁 `source` 任何外部 `runtime_env.sh` / 类似 shim**：那会把 `PYTHON`/cygpath/sleep 写死，绕过本 skill 的 `resolve_python` / `to_win_path` / `preflight_env.sh`，导致"测的根本不是 skill 本身"。PyYAML 解析、POSIX→Windows 路径转换、coreutils 兜底**一律由 skill 自供**。

---

## 安全纪律（灵魂 · 全文见 references/safety_rules.md）
- **R1** 只走仿真人浏览器后端正门，绝不裸 CDP / `Runtime.evaluate` / 查询串捷径。
- **R2** 只用真实光标（`ui.click`/`ui.type`），禁合成点击。
- **R3** 限速：动作间隔 ≥`ACTION_INTERVAL_SECONDS`(5s)；每日收藏+开聊 ≤`DAILY_CAP`(100)。
- **R4** 撞墙即停：验证码/滑块 → `exit 3`，停手交人工，冷却 ≥24h，绝不恢复自动化。
- **R5** 授权门控：书签需批次授权；发消息需**每岗** `AUTHORIZED=1`。门控在 `process_job.sh` 顶部最早执行，未授权带 `--send`/`--bookmark` 直接 `exit 4`。
- **R6** 合并打开，避免无谓重开（同次任务合并书签+读JD+授权发送）。
- **R7** 预飞 1 岗跑通整条路径，再复制其余。
- **R8** 单 lease 连续 tab，批量不杀重启（burst）。
- **R9** 复核收敛：每步仅 1 个权威产物，最多 1 次交叉校验。
- **R10** 发送幂等 / 防重复：批量发送必须有 done 唯一真源 + key 归一化 + 文件内存双写 + 并发锁 + 启动即停（见下方 Step 5 模板），否则中断重跑会重复发。
- **R11** 登录态失败驱动：默认信任已登录，仅在「搜 0 结果且登录页信号」或「发送未确认且登录页信号」时按需 `check_logged_in`；命中即置 `logged_out` + `exit 8`，绝不主动预飞。
- **R12** 反作弊红线：只允许受控运行时（agent-browser-runtime 类），禁止任何 Agent 的浏览器扩展直控（含 Codex `@Chrome` / CloakBrowser）；`BZC_BACKEND=codex|cloak` 会被 `common.sh` 直接拒绝。
- ⚠️ 禁止频繁开关 tab / 本地打开 BOSS HTML / 盲坐标点击。

---

## 🛑 优先复用与增量更新（Reuse-First & Incremental Update · 最高优先级）

> 本 skill 预建了全部资产（**脚本 / 选择器 / 页面 / 点位**），目的就是让 Agent 不再现写或盲猜——那既是误差之源也是低效之源。四类资产统一遵循同一原则：

- **① 复用优先**：动手前先查已有资产——
  - 脚本 → `references/script_catalog.md`（任务 → 内置命令精确映射）
  - 选择器 / 页面 / 点位 → `references/boss_selectors.md`
  - 凡已有对应条目，**必须直接复用**：禁止重写等价脚本、禁止重猜选择器、禁止盲试页面 URL、禁止自造点位。
- **② 发现错误 → 就地更新**：已有条目实测漂移 / 失效，**直接改对应条目**（fix-in-place）惠及所有未来运行；**禁止绕过**（绕过 = 误触 / 误判，见 R1）。
- **③ 发现新内容 → 补进对应位置**：
  - 新脚本 → 收编 `scripts/` + 登记 `script_catalog.md`
  - 新选择器 / 页面 / 点位 → 补进 `boss_selectors.md` 对应节（标注「首次校验」）
- **④ 受控逃逸阀**：仅当确属全新、与现有资产无重叠才新建；新建必登记；**无法说清「为何现有不适用」时，默认就地改，不得新建**。任务执行中**禁止临时改写 `process_job.sh` 等内置脚本绕过门控**——源码修改走 skill 维护流程（改后 commit）。

## 工作流
### Step 0 · 生成 / 校验 profile + 解析求职意图
- `bash scripts/run_py.sh build_profile.py --goal "..." [--resume 简历.md] --out profile.yaml` 抽草稿；Agent 复核补全 `hard_exclude` / `boost_keywords` / `fact_anchors`（依据 `references/profile_schema.md`）。解析不出的维度保守留空（=不限），必要时追问 1 个关键问题。→ **产物 `profile.yaml`**（后续唯一输入）。（复用 `build_profile.py`，禁现写等价脚本）
- **主动解析求职意图（长期能力）**：用户常以自然语言提需求（如"想找一家 B 轮以上的中型公司做后端开发""北京全职20k以上5年经验"）。这类隐含的筛选条件**必须由 `scripts/intent_filters.py` 自动识别并映射到 BOSS 搜索页筛选器**，**优先在搜索阶段应用**，缩小结果范围，避免下游读大量不符岗 JD。用法：
  - `bash scripts/run_py.sh intent_filters.py parse "自然语言" [--profile profile.yaml]` → 解析出 FilterSpec（意图覆盖 profile 默认）
  - `bash scripts/run_py.sh intent_filters.py build --profile profile.yaml [--intent "文本"] [--scale 302,303] [--exp 106] ...` → 合并 profile+意图+显式维度覆盖 → 最终 FilterSpec
  - 编码映射与点位见 `references/boss_selectors.md` 五「结果页筛选器」（六维度全覆盖：公司规模/融资阶段/工作经验/学历要求/薪资待遇/求职类型）。**复用内置，禁现写等价解析。**

### Step 1 · 建 / 校验岗位库
`bash scripts/setup_library.sh` 生成空 `target_library.csv`（`$LIB_CSV` 可指定）。本库是检索/去重/入库的**唯一权威数据源**（`references/target_library_schema.md`）。（复用 `setup_library.sh`，禁现写）

### Step 2 · 检索（先筛选）→ 过滤 → 书签入库
> **🔒 流程铁律：筛选优先于后续操作。** 先按筛选条件在「搜索结果页」源头过滤 → 再对过滤后的岗位列表执行收集/详情抓取/匹配分析。绝不让未过筛的岗位进入下游（读 JD / 写话术 / 入库），那会成倍浪费真实光标动作。

1. **检索收集（源头筛选 + 只读）**（复用内置，禁自写）：
   `bash scripts/search_jobs.sh --profile profile.yaml --out .work/candidates.csv [--intent "自然语言意图"] [--scale "302,303"] [--stage 804,805] [--exp 106] [--degree 203] [--salary 406] [--jobtype 1901]`
   - 查询词取自 `profile.search.queries`（或 `--queries "词1,词2"`）；走 `bz_*` 真实光标、复用同 tab、**禁 `?query=&city=&page=` 捷径**。
   - **六维度筛选在搜索结果页源头应用（核心优化）**：搜索框下方 hover 出下拉、复选（点位/编码见 `boss_selectors.md` 五）。筛选来源优先级：① `profile.thresholds` 默认（scale_min/max、salary_floor、seniority_years 自动推导）→ ② `--intent "文本"` 自动解析隐含条件（如"B轮以上中型公司"）覆盖同名维度 → ③ 显式 `--scale/--stage/--exp/--degree/--salary/--jobtype` 最高优先级覆盖。**在源头筛掉不符岗，比读 JD 详情页后再筛高效得多**（实测：下游 JD 阅读量可降 30–50%）。
   - 产 `candidates.csv`（列：岗位名/公司名/城市/经验要求/URL）。⚠️ **无薪资列**——卡片薪资被字体反爬混淆，须 Step 3 从 JD 详情页取。
2. **过滤打分去重**（复用 `filter_library.py`，禁现写）：`bash scripts/run_py.sh filter_library.py --profile profile.yaml --input .work/candidates.csv --out .work/eval.json`
   - **省略 `--library` = 只读候选清单、不入库**；通过项在 `eval.json.passed`，Top-N 自行按「评分」截断。
   - 确需入库再加 `--library target_library.csv`（通过项追加，状态=已收藏(感兴趣)，按 URL 去重）。
3. 逐岗书签：`AUTHORIZED=1 bash scripts/process_job.sh --url <岗URL> --bookmark`（复用 lease：`--lease <id> --tab <id>`）。
   - 核对实际收藏：个人中心「感兴趣」tab（`https://www.zhipin.com/web/geek/recommend`，见 `boss_selectors.md` 六，**只读**，勿在此页改状态）。列表页**每卡另有 `a.btn-startchat` 可直接开聊**，卡片 DOM 结构见 `boss_selectors.md` 六「收藏列表卡片 DOM」。
4. 预飞 1 岗跑通选择器 → 同路径复用；按 `references/cooldown_config.md` 间隔；撞墙即停。

### Step 3 · 读 JD / 招聘方
单岗：`bash scripts/process_job.sh --url <岗URL> --read-jd --out recruiter_jd.json`（`<岗URL>` 用 `https://www.zhipin.com/job_detail/<jid>.html`，**去掉 `?securityId=...`**，见 `boss_selectors.md` 六/三）→ 解析 `.job-boss-info .name`（真实招聘方，**非登录账号**）/ `.job-sec-text`（完整 JD）/ `.sider-company`。读 JD 前用 `bz_wait $BZ_LEASE $BZ_TAB job-sec-text` 等渲染就绪，避免空串（见 `safety_rules.md` 十）。
**批量（N 岗）禁止另写 `read_jd_batch.py`** → shell 循环复用单岗命令（白赚真实光标 + 撞墙检查 + 解析）：
`for u in $(cat urls.txt); do bash scripts/process_job.sh --url "$u" --read-jd --out .work/jd_$((++n)).json; done`
**输出契约**：每岗产出单元素 JSON 列表 `[{id,title,jd,recruiter,company}]`；合并为批量数组即话术**唯一 JD 依据**（见 `audit_icebreaker.py` 用法）。

### Step 4 · 写破冰话术（通用）
1. **JD 洞察**：1–2 句复述具体业务点，含 ≥3 个 JD 原文 distinctive 词。
2. **事实匹配**：从 `profile.fact_anchors` 取凭据，每段「公司+动作+数字」、可溯源、无编造。
3. **话术**（≤200 字）：真实招聘方称呼 + JD 共鸣 + 事实凭据 + 诚实边界。
4. **自检 gate**：`bash scripts/run_py.sh audit_icebreaker.py recruiter_jd.json 话术.md 事实库.md keys.json` 要求 **JD≥90% 且 事实≥90%**（keys 由 Agent 为每岗写 `jd/fact` 锚点，写即强制精读）。不达标 → 重写。
5. 完成即**停等用户审核**，不自动发送。

### Step 5 · 发送或仅本地（授权门控）
- 用户**每岗**显式授权（`AUTHORIZED=1`）→ `bash scripts/process_job.sh --url <岗URL> --send --msg 话术.txt` 真实光标发送（发送前校验对话列表已有我方内容、称呼/岗位一致）。
- ⚠️ **须前台、逐岗、人工实时在环执行，禁止委托无人值守后台批量跑**（即便已授权）：撞墙无人接手 / 无法中断 / 会话结束即死。仅只读操作可后台（见 `safety_rules.md` 红线）。
- 未授权 → 仅产出本地文档（如 `破冰沟通YYYYMMDD.md`），**不发送**。
- **批量发送（断点续发安全 · 必须遵守 `references/safety_rules.md` R10）**：多岗授权发送用**幂等编排循环**，**禁止裸 `for` 循环不带 done 追踪**（中断重跑会重复发）。官方模板（done 唯一真源 + key 归一化 + 文件内存双写 + 并发锁 + 启动即停）：
  ```bash
  DONE=".work/send_done.txt"; LOCK=".work/.send_lock"
  mkdir "$LOCK" 2>/dev/null || { echo "另一个发送实例正在运行"; exit 1; }
  trap 'rmdir "$LOCK" 2>/dev/null' EXIT
  declare -A DONESET
  [ -f "$DONE" ] && while read -r d; do d="${d%$'\r'}"; [ -n "$d" ] && DONESET["$d"]=1; done < "$DONE"
  # urls.txt: 每行 <jid><TAB><url><TAB><薪资>
  while IFS=$'\t' read -r jid url sal; do
    [ -z "$jid" ] && continue
    jid="${jid%$'\r'}"
    [ "${DONESET[$jid]:-}" = "1" ] && { echo "[skip] $jid"; continue; }
    AUTHORIZED=1 bash scripts/process_job.sh --url "$url" --send --msg ".work/msg/$jid.txt" \
      || { echo "发送失败/撞墙 $jid，停手"; break; }
    printf '%s\n' "$jid" >> "$DONE"   # 文件落盘（显式 LF）
    DONESET["$jid"]=1                  # 内存同步（同跑内防重）
  done < urls.txt
  ```
  - done 文件须**显式 LF**（`printf '%s\n'`，绝不写 `\r`）；加载 / 比较均剥 `\r` → 杜绝 CRLF/LF 混行分裂 key（R10 事故根因）。
  - 同跑内文件+内存双写保证不重发；并发锁杜绝双实例；done 覆盖全部则循环自然跳过全部（启动即停）。
  - 仍逐岗走 `process_job.sh`（R5 每岗授权门控不绕过）、前台人工在环、撞墙即停（R4）。

### Step 6 · 扫描聊天列表（可选）
`bash scripts/scan_chat.sh` 调 `zhipin-chat.extract.js` 取快照，与 `target_library.csv` 按 (name,company,role) 交叉比对，判已发/去重。**只读，不改状态**。（复用，禁现写）

---

## 脚本清单
| 脚本 | 用途 |
|---|---|
| `scripts/common.sh` | 被 source：后端探测 + `source backends/$BZC_BACKEND.sh` + fail-loud + 撞墙/冷却助手 + `to_win_path` + 加载预检层 |
| `scripts/preflight_env.sh` | 环境预检/引导层（Axis B）：防御性确认 PyYAML 可用 + `sleep`/`seq` 缺失时注册会话级 shell 函数兜底（路径转换统一走 `to_win_path`，无 cygpath shim） |
| `scripts/backends/brs.sh` | 唯一后端：agent-browser-runtime（local，已实现，受控 Chromium + companion 真实光标） |
| `scripts/backends/_deprecated/codex.sh` | ⛔ 已废弃：Codex @Chrome 扩展直控（反作弊风险，勿用于 BOSS） |
| `scripts/backends/_deprecated/cloak.sh` | ⛔ 已废弃：CloakBrowser 扩展直驱（反作弊风险，勿用于 BOSS） |
| `scripts/setup_library.sh` | 初始化空岗位库 CSV |
| `scripts/search_jobs.sh` | 多词检索：复用同 tab、只读收集结果卡 → `candidates.csv` |
| `scripts/parse_search.py` | 搜索结果卡片解析（search_jobs 内部调用；不含薪资） |
| `scripts/process_job.sh` | 单岗：书签/读JD/发消息（可复用 lease） |
| `scripts/scan_chat.sh` | 扫描聊天列表（只读，不改状态） |
| `scripts/zhipin-chat.extract.js` | 聊天列表提取器（broker 端执行） |
| `scripts/build_profile.py` | 目标句 → profile 草稿 |
| `scripts/filter_library.py` | profile 驱动过滤 + 评分 + 入库 |
| `scripts/audit_icebreaker.py` | 破冰话术自检 gate（JD≥90% + 事实≥90%） |
| `scripts/parse_job.py` | 读JD 的 HTML DOM 解析（process_job 内部调用） |

> 📌 **复用前必查 `references/script_catalog.md`**：任务 → 内置脚本精确命令映射 + 反模式清单。凡表中有脚本必须复用，禁止重写（见上方「🛑 优先复用与增量更新」）。

---

## 环境变量
| 变量 | 默认 | 说明 |
|---|---|---|
| `BZC_BACKEND` | `brs` | 后端：仅 `brs`（agent-browser-runtime，受控运行时）。设 `codex`/`cloak` 会被 `common.sh` 拒绝（R12 反作弊） |
| `BRS_JS` | 自动探测 | brs.js 路径（或 `AGENT_BROWSER_RUNTIME_HOME` 辅助） |
| `NODE` / `PYTHON` | `node` / `python3` | 可执行 |
| `PROFILE` | `./profile.yaml` | profile 文件 |
| `LIB_CSV` | `./target_library.csv` | 岗位库 CSV |
| `WORK_DIR` | `./.work` | 中间产物目录 |
| `AUTHORIZED` | `0` | 发消息/书签授权（=1 才允许） |
| `ACTION_INTERVAL_SECONDS` | `5` | 动作间隔下限 |
| `COOLDOWN_JITTER` | `3` | 间隔随机抖动幅度（±秒，防机器特征） |
| `BACKOFF_MAX` | `60` | 软限流指数退避上限（秒） |
| `DAILY_CAP` | `100` | 每日收藏+开聊上限 |
| `BOOKMARK_COOLDOWN` / `SEND_COOLDOWN` | `8` / `20` | 书签/发送间隔 |

---

## 错误处理
- 失败分类与「异常 → 动作」完整表见 `references/safety_rules.md` 十（解析空/选择器漂移/撞墙/软限流/部分加载/网络/凭证未连接/日上限）。
- 后端未就绪（`bz_status` 失败 / 缺 companion 扩展 / 解析失败）→ `exit 2`（runtime/companion 未就绪，不降级裸 CDP）。
- 撞验证墙 → `exit 3`，停手交人工，冷却 ≥24h。
- 发送/书签未授权 → `exit 4` 拒绝。
- 单日改状态动作达 `DAILY_CAP` 上限 → `exit 5` 停手（R3）。
- 岗位已关闭 / 下架（页面含「职位已关闭」但无 `.btn-startchat`）→ `exit 6`，跳过该岗（**非撞墙**，不冷却，请在岗位库标记「岗位关闭」）。
- 发送后话术仍在输入框草稿态（未真正发出）→ `exit 7`（见 `process_job.sh` 严格送达判定）。
- BOSS 登录态失效 → `exit 8`，请人工在 noVNC 重新登录（区别于撞墙：无需冷却）。**失败驱动、非主动预飞**：默认信任登录态，仅在「搜索 0 结果且登录页信号」或「发送未确认且登录页信号」时按需 `check_logged_in` 核验；命中即置 `logged_out` 并停手。登录态记录于 `<skill_root>/.state/login_state`（跨产品、机器级、不进 GitHub）。
- 选择器漂移 → 回 `references/boss_selectors.md` 复核，**禁止绕过**（绕过=误触/误判）。

---

## 产物文件
- `profile.yaml`：求职画像（输入契约）。
- `target_library.csv`：目标岗位库（权威，去重主键=BOSS URL 的 `job_detail/<jid>`；辅助键=(公司名+岗位名+BOSS称呼)，防同公司同岗不同招聘方被误并）。
- `.work/recruiter_jd.json` / `.work/eval.json` / `.work/chat_scan.json`：中间产物。
- `破冰沟通YYYYMMDD.md`：话术文档（未授权时本地成稿）。