@reconcrap/boss-recommend-mcp 1.3.38 → 2.0.0

package/README.md

@@ -1,42 +1,57 @@
 # @reconcrap/boss-recommend-mcp
 
-Boss 推荐页自动化流水线 MCP（stdio）服务。
+Boss 推荐 / 搜索 / 聊天筛选 MCP（stdio）服务。
 
 发布入口：
 
 - npm: `@reconcrap/boss-recommend-mcp`（https://www.npmjs.com/package/@reconcrap/boss-recommend-mcp）
 - GitHub: `reconcrap-cpu/boss-recommend-mcp`（https://github.com/reconcrap-cpu/boss-recommend-mcp）
 
-它把 recommend 页面上的两段能力串起来：
+2.0.0 是 CDP-only 重写版本：活跃浏览器路径只允许 Chrome DevTools Protocol 的 `DOM` / `Input` / `Page` / `Network` / `Accessibility` 等域，不使用 `Runtime.evaluate` 或页面 JS。包内保留 recommend、search/recruit、chat 三条域服务，并共享浏览器、生命周期、筛选、CV 获取、无限滚动、自愈与 CSV 报告层。
 
-- `boss-recommend-search-cli`: 只负责推荐页筛选项
-- `boss-recommend-screen-cli`: 只负责滚动列表、打开详情、提取完整简历图、多模态判断，并对通过人选统一执行 `favorite` 或 `greet`
+安装 `boss-recommend-mcp` 后可以直接：
 
-现在包内还内置了 `boss-chat` runtime，因此安装 `boss-recommend-mcp` 后可以直接：
-
-- 单独运行 chat-only 任务，不需要再单独安装 `boss-chat`
-- 在 recommend screen 完成后，通过同一个父 run 自动进入 `chat_followup`
-- 继续把聊天页状态保存在用户目录下的 `~/.boss-recommend-mcp/boss-chat/`（可通过 `BOSS_CHAT_HOME` 覆盖）
+- 读取推荐页岗位列表，供 cron / 一次性任务提前填写完整 `job` 参数。
+- 运行推荐页筛选、搜索页筛选、聊天页筛选。
+- 使用 Network 优先、完整滚动截图兜底的 CV 获取策略。
+- 通过共享 run lifecycle 查询、暂停、恢复、取消任务。
+- 把运行态保存在用户目录下的 `~/.boss-recommend-mcp/`（chat 默认在 `~/.boss-recommend-mcp/boss-chat/`，可通过 `BOSS_CHAT_HOME` 覆盖）。
 
 MCP 工具：
 
+- `list_recommend_jobs`（只读读取推荐页岗位下拉框，返回可直接用于 cron/一次性任务的 `job_names`）
 - `start_recommend_pipeline_run`（异步启动；同样先经过前置门禁，通过后返回 run_id）
 - `get_recommend_pipeline_run`（轮询 run_id 状态）
 - `cancel_recommend_pipeline_run`（取消运行中任务）
 - `pause_recommend_pipeline_run`（请求暂停 run；会在当前候选人处理完成后进入 paused）
 - `resume_recommend_pipeline_run`（继续 paused run；沿用同 run_id 与同 CSV）
 - `run_recommend_self_heal`（手动运维工具；扫描 Boss recommend 的 selector / network 规则漂移，并在确认后应用高置信度修复）
+- `run_recruit_pipeline`
+- `start_recruit_pipeline_run`
+- `get_recruit_pipeline_run`
+- `pause_recruit_pipeline_run`
+- `resume_recruit_pipeline_run`
+- `cancel_recruit_pipeline_run`
 - `boss_chat_health_check`
+- `prepare_boss_chat_run`
 - `start_boss_chat_run`
 - `get_boss_chat_run`
 - `pause_boss_chat_run`
 - `resume_boss_chat_run`
 - `cancel_boss_chat_run`
