@reconcrap/boss-recommend-mcp 1.3.23 → 1.3.25

package/package.json

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

package/src/test-boss-chat.js

@@ -16,6 +16,7 @@ import {
 import { __testables as cliTestables } from "./cli.js";
 import { __testables as indexTestables } from "./index.js";
 import { BossChatApp } from "../vendor/boss-chat-cli/src/app.js";
+import { BossChatPage } from "../vendor/boss-chat-cli/src/browser/chat-page.js";
 import { LlmClient, parseLlmJson } from "../vendor/boss-chat-cli/src/services/llm.js";
 
 const { handleRequest } = indexTestables;
@@ -398,6 +399,90 @@ async function testBossChatPrepareShouldRetryWhenChatPageIsNotReady() {
   });
 }
 
+async function testBossChatPageShouldTreatBlankChatShellAsOnChatPage() {
+  const fakeChromeClient = {
+    async callFunction() {
+      return {
+        href: "https://www.zhipin.com/web/chat/index",
+        readyState: "complete",
+        hasListContainer: false,
+        listItemCount: 0
+      };
+    }
+  };
+
+  const page = new BossChatPage(fakeChromeClient);
+  const pageState = await page.ensureOnChatPage();
+  assert.equal(pageState.href, "https://www.zhipin.com/web/chat/index");
+
+  await assert.rejects(
+    () => page.ensureReady(),
+    /CHAT_LIST_CONTAINER_NOT_FOUND/
+  );
+}
+
+async function testBossChatRecoverToChatIndexShouldForceNavigateAndWaitForCompleteLoad() {
+  const calls = [];
+  let stateIndex = 0;
+  const states = [
+    {
+      href: "https://www.zhipin.com/web/chat/index",
+      readyState: "loading",
+      hasListContainer: false,
+      listItemCount: 0
+    },
+    {
+      href: "https://www.zhipin.com/web/chat/index",
+      readyState: "interactive",
+      hasListContainer: false,
+      listItemCount: 0
+    },
+    {
+      href: "https://www.zhipin.com/web/chat/index",
+      readyState: "complete",
+      hasListContainer: false,
+      listItemCount: 0
+    }
+  ];
+
+  const fakeChromeClient = {
+    async callFunction(fn, arg) {
+      calls.push({ name: fn.name, arg });
+      if (fn.name === "browserGetCurrentHref") {
+        return { href: "https://www.zhipin.com/web/chat/index" };
+      }
+      if (fn.name === "browserNavigateToChatIndex") {
+        return { ok: true, changed: true, href: "https://www.zhipin.com/web/chat/index" };
+      }
+      if (fn.name === "browserGetPageState") {
+        const value = states[Math.min(stateIndex, states.length - 1)];
+        stateIndex += 1;
+        return value;
+      }
+      throw new Error(`unexpected function: ${fn.name}`);
+    }
+  };
+
+  const page = new BossChatPage(fakeChromeClient);
+  const result = await page.recoverToChatIndex({
+    forceNavigate: true,
+    waitForReadyState: "complete",
+    maxAttempts: 5,
+    delayMs: 0
+  });
+
+  assert.equal(result.changed, true);
+  assert.equal(result.href, "https://www.zhipin.com/web/chat/index");
+  assert.equal(
+    calls.some((entry) => entry.name === "browserNavigateToChatIndex" && entry.arg?.force === true),
+    true
+  );
+  assert.equal(
+    calls.filter((entry) => entry.name === "browserGetPageState").length >= 3,
+    true
+  );
+}
+
 async function testBossChatMcpToolsShouldValidateAndRoute() {
   await withBossChatWorkspace(async (workspaceRoot) => {
     const toolsResponse = await handleRequest({
@@ -941,6 +1026,8 @@ async function testBossChatAppShouldPersistEvidenceArtifacts() {
 async function main() {
   await testBossChatAdapterShouldResolveSharedConfigAndInvokeLocalCli();
   await testBossChatPrepareShouldRetryWhenChatPageIsNotReady();
+  await testBossChatPageShouldTreatBlankChatShellAsOnChatPage();
+  await testBossChatRecoverToChatIndexShouldForceNavigateAndWaitForCompleteLoad();
   await testBossChatMcpToolsShouldValidateAndRoute();
   await testBossChatCliShouldSupportRunAndFollowUpParsing();
   testBossChatLlmEvidenceGateShouldDemoteMissingEvidence();

package/vendor/boss-chat-cli/src/browser/chat-page.js

@@ -24,6 +24,7 @@ function browserGetPageState() {
 
   return {
     href: window.location.href,
+    readyState: document.readyState,
     hasListContainer: Boolean(listContainer),
     listItemCount: listItems.length,
   };
@@ -33,9 +34,10 @@ function browserGetCurrentHref() {
   return { href: window.location.href };
 }
 
-function browserNavigateToChatIndex() {
+function browserNavigateToChatIndex(options = {}) {
   const chatUrl = 'https://www.zhipin.com/web/chat/index';
-  if (!String(window.location.href || '').includes('/web/chat/index')) {
+  const force = options?.force === true;
+  if (force || !String(window.location.href || '').includes('/web/chat/index')) {
     window.location.assign(chatUrl);
     return { ok: true, changed: true, href: chatUrl };
   }
@@ -2236,11 +2238,20 @@ export class BossChatPage {
     return target?.type === 'page' && String(target.url || '').includes(CHAT_URL_TOKEN);
   }
 
-  async ensureReady() {
-    const pageState = await this.chromeClient.callFunction(browserGetPageState);
+  async getPageState() {
+    return this.chromeClient.callFunction(browserGetPageState);
+  }
+
+  async ensureOnChatPage() {
+    const pageState = await this.getPageState();
     if (!pageState?.href?.includes(CHAT_URL_TOKEN)) {
       throw new Error('ACTIVE_TAB_IS_NOT_BOSS_CHAT_PAGE');
     }
+    return pageState;
+  }
+
+  async ensureReady() {
+    const pageState = await this.ensureOnChatPage();
     if (!pageState.hasListContainer && Number(pageState.listItemCount || 0) <= 0) {
       throw new Error('CHAT_LIST_CONTAINER_NOT_FOUND');
     }
@@ -2250,16 +2261,20 @@ export class BossChatPage {
   async recoverToChatIndex(options = {}) {
     const maxAttempts = options.maxAttempts || 20;
     const delayMs = options.delayMs || 500;
+    const forceNavigate = options.forceNavigate === true;
+    const waitForReadyState = options.waitForReadyState || 'complete';
     const hrefResult = await this.chromeClient.callFunction(browserGetCurrentHref);
-    if (String(hrefResult?.href || '').includes(CHAT_URL_TOKEN)) {
+    if (!forceNavigate && String(hrefResult?.href || '').includes(CHAT_URL_TOKEN)) {
       return { changed: false, href: hrefResult?.href || '' };
     }
 
-    await this.chromeClient.callFunction(browserNavigateToChatIndex);
+    await this.chromeClient.callFunction(browserNavigateToChatIndex, { force: forceNavigate });
     for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
       await new Promise((resolve) => setTimeout(resolve, delayMs));
-      const state = await this.chromeClient.callFunction(browserGetPageState);
-      if (String(state?.href || '').includes(CHAT_URL_TOKEN)) {
+      const state = await this.getPageState();
+      const onChatPage = String(state?.href || '').includes(CHAT_URL_TOKEN);
+      const ready = !waitForReadyState || String(state?.readyState || '').toLowerCase() === String(waitForReadyState).toLowerCase();
+      if (onChatPage && ready) {
         return { changed: true, href: state.href };
       }
     }

package/vendor/boss-chat-cli/src/cli.js

@@ -44,6 +44,7 @@ const CLI_FILE_PATH = fileURLToPath(import.meta.url);
 const MINIMAL_TERMINAL_PATTERNS = [/^进度: /, /^候选人结果: /];
 const CHAT_INDEX_URL = 'https://www.zhipin.com/web/chat/index';
 const CHAT_START_REQUIRED_FIELDS = ['job', 'start_from', 'target_count', 'criteria'];
+const CHAT_PAGE_RENAVIGATE_MAX_ATTEMPTS = 3;
 
 function sanitizePathToken(value, fallback = 'run') {
   const token = String(value || '')
@@ -651,6 +652,8 @@ async function connectBossChatPage(chromeClient) {
     target?.type === 'page' && /zhipin\.com/i.test(String(target?.url || ''));
   let target = null;
   let recoveredToChatIndex = false;
+  let blankChatPage = false;
+  let renavigateAttempts = 0;
 
   try {
     target = await chromeClient.connect(BossChatPage.targetMatcher);
@@ -659,15 +662,41 @@ async function connectBossChatPage(chromeClient) {
   }
 
   const page = new BossChatPage(chromeClient);
-  try {
-    await page.ensureReady();
-  } catch {
-    await page.recoverToChatIndex();
-    recoveredToChatIndex = true;
-    await page.ensureReady();
+  for (let attempt = 1; attempt <= CHAT_PAGE_RENAVIGATE_MAX_ATTEMPTS + 1; attempt += 1) {
+    try {
+      await page.ensureReady();
+      return {
+        target,
+        page,
+        recoveredToChatIndex,
+        blankChatPage,
+        renavigateAttempts,
+      };
+    } catch (error) {
+      const message = String(error?.message || error || '');
+      const canRetry =
+        /ACTIVE_TAB_IS_NOT_BOSS_CHAT_PAGE|CHAT_LIST_CONTAINER_NOT_FOUND/.test(message)
+        && attempt <= CHAT_PAGE_RENAVIGATE_MAX_ATTEMPTS;
+
+      if (!canRetry) {
+        if (/CHAT_LIST_CONTAINER_NOT_FOUND/.test(message)) {
+          blankChatPage = true;
+          await page.ensureOnChatPage();
+          break;
+        }
+        throw error;
+      }
+
+      await page.recoverToChatIndex({
+        forceNavigate: true,
+        waitForReadyState: 'complete',
+      });
+      recoveredToChatIndex = true;
+      renavigateAttempts += 1;
+    }
   }
 
-  return { target, page, recoveredToChatIndex };
+  return { target, page, recoveredToChatIndex, blankChatPage, renavigateAttempts };
 }
 
 async function handlePrepareRunCommand(args, dataDir) {
@@ -704,7 +733,7 @@ async function handlePrepareRunCommand(args, dataDir) {
   let chromeClient = null;
   try {
     chromeClient = new ChromeClient(mergedProfile.chrome.port);
-    const { target, page, recoveredToChatIndex } = await connectBossChatPage(chromeClient);
+    const { target, page, recoveredToChatIndex, blankChatPage, renavigateAttempts } = await connectBossChatPage(chromeClient);
     const jobs = await page.listJobs();
     if (!Array.isArray(jobs) || jobs.length === 0) {
       return {
@@ -723,6 +752,8 @@ async function handlePrepareRunCommand(args, dataDir) {
       page_url: CHAT_INDEX_URL,
       connected_target: target?.url || '',
       recovered_to_chat_index: recoveredToChatIndex,
+      blank_chat_page: blankChatPage,
+      renavigate_attempts: renavigateAttempts,
       required_fields: CHAT_START_REQUIRED_FIELDS.slice(),
       defaults: {
         profile: String(args.profile || 'default').trim() || 'default',
@@ -1159,10 +1190,13 @@ async function executeRunCommand(args, dataDir) {
 
     chromeClient = new ChromeClient(persistentProfile.chrome.port);
 
-    const { target, page, recoveredToChatIndex } = await connectBossChatPage(chromeClient);
+    const { target, page, recoveredToChatIndex, blankChatPage, renavigateAttempts } = await connectBossChatPage(chromeClient);
     logger.log(`已连接 Chrome tab: ${target.title || target.url}`);
     if (recoveredToChatIndex) {
-      logger.log(`检测到当前标签不在聊天页，已自动跳转到 ${CHAT_INDEX_URL}`);
+      logger.log(`检测到页面不符合预期，已重新跳转到 ${CHAT_INDEX_URL} 并等待加载完成。attempts=${renavigateAttempts}`);
+    }
+    if (blankChatPage) {
+      logger.log('检测到聊天页处于空白未初始化状态，将继续通过岗位选择和首位候选人预热来恢复列表。');
     }
 
     const runProfile = await promptRunProfile({

package/vendor/boss-recommend-screen-cli/boss-recommend-screen-cli.cjs

@@ -475,15 +475,6 @@ function toStringArray(value, maxItems = 8) {
   return normalized;
 }
 
-function hasEvidenceGateSignal(parsed, parsedEvidence = null) {
-  if (!parsed || typeof parsed !== "object") return false;
-  if (parsed?.evidenceGateEligible === true) return true;
-  if (Number.isFinite(Number(parsed?.evidenceRawCount))) return true;
-  if (Number.isFinite(Number(parsed?.evidenceMatchedCount))) return true;
-  const normalizedEvidence = Array.isArray(parsedEvidence) ? parsedEvidence : toStringArray(parsed?.evidence);
-  return normalizedEvidence.length > 0;
-}
-
 function toLowerSafe(text) {
   return String(text || "").toLowerCase();
 }
@@ -4969,26 +4960,17 @@ class RecommendScreenCli {
     const parsed = result && typeof result === "object" ? result : {};
     const rawPassed = parsed?.rawPassed === true || parsed?.passed === true;
     const parsedEvidence = toStringArray(parsed?.evidence);
-    const evidenceGateEligible = hasEvidenceGateSignal(parsed, parsedEvidence);
-    const evidenceRawCount = evidenceGateEligible
-      ? (Number.isFinite(Number(parsed?.evidenceRawCount))
-        ? Number(parsed.evidenceRawCount)
-        : parsedEvidence.length)
-      : null;
-    const evidenceMatchedCount = evidenceGateEligible
-      ? (Number.isFinite(Number(parsed?.evidenceMatchedCount))
-        ? Number(parsed.evidenceMatchedCount)
-        : parsedEvidence.length)
-      : null;
-    const evidenceGateDemoted = parsed?.evidenceGateDemoted === true
-      || (evidenceGateEligible && rawPassed && evidenceMatchedCount <= 0);
+    const evidenceRawCount = Number.isFinite(Number(parsed?.evidenceRawCount))
+      ? Number(parsed.evidenceRawCount)
+      : parsedEvidence.length;
+    const evidenceMatchedCount = Number.isFinite(Number(parsed?.evidenceMatchedCount))
+      ? Number(parsed.evidenceMatchedCount)
+      : parsedEvidence.length;
     const cot = normalizeText(parsed?.cot || parsed?.reason || "");
     const summary = normalizeText(parsed?.summary || cot);
-    const finalReason = evidenceGateDemoted
-      ? `模型未给出可在简历截图中引用的证据，按安全策略判为不通过。${cot ? ` 原始判断依据(CoT): ${cot}` : ""}`
-      : (cot || (rawPassed ? "模型判定符合筛选标准。" : "模型判定不符合筛选标准。"));
+    const finalReason = cot || (rawPassed ? "模型判定符合筛选标准。" : "模型判定不符合筛选标准。");
     return {
-      passed: evidenceGateDemoted ? false : rawPassed,
+      passed: rawPassed,
       rawPassed,
       cot: finalReason,
       reason: finalReason,
@@ -4996,7 +4978,7 @@ class RecommendScreenCli {
       evidence: parsedEvidence,
       evidenceRawCount,
       evidenceMatchedCount,
-      evidenceGateDemoted
+      evidenceGateDemoted: false
     };
   }
 
@@ -5280,19 +5262,14 @@ class RecommendScreenCli {
     const reason = cot || (rawPassed ? "模型判定符合筛选标准。" : "模型判定不符合筛选标准。");
     const summary = reason;
     const parsedEvidence = toStringArray(parsed?.evidence);
-    const evidenceGateEligible = hasEvidenceGateSignal(parsed, parsedEvidence);
-    const evidenceRawCount = evidenceGateEligible
-      ? (Number.isFinite(Number(parsed?.evidenceRawCount)) ? Number(parsed.evidenceRawCount) : parsedEvidence.length)
-      : null;
-    const evidenceMatchedCount = evidenceGateEligible
-      ? (Number.isFinite(Number(parsed?.evidenceMatchedCount)) ? Number(parsed.evidenceMatchedCount) : parsedEvidence.length)
-      : null;
-    const evidenceGateDemoted = evidenceGateEligible && rawPassed && (evidenceMatchedCount ?? 0) <= 0;
-    const finalReason = evidenceGateDemoted
-      ? `模型未给出可在简历截图中引用的证据，按安全策略判为不通过。${reason ? ` 原始判断依据(CoT): ${reason}` : ""}`
-      : reason;
-    const passed = evidenceGateDemoted ? false : rawPassed;
-    const enrichedReason = enrichReasonWithEvidence(finalReason, summary || finalReason, parsedEvidence, passed);
+    const evidenceRawCount = Number.isFinite(Number(parsed?.evidenceRawCount))
+      ? Number(parsed.evidenceRawCount)
+      : parsedEvidence.length;
+    const evidenceMatchedCount = Number.isFinite(Number(parsed?.evidenceMatchedCount))
+      ? Number(parsed.evidenceMatchedCount)
+      : parsedEvidence.length;
+    const passed = rawPassed;
+    const enrichedReason = enrichReasonWithEvidence(reason, summary || reason, parsedEvidence, passed);
     return {
       passed,
       rawPassed,
@@ -5302,8 +5279,8 @@ class RecommendScreenCli {
       evidence: parsedEvidence,
       evidenceRawCount,
       evidenceMatchedCount,
-      evidenceGateEligible,
-      evidenceGateDemoted
+      evidenceGateEligible: false,
+      evidenceGateDemoted: false
     };
   }
 
@@ -5445,17 +5422,11 @@ class RecommendScreenCli {
     const normalizedResume = normalizeText(safeResumeText);
     const normalizedResumeLower = toLowerSafe(normalizedResume);
     const parsedEvidence = toStringArray(parsed?.evidence);
-    const evidenceGateEligible = hasEvidenceGateSignal(parsed, parsedEvidence);
     const evidence = [];
-    const unmatchedEvidence = [];
-    if (evidenceGateEligible) {
-      for (const item of parsedEvidence) {
-        const matched = matchEvidenceAgainstResume(item, safeResumeText, normalizedResume, normalizedResumeLower);
-        if (matched.matched) {
-          evidence.push(item);
-        } else {
-          unmatchedEvidence.push(item);
-        }
+    for (const item of parsedEvidence) {
+      const matched = matchEvidenceAgainstResume(item, safeResumeText, normalizedResume, normalizedResumeLower);
+      if (matched.matched) {
+        evidence.push(item);
       }
     }
     const parsedPassed = parsePassedDecision(parsed?.passed);
@@ -5467,19 +5438,8 @@ class RecommendScreenCli {
         `Text model response missing boolean passed decision. content=${truncateText(content, 180)}`
       );
     }
-    let passed = rawPassed;
-    let finalReason = cot || (passed ? "模型判定符合筛选标准。" : "模型判定不符合筛选标准。");
-    const evidenceGateDemoted = evidenceGateEligible && rawPassed && evidence.length <= 0;
-    if (evidenceGateDemoted) {
-      passed = false;
-      finalReason = `模型未给出可在简历原文中校验的证据，按安全策略判为不通过。${finalReason ? ` 原始判断依据(CoT): ${finalReason}` : ""}`;
-      if (unmatchedEvidence.length > 0) {
-        log(
-          `[EVIDENCE_GATE] passed=true 但证据未命中简历原文，已降级为不通过；` +
-          `chunk=${chunkIndex}/${chunkTotal}; unmatched=${unmatchedEvidence.slice(0, 3).join(" | ")}`
-        );
-      }
-    }
+    const passed = rawPassed;
+    const finalReason = cot || (passed ? "模型判定符合筛选标准。" : "模型判定不符合筛选标准。");
     const summary = finalReason;
     const enrichedReason = enrichReasonWithEvidence(finalReason, summary || finalReason, evidence, passed);
     return {
@@ -5489,9 +5449,9 @@ class RecommendScreenCli {
       reason: enrichedReason,
       summary: summary || enrichedReason,
       evidence,
-      evidenceRawCount: evidenceGateEligible ? parsedEvidence.length : null,
-      evidenceMatchedCount: evidenceGateEligible ? evidence.length : null,
-      evidenceGateDemoted,
+      evidenceRawCount: parsedEvidence.length,
+      evidenceMatchedCount: evidence.length,
+      evidenceGateDemoted: false,
       chunkIndex,
       chunkTotal
     };

package/vendor/boss-recommend-screen-cli/test-recoverable-resume-failures.cjs

@@ -1715,11 +1715,11 @@ async function testVisionEvidenceGateShouldKeepRawPassWithoutExplicitEvidencePro
   assert.equal(result.rawPassed, true);
   assert.equal(result.passed, true);
   assert.equal(result.evidenceGateDemoted, false);
-  assert.equal(result.evidenceRawCount, null);
-  assert.equal(result.evidenceMatchedCount, null);
+  assert.equal(result.evidenceRawCount, 0);
+  assert.equal(result.evidenceMatchedCount, 0);
 }
 
-async function testVisionEvidenceGateShouldDemoteWhenExplicitlyArmedWithoutEvidence() {
+async function testVisionEvidenceGateShouldNotDemoteWhenExplicitlyArmedWithoutEvidence() {
   const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-vision-evidence-gate-explicit-"));
   const cli = new RecommendScreenCli(createArgs(tempDir));
   cli.prepareVisionImageSegmentsForModel = async () => ({
@@ -1740,12 +1740,48 @@ async function testVisionEvidenceGateShouldDemoteWhenExplicitlyArmedWithoutEvide
   });
   const result = await cli.callVisionModel(path.join(tempDir, "fake.png"));
   assert.equal(result.rawPassed, true);
-  assert.equal(result.passed, false);
-  assert.equal(result.evidenceGateDemoted, true);
+  assert.equal(result.passed, true);
+  assert.equal(result.evidenceGateDemoted, false);
   assert.equal(result.evidenceRawCount, 0);
   assert.equal(result.evidenceMatchedCount, 0);
 }
 
+async function testTextModelShouldNotDemoteRawPassWhenEvidenceDoesNotMatchResume() {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-text-no-demote-"));
+  const cli = new RecommendScreenCli(createArgs(tempDir));
+  const originalFetch = global.fetch;
+  global.fetch = async () => ({
+    ok: true,
+    status: 200,
+    async json() {
+      return {
+        choices: [
+          {
+            message: {
+              content: JSON.stringify({
+                passed: true,
+                reason: "matched",
+                summary: "matched",
+                evidence: ["完全不在简历里的证据"]
+              })
+            }
+          }
+        ]
+      };
+    }
+  });
+  try {
+    const result = await cli.callTextModel("这是简历原文，没有那条证据");
+    assert.equal(result.rawPassed, true);
+    assert.equal(result.passed, true);
+    assert.equal(result.evidenceGateDemoted, false);
+    assert.equal(result.evidenceRawCount, 1);
+    assert.equal(result.evidenceMatchedCount, 0);
+  } finally {
+    global.fetch = originalFetch;
+  }
+}
+
 async function testVisionModelShouldSendAllOrderedChunks() {
   const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-vision-all-chunks-"));
   const chunkPaths = [];
@@ -1843,7 +1879,8 @@ async function main() {
   await testTextModelShouldSupportLowThinkingForVolcengine();
   await testPrepareVisionImageSegmentsShouldSplitLongImage();
   await testVisionEvidenceGateShouldKeepRawPassWithoutExplicitEvidenceProtocol();
-  await testVisionEvidenceGateShouldDemoteWhenExplicitlyArmedWithoutEvidence();
+  await testVisionEvidenceGateShouldNotDemoteWhenExplicitlyArmedWithoutEvidence();
+  await testTextModelShouldNotDemoteRawPassWhenEvidenceDoesNotMatchResume();
   await testVisionModelShouldSendAllOrderedChunks();
   testRecoverablePostActionErrorShouldTreatGreetContinueAndNoButtonAsRecoverable();
   await testRecoverableGreetContinueButtonShouldNotAbortWhenDetailCloseFails();