Skip to content
YanQuan edited this page Oct 21, 2026 · 10 revisions

BossClaw · 使用与开发教程

面向求职者的本地 AI 投递助手(Electron 桌面应用)—— 独立运行,不占用你的浏览器;正常上网的同时自动解析简历、匹配岗位并投递简历。

BossClaw 把求职过程中重复的整理工作集中到一个本地桌面应用里:

导入简历 → AI 生成职业画像 → 自主选择投递方向 → 整理岗位信息
        → AI 匹配与优先级排序 → 人工确认 / 半自动辅助 → 查看进度与处理异常

全程数据本地优先,AI 只调用你自己的 Key。


从这里开始

页面 内容 适合谁
快速开始 下载安装、源码构建、首次配置、单条验收 所有新用户
功能指南 界面总览 + 12 个侧栏入口的逐页操作说明 日常使用者
架构与开发 技术栈、进程与信任边界、模块地图、数据模型、核心链路、IPC 与控制桥、安全不变量、回归门禁、打包发布、排障 开发者 / 贡献者
安全与合规 安全边界、安全不变量、数据隐私、免责声明 所有用户 / 审核者
常见问题 白屏、登录态、隐身引擎、多平台、投递节奏等排障 遇到问题的人

第一次用:直接读 快速开始 的一至四节,做到第五节「单条验收」就算上手了。别跳过验收 —— 首次成功投递一条后系统会强制暂停等你确认。

30 秒速览

项目 说明
当前版本 v2.5.7(2026-10-13 发布,Windows 10/11 x64 安装版 + 便携版);Linux AppImage / deb / tar.gz 与 macOS 自构建档案仍为 v2.5.3 产物
技术栈 Electron ^42(Chromium 148)· React 18 · TypeScript · Vite 5 · Ant Design 5 · Zustand
界面 单窗口:标题栏 + 12 入口侧栏 + 主内容区(工作台三栏、其余页面双栏)+ 状态栏
数据存储 本地优先(localStorage / Zustand persist),零后端依赖
代码位置 desktop-app/(统一 Electron + React 应用,无需浏览器扩展)
许可 Apache License 2.0
能力规模 4 个招聘平台 · 9 项内置 AI 技能 · 9 个 MCP 工具 / 3 组 · 112 条 IPC 白名单 · 内置 13.6K 面试题

核心能力

版本提示:本页按 main 分支当前实现标注。其中模拟面试于 2026-10-20 合入 main,v2.5.7 安装包(2026-10-14 构建)未包含,要现在用需从源码构建。

简历与画像

  • 简历解析:PDF / DOCX / DOC / MD / TXT 本地解析,渲染进程内完成、不经网络。旧版 .doc(Word 97-2003)由自研解析器处理(OLE2/CFB 容器,兼容「实为 RTF / HTML」的文件);加密文件或纯图片扫描件仍建议转档为 .docx / .pdf。
  • AI 职业画像:AI 生成 + 本地规则三级降级,结果全部字段可编辑。
  • 方向智能校准:投递方向支持 AI 生成 / 校准搜索关键词,含薪资校准模块与工作时间偏好,用于 AI 判断匹配并约束沟通内容。

多平台岗位采集

  • 多平台招聘:BOSS 直聘基础上可选启用 猎聘 / 智联招聘 / 前程无忧 51Job —— 设置页启用并调整优先级,各平台独立登录态与每日配额(BOSS / 猎聘 / 前程无忧默认 120 日,智联 100 日),岗位卡片带平台标识(BOSS 绿 / 智联蓝 / 猎聘橙 / 前程无忧紫)。四个平台均已打通「搜索 URL 构造 → 列表采集 → 详情 JD 补齐 → 审核入队 → 投递」全链路。
  • 多平台采集层:Python camoufox/platforms/(能力矩阵 / 三段骨架 / 注册表 / 词级断点续采)+ 内置浏览器多平台适配表(platform-adapters.cjs)。非 BOSS 平台也能走内置浏览器做列表级采集,详情 JD 由内置浏览器按平台同源接口补齐(智联 = 详情 JSON、猎聘 = 同源详情页 HTML),不依赖隐身引擎。采集故障分「平台级 / 队列级」:队列级(风控 32·35·36、环境异常 37·38、未知码)整批中止交人工。
  • 多页浏览:内置浏览器支持多标签 / 多页管理(browserRegistry),窗口尺寸变化联动重绘。

匹配与过滤

  • AI 四层整体裁决:硬门槛 → 优先条件 → 职责信号 → 团队信号,一次给出 fitLevel 档位,分数随档走、AI 分即最终分(本地五维仅用于展示与 AI 不可用时兜底);入队门槛由设置页 minQueueScore 控制。工作台做岗位去重(归一化 URL / jobId / 软匹配)并合并跳过日志。
  • 确定性过滤(纯本地,不消耗 AI Token 与投递配额):
    • 面试方式:设置页指定「线上 / 线下 / 不限」,「加入任务」时按岗位文本识别;未明确披露 = 合格,不误杀。
    • 岗位过期判定:JD 中显式写出投递截止日期(猎聘常见「截止日期:2027年07月16日」)且早于今天的岗位被硬性排除,截止日当天仍有效;未写、写成「长期有效 / 招满即止」或日期不可解析一律放行(默认仅猎聘开启,设置页可关)。

