@reconcrap/boss-recommend-mcp 2.1.15 → 2.1.16

package/src/domains/recruit/search.js

@@ -699,7 +699,8 @@ export function normalizeRecruitSearchParams(searchParams = {}) {
     keyword: normalizeText(searchParams.keyword) || DEFAULT_RECRUIT_KEYWORD,
     filter_recent_viewed: typeof searchParams.filter_recent_viewed === "boolean"
       ? searchParams.filter_recent_viewed
-      : null
+      : null,
+    skip_recent_colleague_contacted: searchParams.skip_recent_colleague_contacted !== false
   };
   const job = normalizeText(searchParams.job || searchParams.job_title || searchParams.selected_job);
   if (job) normalized.job = job;
@@ -720,6 +721,7 @@ export function buildRecruitSearchApplicationStepNames(searchParams = {}) {
   if (normalized.gender) steps.push("gender");
   if (normalized.age) steps.push("age");
   if (typeof normalized.filter_recent_viewed === "boolean") steps.push("recent_viewed");
+  if (typeof normalized.skip_recent_colleague_contacted === "boolean") steps.push("exchange_resume");
   // Keyword is the final filter before executing the search.
   steps.push("keyword", "search");
   return steps;
@@ -739,7 +741,8 @@ export function hasRecruitSearchParams(searchParams = {}) {
     keyword: normalizeText(searchParams.keyword),
     filter_recent_viewed: typeof searchParams.filter_recent_viewed === "boolean"
       ? searchParams.filter_recent_viewed
-      : null
+      : null,
+    skip_recent_colleague_contacted: searchParams.skip_recent_colleague_contacted !== false
   };
   return Boolean(
     job
@@ -751,6 +754,7 @@ export function hasRecruitSearchParams(searchParams = {}) {
     || age
     || normalized.keyword
     || typeof normalized.filter_recent_viewed === "boolean"
+    || typeof normalized.skip_recent_colleague_contacted === "boolean"
   );
 }
 
@@ -2365,19 +2369,23 @@ export async function setRecruitAge(client, frameNodeId, age) {
   };
 }
 
-export async function setRecruitRecentViewedFilter(client, frameNodeId, enabled) {
+async function setRecruitCheckboxFilter(client, frameNodeId, enabled, {
+  selectors,
+  label,
+  errorLabel
+} = {}) {
   if (typeof enabled !== "boolean") {
     return { applied: false, reason: "not_requested" };
   }
   const { candidate, candidates } = await findTextCandidate(
     client,
     frameNodeId,
-    RECRUIT_SEARCH_SELECTORS.recentViewedLabel,
-    "过滤近14天查看",
+    selectors,
+    label,
     { match: "contains" }
   );
   if (!candidate) {
-    throw new Error("Recruit recent-viewed filter was not found");
+    throw new Error(`${errorLabel || "Recruit checkbox filter"} was not found`);
   }
 
   let box = null;
@@ -2406,6 +2414,22 @@ export async function setRecruitRecentViewedFilter(client, frameNodeId, enabled)
   };
 }
 
+export async function setRecruitRecentViewedFilter(client, frameNodeId, enabled) {
+  return setRecruitCheckboxFilter(client, frameNodeId, enabled, {
+    selectors: RECRUIT_SEARCH_SELECTORS.recentViewedLabel,
+    label: "过滤近14天查看",
+    errorLabel: "Recruit recent-viewed filter"
+  });
+}
+
+export async function setRecruitExchangeResumeFilter(client, frameNodeId, enabled) {
+  return setRecruitCheckboxFilter(client, frameNodeId, enabled, {
+    selectors: RECRUIT_SEARCH_SELECTORS.exchangeResumeLabel,
+    label: "近30天未和同事交换简历",
+    errorLabel: "Recruit exchange-resume filter"
+  });
+}
+
 async function openRecruitCityPicker(client, frameNodeId, {
   settleMs = 350
 } = {}) {
@@ -3004,6 +3028,16 @@ export async function applyRecruitSearchParams(client, {
           normalizedSearchParams.filter_recent_viewed
         )
       });
