@reconcrap/boss-recommend-mcp 2.0.6 → 2.0.7

package/README.md

@@ -98,6 +98,8 @@ boss-recommend-mcp list-jobs --slow-live --port 9222
 - 不会对每位候选人重复确认
 - 推荐页详情处理完成后，会强制关闭详情页并确认已关闭
 - 简历提取优先使用 Network 响应；没有可解析 Network CV 时，回退到完整滚动截图序列再交给多模态模型判断
+- recommend / search / chat 正式运行默认全部使用 `screening-config.json` 配置的 LLM 筛选；deterministic/local scorer 只保留给明确测试场景，必须显式传 `debug_test_mode=true` 且 `screening_mode=deterministic` 或 `use_llm=false`。
+- `detail_limit=0`、`no_filter`、`filter_enabled=false`、后置动作 dry-run、chat 求简历 dry-run 等调试路径不会在正式 live run 默认启用；需要测试时必须显式传 `debug_test_mode=true`。
 - 提供显式运维自愈工具：只在手动调用 `run_recommend_self_heal` 时运行，不会接入正常 run / doctor / preflight 自动链路
 - 运行前会自动做依赖体检（Node.js、Python、Pillow、`chrome-remote-interface`、`ws`），缺失时会在 `doctor` 与流水线失败诊断中明确提示
 - 若 preflight 失败，返回 `diagnostics.recovery`（含有序修复步骤与 `agent_prompt`），可直接交给 AI agent 自动按顺序安装依赖

package/package.json

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

package/src/chat-mcp.js

