@reconcrap/boss-recommend-mcp 2.1.14 → 2.1.15

package/src/index.js

@@ -1074,7 +1074,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 +1133,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 +1222,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"] }
@@ -1546,7 +1552,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 +1609,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 +1742,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 +1817,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/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"
       ]
     };
   }

package/src/recruit-mcp.js

@@ -697,11 +697,25 @@ export function createRecruitPipelineInputSchema() {
       },
       confirmation: {
         type: "object",
+        description: "搜索页确认状态。新流程建议在用户看过总览后传 final_confirmed=true；逐字段 *_confirmed 为兼容旧调用保留。",
         properties: {
+          final_confirmed: {
+            type: "boolean",
+            description: "用户已确认包含岗位、关键词、城市、学历/院校、是否过滤已看、criteria、目标人数、动作和 restLevel 的总览。"
+          },
+          job_confirmed: { type: "boolean" },
+          job_value: { type: "string" },
           keyword_confirmed: { type: "boolean" },
           keyword_value: { type: "string" },
           search_params_confirmed: { type: "boolean" },
           criteria_confirmed: { type: "boolean" },
+          criteria_value: { type: "string" },
+          post_action_confirmed: { type: "boolean" },
+          post_action_value: {
+            type: "string",
+            enum: ["greet", "none"]
+          },
+          max_greet_count_value: { type: "integer", minimum: 1 },
           use_default_for_missing: { type: "boolean" }
         },
         additionalProperties: false
@@ -709,18 +723,188 @@ export function createRecruitPipelineInputSchema() {
       overrides: {
         type: "object",
         properties: {
+          job: { type: "string" },
+          job_title: { type: "string" },
+          selected_job: { type: "string" },
           city: { type: "string" },
-          degree: { type: "string" },
+          degree: {
+            anyOf: [
+              { type: "string" },
+              { type: "array", items: { type: "string" }, minItems: 1 }
+            ]
+          },
+          degrees: {
+            anyOf: [
+              { type: "string" },
+              { type: "array", items: { type: "string" }, minItems: 1 }
+            ]
+          },
           filter_recent_viewed: { type: "boolean" },
+          recent_not_view: {
+            anyOf: [
+              { type: "boolean" },
+              { type: "string" }
+            ]
+          },
           schools: {
             anyOf: [
               { type: "array", items: { type: "string" } },
               { type: "string" }
             ]
           },
+          school_tag: {
+            anyOf: [
+              { type: "array", items: { type: "string" } },
+              { type: "string" }
+            ]
+          },
+          school_tags: {
+            anyOf: [
+              { type: "array", items: { type: "string" } },
+              { type: "string" }
+            ]
+          },
+          experience: {
+            anyOf: [
+              { type: "string" },
+              {
+                type: "object",
+                properties: {
+                  mode: { type: "string" },
+                  label: { type: "string" },
+                  option: { type: "string" },
+                  start: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  end: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  min: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  max: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  from: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  to: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  start_value: { type: "integer" },
+                  end_value: { type: "integer" }
+                },
+                additionalProperties: false
+              }
+            ]
+          },
+          experiences: {
+            anyOf: [
+              { type: "array", items: { type: "string" } },
+              { type: "string" }
+            ]
+          },
+          experience_range: {
+            anyOf: [
+              { type: "string" },
+              {
+                type: "object",
+                properties: {
+                  mode: { type: "string" },
+                  label: { type: "string" },
+                  option: { type: "string" },
+                  start: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  end: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  min: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  max: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  from: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  to: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  start_value: { type: "integer" },
+                  end_value: { type: "integer" }
+                },
+                additionalProperties: false
+              }
+            ]
+          },
+          experience_start: {
+            anyOf: [
+              { type: "string" },
+              { type: "integer" }
+            ]
+          },
+          experience_end: {
+            anyOf: [
+              { type: "string" },
+              { type: "integer" }
+            ]
+          },
+          gender: { type: "string" },
+          age: {
+            anyOf: [
+              { type: "string" },
+              {
+                type: "object",
+                properties: {
+                  mode: { type: "string" },
+                  label: { type: "string" },
+                  option: { type: "string" },
+                  min: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  max: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  start: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  end: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  from: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  to: { anyOf: [{ type: "string" }, { type: "integer" }] }
+                },
+                additionalProperties: false
+              }
+            ]
+          },
+          ages: {
+            anyOf: [
+              { type: "array", items: { type: "string" } },
+              { type: "string" }
+            ]
+          },
+          age_range: {
+            anyOf: [
+              { type: "string" },
+              {
+                type: "object",
+                properties: {
+                  mode: { type: "string" },
+                  label: { type: "string" },
+                  option: { type: "string" },
+                  min: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  max: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  start: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  end: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  from: { anyOf: [{ type: "string" }, { type: "integer" }] },
+                  to: { anyOf: [{ type: "string" }, { type: "integer" }] }
+                },
+                additionalProperties: false
+              }
+            ]
+          },
+          age_min: {
+            anyOf: [
+              { type: "string" },
+              { type: "integer" }
+            ]
+          },
+          age_max: {
+            anyOf: [
+              { type: "string" },
+              { type: "integer" }
+            ]
+          },
+          min_age: {
+            anyOf: [
+              { type: "string" },
+              { type: "integer" }
+            ]
+          },
+          max_age: {
+            anyOf: [
+              { type: "string" },
+              { type: "integer" }
+            ]
+          },
           keyword: { type: "string" },
           target_count: { type: "integer", minimum: 1 },
-          criteria: { type: "string" }
+          criteria: { type: "string" },
+          post_action: {
+            type: "string",
+            enum: ["greet", "none"]
+          },
+          max_greet_count: { type: "integer", minimum: 1 }
         },
         additionalProperties: false
       },
@@ -805,6 +989,29 @@ export function createRecruitPipelineInputSchema() {
         type: "integer",
         minimum: 0,
         description: "候选人之间的延迟；live pause/resume 测试可增大它"
+      },
+      execute_post_action: {
+        type: "boolean",
+        description: "可选，是否实际执行通过后的 search 后置动作 greet；默认 true"
+      },
+      dry_run_post_action: {
+        type: "boolean",
+        description: "可选，只验证 search 打招呼动作发现/配额/可点击路径，不实际点击"
+      },
+      action_timeout_ms: {
+        type: "integer",
+        minimum: 1000,
+        description: "可选，等待详情页 greet 控件出现的超时时间"
+      },
+      action_interval_ms: {
+        type: "integer",
+        minimum: 100,
+        description: "可选，轮询详情页 greet 控件的间隔"
+      },
+      action_after_click_delay_ms: {
+        type: "integer",
+        minimum: 0,
+        description: "可选，点击 greet 后等待页面状态稳定的时间"
       }
     },
     required: ["instruction"],
@@ -1183,6 +1390,9 @@ function getRunOptions(args, parsed, session, configResolution = null) {
   const targetCount = parsePositiveInteger(args.max_candidates, parsed.screenParams.target_count || 10);
   const screeningMode = normalizeScreeningModeArg(args);
   const humanBehavior = resolveHumanBehaviorForRun(args, configResolution?.config || {});
+  const executePostAction = args.dry_run_post_action === true
+    ? false
+    : args.execute_post_action !== false;
   return {
     client: session.client,
     targetUrl: RECRUIT_TARGET_URL,
@@ -1215,6 +1425,14 @@ function getRunOptions(args, parsed, session, configResolution = null) {
     imageOutputDir: resolveBossConfiguredOutputDir("", getRecruitRunsDir()),
     humanRestEnabled: humanBehavior.restEnabled,
     humanBehavior,
+    postAction: parsed.screenParams?.post_action || "none",
+    maxGreetCount: Number.isInteger(parsed.screenParams?.max_greet_count)
+      ? parsed.screenParams.max_greet_count
+      : null,
+    executePostAction,
+    actionTimeoutMs: parsePositiveInteger(args.action_timeout_ms, slowLive ? 12000 : 8000),
+    actionIntervalMs: parsePositiveInteger(args.action_interval_ms, 400),
+    actionAfterClickDelayMs: parseNonNegativeInteger(args.action_after_click_delay_ms, 900),
     name: "mcp-recruit-pipeline-run"
   };
 }
@@ -1364,7 +1582,14 @@ async function startRecruitPipelineRunInternal(args = {}, { workspaceRoot = "",
     run: persistedStarted,
     poll_after_sec: DEFAULT_RECRUIT_POLL_AFTER_SEC,
     review: parsed.review,
-    message: "Recruit pipeline run started through shared CDP-only recruit service."
+    message: parsed.screenParams?.post_action === "greet"
+      ? `Recruit pipeline run started through shared CDP-only recruit service with post_action=greet${args.dry_run_post_action === true ? " in dry-run mode" : ""}.`
+      : "Recruit pipeline run started through shared CDP-only recruit service.",
+    post_action: {
+      requested: parsed.screenParams?.post_action || "none",
+      execute_post_action: args.dry_run_post_action === true ? false : args.execute_post_action !== false,
+      max_greet_count: Number.isInteger(parsed.screenParams?.max_greet_count) ? parsed.screenParams.max_greet_count : null
+    }
   };
 }