@reconcrap/boss-recommend-mcp 2.1.15 → 2.1.17

package/README.md

@@ -391,6 +391,35 @@ config/screening-config.example.json
   - recommend / search / chat 图片简历 fallback 与主列表滚动都会在启用 `listScrollJitter` 时使用 coverage-safe scroll jitter：每次 wheel delta 在安全范围内变化，并保留截图重叠、重复检测、bottom-marker / stop-boundary 逻辑，实际 delta 和 settle 时间会写入 artifact metadata。
   - chat/recommend/search run 也兼容显式参数 `safe_pacing`、`batch_rest_enabled` 与 `human_behavior.restLevel`：run 参数优先于配置文件。AI harness/skill 启动每次 run 前必须让用户明确选择 `low/medium/high`，再把选择写入 `human_behavior.restLevel`。
 
+### 离线筛选延迟 benchmark
+
+可以用已保存的 recommend run JSON 和截图证据离线评估筛选策略，不打开 Boss、不重新点击候选人，也不改变 `简历来源`。benchmark 会读取每个 saved run 自己的 `result.screen_params.criteria`，缺失时再回退到 run context / instruction，避免用同一套 criteria 误测不同岗位。
+
+```bash
+npm run benchmark:screening -- --dry-run
+npm run benchmark:screening -- --max-candidates 20
+```
+
+默认会自动选择 `~/.boss-recommend-mcp/runs` 下最近 4 个仍有 `detail.image_evidence.llm_file_paths` 的 recommend run，并把输出写到 `.live-artifacts/screening-benchmark/<timestamp>/`。真实 LLM replay 会复用当前 `screening-config.json`；如需指定配置或 run：
+
+```bash
+npm run benchmark:screening -- --config C:/Users/yaolin/.boss-recommend-mcp/screening-config.json --run mcp_recommend_mq92ltt5_3x9liodw
+```
+
+内置策略：
+
+- `oracle_full_image_high`：完整图片筛选，`llmThinkingLevel=high`，作为 pass/fail 质量基准。
+- `baseline_full_image_reasoning`：完整图片筛选，`llmThinkingLevel=low`，用于衡量当前低思考 baseline。
+- `extract_then_reason`：先从图片抽取结构化简历事实，再用文本 reasoning 对每位候选人做最终判断；抽取/判断异常会升级到完整图片筛选。
+- `extract_hard_gate_then_reason`：抽取后先做 cheap hard-fail gate；只有明确违反硬条件/排除项时直接 `passed=false`，否则继续文本 reasoning。
+- `batch_extract_then_reason`：批量抽取多个候选人的结构化事实，再逐个文本 reasoning。
+- `batch_extract_hard_gate_then_reason`：批量抽取后逐个执行 hard-fail gate，明显不合适的候选人不再进入后续 reasoning。
+- `pipeline_simulation`：基于 saved timings 估算浏览器采集和 LLM 重叠后的理论下界；只用于判断是否值得后续改 workflow。
+
+为避免把“输出解释”本身的耗时算进策略，benchmark-native 的抽取/判断提示词不会要求模型输出筛选理由、summary 或 CoT；hard-fail gate 只要求 `{"hard_fail": true/false, "continue_reasoning": true/false, "uncertain": true/false}`，判断阶段只要求 `{"passed": true/false, "uncertain": true/false}`。
+
+输出文件包括 `benchmark-summary.json`、`benchmark-results.json`、`benchmark-results.csv`、`benchmark-disagreements.csv` 和 `benchmark-manifest.json`。所有非 oracle 策略都会和 `oracle_full_image_high` 对比 false negative / false positive / pass-rate drift，并用 `saved_non_llm_ms + benchmark_llm_ms` 计算 projected total time；hard-gate 策略会额外报告 `gate_ms` 和 `early_exit_count`；默认 eligibility 目标是平均 `<30000ms` 且 false negative 为 0。
+
 ## 常用命令
 
 npm 包安装后可直接使用可执行命令 `boss-recommend-mcp`。以下示例展示源码模式（`node src/cli.js`）：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "2.1.15",
+  "version": "2.1.17",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",
@@ -76,7 +76,8 @@
     "live:chat-mcp": "node scripts/live-chat-mcp-smoke.js",
     "live:cv-capture-target": "node scripts/live-cv-capture-target-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"
+    "live:chat-image-screening": "node scripts/live-chat-image-screening-smoke.js",
+    "benchmark:screening": "node scripts/benchmark-screening-strategies.js"
   },
   "files": [
     "bin",

package/src/chat-mcp.js

@@ -756,8 +756,8 @@ function buildLegacyChatResult(snapshot) {
   };
 }
 
