@reconcrap/boss-recommend-mcp 2.1.21 → 2.1.22

package/src/recommend-mcp.js

@@ -44,21 +44,21 @@ import {
   parseRecommendInstruction
 } from "./parser.js";
 import { getRunsDir } from "./run-state.js";
-import {
-  resolveBossConfiguredOutputDir,
-  resolveHumanBehaviorForRun,
-  resolveBossScreeningConfig
-} from "./chat-runtime-config.js";
+import {
+  resolveBossConfiguredOutputDir,
+  resolveHumanBehaviorForRun,
+  resolveBossScreeningConfig
+} from "./chat-runtime-config.js";
 import { DEFAULT_MAX_IMAGE_PAGES } from "./core/cv-acquisition/index.js";
 
 const DEFAULT_RECOMMEND_HOST = "127.0.0.1";
-const DEFAULT_RECOMMEND_PORT = 9222;
-const DEFAULT_RECOMMEND_POLL_AFTER_SEC = 10;
-const STATUS_METHOD_LOG_TAIL_LIMIT = 25;
-const TARGET_COUNT_SEMANTICS = "target_count means candidates that pass screening; scan continues until that many candidates pass or the list ends";
-const RUN_MODE_ASYNC = "async";
-const REST_LEVEL_OPTIONS = ["low", "medium", "high"];
-const REST_LEVEL_SET = new Set(REST_LEVEL_OPTIONS);
+const DEFAULT_RECOMMEND_PORT = 9222;
+const DEFAULT_RECOMMEND_POLL_AFTER_SEC = 10;
+const STATUS_METHOD_LOG_TAIL_LIMIT = 25;
+const TARGET_COUNT_SEMANTICS = "target_count means candidates that pass screening; scan continues until that many candidates pass or the list ends";
+const RUN_MODE_ASYNC = "async";
+const REST_LEVEL_OPTIONS = ["low", "medium", "high"];
+const REST_LEVEL_SET = new Set(REST_LEVEL_OPTIONS);
 
 const TERMINAL_STATUSES = new Set([
   RUN_STATUS_COMPLETED,
@@ -76,188 +76,188 @@ let recommendRunService = createRecommendRunService({
 });
 const recommendRunMeta = new Map();
 
-function normalizeText(value) {
-  return String(value || "").replace(/\s+/g, " ").trim();
-}
-
-function collectRecommendRouteText(args = {}) {
-  return normalizeText([
-    args.instruction,
-    args.criteria,
-    args.target_url_includes,
-    args.page_scope,
-    args.confirmation?.page_value,
-    args.confirmation?.job_value,
-    args.overrides?.criteria,
-    args.overrides?.page_scope,
-    args.overrides?.job,
-    args.overrides?.target_url_includes
-  ].filter((value) => value !== undefined && value !== null).join(" "));
-}
-
-function findRouteSignals(text, patterns = []) {
-  const signals = [];
-  for (const { label, pattern } of patterns) {
-    if (pattern.test(text)) signals.push(label);
-  }
-  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, [
-    { label: "chat-only", pattern: /\bchat[-\s]?only\b/i },
-    { label: "boss-chat", pattern: /\bboss[-\s]?chat\b/i },
-    { label: "chat page", pattern: /\bchat\s+page\b/i },
-    { label: "chat/index", pattern: /(?:\/web\/chat\/index|chat\/index)/i },
-    { label: "聊天页", pattern: /聊天页/ },
-    { label: "聊天列表", pattern: /聊天列表/ },
-    { label: "未读", pattern: /未读/ },
-    { label: "全部聊天", pattern: /全部聊天|所有聊天/ },
-    { label: "求简历", pattern: /求简历|索要简历|要简历|在线简历/ }
-  ]);
-  if (chatSignals.length) {
-    return {
-      domain: "chat",
-      signals: chatSignals,
-      text
-    };
-  }
-  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: /搜索页/ },
-    { label: "招聘搜索", pattern: /招聘搜索/ }
-  ]);
-  if (searchSignals.length) {
-    return {
-      domain: "search",
-      signals: searchSignals,
-      text
-    };
-  }
-  return null;
-}
-
-function buildWrongRecommendRouteResponse(route) {
-  if (route?.domain === "chat") {
-    return {
-      status: "FAILED",
-      route_guard: true,
-      error: {
-        code: "WRONG_BOSS_TOOL_FOR_CHAT",
-        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/boss_chat_health_check",
-        "boss-chat/list_boss_chat_jobs",
-        "boss-chat/prepare_boss_chat_run",
-        "boss-chat/start_boss_chat_run"
-      ]
-    };
-  }
-  if (route?.domain === "search") {
-    return {
-      status: "FAILED",
-      route_guard: true,
-      error: {
-        code: "WRONG_BOSS_TOOL_FOR_SEARCH",
-        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: [
-        "boss-recruit/run_recruit_pipeline",
-        "boss-recruit/start_recruit_pipeline_run"
-      ]
-    };
-  }
-  return null;
-}
-
-function guardRecommendRoute(args = {}) {
-  return buildWrongRecommendRouteResponse(detectNonRecommendRoute(args));
-}
-
-function parsePositiveInteger(raw, fallback) {
-  const parsed = Number.parseInt(String(raw || ""), 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+function normalizeText(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+
+function collectRecommendRouteText(args = {}) {
+  return normalizeText([
+    args.instruction,
+    args.criteria,
+    args.target_url_includes,
+    args.page_scope,
+    args.confirmation?.page_value,
+    args.confirmation?.job_value,
+    args.overrides?.criteria,
+    args.overrides?.page_scope,
+    args.overrides?.job,
+    args.overrides?.target_url_includes
+  ].filter((value) => value !== undefined && value !== null).join(" "));
+}
+
+function findRouteSignals(text, patterns = []) {
+  const signals = [];
+  for (const { label, pattern } of patterns) {
+    if (pattern.test(text)) signals.push(label);
+  }
+  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, [
+    { label: "chat-only", pattern: /\bchat[-\s]?only\b/i },
+    { label: "boss-chat", pattern: /\bboss[-\s]?chat\b/i },
+    { label: "chat page", pattern: /\bchat\s+page\b/i },
+    { label: "chat/index", pattern: /(?:\/web\/chat\/index|chat\/index)/i },
+    { label: "聊天页", pattern: /聊天页/ },
+    { label: "聊天列表", pattern: /聊天列表/ },
+    { label: "未读", pattern: /未读/ },
+    { label: "全部聊天", pattern: /全部聊天|所有聊天/ },
+    { label: "求简历", pattern: /求简历|索要简历|要简历|在线简历/ }
+  ]);
+  if (chatSignals.length) {
+    return {
+      domain: "chat",
+      signals: chatSignals,
+      text
+    };
+  }
+  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: /搜索页/ },
+    { label: "招聘搜索", pattern: /招聘搜索/ }
+  ]);
+  if (searchSignals.length) {
+    return {
+      domain: "search",
+      signals: searchSignals,
+      text
+    };
+  }
+  return null;
+}
+
+function buildWrongRecommendRouteResponse(route) {
+  if (route?.domain === "chat") {
+    return {
+      status: "FAILED",
+      route_guard: true,
+      error: {
+        code: "WRONG_BOSS_TOOL_FOR_CHAT",
+        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/boss_chat_health_check",
+        "boss-chat/list_boss_chat_jobs",
+        "boss-chat/prepare_boss_chat_run",
+        "boss-chat/start_boss_chat_run"
+      ]
+    };
+  }
+  if (route?.domain === "search") {
+    return {
+      status: "FAILED",
+      route_guard: true,
+      error: {
+        code: "WRONG_BOSS_TOOL_FOR_SEARCH",
+        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: [
+        "boss-recruit/run_recruit_pipeline",
+        "boss-recruit/start_recruit_pipeline_run"
+      ]
+    };
+  }
+  return null;
+}
+
+function guardRecommendRoute(args = {}) {
+  return buildWrongRecommendRouteResponse(detectNonRecommendRoute(args));
+}
+
+function parsePositiveInteger(raw, fallback) {
+  const parsed = Number.parseInt(String(raw || ""), 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
 }
 
 function parseNonNegativeInteger(raw, fallback) {
@@ -303,23 +303,23 @@ function resolveRecommendDetailLimit(args = {}, normalized = {}) {
   return requested;
 }
 
-function methodSummary(methodLog = []) {
+function methodSummary(methodLog = []) {
   const summary = {};
   for (const entry of methodLog || []) {
     summary[entry.method] = (summary[entry.method] || 0) + 1;
   }
-  return summary;
-}
-
-function compactMethodLogForStatus(methodLog = []) {
-  if (!Array.isArray(methodLog)) return [];
-  return methodLog.slice(-STATUS_METHOD_LOG_TAIL_LIMIT).map((entry) => ({
-    method: normalizeText(entry?.method || entry || ""),
-    at: normalizeText(entry?.at || "")
-  }));
-}
-
-function clonePlain(value, fallback = null) {
+  return summary;
+}
+
+function compactMethodLogForStatus(methodLog = []) {
+  if (!Array.isArray(methodLog)) return [];
+  return methodLog.slice(-STATUS_METHOD_LOG_TAIL_LIMIT).map((entry) => ({
+    method: normalizeText(entry?.method || entry || ""),
+    at: normalizeText(entry?.at || "")
+  }));
+}
+
+function clonePlain(value, fallback = null) {
   try {
     return value === undefined ? fallback : JSON.parse(JSON.stringify(value));
   } catch {
@@ -382,10 +382,12 @@ function readJsonFile(filePath) {
 
 function recommendSearchParamsForCsv(searchParams = {}) {
   return {
-    school_tag: Object.prototype.hasOwnProperty.call(searchParams, "school_tag") ? searchParams.school_tag : "不限",
-    degree: Object.prototype.hasOwnProperty.call(searchParams, "degree") ? searchParams.degree : "不限",
-    gender: Object.prototype.hasOwnProperty.call(searchParams, "gender") ? searchParams.gender : "不限",
-    recent_not_view: Object.prototype.hasOwnProperty.call(searchParams, "recent_not_view") ? searchParams.recent_not_view : "不限"
+    school_tag: Object.prototype.hasOwnProperty.call(searchParams, "school_tag") ? searchParams.school_tag : "不限",
+    degree: Object.prototype.hasOwnProperty.call(searchParams, "degree") ? searchParams.degree : "不限",
+    gender: Object.prototype.hasOwnProperty.call(searchParams, "gender") ? searchParams.gender : "不限",
+    recent_not_view: Object.prototype.hasOwnProperty.call(searchParams, "recent_not_view") ? searchParams.recent_not_view : "不限",
+    current_city_only: Object.prototype.hasOwnProperty.call(searchParams, "current_city_only") ? searchParams.current_city_only : false,
+    activity_level: Object.prototype.hasOwnProperty.call(searchParams, "activity_level") ? searchParams.activity_level : "不限"
   };
 }
 
@@ -424,10 +426,12 @@ function selectedRecommendJobForCsv(meta = {}, snapshot = {}) {
 function buildRecommendCsvInputRows(snapshot = {}, meta = {}) {
   const { context, confirmation, overrides, followUp, shared } = getSnapshotRequestContext(snapshot);
   const searchParams = recommendSearchParamsForCsv(meta.parsed?.searchParams || {
-    school_tag: overrides.school_tag ?? confirmation.school_tag_value,
-    degree: overrides.degree ?? confirmation.degree_value,
-    gender: overrides.gender ?? confirmation.gender_value,
-    recent_not_view: overrides.recent_not_view ?? confirmation.recent_not_view_value
+    school_tag: overrides.school_tag ?? confirmation.school_tag_value,
+    degree: overrides.degree ?? confirmation.degree_value,
+    gender: overrides.gender ?? confirmation.gender_value,
+    recent_not_view: overrides.recent_not_view ?? confirmation.recent_not_view_value,
+    current_city_only: overrides.current_city_only ?? false,
+    activity_level: overrides.activity_level ?? "不限"
   });
   const parsedScreenParams = meta.parsed?.screenParams || {};
   const screenParams = {
@@ -486,7 +490,7 @@ function secondsBetween(startedAt, endedAt) {
   return Math.max(1, Math.round((endMs - startMs) / 1000));
 }
 
-function normalizeLegacyProgress(progress = {}, summary = null) {
+function normalizeLegacyProgress(progress = {}, summary = null) {
   const processed = Number.isInteger(progress.processed)
     ? progress.processed
     : Number.isInteger(summary?.processed)
@@ -511,146 +515,146 @@ function normalizeLegacyProgress(progress = {}, summary = null) {
     skipped: Number.isInteger(progress.skipped) ? progress.skipped : Math.max(processed - passed, 0),
     greet_count: Number.isInteger(progress.greet_count) ? progress.greet_count : 0,
     post_action_clicked: Number.isInteger(progress.post_action_clicked) ? progress.post_action_clicked : 0
-  };
-}
-
-const STATUS_COUNT_KEYS = [
-  "processed",
-  "screened",
-  "detail_opened",
-  "passed",
-  "skipped",
-  "llm_screened",
-  "greet_count",
-  "post_action_clicked",
-  "image_capture_failed",
-  "detail_open_failed",
-  "transient_recovered",
-  "colleague_contact_checked",
-  "recent_colleague_contact_skipped",
-  "colleague_contact_panel_missing",
-  "context_recoveries",
-  "human_rest_count",
-  "human_rest_ms",
-  "card_count",
-  "refresh_rounds"
-];
-
-function compactPositiveInteger(value, fallback = null) {
-  return Number.isInteger(value) && value >= 0 ? value : fallback;
-}
-
-function compactSmallRecord(value, fallback = null) {
-  const record = plainRecord(value);
-  if (!Object.keys(record).length) return fallback;
-  return clonePlain(record, fallback);
-}
-
-function compactRecommendSummaryForStatus(summary) {
-  if (!summary || typeof summary !== "object" || Array.isArray(summary)) return null;
-  const compact = {
-    domain: normalizeText(summary.domain || "recommend") || "recommend"
-  };
-  for (const key of STATUS_COUNT_KEYS) {
-    if (Number.isInteger(summary[key])) compact[key] = summary[key];
-  }
-  if (summary.target_url) compact.target_url = normalizeText(summary.target_url);
-  if (summary.list_end_reason) compact.list_end_reason = normalizeText(summary.list_end_reason);
-  if (Array.isArray(summary.results)) {
-    compact.results_count = summary.results.length;
-  } else if (Number.isInteger(summary.results_count)) {
-    compact.results_count = summary.results_count;
-  }
-  if (Array.isArray(summary.refresh_attempts)) {
-    compact.refresh_attempt_count = summary.refresh_attempts.length;
-  }
-  if (Array.isArray(summary.context_recoveries)) {
-    compact.context_recovery_count = summary.context_recoveries.length;
-  } else if (Number.isInteger(summary.context_recoveries)) {
-    compact.context_recoveries = summary.context_recoveries;
-  }
-  if (summary.job_selection) compact.job_selection = compactSmallRecord(summary.job_selection);
-  if (summary.page_scope) compact.page_scope = compactSmallRecord(summary.page_scope);
-  if (summary.filter) compact.filter = compactSmallRecord(summary.filter);
-  if (summary.candidate_list) {
-    const candidateList = plainRecord(summary.candidate_list);
-    compact.candidate_list = {
-      total_count: compactPositiveInteger(candidateList.total_count ?? candidateList.card_count, null),
-      visible_count: compactPositiveInteger(candidateList.visible_count, null),
-      list_end_reason: normalizeText(candidateList.list_end_reason || "")
-    };
-  }
-  if (summary.viewport_health?.stats) {
-    compact.viewport_health = {
-      stats: clonePlain(summary.viewport_health.stats, {})
-    };
-  }
-  if (summary.human_behavior) {
-    compact.human_behavior = {
-      enabled: summary.human_behavior.enabled === true,
-      profile: normalizeText(summary.human_behavior.profile || ""),
-      restLevel: normalizeText(summary.human_behavior.restLevel || summary.human_behavior.rest_level || "")
-    };
-  }
-  if (summary.human_rest) {
-    const humanRest = plainRecord(summary.human_rest);
-    compact.human_rest = {
-      enabled: humanRest.enabled === true,
-      restLevel: normalizeText(humanRest.restLevel || humanRest.rest_level || ""),
-      rest_count: compactPositiveInteger(humanRest.rest_count ?? humanRest.count, null),
-      total_pause_ms: compactPositiveInteger(humanRest.total_pause_ms ?? humanRest.pause_ms, null)
-    };
-  }
-  return compact;
-}
-
-function compactRecommendCheckpointForStatus(checkpoint) {
-  if (!checkpoint || typeof checkpoint !== "object" || Array.isArray(checkpoint)) return {};
-  const compact = {};
-  if (checkpoint.updatedAt || checkpoint.updated_at) {
-    compact.updatedAt = normalizeText(checkpoint.updatedAt || checkpoint.updated_at);
-  }
-  if (Array.isArray(checkpoint.results)) {
-    compact.results_count = checkpoint.results.length;
-  } else if (Number.isInteger(checkpoint.results_count)) {
-    compact.results_count = checkpoint.results_count;
-  }
-  for (const key of STATUS_COUNT_KEYS) {
-    if (Number.isInteger(checkpoint[key])) compact[key] = checkpoint[key];
-  }
-  return compact;
-}
-
-function compactRecommendResultForStatus(result) {
-  if (!result || typeof result !== "object" || Array.isArray(result)) return result || null;
-  const compact = {
-    ...result
-  };
-  if (Array.isArray(result.results)) {
-    compact.results_count = result.results.length;
-    compact.results_available = result.results.length > 0;
-  } else if (Number.isInteger(result.results_count)) {
-    compact.results_count = result.results_count;
-    compact.results_available = result.results_available === true || result.results_count > 0;
-  }
-  delete compact.results;
-  return compact;
-}
-
-export function compactRecommendRunForStatus(run) {
-  if (!run || typeof run !== "object" || Array.isArray(run)) return run || null;
-  const compact = {
-    ...run
-  };
-  if (compact.result) compact.result = compactRecommendResultForStatus(compact.result);
-  if (compact.summary) compact.summary = compactRecommendSummaryForStatus(compact.summary);
-  if (compact.checkpoint) compact.checkpoint = compactRecommendCheckpointForStatus(compact.checkpoint);
-  return compact;
-}
-
-function completionReason(status) {
-  if (status === RUN_STATUS_COMPLETED) return "completed";
-  if (status === RUN_STATUS_CANCELED) return "canceled_by_user";
+  };
+}
+
+const STATUS_COUNT_KEYS = [
+  "processed",
+  "screened",
+  "detail_opened",
+  "passed",
+  "skipped",
+  "llm_screened",
+  "greet_count",
+  "post_action_clicked",
+  "image_capture_failed",
+  "detail_open_failed",
+  "transient_recovered",
+  "colleague_contact_checked",
+  "recent_colleague_contact_skipped",
+  "colleague_contact_panel_missing",
+  "context_recoveries",
+  "human_rest_count",
+  "human_rest_ms",
+  "card_count",
+  "refresh_rounds"
+];
+
+function compactPositiveInteger(value, fallback = null) {
+  return Number.isInteger(value) && value >= 0 ? value : fallback;
+}
+
+function compactSmallRecord(value, fallback = null) {
+  const record = plainRecord(value);
+  if (!Object.keys(record).length) return fallback;
+  return clonePlain(record, fallback);
+}
+
+function compactRecommendSummaryForStatus(summary) {
+  if (!summary || typeof summary !== "object" || Array.isArray(summary)) return null;
+  const compact = {
+    domain: normalizeText(summary.domain || "recommend") || "recommend"
+  };
+  for (const key of STATUS_COUNT_KEYS) {
+    if (Number.isInteger(summary[key])) compact[key] = summary[key];
+  }
+  if (summary.target_url) compact.target_url = normalizeText(summary.target_url);
+  if (summary.list_end_reason) compact.list_end_reason = normalizeText(summary.list_end_reason);
+  if (Array.isArray(summary.results)) {
+    compact.results_count = summary.results.length;
+  } else if (Number.isInteger(summary.results_count)) {
+    compact.results_count = summary.results_count;
+  }
+  if (Array.isArray(summary.refresh_attempts)) {
+    compact.refresh_attempt_count = summary.refresh_attempts.length;
+  }
+  if (Array.isArray(summary.context_recoveries)) {
+    compact.context_recovery_count = summary.context_recoveries.length;
+  } else if (Number.isInteger(summary.context_recoveries)) {
+    compact.context_recoveries = summary.context_recoveries;
+  }
+  if (summary.job_selection) compact.job_selection = compactSmallRecord(summary.job_selection);
+  if (summary.page_scope) compact.page_scope = compactSmallRecord(summary.page_scope);
+  if (summary.filter) compact.filter = compactSmallRecord(summary.filter);
+  if (summary.candidate_list) {
+    const candidateList = plainRecord(summary.candidate_list);
+    compact.candidate_list = {
+      total_count: compactPositiveInteger(candidateList.total_count ?? candidateList.card_count, null),
+      visible_count: compactPositiveInteger(candidateList.visible_count, null),
+      list_end_reason: normalizeText(candidateList.list_end_reason || "")
+    };
+  }
+  if (summary.viewport_health?.stats) {
+    compact.viewport_health = {
+      stats: clonePlain(summary.viewport_health.stats, {})
+    };
+  }
+  if (summary.human_behavior) {
+    compact.human_behavior = {
+      enabled: summary.human_behavior.enabled === true,
+      profile: normalizeText(summary.human_behavior.profile || ""),
+      restLevel: normalizeText(summary.human_behavior.restLevel || summary.human_behavior.rest_level || "")
+    };
+  }
+  if (summary.human_rest) {
+    const humanRest = plainRecord(summary.human_rest);
+    compact.human_rest = {
+      enabled: humanRest.enabled === true,
+      restLevel: normalizeText(humanRest.restLevel || humanRest.rest_level || ""),
+      rest_count: compactPositiveInteger(humanRest.rest_count ?? humanRest.count, null),
+      total_pause_ms: compactPositiveInteger(humanRest.total_pause_ms ?? humanRest.pause_ms, null)
+    };
+  }
+  return compact;
+}
+
+function compactRecommendCheckpointForStatus(checkpoint) {
+  if (!checkpoint || typeof checkpoint !== "object" || Array.isArray(checkpoint)) return {};
+  const compact = {};
+  if (checkpoint.updatedAt || checkpoint.updated_at) {
+    compact.updatedAt = normalizeText(checkpoint.updatedAt || checkpoint.updated_at);
+  }
+  if (Array.isArray(checkpoint.results)) {
+    compact.results_count = checkpoint.results.length;
+  } else if (Number.isInteger(checkpoint.results_count)) {
+    compact.results_count = checkpoint.results_count;
+  }
+  for (const key of STATUS_COUNT_KEYS) {
+    if (Number.isInteger(checkpoint[key])) compact[key] = checkpoint[key];
+  }
+  return compact;
+}
+
+function compactRecommendResultForStatus(result) {
+  if (!result || typeof result !== "object" || Array.isArray(result)) return result || null;
+  const compact = {
+    ...result
+  };
+  if (Array.isArray(result.results)) {
+    compact.results_count = result.results.length;
+    compact.results_available = result.results.length > 0;
+  } else if (Number.isInteger(result.results_count)) {
+    compact.results_count = result.results_count;
+    compact.results_available = result.results_available === true || result.results_count > 0;
+  }
+  delete compact.results;
+  return compact;
+}
+
+export function compactRecommendRunForStatus(run) {
+  if (!run || typeof run !== "object" || Array.isArray(run)) return run || null;
+  const compact = {
+    ...run
+  };
+  if (compact.result) compact.result = compactRecommendResultForStatus(compact.result);
+  if (compact.summary) compact.summary = compactRecommendSummaryForStatus(compact.summary);
+  if (compact.checkpoint) compact.checkpoint = compactRecommendCheckpointForStatus(compact.checkpoint);
+  return compact;
+}
+
+function completionReason(status) {
+  if (status === RUN_STATUS_COMPLETED) return "completed";
+  if (status === RUN_STATUS_CANCELED) return "canceled_by_user";
   if (status === RUN_STATUS_FAILED) return "failed";
   if (status === RUN_STATUS_PAUSED) return "paused";
   return null;
@@ -663,9 +667,9 @@ function normalizeErrorText(error = {}) {
   ].join(" "));
 }
 
-function classifyRecommendRecovery(error = {}) {
-  const text = normalizeErrorText(error);
-  if (!text) return null;
+function classifyRecommendRecovery(error = {}) {
+  const text = normalizeErrorText(error);
+  if (!text) return null;
   if (/BOSS_LOGIN_REQUIRED/i.test(text)) return "login_required";
   if (/Could not find node with given id|No node with given id|Node is detached|Cannot find node|DETAIL_STALE_NODE|IMAGE_CAPTURE_STALE_NODE/i.test(text)) {
     return "transient_stale_dom";
@@ -676,13 +680,13 @@ function classifyRecommendRecovery(error = {}) {
   if (/(?:aborted|abort|timeout|timed out|fetch failed|socket|network|ECONNRESET|ETIMEDOUT|EAI_AGAIN)/i.test(text)) {
     return "transient_network_or_llm";
   }
-  return null;
-}
-
-function isCancelShutdownError(error = {}) {
-  const text = normalizeErrorText(error);
-  return /socket hang up|ECONNREFUSED|ECONNRESET|WebSocket is not open|Target closed|Session closed|Connection closed|RUN_PROCESS_EXITED|DETACHED_WORKER|RUN_WORKER/i.test(text);
-}
+  return null;
+}
+
+function isCancelShutdownError(error = {}) {
+  const text = normalizeErrorText(error);
+  return /socket hang up|ECONNREFUSED|ECONNRESET|WebSocket is not open|Target closed|Session closed|Connection closed|RUN_PROCESS_EXITED|DETACHED_WORKER|RUN_WORKER/i.test(text);
+}
 
 function buildConstrainedAgentRecovery(snapshot = {}, meta = {}, artifacts = null) {
   const error = snapshot?.error || snapshot?.result?.error || null;
@@ -828,14 +832,14 @@ function buildLegacyRecommendResult(snapshot) {
       effective_scope: meta.normalized?.pageScope || meta.parsed?.page_scope || "recommend"
     },
     search_params: clonePlain(meta.parsed?.searchParams || {}, {}),
-    screen_params: clonePlain(meta.parsed?.screenParams || {}, {}),
-    target_count_semantics: TARGET_COUNT_SEMANTICS,
-    error: snapshot.error || null,
-    recovery: buildConstrainedAgentRecovery(snapshot, meta, artifacts),
-    results_count: resultRows.length,
-    results_available: resultRows.length > 0
-  };
-}
+    screen_params: clonePlain(meta.parsed?.screenParams || {}, {}),
+    target_count_semantics: TARGET_COUNT_SEMANTICS,
+    error: snapshot.error || null,
+    recovery: buildConstrainedAgentRecovery(snapshot, meta, artifacts),
+    results_count: resultRows.length,
+    results_available: resultRows.length > 0
+  };
+}
 
 function normalizeRunSnapshot(snapshot) {
   if (!snapshot) return null;
@@ -858,12 +862,12 @@ function normalizeRunSnapshot(snapshot) {
     follow_up: clonePlain(metaArgs.follow_up ?? snapshotContext.follow_up ?? null, null),
     target_count_semantics: TARGET_COUNT_SEMANTICS
   };
-  return {
-    ...snapshot,
-    checkpoint: compactRecommendCheckpointForStatus(snapshot.checkpoint),
-    summary: compactRecommendSummaryForStatus(summary),
-    progress,
-    run_id: snapshot.runId,
+  return {
+    ...snapshot,
+    checkpoint: compactRecommendCheckpointForStatus(snapshot.checkpoint),
+    summary: compactRecommendSummaryForStatus(summary),
+    progress,
+    run_id: snapshot.runId,
     mode: RUN_MODE_ASYNC,
     state: snapshot.status,
     stage: snapshot.phase,
@@ -900,31 +904,31 @@ function normalizeRunSnapshot(snapshot) {
   };
 }
 
-function mergePersistedControlRequest(normalized, existing) {
-  const control = {
-    ...(normalized?.control || {})
-  };
-  const existingControl = plainRecord(existing?.control);
-  if (!normalized) return control;
-  if (TERMINAL_STATUSES.has(normalized.state)) {
-    if (
-      normalized.state === RUN_STATUS_FAILED
-      && existingControl.cancel_requested === true
-      && isCancelShutdownError(normalized.error || normalized.result?.error || "")
-    ) {
-      return {
-        ...control,
-        pause_requested: true,
-        pause_requested_at: existingControl.pause_requested_at || control.pause_requested_at || new Date().toISOString(),
-        pause_requested_by: existingControl.pause_requested_by || control.pause_requested_by || "cancel_recommend_pipeline_run",
-        cancel_requested: true
-      };
-    }
-    return control;
-  }
-  if (existingControl.cancel_requested === true) {
-    return {
-      ...control,
+function mergePersistedControlRequest(normalized, existing) {
+  const control = {
+    ...(normalized?.control || {})
+  };
+  const existingControl = plainRecord(existing?.control);
+  if (!normalized) return control;
+  if (TERMINAL_STATUSES.has(normalized.state)) {
+    if (
+      normalized.state === RUN_STATUS_FAILED
+      && existingControl.cancel_requested === true
+      && isCancelShutdownError(normalized.error || normalized.result?.error || "")
+    ) {
+      return {
+        ...control,
+        pause_requested: true,
+        pause_requested_at: existingControl.pause_requested_at || control.pause_requested_at || new Date().toISOString(),
+        pause_requested_by: existingControl.pause_requested_by || control.pause_requested_by || "cancel_recommend_pipeline_run",
+        cancel_requested: true
+      };
+    }
+    return control;
+  }
+  if (existingControl.cancel_requested === true) {
+    return {
+      ...control,
       pause_requested: true,
       pause_requested_at: existingControl.pause_requested_at || control.pause_requested_at || new Date().toISOString(),
       pause_requested_by: existingControl.pause_requested_by || control.pause_requested_by || "cancel_recommend_pipeline_run",
@@ -947,81 +951,81 @@ function mergePersistedControlRequest(normalized, existing) {
       pause_requested_by: null,
       cancel_requested: false
     };
-  }
-  return control;
-}
-
-function cancelErrorFromShutdown(shutdownError = null) {
-  return {
-    code: "PIPELINE_CANCELED",
-    message: "流水线已取消。",
-    retryable: true,
-    shutdown_error: shutdownError || undefined
-  };
-}
-
-function coerceCanceledTerminalSnapshot(normalized, existing) {
-  const existingControl = plainRecord(existing?.control);
-  const shutdownError = normalized?.error || normalized?.result?.error || null;
-  const shouldWrapCanceledShutdown = (
-    normalized
-    && (
-      (
-        normalized.state === RUN_STATUS_FAILED
-        && existingControl.cancel_requested === true
-      )
-      || normalized.state === RUN_STATUS_CANCELED
-    )
-    && isCancelShutdownError(shutdownError || "")
-  );
-  if (
-    !shouldWrapCanceledShutdown
-  ) {
-    return normalized;
-  }
-  const canceledError = cancelErrorFromShutdown(shutdownError);
-  return {
-    ...normalized,
-    state: RUN_STATUS_CANCELED,
-    status: RUN_STATUS_CANCELED,
-    last_message: "流水线已取消；取消收尾时浏览器连接已关闭。",
-    control: {
-      pause_requested: false,
-      pause_requested_at: null,
-      pause_requested_by: null,
-      cancel_requested: false
-    },
-    error: canceledError,
-    result: normalized.result ? {
-      ...normalized.result,
-      status: "CANCELED",
-      completion_reason: "canceled_by_user",
-      error: canceledError
-    } : {
-      status: "CANCELED",
-      completion_reason: "canceled_by_user",
-      error: canceledError,
-      run_id: normalized.run_id,
-      processed_count: normalized.progress?.processed || 0,
-      screened_count: normalized.progress?.screened || normalized.progress?.processed || 0,
-      passed_count: normalized.progress?.passed || 0
-    }
-  };
-}
-
-function persistRecommendRunSnapshot(snapshot, {
-  persistActiveCheckpoint = false
-} = {}) {
-  let normalized = normalizeRunSnapshot(snapshot);
-  if (!normalized?.run_id) return normalized;
-  const artifacts = getRecommendRunArtifacts(normalized.run_id);
-  if (!artifacts) return normalized;
-  const existing = readJsonFile(artifacts.run_state_path);
-  normalized.control = mergePersistedControlRequest(normalized, existing);
-  normalized = coerceCanceledTerminalSnapshot(normalized, existing);
-  if (persistActiveCheckpoint) {
-    persistRecommendCheckpointSnapshot(snapshot);
-  }
+  }
+  return control;
+}
+
+function cancelErrorFromShutdown(shutdownError = null) {
+  return {
+    code: "PIPELINE_CANCELED",
+    message: "流水线已取消。",
+    retryable: true,
+    shutdown_error: shutdownError || undefined
+  };
+}
+
+function coerceCanceledTerminalSnapshot(normalized, existing) {
+  const existingControl = plainRecord(existing?.control);
+  const shutdownError = normalized?.error || normalized?.result?.error || null;
+  const shouldWrapCanceledShutdown = (
+    normalized
+    && (
+      (
+        normalized.state === RUN_STATUS_FAILED
+        && existingControl.cancel_requested === true
+      )
+      || normalized.state === RUN_STATUS_CANCELED
+    )
+    && isCancelShutdownError(shutdownError || "")
+  );
+  if (
+    !shouldWrapCanceledShutdown
+  ) {
+    return normalized;
+  }
+  const canceledError = cancelErrorFromShutdown(shutdownError);
+  return {
+    ...normalized,
+    state: RUN_STATUS_CANCELED,
+    status: RUN_STATUS_CANCELED,
+    last_message: "流水线已取消；取消收尾时浏览器连接已关闭。",
+    control: {
+      pause_requested: false,
+      pause_requested_at: null,
+      pause_requested_by: null,
+      cancel_requested: false
+    },
+    error: canceledError,
+    result: normalized.result ? {
+      ...normalized.result,
+      status: "CANCELED",
+      completion_reason: "canceled_by_user",
+      error: canceledError
+    } : {
+      status: "CANCELED",
+      completion_reason: "canceled_by_user",
+      error: canceledError,
+      run_id: normalized.run_id,
+      processed_count: normalized.progress?.processed || 0,
+      screened_count: normalized.progress?.screened || normalized.progress?.processed || 0,
+      passed_count: normalized.progress?.passed || 0
+    }
+  };
+}
+
+function persistRecommendRunSnapshot(snapshot, {
+  persistActiveCheckpoint = false
+} = {}) {
+  let normalized = normalizeRunSnapshot(snapshot);
+  if (!normalized?.run_id) return normalized;
+  const artifacts = getRecommendRunArtifacts(normalized.run_id);
+  if (!artifacts) return normalized;
+  const existing = readJsonFile(artifacts.run_state_path);
+  normalized.control = mergePersistedControlRequest(normalized, existing);
+  normalized = coerceCanceledTerminalSnapshot(normalized, existing);
+  if (persistActiveCheckpoint) {
+    persistRecommendCheckpointSnapshot(snapshot);
+  }
   const payload = {
     run_id: normalized.run_id,
     mode: normalized.mode,
@@ -1044,59 +1048,59 @@ function persistRecommendRunSnapshot(snapshot, {
     summary: normalized.summary,
     artifacts: normalized.artifacts
   };
-  writeJsonAtomic(artifacts.run_state_path, payload);
-  return normalized;
-}
-
-function patchPersistedRecommendRunControl(runId, controlPatch = {}, {
-  message = ""
-} = {}) {
-  const artifacts = getRecommendRunArtifacts(runId);
-  if (!artifacts) return null;
-  const current = readJsonFile(artifacts.run_state_path);
-  const state = normalizeText(current?.state || current?.status || "");
-  if (!current || TERMINAL_STATUSES.has(state)) return null;
-  const now = new Date().toISOString();
-  const patched = {
-    ...current,
-    updated_at: now,
-    heartbeat_at: current.heartbeat_at || now,
-    last_message: message || current.last_message || "",
-    control: {
-      ...(current.control || {}),
-      ...controlPatch
-    }
-  };
-  writeJsonAtomic(artifacts.run_state_path, patched);
-  return patched;
-}
-
-function reconcilePersistedRecommendRunIfNeeded(persisted) {
-  if (!persisted || typeof persisted !== "object") return persisted;
-  const persistedState = normalizeText(persisted.state || persisted.status);
-  if (TERMINAL_STATUSES.has(persistedState)) return persisted;
+  writeJsonAtomic(artifacts.run_state_path, payload);
+  return normalized;
+}
+
+function patchPersistedRecommendRunControl(runId, controlPatch = {}, {
+  message = ""
+} = {}) {
+  const artifacts = getRecommendRunArtifacts(runId);
+  if (!artifacts) return null;
+  const current = readJsonFile(artifacts.run_state_path);
+  const state = normalizeText(current?.state || current?.status || "");
+  if (!current || TERMINAL_STATUSES.has(state)) return null;
+  const now = new Date().toISOString();
+  const patched = {
+    ...current,
+    updated_at: now,
+    heartbeat_at: current.heartbeat_at || now,
+    last_message: message || current.last_message || "",
+    control: {
+      ...(current.control || {}),
+      ...controlPatch
+    }
+  };
+  writeJsonAtomic(artifacts.run_state_path, patched);
+  return patched;
+}
+
+function reconcilePersistedRecommendRunIfNeeded(persisted) {
+  if (!persisted || typeof persisted !== "object") return persisted;
+  const persistedState = normalizeText(persisted.state || persisted.status);
+  if (TERMINAL_STATUSES.has(persistedState)) return persisted;
   if (isProcessAlive(persisted.pid)) return persisted;
 
-  const runId = normalizeRunId(persisted.run_id || persisted.runId);
-  const artifacts = getRecommendRunArtifacts(runId);
-  const checkpoint = artifacts?.checkpoint_path ? readJsonFile(artifacts.checkpoint_path) : null;
-  const now = new Date().toISOString();
-  const cancelRequested = persisted.control?.cancel_requested === true;
-  const processExitedError = {
-    code: "RUN_PROCESS_EXITED",
-    message: `检测到推荐任务进程已退出（pid=${persisted.pid || "unknown"}）。`,
-    retryable: true
-  };
-  const error = cancelRequested
-    ? cancelErrorFromShutdown(processExitedError)
-    : {
-        ...processExitedError,
-        message: `检测到推荐任务进程已退出（pid=${persisted.pid || "unknown"}），已自动标记为失败。`
-      };
-  return persistRecommendRunSnapshot({
+  const runId = normalizeRunId(persisted.run_id || persisted.runId);
+  const artifacts = getRecommendRunArtifacts(runId);
+  const checkpoint = artifacts?.checkpoint_path ? readJsonFile(artifacts.checkpoint_path) : null;
+  const now = new Date().toISOString();
+  const cancelRequested = persisted.control?.cancel_requested === true;
+  const processExitedError = {
+    code: "RUN_PROCESS_EXITED",
+    message: `检测到推荐任务进程已退出（pid=${persisted.pid || "unknown"}）。`,
+    retryable: true
+  };
+  const error = cancelRequested
+    ? cancelErrorFromShutdown(processExitedError)
+    : {
+        ...processExitedError,
+        message: `检测到推荐任务进程已退出（pid=${persisted.pid || "unknown"}），已自动标记为失败。`
+      };
+  return persistRecommendRunSnapshot({
     runId,
     name: persisted.name || runId,
-    status: cancelRequested ? RUN_STATUS_CANCELED : RUN_STATUS_FAILED,
+    status: cancelRequested ? RUN_STATUS_CANCELED : RUN_STATUS_FAILED,
     phase: persisted.stage || persisted.phase || "recommend:orphaned",
     progress: persisted.progress || {},
     context: persisted.context || {},
@@ -1116,19 +1120,19 @@ function persistRecommendLifecycleSnapshot(snapshot, event = {}) {
   });
 }
 
-function attachMethodEvidence(payload, runId) {
-  const meta = getRecommendRunMeta(runId);
-  const methodLog = meta.methodLog || [];
-  assertNoForbiddenCdpCalls(methodLog);
-  return {
-    ...payload,
-    runtime_evaluate_used: false,
-    method_summary: methodSummary(methodLog),
-    method_log: compactMethodLogForStatus(methodLog),
-    method_log_total: Array.isArray(methodLog) ? methodLog.length : 0,
-    chrome: meta.chrome || null
-  };
-}
+function attachMethodEvidence(payload, runId) {
+  const meta = getRecommendRunMeta(runId);
+  const methodLog = meta.methodLog || [];
+  assertNoForbiddenCdpCalls(methodLog);
+  return {
+    ...payload,
+    runtime_evaluate_used: false,
+    method_summary: methodSummary(methodLog),
+    method_log: compactMethodLogForStatus(methodLog),
+    method_log_total: Array.isArray(methodLog) ? methodLog.length : 0,
+    chrome: meta.chrome || null
+  };
+}
 
 function compactRecommendJobListOption(option, index) {
   const label = normalizeText(option?.label);
@@ -1178,17 +1182,17 @@ async function readRecommendJobOptionsFromSession(session) {
   };
 }
 
-export async function listRecommendJobsTool({ workspaceRoot = "", args = {} } = {}) {
-  const routeGuard = guardRecommendRoute(args);
-  if (routeGuard) {
-    return {
-      ...routeGuard,
-      stage: "recommend_job_list",
-      message: "list_recommend_jobs is recommend-page only. For chat-only job lists, call list_boss_chat_jobs or prepare_boss_chat_run."
-    };
-  }
-  const configResolution = resolveBossScreeningConfig(workspaceRoot);
-  const host = normalizeText(args.host) || DEFAULT_RECOMMEND_HOST;
+export async function listRecommendJobsTool({ workspaceRoot = "", args = {} } = {}) {
+  const routeGuard = guardRecommendRoute(args);
+  if (routeGuard) {
+    return {
+      ...routeGuard,
+      stage: "recommend_job_list",
+      message: "list_recommend_jobs is recommend-page only. For chat-only job lists, call list_boss_chat_jobs or prepare_boss_chat_run."
+    };
+  }
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
+  const host = normalizeText(args.host) || DEFAULT_RECOMMEND_HOST;
   const port = parsePositiveInteger(
     args.port,
     configResolution.ok ? configResolution.config.debugPort : DEFAULT_RECOMMEND_PORT
@@ -1462,146 +1466,146 @@ async function connectRecommendChromeSession({
   };
 }
 
-function parseRecommendPipelineRequest(args = {}) {
-  return parseRecommendInstruction({
-    instruction: args.instruction,
+function parseRecommendPipelineRequest(args = {}) {
+  return parseRecommendInstruction({
+    instruction: args.instruction,
     confirmation: args.confirmation,
     overrides: args.overrides
-  });
-}
-
-function readOwn(source, keys = []) {
-  if (!source || typeof source !== "object" || Array.isArray(source)) return undefined;
-  for (const key of keys) {
-    if (Object.prototype.hasOwnProperty.call(source, key)) return source[key];
-  }
-  return undefined;
-}
-
-function getExplicitRestLevel(args = {}) {
-  const behavior = readOwn(args, ["human_behavior", "humanBehavior"]);
-  const raw = readOwn(behavior, ["restLevel", "rest_level"]);
-  const normalized = normalizeText(raw).toLowerCase();
-  return {
-    raw: raw ?? null,
-    restLevel: REST_LEVEL_SET.has(normalized) ? normalized : null,
-    valid: REST_LEVEL_SET.has(normalized),
-    missing: raw === undefined || raw === null || normalizeText(raw) === ""
-  };
-}
-
-function buildReviewScreenParams(parsed) {
-  return {
-    ...(parsed.screenParams || {}),
-    criteria: parsed.screenParams?.criteria || null,
-    criteria_normalized: parsed.criteria_normalized || null,
-    target_count: parsed.screenParams?.target_count ?? parsed.proposed_target_count ?? null,
-    post_action: parsed.screenParams?.post_action || parsed.proposed_post_action || null,
-    max_greet_count: parsed.screenParams?.max_greet_count ?? parsed.proposed_max_greet_count ?? null
-  };
-}
-
-function buildReviewPageScope(parsed) {
-  return parsed.page_scope || parsed.proposed_page_scope || "recommend";
-}
-
-function buildReviewJob(args = {}) {
-  return normalizeText(args.confirmation?.job_value || args.overrides?.job || "") || null;
-}
-
-function buildScheduleReview(args = {}) {
-  const scheduleRunAt = normalizeText(args.schedule_run_at || args.scheduleRunAt || args.run_at || args.runAt);
-  const scheduleDelayMinutes = args.schedule_delay_minutes ?? args.scheduleDelayMinutes;
-  const scheduleDelaySeconds = args.schedule_delay_seconds ?? args.scheduleDelaySeconds;
-  if (!scheduleRunAt && scheduleDelayMinutes === undefined && scheduleDelaySeconds === undefined) return null;
-  return {
-    schedule_run_at: scheduleRunAt || null,
-    schedule_delay_minutes: scheduleDelayMinutes ?? null,
-    schedule_delay_seconds: scheduleDelaySeconds ?? null
-  };
-}
-
-function buildRequiredConfirmations(parsed, args = {}) {
-  const required = [];
-  if (parsed.needs_page_confirmation) required.push("page_scope");
+  });
+}
+
+function readOwn(source, keys = []) {
+  if (!source || typeof source !== "object" || Array.isArray(source)) return undefined;
+  for (const key of keys) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) return source[key];
+  }
+  return undefined;
+}
+
+function getExplicitRestLevel(args = {}) {
+  const behavior = readOwn(args, ["human_behavior", "humanBehavior"]);
+  const raw = readOwn(behavior, ["restLevel", "rest_level"]);
+  const normalized = normalizeText(raw).toLowerCase();
+  return {
+    raw: raw ?? null,
+    restLevel: REST_LEVEL_SET.has(normalized) ? normalized : null,
+    valid: REST_LEVEL_SET.has(normalized),
+    missing: raw === undefined || raw === null || normalizeText(raw) === ""
+  };
+}
+
+function buildReviewScreenParams(parsed) {
+  return {
+    ...(parsed.screenParams || {}),
+    criteria: parsed.screenParams?.criteria || null,
+    criteria_normalized: parsed.criteria_normalized || null,
+    target_count: parsed.screenParams?.target_count ?? parsed.proposed_target_count ?? null,
+    post_action: parsed.screenParams?.post_action || parsed.proposed_post_action || null,
+    max_greet_count: parsed.screenParams?.max_greet_count ?? parsed.proposed_max_greet_count ?? null
+  };
+}
+
+function buildReviewPageScope(parsed) {
+  return parsed.page_scope || parsed.proposed_page_scope || "recommend";
+}
+
+function buildReviewJob(args = {}) {
+  return normalizeText(args.confirmation?.job_value || args.overrides?.job || "") || null;
+}
+
+function buildScheduleReview(args = {}) {
+  const scheduleRunAt = normalizeText(args.schedule_run_at || args.scheduleRunAt || args.run_at || args.runAt);
+  const scheduleDelayMinutes = args.schedule_delay_minutes ?? args.scheduleDelayMinutes;
+  const scheduleDelaySeconds = args.schedule_delay_seconds ?? args.scheduleDelaySeconds;
+  if (!scheduleRunAt && scheduleDelayMinutes === undefined && scheduleDelaySeconds === undefined) return null;
+  return {
+    schedule_run_at: scheduleRunAt || null,
+    schedule_delay_minutes: scheduleDelayMinutes ?? null,
+    schedule_delay_seconds: scheduleDelaySeconds ?? null
+  };
+}
+
+function buildRequiredConfirmations(parsed, args = {}) {
+  const required = [];
+  if (parsed.needs_page_confirmation) required.push("page_scope");
   if (parsed.needs_filters_confirmation) required.push("filters");
   if (parsed.needs_school_tag_confirmation) required.push("school_tag");
   if (parsed.needs_degree_confirmation) required.push("degree");
   if (parsed.needs_gender_confirmation) required.push("gender");
   if (parsed.needs_recent_not_view_confirmation) required.push("recent_not_view");
-  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 || {};
-  const jobValue = normalizeText(confirmation.job_value || args.overrides?.job || "");
-  if (!jobValue) required.push("job");
-  const restLevel = getExplicitRestLevel(args);
-  if (!restLevel.valid) required.push("rest_level");
-  const blocksFinalReview = required.some((field) => field !== "rest_level");
-  if (confirmation.final_confirmed !== true && !blocksFinalReview) required.push("final_review");
-  return Array.from(new Set(required));
-}
+  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");
 
-function buildJobPendingQuestion(args = {}) {
-  const value = normalizeText(args.confirmation?.job_value || args.overrides?.job || "");
+  const confirmation = args.confirmation || {};
+  const jobValue = normalizeText(confirmation.job_value || args.overrides?.job || "");
+  if (!jobValue) required.push("job");
+  const restLevel = getExplicitRestLevel(args);
+  if (!restLevel.valid) required.push("rest_level");
+  const blocksFinalReview = required.some((field) => field !== "rest_level");
+  if (confirmation.final_confirmed !== true && !blocksFinalReview) required.push("final_review");
+  return Array.from(new Set(required));
+}
+
+function buildJobPendingQuestion(args = {}) {
+  const value = normalizeText(args.confirmation?.job_value || args.overrides?.job || "");
   return {
     field: "job",
     question: "请确认推荐页岗位。CDP-only rewrite 会先切换到该岗位，再按所选页面范围执行筛选。",
     value: value || null
-  };
-}
-
-function buildRestLevelPendingQuestion(args = {}) {
-  const restLevel = getExplicitRestLevel(args);
-  return {
-    field: "rest_level",
-    question: restLevel.missing
-      ? "请确认本次运行休息强度 rest_level。"
-      : "rest_level 只能是 low / medium / high，请重新确认本次运行休息强度。",
-    value: restLevel.restLevel || restLevel.raw || null,
-    options: REST_LEVEL_OPTIONS.map((value) => ({
-      label: value,
-      value
-    }))
-  };
-}
-
-function buildSuspiciousFieldsQuestion(parsed) {
-  return {
-    field: "suspicious_fields",
-    question: "检测到需要修正或明确确认的异常字段，请先修正后再启动。",
-    value: parsed.suspicious_fields || []
-  };
-}
-
-function buildFinalReviewQuestion(parsed, args = {}) {
-  const restLevel = getExplicitRestLevel(args);
-  return {
-    field: "final_review",
-    question: "请最终确认本次推荐页筛选参数无误；确认后设置 final_confirmed=true 即可启动或创建定时任务。",
-    value: {
-      page_scope: buildReviewPageScope(parsed),
-      job: buildReviewJob(args),
-      search_params: parsed.searchParams,
-      screen_params: buildReviewScreenParams(parsed),
-      human_behavior: {
-        restLevel: restLevel.restLevel || null
-      },
-      schedule: buildScheduleReview(args)
-    }
-  };
-}
-
-function buildNeedInputResponse(parsed, args = {}) {
-  return {
-    status: "NEED_INPUT",
-    missing_fields: parsed.missing_fields,
-    required_confirmations: buildRequiredConfirmations(parsed, args),
-    search_params: parsed.searchParams,
-    screen_params: parsed.screenParams,
+  };
+}
+
+function buildRestLevelPendingQuestion(args = {}) {
+  const restLevel = getExplicitRestLevel(args);
+  return {
+    field: "rest_level",
+    question: restLevel.missing
+      ? "请确认本次运行休息强度 rest_level。"
+      : "rest_level 只能是 low / medium / high，请重新确认本次运行休息强度。",
+    value: restLevel.restLevel || restLevel.raw || null,
+    options: REST_LEVEL_OPTIONS.map((value) => ({
+      label: value,
+      value
+    }))
+  };
+}
+
+function buildSuspiciousFieldsQuestion(parsed) {
+  return {
+    field: "suspicious_fields",
+    question: "检测到需要修正或明确确认的异常字段，请先修正后再启动。",
+    value: parsed.suspicious_fields || []
+  };
+}
+
+function buildFinalReviewQuestion(parsed, args = {}) {
+  const restLevel = getExplicitRestLevel(args);
+  return {
+    field: "final_review",
+    question: "请最终确认本次推荐页筛选参数无误；确认后设置 final_confirmed=true 即可启动或创建定时任务。",
+    value: {
+      page_scope: buildReviewPageScope(parsed),
+      job: buildReviewJob(args),
+      search_params: parsed.searchParams,
+      screen_params: buildReviewScreenParams(parsed),
+      human_behavior: {
+        restLevel: restLevel.restLevel || null
+      },
+      schedule: buildScheduleReview(args)
+    }
+  };
+}
+
+function buildNeedInputResponse(parsed, args = {}) {
+  return {
+    status: "NEED_INPUT",
+    missing_fields: parsed.missing_fields,
+    required_confirmations: buildRequiredConfirmations(parsed, args),
+    search_params: parsed.searchParams,
+    screen_params: parsed.screenParams,
     pending_questions: parsed.pending_questions,
     review: parsed.review,
     error: {
@@ -1612,36 +1616,36 @@ function buildNeedInputResponse(parsed, args = {}) {
   };
 }
 
-function buildNeedConfirmationResponse(parsed, args, requiredConfirmations) {
-  const pending = [...(parsed.pending_questions || [])];
-  if (requiredConfirmations.includes("suspicious_fields") && !pending.some((item) => item.field === "suspicious_fields")) {
-    pending.push(buildSuspiciousFieldsQuestion(parsed));
-  }
-  if (requiredConfirmations.includes("job") && !pending.some((item) => item.field === "job")) {
-    pending.push(buildJobPendingQuestion(args));
-  }
-  if (requiredConfirmations.includes("rest_level") && !pending.some((item) => item.field === "rest_level")) {
-    pending.push(buildRestLevelPendingQuestion(args));
-  }
-  if (requiredConfirmations.includes("final_review") && !pending.some((item) => item.field === "final_review")) {
-    pending.push(buildFinalReviewQuestion(parsed, args));
-  }
-  return {
-    status: "NEED_CONFIRMATION",
-    required_confirmations: requiredConfirmations,
-    page_scope: buildReviewPageScope(parsed),
-    search_params: parsed.searchParams,
-    screen_params: buildReviewScreenParams(parsed),
-    pending_questions: pending,
-    review: {
-      ...(parsed.review || {}),
+function buildNeedConfirmationResponse(parsed, args, requiredConfirmations) {
+  const pending = [...(parsed.pending_questions || [])];
+  if (requiredConfirmations.includes("suspicious_fields") && !pending.some((item) => item.field === "suspicious_fields")) {
+    pending.push(buildSuspiciousFieldsQuestion(parsed));
+  }
+  if (requiredConfirmations.includes("job") && !pending.some((item) => item.field === "job")) {
+    pending.push(buildJobPendingQuestion(args));
+  }
+  if (requiredConfirmations.includes("rest_level") && !pending.some((item) => item.field === "rest_level")) {
+    pending.push(buildRestLevelPendingQuestion(args));
+  }
+  if (requiredConfirmations.includes("final_review") && !pending.some((item) => item.field === "final_review")) {
+    pending.push(buildFinalReviewQuestion(parsed, args));
+  }
+  return {
+    status: "NEED_CONFIRMATION",
+    required_confirmations: requiredConfirmations,
+    page_scope: buildReviewPageScope(parsed),
+    search_params: parsed.searchParams,
+    screen_params: buildReviewScreenParams(parsed),
+    pending_questions: pending,
+    review: {
+      ...(parsed.review || {}),
       required_confirmations: requiredConfirmations
     }
   };
 }
-
-function evaluateRecommendPipelineGate(parsed, args = {}) {
-  if (parsed.missing_fields?.length) return buildNeedInputResponse(parsed, args);
+
+function evaluateRecommendPipelineGate(parsed, args = {}) {
+  if (parsed.missing_fields?.length) return buildNeedInputResponse(parsed, args);
   const requiredConfirmations = buildRequiredConfirmations(parsed, args);
   if (requiredConfirmations.length) {
     return buildNeedConfirmationResponse(parsed, args, requiredConfirmations);
@@ -1679,7 +1683,13 @@ function buildRecommendFilter(parsed, args = {}) {
     return { enabled: false };
   }
 
-  const groups = [];
+  const groups = [{
+    group: "activity",
+    labels: [parsed.searchParams?.activity_level || "不限"],
+    selectAllLabels: false,
+    allowUnlimited: true,
+    verifySticky: true
+  }];
   const recentNotView = withoutUnlimited(parsed.searchParams?.recent_not_view);
   if (recentNotView.length) {
     groups.push({
@@ -1716,8 +1726,12 @@ function buildRecommendFilter(parsed, args = {}) {
     });
   }
 
-  return groups.length ? { filterGroups: groups } : { enabled: false };
-}
+  return {
+    enabled: true,
+    currentCityOnly: parsed.searchParams?.current_city_only === true,
+    filterGroups: groups
+  };
+}
 
 function normalizeRecommendStartInput(args = {}, parsed, configResolution = null) {
   const confirmation = args.confirmation || {};
@@ -1740,24 +1754,24 @@ 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,
-    skipRecentColleagueContacted: parsed.screenParams?.skip_recent_colleague_contacted !== false,
-    colleagueContactWindowDays: 14,
-    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;
-  const executePostAction = args.dry_run_post_action === true
-    ? false
-    : args.execute_post_action !== false;
-  const humanBehavior = resolveHumanBehaviorForRun(args, configResolution?.config || {});
-  return {
+function getRunOptions(args, parsed, normalized, session, configResolution = null) {
+  const slowLive = args.slow_live === true;
+  const executePostAction = args.dry_run_post_action === true
+    ? false
+    : args.execute_post_action !== false;
+  const humanBehavior = resolveHumanBehaviorForRun(args, configResolution?.config || {});
+  return {
     client: session.client,
     targetUrl: RECOMMEND_TARGET_URL,
     criteria: normalized.criteria,
@@ -1787,8 +1801,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,
@@ -1800,23 +1814,23 @@ function getRunOptions(args, parsed, normalized, session, configResolution = nul
       args.llm_image_limit,
       parsePositiveInteger(configResolution?.config?.llmImageLimit || configResolution?.config?.imageLimit, 8)
     ),
-    llmImageDetail: normalizeText(
-      args.llm_image_detail || configResolution?.config?.llmImageDetail || configResolution?.config?.imageDetail
-    ) || "low",
-    imageOutputDir: resolveBossConfiguredOutputDir("", getRunsDir()),
-    humanRestEnabled: humanBehavior.restEnabled,
-    humanBehavior,
-    skipRecentColleagueContacted: normalized.skipRecentColleagueContacted,
-    colleagueContactWindowDays: normalized.colleagueContactWindowDays,
-    name: "mcp-recommend-pipeline-run",
-    parsed
-  };
-}
+    llmImageDetail: normalizeText(
+      args.llm_image_detail || configResolution?.config?.llmImageDetail || configResolution?.config?.imageDetail
+    ) || "low",
+    imageOutputDir: resolveBossConfiguredOutputDir("", getRunsDir()),
+    humanRestEnabled: humanBehavior.restEnabled,
+    humanBehavior,
+    skipRecentColleagueContacted: normalized.skipRecentColleagueContacted,
+    colleagueContactWindowDays: normalized.colleagueContactWindowDays,
+    name: "mcp-recommend-pipeline-run",
+    parsed
+  };
+}
 
-function prepareRecommendPipelineStart(args = {}, { workspaceRoot = "" } = {}) {
-  const routeGuard = guardRecommendRoute(args);
-  if (routeGuard) return { response: routeGuard };
-  const parsed = parseRecommendPipelineRequest(args);
+function prepareRecommendPipelineStart(args = {}, { workspaceRoot = "" } = {}) {
+  const routeGuard = guardRecommendRoute(args);
+  if (routeGuard) return { response: routeGuard };
+  const parsed = parseRecommendPipelineRequest(args);
   const gate = evaluateRecommendPipelineGate(parsed, args);
   if (gate) return { response: gate };
   const configResolution = resolveBossScreeningConfig(workspaceRoot);
@@ -2002,72 +2016,72 @@ async function startRecommendPipelineRunInternal(args = {}, { workspaceRoot = ""
   };
 }
 
-export function prepareRecommendPipelineRunTool({ workspaceRoot = "", args = {} } = {}) {
-  const prepared = prepareRecommendPipelineStart(args, { workspaceRoot });
-  if (prepared.response) {
-    return {
-      ...prepared.response,
-      cron_ready: false
-    };
-  }
-  const { parsed, normalized } = prepared;
-  const nextAction = {
-    immediate_run: {
-      recommended_next_tool: "start_recommend_pipeline_run",
-      alternate_next_tool: "run_recommend",
-      same_arguments: true,
-      native_mcp_required: true
-    },
-    scheduled_run: {
-      recommended_next_tool: "schedule_recommend_pipeline_run",
-      same_arguments: true,
-      requires_schedule_field: true
-    },
-    do_not_call_prepare_again: true,
-    do_not_use_cli_fallback_when_mcp_tools_available: true,
-    do_not_use_terminal_or_shell: true,
-    forbidden_fallbacks: [
-      "run_command",
-      "terminal",
-      "shell",
-      "CLI detached fallback",
-      "manual JSON-RPC over shell",
-      "npx --stdio"
-    ]
-  };
-  const agentGuidance = {
-    host_has_native_mcp: true,
-    native_mcp_required_after_prepare: true,
-    proof: "This prepare_recommend_pipeline_run response was returned by the MCP server, so the host can call MCP tools from this server.",
-    immediate_run: {
-      tool: nextAction.immediate_run.recommended_next_tool,
-      alternate_tool: nextAction.immediate_run.alternate_next_tool,
-      same_arguments: true
-    },
-    scheduled_run: {
-      tool: nextAction.scheduled_run.recommended_next_tool,
-      same_arguments: true
-    },
-    trae_cn: {
-      next_step: "Call boss-recommend/start_recommend_pipeline_run or boss-recommend/run_recommend through the native MCP tool interface.",
-      never_use_terminal_fallback_after_prepare: true
-    },
-    forbidden_when_mcp_tools_are_available: nextAction.forbidden_fallbacks
-  };
-  return {
-    status: "READY",
-    cron_ready: true,
-    prepared_only: true,
-    run_started: false,
-    recommended_next_tool: nextAction.immediate_run.recommended_next_tool,
-    alternate_next_tool: nextAction.immediate_run.alternate_next_tool,
-    next_action: nextAction,
-    agent_guidance: agentGuidance,
-    message: "READY only means the payload passed validation; prepare_recommend_pipeline_run did not start a run. This response proves the MCP server is available. To start now, call the native MCP tool start_recommend_pipeline_run or run_recommend with the same arguments. Do not call prepare_recommend_pipeline_run again, and do not use terminal, shell, CLI detached fallback, or manual JSON-RPC when MCP tools are available.",
-    review: parsed.review,
-    post_action: {
-      requested: normalized.postAction,
-      execute_post_action: args.dry_run_post_action === true ? false : args.execute_post_action !== false,
+export function prepareRecommendPipelineRunTool({ workspaceRoot = "", args = {} } = {}) {
+  const prepared = prepareRecommendPipelineStart(args, { workspaceRoot });
+  if (prepared.response) {
+    return {
+      ...prepared.response,
+      cron_ready: false
+    };
+  }
+  const { parsed, normalized } = prepared;
+  const nextAction = {
+    immediate_run: {
+      recommended_next_tool: "start_recommend_pipeline_run",
+      alternate_next_tool: "run_recommend",
+      same_arguments: true,
+      native_mcp_required: true
+    },
+    scheduled_run: {
+      recommended_next_tool: "schedule_recommend_pipeline_run",
+      same_arguments: true,
+      requires_schedule_field: true
+    },
+    do_not_call_prepare_again: true,
+    do_not_use_cli_fallback_when_mcp_tools_available: true,
+    do_not_use_terminal_or_shell: true,
+    forbidden_fallbacks: [
+      "run_command",
+      "terminal",
+      "shell",
+      "CLI detached fallback",
+      "manual JSON-RPC over shell",
+      "npx --stdio"
+    ]
+  };
+  const agentGuidance = {
+    host_has_native_mcp: true,
+    native_mcp_required_after_prepare: true,
+    proof: "This prepare_recommend_pipeline_run response was returned by the MCP server, so the host can call MCP tools from this server.",
+    immediate_run: {
+      tool: nextAction.immediate_run.recommended_next_tool,
+      alternate_tool: nextAction.immediate_run.alternate_next_tool,
+      same_arguments: true
+    },
+    scheduled_run: {
+      tool: nextAction.scheduled_run.recommended_next_tool,
+      same_arguments: true
+    },
+    trae_cn: {
+      next_step: "Call boss-recommend/start_recommend_pipeline_run or boss-recommend/run_recommend through the native MCP tool interface.",
+      never_use_terminal_fallback_after_prepare: true
+    },
+    forbidden_when_mcp_tools_are_available: nextAction.forbidden_fallbacks
+  };
+  return {
+    status: "READY",
+    cron_ready: true,
+    prepared_only: true,
+    run_started: false,
+    recommended_next_tool: nextAction.immediate_run.recommended_next_tool,
+    alternate_next_tool: nextAction.immediate_run.alternate_next_tool,
+    next_action: nextAction,
+    agent_guidance: agentGuidance,
+    message: "READY only means the payload passed validation; prepare_recommend_pipeline_run did not start a run. This response proves the MCP server is available. To start now, call the native MCP tool start_recommend_pipeline_run or run_recommend with the same arguments. Do not call prepare_recommend_pipeline_run again, and do not use terminal, shell, CLI detached fallback, or manual JSON-RPC when MCP tools are available.",
+    review: parsed.review,
+    post_action: {
+      requested: normalized.postAction,
+      execute_post_action: args.dry_run_post_action === true ? false : args.execute_post_action !== false,
       max_greet_count: normalized.maxGreetCount
     },
     target_count_semantics: TARGET_COUNT_SEMANTICS
@@ -2093,19 +2107,19 @@ export function getRecommendPipelineRunTool({ args = {} } = {}) {
     };
   }
   try {
-    const run = recommendRunService.getRecommendRun(runId);
-    const normalizedRun = persistRecommendRunSnapshot(run);
-    return attachMethodEvidence({
-      status: "RUN_STATUS",
-      run: compactRecommendRunForStatus(normalizedRun)
-    }, runId);
-  } catch {
-    const persisted = readRecommendRunState(runId);
-    if (persisted) {
-      const reconciled = compactRecommendRunForStatus(reconcilePersistedRecommendRunIfNeeded(persisted));
-      return {
-        status: "RUN_STATUS",
-        run: reconciled,
+    const run = recommendRunService.getRecommendRun(runId);
+    const normalizedRun = persistRecommendRunSnapshot(run);
+    return attachMethodEvidence({
+      status: "RUN_STATUS",
+      run: compactRecommendRunForStatus(normalizedRun)
+    }, runId);
+  } catch {
+    const persisted = readRecommendRunState(runId);
+    if (persisted) {
+      const reconciled = compactRecommendRunForStatus(reconcilePersistedRecommendRunIfNeeded(persisted));
+      return {
+        status: "RUN_STATUS",
+        run: reconciled,
         persistence: {
           source: "disk",
           active_control_available: false,
@@ -2133,36 +2147,36 @@ export function pauseRecommendPipelineRunTool({ args = {} } = {}) {
   try {
     const before = recommendRunService.getRecommendRun(runId);
     if (TERMINAL_STATUSES.has(before.status)) {
-      const normalizedBefore = persistRecommendRunSnapshot(before);
-      return attachMethodEvidence({
-        status: "PAUSE_IGNORED",
-        run: compactRecommendRunForStatus(normalizedBefore),
-        message: "目标任务已结束，无需暂停。"
-      }, runId);
+      const normalizedBefore = persistRecommendRunSnapshot(before);
+      return attachMethodEvidence({
+        status: "PAUSE_IGNORED",
+        run: compactRecommendRunForStatus(normalizedBefore),
+        message: "目标任务已结束，无需暂停。"
+      }, runId);
     }
     if (before.status === RUN_STATUS_PAUSED) {
-      const normalizedBefore = persistRecommendRunSnapshot(before);
-      return attachMethodEvidence({
-        status: "PAUSE_IGNORED",
-        run: compactRecommendRunForStatus(normalizedBefore),
-        message: "目标任务已经处于 paused 状态。"
-      }, runId);
+      const normalizedBefore = persistRecommendRunSnapshot(before);
+      return attachMethodEvidence({
+        status: "PAUSE_IGNORED",
+        run: compactRecommendRunForStatus(normalizedBefore),
+        message: "目标任务已经处于 paused 状态。"
+      }, runId);
     }
     const run = recommendRunService.pauseRecommendRun(runId);
-    const normalizedRun = persistRecommendRunSnapshot(run);
-    return attachMethodEvidence({
-      status: "PAUSE_REQUESTED",
-      run: compactRecommendRunForStatus(normalizedRun),
-      message: "暂停请求已接收，将在当前候选人处理完成后进入 paused。"
-    }, runId);
+    const normalizedRun = persistRecommendRunSnapshot(run);
+    return attachMethodEvidence({
+      status: "PAUSE_REQUESTED",
+      run: compactRecommendRunForStatus(normalizedRun),
+      message: "暂停请求已接收，将在当前候选人处理完成后进入 paused。"
+    }, runId);
   } catch {
     const persisted = readRecommendRunState(runId);
     if (persisted && TERMINAL_STATUSES.has(persisted.state)) {
-      return {
-        status: "PAUSE_IGNORED",
-        run: compactRecommendRunForStatus(persisted),
-        message: "目标任务已结束，无需暂停。",
-        runtime_evaluate_used: false,
+      return {
+        status: "PAUSE_IGNORED",
+        run: compactRecommendRunForStatus(persisted),
+        message: "目标任务已结束，无需暂停。",
+        runtime_evaluate_used: false,
         method_summary: {},
         method_log: [],
         chrome: null
@@ -2177,28 +2191,28 @@ export function resumeRecommendPipelineRunTool({ args = {} } = {}) {
   try {
     const before = recommendRunService.getRecommendRun(runId);
     if (TERMINAL_STATUSES.has(before.status)) {
-      const normalizedBefore = persistRecommendRunSnapshot(before);
-      return attachMethodEvidence({
-        status: "FAILED",
+      const normalizedBefore = persistRecommendRunSnapshot(before);
+      return attachMethodEvidence({
+        status: "FAILED",
         error: {
           code: "RUN_ALREADY_TERMINATED",
           message: "目标任务已结束，无法继续。",
           retryable: false
         },
-        run: compactRecommendRunForStatus(normalizedBefore)
-      }, runId);
+        run: compactRecommendRunForStatus(normalizedBefore)
+      }, runId);
     }
     if (before.status !== RUN_STATUS_PAUSED) {
-      const normalizedBefore = persistRecommendRunSnapshot(before);
-      return attachMethodEvidence({
-        status: "FAILED",
+      const normalizedBefore = persistRecommendRunSnapshot(before);
+      return attachMethodEvidence({
+        status: "FAILED",
         error: {
           code: "RUN_NOT_PAUSED",
           message: "仅 paused 状态的 run 才能继续。",
           retryable: true
         },
-        run: compactRecommendRunForStatus(normalizedBefore)
-      }, runId);
+        run: compactRecommendRunForStatus(normalizedBefore)
+      }, runId);
     }
     const run = recommendRunService.resumeRecommendRun(runId);
     const meta = getRecommendRunMeta(runId);
@@ -2206,12 +2220,12 @@ export function resumeRecommendPipelineRunTool({ args = {} } = {}) {
       meta.resumeCount = (meta.resumeCount || 0) + 1;
       meta.lastResumedAt = new Date().toISOString();
     }
-    const normalizedRun = persistRecommendRunSnapshot(run);
-    return attachMethodEvidence({
-      status: "RESUME_REQUESTED",
-      run: compactRecommendRunForStatus(normalizedRun),
-      poll_after_sec: DEFAULT_RECOMMEND_POLL_AFTER_SEC,
-      message: "已恢复 Recommend run，请使用 get_recommend_pipeline_run 按需轮询。"
+    const normalizedRun = persistRecommendRunSnapshot(run);
+    return attachMethodEvidence({
+      status: "RESUME_REQUESTED",
+      run: compactRecommendRunForStatus(normalizedRun),
+      poll_after_sec: DEFAULT_RECOMMEND_POLL_AFTER_SEC,
+      message: "已恢复 Recommend run，请使用 get_recommend_pipeline_run 按需轮询。"
     }, runId);
   } catch {
     const persisted = readRecommendRunState(runId);
@@ -2225,9 +2239,9 @@ export function resumeRecommendPipelineRunTool({ args = {} } = {}) {
             : "该 run 只有磁盘快照，没有当前进程内的活动 CDP 会话，无法安全继续。",
           retryable: !TERMINAL_STATUSES.has(persisted.state)
         },
-        run: compactRecommendRunForStatus(persisted),
-        persistence: {
-          source: "disk",
+        run: compactRecommendRunForStatus(persisted),
+        persistence: {
+          source: "disk",
           active_control_available: false
         },
         runtime_evaluate_used: false,
@@ -2245,61 +2259,61 @@ export function cancelRecommendPipelineRunTool({ args = {} } = {}) {
   try {
     const before = recommendRunService.getRecommendRun(runId);
     if (TERMINAL_STATUSES.has(before.status)) {
-      const normalizedBefore = persistRecommendRunSnapshot(before);
-      return attachMethodEvidence({
-        status: "CANCEL_IGNORED",
-        run: compactRecommendRunForStatus(normalizedBefore),
-        message: "目标任务已结束，无需取消。"
-      }, runId);
+      const normalizedBefore = persistRecommendRunSnapshot(before);
+      return attachMethodEvidence({
+        status: "CANCEL_IGNORED",
+        run: compactRecommendRunForStatus(normalizedBefore),
+        message: "目标任务已结束，无需取消。"
+      }, runId);
     }
     const run = recommendRunService.cancelRecommendRun(runId);
-    const normalizedRun = persistRecommendRunSnapshot(run);
-    return attachMethodEvidence({
-      status: "CANCEL_REQUESTED",
-      run: compactRecommendRunForStatus(normalizedRun),
-      message: "已收到取消请求，将在当前候选人处理完成后安全停止。"
-    }, runId);
+    const normalizedRun = persistRecommendRunSnapshot(run);
+    return attachMethodEvidence({
+      status: "CANCEL_REQUESTED",
+      run: compactRecommendRunForStatus(normalizedRun),
+      message: "已收到取消请求，将在当前候选人处理完成后安全停止。"
+    }, runId);
   } catch {
     const persisted = readRecommendRunState(runId);
-    if (persisted && TERMINAL_STATUSES.has(persisted.state)) {
-      return {
-        status: "CANCEL_IGNORED",
-        run: compactRecommendRunForStatus(persisted),
-        message: "目标任务已结束，无需取消。",
-        runtime_evaluate_used: false,
+    if (persisted && TERMINAL_STATUSES.has(persisted.state)) {
+      return {
+        status: "CANCEL_IGNORED",
+        run: compactRecommendRunForStatus(persisted),
+        message: "目标任务已结束，无需取消。",
+        runtime_evaluate_used: false,
         method_summary: {},
         method_log: [],
-        chrome: null
-      };
-    }
-    const cancelMessage = "已收到取消请求，将由 detached worker 在下一个安全边界停止。";
-    const patched = patchPersistedRecommendRunControl(runId, {
-      pause_requested: true,
-      pause_requested_at: new Date().toISOString(),
-      pause_requested_by: "cancel_recommend_pipeline_run",
-      cancel_requested: true
-    }, {
-      message: cancelMessage
-    });
-    if (patched) {
-      return {
-        status: "CANCEL_REQUESTED",
-        run: compactRecommendRunForStatus(patched),
-        message: cancelMessage,
-        persistence: {
-          source: "disk",
-          active_control_available: false,
-          detached_control_requested: true
-        },
-        runtime_evaluate_used: false,
-        method_summary: {},
-        method_log: [],
-        chrome: null
-      };
-    }
-    return getRecommendPipelineRunTool({ args });
-  }
-}
+        chrome: null
+      };
+    }
+    const cancelMessage = "已收到取消请求，将由 detached worker 在下一个安全边界停止。";
+    const patched = patchPersistedRecommendRunControl(runId, {
+      pause_requested: true,
+      pause_requested_at: new Date().toISOString(),
+      pause_requested_by: "cancel_recommend_pipeline_run",
+      cancel_requested: true
+    }, {
+      message: cancelMessage
+    });
+    if (patched) {
+      return {
+        status: "CANCEL_REQUESTED",
+        run: compactRecommendRunForStatus(patched),
+        message: cancelMessage,
+        persistence: {
+          source: "disk",
+          active_control_available: false,
+          detached_control_requested: true
+        },
+        runtime_evaluate_used: false,
+        method_summary: {},
+        method_log: [],
+        chrome: null
+      };
+    }
+    return getRecommendPipelineRunTool({ args });
+  }
+}
 
 export function getRecommendMcpHealthSnapshot(runId) {
   const meta = getRecommendRunMeta(runId);