-  - `validation_profile=safe`：只做非破坏性扫描与被动 network 观察
-  - `validation_profile=full`：会主动打开候选人详情，并执行收藏往返校验与一次打招呼校验；若完整交互没跑通，会明确返回验证异常而不是静默跳过
-  - 扫描会主动覆盖 recommend/latest/featured 三个 tab 的详情链路（详情打开、详情内关键 selector、popup 关闭）
-  - 搜索链路 selector 会在状态触发后验证：职位下拉、职位搜索输入、职位 label、筛选面板、筛选分组（school/degree/gender/recentNotView）、筛选滚动容器与筛选项激活态
-  - 对关闭弹层相关 selector，会同时验证 close 按钮与 fallback close 候选 selector
+
+推荐页 page scope：
+
+- 支持 `recommend` / `featured` / `latest`，对应 Boss UI 的 `推荐` / `精选` / `最新`。
+- 切换岗位后再选择 page scope；如果所选岗位没有用户要求的 scope，会自动回退到 `推荐` 并继续运行。
+
+推荐页岗位列表：
+
+```bash
+boss-recommend-mcp list-jobs --slow-live --port 9222
+```
+
+返回的 `job_names` 可直接作为后续 `start_recommend_pipeline_run` 的 `confirmation.job_value` / `overrides.job`。
 
 状态机：
 
@@ -54,12 +69,15 @@ MCP 工具：
 - `failed`
 - `canceled`
 
-当 recommend run 传入 `follow_up.chat` 且 screen 成功后，父 run 会进入 `chat_followup` 阶段并保持 `running`，直到内置 boss-chat 子任务结束。此时对父 run 的 `pause/resume/cancel` 会代理到子 chat run。
+旧版 recommend -> chat 自动衔接属于 legacy-only 行为，2.0.0 的 CDP-only MCP 路径会 fail closed。需要聊天页筛选时，请在 recommend 完成后显式调用 `prepare_boss_chat_run` / `start_boss_chat_run`。
 
 ## 设计特点
 
 - 页面目标固定为 `https://www.zhipin.com/web/chat/recommend`
+- 活跃浏览器自动化为 CDP-only；硬静态门禁会阻止活跃路径重新引入 `Runtime.evaluate` / 页面 JS。
 - 支持推荐页原生筛选：学校标签 / 学历 / 性别 / 近14天没有
+- 支持推荐页岗位列表只读读取：`list_recommend_jobs` / `boss-recommend-mcp list-jobs`
+- 支持推荐页 page scope：`推荐` / `精选` / `最新`
 - 学校标签支持多选语义：如“985、211”会同时勾选这两项
 - 学校标签对“混合输入”按容错处理：如“985、211、qs100”会忽略无效项 `qs100`，保留并应用有效项；仅当全部无效或用户明确“不限”时才回落到“不限”
 - 学历支持单选与多选语义：如“本科及以上”会展开为 `本科/硕士/博士`；如“大专、本科”只勾选这两项
@@ -77,11 +95,12 @@ MCP 工具：
 - 若达到 `max_greet_count` 但流程仍需继续，后续通过人选会自动改为收藏
 - 不会对每位候选人重复确认
 - 推荐页详情处理完成后，会强制关闭详情页并确认已关闭
-- 简历提取采用“分段滚动截图 + 拼成长图”的方式，再交给多模态模型判断
+- 简历提取优先使用 Network 响应；没有可解析 Network CV 时，回退到完整滚动截图序列再交给多模态模型判断
 - 提供显式运维自愈工具：只在手动调用 `run_recommend_self_heal` 时运行，不会接入正常 run / doctor / preflight 自动链路
 - 运行前会自动做依赖体检（Node.js、Python、Pillow、`chrome-remote-interface`、`ws`），缺失时会在 `doctor` 与流水线失败诊断中明确提示
 - 若 preflight 失败，返回 `diagnostics.recovery`（含有序修复步骤与 `agent_prompt`），可直接交给 AI agent 自动按顺序安装依赖
 - 不依赖 PowerShell；Windows / macOS 均可运行（命令提示会按平台给出）
+- package-local legacy/vendor 代码被隔离在 `legacy/research/`，不会进入 npm clean install 包。
 
 ## 安装
 
