prui0474 / hk-job-radar

# HK Job Radar · 香港岗位雷达
> **一个本地运行、AI 辅助的香港求职自动化工具。**
> 自动监控三大招聘网站的新岗位 → 关键词初筛 → 大模型打分 → 每日推送（企业微信 / WxPusher / 邮件 / Telegram）→ 半自动填表。
> 数据不出本机，合规克制，配置驱动。
>
> **Your personal, AI-assisted job search automation for Hong Kong.**
> Watch new jobs across three boards → filter → score → daily push (WeCom / WxPusher / Email / Telegram) → semi-auto apply.
> Local-first, privacy-first, compliance-first.
> 🍎 **On a Mac?** One-click install via `.command` scripts —
> see **Mac 安装教程 →** (Chinese, click-by-click).
>
> 🧰 **Never used a terminal? / 完全新手？**
> Follow the step-by-step beginner's guide (Chinese, from installing Python to
> receiving your first digest): **保姆级新手教程 →**
> No coding experience needed — the one-click installer does the work for you.
>
> 🌐 **English version:** jump to English ↓
---
## 中文
### 这是什么
香港岗位雷达是一个**本地运行的求职助手**：定时监控 **JobsDB / LinkedIn / Indeed**
三大网站的新岗位，按你的关键词初筛，用**大模型（DeepSeek）对照你的个人画像打分**，
每天推送到**你自选的一个通道**——企业微信群机器人 / WxPusher / 邮件（HTML 岗位卡片）/
Telegram（带 ✅/❌ 反馈按钮）；还附带一个**半自动投递副驾**，
帮你填申请表——但**最后的「提交」永远由你亲手点击**。
它**不是**求职网站、**不是**猎头、**不是**代写简历，它只自动处理求职里最重复的
那部分：*找岗位 + 筛选岗位*。
### 适合谁
- **任何在香港求职的人**——学生、应届生、转行者都能用；用 `career_stage` 选身份，
 岗位类型过滤会自动跟着变；
- **尤其适合持学生签证的港硕/非本地学生**（默认 `career_stage: student`，内置签证合规过滤，见下）；
- 岗位方向**完全由你自己定**——双击 `setup.bat`（Mac 上是 `setup.command`），在打开的网页里填；
 向导会先预填几个常见方向当示例，改成你自己的就行，覆盖任意岗位。
### 解决什么痛点
| 痛点 | 本工具怎么解决 |
| --- | --- |
| 打开 JobsDB 翻一遍、再 LinkedIn、再 Indeed，两个多小时过去了，真正投出去的也就那么几份 | 一条本地流水线按点盯住三个站，你只在日报里挑 |
| 翻了一整个下午，一百个岗位里真正能投的就那么几个，其余全在耗你的时间和耐心 | 关键词初筛 + LLM 相关度打分（0–100），能投的排在最前面 |
| 重复填申请表浪费时间 | 半自动填表 + 筛选问题答案生成 |
| （非本地学生）搞不清哪些岗位学生签能合法做 | 内置签证合规过滤 |
### 工作原理
 [code] 
1. **抓取** — 每个开启的站都按随机的人为延迟抓，并限制单站每日页数（防封号优先）。
2. **初筛** — 先用关键词和同义词做便宜的匹配，把噪音丢掉，这样只有值得看的岗位才会
 送进大模型，省的是你自己的 API 钱。
3. **打分** — DeepSeek 对着你的个人画像给每个岗位打 0–100 分；调用失败会降级处理，
 不会把整条流水线卡死。
4. **去重入库** — SQLite 用「岗位 ID + 归一化 URL」双键去重，保证同一个岗位不会被
 推第二遍。
5. **推送** — 按分数排序的日报（电脑开着就 09:00 发，当天第一次开机也会补发）；
 新出现的 ≥80 分岗位是高级版的实时秒推。
6. **投递（可选）** — 帮你填表、传简历、起草筛选问题的答案，然后请你逐项核对、
 **自己点「提交」**。
### 核心优点
- 🔎 三站监控，各自可开关
- 🧠 LLM 打分（DeepSeek，OpenAI 兼容，可换其他服务）
- 📬 **四个推送通道，挑一个顺手的就行**——企业微信 / WxPusher / 邮件（HTML 卡片）/
 Telegram。其中 Telegram 多一层反馈：日报里每个岗位都带 ✅ / ❌ 按钮，点一下就把
 「感兴趣 / 不感兴趣」记进本机数据库，岗位状态跟着变成「感兴趣」或「已排除」——
 一条条攒下来，就是你自己看得懂的求职偏好档案
- ✍️ 半自动投递，绝不自动提交
- 🛡️ 防封号：随机延迟、每日页数上限、指数退避，不破解验证码
- 🧩 配置驱动，可复用到任何求职目标
- 🎓 按求职阶段自动过滤岗位类型（`career_stage`：学生 / 已毕业 / 两者）
- 🔓 **免费版就能跑通全流程**——三个站、关键词初筛、AI 打分、日报推送、半自动投递，
 全都在免费版里；不需要服务器，数据不出本机。
- ⚡ **高级版：同一套雷达，但这七件事是免费版做不到的**——
 - **一条关键词表，变成三条并行的求职线**——数据、量化、银行管培各挂一套关键词和分数门槛，
 早上看数据岗、下午看管培，互不覆盖，也不用改一次配置就重跑一遍。
 - **岗位早知道**——≥80 分的新岗位抓到就推，不用等到第二天早上 09:00；日报多久发一次
 也由你定，早晚各一份，或者只在真有新岗位落地时才响。香港的岗位经常上午挂出来、
 下午就约面，这个差别直接体现在你投得早不早。
 - **关键词想铺多少铺多少，四个通道也能同时开**——免费版是 7 个关键词、1 个通道，
 想加第八个就得先删掉一个。
 - **积压的岗位摊在一张页面上挑，而不是在聊天记录里往上翻**——图形工作台按分数排开，
 看过的、标过的、不想看的各自归位。
 - **市场在怎么变、你投到了哪一步，两件事放在一起看**——趋势看板盯着你关注的方向：
 这周放出多少岗位、集中在哪些薪资区间、哪几家在连续招。投递那边不用来回翻记录：
 一张本地看板把岗位摊成卡片，点标题直接跳回原站去投；投完在卡片上点「已投」，约到了点
 「约面」，告一段落点「结束」——公司、岗位、日期、走的哪个站、用的哪版简历自动留档，
 投出