+    } else if (stepName === "exchange_resume") {
+      const exchangeFilterRoots = await getRecruitRoots(client);
+      steps.push({
+        step: "exchange_resume",
+        result: await setRecruitExchangeResumeFilter(
+          client,
+          exchangeFilterRoots.iframe.documentNodeId,
+          normalizedSearchParams.skip_recent_colleague_contacted
+        )
+      });
     }
   }
 

package/src/index.js

@@ -800,11 +800,13 @@ function createRunInputSchema() {
             enum: ["不限", "男", "女"]
           },
           recent_not_view_confirmed: { type: "boolean" },
-          recent_not_view_value: {
-            type: "string",
-            enum: ["不限", "近14天没有"]
-          },
-          criteria_confirmed: { type: "boolean" },
+          recent_not_view_value: {
+            type: "string",
+            enum: ["不限", "近14天没有"]
+          },
+          skip_recent_colleague_contacted_confirmed: { type: "boolean" },
+          skip_recent_colleague_contacted_value: { type: "boolean" },
+          criteria_confirmed: { type: "boolean" },
           target_count_confirmed: { type: "boolean" },
           target_count_value: {
             type: "integer",
@@ -874,11 +876,15 @@ function createRunInputSchema() {
             type: "string",
             enum: ["不限", "男", "女"]
           },
-          recent_not_view: {
-            type: "string",
-            enum: ["不限", "近14天没有"]
-          },
-          criteria: { type: "string" },
+          recent_not_view: {
+            type: "string",
+            enum: ["不限", "近14天没有"]
+          },
+          skip_recent_colleague_contacted: {
+            type: "boolean",
+            description: "默认 true。推荐页跳过近14天同事沟通过的人选；搜索页使用近30天未和同事交换简历过滤。"
+          },
+          criteria: { type: "string" },
           job: { type: "string" },
           target_count: { type: "integer", minimum: 1 },
           max_greet_count: { type: "integer", minimum: 1 },
@@ -1382,7 +1388,9 @@ function createCompactRunInputSchema() {
           final_confirmed: {
             type: "boolean",
             description: "用户完成总确认后传 true"
-          }
+          },
+          skip_recent_colleague_contacted_confirmed: { type: "boolean" },
+          skip_recent_colleague_contacted_value: { type: "boolean" }
         },
         additionalProperties: true
       },
@@ -1404,6 +1412,7 @@ function createCompactRunInputSchema() {
           },
           gender: { type: "string" },
           recent_not_view: { type: "string" },
+          skip_recent_colleague_contacted: { type: "boolean" },
           criteria: { type: "string" },
           target_count: targetCountSchema,
           post_action: { type: "string", enum: ["greet", "none"] },

package/src/parser.js

@@ -302,6 +302,16 @@ function normalizeRecentNotView(value) {
   return RECENT_NOT_VIEW_OPTIONS.includes(normalized) ? normalized : null;
 }
 
