使用说明书(必读)
一、功能介绍
BOSS 直聘助手是一款浏览器扩展，提供职位采集、AI 分析、公司查询、自动打招呼等功能，辅助求职者高效管理求职流程。
💡 推荐使用 LibreWolf 浏览器（基于 Firefox，内置隐私增强功能，无遥测追踪），兼容所有 Firefox 插件。
版本功能对照表
| 功能 | 免费版 | 专业版 | 旗舰版 |
|---|---|---|---|
| 单条采集 | ✔ | ✔ | ✔ |
| 批量采集 | ✔（≤5条） | ✔（≤15条） | ✔（≤15条） |
| 每日采集上限 | 100条 | 无限制 | 无限制 |
| 全自动采集 | — | ✔ | ✔ |
| 采集间隔设置 | — | ✔ | ✔ |
| 职位排除关键词 | — | ✔ | ✔ |
| 采集后自动 AI 分析 | — | ✔ | ✔ |
| AI 分析（强制） | ✔ | ✔ | ✔ |
| AI 分析（智能 / 缓存） | — | ✔ | ✔ |
| 公司信息浮窗 | ✔ | ✔ | ✔ |
| 公司联网查询 | — | ✔ | ✔ |
| 公司标记（黑名单 / 大厂 / 备注） | — | ✔ | ✔ |
| 黑名单自动过滤 | — | ✔ | ✔ |
| 批量标记已处理 | ✔ | ✔ | ✔ |
| 批量删除 | ✔ | ✔ | ✔ |
| 人工填写问候语 | ✔ | ✔ | ✔ |
| 批量自动打招呼 | — | — | ✔ |
| AI 打招呼语生成 | — | — | ✔ |
| 趋势图表 | 演示数据 | 真实数据 | 真实数据 |
| 任务看板 | 限100条 | 完整 | 完整 |
| 实时日志 | ✔ | ✔ | ✔ |
二、配置说明
所有配置在 求职配置 页面（myInfo）完成。
2.1 AI 配置
支持 DeepSeek 和 小米 MiNo 两种 AI 供应商，在下拉框中选择对应供应商后，填写各自的 API Key。
| 配置项 | 说明 |
|---|---|
| 个人基础信息提示词 | 描述你的个人背景、技能、求职意向，用于 AI 分析职位匹配度 |
| 限制提示词 | 描述你不想去的公司类型、地点限制等排除条件 |
| AI 供应商 | 选择 DeepSeek（推荐）或小米 MiNo |
| API Key | 对应供应商的 API Key，点击"验证"确认有效 |
DeepSeek API Key 获取步骤：
- 登录 platform.deepseek.com
- 进入 API keys 页面，点击"创建 API key"
- 填写名称并创建，复制生成的 API Key
- 粘贴到配置页面的 API Key 输入框，点击"验证"
- 显示"Key 有效"即完成
小米 MiNo API Key 获取步骤：
- 登录 platform.xiaomimimo.com
- 进入控制台 → API Keys 页面，点击"创建 API Key"
- 复制生成的 API Key
- 在求职配置中选择 AI 供应商为"MiNo"
- 粘贴 API Key 到输入框，点击"验证"
- 显示"Key 有效"即完成
⚠️ MiNo 用户注意：使用公司联网查询功能前，需在 MiNo 控制台 → 插件 → 联网服务 中开通「联网搜索插件」，否则联网查询将失败。详见「小米 MiNo API Key 获取教程」。
2.2 打招呼设置
| 配置项 | 说明 |
|---|---|
| 打招呼语 | 自动发送给招聘方的问候语，支持换行和简单格式 |
| AI 打招呼语生成（旗舰版） | 在聊天页面点击「AI 打招呼语」按钮，AI 自动生成贴合职位与个人背景的问候语 |
| AI 打招呼语生成要求（旗舰版） | 填写 AI 生成打招呼语时需遵循的要求（如语气风格、强调的亮点），AI 将按此要求生成 |
设置完成后，在聊天页面点击"填写问候语"按钮可手动填入；旗舰版用户可批量自动发送，并可使用 AI 打招呼语生成功能。
2.3 采集配置（专业版 / 旗舰版）
| 配置项 | 说明 |
|---|---|
| BOSS 搜索页面地址 | 全自动采集的目标搜索页 URL |
| 全自动采集间隔（分钟） | 每轮采集完成后等待多久再开始下一轮（1-10 分钟） |
| 采集后自动 AI 分析 | 开启后每采集到一条职位自动进行 AI 匹配分析（需 DeepSeek API Key 有效） |
| 职位排除关键词 | 包含这些关键词的职位将自动跳过，多个用逗号分隔 |
三、使用指南
3.1 采集职位
在 BOSS 直聘职位搜索页，页面右侧会显示采集按钮组。
单条采集：
- 点击一条职位卡片使其高亮 → 点击"采集当前职位"按钮
批量采集：
- 点击"批量采集"按钮，从当前记录的位置开始依次采集
- 免费版每次最多 5 条，专业版 / 旗舰版每次最多 15 条
全自动采集（专业版 / 旗舰版）：
- 点击"全自动采集"按钮，扩展会自动循环：批量采集 → 暂停 → 模拟滚动加载更多 → 继续采集
- 可在求职配置中设置采集间隔和排除关键词
- 点击"停止采集"按钮终止
采集位置管理：
- "位置"按钮显示当前选中的是第几条卡片
- "记录位置"按钮保存当前位置，下次批量采集从此继续
3.2 AI 分析职位
在 数据管理 页面（jobInfo）选中职位后：
| 按钮 | 说明 |
|---|---|
| AI 分析 | 强制重新分析，忽略已有缓存 |
| 智能 AI 分析（专业版 / 旗舰版） | 优先使用缓存，未分析过的才调用 API，节省 Token |
查看分析结果：
- 点击职位行操作列的"详情"按钮
- 左侧抽屉显示：匹配度百分比（颜色编码）、匹配分数、详细分析文本、建议投递/不建议投递
3.3 职位管理与筛选
数据管理页面提供多维筛选：
| 筛选条件 | 说明 |
|---|---|
| 日期范围 | 按职位创建时间筛选 |
| 处理状态 | 未处理 / 已处理（标记过"已处理"的记录） |
| 打招呼状态 | 待发送 / 已发送 / 已下架 / 沟通过 / 进入失败 |
| 是否分析 | 未分析 / 已分析 |
| 是否建议投递 | 按 AI 分析结果筛选（专业版 / 旗舰版） |
| 是否大厂 | 按公司标记筛选（专业版 / 旗舰版） |
| 频次 | 显示该职位招聘方出现的次数，≥3 次标黄提示 |
批量操作按钮：
| 按钮 | 说明 |
|---|---|
| 打招呼（旗舰版） | 对选中职位批量自动发送问候语 |
| 标记已处理 | 标记选中职位为"已处理"，表示已人工过目 |
| 取消标记 | 取消已处理标记 |
| 删除 | 删除选中职位 |
| AI 分析 / 智能 AI 分析 | 对选中职位进行 AI 匹配分析 |
3.4 打招呼
配置问候语：
在求职配置页面填写"打招呼语"并保存。
手动填写（所有版本）：
- 进入 BOSS 直聘聊天页面
- 点击右下角的"填写问候语"按钮
- 问候语自动填入输入框，手动发送
AI 打招呼语生成（旗舰版）：
- 进入 BOSS 直聘聊天页面
- 点击右下角的"AI 打招呼语"按钮
- AI 根据职位描述与个人背景生成个性化问候语（可先在求职配置中设置生成要求）
- 确认内容后点击发送
批量自动打招呼（旗舰版）：
- 确认已在求职配置中填写好"打招呼语"，或使用 AI 打招呼语生成
- 在数据管理页面筛选出需要打招呼的职位
- 选中职位，点击"打招呼"按钮
- 系统自动依次处理：
- 打开职位详情页 → 查找"立即沟通"按钮 → 进入聊天页
- 填入问候语 → 点击发送 → 等待 5-10 秒 → 关闭页面
- 每处理 5 条暂停 30-60 秒防检测
- 每条完成后等待 3-8 秒再执行下一条
- 处理过程中请勿操作 BOSS 直聘页面
打招呼状态说明：
| 状态 | 含义 |
|---|---|
| 待发送 | 已加入队列，等待自动发送 |
| 已发送 | 问候语已成功发送 |
| 已下架 | 职位已下架或沟通按钮未找到 |
| 沟通过 | 之前已发送过消息 |
| 进入失败 | 无法进入聊天页面 |
3.5 公司查询与标记
页面浮窗（自动弹出）：
- 在 BOSS 直聘职位详情页，右侧自动显示公司信息浮窗
- 包含：公司名称、大厂标签、黑名单警告、备注、AI 联网查询结果
- 可直接在浮窗中编辑大厂/黑名单/备注
公司标记页面（companyRemark，专业版 / 旗舰版）：
- 集中管理所有公司标记
- 支持：新增/编辑/删除公司标签
- 设为黑名单后，采集时自动跳过该公司职位
联网查询：
- 点击"查询工商信息"或公司名可触发 AI 联网查询企业信息
- 每次查询消耗 AI Token
3.6 趋势查看
在趋势页面可查看 7 天 / 30 天数据变化，包含：
- 统计卡片：职位总数、新增数、可投递数
- 折线图：三条趋势线（总数 / 新增 / 可投递），支持悬停查看详情
- 趋势分析：自动生成文本总结（增长率、峰值标记等）
- 每日明细表格
免费版显示为演示数据，专业版 / 旗舰版展示真实数据。
3.7 侧边栏
点击扩展图标或右键菜单"打开求职助手面板"可打开侧边栏，包含：
- 后端服务连接状态
- 今日任务统计数据
- 实时采集日志（最多 30 条）
- 采集位置控制
- 底部导航链接
四、常见问题
Q1：后端无法启动 / 连接失败
现象： 侧边栏显示红色断开状态，功能不可用。
排查：
- 确认已下载并启动后端服务（默认地址
http://localhost:9999） - 检查端口 9999 是否被占用
- 如使用自定义地址，确认扩展已配置对应地址
- 点击侧边栏"重新连接"按钮
Q2：AI API Key 校验失败
DeepSeek 用户：
- API Key 未正确复制（注意不要漏掉字符）
- API Key 已失效或已被删除
- 网络无法访问
api.deepseek.com - DeepSeek 账户余额不足
小米 MiNo 用户：
- API Key 未正确复制
- API Key 已失效或已被删除
- 网络无法访问
api.xiaomimimo.com - MiNo 账户余额不足或未开通 API 服务
解决： 确认使用的 API Key 与所选供应商匹配，重新生成 API Key 后再次验证，并确认账户已充值。
Q3：采集不到数据
排查：
- 确认当前在 BOSS 直聘职位搜索页（
zhipin.com/web/geek/jobs） - 确认搜索页有职位列表展示
- 检查是否已达到每日采集上限（免费版 100 条）
- 查看采集日志是否有错误提示
Q4：打招呼失败
| 失败原因 | 处理方法 |
|---|---|
| 未找到"立即沟通"按钮 | 职位可能已下架，状态会标记为"已下架" |
| 已沟通过 | 之前已发送过消息，自动跳过并标记 |
| 进入页面失败 | 状态标记为"进入失败"，可尝试手动处理 |
| 按钮未被点击 | 检查 BOSS 直聘页面是否有弹窗遮挡 |
Q5：许可证相关问题
激活失败：
- 确认激活码未过期
- 确认机器码与激活时一致（重装系统或更换浏览器会导致机器码变化）
到期：
- 到期后自动降级为免费版，超出限制的功能将不可用
- 续费后重新激活即可恢复
等级不符：
- 批量打招呼与 AI 打招呼语生成需要旗舰版，AI 分析智能模式需要专业版或旗舰版
- 如需使用对应功能请升级许可证
Q6：AI 分析失败
- 确认所选 AI 供应商的 API Key 有效且未过期
- 确认网络可正常访问对应的 API 端点
- DeepSeek：
api.deepseek.com；小米 MiNo：api.xiaomimimo.com - 确认已填写个人基础信息提示词
- 确认账户余额充足（参考 Q7）
- 如频繁失败，可尝试使用"强制分析"重试
Q7：AI 余额消耗说明
AI 分析功能按 Token 用量计费，以下操作会消耗余额：
| 功能 | DeepSeek 单次消耗 | 小米 MiNo 单次消耗 |
|---|---|---|
| AI 分析职位（含 AI 打招呼语生成） | 约 4500 Token | 约 4500 Token |
| 公司联网查询 | 约 1000 Token | 约 1000 Token |
| 采集后自动 AI 分析 | 每采集一条自动分析一次 | 每采集一条自动分析一次 |
DeepSeek 费用参考：
- 实测约 108 次 AI 调用共消耗约 48.85 万 Token（平均每次约 4500 Token，单次费用约 0.007 元）
- 按每天分析约 300 条职位计算，日消耗约 2 元
- 余额不足时需在 platform.deepseek.com/top_up 充值
小米 MiNo 费用参考（mimo-v2.5 模型）：
- 输入：¥1/MTok（缓存未命中）、¥0.02/MTok（缓存命中）
- 输出：¥2/MTok
- 单次 AI 分析费用约 0.005 元，比 DeepSeek 更便宜
- 余额不足时需在 platform.xiaomimimo.com 充值
注意：以上是 AI 分析功能的 API 调用费用，与软件本身的版本收费（免费版/专业版 59 元/月/旗舰版 89 元/月）无关。