RecruitOps 秋招工作台

一个面向校园招聘的 Windows 桌面软件：发现和筛选岗位、补全 JD、匹配评分、辅助投递、维护投递进度、处理招聘邮件，并把笔试、面试和待办统一到一处。

主要功能

下载与启动

系统要求

• Windows 10 或 Windows 11，64 位
• 建议至少 8 GB 内存
• 建议预留 3 GB 可用磁盘空间
• 能访问模型 API、招聘网站和邮箱 IMAP 服务的网络

1. 下载桌面版

当前可用版本为 RecruitOps v0.1.5，请下载 RecruitOps-v0.1.5.zip：

• GitHub Releases
• Gitee v0.1.5 更新说明（完整安装包请从 GitHub 或 123 云盘下载）
• 123 云盘

安装包大小约 704 MB。下载完成后可按需核对 SHA-256：

D9030D35B30F67497EBB6AB9115AA7A587BB2DA52CA2E50A1D233424F7D8C47E

如果旧版已经爬取到岗位，或已有投递记录、招聘邮件，请先阅读已有数据的桌面版升级步骤。不要直接把旧版 .data 复制到不同安装路径。

本版重点修复简历结构化解析、评分缺维度、管理员权限启动、全量任务超时接续和批量投递复核，并完善任务进度、邮件关联及投递搜索。完整范围与限制见 v0.1.5 更新说明。

2. 完整解压

将压缩包完整解压到可写的短路径，例如：

D:\RecruitOps

不要直接在压缩包预览窗口中运行，也不要只复制其中的 EXE。数据库、Python、Node.js、Chromium 和 PostgreSQL 都是软件的内部组件，必须和主程序保持原有目录结构。

3. 启动唯一入口

双击：

RecruitOps-Desktop-Preview.exe

普通用户只需要运行这一个文件，不需要启动 CMD 脚本，也不需要单独启动目录里的其他程序。首次启动会初始化本地数据库和运行组件，时间可能比之后启动稍长。

桌面版不要求预先安装 Docker、Python、Node.js、PostgreSQL 或浏览器插件。

首次配置

启动后进入左侧 配置 页面，按下面顺序完成设置。

1. 配置模型连接

1. 点击 添加连接，或编辑已有的主连接。
2. 选择 DeepSeek 或 OpenAI 兼容接口。
3. 填写 API 服务地址、模型名称和 API Key。
4. 点击 测试连接。测试会检查鉴权、模型名称、结构化输出和求职助理接口。
5. 测试通过后点击 保存模型连接。

可以保存多个连接，但同一时间只有一个主连接。简历解析、岗位评分、邮件理解和求职助理都使用当前主连接。

2. 上传并分析简历

1. 上传文字版 PDF、TXT 或 Markdown 简历，文件最大 10 MB。
2. 点击 分析简历。
3. 系统会提取学历、技能、项目依据和岗位筛选关键词。
4. 检查模型生成的关键词，根据自己的求职目标增删后再保存。

岗位筛选关键词不能为空。它们用于第一轮标题筛选，决定哪些岗位值得继续抓取 JD 和评分。扫描版 PDF 如果没有文字层，请先转换为可复制文字的 PDF。

3. 选择岗位范围

• 招聘类型固定为校招正式岗位。
• 社招和实习默认排除，不需要额外配置。
• 在 OfferBiu 行业大类 中选择希望关注的行业方向。
• 行业方向控制公司来源范围，岗位关键词控制具体公司内保留哪些岗位。

4. 配置招聘邮箱

1. 在邮箱网页设置中开启 IMAP。
2. 创建授权码或应用专用密码，不要填写网页登录密码。
3. 在 RecruitOps 中选择邮箱服务商，或填写自定义 IMAP 地址和 SSL 端口。
4. 填写完整邮箱地址、授权码和邮件文件夹，通常为 INBOX。
5. 点击 测试邮箱连接，通过后保存。

网易 163 可直接选择预设；其他支持账号密码或应用密码登录 IMAP 的邮箱可使用自定义配置。仅支持 OAuth2 且不允许 IMAP 应用密码的 Gmail、Outlook 账号，当前版本暂不支持。

5. 保存配置

点击页面底部的 保存并完成首次配置。模型连接、简历关键词和行业范围准备完成后，求职助理、抓取后评分和本地定时任务会按配置自动启用，不需要再寻找额外开关。部分运行配置变更会提示重启桌面软件后生效。

从零开始使用