@@ -308,8 +308,15 @@ function ensureChatRunArtifacts(snapshot) {
   if (meta) meta.checkpointPath = artifacts.checkpoint_path;
 
   const summary = snapshot?.summary && typeof snapshot.summary === "object" ? snapshot.summary : null;
-  if (summary) {
-    const rows = Array.isArray(summary.results) ? summary.results : [];
+  const checkpointResults = Array.isArray(checkpoint.results) ? checkpoint.results : [];
+  const artifactSummary = summary || (checkpointResults.length ? {
+    domain: "chat",
+    partial: true,
+    partial_reason: snapshot?.status || snapshot?.state || "non_terminal",
+    results: checkpointResults
+  } : null);
+  if (artifactSummary) {
+    const rows = Array.isArray(artifactSummary.results) ? artifactSummary.results : [];
     writeChatLegacyCsvAtomic(artifacts.output_csv, rows, snapshot, meta);
     writeJsonAtomic(artifacts.report_json, {
       run_id: snapshot.runId || snapshot.run_id,
@@ -318,7 +325,7 @@ function ensureChatRunArtifacts(snapshot) {
       progress: snapshot.progress || {},
       context: snapshot.context || {},
       checkpoint,
-      summary,
+      summary: artifactSummary,
       generated_at: new Date().toISOString()
     });
     if (meta) {
@@ -335,6 +342,12 @@ function buildLegacyChatResult(snapshot) {
   const artifacts = ensureChatRunArtifacts(snapshot);
   const meta = getChatRunMeta(snapshot.runId);
   const summary = snapshot.summary && typeof snapshot.summary === "object" ? snapshot.summary : null;
+  const checkpoint = snapshot.checkpoint && typeof snapshot.checkpoint === "object" ? snapshot.checkpoint : {};
+  const resultRows = Array.isArray(summary?.results)
+    ? summary.results
+    : Array.isArray(checkpoint.results)
+      ? checkpoint.results
+      : [];
   const progress = normalizeLegacyProgress(snapshot.progress, summary);
   return {
     run_id: snapshot.runId,
@@ -358,7 +371,7 @@ function buildLegacyChatResult(snapshot) {
     completed_at: snapshot.completedAt || null,
     duration_sec: secondsBetween(snapshot.startedAt, snapshot.completedAt),
     error: snapshot.error || null,
-    results: Array.isArray(summary?.results) ? summary.results : []
+    results: resultRows
   };
 }
 
@@ -788,16 +801,31 @@ function shouldRequestChatResume(args = {}) {
   );
 }
 
-function shouldUseChatLlm(args = {}, shouldRequestResume = false) {
-  if (args.use_llm === false) return false;
-  return (
-    args.use_llm === true
-    || shouldRequestResume
-    || parseNonNegativeInteger(args.detail_limit, 0) > 0
-  );
+function isDebugTestMode(args = {}) {
+  return args.debug_test_mode === true || args.allow_debug_test_mode === true;
+}
+
+function normalizeScreeningModeArg(args = {}) {
+  const raw = normalizeText(args.screening_mode || args.screeningMode || "");
+  if (args.use_llm === false) return "deterministic";
+  return ["deterministic", "local", "local_scorer"].includes(raw.toLowerCase())
+    ? "deterministic"
+    : "llm";
+}
+
+function collectChatDebugTestOptions(args = {}) {
+  const reasons = [];
+  if (normalizeScreeningModeArg(args) === "deterministic") reasons.push("deterministic_screening");
+  if (parseNonNegativeInteger(args.detail_limit, null) === 0) reasons.push("detail_limit=0");
+  if (args.dry_run === true || args.dry_run_request_cv === true) reasons.push("dry_run_request_cv");
+  return reasons;
+}
+
+function shouldUseChatLlm(args = {}) {
+  return normalizeScreeningModeArg(args) !== "deterministic";
 }
 
-function getRunOptions(args, normalized, session, { workspaceRoot = "" } = {}) {
+function getRunOptions(args, normalized, session, { workspaceRoot = "", configResolution = null } = {}) {
   const slowLive = args.slow_live === true;
   const isAllTarget = normalized.publicTargetCount === "all";
   const processedLimit = parsePositiveInteger(
@@ -805,8 +833,8 @@ function getRunOptions(args, normalized, session, { workspaceRoot = "" } = {}) {
     isAllTarget ? CHAT_ALL_MAX_CANDIDATES : CHAT_ALL_MAX_CANDIDATES
   );
   const shouldRequestResume = shouldRequestChatResume(args);
-  const useLlm = shouldUseChatLlm(args, shouldRequestResume);
-  const configResolution = useLlm ? resolveBossScreeningConfig(workspaceRoot) : { ok: false };
+  const useLlm = shouldUseChatLlm(args);
+  const resolvedConfig = configResolution || (useLlm ? resolveBossScreeningConfig(workspaceRoot) : { ok: false });
   return {
     client: session.client,
     targetUrl: CHAT_TARGET_URL,
@@ -832,12 +860,13 @@ function getRunOptions(args, normalized, session, { workspaceRoot = "" } = {}) {
     resumeDomTimeoutMs: slowLive ? 120000 : 60000,
     maxImagePages: parsePositiveInteger(args.max_image_pages, 8),
     imageWheelDeltaY: parsePositiveInteger(args.image_wheel_delta_y, 650),
-    llmConfig: configResolution.ok ? {
-      ...configResolution.config
+    llmConfig: resolvedConfig.ok ? {
+      ...resolvedConfig.config
     } : null,
     llmTimeoutMs: parsePositiveInteger(args.llm_timeout_ms, slowLive ? 180000 : 120000),
     llmImageLimit: parsePositiveInteger(args.llm_image_limit, 8),
     llmImageDetail: normalizeText(args.llm_image_detail) || "high",
+    screeningMode: normalizeScreeningModeArg(args),
     listMaxScrolls: parsePositiveInteger(args.list_max_scrolls, 200),
     listStableSignatureLimit: parsePositiveInteger(args.list_stable_signature_limit, 2),
     listWheelDeltaY: parsePositiveInteger(args.list_wheel_delta_y, 850),
@@ -905,7 +934,19 @@ async function startBossChatRunInternal(args = {}, { workspaceRoot = "" } = {})
   }
 
   const shouldRequestResume = shouldRequestChatResume(args);
-  const useLlm = shouldUseChatLlm(args, shouldRequestResume);
+  const useLlm = shouldUseChatLlm(args);
+  const debugTestOptions = collectChatDebugTestOptions(args);
+  if (debugTestOptions.length && !isDebugTestMode(args)) {
+    return {
+      status: "FAILED",
+      error: {
+        code: "DEBUG_TEST_MODE_REQUIRED",
+        message: `这些参数属于调试/测试路径，正式 live run 不会默认启用：${debugTestOptions.join(", ")}。如确需测试，请显式传 debug_test_mode=true。`,
+        retryable: false
+      },
+      debug_test_options: debugTestOptions
+    };
+  }
   const configResolution = useLlm ? resolveBossScreeningConfig(workspaceRoot) : null;
   if (useLlm && !configResolution?.ok) {
     return {
@@ -948,7 +989,7 @@ async function startBossChatRunInternal(args = {}, { workspaceRoot = "" } = {})
 
   let started;
   try {
-    started = chatRunService.startChatRun(getRunOptions(args, normalized, session, { workspaceRoot }));
+    started = chatRunService.startChatRun(getRunOptions(args, normalized, session, { workspaceRoot, configResolution }));
   } catch (error) {
     await session.close?.();
     return {

package/src/core/reporting/legacy-csv.js

@@ -284,8 +284,8 @@ export function legacyScreenResultRow(row = {}) {
     totalEvidence,
     totalEvidence,
     "",
-    row.error_code || error.code || error.name || "",
-    row.error_message || error.message || "",
+    row.error_code || error.code || error.name || (llm.error ? "LLM_SCREENING_ERROR" : ""),
+    row.error_message || error.message || llm.error || "",
     candidate.id || row.candidate_id || "",
     timingValue(row, "total_ms"),
     timingValue(row, "card_read_ms"),

package/src/core/screening/index.js

@@ -1003,6 +1003,54 @@ export function screenCandidate(candidateInput, criteria = {}) {
   };
 }
 
+export function compactScreeningLlmResult(llmResult) {
+  if (!llmResult) return null;
+  return {
+    ok: Boolean(llmResult.ok),
+    provider: llmResult.provider || null,
+    passed: llmResult.passed,
+    cot: llmResult.cot || llmResult.decision_cot || "",
+    reasoning_content: llmResult.reasoning_content || "",
+    raw_model_output: llmResult.raw_model_output || "",
+    evidence_count: Array.isArray(llmResult.evidence) ? llmResult.evidence.length : 0,
+    usage: llmResult.usage || null,
+    finish_reason: llmResult.finish_reason || null,
+    image_input_count: llmResult.image_input_count || 0,
+    error: llmResult.error || null,
+    screened_at: llmResult.screened_at || null
+  };
+}
+
+export function llmResultToScreening(llmResult, candidate) {
+  return {
+    status: llmResult?.passed ? "pass" : "fail",
+    passed: Boolean(llmResult?.passed),
+    score: llmResult?.passed ? 100 : 0,
+    reasons: llmResult?.error ? ["llm_invalid_response"] : [],
+    candidate
+  };
+}
+
+export function isRecoverableLlmScreeningError(error) {
+  return /(?:LLM response missing boolean passed decision|LLM response was not valid JSON)/i
+    .test(String(error?.message || error || ""));
+}
+
+export function createFailedLlmScreeningResult(error) {
+  return {
+    ok: false,
+    passed: false,
+    reason: "",
+    evidence: [],
+    cot: "",
+    decision_cot: "",
+    reasoning_content: "",
+    raw_model_output: "",
+    error: error?.message || String(error || "unknown"),
+    screened_at: nowIso()
+  };
+}
+
 export function buildScreeningLlmMessages({
   candidate,
   criteria,

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

@@ -167,6 +167,17 @@ function createFailedLlmResult(error) {
   };
 }
 
+function normalizeScreeningMode(value) {
+  const normalized = String(value || "llm").trim().toLowerCase();
+  return ["deterministic", "local", "local_scorer"].includes(normalized)
+    ? "deterministic"
+    : "llm";
+}
+
+function createMissingLlmConfigResult() {
+  return createFailedLlmResult(new Error("LLM screening config is required for production chat runs"));
+}
+
 function createSkippedDetailResult(cardCandidate, reason, error = null) {
   return {
     candidate: cardCandidate,
@@ -334,7 +345,7 @@ export async function runChatWorkflow({
   maxCandidates = 5,
   targetPassCount = null,
   processUntilListEnd = false,
-  detailLimit = 0,
+  detailLimit = null,
   detailSource = "cascade",
   closeResume = true,
   requestResumeForPassed = false,
@@ -353,6 +364,7 @@ export async function runChatWorkflow({
   llmTimeoutMs = 120000,
   llmImageLimit = 8,
   llmImageDetail = "high",
+  screeningMode = "llm",
   listMaxScrolls = 20,
   listStableSignatureLimit = 2,
   listWheelDeltaY = 850,
@@ -361,12 +373,14 @@ export async function runChatWorkflow({
 } = {}, runControl) {
   if (!client) throw new Error("runChatWorkflow requires a guarded CDP client");
   const normalizedDetailSource = normalizeDetailSource(detailSource);
+  const normalizedScreeningMode = normalizeScreeningMode(screeningMode);
+  const useLlmScreening = normalizedScreeningMode !== "deterministic";
   const processedLimit = Math.max(1, Number(maxCandidates) || 1);
   const passTarget = Number.isFinite(Number(targetPassCount)) && Number(targetPassCount) > 0
     ? Number(targetPassCount)
     : null;
   const normalizedStartFrom = normalizeText(startFrom).toLowerCase() === "unread" ? "unread" : "all";
-  const detailCountLimit = Math.max(0, Number(detailLimit) || 0);
+  const detailCountLimit = detailLimit == null ? processedLimit : Math.max(0, Number(detailLimit) || 0);
   const networkRecorder = detailCountLimit > 0
     ? createChatProfileNetworkRecorder(client)
     : null;
@@ -556,6 +570,7 @@ export async function runChatWorkflow({
     requested: 0,
     request_satisfied: 0,
     request_skipped: 0,
+    screening_mode: normalizedScreeningMode,
     unique_seen: compactInfiniteListState(listState).seen_count,
     scroll_count: 0,
     viewport_checks: viewportGuard.getStats().checks,
@@ -799,21 +814,23 @@ export async function runChatWorkflow({
                 imageEvidence
               });
               if (callLlmOnImage) {
-                if (!llmConfig) throw new Error("callLlmOnImage requires llmConfig");
                 detailStep = "llm_image_screening";
-                try {
-                  llmResult = await callScreeningLlm({
-                    candidate: detailResult.candidate,
-                    criteria,
-                    config: llmConfig,
-                    timeoutMs: llmTimeoutMs,
-                    imageEvidence,
-                    maxImages: llmImageLimit,
-                    imageDetail: llmImageDetail
-                  });
-                } catch (error) {
-                  if (!isRecoverableLlmScreeningError(error)) throw error;
-                  llmResult = createFailedLlmResult(error);
+                if (!llmConfig) {
+                  llmResult = createMissingLlmConfigResult();
+                } else {
+                  try {
+                    llmResult = await callScreeningLlm({
+                      candidate: detailResult.candidate,
+                      criteria,
+                      config: llmConfig,
+                      timeoutMs: llmTimeoutMs,
+                      imageEvidence,
+                      maxImages: llmImageLimit,
+                      imageDetail: llmImageDetail
+                    });
+                  } catch (error) {
+                    llmResult = createFailedLlmResult(error);
+                  }
                 }
               }
             } else {
@@ -838,21 +855,24 @@ export async function runChatWorkflow({
             });
           }
 
-          if (llmConfig && !llmResult) {
+          if (useLlmScreening && !llmResult) {
             detailStep = "llm_screening";
-            try {
-              llmResult = await callScreeningLlm({
-                candidate: detailResult.candidate,
-                criteria,
-                config: llmConfig,
-                timeoutMs: llmTimeoutMs,
-                imageEvidence,
-                maxImages: llmImageLimit,
-                imageDetail: llmImageDetail
-              });
-            } catch (error) {
-              if (!isRecoverableLlmScreeningError(error)) throw error;
-              llmResult = createFailedLlmResult(error);
+            if (!llmConfig) {
+              llmResult = createMissingLlmConfigResult();
+            } else {
+              try {
+                llmResult = await callScreeningLlm({
+                  candidate: detailResult.candidate,
+                  criteria,
+                  config: llmConfig,
+                  timeoutMs: llmTimeoutMs,
+                  imageEvidence,
+                  maxImages: llmImageLimit,
+                  imageDetail: llmImageDetail
+                });
+              } catch (error) {
+                llmResult = createFailedLlmResult(error);
+              }
             }
           }
 
@@ -901,6 +921,26 @@ export async function runChatWorkflow({
     await runControl.waitIfPaused();
     runControl.throwIfCanceled();
     runControl.setPhase("chat:screening");
+    let cardOnlyLlmResult = null;
+    if (useLlmScreening && !detailUnavailableReason && !detailResult?.llm_result) {
+      if (!llmConfig) {
+        cardOnlyLlmResult = createMissingLlmConfigResult();
+      } else {
+        try {
+          cardOnlyLlmResult = await callScreeningLlm({
+            candidate: screeningCandidate,
+            criteria,
+            config: llmConfig,
+            timeoutMs: llmTimeoutMs,
+            maxImages: llmImageLimit,
+            imageDetail: llmImageDetail
+          });
+        } catch (error) {
+          cardOnlyLlmResult = createFailedLlmResult(error);
+        }
+      }
+    }
+    const effectiveLlmResult = detailResult?.llm_result || cardOnlyLlmResult;
     const screening = detailUnavailableReason
       ? {
           status: "skip",
@@ -909,8 +949,8 @@ export async function runChatWorkflow({
           reasons: [detailUnavailableReason],
           candidate: screeningCandidate
         }
-      : detailResult?.llm_result
-        ? llmToScreening(detailResult.llm_result, screeningCandidate)
+      : useLlmScreening
+        ? llmToScreening(effectiveLlmResult, screeningCandidate)
         : screenCandidate(screeningCandidate, { criteria });
     let postAction = null;
     if (requestResumeForPassed && screening.passed) {
@@ -931,6 +971,7 @@ export async function runChatWorkflow({
       card_node_id: effectiveCardNodeId,
       candidate: compactCandidate(screeningCandidate),
       detail: compactDetail(detailResult),
+      llm_screening: detailResult ? null : compactLlmResult(cardOnlyLlmResult),
       screening: compactScreening(screening),
       post_action: postAction,
       pre_action_state: preActionState
@@ -951,7 +992,7 @@ export async function runChatWorkflow({
       processed: results.length,
       screened: results.length,
       detail_opened: results.filter(resultOpenedDetail).length,
-      llm_screened: results.filter((item) => item.detail?.llm_screening).length,
+      llm_screened: results.filter((item) => item.detail?.llm_screening || item.llm_screening).length,
       passed: results.filter((item) => item.screening.passed).length,
       requested: requestedCount,
       request_satisfied: requestSatisfiedCount,
@@ -966,6 +1007,7 @@ export async function runChatWorkflow({
       last_score: screening.score
     });
     runControl.checkpoint({
+      results,
       last_candidate: {
         id: screeningCandidate.id || null,
         key: candidateKey,
@@ -974,7 +1016,8 @@ export async function runChatWorkflow({
           status: screening.status,
           passed: screening.passed,
           score: screening.score
-        }
+        },
+        llm_screening: compactLlmResult(effectiveLlmResult)
       }
     });
 
@@ -1002,7 +1045,7 @@ export async function runChatWorkflow({
     processed: results.length,
     screened: results.length,
     detail_opened: results.filter(resultOpenedDetail).length,
-    llm_screened: results.filter((item) => item.detail?.llm_screening).length,
+    llm_screened: results.filter((item) => item.detail?.llm_screening || item.llm_screening).length,
     passed: results.filter((item) => item.screening.passed).length,
     requested: requestedCount,
     request_satisfied: requestSatisfiedCount,
@@ -1027,7 +1070,7 @@ export function createChatRunService({
     maxCandidates = 5,
     targetPassCount = null,
     processUntilListEnd = false,
-    detailLimit = 0,
+    detailLimit = null,
     detailSource = "cascade",
     closeResume = true,
     requestResumeForPassed = false,
@@ -1046,6 +1089,7 @@ export function createChatRunService({
     llmTimeoutMs = 120000,
     llmImageLimit = 8,
     llmImageDetail = "high",
+    screeningMode = "llm",
     listMaxScrolls = 20,
     listStableSignatureLimit = 2,
     listWheelDeltaY = 850,
@@ -1055,6 +1099,9 @@ export function createChatRunService({
   } = {}) {
     if (!client) throw new Error("startChatRun requires a guarded CDP client");
     const normalizedDetailSource = normalizeDetailSource(detailSource);
+    const normalizedScreeningMode = normalizeScreeningMode(screeningMode);
+    const processedLimit = Math.max(1, Number(maxCandidates) || 1);
+    const normalizedDetailLimit = detailLimit == null ? processedLimit : Math.max(0, Number(detailLimit) || 0);
     return manager.startRun({
       name,
       context: {
@@ -1066,11 +1113,16 @@ export function createChatRunService({
         max_candidates: maxCandidates,
         target_pass_count: targetPassCount,
         process_until_list_end: Boolean(processUntilListEnd),
-        detail_limit: detailLimit,
+        detail_limit: normalizedDetailLimit,
         detail_source: normalizedDetailSource,
         close_resume: closeResume,
         cv_acquisition_mode: cvAcquisitionMode,
         call_llm_on_image: Boolean(callLlmOnImage),
+        screening_mode: normalizedScreeningMode,
+        llm_configured: Boolean(llmConfig),
+        llm_timeout_ms: llmTimeoutMs,
+        llm_image_limit: llmImageLimit,
+        llm_image_detail: llmImageDetail,
         max_image_pages: maxImagePages,
         image_wheel_delta_y: imageWheelDeltaY,
         list_max_scrolls: listMaxScrolls,
@@ -1082,9 +1134,9 @@ export function createChatRunService({
       },
       progress: {
         card_count: 0,
-        target_count: targetPassCount || (processUntilListEnd ? "all" : Math.max(1, Number(maxCandidates) || 1)),
+        target_count: targetPassCount || (processUntilListEnd ? "all" : processedLimit),
         target_pass_count: targetPassCount,
-        processed_limit: Math.max(1, Number(maxCandidates) || 1),
+        processed_limit: processedLimit,
         processed: 0,
         screened: 0,
         detail_opened: 0,
@@ -1104,7 +1156,7 @@ export function createChatRunService({
         maxCandidates,
         targetPassCount,
         processUntilListEnd,
-        detailLimit,
+        detailLimit: normalizedDetailLimit,
         detailSource: normalizedDetailSource,
         closeResume,
         requestResumeForPassed,
@@ -1123,6 +1175,7 @@ export function createChatRunService({
         llmTimeoutMs,
         llmImageLimit,
         llmImageDetail,
+        screeningMode: normalizedScreeningMode,
         listMaxScrolls,
         listStableSignatureLimit,
         listWheelDeltaY,