投递与沟通

  • 投递闭环:工作台三栏(侧栏 + 消息进度 + 内置浏览器)。一键投递按岗位所属平台自动选通道 —— BOSS 走详情页真实 DOM 沟通;猎聘 / 智联 / 前程无忧在各自平台标签页内完成投递,猎聘以「真实输入本岗位招呼语 + 新增本人文字消息」为成功信号,仅会话打开不计成功。任务级进度 + 实时日志 + 失败恢复。
  • 投递节奏:人工确认 / 半自动 / 自动辅助三档,操作细节见功能指南 §6.5。
  • 自动沟通:可选真实浏览器引擎(Camoufox)多平台批量沟通 —— BOSS 聊天;猎聘点「聊一聊」后真实输入本岗位招呼语 + 文字气泡确认;智联 / 前程无忧投递简历。发送结果确认后才计成功,按平台优先级串行执行。
  • AI 跟聊监听(BOSS 专属,可选开关):常驻巡检「已投递」会话,HR 回消息即带多轮上下文自动回复;HR 明确拒绝则收口该会话;回复类发送不计入单日投递上限。
  • 人工作息节奏:活跃时段(默认 8:00–23:00,带每日抖动)与批次休息(每 N 个岗位分钟级长休),非活跃时段自动暂停;不改变既有速率上限与安全不变量。

面试与定制简历

  • 定制简历:输入岗位 JD(或从已批准 / 已投递岗位导入)生成定制摘要 / 量化经历 / 突出技能 / 技能缺口 / 定制求职信 / 优化建议,仅引用简历真实事实。工作台岗位支持单岗位 / 批量 / 迭代三档生成,可导出 PDF(A4)、可存入打招呼语,另可导入「经历补充材料」辅助定制。
  • 模拟面试:按岗位 JD(可带简历原文)出题,两段式(基础题 → 针对你回答的深挖题);语音作答(本地 ASR,可选在线高音质 TTS / 克隆音色)或文字作答;答完一次性出报告 —— 五维加权(相关性 / 证据具体性 / 结构 / 深度 / 复盘权衡)+ 逐题评分 + 改进建议。模型只给档位、分数本地按权重算,同一份回答重算恒定;内置题库 + 自建 / 导入题库,历史会话可导出。

自动化与数据

  • 定时任务:按设定时刻(HH:mm + 星期)自动触发「投递 / 采集 / 备份」三类动作;每条任务可圈定目标平台并设单轮条数上限;「分批投递模板」一键创建早 / 午 / 晚三条任务;心跳扫描 + 按时刻去重,最小化仍触发。
  • 本地备份:localStorage 主存储,每 5 分钟脏检查写盘到可配置备份目录,主存储缺失自动回签恢复。
  • 开机自启动:设置页开关(Windows 登录项),配合定时任务后台自动运行。
  • 数据统计:投递量、沟通量、成功率等指标看板 + 投递漏斗(采集入队 → 已投递 → 已打开沟通 → 已回复 → 面试),支持导出岗位明细 CSV / 统计汇总 CSV / 统计报表 PDF(A4 横版)。

集成与增强

  • AI 技能体系:内置 9 项技能(resume-profile / job-analysis / greetings / tailor-cv / jd-reading / great-resume / job-match / mock-interview-question / mock-interview-report),支持自定义技能导入 / 新建 / 删除。
  • 外部 Agent 通道:应用内白名单控制桥(本地令牌鉴权、默认关闭,start-bossclaw.cmd 默认开启)+ mcp/bossclaw-mcp 零依赖 stdio MCP 服务器(9 工具 / 3 组)。未配置 API Key 时可由在线外部 Agent 代答(只搬运提示词与生成文本,发送类能力默认不开放);安全侧配置(活跃时段 / 批次休息 / 首条验收 / 日上限 / 执行模式)禁止经控制桥改写。
  • 内置浏览器真实性增强(v2.5.6 起):内核升级 Electron 42 / Chromium 148,UA / UA-CH 由内核真实产生;主世界反检测补丁 + 请求头与真机画像同源对齐(一份 TARGET_PROFILE 驱动 UA / 请求头 / JS);BOSS 聊天链路改真实事件优先 + 人类化鼠标轨迹。
  • 可选隐身增强(默认关闭):Camoufox(仅用原生内核,本地 Chrome / Edge 不可复用)/ CloakBrowser,不绕过验证码与账户验证。

适合谁 / 不适合谁

适合

  • 同时在 BOSS、猎聘、智联、前程无忧投递,进度还靠表格或聊天记录管的人
  • 想用自己 API Key 的模型做匹配与招呼语,但不接受把简历交给第三方 SaaS 的人
  • 需要「AI 先整理、人再拍板」,而不是全托管黑盒的人
  • 拿到面试后想按真实 JD 练一场,又不想被摄像头和数字人绑架的人

不适合

  • 期望「一键海投、全程不用确认」的 —— 发送类动作默认不开放,首次成功投递后强制暂停验收
  • 需要移动端、网页版或跨设备同步的 —— 数据本地优先,存于 localStorage
  • 想绕过验证码、账号限制或平台风控的 —— 明确不做,遇风控码 32 / 35 / 36 / 37 立即停止交人工
  • 既不配置 API Key、也不接外部 Agent 代答的 —— AI 相关能力不可用

三条不能跳过的约定

  1. 首次只投一条并验收:确认打开的是所选岗位、沟通对象与岗位一致、文字基于真实简历、页面出现完整的已发送文字气泡、任务状态记录正确。任一步无法确认就暂停。
  2. 没看到文字气泡就不算成功:不发送附件、不计成功、不跳下一岗位。
  3. 敏感数据不出本机:简历、画像、任务记录与 API Key 都存在本地;只有你自己配置的模型服务商能看到必要的简历摘要与岗位信息。

边界与例外情形见安全与合规。


快速链接