第一步：抓取并评分岗位

进入 求职助理，发送类似下面的指令：

完成一次全量岗位抓取并评分

也可以让助理创建每日定时任务。一次全量流程依次执行：

1. 从 OfferBiu 等来源同步公司和校园招聘入口。
2. 排除公众号、问卷、登录页、个人中心等不可直接抓取的入口。
3. 抓取各公司当前岗位列表并保存抓取状态。
4. 按岗位标题关键词筛出相关岗位。
5. 对 JD 缺失或不完整的候选岗位抓取详情。
6. 对公司和岗位进行去重、更新和失效标记。
7. 使用简历事实完成匹配评分和优势、劣势分析。
8. 保存检查点和最终统计；长任务中断后可从检查点恢复。

任务进度中的“需要补全 JD”表示当前候选集中 JD 不完整的岗位数量，不等于本轮新抓取到的关键词命中岗位数。

第二步：查看和筛选岗位

进入 27 届校招：

• 按公司、岗位类型、招聘平台、评分状态和匹配分筛选。
• 高匹配岗位优先展示。
• 打开岗位详情可查看保存的 JD、匹配摘要、个人优势和待补足项。
• 点击招聘页按钮可在内置浏览器中打开岗位。

第三步：在内置浏览器投递

1. 打开目标公司的招聘页。
2. 在页面中自行完成登录、验证码或滑块验证。
3. 点击桌面工具栏的 简历闪填。
4. 扫描当前页面后，软件会尝试填写能够可靠识别的文本框、单选、多选、下拉框、重复经历和附件字段。
5. 检查内容后由你手动提交，软件不会代替用户完成最终提交。
6. 投递完成后，在 投递记录 页签填写公司、岗位、投递进度链接等信息并保存。

内置浏览器会为不同站点保存独立登录状态。验证码、密码和最终提交始终由用户处理。

第四步：维护投递进度

进入 投递记录 可以：

• 手动添加、编辑或删除记录。
• 打开保存的官方投递进度页。
• 查看阶段历史和证据说明。
• 让助理批量复核所有非终态岗位。

状态更新采用只升不降的优先级：已由邮件、人工或可靠官网证据确认的笔试、面试等阶段，不会因为官网只显示“已投递”“筛选中”或没有状态文本而被降级。

第五步：处理邮件和日程

进入 招聘邮箱 点击 同步邮件，或让求职助理处理未处理邮件。已成功处理的邮件会保存处理状态，后续同步不会重复执行同一事件；需要人工确认的邮件会保留在待确认列表。

邮件中的测评、笔试和面试如果包含明确日期，会生成日程；只有截止时间但没有具体开始时间的事项会以截止提醒保存；时间不明确的事项进入待办。

招聘邮箱	日程安排

第六步：查看公司来源和任务状态

进入 公司 可以查看每个招聘来源的入口地址、抓取状态、岗位数量、JD 未完成数量和最近尝试时间。抓取完整、抓取不完整 与 无法抓取 会分别保留，便于后续重试和排查。

进入 定时任务 可以查看：

• 每天的多个执行时间
• 是否启用、下次运行时间和最近运行时间
• 最近一次执行状态、耗时和结构化结果
• 失败原因以及 让助理解释 入口

定时任务依赖本地服务运行；需要在计划时间保持 RecruitOps 桌面软件开启。错过的时间点不会假装执行成功。

数据保存与升级

运行数据默认保存在软件目录旁的：

.data\

其中包含本地数据库、配置、任务检查点和招聘网站登录状态。建议定期备份整个 .data 目录。

若旧版已经爬取岗位，或已有投递记录、邮件等数据，必须先正常退出软件并完整备份 .data。新版本先解压到临时目录，随后让新程序回到旧版的相同绝对路径，再把整个旧 .data 同盘移回；使用原 Windows 用户启动。不要在软件运行时复制数据库，也不要直接覆盖正在使用的旧目录。逐步操作及回退方法见已有数据的桌面版升级步骤。

常见问题

到底应该启动 EXE 还是 CMD？

只启动 RecruitOps-Desktop-Preview.exe。CMD、内部 Python、Node.js 和 PostgreSQL 程序都不是用户入口。

桌面版需要 Docker 吗？

不需要。Releases 中的压缩包已经包含完整运行环境。Docker 只面向阅读源码、参与开发、运行 CI 或部署服务端环境的开发者。

首次打开为什么没有岗位？