+function normalizeBooleanOverride(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "number") return value !== 0;
+  const normalized = normalizeText(value).toLowerCase();
+  if (!normalized) return null;
+  if (["true", "yes", "y", "1", "on", "enable", "enabled", "需要", "是", "开启"].includes(normalized)) return true;
+  if (["false", "no", "n", "0", "off", "disable", "disabled", "不需要", "否", "关闭"].includes(normalized)) return false;
+  return null;
+}
+
 function normalizePostAction(value) {
   const normalized = normalizeText(value).toLowerCase();
   if (!normalized) return null;
@@ -658,6 +668,16 @@ export function parseRecommendInstruction({ instruction, confirmation, overrides
     || ""
   );
   const pageScopeResolution = resolvePageScope({ instruction: text, confirmation, overrides, finalConfirmed });
+  const hasSkipRecentColleagueOverride = Object.prototype.hasOwnProperty.call(
+    overrides || {},
+    "skip_recent_colleague_contacted"
+  );
+  const confirmationSkipRecentColleagueContacted = normalizeBooleanOverride(
+    confirmation?.skip_recent_colleague_contacted_value
+  );
+  const skipRecentColleagueContacted = hasSkipRecentColleagueOverride
+    ? normalizeBooleanOverride(overrides?.skip_recent_colleague_contacted) ?? true
+    : confirmationSkipRecentColleagueContacted ?? true;
 
   const inferredSchoolTag = detectedSchoolTags.length > 0
     ? sortSchoolTagSelections(detectedSchoolTags)
@@ -680,7 +700,9 @@ export function parseRecommendInstruction({ instruction, confirmation, overrides
     criteria: criteriaResolution.raw || criteriaResolution.normalized || null,
     target_count: null,
     post_action: null,
-    max_greet_count: null
+    max_greet_count: null,
+    skip_recent_colleague_contacted: skipRecentColleagueContacted,
+    colleague_contact_window_days: 14
   };
   const targetCountResolution = resolveTargetCount({ instruction: text, confirmation, overrides, finalConfirmed });
   screenParams.target_count = targetCountResolution.target_count;
@@ -722,6 +744,12 @@ export function parseRecommendInstruction({ instruction, confirmation, overrides
   const needs_post_action_confirmation = postActionResolution.needs_post_action_confirmation;
   const needs_max_greet_count_confirmation = maxGreetCountResolution.needs_max_greet_count_confirmation;
   const needs_page_confirmation = pageScopeResolution.needs_page_confirmation;
+  const needs_skip_recent_colleague_contacted_confirmation = (
+    !finalConfirmed
+    && !hasSkipRecentColleagueOverride
+    && confirmationSkipRecentColleagueContacted === null
+    && confirmation?.skip_recent_colleague_contacted_confirmed !== true
+  );
   const pending_questions = [];
 
   if (needs_page_confirmation) {
@@ -829,6 +857,18 @@ export function parseRecommendInstruction({ instruction, confirmation, overrides
     });
   }
 
+  if (needs_skip_recent_colleague_contacted_confirmation) {
+    pending_questions.push({
+      field: "skip_recent_colleague_contacted",
+      question: "是否跳过最近已被同事联系过的人选？推荐页会检查近14天同事沟通记录。",
+      value: true,
+      options: [
+        { label: "跳过（推荐）", value: true },
+        { label: "不跳过", value: false }
+      ]
+    });
+  }
+
   return {
     searchParams,
     screenParams,
@@ -844,6 +884,7 @@ export function parseRecommendInstruction({ instruction, confirmation, overrides
     needs_post_action_confirmation,
     needs_max_greet_count_confirmation,
     needs_page_confirmation,
+    needs_skip_recent_colleague_contacted_confirmation,
     criteria_normalized: criteriaResolution.normalized,
     proposed_target_count: targetCountResolution.proposed_target_count,
     proposed_post_action: postActionResolution.proposed_post_action,
@@ -860,7 +901,9 @@ export function parseRecommendInstruction({ instruction, confirmation, overrides
         criteria_normalized: criteriaResolution.normalized,
         target_count: targetCountResolution.proposed_target_count,
         post_action: postActionResolution.proposed_post_action,
-        max_greet_count: maxGreetCountResolution.proposed_max_greet_count
+        max_greet_count: maxGreetCountResolution.proposed_max_greet_count,
+        skip_recent_colleague_contacted: screenParams.skip_recent_colleague_contacted,
+        colleague_contact_window_days: screenParams.colleague_contact_window_days
       },
       current_page_scope: pageScopeResolution.page_scope,
       current_search_params: searchParams,

package/src/recommend-mcp.js

@@ -1384,6 +1384,7 @@ function buildRequiredConfirmations(parsed, args = {}) {
   if (parsed.needs_criteria_confirmation) required.push("criteria");
   if (parsed.needs_target_count_confirmation) required.push("target_count");
   if (parsed.needs_post_action_confirmation) required.push("post_action");
+  if (parsed.needs_skip_recent_colleague_contacted_confirmation) required.push("skip_recent_colleague_contacted");
   if ((parsed.suspicious_fields || []).length) required.push("suspicious_fields");
 
   const confirmation = args.confirmation || {};
@@ -1591,14 +1592,16 @@ function normalizeRecommendStartInput(args = {}, parsed, configResolution = null
     targetCount,
     job: normalizeText(confirmation.job_value || overrides.job || ""),
     pageScope: parsed.page_scope || "recommend",
-    filter: buildRecommendFilter(parsed, args),
-    postAction: parsed.screenParams?.post_action || "none",
-    maxGreetCount: Number.isInteger(parsed.screenParams?.max_greet_count)
-      ? parsed.screenParams.max_greet_count
-      : null,
-    screeningMode: normalizeScreeningModeArg(args)
-  };
-}
+    filter: buildRecommendFilter(parsed, args),
+    postAction: parsed.screenParams?.post_action || "none",
+    maxGreetCount: Number.isInteger(parsed.screenParams?.max_greet_count)
+      ? parsed.screenParams.max_greet_count
+      : null,
+    skipRecentColleagueContacted: parsed.screenParams?.skip_recent_colleague_contacted !== false,
+    colleagueContactWindowDays: 14,
+    screeningMode: normalizeScreeningModeArg(args)
+  };
+}
 
 function getRunOptions(args, parsed, normalized, session, configResolution = null) {
   const slowLive = args.slow_live === true;
@@ -1636,8 +1639,8 @@ function getRunOptions(args, parsed, normalized, session, configResolution = nul
     executePostAction,
     actionTimeoutMs: parsePositiveInteger(args.action_timeout_ms, slowLive ? 12000 : 8000),
     actionIntervalMs: parsePositiveInteger(args.action_interval_ms, 500),
-    actionAfterClickDelayMs: parseNonNegativeInteger(args.action_after_click_delay_ms, slowLive ? 1200 : 900),
-    screeningMode: normalized.screeningMode,
+    actionAfterClickDelayMs: parseNonNegativeInteger(args.action_after_click_delay_ms, slowLive ? 1200 : 900),
+    screeningMode: normalized.screeningMode,
     llmConfig: normalized.screeningMode === "llm" && configResolution?.ok ? {
       ...configResolution.config
     } : null,
@@ -1655,6 +1658,8 @@ function getRunOptions(args, parsed, normalized, session, configResolution = nul
     imageOutputDir: resolveBossConfiguredOutputDir("", getRunsDir()),
     humanRestEnabled: humanBehavior.restEnabled,
     humanBehavior,
+    skipRecentColleagueContacted: normalized.skipRecentColleagueContacted,
+    colleagueContactWindowDays: normalized.colleagueContactWindowDays,
     name: "mcp-recommend-pipeline-run",
     parsed
   };

package/src/recruit-mcp.js

@@ -710,6 +710,8 @@ export function createRecruitPipelineInputSchema() {
           search_params_confirmed: { type: "boolean" },
           criteria_confirmed: { type: "boolean" },
           criteria_value: { type: "string" },
+          skip_recent_colleague_contacted_confirmed: { type: "boolean" },
+          skip_recent_colleague_contacted_value: { type: "boolean" },
           post_action_confirmed: { type: "boolean" },
           post_action_value: {
             type: "string",
@@ -740,6 +742,10 @@ export function createRecruitPipelineInputSchema() {
             ]
           },
           filter_recent_viewed: { type: "boolean" },
+          skip_recent_colleague_contacted: {
+            type: "boolean",
+            description: "默认 true。搜索页使用 Boss 的“近30天未和同事交换简历”过滤；false 会确保该过滤取消。"
+          },
           recent_not_view: {
             anyOf: [
               { type: "boolean" },
@@ -1043,6 +1049,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_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");
@@ -1110,6 +1117,7 @@ function evaluateRecruitPipelineGate(parsed) {
   if (
     parsed.needs_keyword_confirmation
     || parsed.needs_recent_viewed_filter_confirmation
+    || parsed.needs_skip_recent_colleague_contacted_confirmation
     || parsed.needs_criteria_confirmation
     || parsed.needs_search_params_confirmation
     || (parsed.suspicious_fields || []).length > 0