@@ -117,12 +136,12 @@ BOSS_RECOMMEND_MCP_CONFIG_TARGETS   # JSON 数组或系统 path 分隔路径列
 BOSS_RECOMMEND_EXTERNAL_SKILL_DIRS  # JSON 数组或系统 path 分隔路径列表，指定额外 skills 根目录
 ```
 
-或使用 CLI fallback：
+推荐运行入口是 MCP 工具。旧版 one-shot recommend CLI `run` 在 CDP-only 重写期间已 fenced；请使用 `start_recommend_pipeline_run` 或 live harness。岗位发现可以使用新的只读 CLI：
 
 ```bash
-npx -y @reconcrap/boss-recommend-mcp@latest run --instruction "推荐页筛选985男生，近14天没有，有大模型平台经验，符合标准的收藏"
+npx -y @reconcrap/boss-recommend-mcp@latest list-jobs --slow-live --port 9222
 # 源码模式（GitHub clone 后）
-node src/cli.js run --instruction "推荐页筛选985男生，近14天没有，有大模型平台经验，符合标准的收藏"
+node src/cli.js list-jobs --slow-live --port 9222
 ```
 
 ## 配置
@@ -185,15 +204,16 @@ node src/cli.js config set --base-url https://api.openai.com/v1 --api-key <your-
 node src/cli.js set-port --port 9222
 node src/cli.js doctor --agent trae-cn
 node src/cli.js launch-chrome --port 9222
-node src/cli.js run --instruction-file request.txt --confirmation-file confirmation.json --overrides-file overrides.json
-node src/cli.js run --instruction-file request.txt --confirmation-file confirmation.json --overrides-file overrides.json --follow-up-file follow-up.json
+node src/cli.js list-jobs --slow-live --port 9222
 node src/cli.js chat health-check
-node src/cli.js chat run --job "算法工程师" --start-from unread --criteria "有 AI Agent 经验" --targetCount 20 --greeting-text "您好，方便发下简历吗？"
+node src/cli.js chat prepare-run --slow-live --port 9222
 ```
 
-## Recommend + Chat Follow-up
+## Recommend + Chat Follow-up（Legacy-only）
+
+旧版曾支持 recommend screen 完成后自动开始 boss-chat，把 chat 配置放到同一个 recommend run 的顶层 `follow_up.chat`。2.0.0 的 CDP-only MCP 路径已将该链式 orchestration fenced，避免回到 legacy page-JS 路径。推荐做法是：recommend run 完成后，显式启动 chat 工具。
 