新安装默认是空数据。完成模型、简历关键词和行业范围配置后，运行一次全量抓取，岗位和公司数据才会逐步入库。

出现 missing_resource、packaged_isolation_root_required 或 init_db_failed 怎么办？

1. 确认下载的是完整 Release 压缩包。
2. 重新完整解压到 D:\RecruitOps 这类短路径。
3. 不要只移动 EXE，不要从压缩包内运行。
4. 确认当前目录可写，并暂时避开网盘同步目录、系统保护目录和过长路径。
5. 如果旧目录曾启动失败，先备份 .data，再使用全新目录测试。

求职助理不可用怎么办？

回到 配置 页面测试主模型连接。检查 API Key、服务地址、模型名称和账户额度；保存后如果页面提示需要重启，请退出并重新打开软件。

邮箱连接失败怎么办？

确认邮箱已开启 IMAP，并使用授权码或应用专用密码。网页登录密码通常不能用于第三方 IMAP 客户端。

招聘官网打不开或状态读取失败怎么办？

先在内置浏览器中手动完成登录和验证码，等待岗位列表或投递记录完整渲染，再重新扫描。系统不会绕过登录、验证码、滑块或网站访问限制。

Windows 提示未知发布者怎么办？

当前便携版可能尚未进行商业代码签名。请确认压缩包来自本仓库 Releases，并核对 Release 页面提供的 SHA256 后再运行。

源码运行（开发者）

普通用户请使用上面的 Windows 桌面版。下面内容仅用于二次开发、调试和贡献代码。

Docker 开发环境

仓库保留 Docker 配置，用于统一 PostgreSQL、API 和 CI 环境；它不是桌面软件的用户安装方式。

git clone https://github.com/849879772/recruitops-agent.git
cd recruitops-agent
cp .env.example .env
cp config/companies.example.yaml config/companies.yaml
cp config/candidate_profile.example.yaml config/candidate_profile.yaml
docker compose up -d --build

PowerShell 可将 cp 替换为 Copy-Item。服务启动后访问：

• Web/API：http://127.0.0.1:8010
• 健康检查：http://127.0.0.1:8010/ready

停止开发环境：

docker compose down

本地开发与测试

python -m venv .venv
# Windows: .venv\Scripts\activate
# Linux/macOS: source .venv/bin/activate
pip install -e ".[dev]"
playwright install chromium
uvicorn apps.api.main:app --reload --port 8010
python -m pytest -c pytest-public.ini
python -m compileall apps packages scripts
docker compose config

技术架构

• 桌面层：Electron、内置招聘浏览器、站点隔离登录和简历闪填面板
• 应用层：FastAPI、原生 Web UI、REST API
• Agent 层：MCP typed tools、领域技能、工具路由、审批与审计边界
• 数据层：PostgreSQL 16、SQLAlchemy、阶段历史和任务检查点
• 采集层：Playwright、Requests、BeautifulSoup、招聘平台适配器
• 可靠性：幂等写入、分批执行、心跳、断点恢复、失败归因和冻结评测集

核心岗位、投递、邮件和日程使用结构化数据库查询；模型主要负责简历解析、岗位评分、邮件理解和工具调用。

项目结构

apps/                 FastAPI API 与 Web 工作台
apps/desktop/         Electron 桌面壳、内置浏览器和简历闪填
packages/             领域模型、抓取、评分、邮件、工具和流程编排
migrations/           PostgreSQL 数据库迁移
config/               公司来源与候选人配置示例
.agents/skills/       求职助理领域技能
scripts/              启动、迁移、诊断、备份和发布脚本
evals/                冻结评测集与可靠性评估
tests/                单元、集成与契约测试
docs/                 架构、安装、运行和故障排查文档

安全说明

• API Key、邮箱授权码和招聘网站登录状态只保存在本机运行目录中。
• .env、.data/、数据库、日志、备份和候选人配置默认不进入 Git。
• 不要将自己的 .data 目录、简历、浏览器存储或邮箱配置上传到公开仓库。
• 登录、验证码、滑块和最终投递提交由用户本人完成。
• 邮件与官网证据不足时保留原状态，不用猜测覆盖已确认进度。

发现安全问题请阅读 SECURITY.md。

支持作者

如果这个项目对你有帮助，欢迎请作者喝杯咖啡。感谢你的支持，它会帮助项目继续维护和完善。

更多文档

• 安装与部署
• 启动指南
• 系统架构
• 抓取流程
• MCP 工具
• 故障排查
• 贡献指南

License

MIT