国央企招聘-聘家

概述

国央企招聘求职主技能 (pinjia-recruitment)

为用户提供国央企招聘信息表（收录 100 万+ 岗位）的查询服务：登录与购买均引导用户跳转官网 https://wssq.58pinjia.com/#/tabbuy?source=workbuddy 完成，用户拿到 token 回复后即可继续；已购买后查询并展示完整招聘表格，未购买时展示试看数据。所有接口请求地址为 https://api.58pinjia.com。

1. 运行环境（每次执行脚本前必读）

scripts/ 下所有脚本用本机系统 Python 执行，仅依赖标准库 + pycryptodome。严禁写死解释器绝对路径（如 C:/Users/xxx/.../python.exe）——那只存在于开发机上，换环境必然失败。

第 1 步：探测可用解释器，按顺序取第一个成功且版本 ≥ 3.7 的命令，记为 <PY>：

python3 -V || python -V || py -3 -V      # py -3 为 Windows 兜底

第 2 步：设置编码（Windows 控制台默认 GBK，不设会报编码错）：

• Windows：set PYTHONIOENCODING=utf-8
• macOS / Linux：export PYTHONIOENCODING=utf-8

第 3 步：确认解密依赖（仅表格查询 / 试看接口的密文解密路径需要）：

<PY> -c "import Crypto" || <PY> -m pip install pycryptodome

后续统一用 <PY> scripts/xxx.py ... 调用，例如 <PY> scripts/query_jobs.py --areas 北京 --batch 校招。

• 登录 token 自动持久化于 ~/.workbuddy/pinjia-recruitment/token（可用环境变量 PINJIA_RECRUITMENT_DATA_DIR 覆盖），跨会话自动复用；脚本报 TOKEN_INVALID 时需重新引导用户到官网登录并回传 token。
• 若 pip 安装失败（无网络 / 权限不足），回到第 1 步换下一个候选解释器重试——同一台机器上 python3 与 python 常指向不同环境，已装的依赖并不通用；全部失败再提示用户手动执行 <PY> -m pip install pycryptodome。任何情况下都不要自行写死某个解释器路径。

2. 触发词与场景路由

用户输入
    │
    ├─ 提到 国央企/国企央企/央企招聘、招聘信息表、上岸、事业单位岗位、春招/秋招/校招/社招信息
    │   → 进入【主流程】(第 3 节): 登录/购买 → 查询 → 展示表格
    │
    ├─ 已购买过、直接要查岗位/筛选岗位 ("帮我查北京的央企校招岗位")
    │   → 跳过登录与购买, 直接执行 query_jobs.py (第 3.3 节)
    │
    └─ 未登录且只想随便看看 ("有哪些岗位"、"试看")
        → 可先执行 get_trial.py 展示试看数据, 再引导购买

3. 主流程（严格按序执行）

3.0 登录态判定

优先直接执行 get_table_detail.py：

• 输出 未登录（status=error，message 含"未登录"）→ 执行 3.1；
• 输出 purchased: true → 跳到 3.3 直接查表；
• 输出 purchased: false → 执行 3.2（展示试看 + 引导官网购买）。

3.1 未登录：跳转官网登录并回传 token（不再使用二维码）

未登录时不请求二维码接口（login_qr.py 已删除）。

1. 直接输出官网登录/购买链接（可点击跳转）：https://wssq.58pinjia.com/#/tabbuy?source=workbuddy，并提示用户：

"请点击上方链接，在打开的页面完成登录；拿到 token 后回复给我，我会继续为你查询。"

1. 用户回复 token 后：执行 save_token.py --token "<token>" 持久化 token（注意用双引号包裹 token）。
2. 保存成功后回到 3.0 重新判定登录/购买状态，继续后续流程。

3.2 已登录未购买：展示试看 + 引导官网购买（不再自动下单）

1. 执行 get_trial.py 展示试看数据（预览行）。
2. 取消技能内下单流程：不再执行下单与支付轮询（create_order.py / query_pay_status.py 已删除）。
3. 引导用户到官网购买：输出 https://wssq.58pinjia.com/#/tabbuy，提示：

"以上为试看数据。购买【招聘信息表】后即可查看全部岗位——请点击链接前往官网下单购买，完成后回复我（如已重新获取 token 一并发我），我继续为你查询。"

3.3 查询完整招聘表格并展示（参照 table/constant.ts）

1. 执行 query_jobs.py 及其筛选参数（见第 4 节），默认第 1 页、每页 10 条。
2. 以表格形式展示返回的 rows，列顺序与字段（表格显示字段参照前端 constant.ts）：

1. 展示总数 total 与当前页码，并主动询问是否需要：翻页、调整筛选条件（地区/企业类型/批次/学历/专业等）、导出文件。
2. 批次联动规则（与前端一致）：选"校招"时招聘届别有效；选"社招"时工作经验有效；纯校招/实习场景不要传工作经验参数。

4. query_jobs.py 筛选参数速查

5. 脚本一览 (scripts)

所有脚本输出 JSON 到 stdout，需解析 JSON 提取业务字段。

6. 全局铁律

1. 实时数据：每次查询必须重新执行脚本，严禁凭记忆编造岗位数据、价格或订单状态。
2. 流程顺序：未登录 → 跳官网登录回传 token → 未购买 → 展示试看 + 引导官网购买 → 已购买 → 查表。未购买时严禁调用 query_jobs.py 查询完整表格，可改用 get_trial.py 展示试看。
3. 登录/购买一律走官网：不请求二维码接口、不在技能内下单与支付，统一引导用户到 https://wssq.58pinjia.com/#/tabbuy?source=workbuddy 完成，用户回传 token 后继续。
4. 调用隐身：不向用户展示脚本文件名、CLI 命令、请求参数、原始 JSON 返回或报错堆栈；对外只输出业务结果与下一步引导。
5. 默认中文回复，简洁不写长解释；用户要求导出时可将查询结果整理为表格文件（xlsx/markdown）交付。

7. 深入参考

接口签名算法、加密细节、错误码、完整字段映射见 references/api_flow.md（仅在脚本异常需要排查或用户询问技术细节时加载）。