让 AI 助手（Codex / Claude / Workbuddy 等桌面端）替你自动回复 Boss 直聘候选人的第一条消息，比如"好的，麻烦发份简历"。
✅ 能做
- 列出"等你回复"的候选人（候选人主动打招呼且你还没回过的）
- 按你预设的模板池随机回一句
- 在 AI agent 里用大白话调用："看下有谁等我回复，帮我都回了"
❌ 不能做
- 主动给陌生候选人打招呼（Boss 风控屏蔽，不要做）
- 替你做面试决策、要电话微信（这些要你亲自来）
- Boss 用户协议禁止自动化脚本，账号有被风控的风险
- 第一次用建议拿小号试，不要直接上公司主账号
- 默认只在工作时间（9:30-12:00 / 14:00-19:00）跑，每天最多 80 条
你需要 Mac 或 Linux。Windows 也能跑但步骤略不同，本文以 Mac 为例。
打开 终端（Terminal app），逐条复制粘贴：
# 1. 装 Homebrew（如果你已经有了，跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 装 uv（Python 包管理器）
brew install uv
# 3. 装 gh（GitHub 命令行，用来下载代码）
brew install gh
# 4. 登录 GitHub
gh auth login
# 按提示选 GitHub.com → HTTPS → Login with a web browser，把屏幕上的 8 位码贴到浏览器验证：
uv --version # 应该显示 uv 0.x.x
gh auth status # 应该显示 ✓ Logged in# 下载到 ~/dev 目录（没有的话会自动建）
mkdir -p ~/dev
cd ~/dev
gh repo clone ARMANDSnow/boss-cli
cd boss-cli
# 创建虚拟环境并安装
uv venv --python 3.12
source .venv/bin/activate
uv pip install -e ".[mcp,yaml]"验证：
boss --version # 应该显示 boss, version 0.x.x
which boss-cli-mcp # 应该显示 .../boss-cli/.venv/bin/boss-cli-mcp把这一行的输出记下来，等会儿配 Codex 要用：
echo "$(pwd)/.venv/bin/boss-cli-mcp"
# 例如输出：/Users/dingyuxuan/dev/boss-cli/.venv/bin/boss-cli-mcpboss login终端会弹出一个二维码——用 Boss 直聘手机 App 扫码确认。成功后会显示 ✅ 已登录。
如果你已经在 Chrome 里登录过 Boss 网页版，可以直接
boss login，工具会自动从浏览器导 cookie，不用扫码。
验证：
boss status # 应该显示用户名和已登录状态
boss recruiter jobs # 应该列出你的在招职位mkdir -p ~/.config/boss-cli
cp ~/dev/boss-cli/templates.txt.example ~/.config/boss-cli/templates.txt
open -e ~/.config/boss-cli/templates.txt # 用文本编辑器打开把里面的模板改成你平时的口吻，比如：
你好，方便发一份最新的简历吗？
你好，麻烦发份完整简历，我看完跟你约时间细聊
Hi，可以先把简历发我看看吗？
你好{name}，看完你打的招呼觉得挺合适，先发份简历过来呗
你好，简历方便先发一份吗？看完咱们详细聊
规则：
- 一行一条，
#开头是注释 {name}会自动替换为候选人姓名- 至少写 8 条（少了风控会觉得你像机器）
- 不要写微信号、电话号、链接（Boss 会秒删消息）
存盘后验证：
boss recruiter templates # 应该列出你写的所有模板# 看看现在有谁等你回复（不发任何东西）
boss recruiter pending
# 干跑：显示"会发什么"但不真发
boss recruiter auto-reply --dry-run --max-send 3如果输出看着对，再真发一次：
boss recruiter auto-reply --max-send 3
# 它会让你按 y 确认，回 3 条之间各间隔 12-30 秒去 Boss 直聘 App 看消息列表——应该已经回出去了。✅
- 打开 Codex 桌面 App
- 左下角点 Settings（设置）
- 左边栏点 MCP servers
- 点 + Add server
- 填：
- Name:
boss - Type:
STDIO（默认就是） - Command: 粘贴第 1 步末尾让你记下的那个绝对路径，比如
/Users/dingyuxuan/dev/boss-cli/.venv/bin/boss-cli-mcp - Args: 留空
- Env: 留空
- Name:
- 点 Save
- 重启 Codex
mkdir -p ~/.codex
open -e ~/.codex/config.toml在文件末尾追加（把 command 换成你的真实路径）：
[mcp_servers.boss]
command = "/Users/dingyuxuan/dev/boss-cli/.venv/bin/boss-cli-mcp"存盘，重启 Codex。
在 Codex 对话框里说：
你能用 boss 这个 MCP 看下我有哪些工具吗？
Codex 应该列出 list_pending / auto_reply / list_templates / add_template / reset_templates 这 5 个。
直接用大白话指挥 Codex，例如：
看下 boss 现在有几个候选人等我回复，先列出来给我看。
Codex 会调 list_pending，告诉你"有 7 个人等你回复"。然后你说：
帮我都回了，先 dry_run 看下会发什么。
Codex 会调 auto_reply(dry_run=true)，把"打算给谁发什么"的清单返回。你看完说：
可以，真发出去。
Codex 会调 auto_reply(dry_run=false)，按节奏一条条发。
几个常用指令模板：
| 你想做的事 | 跟 Codex 说 |
|---|---|
| 看待回复名单 | "看下 boss 有几个等回复的" |
| 干跑预览 | "boss 帮我自动回，先 dry run" |
| 真实发送 | "确认发出去" |
| 只针对某个职位 | "只看 encryptJobId 是 xxx 的候选人，帮我回了" |
| 加新模板 | "给 boss 模板池加一条：'你好，简历方便发下吗'" |
| 看现有模板 | "boss 现在有哪些模板？" |
claude mcp add boss /Users/dingyuxuan/dev/boss-cli/.venv/bin/boss-cli-mcp编辑 ~/Library/Application Support/Claude/claude_desktop_config.json，加：
{
"mcpServers": {
"boss": {
"command": "/Users/dingyuxuan/dev/boss-cli/.venv/bin/boss-cli-mcp"
}
}
}重启 Claude Desktop。
通用规则：让客户端启动 boss-cli-mcp 命令，使用 stdio 协议。具体配在哪个文件、哪个菜单，请查该 app 自己的 MCP 文档关键词："add MCP server" 或 "stdio command"。基本上都是填一个 Name + 一个绝对路径，跟上面 Codex 的方法 A 是一回事。
boss logout && boss login # 重新扫码- 确认配的是绝对路径（
/Users/.../boss-cli-mcp），不是boss-cli-mcp - 重启 Codex（不是关窗口，要完全 Quit 再开）
- 在终端跑一遍
boss-cli-mcp，立即 Ctrl+C；如果没报错说明命令本身没坏
账号被风控了。立刻停止 24 小时，不要重试。下次：
- 模板池再扩到 15 条以上
--max-send 3之类小批量分多次跑- 错峰时段（避开 9 点整、10 点整这种太规整的时间）
工具默认只在 9:30-12:00 / 14:00-19:00 跑。强行跑加 --ignore-hours，但不推荐——非工作时间发消息正是风控的重点信号。
- 改时段曲线：编辑
boss_cli/pacing.py的INTENSITY_CURVE - 改每日上限：编辑
boss_cli/auto_reply.py的DEFAULT_DAILY_QUOTA，或 CLI 加--limit N - 改 burst 大小/间隔：编辑
boss_cli/pacing.py的BURST_MIN/MAX、INTRA_BURST_SEC、REST_GAP_SEC
改完不用重装。
为了让调用模式像真人 HR，工具内置了两层「行为真实度」：
每发一条消息前，自动按这个顺序：
打开候选人简历 (view_geek)
↓ 8-25 秒"读简历"停顿
拉聊天记录 (chat_history)
↓ 按消息长度的"打字"延迟
发消息 (boss_send_message)
让 Boss 后端看到完整的「浏览-阅读-回复」调用图谱，而非孤立 send。
不再是固定 12-30s，而是「3-5 条一个 burst → 15-40 分钟休息 → 再 burst」，并按时段强度自动伸缩：
- 09:30-10:30 / 13:30-14:30：缓冲（强度 0.4-0.5，间隔自动放大）
- 10:30-12:00 / 14:30-16:30：峰值（强度 1.0）
- 12:00-13:30：硬静默（不发任何消息，HR 也吃午饭）
- 16:30-19:00：尾段（强度 0.3-0.7）
查看当前节奏状态：
boss recruiter pacing-status
# 输出：工作强度、当前 burst 进度、距下次可发还有几秒、下一步动作--batch（CLI 默认）：单次调用按 pulse 内置 sleep 跑完整批。可能跑数小时。配 --max-send 5 切短。
--respect-pacing（MCP 默认）：单次调用最多发 1 条。如果当前在 cooldown / rest / 午休，立即返回并告诉 agent 等多久。推荐配 cron / agent 调度器每 10 分钟触发一次：
# crontab：每工作日 9:30-19:00 每 10 分钟触发
*/10 9-18 * * 1-5 cd ~/dev/boss-cli && source .venv/bin/activate && boss recruiter auto-reply --respect-pacing -y >> /tmp/boss-auto.log 2>&1或者直接在 Codex 里说："以后每 10 分钟帮我跑一次 boss 的 auto_reply"，让 agent 自己定时。
每发一条消息都写一行到 ~/.config/boss-cli/auto_reply_audit.jsonl，字段：
ts/view_ts/read_ts—— 三步调用的时刻（用来验证「浏览-阅读-回复」链路完整）intensity—— 发送瞬间的工作强度（0.3-1.0）burst_position—— "3/5" 表示当前 burst 第 3 条共 5 条
出问题时回看：
tail -20 ~/.config/boss-cli/auto_reply_audit.jsonl今日已用配额：
cat ~/.config/boss-cli/auto_reply_quota.jsonPulse 状态（cross-invocation 持久化）：
cat ~/.config/boss-cli/session_state.jsonboss login # 一次性
boss recruiter pending # 看谁等你
boss recruiter auto-reply -y # 帮你回
或在 Codex 里说："boss 看下有谁等我回，帮我都回了"。
本项目 fork 自 jackwener/boss-cli，在原有 CLI 基础上加了 HR 自动回复 + MCP server 能力。完整的求职者端 / 招聘方其他命令请看 README_UPSTREAM.md。