@reconcrap/boss-recommend-mcp 1.3.24 → 1.3.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "1.3.24",
+  "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({