@reconcrap/boss-recommend-mcp 2.1.17 → 2.1.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "2.1.17",
+  "version": "2.1.18",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",

package/src/core/browser/index.js

@@ -1971,7 +1971,18 @@ export async function getOuterHTML(client, nodeId) {
 }
 
 export async function getNodeBox(client, nodeId) {
-  const result = await client.DOM.getBoxModel({ nodeId });
+  let result;
+  try {
+    result = await client.DOM.getBoxModel({ nodeId });
+  } catch (error) {
+    const wrapped = new Error(error?.message || String(error));
+    wrapped.name = error?.name || "Error";
+    wrapped.node_id = nodeId;
+    wrapped.cdp_method = "DOM.getBoxModel";
+    wrapped.original_stack = error?.stack || "";
+    wrapped.stack = `${new Error(`getNodeBox failed for nodeId=${nodeId}`).stack || wrapped.stack}\nCaused by: ${error?.stack || error}`;
+    throw wrapped;
+  }
   const model = result.model;
   const quad = model.border?.length ? model.border : model.content;
   const xs = [quad[0], quad[2], quad[4], quad[6]];
@@ -2171,7 +2182,17 @@ export async function clickPoint(client, x, y, {
 }
 
 export async function scrollNodeIntoView(client, nodeId) {
-  await client.DOM.scrollIntoViewIfNeeded({ nodeId });
+  try {
+    await client.DOM.scrollIntoViewIfNeeded({ nodeId });
+  } catch (error) {
+    const wrapped = new Error(error?.message || String(error));
+    wrapped.name = error?.name || "Error";
+    wrapped.node_id = nodeId;
+    wrapped.cdp_method = "DOM.scrollIntoViewIfNeeded";
+    wrapped.original_stack = error?.stack || "";
+    wrapped.stack = `${new Error(`scrollNodeIntoView failed for nodeId=${nodeId}`).stack || wrapped.stack}\nCaused by: ${error?.stack || error}`;
+    throw wrapped;
+  }
 }
 
 export async function clickNodeCenter(client, nodeId, {

package/src/domains/recruit/detail.js

@@ -7,6 +7,7 @@ import {
   getOuterHTML,
   pressKey,
   querySelectorAll,
+  scrollNodeIntoView,
   sleep
 } from "../../core/browser/index.js";
 import {
@@ -27,6 +28,111 @@ import {
   getRecruitRoots
 } from "./roots.js";
 
+function compactBox(box = null) {
+  if (!box) return null;
+  return {
+    center: box.center || null,
+    rect: box.rect || null
+  };
+}
+
+async function getViewportRect(client) {
+  if (typeof client?.Page?.getLayoutMetrics !== "function") return null;
+  try {
+    const metrics = await client.Page.getLayoutMetrics();
+    const viewport = metrics?.cssVisualViewport || metrics?.visualViewport || metrics?.layoutViewport || {};
+    const width = Number(viewport.clientWidth || viewport.width || metrics?.layoutViewport?.clientWidth || 0);
+    const height = Number(viewport.clientHeight || viewport.height || metrics?.layoutViewport?.clientHeight || 0);
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) return null;
+    return {
+      x: 0,
+      y: 0,
+      width,
+      height
+    };
+  } catch {
+    return null;
+  }
+}
+
+function boxCenterIsInViewport(box, viewport, { marginPx = 16 } = {}) {
+  if (!box?.center || !viewport) return null;
+  const margin = Math.max(0, Number(marginPx) || 0);
+  return (
+    box.center.x >= viewport.x + margin
+    && box.center.x <= viewport.x + viewport.width - margin
+    && box.center.y >= viewport.y + margin
+    && box.center.y <= viewport.y + viewport.height - margin
+  );
+}
+
+function scrollDeltaForBox(box, viewport) {
+  if (!box?.center || !viewport) return 0;
+  const targetY = viewport.y + viewport.height * 0.48;
+  const delta = box.center.y - targetY;
+  if (Math.abs(delta) < 80) return 0;
+  return Math.max(-900, Math.min(900, delta));
+}
+
+export async function ensureRecruitCardInViewport(client, cardNodeId, {
+  maxScrollAttempts = 4,
+  marginPx = 16,
+  settleMs = 220
+} = {}) {
+  const attempts = [];
+  await scrollNodeIntoView(client, cardNodeId);
+  if (settleMs > 0) await sleep(settleMs);
+
+  let finalBox = null;
+  for (let attempt = 0; attempt <= maxScrollAttempts; attempt += 1) {
+    const box = await getNodeBox(client, cardNodeId);
+    finalBox = box;
+    const viewport = await getViewportRect(client);
+    const inViewport = boxCenterIsInViewport(box, viewport, { marginPx });
+    const entry = {
+      attempt,
+      in_viewport: inViewport,
+      viewport,
+      box: compactBox(box)
+    };
+    attempts.push(entry);
+    if (inViewport === true || inViewport === null) {
+      return {
+        ok: inViewport !== false,
+        verified: inViewport === true,
+        box,
+        attempts
+      };
+    }
+    if (attempt >= maxScrollAttempts) break;
+
+    const deltaY = scrollDeltaForBox(box, viewport);
+    if (!deltaY) break;
+    const wheelPoint = {
+      x: viewport.x + viewport.width * 0.5,
+      y: viewport.y + viewport.height * 0.5
+    };
+    await client.Input.dispatchMouseEvent({
+      type: "mouseWheel",
+      x: wheelPoint.x,
+      y: wheelPoint.y,
+      deltaX: 0,
+      deltaY
+    });
+    entry.scroll = {
+      method: "mouseWheel",
+      delta_y: deltaY,
+      point: wheelPoint
+    };
+    if (settleMs > 0) await sleep(settleMs);
+  }
+
+  const error = new Error("Recruit candidate card is not inside the visible viewport before click");
+  error.card_viewport_attempts = attempts;
+  error.card_node_id = cardNodeId;
+  throw error;
+}
+
 export function matchesRecruitDetailNetwork(url) {
   return RECRUIT_DETAIL_NETWORK_PATTERNS.some((pattern) => pattern.test(String(url || "")));
 }
@@ -256,13 +362,19 @@ export async function openRecruitCardDetail(client, cardNodeId, {
   const openedStarted = Date.now();
   const attempts = [];
   const clickStarted = Date.now();
+  const viewportGuard = await ensureRecruitCardInViewport(client, cardNodeId);
   const cardBox = await clickNodeCenter(client, cardNodeId, {
-    scrollIntoView: true
+    scrollIntoView: false
   });
   let candidateClickMs = Date.now() - clickStarted;
   attempts.push({
     mode: "card-center",
-    center: cardBox.center
+    center: cardBox.center,
+    viewport_guard: {
+      ok: viewportGuard.ok,
+      verified: viewportGuard.verified,
+      attempts: viewportGuard.attempts
+    }
   });
   const detailStarted = Date.now();
   let detailState = await waitForRecruitDetail(client, { timeoutMs });

package/src/domains/recruit/instruction-parser.js

@@ -44,7 +44,8 @@ const DEGREE_VALUES = new Set(["不限", "本科", "本科及以上", "硕士及
 const CITY_STOP_PATTERN = /(?:筛选|搜索|查找|找|做过|从事过|有过|相关|的人选|的人|并且|且|学历|学校|经验|性别|年龄|目标|必须|优先|，|。|；|;|,)/;
 const POST_ACTIONS = new Set(["none", "greet"]);
 const CRITERIA_MARKER_PATTERN = /(?:筛选条件|筛选标准|筛选要求|筛选规则|硬性条件|硬条件|criteria)\s*[：:]/i;
-const CRITERIA_TRAILING_FIELD_PATTERN = /\n\s*(?:岗位|职位|关键词|城市|地点|工作地|学历|学校类型|院校标签|经验|经验要求|工作经验|工作年限|性别|年龄|年龄要求|年龄范围|只看未查看|目标筛选人数|目标人数|休息强度|后置动作|post_action|rest_level)\s*[：:]/i;
+const CRITERIA_TRAILING_FIELD_PATTERN = /\n\s*(?:岗位|职位|关键词|城市|地点|工作地|学历|学校类型|院校标签|经验|经验要求|工作经验|工作年限|性别|年龄|年龄要求|年龄范围|只看未查看|过滤已看|同事近期触达|近期同事触达|同事触达|同事联系|同事沟通|同事交换简历|目标筛选人数|目标人数|休息强度|后置动作|post_action|rest_level|filter_recent_colleague_contacted|recent_colleague_contacted|skip_recent_colleague_contacted)\s*[：:]/i;
+const INLINE_FIELD_BOUNDARY_PATTERN = /[；;]\s*(?:岗位|职位|关键词|城市|地点|工作地|学历|学校|学校类型|院校标签|经验|经验要求|工作经验|工作年限|性别|年龄|年龄要求|年龄范围|只看未查看|过滤已看|同事近期触达|近期同事触达|同事触达|同事联系|同事沟通|同事交换简历|目标筛选人数|目标人数|休息强度|后置动作|post_action|rest_level|filter_recent_colleague_contacted|recent_colleague_contacted|skip_recent_colleague_contacted)\s*(?:\([^)]*\))?\s*[：:]/i;
 
 function normalizeText(input) {
   return String(input || "").replace(/\s+/g, " ").trim();
@@ -64,13 +65,15 @@ function escapeRegExp(input) {
 }
 
 function extractFieldLineValue(rawText, labels = []) {
-  const lines = String(rawText || "").replace(/\r\n/g, "\n").split("\n");
+  const lines = String(rawText || "").replace(/\r\n/g, "\n").split(/\n|[；;]/);
   const labelPattern = labels.map(escapeRegExp).join("|");
   if (!labelPattern) return null;
   const pattern = new RegExp(`^\\s*(?:${labelPattern})(?:\\s*\\([^)]*\\))?\\s*[：:]\\s*(.+?)\\s*$`, "i");
   for (const line of lines) {
     const match = line.match(pattern);
-    const value = match?.[1]?.trim();
+    let value = match?.[1]?.trim();
+    const inlineBoundaryIndex = value ? value.search(INLINE_FIELD_BOUNDARY_PATTERN) : -1;
+    if (inlineBoundaryIndex >= 0) value = value.slice(0, inlineBoundaryIndex).trim();
     if (value) return value;
   }
   return null;
@@ -172,6 +175,56 @@ function normalizeRecentViewedOverride(value) {
   return null;
 }
 
+function normalizeColleagueContactedFilterOverride(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "number") return value !== 0;
+  const normalized = normalizeText(value).toLowerCase();
+  const compact = normalized.replace(/\s+/g, "");
+  if (!compact) return null;
+  if ([
+    "true",
+    "yes",
+    "y",
+    "1",
+    "on",
+    "enable",
+    "enabled",
+    "需要",
+    "是",
+    "开启",
+    "过滤",
+    "需要过滤",
+    "跳过",
+    "排除",
+    "剔除",
+    "近30天未和同事交换简历",
+    "未和同事交换简历",
+    "只看未和同事交换简历"
+  ].includes(compact)) return true;
+  if ([
+    "false",
+    "no",
+    "n",
+    "0",
+    "off",
+    "disable",
+    "disabled",
+    "不需要",
+    "否",
+    "关闭",
+    "不限",
+    "不过滤",
+    "不跳过",
+    "不排除",
+    "保留",
+    "none",
+    "all"
+  ].includes(compact)) return false;
+  if (/(?:不|别|无需|不用|不要).{0,6}(?:过滤|排除|跳过|剔除).{0,8}(?:同事|交换简历|触达|联系|沟通)/i.test(normalized)) return false;
+  if (/(?:过滤|排除|跳过|剔除).{0,8}(?:同事|交换简历|触达|联系|沟通)/i.test(normalized)) return true;
+  return normalizeBooleanOverride(value);
+}
+
 function normalizeBooleanOverride(value) {
   if (typeof value === "boolean") return value;
   if (typeof value === "number") return value !== 0;
@@ -217,6 +270,29 @@ function extractRecentViewedExplicit(rawText) {
   return value === null ? null : normalizeRecentViewedOverride(value);
 }
 
+function extractColleagueContactedFilterExplicit(rawText) {
+  const value = extractFieldLineValue(rawText, [
+    "同事近期触达",
+    "近期同事触达",
+    "同事触达",
+    "同事近期联系",
+    "近期同事联系",
+    "同事联系",
+    "同事近期沟通",
+    "近期同事沟通",
+    "同事沟通",
+    "同事交换简历",
+    "近期同事交换简历",
+    "近30天未和同事交换简历",
+    "filter_recent_colleague_contacted",
+    "recent_colleague_contacted",
+    "colleague_contacted_filter",
+    "colleague_contacted",
+    "skip_recent_colleague_contacted"
+  ]);
+  return value === null ? null : normalizeColleagueContactedFilterOverride(value);
+}
+
 function normalizeDegreesOverride(value) {
   if (Array.isArray(value)) return uniqueList(value.map(normalizeText));
   if (typeof value === "string") return uniqueList(value.split(/[，,、|/]/).map(normalizeText));
@@ -493,15 +569,21 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
   const rawInstruction = String(instruction || "");
   const text = normalizeText(rawInstruction);
   const finalConfirmed = confirmation?.final_confirmed === true;
-  const hasSkipRecentColleagueOverride = Object.prototype.hasOwnProperty.call(
-    overrides || {},
-    "skip_recent_colleague_contacted"
-  );
-  const confirmationSkipRecentColleagueContacted = normalizeBooleanOverride(
-    confirmation?.skip_recent_colleague_contacted_value
+  const hasSkipRecentColleagueOverride = [
+    "skip_recent_colleague_contacted",
+    "filter_recent_colleague_contacted",
+    "recent_colleague_contacted",
+    "colleague_contacted_filter",
+    "colleague_contacted"
+  ].some((key) => Object.prototype.hasOwnProperty.call(overrides || {}, key));
+  const confirmationSkipRecentColleagueContacted = normalizeColleagueContactedFilterOverride(
+    Object.prototype.hasOwnProperty.call(confirmation || {}, "filter_recent_colleague_contacted_value")
+      ? confirmation.filter_recent_colleague_contacted_value
+      : confirmation?.skip_recent_colleague_contacted_value
   );
   const explicitSchools = extractSchoolFilterExplicit(rawInstruction);
   const explicitRecentViewed = extractRecentViewedExplicit(rawInstruction);
+  const explicitColleagueContactedFilter = extractColleagueContactedFilterExplicit(rawInstruction);
   const explicitKeyword = extractFieldLineValue(rawInstruction, ["搜索关键词", "关键词", "keyword"]);
   const explicitJob = extractFieldLineValue(rawInstruction, ["岗位", "职位", "job"]);
   const explicitCity = extractFieldLineValue(rawInstruction, ["城市", "地点", "工作地", "base"]);
@@ -526,7 +608,7 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
     schools: explicitSchools.explicit ? explicitSchools.schools : extractSchools(text),
     schools_explicit: explicitSchools.explicit,
     filter_recent_viewed: explicitRecentViewed !== null ? explicitRecentViewed : extractRecentViewedFilter(text),
-    skip_recent_colleague_contacted: confirmationSkipRecentColleagueContacted ?? true,
+    skip_recent_colleague_contacted: explicitColleagueContactedFilter ?? confirmationSkipRecentColleagueContacted,
     keyword_explicit: explicitKeyword || extractKeywordExplicit(text),
     keyword_auto: extractKeywordAuto(text),
     target_count: explicitTargetCount || extractTargetCount(text),
@@ -594,7 +676,17 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
         ? overrides.filter_recent_viewed
         : overrides.recent_not_view
     );
-    const overrideSkipRecentColleagueContacted = normalizeBooleanOverride(overrides.skip_recent_colleague_contacted);
+    const overrideSkipRecentColleagueContacted = normalizeColleagueContactedFilterOverride(
+      Object.prototype.hasOwnProperty.call(overrides, "skip_recent_colleague_contacted")
+        ? overrides.skip_recent_colleague_contacted
+        : Object.prototype.hasOwnProperty.call(overrides, "filter_recent_colleague_contacted")
+          ? overrides.filter_recent_colleague_contacted
+          : Object.prototype.hasOwnProperty.call(overrides, "recent_colleague_contacted")
+            ? overrides.recent_colleague_contacted
+            : Object.prototype.hasOwnProperty.call(overrides, "colleague_contacted_filter")
+              ? overrides.colleague_contacted_filter
+              : overrides.colleague_contacted
+    );
     const overridePostAction = normalizePostAction(overrides.post_action);
     if (overrideCity) parsed.city = overrideCity;
     if (overrideDegree) parsed.degree = overrideDegree;
@@ -638,6 +730,11 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
   const postAction = resolvePostAction(parsed, confirmation);
   const maxGreetCount = resolveMaxGreetCount(parsed, confirmation);
   const confirmationCriteria = normalizeStringOverride(confirmation?.criteria_value);
+  const skipRecentColleagueContacted = typeof parsed.skip_recent_colleague_contacted === "boolean"
+    ? parsed.skip_recent_colleague_contacted
+    : finalConfirmed
+      ? false
+      : null;
   const baseSearchParams = {
     job,
     city: parsed.city,
@@ -648,7 +745,7 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
     gender: parsed.gender,
     age: parsed.age,
     filter_recent_viewed: parsed.filter_recent_viewed,
-    skip_recent_colleague_contacted: parsed.skip_recent_colleague_contacted !== false,
+    skip_recent_colleague_contacted: skipRecentColleagueContacted,
     keyword: keywordResolution.keyword
   };
   const criteria = parsed.criteria_override || confirmationCriteria || parsed.criteria_explicit || null;
@@ -664,7 +761,7 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
     target_count: parsed.target_count,
     post_action: postAction,
     max_greet_count: maxGreetCount,
-    skip_recent_colleague_contacted: parsed.skip_recent_colleague_contacted !== false,
+    skip_recent_colleague_contacted: skipRecentColleagueContacted === true,
     search_exchange_resume_filter_days: 30
   };
   const missingBeforeDefaults = collectMissingFields(baseSearchParams, baseScreenParams, parsed);
@@ -687,6 +784,7 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
     && !hasSkipRecentColleagueOverride
     && confirmationSkipRecentColleagueContacted === null
     && confirmation?.skip_recent_colleague_contacted_confirmed !== true
+    && confirmation?.filter_recent_colleague_contacted_confirmed !== true
   );
   const needs_criteria_confirmation = Boolean(screenParams.criteria) && !finalConfirmed && confirmation?.criteria_confirmed !== true;
   const pending_questions = [
@@ -703,12 +801,12 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
       : []),
     ...(needs_skip_recent_colleague_contacted_confirmation
       ? [{
-        field: "skip_recent_colleague_contacted",
-        question: "是否跳过近期已被同事触达的人选？搜索页会开启 Boss 的“近30天未和同事交换简历”过滤。",
+        field: "filter_recent_colleague_contacted",
+        question: "是否过滤近期已被同事触达的人选？开启后搜索页会勾选 Boss 的“近30天未和同事交换简历”。",
         value: true,
         options: [
-          { label: "跳过（推荐）", value: true },
-          { label: "不跳过", value: false }
+          { label: "过滤", value: true },
+          { label: "不过滤", value: false }
         ]
       }]
       : []),

package/src/domains/recruit/run-service.js

@@ -109,6 +109,8 @@ function compactDetail(detailResult) {
   return {
     popup_text_length: detailResult.detail?.popup_text?.length || 0,
     resume_text_length: detailResult.detail?.resume_text?.length || 0,
+    card_box: detailResult.card_box || null,
+    open_attempts: detailResult.open_attempts || [],
     network_body_count: detailResult.network_bodies?.filter((item) => item.body).length || 0,
     parsed_network_profile_count: detailResult.parsed_network_profiles?.filter((item) => item.ok).length || 0,
     cv_acquisition: detailResult.cv_acquisition || null,
@@ -593,7 +595,7 @@ export async function runRecruitWorkflow({
   const normalizedPostAction = normalizeRecruitPostAction(postAction);
   const postActionEnabled = normalizedPostAction !== "none";
   const useLlmScreening = normalizedScreeningMode !== "deterministic";
-  const searchExchangeResumeFilterRequested = normalizedSearchParams.skip_recent_colleague_contacted !== false;
+  const searchExchangeResumeFilterRequested = normalizedSearchParams.skip_recent_colleague_contacted === true;
   let searchExchangeResumeFilterApplied = false;
   const limit = Math.max(1, Number(maxCandidates) || 1);
   const detailCountLimit = detailLimit == null ? limit : Math.max(0, Number(detailLimit) || 0);
@@ -1047,6 +1049,8 @@ export async function runRecruitWorkflow({
           networkParseRetryMs: waitPlan.mode_before === "image" ? 500 : 2200,
           networkParseIntervalMs: 250
         });
+        detailResult.card_box = openedDetail.card_box || null;
+        detailResult.open_attempts = openedDetail.open_attempts || [];
         addTiming(timings, "late_network_retry_ms", detailResult.network_parse_retry_elapsed_ms);
         const parsedNetworkProfileCount = countParsedNetworkProfiles(detailResult);
         let source = "network";
@@ -1484,7 +1488,7 @@ export function createRecruitRunService({
     const normalizedSearchParams = normalizeSearchParams(searchParams);
     const normalizedScreeningMode = normalizeScreeningMode(screeningMode);
     const normalizedPostAction = normalizeRecruitPostAction(postAction);
-    const searchExchangeResumeFilterRequested = normalizedSearchParams.skip_recent_colleague_contacted !== false;
+    const searchExchangeResumeFilterRequested = normalizedSearchParams.skip_recent_colleague_contacted === true;
     const candidateLimit = Math.max(1, Number(maxCandidates) || 1);
     const normalizedDetailLimit = detailLimit == null ? candidateLimit : Math.max(0, Number(detailLimit) || 0);
     const effectiveHumanBehavior = normalizeHumanBehaviorOptions(humanBehavior, {

package/src/domains/recruit/search.js

@@ -691,6 +691,9 @@ export function normalizeRecruitSearchParams(searchParams = {}) {
   const experience = normalizeRecruitExperienceFilter(pickRecruitExperienceSource(searchParams));
   const gender = normalizeRecruitGenderFilter(searchParams.gender);
   const age = normalizeRecruitAgeFilter(pickRecruitAgeSource(searchParams));
+  const skipRecentColleagueContacted = typeof searchParams.skip_recent_colleague_contacted === "boolean"
+    ? searchParams.skip_recent_colleague_contacted
+    : null;
   const normalized = {
     city: normalizeText(searchParams.city) || null,
     degree: degrees[0] || "不限",
@@ -700,7 +703,7 @@ export function normalizeRecruitSearchParams(searchParams = {}) {
     filter_recent_viewed: typeof searchParams.filter_recent_viewed === "boolean"
       ? searchParams.filter_recent_viewed
       : null,
-    skip_recent_colleague_contacted: searchParams.skip_recent_colleague_contacted !== false
+    skip_recent_colleague_contacted: skipRecentColleagueContacted
   };
   const job = normalizeText(searchParams.job || searchParams.job_title || searchParams.selected_job);
   if (job) normalized.job = job;
@@ -733,6 +736,9 @@ export function hasRecruitSearchParams(searchParams = {}) {
   const experience = normalizeRecruitExperienceFilter(pickRecruitExperienceSource(searchParams));
   const gender = normalizeRecruitGenderFilter(searchParams.gender);
   const age = normalizeRecruitAgeFilter(pickRecruitAgeSource(searchParams));
+  const skipRecentColleagueContacted = typeof searchParams.skip_recent_colleague_contacted === "boolean"
+    ? searchParams.skip_recent_colleague_contacted
+    : null;
   const normalized = {
     city: normalizeText(searchParams.city) || null,
     degree: degrees[0] || "不限",
@@ -742,7 +748,7 @@ export function hasRecruitSearchParams(searchParams = {}) {
     filter_recent_viewed: typeof searchParams.filter_recent_viewed === "boolean"
       ? searchParams.filter_recent_viewed
       : null,
-    skip_recent_colleague_contacted: searchParams.skip_recent_colleague_contacted !== false
+    skip_recent_colleague_contacted: skipRecentColleagueContacted
   };
   return Boolean(
     job
@@ -2239,20 +2245,180 @@ function parseRecruitAgeCustomHiddenValue(value) {
   return parseAgeNumber(text, null);
 }
 
+async function listRecruitAgeCustomTriggerState(client, frameNodeId) {
+  const triggerSources = [
+    {
+      source: "dropdown",
+      node_ids: uniqueNodeIds(await querySelectorAll(
+        client,
+        frameNodeId,
+        RECRUIT_SEARCH_SELECTORS.ageCustomDropdown.join(", ")
+      ))
+    },
+    {
+      source: "input",
+      node_ids: uniqueNodeIds(await querySelectorAll(
+        client,
+        frameNodeId,
+        RECRUIT_SEARCH_SELECTORS.ageCustomInput.join(", ")
+      ))
+    }
+  ];
+  const discovered = [];
+  const seenTriggers = new Set();
+  for (const { source, node_ids: nodeIds } of triggerSources) {
+    for (const nodeId of nodeIds) {
+      if (seenTriggers.has(nodeId)) continue;
+      seenTriggers.add(nodeId);
+      const attributes = await getAttributesMap(client, nodeId).catch(() => ({}));
+      if (source === "input" && attributes.type === "hidden") {
+        discovered.push({
+          node_id: nodeId,
+          source,
+          visible: false,
+          reason: "hidden_input"
+        });
+        continue;
+      }
+      let box = null;
+      try {
+        box = await getNodeBox(client, nodeId);
+      } catch (error) {
+        discovered.push({
+          node_id: nodeId,
+          source,
+          visible: false,
+          error: error?.message || String(error)
+        });
+        continue;
+      }
+      discovered.push({
+        node_id: nodeId,
+        source,
+        visible: isVisibleBox(box),
+        center: box.center,
+        rect: box.rect
+      });
+    }
+  }
+  const sortTriggers = (items) => items
+    .slice()
+    .sort((left, right) => left.rect.x - right.rect.x || left.rect.y - right.rect.y);
+  const visible_dropdowns = sortTriggers(discovered.filter((item) => item.visible && item.source === "dropdown"));
+  const visible_inputs = sortTriggers(discovered.filter((item) => item.visible && item.source === "input"));
+  return {
+    discovered,
+    visible_dropdowns,
+    visible_inputs,
+    preferred: visible_dropdowns.length >= 2 ? visible_dropdowns : visible_inputs
+  };
+}
+
+async function waitForRecruitAgeCustomTriggerState(client, frameNodeId, {
+  timeoutMs = 1800,
+  intervalMs = 150
+} = {}) {
+  const started = Date.now();
+  let state = null;
+  while (Date.now() - started <= timeoutMs) {
+    state = await listRecruitAgeCustomTriggerState(client, frameNodeId);
+    if ((state.preferred || []).length >= 2) {
+      return {
+        ok: true,
+        elapsed_ms: Date.now() - started,
+        ...state
+      };
+    }
+    await sleep(intervalMs);
+  }
+  return {
+    ok: false,
+    elapsed_ms: Date.now() - started,
+    ...(state || { discovered: [], visible_dropdowns: [], visible_inputs: [], preferred: [] })
+  };
+}
+
+async function openRecruitAgeCustomControls(client, frameNodeId) {
+  const alreadyOpen = await waitForRecruitAgeCustomTriggerState(client, frameNodeId, {
+    timeoutMs: 200,
+    intervalMs: 100
+  });
+  if (alreadyOpen.ok) {
+    return {
+      opened: true,
+      already_open: true,
+      trigger_state: alreadyOpen
+    };
+  }
+
+  const attempts = [];
+  for (let attempt = 1; attempt <= 2; attempt += 1) {
+    const candidates = await listTextCandidates(client, frameNodeId, RECRUIT_SEARCH_SELECTORS.ageCustom, {
+      includeBox: true
+    });
+    const visibleCandidates = candidates.filter((item) => item.visible);
+    const labelCandidate = chooseRecruitTextCandidate(visibleCandidates, {
+      label: "自定义",
+      match: "exact"
+    });
+    const customClick = labelCandidate
+      ? {
+        clicked: true,
+        selector: labelCandidate.selector,
+        node_id: labelCandidate.node_id,
+        box: await clickNodeCenter(client, labelCandidate.node_id, {
+          ...DETERMINISTIC_CLICK_OPTIONS,
+          scrollIntoView: true
+        })
+      }
+      : await clickFirstNodeBySelectors(
+        client,
+        frameNodeId,
+        RECRUIT_SEARCH_SELECTORS.ageCustom,
+        { optional: false, scrollIntoView: true }
+      );
+    await sleep(500);
+    const triggerState = await waitForRecruitAgeCustomTriggerState(client, frameNodeId);
+    attempts.push({
+      attempt,
+      click: customClick,
+      matched_label: labelCandidate ? compactRecruitTextCandidate(labelCandidate) : null,
+      candidates: visibleCandidates.map(compactRecruitTextCandidate).slice(0, 10),
+      trigger_state: triggerState
+    });
+    if (triggerState.ok) {
+      return {
+        opened: true,
+        already_open: false,
+        attempts,
+        trigger_state: triggerState
+      };
+    }
+  }
+
+  const error = new Error("Recruit age custom controls did not open after clicking 自定义");
+  error.age_custom_attempts = attempts;
+  error.discovered_dropdowns = attempts[attempts.length - 1]?.trigger_state?.discovered || [];
+  throw error;
+}
+
 async function selectRecruitAgeCustomDropdownValue(client, frameNodeId, {
   dropdownIndex,
   value
 }) {
-  const dropdownNodeIds = uniqueNodeIds(await querySelectorAll(
-    client,
-    frameNodeId,
-    RECRUIT_SEARCH_SELECTORS.ageCustomDropdown.join(", ")
-  ));
-  const dropdownNodeId = dropdownNodeIds[dropdownIndex];
-  if (!dropdownNodeId) {
-    throw new Error(`Recruit age custom dropdown was not found: index=${dropdownIndex}`);
-  }
-  const openBox = await clickNodeCenter(client, dropdownNodeId, {
+  const triggerState = await listRecruitAgeCustomTriggerState(client, frameNodeId);
+  const visibleDropdownWrappers = triggerState.visible_dropdowns || [];
+  const visibleInputTriggers = triggerState.visible_inputs || [];
+  const visibleDropdowns = visibleDropdownWrappers.length > dropdownIndex
+    ? visibleDropdownWrappers
+    : visibleInputTriggers;
+  const dropdown = visibleDropdowns[dropdownIndex];
+  if (!dropdown?.node_id) {
+    const error = new Error(`Recruit age custom dropdown was not found: index=${dropdownIndex}`);
+    error.discovered_dropdowns = triggerState.discovered;
+    throw error;
+  }
+  const openBox = await clickNodeCenter(client, dropdown.node_id, {
     ...DETERMINISTIC_CLICK_OPTIONS,
     scrollIntoView: true
   });
@@ -2261,7 +2427,8 @@ async function selectRecruitAgeCustomDropdownValue(client, frameNodeId, {
   const options = await listTextCandidates(client, frameNodeId, RECRUIT_SEARCH_SELECTORS.ageCustomOption, {
     includeBox: true
   });
-  const option = chooseRecruitTextCandidate(options, { label, match: "exact" });
+  const visibleOptions = options.filter((item) => item.visible);
+  const option = chooseRecruitTextCandidate(visibleOptions, { label, match: "exact" });
   if (!option) {
     throw new Error(`Recruit age custom option was not found: ${label}`);
   }
@@ -2274,10 +2441,11 @@ async function selectRecruitAgeCustomDropdownValue(client, frameNodeId, {
     dropdown_index: dropdownIndex,
     requested_value: value,
     selected_label: option.text,
-    dropdown_node_id: dropdownNodeId,
+    dropdown_node_id: dropdown.node_id,
     option_node_id: option.node_id,
     open_box: openBox,
     box,
+    discovered_dropdowns: triggerState.discovered,
     discovered_options: summarizeTextCandidates(options, 40)
   };
 }
@@ -2320,12 +2488,7 @@ export async function setRecruitAge(client, frameNodeId, age) {
     };
   }
 
-  const customClick = await clickFirstNodeBySelectors(
-    client,
-    frameNodeId,
-    RECRUIT_SEARCH_SELECTORS.ageCustom,
-    { optional: false, scrollIntoView: true }
-  );
+  const customOpen = await openRecruitAgeCustomControls(client, frameNodeId);
   const before = await readRecruitAgeCustomState(client, frameNodeId);
   const fixedBefore = await readRecruitAgeFixedOptionState(client, frameNodeId);
   const selected = [];
@@ -2354,7 +2517,7 @@ export async function setRecruitAge(client, frameNodeId, age) {
       min: filter.min,
       max: filter.max
     },
-    custom_click: customClick,
+    custom_open: customOpen,
     before,
     after,
     fixed_options_before: fixedBefore,

package/src/index.js

@@ -882,7 +882,7 @@ function createRunInputSchema() {
           },
           skip_recent_colleague_contacted: {
             type: "boolean",
-            description: "默认 true。推荐页跳过近14天同事沟通过的人选；搜索页使用近30天未和同事交换简历过滤。"
+            description: "推荐页默认 true，用于跳过近14天同事沟通过的人选。搜索页请使用 recruit 工具的 filter_recent_colleague_contacted。"
           },
           criteria: { type: "string" },
           job: { type: "string" },
@@ -1390,7 +1390,12 @@ function createCompactRunInputSchema() {
             description: "用户完成总确认后传 true"
           },
           skip_recent_colleague_contacted_confirmed: { type: "boolean" },
-          skip_recent_colleague_contacted_value: { type: "boolean" }
+          skip_recent_colleague_contacted_value: { type: "boolean" },
+          filter_recent_colleague_contacted_confirmed: { type: "boolean" },
+          filter_recent_colleague_contacted_value: {
+            type: "boolean",
+            description: "是否过滤近期已被同事触达的人选；true 会开启搜索页“近30天未和同事交换简历”。"
+          }
         },
         additionalProperties: true
       },
@@ -1413,6 +1418,17 @@ function createCompactRunInputSchema() {
           gender: { type: "string" },
           recent_not_view: { type: "string" },
           skip_recent_colleague_contacted: { type: "boolean" },
+          filter_recent_colleague_contacted: {
+            type: "boolean",
+            description: "是否过滤近期已被同事触达的人选；true 会开启搜索页“近30天未和同事交换简历”；false 会确保该过滤取消。"
+          },
+          recent_colleague_contacted: {
+            anyOf: [
+              { type: "boolean" },
+              { type: "string" }
+            ],
+            description: "同事近期触达筛选别名；可填 不限/不过滤/过滤。"
+          },
           criteria: { type: "string" },
           target_count: targetCountSchema,
           post_action: { type: "string", enum: ["greet", "none"] },

package/src/recruit-mcp.js

@@ -712,6 +712,11 @@ export function createRecruitPipelineInputSchema() {
           criteria_value: { type: "string" },
           skip_recent_colleague_contacted_confirmed: { type: "boolean" },
           skip_recent_colleague_contacted_value: { type: "boolean" },
+          filter_recent_colleague_contacted_confirmed: { type: "boolean" },
+          filter_recent_colleague_contacted_value: {
+            type: "boolean",
+            description: "是否过滤近期已被同事触达的人选；true 会开启搜索页“近30天未和同事交换简历”。"
+          },
           post_action_confirmed: { type: "boolean" },
           post_action_value: {
             type: "string",
@@ -744,7 +749,18 @@ export function createRecruitPipelineInputSchema() {
           filter_recent_viewed: { type: "boolean" },
           skip_recent_colleague_contacted: {
             type: "boolean",
-            description: "默认 true。搜索页使用 Boss 的“近30天未和同事交换简历”过滤；false 会确保该过滤取消。"
+            description: "显式 true 时开启 Boss 的“近30天未和同事交换简历”过滤；false 会确保该过滤取消；未提供时不默认开启。"
+          },
+          filter_recent_colleague_contacted: {
+            type: "boolean",
+            description: "是否过滤近期已被同事触达的人选；true 会开启搜索页“近30天未和同事交换简历”；false 会确保该过滤取消。"
+          },
+          recent_colleague_contacted: {
+            anyOf: [
+              { type: "boolean" },
+              { type: "string" }
+            ],
+            description: "同事近期触达筛选别名；可填 不限/不过滤/过滤。"
           },
           recent_not_view: {
             anyOf: [
@@ -1049,7 +1065,7 @@ function buildRequiredConfirmations(parsedResult) {
   if (parsedResult.needs_search_params_confirmation) confirmations.push("search_params");
   if (parsedResult.needs_keyword_confirmation) confirmations.push("keyword");
   if (parsedResult.needs_recent_viewed_filter_confirmation) confirmations.push("filter_recent_viewed");
-  if (parsedResult.needs_skip_recent_colleague_contacted_confirmation) confirmations.push("skip_recent_colleague_contacted");
+  if (parsedResult.needs_skip_recent_colleague_contacted_confirmation) confirmations.push("filter_recent_colleague_contacted");
   if (parsedResult.needs_criteria_confirmation) confirmations.push("criteria");
   if (parsedResult.has_unresolved_missing_fields) confirmations.push("missing_fields_or_defaults");
   if ((parsedResult.suspicious_fields || []).length) confirmations.push("suspicious_fields");