JobHunter AI · 求职雷达

简历制作 + 意向岗位筛选一体化的求职聊天机器人（开源框架）

JobHunter AI 是一个基于 AstrBot 的开源求职助手框架。 部署到 QQ / 微信 / Telegram 等即时通讯平台后，用户可以直接在聊天框里： 制作规范简历、发起多维度岗位筛选，并拿到一份含契合度评分与提升方向的合格报告。

---

✨ 核心能力

📝 简历制作

内置 4 套简历模板，对话式引导，自动渲染：

模板	适用
应届生标准模板	本科/硕士应届生
实习生模板	在校生找实习
社招标准模板	有工作经验
学术科研模板	科研岗/读博申请

🔍 意向岗位筛选

多步骤采集求职偏好，输出合格报告：

1. 收集条件：薪资 · 城市 · 公司规模 · 岗位类型 · 行业
2. 生成报告：
   • 🛠 岗位要求技能
   • 🚀 行业发展前景
   • 🧩 简历契合度评分
   • 📈 技能提升方向

🤖 AI 领域示范

内置 12 个 AI 领域代表性岗位（大模型/NLP/CV/AIGC/强化学习/数据科学…）， 开箱即可演示完整筛选与报告流程。

📱 多平台接入

通过 AstrBot 适配 QQ / 微信 / Telegram / 飞书 / 钉钉 等数十个平台。

---

📦 pip 安装（本地直接使用）

项目已发布到 PyPI，一行命令即可安装（含插件本体 + 内置前端网页）：

# 方式一：从 PyPI 安装（推荐）
pip install jobhunter-bot

# 方式二：直接从 GitHub 安装
pip install git+https://github.com/shikunpneg/jobhunter-ai.git

🖥 终端直接聊天（不需要 QQ）

安装后直接在终端里运行 jobhunter，即可和「工作雷达」猫娘聊天（本地运行，无需部署 AstrBot / QQ）：

jobhunter

进入对话后直接输入命令：

命令	功能
/jobhunter	查看功能菜单
/简历	制作简历（4 套模板）
/岗位 <关键词>	筛选岗位（如：/岗位 大模型）
/岗位 <关键词> --offline	离线模式（本地数据集，不联网）
/报告	查看最近生成的报告
/数据源 [refresh]	查看 / 强制刷新官网岗位缓存
quit / exit	退出

简历与报告保存在 ~/.jobhunter/ 目录，随时可查。

🖥 启动内置前端网页

jobhunter-serve          # 启动后自动打开 http://127.0.0.1:8080
jobhunter-serve --port 3000 --no-browser   # 自定义端口 / 不自动开浏览器

安装后自带网页版说明（项目介绍 / 能力展示 / 使用引导），本地也能随时查看。

🤖 作为 AstrBot 插件使用

# 查看包安装位置（插件名必须为 astrbot_plugin_jobhunter）
pip show -f jobhunter-bot

或更简单：克隆仓库到 AstrBot 插件目录并安装依赖：

cd <AstrBot>/data/plugins
git clone https://github.com/shikunpneg/jobhunter-ai.git astrbot_plugin_jobhunter
cd astrbot_plugin_jobhunter/plugin/astrbot_plugin_jobhunter
pip install -r requirements.txt

重启 AstrBot 后在 WebUI → 插件管理中启用 JobHunter AI 即可。

---

🚀 快速开始

1. 部署 AstrBot

uv tool install astrbot --python 3.12
astrbot init && astrbot run

（或使用 Docker / 雨云一键部署，详见 AstrBot 文档）

2. 安装插件

打开 AstrBot WebUI → 插件市场搜索 JobHunter AI 一键安装； 或手动克隆：

cd AstrBot/data/plugins
git clone https://github.com/shikunpneg/jobhunter-ai.git astrbot_plugin_jobhunter

3. 接入 QQ

在 AstrBot WebUI → 消息平台适配器 中配置 QQ（NapCat/OneBot） 或 QQ 官方接口， 扫码登录后即可在 QQ 中与机器人对话。

4. 开始使用

/简历          制作简历
/岗位 大模型   岗位筛选
/报告          查看最近报告

---

📁 项目结构

jobhunter-ai/
├── pyproject.toml                      # pip 打包配置（安装后可用 jobhunter-serve）
├── index.html                          # Landing 页（已部署 Vercel）
├── vercel.json                         # Vercel 静态部署配置
├── LICENSE
└── plugin/
    └── astrbot_plugin_jobhunter/       # AstrBot 插件本体（pip 包源）
        ├── __init__.py                 # 包标识（含版本号）
        ├── main.py                     # 插件主逻辑（状态机 + 指令 + 报告生成）
        ├── sources.py                  # 真实招聘数据源（腾讯招聘 / Greenhouse ATS / Lever / 通用）
        ├── companies.json              # 数据源配置（公司 slug / 关键词 / 抓取规则）
        ├── data.py                     # 离线示例岗位集 + 简历模板 + 筛选提问
        ├── serve.py                    # 本地前端网页启动器（jobhunter-serve 命令）
        ├── web/
        │   └── index.html              # 内置前端网页副本（pip 包内）
        ├── metadata.yaml               # 插件元数据（插件市场展示）
        ├── requirements.txt
        └── README.md                   # 插件使用文档

🧩 扩展指南

• 接真实数据源（在线模式默认）：编辑 plugin/astrbot_plugin_jobhunter/companies.json
  • greenhouse：加公司 slug（如 anthropic），对接 Greenhouse 公开 ATS API
  • tencent：加搜索关键词（如 AI / 大模型），对接腾讯招聘官网 API
  • 新增公司可自行实现 BaseSource 子类并注册到 SOURCE_REGISTRY
• 换离线示例数据集（--offline 模式）：编辑 data.py 的 AI_JOBS
• 加简历模板：在 RESUME_TEMPLATES 增加条目即可
• 调筛选步骤：改 JOB_FILTER_QUESTIONS 数组

📄 License

MIT

---

© 2026 shikunpneg · 开源项目 · GitHub