-function normalizeRunSnapshot(snapshot) {
-  if (!snapshot) return null;
+function normalizeRunSnapshot(snapshot) {
+  if (!snapshot) return null;
   const meta = getChatRunMeta(snapshot.runId);
   const artifacts = getChatRunArtifacts(snapshot.runId);
   const summary = snapshot.summary && typeof snapshot.summary === "object" ? snapshot.summary : null;
@@ -812,19 +812,61 @@ function normalizeRunSnapshot(snapshot) {
     },
     result: legacyResult,
     artifacts
-  };
-}
-
-function persistChatRunSnapshot(snapshot, {
-  persistActiveCheckpoint = false
-} = {}) {
-  const normalized = normalizeRunSnapshot(snapshot);
-  if (!normalized?.run_id) return normalized;
-  const artifacts = getChatRunArtifacts(normalized.run_id);
-  if (!artifacts) return normalized;
-  if (persistActiveCheckpoint) {
-    persistChatCheckpointSnapshot(normalized);
-  }
+  };
+}
+
+function plainRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+
+function mergePersistedChatControlRequest(normalized, existing) {
+  const control = {
+    ...(normalized?.control || {})
+  };
+  if (!normalized) return control;
+  const existingControl = plainRecord(existing?.control);
+  if (TERMINAL_STATUSES.has(normalized.state)) return control;
+  if (existingControl.cancel_requested === true) {
+    return {
+      ...control,
+      pause_requested: true,
+      pause_requested_at: existingControl.pause_requested_at || control.pause_requested_at || new Date().toISOString(),
+      pause_requested_by: existingControl.pause_requested_by || control.pause_requested_by || "cancel_boss_chat_run",
+      cancel_requested: true
+    };
+  }
+  if (existingControl.pause_requested === true && normalized.state !== RUN_STATUS_PAUSED) {
+    return {
+      ...control,
+      pause_requested: true,
+      pause_requested_at: existingControl.pause_requested_at || control.pause_requested_at || new Date().toISOString(),
+      pause_requested_by: existingControl.pause_requested_by || control.pause_requested_by || "pause_boss_chat_run"
+    };
+  }
+  if (existingControl.pause_requested === false && normalized.state === RUN_STATUS_PAUSED) {
+    return {
+      ...control,
+      pause_requested: false,
+      pause_requested_at: null,
+      pause_requested_by: null,
+      cancel_requested: false
+    };
+  }
+  return control;
+}
+
+function persistChatRunSnapshot(snapshot, {
+  persistActiveCheckpoint = false
+} = {}) {
+  const normalized = normalizeRunSnapshot(snapshot);
+  if (!normalized?.run_id) return normalized;
+  const artifacts = getChatRunArtifacts(normalized.run_id);
+  if (!artifacts) return normalized;
+  const existing = readJsonFile(artifacts.run_state_path);
+  normalized.control = mergePersistedChatControlRequest(normalized, existing);
+  if (persistActiveCheckpoint) {
+    persistChatCheckpointSnapshot(normalized);
+  }
   const payload = {
     run_id: normalized.run_id,
     mode: normalized.mode,

package/src/core/greet-quota/index.js

@@ -52,3 +52,20 @@ export function assertGreetQuotaAvailable(source = "") {
   }
   return quota;
 }
+
+export function describeGreetQuotaAfterSpend(source = "") {
+  const quota = normalizeGreetQuotaSource(source);
+  if (!quota.found || quota.numerator === null || quota.denominator === null) {
+    return {
+      ...quota,
+      remaining_after_spend: null,
+      exhausted_after_spend: false
+    };
+  }
+  const remaining = quota.denominator - quota.numerator;
+  return {
+    ...quota,
+    remaining_after_spend: remaining,
+    exhausted_after_spend: remaining < quota.numerator
+  };
+}

package/src/core/reporting/legacy-csv.js

@@ -50,6 +50,7 @@ const SEARCH_PARAM_ORDER = [
   "schools",
   "keyword",
   "filter_recent_viewed",
+  "skip_recent_colleague_contacted",
   "job",
   "start_from",
   "target_count",
@@ -60,7 +61,10 @@ const SCREEN_PARAM_ORDER = [
   "criteria",
   "target_count",
   "post_action",
-  "max_greet_count"
+  "max_greet_count",
+  "skip_recent_colleague_contacted",
+  "colleague_contact_window_days",
+  "search_exchange_resume_filter_days"
 ];
 
 function normalizeText(value) {

package/src/domains/recommend/actions.js

@@ -5,6 +5,7 @@ import {
   getNodeBox,
   getOuterHTML,
   querySelectorAll,
+  scrollNodeIntoView,
   sleep
 } from "../../core/browser/index.js";
 import {
@@ -433,7 +434,21 @@ export async function waitForRecommendDetailActionControls(client, {
 export async function clickRecommendActionControl(client, control, {
   allowDisabled = false
 } = {}) {
-  if (!control?.center) {
+  let clickCenter = control?.center || null;
+  let clickRect = control?.rect || null;
+  if (control?.node_id) {
+    try {
+      await scrollNodeIntoView(client, control.node_id);
+      await sleep(150);
+      const box = await getNodeBox(client, control.node_id);
+      clickCenter = box.center;
+      clickRect = box.rect;
+    } catch {
+      // Fall back to the discovered center below; callers still get a clear
+      // error if no usable click point exists.
+    }
+  }
+  if (!clickCenter) {
     throw new Error("Action control has no clickable center");
   }
   const greetQuota = control.kind === "greet"
@@ -442,7 +457,7 @@ export async function clickRecommendActionControl(client, control, {
   if (control.disabled && !allowDisabled) {
     throw new Error(`Action control is disabled: ${control.kind}`);
   }
-  await clickPoint(client, control.center.x, control.center.y);
+  await clickPoint(client, clickCenter.x, clickCenter.y);
   return {
     clicked: true,
     kind: control.kind,
@@ -451,6 +466,7 @@ export async function clickRecommendActionControl(client, control, {
     selector: control.selector,
     root: control.root,
     node_id: control.node_id,
-    center: control.center
+    center: clickCenter,
+    rect: clickRect
   };
 }

package/src/domains/recommend/colleague-contact.js

@@ -0,0 +1,333 @@
+import {
+  clickNodeCenter,
+  getNodeBox,
+  getOuterHTML,
+  querySelectorAll,
+  sleep
+} from "../../core/browser/index.js";
+import { htmlToText } from "../../core/screening/index.js";
+
+const COLLEAGUE_SECTION_SELECTOR = ".colleague-collaboration";
+const COLLEAGUE_TAB_SELECTOR = ".colleague-collaboration .tab-hd";
+const SELECTED_TAB_SELECTOR = ".colleague-collaboration .tab-hd .selected";
+const SECTION_SELECTED_TAB_SELECTOR = ".tab-hd .selected";
+const TAB_CANDIDATE_SELECTOR = ".tab-hd span, .tab-hd div, .tab-hd *";
+const ROW_SELECTOR = ".colleague-collaboration .record-item.mate-log-item";
+const ROW_CONTENT_SELECTOR = ".colleague-collaboration .record-item.mate-log-item .content";
+const DETAIL_PANE_SELECTOR = ".resume-item-detail";
+
+function normalizeText(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+
+function dateOnly(value) {
+  const date = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(date.getTime())) return null;
+  return new Date(date.getFullYear(), date.getMonth(), date.getDate());
+}
+
+function daysBetween(left, right) {
+  const leftDate = dateOnly(left);
+  const rightDate = dateOnly(right);
+  if (!leftDate || !rightDate) return null;
+  return Math.floor((leftDate.getTime() - rightDate.getTime()) / 86400000);
+}
+
+function formatLocalDate(date) {
+  const parsed = dateOnly(date);
+  if (!parsed) return null;
+  const year = parsed.getFullYear();
+  const month = String(parsed.getMonth() + 1).padStart(2, "0");
+  const day = String(parsed.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+
+function makeDate(year, month, day) {
+  const parsed = new Date(year, month - 1, day);
+  if (
+    parsed.getFullYear() !== year
+    || parsed.getMonth() !== month - 1
+    || parsed.getDate() !== day
+  ) {
+    return null;
+  }
+  return parsed;
+}
+
+export function parseColleagueContactDate(text, {
+  referenceDate = new Date()
+} = {}) {
+  const raw = normalizeText(text);
+  if (!raw) return null;
+  const today = dateOnly(referenceDate) || dateOnly(new Date());
+  const relativeDays = raw.match(/(\d+)\s*天前/);
+  if (relativeDays) {
+    const days = Number.parseInt(relativeDays[1], 10);
+    if (Number.isFinite(days) && days >= 0) {
+      const date = new Date(today);
+      date.setDate(date.getDate() - days);
+      return date;
+    }
+  }
+  if (/今天/.test(raw)) return today;
+  if (/昨天/.test(raw)) {
+    const date = new Date(today);
+    date.setDate(date.getDate() - 1);
+    return date;
+  }
+  if (/前天/.test(raw)) {
+    const date = new Date(today);
+    date.setDate(date.getDate() - 2);
+    return date;
+  }
+
+  const full = raw.match(/(20\d{2})[.\-\/](\d{1,2})[.\-\/](\d{1,2})/);
+  if (full) {
+    return makeDate(
+      Number.parseInt(full[1], 10),
+      Number.parseInt(full[2], 10),
+      Number.parseInt(full[3], 10)
+    );
+  }
+
+  const partial = raw.match(/(?:^|\D)(\d{1,2})[.\-\/](\d{1,2})(?:\D|$)/);
+  if (partial) {
+    const reference = dateOnly(referenceDate) || new Date();
+    let date = makeDate(
+      reference.getFullYear(),
+      Number.parseInt(partial[1], 10),
+      Number.parseInt(partial[2], 10)
+    );
+    if (date && daysBetween(date, reference) > 7) {
+      date = makeDate(
+        reference.getFullYear() - 1,
+        Number.parseInt(partial[1], 10),
+        Number.parseInt(partial[2], 10)
+      );
+    }
+    return date;
+  }
+
+  return null;
+}
+
+export function isDateWithinWindow(date, {
+  referenceDate = new Date(),
+  windowDays = 14
+} = {}) {
+  const diff = daysBetween(referenceDate, date);
+  return Number.isFinite(diff) && diff >= 0 && diff <= windowDays;
+}
+
+async function textForNode(client, nodeId) {
+  return htmlToText(await getOuterHTML(client, nodeId));
+}
+
+async function queryAcrossRoots(client, roots, selector) {
+  const matches = [];
+  for (const root of roots || []) {
+    if (!root?.nodeId) continue;
+    const nodeIds = await querySelectorAll(client, root.nodeId, selector).catch(() => []);
+    for (const nodeId of nodeIds) {
+      matches.push({
+        root: root.name,
+        root_node_id: root.nodeId,
+        selector,
+        node_id: nodeId
+      });
+    }
+  }
+  return matches;
+}
+
+function tabIsColleague(text) {
+  return /同事沟通进度/.test(normalizeText(text));
+}
+
+async function ensureColleagueTabSelected(client, sectionNodeId) {
+  const selectedIds = await querySelectorAll(client, sectionNodeId, SECTION_SELECTED_TAB_SELECTOR).catch(() => []);
+  for (const nodeId of selectedIds) {
+    const text = normalizeText(await textForNode(client, nodeId).catch(() => ""));
+    if (tabIsColleague(text)) {
+      return {
+        selected: true,
+        changed: false,
+        selected_text: text
+      };
+    }
+  }
+
+  const candidateIds = await querySelectorAll(client, sectionNodeId, TAB_CANDIDATE_SELECTOR).catch(() => []);
+  for (const nodeId of candidateIds) {
+    const text = normalizeText(await textForNode(client, nodeId).catch(() => ""));
+    if (!tabIsColleague(text)) continue;
+    const box = await clickNodeCenter(client, nodeId, { scrollIntoView: true });
+    await sleep(500);
+    return {
+      selected: true,
+      changed: true,
+      selected_text: text,
+      click_box: {
+        rect: box.rect,
+        center: box.center
+      }
+    };
+  }
+
+  return {
+    selected: false,
+    changed: false,
+    selected_text: selectedIds.length
+      ? normalizeText(await textForNode(client, selectedIds[0]).catch(() => ""))
+      : ""
+  };
+}
+
+async function readContactRows(client, roots) {
+  const rowMatches = await queryAcrossRoots(client, roots, ROW_CONTENT_SELECTOR);
+  const fallbackMatches = rowMatches.length ? [] : await queryAcrossRoots(client, roots, ROW_SELECTOR);
+  const matches = rowMatches.length ? rowMatches : fallbackMatches;
+  const rows = [];
+  const seen = new Set();
+  for (const match of matches) {
+    const text = normalizeText(await textForNode(client, match.node_id).catch(() => ""));
+    if (!text || seen.has(text)) continue;
+    seen.add(text);
+    rows.push({
+      text,
+      root: match.root,
+      selector: match.selector,
+      node_id: match.node_id
+    });
+  }
+  return rows;
+}
+
+async function scrollDetailPaneForRows(client, roots, sectionNodeId, {
+  maxScrolls = 4,
+  settleMs = 350
+} = {}) {
+  const detailPanes = await queryAcrossRoots(client, roots, DETAIL_PANE_SELECTOR);
+  const targetNodeId = detailPanes[0]?.node_id || sectionNodeId;
+  let box = null;
+  try {
+    box = await getNodeBox(client, targetNodeId);
+  } catch {
+    try {
+      box = await getNodeBox(client, sectionNodeId);
+    } catch {
+      return { scrolls: 0, reason: "scroll_target_box_unavailable" };
+    }
+  }
+  let scrolls = 0;
+  for (let index = 0; index < maxScrolls; index += 1) {
+    await client.Input.dispatchMouseEvent({
+      type: "mouseWheel",
+      x: box.center.x,
+      y: box.center.y,
+      deltaY: 680,
+      deltaX: 0
+    });
+    scrolls += 1;
+    await sleep(settleMs);
+  }
+  return {
+    scrolls,
+    target_selector: detailPanes[0]?.selector || COLLEAGUE_SECTION_SELECTOR
+  };
+}
+
+async function waitForColleagueSections(client, roots, {
+  timeoutMs = 1000,
+  intervalMs = 150
+} = {}) {
+  const started = Date.now();
+  let sections = [];
+  do {
+    sections = await queryAcrossRoots(client, roots, COLLEAGUE_SECTION_SELECTOR);
+    if (sections.length) return sections;
+    if (Date.now() - started >= timeoutMs) break;
+    await sleep(intervalMs);
+  } while (Date.now() - started <= timeoutMs);
+  return sections;
+}
+
+export async function inspectRecentColleagueContact(client, detailState, {
+  referenceDate = new Date(),
+  windowDays = 14,
+  scroll = true,
+  sectionWaitMs = 1000,
+  sectionPollMs = 150
+} = {}) {
+  const roots = detailState?.roots || [];
+  const sections = await waitForColleagueSections(client, roots, {
+    timeoutMs: sectionWaitMs,
+    intervalMs: sectionPollMs
+  });
+  if (!sections.length) {
+    return {
+      checked: true,
+      panel_found: false,
+      recent: false,
+      reason: "panel_missing",
+      window_days: windowDays,
+      rows: []
+    };
+  }
+
+  const section = sections[0];
+  const tabHeader = await queryAcrossRoots(client, roots, COLLEAGUE_TAB_SELECTOR);
+  const tab = await ensureColleagueTabSelected(client, section.node_id);
+  if (!tab.selected) {
+    return {
+      checked: true,
+      panel_found: true,
+      recent: false,
+      reason: "colleague_tab_unavailable",
+      window_days: windowDays,
+      section_root: section.root,
+      tab_header_found: tabHeader.length > 0,
+      selected_tab_text: tab.selected_text,
+      rows: []
+    };
+  }
+
+  let rows = await readContactRows(client, roots);
+  let scroll_probe = null;
+  if (scroll) {
+    scroll_probe = await scrollDetailPaneForRows(client, roots, section.node_id);
+    const afterScrollRows = await readContactRows(client, roots);
+    const byText = new Map(rows.map((row) => [row.text, row]));
+    for (const row of afterScrollRows) {
+      if (!byText.has(row.text)) byText.set(row.text, row);
+    }
+    rows = Array.from(byText.values());
+  }
+
+  const parsedRows = rows.map((row) => {
+    const parsedDate = parseColleagueContactDate(row.text, { referenceDate });
+    return {
+      ...row,
+      parsed_date: parsedDate ? formatLocalDate(parsedDate) : null,
+      within_window: parsedDate
+        ? isDateWithinWindow(parsedDate, { referenceDate, windowDays })
+        : false
+    };
+  });
+  const matched = parsedRows.find((row) => row.within_window) || null;
+  return {
+    checked: true,
+    panel_found: true,
+    recent: Boolean(matched),
+    reason: matched ? "recent_colleague_contact_found" : "no_recent_colleague_contact",
+    window_days: windowDays,
+    section_root: section.root,
+    tab_header_found: tabHeader.length > 0,
+    selected_tab_text: tab.selected_text,
+    tab_changed: tab.changed,
+    matched_row: matched,
+    row_count: parsedRows.length,
+    rows: parsedRows,
+    scroll_probe
+  };
+}

package/src/domains/recommend/index.js

@@ -6,5 +6,6 @@ export * from "./detail.js";
 export * from "./actions.js";
 export * from "./jobs.js";
 export * from "./scopes.js";
+export * from "./colleague-contact.js";
 export * from "./refresh.js";
 export * from "./run-service.js";