@reconcrap/boss-recommend-mcp 1.2.5 → 1.2.6

package/package.json

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

package/src/adapters.js

@@ -1343,15 +1343,21 @@ function findChromeOnboardingUrl(tabs) {
   return null;
 }
 
-function isBossLoginTab(tab) {
-  const url = String(tab?.url || "");
-  const title = String(tab?.title || "");
-  return (
-    url === bossLoginUrl
-    || bossLoginUrlPattern.test(url)
-    || bossLoginTitlePattern.test(title)
-  );
-}
+function isBossLoginTab(tab) {
+  const url = String(tab?.url || "");
+  const title = String(tab?.title || "");
+  return (
+    url === bossLoginUrl
+    || bossLoginUrlPattern.test(url)
+    || bossLoginTitlePattern.test(title)
+  );
+}
+
+function findRecommendTab(tabs = []) {
+  return tabs.find(
+    (tab) => typeof tab?.url === "string" && tab.url.includes("/web/chat/recommend")
+  ) || null;
+}
 
 export async function inspectBossRecommendPageState(port, options = {}) {
   const timeoutMs = Number.isFinite(options.timeoutMs) ? options.timeoutMs : 6000;
@@ -1365,9 +1371,7 @@ export async function inspectBossRecommendPageState(port, options = {}) {
     try {
       const tabs = await listChromeTabs(port);
       lastTabs = tabs;
-      const exactTab = tabs.find(
-        (tab) => typeof tab?.url === "string" && tab.url.includes("/web/chat/recommend")
-      );
+      const exactTab = findRecommendTab(tabs);
       if (exactTab) {
         if (isBossLoginTab(exactTab)) {
           return buildBossPageState({
@@ -1498,36 +1502,287 @@ async function openBossRecommendTab(port) {
   };
 }
 
-async function verifyRecommendPageStable(port, options = {}) {
-  const settleMs = Number.isFinite(options.settleMs) ? options.settleMs : 1500;
-  const recheckTimeoutMs = Number.isFinite(options.recheckTimeoutMs) ? options.recheckTimeoutMs : 2500;
-  const pollMs = Number.isFinite(options.pollMs) ? options.pollMs : 600;
+async function verifyRecommendPageStable(port, options = {}) {
+  const settleMs = Number.isFinite(options.settleMs) ? options.settleMs : 1500;
+  const recheckTimeoutMs = Number.isFinite(options.recheckTimeoutMs) ? options.recheckTimeoutMs : 2500;
+  const pollMs = Number.isFinite(options.pollMs) ? options.pollMs : 600;
 
   await sleep(settleMs);
-  const recheck = await inspectBossRecommendPageState(port, {
-    timeoutMs: recheckTimeoutMs,
-    pollMs
-  });
-  if (recheck.state === "RECOMMEND_READY") {
-    return recheck;
-  }
-  if (recheck.state === "LOGIN_REQUIRED") {
-    return buildBossPageState({
-      ...recheck,
-      state: "LOGIN_REQUIRED_AFTER_REDIRECT",
+  const recheck = await inspectBossRecommendPageState(port, {
+    timeoutMs: recheckTimeoutMs,
+    pollMs
+  });
+  if (recheck.state === "RECOMMEND_READY") {
+    const iframeState = await waitForRecommendIframeReady(port, {
+      timeoutMs: recheckTimeoutMs,
+      pollMs
+    });
+    if (iframeState.state === "RECOMMEND_IFRAME_READY") {
+      return buildBossPageState({
+        ...recheck,
+        ok: true,
+        state: "RECOMMEND_READY",
+        frame_url: iframeState.frame_url || null,
+        iframe_state: iframeState
+      });
+    }
+    if (iframeState.state === "LOGIN_REQUIRED") {
+      return buildBossPageState({
+        ...iframeState,
+        state: "LOGIN_REQUIRED_AFTER_REDIRECT",
+        message: "Boss 页面曾进入 recommend 但 iframe 不可用且出现登录态特征，通常表示登录态失效。"
+      });
+    }
+    if (iframeState.state === "NO_RECOMMEND_IFRAME") {
+      return buildBossPageState({
+        ...recheck,
+        ok: false,
+        state: "NO_RECOMMEND_IFRAME",
+        current_url: iframeState.current_url || recheck.current_url || null,
+        title: iframeState.title || recheck.title || null,
+        frame_url: iframeState.frame_url || null,
+        iframe_state: iframeState,
+        message: "Boss recommend 页面已打开，但 recommend iframe 尚未就绪。"
+      });
+    }
+    return iframeState;
+  }
+  if (recheck.state === "LOGIN_REQUIRED") {
+    return buildBossPageState({
+      ...recheck,
+      state: "LOGIN_REQUIRED_AFTER_REDIRECT",
       message: "Boss 页面曾进入 recommend 但随后跳转到其他页面，通常表示登录态失效。"
     });
-  }
-  return recheck;
-}
-
-function pickBossRecommendReloadTarget(tabs = []) {
-  return tabs.find(
-    (tab) => typeof tab?.url === "string" && tab.url.includes("/web/chat/recommend")
-  ) || tabs.find(
-    (tab) => typeof tab?.url === "string" && tab.url.includes("zhipin.com")
-  ) || null;
-}
+  }
+  return recheck;
+}
+
+function buildRecommendIframeProbeExpression() {
+  return `(() => {
+    const currentUrl = (() => {
+      try { return String(window.location.href || ""); } catch { return ""; }
+    })();
+    const title = (() => {
+      try { return String(document.title || ""); } catch { return ""; }
+    })();
+    const isLogin = ${bossLoginUrlPattern}.test(currentUrl)
+      || ${bossLoginTitlePattern}.test(title);
+    if (isLogin) {
+      return {
+        ok: false,
+        error: "LOGIN_REQUIRED",
+        current_url: currentUrl || ${JSON.stringify(bossLoginUrl)},
+        title
+      };
+    }
+    const frame = document.querySelector('iframe[name="recommendFrame"]')
+      || document.querySelector('iframe[src*="/web/frame/recommend/"]')
+      || document.querySelector('iframe');
+    const frameUrl = (() => {
+      try {
+        return String(frame?.contentWindow?.location?.href || frame?.src || "");
+      } catch {
+        return String(frame?.src || "");
+      }
+    })();
+    const iframeCount = document.querySelectorAll("iframe").length;
+    if (!frame || !frame.contentDocument) {
+      return {
+        ok: false,
+        error: "NO_RECOMMEND_IFRAME",
+        current_url: currentUrl,
+        title,
+        frame_url: frameUrl,
+        frame_present: Boolean(frame),
+        iframe_count: iframeCount
+      };
+    }
+    return {
+      ok: true,
+      current_url: currentUrl,
+      title,
+      frame_url: frameUrl,
+      frame_present: true,
+      iframe_count: iframeCount
+    };
+  })()`;
+}
+
+async function probeRecommendIframeState(port, options = {}) {
+  const expectedUrl = options.expectedUrl || bossRecommendUrl;
+  let client = null;
+  try {
+    const tabs = await listChromeTabs(port);
+    const exactTab = findRecommendTab(tabs);
+    if (!exactTab) {
+      const loginTab = tabs.find((tab) => isBossLoginTab(tab));
+      if (loginTab) {
+        return buildBossPageState({
+          ok: false,
+          state: "LOGIN_REQUIRED",
+          path: loginTab.url || bossLoginUrl,
+          current_url: loginTab.url || bossLoginUrl,
+          title: loginTab.title || null,
+          requires_login: true,
+          expected_url: expectedUrl,
+          login_url: bossLoginUrl,
+          message: "Boss 页面未登录，需先完成登录后再进入 recommend 页面。"
+        });
+      }
+      const bossTab = tabs.find(
+        (tab) => typeof tab?.url === "string" && tab.url.includes("zhipin.com")
+      );
+      if (bossTab) {
+        return buildBossPageState({
+          ok: false,
+          state: "BOSS_NOT_ON_RECOMMEND",
+          path: bossTab.url,
+          current_url: bossTab.url,
+          title: bossTab.title || null,
+          requires_login: false,
+          expected_url: expectedUrl,
+          message: "Boss 已登录但当前不在 recommend 页面。"
+        });
+      }
+      return buildBossPageState({
+        ok: false,
+        state: "BOSS_TAB_NOT_FOUND",
+        path: expectedUrl,
+        current_url: null,
+        title: null,
+        requires_login: false,
+        expected_url: expectedUrl,
+        message: "未检测到 Boss 推荐页标签页。",
+        sample_urls: extractSampleUrls(tabs)
+      });
+    }
+    if (isBossLoginTab(exactTab)) {
+      return buildBossPageState({
+        ok: false,
+        state: "LOGIN_REQUIRED",
+        path: exactTab.url || bossLoginUrl,
+        current_url: exactTab.url || bossLoginUrl,
+        title: exactTab.title || null,
+        requires_login: true,
+        expected_url: expectedUrl,
+        login_url: bossLoginUrl,
+        message: "当前标签页虽在 recommend 路径，但检测到登录态页面特征，请先完成 Boss 登录。"
+      });
+    }
+
+    client = await CDP({ port, target: exactTab });
+    const { Runtime, Page } = client;
+    if (Runtime && typeof Runtime.enable === "function") {
+      await Runtime.enable();
+    }
+    if (Page && typeof Page.enable === "function") {
+      await Page.enable();
+    }
+    const frameProbe = await evaluateCdpExpression(client, buildRecommendIframeProbeExpression());
+    if (frameProbe?.ok) {
+      return buildBossPageState({
+        ok: true,
+        state: "RECOMMEND_IFRAME_READY",
+        path: frameProbe.current_url || exactTab.url || expectedUrl,
+        current_url: frameProbe.current_url || exactTab.url || null,
+        title: frameProbe.title || exactTab.title || null,
+        expected_url: expectedUrl,
+        frame_url: frameProbe.frame_url || null,
+        frame_present: frameProbe.frame_present === true,
+        iframe_count: Number.isFinite(Number(frameProbe.iframe_count))
+          ? Number(frameProbe.iframe_count)
+          : null,
+        message: "Boss 推荐页 iframe 已就绪。"
+      });
+    }
+    if (frameProbe?.error === "LOGIN_REQUIRED") {
+      return buildBossPageState({
+        ok: false,
+        state: "LOGIN_REQUIRED",
+        path: frameProbe.current_url || exactTab.url || bossLoginUrl,
+        current_url: frameProbe.current_url || exactTab.url || bossLoginUrl,
+        title: frameProbe.title || exactTab.title || null,
+        requires_login: true,
+        expected_url: expectedUrl,
+        login_url: bossLoginUrl,
+        message: "页面检测到登录态特征，请先完成 Boss 登录。"
+      });
+    }
+    return buildBossPageState({
+      ok: false,
+      state: frameProbe?.error || "NO_RECOMMEND_IFRAME",
+      path: frameProbe?.current_url || exactTab.url || expectedUrl,
+      current_url: frameProbe?.current_url || exactTab.url || null,
+      title: frameProbe?.title || exactTab.title || null,
+      expected_url: expectedUrl,
+      frame_url: frameProbe?.frame_url || null,
+      frame_present: frameProbe?.frame_present === true,
+      iframe_count: Number.isFinite(Number(frameProbe?.iframe_count))
+        ? Number(frameProbe.iframe_count)
+        : null,
+      message: "recommend iframe 暂不可用。"
+    });
+  } catch (error) {
+    return buildBossPageState({
+      ok: false,
+      state: "DEBUG_PORT_UNREACHABLE",
+      path: `http://127.0.0.1:${port}`,
+      current_url: null,
+      title: null,
+      requires_login: false,
+      expected_url: expectedUrl,
+      message: `无法连接到 Chrome DevTools 端口 ${port}。请确认 Chrome 已以远程调试模式启动。`,
+      error: error?.message || String(error)
+    });
+  } finally {
+    if (client) {
+      try {
+        await client.close();
+      } catch {}
+    }
+  }
+}
+
+async function waitForRecommendIframeReady(port, options = {}) {
+  const timeoutMs = Number.isFinite(options.timeoutMs) ? options.timeoutMs : 3000;
+  const pollMs = Number.isFinite(options.pollMs) ? options.pollMs : 600;
+  const expectedUrl = options.expectedUrl || bossRecommendUrl;
+  const deadline = Date.now() + timeoutMs;
+  let lastState = null;
+
+  while (Date.now() < deadline) {
+    lastState = await probeRecommendIframeState(port, { expectedUrl });
+    if (lastState?.state === "RECOMMEND_IFRAME_READY") {
+      return lastState;
+    }
+    if (
+      lastState?.state === "LOGIN_REQUIRED"
+      || lastState?.state === "LOGIN_REQUIRED_AFTER_REDIRECT"
+      || lastState?.state === "DEBUG_PORT_UNREACHABLE"
+      || lastState?.state === "BOSS_TAB_NOT_FOUND"
+      || lastState?.state === "BOSS_NOT_ON_RECOMMEND"
+    ) {
+      return lastState;
+    }
+    await sleep(pollMs);
+  }
+
+  return lastState || buildBossPageState({
+    ok: false,
+    state: "NO_RECOMMEND_IFRAME",
+    path: expectedUrl,
+    current_url: null,
+    title: null,
+    expected_url: expectedUrl,
+    message: "recommend iframe 尚未就绪。"
+  });
+}
+
+function pickBossRecommendReloadTarget(tabs = []) {
+  return findRecommendTab(tabs) || tabs.find(
+    (tab) => typeof tab?.url === "string" && tab.url.includes("zhipin.com")
+  ) || null;
+}
 
 async function evaluateCdpExpression(client, expression) {
   const result = await client.Runtime.evaluate({

package/src/pipeline.js

@@ -16,6 +16,8 @@ import {
 
 const FORCED_RECENT_NOT_VIEW_ON_SCREEN_RECOVERY = "近14天没有";
 const MAX_SCREEN_AUTO_RECOVERY_ATTEMPTS = 5;
+const MAX_SEARCH_NO_IFRAME_RETRY_ATTEMPTS = 1;
+const SEARCH_NO_IFRAME_RETRY_DELAY_MS = 1200;
 const PAGE_SCOPE_TO_TAB_STATUS = {
   recommend: "0",
   latest: "1",
@@ -40,6 +42,10 @@ function normalizeText(value) {
   return String(value || "").replace(/\s+/g, " ").trim();
 }
 
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 function normalizePageScope(value) {
   const normalized = normalizeText(value).toLowerCase();
   if (!normalized) return null;
@@ -886,6 +892,7 @@ export async function runRecommendPipeline(
   let shouldRunSearch = !skipSearchOnResume;
   let screenAutoRecoveryCount = 0;
   let lastAutoRecovery = null;
+  let searchNoIframeRetryCount = 0;
   let activeTabStatus = null;
   let currentResumeConfig = {
     checkpoint_path: resume?.checkpoint_path || null,
@@ -971,11 +978,14 @@ export async function runRecommendPipeline(
       if (!searchResult.ok) {
         const searchErrorCode = String(searchResult.error?.code || "");
         const searchErrorMessage = String(searchResult.error?.message || "");
+        const isNoIframeSearchFailure = (
+          searchErrorCode === "NO_RECOMMEND_IFRAME"
+          || searchErrorMessage.includes("NO_RECOMMEND_IFRAME")
+        );
         const loginRelatedSearchFailure = (
           searchErrorCode === "LOGIN_REQUIRED"
-          || searchErrorCode === "NO_RECOMMEND_IFRAME"
+          || isNoIframeSearchFailure
           || searchErrorMessage.includes("LOGIN_REQUIRED")
-          || searchErrorMessage.includes("NO_RECOMMEND_IFRAME")
         );
         if (loginRelatedSearchFailure) {
           const recheck = await ensureRecommendPageReady(workspaceRoot, {
@@ -1006,6 +1016,28 @@ export async function runRecommendPipeline(
               }
             );
           }
+          if (
+            isNoIframeSearchFailure
+            && recheck.state === "RECOMMEND_READY"
+            && searchNoIframeRetryCount < MAX_SEARCH_NO_IFRAME_RETRY_ATTEMPTS
+          ) {
+            searchNoIframeRetryCount += 1;
+            const retryDelayMs = SEARCH_NO_IFRAME_RETRY_DELAY_MS;
+            const retryDiagnostics = {
+              trigger: "NO_RECOMMEND_IFRAME",
+              attempt: searchNoIframeRetryCount,
+              max_attempts: MAX_SEARCH_NO_IFRAME_RETRY_ATTEMPTS,
+              delay_ms: retryDelayMs,
+              page_state: recheck.page_state || null
+            };
+            runtimeHooks.setStage(
+              "search_recovery",
+              `检测到 recommend iframe 暂未就绪，等待 ${Math.round(retryDelayMs / 1000)} 秒后重试 search（第 ${searchNoIframeRetryCount}/${MAX_SEARCH_NO_IFRAME_RETRY_ATTEMPTS} 次）。`
+            );
+            runtimeHooks.heartbeat("search_recovery", retryDiagnostics);
+            await sleep(retryDelayMs);
+            continue;
+          }
         }
         return buildFailedResponse(
           searchResult.error?.code || "RECOMMEND_SEARCH_FAILED",

package/src/test-pipeline.js

@@ -1505,6 +1505,72 @@ async function testSearchNoIframeWithLoginShouldReturnLoginRequired() {
   assert.equal(result.guidance.agent_prompt.includes("https://www.zhipin.com/web/user/?ka=bticket"), true);
 }
 
+async function testSearchNoIframeShouldRetryOnceWhenPageRecheckReady() {
+  let searchCallCount = 0;
+  let recheckCount = 0;
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: createJobConfirmedConfirmation(),
+      overrides: {}
+    },
+    {
+      parseRecommendInstruction: () => createParsed(),
+      runPipelinePreflight: () => ({ ok: true, checks: [], debug_port: 9222 }),
+      ensureBossRecommendPageReady: async () => {
+        recheckCount += 1;
+        return {
+          ok: true,
+          debug_port: 9222,
+          state: "RECOMMEND_READY",
+          page_state: {
+            state: "RECOMMEND_READY",
+            expected_url: "https://www.zhipin.com/web/chat/recommend",
+            current_url: "https://www.zhipin.com/web/chat/recommend"
+          }
+        };
+      },
+      listRecommendJobs: async () => createJobListResult(),
+      runRecommendSearchCli: async () => {
+        searchCallCount += 1;
+        if (searchCallCount === 1) {
+          return {
+            ok: false,
+            stdout: "",
+            stderr: "NO_RECOMMEND_IFRAME",
+            structured: null,
+            error: {
+              code: "NO_RECOMMEND_IFRAME",
+              message: "NO_RECOMMEND_IFRAME"
+            }
+          };
+        }
+        return {
+          ok: true,
+          summary: {
+            candidate_count: 5,
+            applied_filters: {}
+          }
+        };
+      },
+      runRecommendScreenCli: async () => ({
+        ok: true,
+        summary: {
+          processed_count: 2,
+          passed_count: 1,
+          skipped_count: 1,
+          output_csv: "C:/temp/retry.csv"
+        }
+      })
+    }
+  );
+
+  assert.equal(result.status, "COMPLETED");
+  assert.equal(searchCallCount, 2);
+  assert.equal(recheckCount >= 2, true);
+}
+
 async function testJobTriggerNotFoundShouldMapToLoginRequiredWhenRecheckShowsLogin() {
   const result = await runRecommendPipeline(
     {
@@ -1940,6 +2006,7 @@ async function main() {
   await testCompletedPipeline();
   await testSearchFailure();
   await testSearchNoIframeWithLoginShouldReturnLoginRequired();
+  await testSearchNoIframeShouldRetryOnceWhenPageRecheckReady();
   await testJobTriggerNotFoundShouldMapToLoginRequiredWhenRecheckShowsLogin();
   await testLoginRequiredShouldReturnGuidance();
   await testDebugPortUnreachableShouldReturnConnectionCode();