-若要让 recommend screen 完成后自动开始 boss-chat，把 chat 配置放到同一个 recommend run 的顶层 `follow_up.chat`：
+历史 payload 形状如下，仅作迁移参考：
 
 ```json
 {
@@ -222,8 +242,8 @@ node src/cli.js chat run --job "算法工程师" --start-from unread --criteria
 - `baseUrl` / `apiKey` / `model` 不再单独传入，固定复用 recommend 的 `screening-config.json`
 - `greeting_text` 默认优先级：本次显式值 > profile 历史值 > 内置默认招呼语（`Hi同学，能麻烦发下简历吗？`）
 - 若缺少 `follow_up.chat` 必填项，pipeline 会返回 `NEED_INPUT`
-- recommend 成功后，父 run 继续存活并进入 `chat_followup`；chat 结束后父 run 才会进入最终终态
-- `boss-chat` 子任务状态统一写入 `~/.boss-recommend-mcp/boss-chat`（或 `BOSS_CHAT_HOME` 指定目录），不再依赖工作区 `cwd`
+- 如需聊天页筛选，请调用 `prepare_boss_chat_run` 获取岗位列表，再调用 `start_boss_chat_run`。
+- `boss-chat` 状态统一写入 `~/.boss-recommend-mcp/boss-chat`（或 `BOSS_CHAT_HOME` 指定目录），不再依赖工作区 `cwd`
 
 ## Chat-only
 
@@ -232,16 +252,16 @@ node src/cli.js chat run --job "算法工程师" --start-from unread --criteria
 - CLI：
   - `boss-recommend-mcp chat health-check`
   - `boss-recommend-mcp chat prepare-run`
-  - `boss-recommend-mcp chat run --job "算法工程师" --start-from unread --targetCount 20 --criteria "有 AI Agent 经验" [--greeting-text "您好，方便发下简历吗？"]`（后台启动，不自动轮询）
-  - `boss-recommend-mcp chat start-run|get-run|pause-run|resume-run|cancel-run`
+  - `boss-recommend-mcp chat start-run` / `run` 在 2.0.0 CLI 中 fenced；活跃异步 chat run 请使用 MCP `start_boss_chat_run` 或 live harness。
+  - `boss-recommend-mcp chat get-run|pause-run|resume-run|cancel-run`
 - MCP：
   - `boss_chat_health_check`
   - `prepare_boss_chat_run`
-- `start_boss_chat_run`
-- `get_boss_chat_run`
-- `pause_boss_chat_run`
-- `resume_boss_chat_run`
-- `cancel_boss_chat_run`
+  - `start_boss_chat_run`
+  - `get_boss_chat_run`
+  - `pause_boss_chat_run`
+  - `resume_boss_chat_run`
+  - `cancel_boss_chat_run`
 - vendored `boss-chat` CLI 还支持 `--data-dir <path>` 与 `BOSS_CHAT_HOME`，默认目录为 `~/.boss-recommend-mcp/boss-chat`（若设置 `BOSS_RECOMMEND_HOME`，则默认 `<BOSS_RECOMMEND_HOME>/boss-chat`）
 - 对 `/.boss-chat`、系统目录等危险运行目录会主动拒绝启动并返回 `UNSAFE_DATA_DIR`，避免在 harness 丢参时误写根目录
 - `boss_chat_health_check` 与 chat run 返回结果会包含 `data_dir` 与 `data_dir_source`，便于定位是参数/环境变量/默认路径生效

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "1.3.38",
+  "version": "2.0.0",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",
@@ -21,22 +21,74 @@
     "install:local": "node src/cli.js install",
     "postinstall": "node scripts/postinstall.cjs",
     "test:parser": "node src/test-parser.js",
-    "test:pipeline": "node src/test-pipeline.js",
     "test:run-state": "node src/test-run-state.js",
-    "test:runtime": "node src/test-adapters-runtime.js",
+    "test:cdp-browser": "node src/test-cdp-browser.js",
+    "test:core-capture": "node src/test-core-capture.js",
+    "test:core-cv-acquisition": "node src/test-core-cv-acquisition.js",
+    "test:core-greet-quota": "node src/test-core-greet-quota.js",
+    "test:core-infinite-list": "node src/test-core-infinite-list.js",
+    "test:core-reporting": "node src/test-core-reporting.js",
+    "test:core-run": "node src/test-core-run.js",
+    "test:core-screening": "node src/test-core-screening.js",
+    "test:core-self-heal": "node src/test-core-self-heal.js",
+    "test:recommend-actions": "node src/test-recommend-actions.js",
+    "test:recommend-domain": "node src/test-recommend-domain.js",
+    "test:recommend-run-service": "node src/test-recommend-run-service.js",
+    "test:recommend-mcp": "node src/test-recommend-mcp.js",
+    "test:recruit-domain": "node src/test-recruit-domain.js",
+    "test:recruit-mcp": "node src/test-recruit-mcp.js",
+    "test:chat-domain": "node src/test-chat-domain.js",
+    "test:chat-run-service": "node src/test-chat-run-service.js",
+    "test:chat-mcp": "node src/test-chat-mcp.js",
     "test:async": "node src/test-index-async.js",
-    "test:boss-chat": "node src/test-boss-chat.js",
-    "test:self-heal": "node src/test-self-heal.js",
-    "test:search-job": "node vendor/boss-recommend-search-cli/src/test-job-selection.js",
-    "test:screen-runtime": "node vendor/boss-recommend-screen-cli/test-recoverable-resume-failures.cjs"
+    "test:runtime-scan": "node src/test-runtime-scan.js",
+    "scan:runtime": "node scripts/scan-forbidden-runtime.js",
+    "scan:runtime:json": "node scripts/scan-forbidden-runtime.js --json",
+    "scan:runtime:strict": "node scripts/scan-forbidden-runtime.js --fail-on-findings",
+    "scan:runtime:package": "node scripts/scan-forbidden-runtime.js --package-surface",
+    "scan:runtime:package:strict": "node scripts/scan-forbidden-runtime.js --package-surface --fail-on-legacy",
+    "scan:legacy-boundary": "node scripts/scan-legacy-boundary.js",
+    "scan:package-boundary": "node scripts/scan-package-boundary.js",
+    "gate:phase9-static": "node scripts/phase9-static-gate.js",
+    "gate:phase10-complete": "node scripts/phase10-completion-gate.js",
+    "live:cdp-smoke": "node scripts/live-cdp-smoke.js",
+    "live:run-lifecycle": "node scripts/live-run-lifecycle-smoke.js",
+    "live:screening": "node scripts/live-screening-smoke.js",
+    "live:detail": "node scripts/live-detail-smoke.js",
+    "live:infinite-list": "node scripts/live-infinite-list-smoke.js",
+    "live:scroll-end": "node scripts/live-scroll-end-screenshot.js",
+    "live:refresh-round": "node scripts/live-refresh-round-smoke.js",
+    "live:self-heal": "node scripts/live-self-heal-smoke.js",
+    "live:recommend-actions": "node scripts/live-recommend-actions-smoke.js",
+    "live:recommend-phase10-full": "node scripts/live-recommend-phase10-full.js",
+    "live:recommend-domain": "node scripts/live-recommend-domain-smoke.js",
+    "live:recommend-run-service": "node scripts/live-recommend-run-service-smoke.js",
+    "live:recommend-mcp": "node scripts/live-recommend-mcp-smoke.js",
+    "live:search-phase10-full": "node scripts/live-search-phase10-full.js",
+    "live:recruit-domain": "node scripts/live-recruit-domain-smoke.js",
+    "live:recruit-run-service": "node scripts/live-recruit-run-service-smoke.js",
+    "live:recruit-mcp": "node scripts/live-recruit-mcp-smoke.js",
+    "live:chat-domain": "node scripts/live-chat-domain-smoke.js",
+    "live:chat-run-service": "node scripts/live-chat-run-service-smoke.js",
+    "live:chat-mcp": "node scripts/live-chat-mcp-smoke.js",
+    "live:chat-phase10-full": "node scripts/live-chat-phase10-full.js",
+    "live:chat-image-screening": "node scripts/live-chat-image-screening-smoke.js"
   },
   "files": [
     "bin",
     "config/screening-config.example.json",
     "skills",
     "scripts/postinstall.cjs",
-    "src",
-    "vendor",
+    "src/core",
+    "src/domains",
+    "src/chat-mcp.js",
+    "src/chat-runtime-config.js",
+    "src/cli.js",
+    "src/index.js",
+    "src/parser.js",
+    "src/recommend-mcp.js",
+    "src/recruit-mcp.js",
+    "src/run-state.js",
     "README.md"
   ],
   "dependencies": {

package/skills/boss-recommend-pipeline/SKILL.md

@@ -95,6 +95,10 @@ description: "Use when users want Boss recommend-page filtering/screening via bo
 
 ## Tool Usage
 
+- 岗位发现工具：`list_recommend_jobs`
+  - 用途：当用户需要为 cron / 一次性自动任务提前填写完整参数时，先用它读取推荐页岗位下拉框的全部可用岗位名。
+  - 输出：优先把 `job_names` 里的值作为后续 `overrides.job` / `confirmation.job_value`。
+  - 限制：只读岗位列表，不启动筛选任务；仍然必须在正式 `start_recommend_pipeline_run` 前完成岗位与最终确认。
 - 主工具：`start_recommend_pipeline_run`
 - 必填：`instruction`
 - 关键输入：