@reconcrap/boss-recommend-mcp 2.1.14 → 2.1.16

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 },
@@ -1074,7 +1080,7 @@ function createBossChatStartInputSchema({ requireFullInput = false } = {}) {
       },
       criteria: {
         type: "string",
-        description: "boss-chat 的筛选 criteria"
+        description: "boss-chat 的筛选 criteria；可留空，留空时进入 collect_cv 模式：不触发 LLM 筛选，只向没有在线/附件简历的人选求简历"
       },
       greeting_text: {
         type: "string",
@@ -1133,8 +1139,8 @@ function createBossChatStartInputSchema({ requireFullInput = false } = {}) {
       },
       screening_mode: {
         type: "string",
-        enum: ["llm", "deterministic"],
-        description: "筛选引擎；默认 llm。deterministic 仅限 debug_test_mode=true"
+        enum: ["llm", "deterministic", "collect_cv"],
+        description: "筛选引擎；默认 llm。有 criteria 时 deterministic 仅限 debug_test_mode=true；criteria 留空时自动 collect_cv"
       },
       debug_test_mode: {
         type: "boolean",
@@ -1222,11 +1228,17 @@ function createBossChatStartInputSchema({ requireFullInput = false } = {}) {
         start_from: "unread",
         target_count: 20,
         criteria: "请筛选 20 位符合条件的人选"
+      },
+      {
+        job: "530272634",
+        start_from: "all",
+        target_count: "all",
+        criteria: ""
       }
     ]
   };
   if (requireFullInput) {
-    schema.required = ["job", "start_from", "criteria"];
+    schema.required = ["job", "start_from"];
     schema.anyOf = [
       { required: ["target_count"] },
       { required: ["targetCount"] }
@@ -1376,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
       },
@@ -1398,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"] },
@@ -1546,7 +1561,7 @@ function createToolsSchema(toolset = getConfiguredMcpToolset()) {
     },
     {
       name: TOOL_BOSS_CHAT_START_RUN,
-      description: "异步启动一次 boss-chat/chat-only 任务。必须一次性提供 job、start_from、target_count、criteria；若用户选择扫到底/不限/全部候选人，必须字面传 target_count=\"all\"。严禁改用 start_recommend_pipeline_run。",
+      description: "异步启动一次 boss-chat/chat-only 任务。必须一次性提供 job、start_from、target_count；criteria 可留空，留空时自动收集缺失简历而不触发 LLM 筛选。若用户选择扫到底/不限/全部候选人，必须字面传 target_count=\"all\"。严禁改用 start_recommend_pipeline_run。",
       inputSchema: createBossChatStartInputSchema({ requireFullInput: true })
     },
     {
@@ -1603,17 +1618,17 @@ function createToolsSchema(toolset = getConfiguredMcpToolset()) {
     },
     {
       name: TOOL_LIST_RECOMMEND_JOBS,
-      description: "CDP-only 读取 Boss 推荐页岗位下拉框，返回所有可用岗位完整名称，方便 recommend/推荐页 cron/一次性任务提前填写 job 参数。不会启动筛选任务。chat-only、未读、全部聊天、求简历任务严禁调用本工具，必须用 list_boss_chat_jobs 或 prepare_boss_chat_run。",
+      description: "CDP-only 读取 Boss 推荐页岗位下拉框，返回所有可用岗位完整名称，方便 recommend/推荐页 cron/一次性任务提前填写 job 参数。不会启动筛选任务。chat-only、未读、全部聊天、求简历任务严禁调用本工具，必须用 list_boss_chat_jobs 或 prepare_boss_chat_run。搜索页/search/recruit、/web/chat/search 任务也严禁调用本工具，必须用 boss-recruit/run_recruit_pipeline 或 boss-recruit/start_recruit_pipeline_run。",
       inputSchema: createListRecommendJobsInputSchema()
     },
     {
       name: TOOL_RUN_RECOMMEND,
-      description: "立即通过原生 MCP 启动 Boss 推荐页筛选。它是 start_recommend_pipeline_run 的短别名；用户已经确认并要现在启动时，优先调用本工具，不需要先调用 prepare_recommend_pipeline_run。必须作为 MCP tool call 调用，禁止通过 terminal/shell/run_command/PowerShell/CLI/manual JSON-RPC 代替，也不要用 schedule_recommend_pipeline_run 冒充立即启动。",
+      description: "立即通过原生 MCP 启动 Boss 推荐页筛选。仅用于 boss-recommend/推荐页，不用于搜索页。搜索页/search/recruit、/web/chat/search 任务必须调用 boss-recruit/run_recruit_pipeline 或 boss-recruit/start_recruit_pipeline_run。它是 start_recommend_pipeline_run 的短别名；用户已经确认并要现在启动时，优先调用本工具，不需要先调用 prepare_recommend_pipeline_run。必须作为 MCP tool call 调用，禁止通过 terminal/shell/run_command/PowerShell/CLI/manual JSON-RPC 代替，也不要用 schedule_recommend_pipeline_run 冒充立即启动。",
       inputSchema: runInputSchema
     },
     {
       name: TOOL_START_RUN,
-      description: "立即通过原生 MCP 异步启动 Boss 推荐页流水线（含同步门禁预检）。用户已经确认并要现在启动时，优先调用本工具或 run_recommend，不需要先调用 prepare_recommend_pipeline_run。必须作为 MCP tool call 调用，禁止通过 terminal/shell/run_command/PowerShell/CLI/manual JSON-RPC 代替，也不要用 schedule_recommend_pipeline_run 冒充立即启动。",
+      description: "立即通过原生 MCP 异步启动 Boss 推荐页流水线（含同步门禁预检）。仅用于 boss-recommend/推荐页，不用于搜索页。搜索页/search/recruit、/web/chat/search 任务必须调用 boss-recruit/start_recruit_pipeline_run 或 boss-recruit/run_recruit_pipeline。用户已经确认并要现在启动时，优先调用本工具或 run_recommend，不需要先调用 prepare_recommend_pipeline_run。必须作为 MCP tool call 调用，禁止通过 terminal/shell/run_command/PowerShell/CLI/manual JSON-RPC 代替，也不要用 schedule_recommend_pipeline_run 冒充立即启动。",
       inputSchema: runInputSchema
     },
     {
@@ -1736,12 +1751,12 @@ function createToolsSchema(toolset = getConfiguredMcpToolset()) {
     },
     {
       name: TOOL_RUN_RECRUIT_PIPELINE,
-      description: "兼容 Boss recruit 入口：默认 async；sync 模式会等待终态。所有浏览器动作走共享 CDP-only recruit service。",
+      description: "Boss 搜索页/search/recruit 专用入口；Trae-CN split-server 下应调用 boss-recruit/run_recruit_pipeline。默认 async，sync 模式会等待终态。必须提供搜索页岗位 job（关键词输入框旁边的岗位选择）和 keyword/search intent；不要改用 boss-recommend/run_recommend 或 boss-recommend/start_recommend_pipeline_run。所有浏览器动作走共享 CDP-only recruit service。",
       inputSchema: createRecruitPipelineInputSchema()
     },
     {
       name: TOOL_START_RECRUIT_PIPELINE_RUN,
-      description: "异步启动 Boss recruit 流水线；先完成参数/criteria/default 确认门禁，再连接 Chrome search 页执行。",
+      description: "异步启动 Boss 搜索页/search/recruit 流水线；Trae-CN split-server 下应调用 boss-recruit/start_recruit_pipeline_run。必须提供搜索页岗位 job（关键词输入框旁边的岗位选择）和 keyword/search intent；先完成参数/criteria/default 确认门禁，再连接 Chrome search 页执行。不要改用 boss-recommend/start_recommend_pipeline_run。",
       inputSchema: createRecruitPipelineInputSchema()
     },
     {
@@ -1811,8 +1826,8 @@ function validateBossChatStartArgs(args) {
     }
   }
   if (Object.prototype.hasOwnProperty.call(args, "criteria")) {
-    if (typeof args.criteria !== "string" || !normalizeText(args.criteria)) {
-      return "criteria must be a non-empty string when provided";
+    if (typeof args.criteria !== "string") {
+      return "criteria must be a string when provided";
     }
   }
   if (

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

@@ -102,7 +102,71 @@ function findRouteSignals(text, patterns = []) {
   return signals;
 }
 
+function detectExplicitNonRecommendScope(args = {}) {
+  const fields = [
+    ["page_scope", args.page_scope],
+    ["confirmation.page_value", args.confirmation?.page_value],
+    ["overrides.page_scope", args.overrides?.page_scope],
+    ["target_url_includes", args.target_url_includes],
+    ["overrides.target_url_includes", args.overrides?.target_url_includes]
+  ];
+  for (const [field, value] of fields) {
+    const normalized = normalizeText(value).toLowerCase();
+    if (!normalized) continue;
+    if (/\/web\/chat\/index|chat\/index/.test(normalized) || ["chat", "chat-page", "boss-chat"].includes(normalized)) {
+      return {
+        domain: "chat",
+        signals: [`${field}:chat`],
+        text: normalized
+      };
+    }
+    if (/\/web\/chat\/search|chat\/search/.test(normalized) || ["search", "search-page", "recruit", "recruit-page", "boss-recruit"].includes(normalized)) {
+      return {
+        domain: "search",
+        signals: [`${field}:search`],
+        text: normalized
+      };
+    }
+  }
+  return null;
+}
+
+function detectRecruitShapedRecommendArgs(args = {}) {
+  const checks = [
+    ["keyword", args.keyword],
+    ["search_keyword", args.search_keyword],
+    ["city", args.city],
+    ["confirmation.keyword_value", args.confirmation?.keyword_value],
+    ["confirmation.keyword_confirmed", args.confirmation?.keyword_confirmed],
+    ["confirmation.search_params_confirmed", args.confirmation?.search_params_confirmed],
+    ["overrides.keyword", args.overrides?.keyword],
+    ["overrides.search_keyword", args.overrides?.search_keyword],
+    ["overrides.city", args.overrides?.city],
+    ["overrides.filter_recent_viewed", args.overrides?.filter_recent_viewed],
+    ["overrides.schools", args.overrides?.schools],
+    ["overrides.school_tags", args.overrides?.school_tags]
+  ];
+  const signals = [];
+  for (const [field, value] of checks) {
+    if (value === undefined || value === null) continue;
+    if (Array.isArray(value) && value.length === 0) continue;
+    if (typeof value === "string" && !normalizeText(value)) continue;
+    signals.push(field);
+  }
+  if (!signals.length) return null;
+  return {
+    domain: "search",
+    signals: signals.map((field) => `${field}:recruit_arg`),
+    text: signals.join(" ")
+  };
+}
+
 function detectNonRecommendRoute(args = {}) {
+  const explicitRoute = detectExplicitNonRecommendScope(args);
+  if (explicitRoute) return explicitRoute;
+  const recruitArgRoute = detectRecruitShapedRecommendArgs(args);
+  if (recruitArgRoute) return recruitArgRoute;
+
   const text = collectRecommendRouteText(args);
   if (!text) return null;
   const chatSignals = findRouteSignals(text, [
@@ -126,6 +190,7 @@ function detectNonRecommendRoute(args = {}) {
   const searchSignals = findRouteSignals(text, [
     { label: "search-only", pattern: /\bsearch[-\s]?only\b/i },
     { label: "search page", pattern: /\bsearch\s+page\b/i },
+    { label: "search keyword", pattern: /搜索关键词|关键词|keyword/i },
     { label: "recruit pipeline", pattern: /\brecruit\s+pipeline\b/i },
     { label: "chat/search", pattern: /(?:\/web\/chat\/search|chat\/search)/i },
     { label: "搜索页", pattern: /搜索页/ },
@@ -148,16 +213,18 @@ function buildWrongRecommendRouteResponse(route) {
       route_guard: true,
       error: {
         code: "WRONG_BOSS_TOOL_FOR_CHAT",
-        message: "This request is explicitly chat-only/chat-page work. Do not use recommend tools. Use boss_chat_health_check, then list_boss_chat_jobs or prepare_boss_chat_run, then start_boss_chat_run.",
+        message: "This request is explicitly chat-only/chat-page work. In Trae-CN split toolsets, call boss-chat/boss_chat_health_check, then boss-chat/list_boss_chat_jobs or boss-chat/prepare_boss_chat_run, then boss-chat/start_boss_chat_run. Do not call boss-recommend tools.",
         retryable: false
       },
       detected_domain: "chat",
       detected_signals: route.signals || [],
+      wrong_server: "boss-recommend",
+      recommended_server: "boss-chat",
       recommended_tool_sequence: [
-        "boss_chat_health_check",
-        "list_boss_chat_jobs",
-        "prepare_boss_chat_run",
-        "start_boss_chat_run"
+        "boss-chat/boss_chat_health_check",
+        "boss-chat/list_boss_chat_jobs",
+        "boss-chat/prepare_boss_chat_run",
+        "boss-chat/start_boss_chat_run"
       ]
     };
   }
@@ -167,14 +234,16 @@ function buildWrongRecommendRouteResponse(route) {
       route_guard: true,
       error: {
         code: "WRONG_BOSS_TOOL_FOR_SEARCH",
-        message: "This request is explicitly search/recruit-page work. Do not use recommend tools. Use run_recruit_pipeline or start_recruit_pipeline_run.",
+        message: "This request is explicitly search/recruit-page work. In Trae-CN split toolsets, call boss-recruit/run_recruit_pipeline or boss-recruit/start_recruit_pipeline_run. Do not call boss-recommend/run_recommend or boss-recommend/start_recommend_pipeline_run.",
         retryable: false
       },
       detected_domain: "search",
       detected_signals: route.signals || [],
+      wrong_server: "boss-recommend",
+      recommended_server: "boss-recruit",
       recommended_tool_sequence: [
-        "run_recruit_pipeline",
-        "start_recruit_pipeline_run"
+        "boss-recruit/run_recruit_pipeline",
+        "boss-recruit/start_recruit_pipeline_run"
       ]
     };
   }
@@ -1315,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 || {};
@@ -1522,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;
@@ -1567,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,
@@ -1586,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
   };