Catch-Job

面向求职者的 Chrome / Edge AI 求职助手

从公开 GitHub 仓库生成项目经历与简历，并在浏览器侧边栏中完成简历管理、岗位采集、AI 匹配和投递进度跟踪。

快速安装 · 使用流程 · 完整指南 · 常见问题

Catch-Job 是独立维护的求职辅助工具，不属于 BOSS 直聘官方产品。请使用真实信息、遵守平台规则，并在发送消息或投递前核对结果。

核心能力

• GitHub 简历生成：读取用户自己的公开仓库，根据基本信息、教育经历和其他经历生成项目经历与一套 A4 简历。
• 已有简历导入：支持 PDF、DOCX、TXT 和直接粘贴文本，识别结果可继续编辑。
• 职业画像与岗位方向：从简历整理技能、项目和求职偏好，由用户选择最终投递方向。
• 岗位采集与 AI 匹配：采集岗位信息，分析匹配度、硬性条件、能力差距和风险。
• 人工确认与自动模式：可逐条审核，也可在完成首次单条验收后启用自动沟通。
• 任务进度管理：集中查看执行阶段、岗位状态、失败原因，并支持重试或忽略失败任务。
• Chrome / Edge 适配：支持 Manifest V3 和 Side Panel；无法使用侧边栏时自动改为独立标签页。

安装扩展

从 Releases 下载最新发布包并解压。请使用发布资产中的完整安装包，不要直接使用 GitHub 自动生成的 Source code.zip。

1. Chrome 打开 chrome://extensions，Edge 打开 edge://extensions。
2. 开启“开发者模式”。
3. 点击“加载已解压的扩展程序”。
4. 选择发布包中的 extension 目录。
5. 登录 BOSS 直聘，点击扩展按钮打开 Catch-Job。

Chrome 和 Edge 使用同一个扩展目录，无需分别构建。

使用流程

通过 GitHub 生成简历

进入“简历 -> 生成简历”。

1. 填写姓名、目标职位、联系方式等基本信息。
2. 至少填写一条教育经历，按需添加实习、社团、竞赛、获奖或证书。
3. 输入 GitHub 用户名或个人主页地址，读取自己的公开仓库。
4. 选择 1 至 4 个项目。Catch-Job 会基于仓库描述、语言、topics、活跃度和 README 整理项目事实。
5. 点击“生成并预览”，核对生成内容。
6. 使用唯一的 A4 模板，通过浏览器打印功能导出 PDF。

该流程不要求 GitHub 登录或 Token，不读取私有仓库。AI 可用时只在仓库事实范围内优化表达；未配置 AI 时使用本地规则生成初稿。

导入已有简历

进入“简历 -> 简历原文”，上传 PDF、DOCX、TXT，或直接粘贴简历正文。识别结果会显示在编辑器中，确认无误后可保存原文并生成职业画像。

文本型 PDF 默认在浏览器内处理。扫描件、特殊字体或布局复杂的 PDF 可使用可选的 macOS 本地 OCR，详见本地 OCR。

配置 AI 与求职条件

在“设置”中填写城市、求职类型、经验、学历、薪资等筛选条件，并配置自己的 AI API Key。连接测试通过后，再从职业画像中确认岗位方向和搜索词。

API Key 仅应保存在自己的浏览器中，不要提交到仓库、Issue、日志或截图。AI 输出是可编辑初稿，投递前应核对经历、技能、薪资和入职时间等事实。

执行与跟踪

首次使用建议选择“人工确认”，先完成一条岗位的采集、匹配和沟通验收。确认聊天对象、消息内容、附件和任务记录均正确后，再考虑自动模式。

“消息”页面展示当前阶段、执行进度、失败原因和重试次数。遇到验证码、登录异常、页面结构无法确认或聊天对象不明确时，任务应暂停并交由用户处理。

可选本地 OCR

macOS 用户可运行发布包根目录中的：

install-pdf-ocr-macos.command

安装器会启动仅监听 127.0.0.1:17899 的本地简历解析服务，并使用 PDFKit、Vision OCR 或 pdftotext 识别 PDF。文件只在本机临时处理；该服务不是使用 Catch-Job 其他功能的前置条件。

本地解析器源码位于 local-resume-parser/。安装、升级与故障排查步骤见新手安装与使用和常见问题。

项目结构

Catch-Job/
|-- extension/                           可直接加载的 Chrome / Edge 扩展
|-- source/                              扩展源码、构建脚本与测试
|   |-- public/                          Manifest、HTML 与样式资源
|   |-- src/                             前端、后台与内容脚本
|   |   `-- content-v37.js               BOSS 直聘页面内容脚本
|   |-- scripts/                         构建校验脚本
|   `-- tests/                           单元、集成与回归测试
|-- local-resume-parser/                 可选 macOS PDF/OCR 本地解析器
|-- docs/                                使用、安全、架构与发布文档
|-- install-pdf-ocr-macos.command        macOS 本地 OCR 安装器
|-- LICENSE                              Apache License 2.0
`-- NOTICE                               版权与上游声明

补充文档：

• 安装与使用
• 技术栈
• 架构说明
• 权限说明
• 隐私与安全
• 首次单条验收
• 发布说明

开发与测试

建议使用 Node.js 20 或更高版本。

cd source
npm install
npm test
npm run build

• npm test：执行构建校验、单元测试、集成测试、回归测试、Manifest 检查、语法检查、敏感信息扫描和发布目录同步检查。
• npm run build：构建扩展并输出到 source/dist/chrome-extension/。
• 根目录的 extension/ 是可加载和发布的扩展副本，发布前需确保它与构建输出一致。

贡献约定见 CONTRIBUTING.md，正式发布检查见正式版验收说明。

隐私与安全

• 简历、职业画像、筛选条件、API Key 和任务记录默认保存在当前浏览器本地。
• GitHub 简历功能只请求 api.github.com 的公开仓库信息，不保存 GitHub Token。
• 配置 AI 后，生成或分析所需的简历与岗位内容会发送到用户选择的 AI 服务。
• 可选 OCR 服务只绑定本机回环地址，并限制浏览器跨域请求的扩展来源。
• 项目不需要导出、共享或远程托管登录 Cookie。
• Catch-Job 不应被用于绕过验证码或安全限制、虚构经历、批量骚扰或规避平台规则。

不要在公开仓库、Issue 或日志中提交真实简历、API Key、手机号、邮箱、聊天记录等个人信息。完整说明见隐私与安全及 SECURITY.md。

许可与上游署名

Catch-Job 使用 Apache License 2.0 发布。复制、修改或再分发时，请保留 LICENSE、NOTICE、上游署名和变更说明。

本项目基于以下上游项目继续开发：

JobClaw by Chris

https://github.com/Chrisbetheking/job-claw

Catch-Job 是独立维护的衍生项目，不代表上游作者对本项目的认可或背书。详细归属信息见 ATTRIBUTION.md。

反馈

• 功能建议与缺陷：GitHub Issues
• 安全问题：Security Policy

Catch-Job 与 BOSS 直聘及其运营主体不存在隶属、合作或授权关系。“BOSS 直聘”是相关权利人的商标。