@reconcrap/boss-recommend-mcp 1.1.4 → 1.1.6

package/src/pipeline.js

@@ -1,17 +1,18 @@
 import path from "node:path";
 import { parseRecommendInstruction } from "./parser.js";
-import {
-  attemptPipelineAutoRepair,
-  ensureBossRecommendPageReady,
-  listRecommendJobs,
-  reloadBossRecommendPage,
-  runPipelinePreflight,
-  runRecommendSearchCli,
-  runRecommendScreenCli
-} from "./adapters.js";
-
-const FORCED_RECENT_NOT_VIEW_ON_SCREEN_RECOVERY = "近14天没有";
-const MAX_SCREEN_AUTO_RECOVERY_ATTEMPTS = 5;
+import {
+  attemptPipelineAutoRepair,
+  ensureBossRecommendPageReady,
+  listRecommendJobs,
+  refreshBossRecommendList,
+  reloadBossRecommendPage,
+  runPipelinePreflight,
+  runRecommendSearchCli,
+  runRecommendScreenCli
+} from "./adapters.js";
+
+const FORCED_RECENT_NOT_VIEW_ON_SCREEN_RECOVERY = "近14天没有";
+const MAX_SCREEN_AUTO_RECOVERY_ATTEMPTS = 5;
 
 function dedupe(values = []) {
   return [...new Set(values.filter(Boolean))];
@@ -114,7 +115,8 @@ function collectNpmInstallDirs(checks = [], workspaceRoot) {
   const npmCheckKeys = new Set([
     "npm_dep_chrome_remote_interface_search",
     "npm_dep_chrome_remote_interface_screen",
-    "npm_dep_ws"
+    "npm_dep_ws",
+    "npm_dep_sharp"
   ]);
   const dirs = checks
     .filter((item) => item && item.ok === false && npmCheckKeys.has(item.key))
@@ -156,26 +158,6 @@ function getNodeInstallCommands() {
   ];
 }
 
-function getPythonInstallCommands() {
-  if (process.platform === "win32") {
-    return [
-      "winget install Python.Python.3.12",
-      "python --version"
-    ];
-  }
-  if (process.platform === "darwin") {
-    return [
-      "brew install python",
-      "python3 --version",
-      "若系统无 python 命令，请在当前终端建立 python -> python3 别名后重试。"
-    ];
-  }
-  return [
-    "使用系统包管理器安装 Python（例如 apt / yum / brew）",
-    "python --version"
-  ];
-}
-
 function formatCommandBlock(commands = []) {
   return commands.map((command) => `- ${command}`).join("\n");
 }
@@ -190,9 +172,8 @@ function buildPreflightRecovery(checks = [], workspaceRoot) {
     failed.has("npm_dep_chrome_remote_interface_search")
     || failed.has("npm_dep_chrome_remote_interface_screen")
     || failed.has("npm_dep_ws")
+    || failed.has("npm_dep_sharp")
   );
-  const needPython = failed.has("python_cli");
-  const needPillow = failed.has("python_pillow");
 
   const ordered_steps = [];
   if (needScreenConfig) {
@@ -218,37 +199,16 @@ function buildPreflightRecovery(checks = [], workspaceRoot) {
   if (needNpm) {
     ordered_steps.push({
       id: "install_npm_dependencies",
-      title: "安装 npm 依赖（chrome-remote-interface / ws）",
+      title: "安装 npm 依赖（chrome-remote-interface / ws / sharp）",
       blocked_by: needNode ? ["install_nodejs"] : [],
       commands: buildNpmInstallCommands(checks, workspaceRoot)
     });
   }
-  if (needPython) {
-    ordered_steps.push({
-      id: "install_python",
-      title: "安装 Python（确保 python 命令可用）",
-      blocked_by: [],
-      commands: getPythonInstallCommands()
-    });
-  }
-  if (needPillow) {
-    ordered_steps.push({
-      id: "install_pillow",
-      title: "安装 Pillow",
-      blocked_by: needPython ? ["install_python"] : [],
-      commands: [
-        "python -m pip install --upgrade pip",
-        "python -m pip install pillow"
-      ]
-    });
-  }
 
   const promptLines = [
     "你是环境修复 agent。请先读取 diagnostics.checks，再严格按下面顺序执行，不要并行跳步：",
     "1) node_cli 失败 -> 先安装 Node.js，未成功前禁止执行 npm install。",
-    "2) npm_dep_* 失败 -> 再安装 npm 依赖（chrome-remote-interface / ws）。",
-    "3) python_cli 失败 -> 安装 Python 并确保 python 命令可用。",
-    "4) python_pillow 失败 -> 最后安装 Pillow。",
+    "2) npm_dep_* 失败 -> 再安装 npm 依赖（chrome-remote-interface / ws / sharp）。",
     "每一步完成后都重新运行 doctor，直到所有检查通过后再重试流水线。"
   ];
   if (needScreenConfig) {
@@ -494,16 +454,17 @@ function buildChromeSetupGuidance({ debugPort, pageState }) {
   };
 }
 
-const defaultDependencies = {
-  attemptPipelineAutoRepair,
-  parseRecommendInstruction,
-  ensureBossRecommendPageReady,
-  listRecommendJobs,
-  reloadBossRecommendPage,
-  runPipelinePreflight,
-  runRecommendSearchCli,
-  runRecommendScreenCli
-};
+const defaultDependencies = {
+  attemptPipelineAutoRepair,
+  parseRecommendInstruction,
+  ensureBossRecommendPageReady,
+  listRecommendJobs,
+  refreshBossRecommendList,
+  reloadBossRecommendPage,
+  runPipelinePreflight,
+  runRecommendSearchCli,
+  runRecommendScreenCli
+};
 
 export async function runRecommendPipeline(
   { workspaceRoot, instruction, confirmation, overrides, resume = null },
@@ -512,16 +473,17 @@ export async function runRecommendPipeline(
 ) {
   const injectedDependencies = dependencies || {};
   const resolvedDependencies = { ...defaultDependencies, ...(dependencies || {}) };
-  const {
-    attemptPipelineAutoRepair: attemptAutoRepair,
-    parseRecommendInstruction: parseInstruction,
-    ensureBossRecommendPageReady: ensureRecommendPageReady,
-    listRecommendJobs: listJobs,
-    reloadBossRecommendPage: reloadRecommendPage,
-    runPipelinePreflight: runPreflight,
-    runRecommendSearchCli: searchCli,
-    runRecommendScreenCli: screenCli
-  } = resolvedDependencies;
+  const {
+    attemptPipelineAutoRepair: attemptAutoRepair,
+    parseRecommendInstruction: parseInstruction,
+    ensureBossRecommendPageReady: ensureRecommendPageReady,
+    listRecommendJobs: listJobs,
+    refreshBossRecommendList: refreshRecommendList,
+    reloadBossRecommendPage: reloadRecommendPage,
+    runPipelinePreflight: runPreflight,
+    runRecommendSearchCli: searchCli,
+    runRecommendScreenCli: screenCli
+  } = resolvedDependencies;
   const runtimeHooks = createPipelineRuntime(runtime);
   ensurePipelineNotAborted(runtimeHooks.signal);
 
@@ -811,300 +773,413 @@ export async function runRecommendPipeline(
     };
   }
 
-  const resumeCompletionReason = normalizeText(resume?.previous_completion_reason || "").toLowerCase();
-  const isResumeRun = resume?.resume === true;
-  const resumeFromPausedBeforeScreen = isResumeRun && resumeCompletionReason === "paused_before_screen";
-  const skipSearchOnResume = isResumeRun && !resumeFromPausedBeforeScreen;
-  let effectiveSearchParams = { ...parsed.searchParams };
-  let searchSummary = null;
-  let shouldRunSearch = !skipSearchOnResume;
-  let screenAutoRecoveryCount = 0;
-  let lastAutoRecovery = null;
-  let currentResumeConfig = {
-    checkpoint_path: resume?.checkpoint_path || null,
-    pause_control_path: resume?.pause_control_path || null,
-    output_csv: resume?.output_csv || null,
-    resume: resume?.resume === true,
-    require_checkpoint: skipSearchOnResume
-  };
-
-  while (true) {
-    if (shouldRunSearch) {
-      ensurePipelineNotAborted(runtimeHooks.signal);
-      runtimeHooks.setStage(
-        "search",
-        screenAutoRecoveryCount > 0
-          ? `自动恢复第 ${screenAutoRecoveryCount} 次：重新执行 recommend search（强制 recent_not_view=${FORCED_RECENT_NOT_VIEW_ON_SCREEN_RECOVERY}）。`
-          : "岗位已确认，开始执行 recommend search。"
-      );
-      runtimeHooks.heartbeat("search", lastAutoRecovery);
-      const searchResult = await searchCli({
-        workspaceRoot,
-        searchParams: effectiveSearchParams,
-        selectedJob: selectedJobToken,
-        runtime: runtimeHooks.adapterRuntime("search")
-      });
-      ensurePipelineNotAborted(runtimeHooks.signal);
-      if (isProcessAbortError(searchResult.error)) {
-        throw new PipelineAbortError(searchResult.error?.message || "推荐筛选已取消。");
-      }
-      if (!searchResult.ok) {
-        const searchErrorCode = String(searchResult.error?.code || "");
-        const searchErrorMessage = String(searchResult.error?.message || "");
-        const loginRelatedSearchFailure = (
-          searchErrorCode === "LOGIN_REQUIRED"
-          || searchErrorCode === "NO_RECOMMEND_IFRAME"
-          || searchErrorMessage.includes("LOGIN_REQUIRED")
-          || searchErrorMessage.includes("NO_RECOMMEND_IFRAME")
-        );
-        if (loginRelatedSearchFailure) {
-          const recheck = await ensureRecommendPageReady(workspaceRoot, {
-            port: preflight.debug_port
-          });
-          if (recheck.state === "LOGIN_REQUIRED" || recheck.state === "LOGIN_REQUIRED_AFTER_REDIRECT") {
-            const guidance = buildChromeSetupGuidance({
-              debugPort: preflight.debug_port,
-              pageState: recheck.page_state
-            });
-            return buildFailedResponse(
-              "BOSS_LOGIN_REQUIRED",
-              "检测到当前 Boss 处于未登录状态，请先登录后再继续。登录页：https://www.zhipin.com/web/user/?ka=bticket",
-              {
-                search_params: effectiveSearchParams,
-                screen_params: parsed.screenParams,
-                selected_job: selectedJob,
-                required_user_action: "prepare_boss_recommend_page",
-                guidance,
-                diagnostics: {
-                  debug_port: preflight.debug_port,
-                  page_state: recheck.page_state,
-                  stdout: searchResult.stdout?.slice(-1000),
-                  stderr: searchResult.stderr?.slice(-1000),
-                  result: searchResult.structured || null,
-                  auto_recovery: lastAutoRecovery
-                }
-              }
-            );
-          }
-        }
-        return buildFailedResponse(
-          searchResult.error?.code || "RECOMMEND_SEARCH_FAILED",
-          searchResult.error?.message || "推荐页筛选执行失败。",
-          {
-            search_params: effectiveSearchParams,
-            screen_params: parsed.screenParams,
-            selected_job: selectedJob,
-            diagnostics: {
-              debug_port: preflight.debug_port,
-              stdout: searchResult.stdout?.slice(-1000),
-              stderr: searchResult.stderr?.slice(-1000),
-              result: searchResult.structured || null,
-              auto_recovery: lastAutoRecovery
-            }
-          }
-        );
-      }
-
-      searchSummary = searchResult.summary || {};
-      if (isPauseRequested(runtimeHooks)) {
-        return buildPausedResponse("已在 screen 阶段开始前暂停 Recommend 流水线。", {
-          search_params: effectiveSearchParams,
-          screen_params: parsed.screenParams,
-          selected_job: selectedJob,
-          partial_result: {
-            candidate_count: searchSummary.candidate_count ?? null,
-            applied_filters: searchSummary.applied_filters || effectiveSearchParams,
-            output_csv: currentResumeConfig.output_csv || null,
-            completion_reason: "paused_before_screen"
-          }
-        });
-      }
-      ensurePipelineNotAborted(runtimeHooks.signal);
-      runtimeHooks.setStage("screen", "search 完成，开始执行 recommend screen。");
-    } else {
-      ensurePipelineNotAborted(runtimeHooks.signal);
-      runtimeHooks.setStage("screen", "检测到可续跑 checkpoint，跳过 search，直接恢复 recommend screen。");
-    }
-
-    runtimeHooks.heartbeat("screen", lastAutoRecovery);
-    const screenResult = await screenCli({
-      workspaceRoot,
-      screenParams: parsed.screenParams,
-      resume: currentResumeConfig,
-      runtime: runtimeHooks.adapterRuntime("screen")
-    });
-    ensurePipelineNotAborted(runtimeHooks.signal);
-    if (isProcessAbortError(screenResult.error)) {
-      throw new PipelineAbortError(screenResult.error?.message || "推荐筛选已取消。");
-    }
-    if (screenResult.paused) {
-      return buildPausedResponse("Recommend 流水线已暂停，可使用 resume 继续。", {
-        search_params: effectiveSearchParams,
-        screen_params: parsed.screenParams,
-        selected_job: selectedJob,
-        partial_result: screenResult.summary || screenResult.structured?.result || null
-      });
-    }
-    if (!screenResult.ok) {
-      const partialScreenResult = screenResult.summary || screenResult.structured?.result || null;
-      const resumeOutputCsv = normalizeText(partialScreenResult?.output_csv || currentResumeConfig.output_csv || "");
-      const hasCheckpointForRecovery = Boolean(normalizeText(currentResumeConfig.checkpoint_path || ""));
-      const shouldAutoRecover = (
-        screenResult.error?.code === "RESUME_CAPTURE_FAILED_CONSECUTIVE_LIMIT"
-        && screenAutoRecoveryCount < MAX_SCREEN_AUTO_RECOVERY_ATTEMPTS
-        && hasCheckpointForRecovery
-        && Boolean(resumeOutputCsv)
-      );
-
-      if (shouldAutoRecover) {
-        screenAutoRecoveryCount += 1;
-        effectiveSearchParams = {
-          ...effectiveSearchParams,
-          recent_not_view: FORCED_RECENT_NOT_VIEW_ON_SCREEN_RECOVERY
-        };
-        lastAutoRecovery = {
-          trigger: "RESUME_CAPTURE_FAILED_CONSECUTIVE_LIMIT",
-          attempt: screenAutoRecoveryCount,
-          max_attempts: MAX_SCREEN_AUTO_RECOVERY_ATTEMPTS,
-          original_recent_not_view: parsed.searchParams.recent_not_view,
-          effective_recent_not_view: effectiveSearchParams.recent_not_view,
-          partial_result: partialScreenResult
-            ? {
-                processed_count: partialScreenResult.processed_count ?? null,
-                passed_count: partialScreenResult.passed_count ?? null,
-                skipped_count: partialScreenResult.skipped_count ?? null,
-                output_csv: partialScreenResult.output_csv || currentResumeConfig.output_csv || null
-              }
-            : null
-        };
-
-        runtimeHooks.setStage(
-          "screen_recovery",
-          `screen 连续截图失败，开始自动恢复（第 ${screenAutoRecoveryCount} 次）：刷新 recommend 页面并重跑 search。`
-        );
-        runtimeHooks.heartbeat("screen_recovery", lastAutoRecovery);
-
-        const reloadResult = typeof reloadRecommendPage === "function"
-          ? await reloadRecommendPage(workspaceRoot, {
-              port: preflight.debug_port
-            })
-          : null;
-        ensurePipelineNotAborted(runtimeHooks.signal);
-
-        lastAutoRecovery = {
-          ...lastAutoRecovery,
-          reload: reloadResult
-            ? {
-                ok: reloadResult.ok,
-                state: reloadResult.state || null,
-                message: reloadResult.message || null,
-                reloaded_url: reloadResult.reloaded_url || null
-              }
-            : null
-        };
-
-        const recoveryPageCheck = await ensureRecommendPageReady(workspaceRoot, {
-          port: preflight.debug_port
-        });
-        ensurePipelineNotAborted(runtimeHooks.signal);
-        if (!recoveryPageCheck.ok) {
-          const guidance = buildChromeSetupGuidance({
-            debugPort: preflight.debug_port,
-            pageState: recoveryPageCheck.page_state
-          });
-          return buildFailedResponse(
-            recoveryPageCheck.state === "LOGIN_REQUIRED" || recoveryPageCheck.state === "LOGIN_REQUIRED_AFTER_REDIRECT"
-              ? "BOSS_LOGIN_REQUIRED"
-              : recoveryPageCheck.state === "DEBUG_PORT_UNREACHABLE"
-                ? "BOSS_CHROME_NOT_CONNECTED"
-                : "BOSS_RECOMMEND_PAGE_NOT_READY",
-            "自动恢复时无法重新就绪 recommend 页面，请先处理页面状态后再继续。",
-            {
-              search_params: effectiveSearchParams,
-              screen_params: parsed.screenParams,
-              selected_job: selectedJob,
-              partial_result: partialScreenResult,
-              required_user_action: "prepare_boss_recommend_page",
-              guidance,
-              diagnostics: {
-                debug_port: preflight.debug_port,
-                page_state: recoveryPageCheck.page_state,
-                stdout: screenResult.stdout?.slice(-1000),
-                stderr: screenResult.stderr?.slice(-1000),
-                result: screenResult.structured || null,
-                auto_recovery: lastAutoRecovery
-              }
-            }
-          );
-        }
-
-        currentResumeConfig = {
-          checkpoint_path: currentResumeConfig.checkpoint_path || null,
-          pause_control_path: currentResumeConfig.pause_control_path || null,
-          output_csv: resumeOutputCsv || null,
-          resume: true,
-          require_checkpoint: true
-        };
-        shouldRunSearch = true;
-        searchSummary = null;
-        continue;
-      }
-
-      return buildFailedResponse(
-        screenResult.error?.code || "RECOMMEND_SCREEN_FAILED",
-        screenResult.error?.message || "推荐页筛选执行失败。",
-        {
-          search_params: effectiveSearchParams,
-          screen_params: parsed.screenParams,
-          selected_job: selectedJob,
-          partial_result: partialScreenResult,
-          diagnostics: {
-            debug_port: preflight.debug_port,
-            stdout: screenResult.stdout?.slice(-1000),
-            stderr: screenResult.stderr?.slice(-1000),
-            result: screenResult.structured || null,
-            auto_recovery: lastAutoRecovery
-          }
-        }
-      );
-    }
-
-    runtimeHooks.setStage("finalize", "screen 完成，正在汇总结果。");
-    runtimeHooks.heartbeat("finalize");
-    const durationSec = Math.max(1, Math.round((Date.now() - startedAt) / 1000));
-    const finalSearchSummary = searchSummary || {};
-    const screenSummary = screenResult.summary || {};
-    runtimeHooks.progress("finalize", {
-      processed: screenSummary.processed_count ?? 0,
-      passed: screenSummary.passed_count ?? 0,
-      skipped: screenSummary.skipped_count ?? 0,
-      greet_count: screenSummary.greet_count ?? 0
-    });
-
-    return {
-      status: "COMPLETED",
-      search_params: effectiveSearchParams,
-      screen_params: parsed.screenParams,
-      result: {
-        candidate_count: finalSearchSummary.candidate_count ?? null,
-        applied_filters: finalSearchSummary.applied_filters || effectiveSearchParams,
-        processed_count: screenSummary.processed_count ?? 0,
-        passed_count: screenSummary.passed_count ?? 0,
-        skipped_count: screenSummary.skipped_count ?? 0,
-        duration_sec: durationSec,
-        output_csv: screenSummary.output_csv || null,
-        completion_reason: screenSummary.completion_reason || "screen_completed",
-        page_state: finalSearchSummary.page_state || pageCheck.page_state,
-        selected_job: finalSearchSummary.selected_job || selectedJob,
-        post_action: parsed.screenParams.post_action,
-        max_greet_count: parsed.screenParams.max_greet_count,
-        greet_count: screenSummary.greet_count ?? 0,
-        greet_limit_fallback_count: screenSummary.greet_limit_fallback_count ?? 0,
-        auto_recovery: lastAutoRecovery
-      },
-      message: parsed.screenParams.post_action === "none"
-        ? "Recommend 流水线已完成。本次 post_action=none：符合条件的人选仅记录到 CSV，不执行收藏或打招呼。"
-        : "Recommend 流水线已完成。post_action 在运行开始时已一次性确认；若选择打招呼并设置上限，超出上限后会自动改为收藏。"
-    };
-  }
-}
+  const resumeCompletionReason = normalizeText(resume?.previous_completion_reason || "").toLowerCase();
+  const isResumeRun = resume?.resume === true;
+  const resumeFromPausedBeforeScreen = isResumeRun && resumeCompletionReason === "paused_before_screen";
+  const skipSearchOnResume = isResumeRun && !resumeFromPausedBeforeScreen;
+  let effectiveSearchParams = { ...parsed.searchParams };
+  let searchSummary = null;
+  let shouldRunSearch = !skipSearchOnResume;
+  let screenAutoRecoveryCount = 0;
+  let lastAutoRecovery = null;
+  let currentResumeConfig = {
+    checkpoint_path: resume?.checkpoint_path || null,
+    pause_control_path: resume?.pause_control_path || null,
+    output_csv: resume?.output_csv || null,
+    resume: resume?.resume === true,
+    require_checkpoint: skipSearchOnResume
+  };
+
+  while (true) {
+    if (shouldRunSearch) {
+      ensurePipelineNotAborted(runtimeHooks.signal);
+      runtimeHooks.setStage(
+        "search",
+        screenAutoRecoveryCount > 0
+          ? `自动恢复第 ${screenAutoRecoveryCount} 次：重新执行 recommend search（强制 recent_not_view=${FORCED_RECENT_NOT_VIEW_ON_SCREEN_RECOVERY}）。`
+          : "岗位已确认，开始执行 recommend search。"
+      );
+      runtimeHooks.heartbeat("search", lastAutoRecovery);
+      const searchResult = await searchCli({
+        workspaceRoot,
+        searchParams: effectiveSearchParams,
+        selectedJob: selectedJobToken,
+        runtime: runtimeHooks.adapterRuntime("search")
+      });
+      ensurePipelineNotAborted(runtimeHooks.signal);
+      if (isProcessAbortError(searchResult.error)) {
+        throw new PipelineAbortError(searchResult.error?.message || "推荐筛选已取消。");
+      }
+      if (!searchResult.ok) {
+        const searchErrorCode = String(searchResult.error?.code || "");
+        const searchErrorMessage = String(searchResult.error?.message || "");
+        const loginRelatedSearchFailure = (
+          searchErrorCode === "LOGIN_REQUIRED"
+          || searchErrorCode === "NO_RECOMMEND_IFRAME"
+          || searchErrorMessage.includes("LOGIN_REQUIRED")
+          || searchErrorMessage.includes("NO_RECOMMEND_IFRAME")
+        );
+        if (loginRelatedSearchFailure) {
+          const recheck = await ensureRecommendPageReady(workspaceRoot, {
+            port: preflight.debug_port
+          });
+          if (recheck.state === "LOGIN_REQUIRED" || recheck.state === "LOGIN_REQUIRED_AFTER_REDIRECT") {
+            const guidance = buildChromeSetupGuidance({
+              debugPort: preflight.debug_port,
+              pageState: recheck.page_state
+            });
+            return buildFailedResponse(
+              "BOSS_LOGIN_REQUIRED",
+              "检测到当前 Boss 处于未登录状态，请先登录后再继续。登录页：https://www.zhipin.com/web/user/?ka=bticket",
+              {
+                search_params: effectiveSearchParams,
+                screen_params: parsed.screenParams,
+                selected_job: selectedJob,
+                required_user_action: "prepare_boss_recommend_page",
+                guidance,
+                diagnostics: {
+                  debug_port: preflight.debug_port,
+                  page_state: recheck.page_state,
+                  stdout: searchResult.stdout?.slice(-1000),
+                  stderr: searchResult.stderr?.slice(-1000),
+                  result: searchResult.structured || null,
+                  auto_recovery: lastAutoRecovery
+                }
+              }
+            );
+          }
+        }
+        return buildFailedResponse(
+          searchResult.error?.code || "RECOMMEND_SEARCH_FAILED",
+          searchResult.error?.message || "推荐页筛选执行失败。",
+          {
+            search_params: effectiveSearchParams,
+            screen_params: parsed.screenParams,
+            selected_job: selectedJob,
+            diagnostics: {
+              debug_port: preflight.debug_port,
+              stdout: searchResult.stdout?.slice(-1000),
+              stderr: searchResult.stderr?.slice(-1000),
+              result: searchResult.structured || null,
+              auto_recovery: lastAutoRecovery
+            }
+          }
+        );
+      }
+
+      searchSummary = searchResult.summary || {};
+      if (isPauseRequested(runtimeHooks)) {
+        return buildPausedResponse("已在 screen 阶段开始前暂停 Recommend 流水线。", {
+          search_params: effectiveSearchParams,
+          screen_params: parsed.screenParams,
+          selected_job: selectedJob,
+          partial_result: {
+            candidate_count: searchSummary.candidate_count ?? null,
+            applied_filters: searchSummary.applied_filters || effectiveSearchParams,
+            output_csv: currentResumeConfig.output_csv || null,
+            completion_reason: "paused_before_screen"
+          }
+        });
+      }
+      ensurePipelineNotAborted(runtimeHooks.signal);
+      runtimeHooks.setStage("screen", "search 完成，开始执行 recommend screen。");
+    } else {
+      ensurePipelineNotAborted(runtimeHooks.signal);
+      runtimeHooks.setStage("screen", "检测到可续跑 checkpoint，跳过 search，直接恢复 recommend screen。");
+    }
+
+    runtimeHooks.heartbeat("screen", lastAutoRecovery);
+    const screenResult = await screenCli({
+      workspaceRoot,
+      screenParams: parsed.screenParams,
+      resume: currentResumeConfig,
+      runtime: runtimeHooks.adapterRuntime("screen")
+    });
+    ensurePipelineNotAborted(runtimeHooks.signal);
+    if (isProcessAbortError(screenResult.error)) {
+      throw new PipelineAbortError(screenResult.error?.message || "推荐筛选已取消。");
+    }
+    if (screenResult.paused) {
+      return buildPausedResponse("Recommend 流水线已暂停，可使用 resume 继续。", {
+        search_params: effectiveSearchParams,
+        screen_params: parsed.screenParams,
+        selected_job: selectedJob,
+        partial_result: screenResult.summary || screenResult.structured?.result || null
+      });
+    }
+    if (!screenResult.ok) {
+      const screenErrorCode = String(screenResult.error?.code || "");
+      const partialScreenResult = screenResult.summary || screenResult.structured?.result || null;
+      const resumeOutputCsv = normalizeText(partialScreenResult?.output_csv || currentResumeConfig.output_csv || "");
+      const hasCheckpointForRecovery = Boolean(normalizeText(currentResumeConfig.checkpoint_path || ""));
+      const screenPartialForRecovery = partialScreenResult
+        ? {
+            processed_count: partialScreenResult.processed_count ?? null,
+            passed_count: partialScreenResult.passed_count ?? null,
+            skipped_count: partialScreenResult.skipped_count ?? null,
+            output_csv: partialScreenResult.output_csv || currentResumeConfig.output_csv || null,
+            checkpoint_path: partialScreenResult.checkpoint_path || currentResumeConfig.checkpoint_path || null,
+            completion_reason: partialScreenResult.completion_reason || null
+          }
+        : null;
+      const isResumeCaptureRecovery = screenErrorCode === "RESUME_CAPTURE_FAILED_CONSECUTIVE_LIMIT";
+      const isPageExhaustedRecovery = screenErrorCode === "TARGET_COUNT_NOT_REACHED_PAGE_EXHAUSTED";
+      const isRecoverableScreenFailure = isResumeCaptureRecovery || isPageExhaustedRecovery;
+      const canRecoverSafely = hasCheckpointForRecovery && Boolean(resumeOutputCsv);
+      const hasRecoveryAttemptsRemaining = screenAutoRecoveryCount < MAX_SCREEN_AUTO_RECOVERY_ATTEMPTS;
+
+      if (isRecoverableScreenFailure && !canRecoverSafely) {
+        return buildFailedResponse(
+          "SCREEN_AUTO_RECOVERY_UNSAFE",
+          "检测到 recommend 自动恢复触发，但缺少 checkpoint 或 output_csv，无法安全续跑。",
+          {
+            search_params: effectiveSearchParams,
+            screen_params: parsed.screenParams,
+            selected_job: selectedJob,
+            partial_result: partialScreenResult,
+            diagnostics: {
+              debug_port: preflight.debug_port,
+              stdout: screenResult.stdout?.slice(-1000),
+              stderr: screenResult.stderr?.slice(-1000),
+              result: screenResult.structured || null,
+              auto_recovery: {
+                trigger: screenErrorCode,
+                attempt: screenAutoRecoveryCount,
+                max_attempts: MAX_SCREEN_AUTO_RECOVERY_ATTEMPTS,
+                original_recent_not_view: parsed.searchParams.recent_not_view,
+                effective_recent_not_view: effectiveSearchParams.recent_not_view,
+                partial_result: screenPartialForRecovery
+              }
+            }
+          }
+        );
+      }
+
+      if (isRecoverableScreenFailure && !hasRecoveryAttemptsRemaining) {
+        return buildFailedResponse(
+          screenResult.error?.code || "RECOMMEND_SCREEN_FAILED",
+          `${screenResult.error?.message || "推荐页筛选执行失败。"} 已达到自动恢复上限 ${MAX_SCREEN_AUTO_RECOVERY_ATTEMPTS} 次。`,
+          {
+            search_params: effectiveSearchParams,
+            screen_params: parsed.screenParams,
+            selected_job: selectedJob,
+            partial_result: partialScreenResult,
+            diagnostics: {
+              debug_port: preflight.debug_port,
+              stdout: screenResult.stdout?.slice(-1000),
+              stderr: screenResult.stderr?.slice(-1000),
+              result: screenResult.structured || null,
+              auto_recovery: lastAutoRecovery
+            }
+          }
+        );
+      }
+
+      if (isRecoverableScreenFailure && canRecoverSafely && hasRecoveryAttemptsRemaining) {
+        screenAutoRecoveryCount += 1;
+        lastAutoRecovery = {
+          trigger: screenErrorCode,
+          attempt: screenAutoRecoveryCount,
+          max_attempts: MAX_SCREEN_AUTO_RECOVERY_ATTEMPTS,
+          original_recent_not_view: parsed.searchParams.recent_not_view,
+          effective_recent_not_view: effectiveSearchParams.recent_not_view,
+          partial_result: screenPartialForRecovery,
+          page_exhaustion: screenResult.error?.page_exhaustion || null
+        };
+
+        if (isPageExhaustedRecovery) {
+          runtimeHooks.setStage(
+            "screen_recovery",
+            `推荐列表已到底但未达目标，开始自动补货（第 ${screenAutoRecoveryCount} 次）：优先尝试页内刷新。`
+          );
+          runtimeHooks.heartbeat("screen_recovery", lastAutoRecovery);
+
+          const refreshResult = typeof refreshRecommendList === "function"
+            ? await refreshRecommendList(workspaceRoot, {
+                port: preflight.debug_port
+              })
+            : {
+                ok: false,
+                action: "in_page_refresh",
+                state: "REFRESH_ADAPTER_MISSING",
+                message: "缺少页内刷新适配器。"
+              };
+          ensurePipelineNotAborted(runtimeHooks.signal);
+
+          lastAutoRecovery = {
+            ...lastAutoRecovery,
+            refresh: refreshResult
+              ? {
+                  ok: refreshResult.ok,
+                  state: refreshResult.state || null,
+                  message: refreshResult.message || null,
+                  before_state: refreshResult.before_state || null,
+                  after_state: refreshResult.after_state || null
+                }
+              : null
+          };
+
+          if (refreshResult?.ok) {
+            lastAutoRecovery = {
+              ...lastAutoRecovery,
+              action: "in_page_refresh"
+            };
+            currentResumeConfig = {
+              checkpoint_path: currentResumeConfig.checkpoint_path || null,
+              pause_control_path: currentResumeConfig.pause_control_path || null,
+              output_csv: resumeOutputCsv || null,
+              resume: true,
+              require_checkpoint: true
+            };
+            shouldRunSearch = false;
+            searchSummary = null;
+            continue;
+          }
+
+          runtimeHooks.setStage(
+            "screen_recovery",
+            `页内刷新不可用（${refreshResult?.state || "unknown"}），改为刷新 recommend 页面并重跑 search。`
+          );
+          runtimeHooks.heartbeat("screen_recovery", lastAutoRecovery);
+        } else {
+          runtimeHooks.setStage(
+            "screen_recovery",
+            `screen 连续截图失败，开始自动恢复（第 ${screenAutoRecoveryCount} 次）：刷新 recommend 页面并重跑 search。`
+          );
+          runtimeHooks.heartbeat("screen_recovery", lastAutoRecovery);
+        }
+
+        effectiveSearchParams = {
+          ...effectiveSearchParams,
+          recent_not_view: FORCED_RECENT_NOT_VIEW_ON_SCREEN_RECOVERY
+        };
+        lastAutoRecovery = {
+          ...lastAutoRecovery,
+          action: "reload_page_and_rerun_search",
+          effective_recent_not_view: effectiveSearchParams.recent_not_view
+        };
+
+        const reloadResult = typeof reloadRecommendPage === "function"
+          ? await reloadRecommendPage(workspaceRoot, {
+              port: preflight.debug_port
+            })
+          : null;
+        ensurePipelineNotAborted(runtimeHooks.signal);
+
+        lastAutoRecovery = {
+          ...lastAutoRecovery,
+          reload: reloadResult
+            ? {
+                ok: reloadResult.ok,
+                state: reloadResult.state || null,
+                message: reloadResult.message || null,
+                reloaded_url: reloadResult.reloaded_url || null
+              }
+            : null
+        };
+
+        const recoveryPageCheck = await ensureRecommendPageReady(workspaceRoot, {
+          port: preflight.debug_port
+        });
+        ensurePipelineNotAborted(runtimeHooks.signal);
+        if (!recoveryPageCheck.ok) {
+          const guidance = buildChromeSetupGuidance({
+            debugPort: preflight.debug_port,
+            pageState: recoveryPageCheck.page_state
+          });
+          return buildFailedResponse(
+            recoveryPageCheck.state === "LOGIN_REQUIRED" || recoveryPageCheck.state === "LOGIN_REQUIRED_AFTER_REDIRECT"
+              ? "BOSS_LOGIN_REQUIRED"
+              : recoveryPageCheck.state === "DEBUG_PORT_UNREACHABLE"
+                ? "BOSS_CHROME_NOT_CONNECTED"
+                : "BOSS_RECOMMEND_PAGE_NOT_READY",
+            "自动恢复时无法重新就绪 recommend 页面，请先处理页面状态后再继续。",
+            {
+              search_params: effectiveSearchParams,
+              screen_params: parsed.screenParams,
+              selected_job: selectedJob,
+              partial_result: partialScreenResult,
+              required_user_action: "prepare_boss_recommend_page",
+              guidance,
+              diagnostics: {
+                debug_port: preflight.debug_port,
+                page_state: recoveryPageCheck.page_state,
+                stdout: screenResult.stdout?.slice(-1000),
+                stderr: screenResult.stderr?.slice(-1000),
+                result: screenResult.structured || null,
+                auto_recovery: lastAutoRecovery
+              }
+            }
+          );
+        }
+
+        currentResumeConfig = {
+          checkpoint_path: currentResumeConfig.checkpoint_path || null,
+          pause_control_path: currentResumeConfig.pause_control_path || null,
+          output_csv: resumeOutputCsv || null,
+          resume: true,
+          require_checkpoint: true
+        };
+        shouldRunSearch = true;
+        searchSummary = null;
+        continue;
+      }
+
+      return buildFailedResponse(
+        screenResult.error?.code || "RECOMMEND_SCREEN_FAILED",
+        screenResult.error?.message || "推荐页筛选执行失败。",
+        {
+          search_params: effectiveSearchParams,
+          screen_params: parsed.screenParams,
+          selected_job: selectedJob,
+          partial_result: partialScreenResult,
+          diagnostics: {
+            debug_port: preflight.debug_port,
+            stdout: screenResult.stdout?.slice(-1000),
+            stderr: screenResult.stderr?.slice(-1000),
+            result: screenResult.structured || null,
+            auto_recovery: lastAutoRecovery
+          }
+        }
+      );
+    }
+
+    runtimeHooks.setStage("finalize", "screen 完成，正在汇总结果。");
+    runtimeHooks.heartbeat("finalize");
+    const durationSec = Math.max(1, Math.round((Date.now() - startedAt) / 1000));
+    const finalSearchSummary = searchSummary || {};
+    const screenSummary = screenResult.summary || {};
+    runtimeHooks.progress("finalize", {
+      processed: screenSummary.processed_count ?? 0,
+      passed: screenSummary.passed_count ?? 0,
+      skipped: screenSummary.skipped_count ?? 0,
+      greet_count: screenSummary.greet_count ?? 0
+    });
+
+    return {
+      status: "COMPLETED",
+      search_params: effectiveSearchParams,
+      screen_params: parsed.screenParams,
+      result: {
+        candidate_count: finalSearchSummary.candidate_count ?? null,
+        applied_filters: finalSearchSummary.applied_filters || effectiveSearchParams,
+        processed_count: screenSummary.processed_count ?? 0,
+        passed_count: screenSummary.passed_count ?? 0,
+        skipped_count: screenSummary.skipped_count ?? 0,
+        duration_sec: durationSec,
+        output_csv: screenSummary.output_csv || null,
+        completion_reason: screenSummary.completion_reason || "screen_completed",
+        page_state: finalSearchSummary.page_state || pageCheck.page_state,
+        selected_job: finalSearchSummary.selected_job || selectedJob,
+        post_action: parsed.screenParams.post_action,
+        max_greet_count: parsed.screenParams.max_greet_count,
+        greet_count: screenSummary.greet_count ?? 0,
+        greet_limit_fallback_count: screenSummary.greet_limit_fallback_count ?? 0,
+        auto_recovery: lastAutoRecovery
+      },
+      message: parsed.screenParams.post_action === "none"
+        ? "Recommend 流水线已完成。本次 post_action=none：符合条件的人选仅记录到 CSV，不执行收藏或打招呼。"
+        : "Recommend 流水线已完成。post_action 在运行开始时已一次性确认；若选择打招呼并设置上限，超出上限后会自动改为收藏。"
+    };
+  }
+}