Metadata-Version: 2.4
Name: jobhunter-bot
Version: 1.3.0
Summary: 简历制作 + 意向岗位筛选一体化的求职聊天机器人（JobHunter AI · 工作雷达），基于 AstrBot；附内置前端网页，本地 pip 安装后即可使用。
Author: shikunpneg
License: MIT
Project-URL: Homepage, https://jobhunter-rosy.vercel.app
Project-URL: Repository, https://github.com/shikunpneg/jobhunter-ai
Keywords: astrbot,job,resume,求职,简历,岗位筛选,chatbot
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27.0
Dynamic: license-file

# JobHunter AI · 求职雷达

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

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

---

## ✨ 核心能力

### 📝 简历制作
内置 **4 套简历模板**，对话式引导，自动渲染：

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

### 🔍 意向岗位筛选
多步骤采集求职偏好，输出合格报告：

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

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

### 📱 多平台接入
通过 AstrBot 适配 **QQ / 微信 / Telegram / 飞书 / 钉钉** 等数十个平台。

---

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

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

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

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

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

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

```bash
jobhunter
```

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

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

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

### 🖥 启动内置前端网页

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

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

### 🤖 作为 AstrBot 插件使用

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

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

```bash
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

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

（或使用 Docker / 雨云一键部署，详见 [AstrBot 文档](https://docs.astrbot.app)）

### 2. 安装插件

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

```bash
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](LICENSE)

---

© 2026 shikunpneg · 开源项目 · [GitHub](https://github.com/shikunpneg/jobhunter-ai)
