@reconcrap/boss-recommend-mcp 1.3.25 → 1.3.27

package/package.json

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

package/src/cli.js

@@ -39,7 +39,6 @@ const chromeOnboardingUrlPattern = /^chrome:\/\/(welcome|intro|newtab|signin|his
 const supportedMcpClients = ["generic", "cursor", "trae", "claudecode", "openclaw"];
 const defaultMcpServerName = "boss-recommend";
 const defaultMcpCommand = "npx";
-const defaultMcpArgs = ["-y", "@reconcrap/boss-recommend-mcp@latest", "start"];
 const recommendMcpPackageName = "@reconcrap/boss-recommend-mcp";
 const recommendMcpBinaryName = "boss-recommend-mcp";
 const autoSyncSkipCommands = new Set(["install", "install-skill", "where", "help", "--help", "-h"]);
@@ -65,6 +64,29 @@ function getPackageVersion() {
 
 const packageVersion = getPackageVersion();
 
+function isInstalledPackageRoot(rootPath = packageRoot) {
+  const normalized = path.resolve(String(rootPath || ""))
+    .replace(/\\/g, "/")
+    .toLowerCase();
+  return (
+    normalized.includes("/appdata/local/npm-cache/_npx/")
+    || normalized.includes("/node_modules/@reconcrap/boss-recommend-mcp")
+  );
+}
+
+function getDefaultMcpPackageSpecifier(options = {}) {
+  const version = String(options.packageVersion || packageVersion).trim();
+  const rootPath = options.packageRootPath || packageRoot;
+  if (version && version !== "0.0.0" && isInstalledPackageRoot(rootPath)) {
+    return `${recommendMcpPackageName}@${version}`;
+  }
+  return `${recommendMcpPackageName}@latest`;
+}
+
+function buildDefaultMcpArgs(options = {}) {
+  return ["-y", getDefaultMcpPackageSpecifier(options), "start"];
+}
+
 function getCodexHome() {
   return process.env.CODEX_HOME
     ? path.resolve(process.env.CODEX_HOME)
@@ -338,7 +360,7 @@ function buildMcpLaunchConfig(options = {}) {
     ? args
     : command === "boss-recommend-mcp"
       ? ["start"]
-      : defaultMcpArgs.slice();
+      : buildDefaultMcpArgs();
   const launchConfig = { command, args: launchArgs };
   if (env && typeof env === "object" && !Array.isArray(env) && Object.keys(env).length > 0) {
     launchConfig.env = env;
@@ -1606,9 +1628,13 @@ export async function runCli(argv = process.argv) {
 
 export const __testables = {
   buildBossChatCliInput,
+  buildDefaultMcpArgs,
+  buildMcpLaunchConfig,
   getBossChatCliRunTarget,
+  getDefaultMcpPackageSpecifier,
   getRunFollowUp,
   installSkill,
+  isInstalledPackageRoot,
   runBossChatCliCommand,
   runPipelineOnce
 };

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 { __testables as vendorCliTestables } from "../vendor/boss-chat-cli/src/cli.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";
 
@@ -684,6 +685,118 @@ async function testBossChatCliShouldSupportRunAndFollowUpParsing() {
   });
 }
 
+async function testVendorBossChatCliShouldWaitForHydratedChatShell() {
+  const pageStates = [
+    { href: "https://www.zhipin.com/web/chat/index", hasListContainer: false, listItemCount: 0 },
+    { href: "https://www.zhipin.com/web/chat/index", hasListContainer: false, listItemCount: 0 },
+    { href: "https://www.zhipin.com/web/chat/index", hasListContainer: true, listItemCount: 40 },
+  ];
+  const jobsPerAttempt = [
+    [],
+    [],
+    [{ value: "job-1", label: "AI应用开发工程师（2026） _ 杭州", active: false }],
+  ];
+  let ensureCallCount = 0;
+  let listJobsCallCount = 0;
+  const page = {
+    async ensureOnChatPage() {
+      const next = pageStates[Math.min(ensureCallCount, pageStates.length - 1)];
+      ensureCallCount += 1;
+      return next;
+    },
+    async listJobs() {
+      const next = jobsPerAttempt[Math.min(listJobsCallCount, jobsPerAttempt.length - 1)];
+      listJobsCallCount += 1;
+      return next;
+    },
+  };
+
+  const hydrated = await vendorCliTestables.waitForChatShellHydration({
+    page,
+    maxAttempts: 4,
+    delayMs: 0,
+  });
+  assert.equal(Array.isArray(hydrated.jobs), true);
+  assert.equal(hydrated.jobs.length, 1);
+  assert.equal(hydrated.pageState.listItemCount, 40);
+  assert.equal(ensureCallCount >= 3, true);
+}
+
+async function testVendorBossChatCliShouldRetryJobListDuringPromptRunProfile() {
+  const page = {
+    _attempt: 0,
+    async ensureOnChatPage() {
+      return {
+        href: "https://www.zhipin.com/web/chat/index",
+        hasListContainer: this._attempt >= 1,
+        listItemCount: this._attempt >= 1 ? 10 : 0,
+      };
+    },
+    async listJobs() {
+      this._attempt += 1;
+      if (this._attempt < 2) {
+        return [];
+      }
+      return [
+        {
+          value: "job-1",
+          label: "AI应用开发工程师（2026） _ 杭州",
+          active: false,
+        },
+      ];
+    },
+  };
+
+  const profile = await vendorCliTestables.promptRunProfile({
+    page,
+    persistentProfile: {
+      llm: {
+        baseUrl: "https://api.example.com/v1",
+        apiKey: "sk-test-key",
+        model: "gpt-4.1-mini",
+      },
+      chrome: {
+        port: 9222,
+      },
+      runtime: {},
+    },
+    overrides: {
+      jobSelection: "AI应用开发工程师（2026） _ 杭州",
+      startFrom: "unread",
+      screeningCriteria: "小样本联通性验证",
+      targetCount: 1,
+    },
+  });
+  assert.equal(profile.jobSelection.label, "AI应用开发工程师（2026） _ 杭州");
+  assert.equal(profile.startFrom, "unread");
+  assert.equal(profile.targetCount, 1);
+}
+
+function testCliShouldPinInstalledPackageVersionInGeneratedMcpConfig() {
+  const installedSpecifier = cliTestables.getDefaultMcpPackageSpecifier({
+    packageVersion: "1.3.25",
+    packageRootPath: "C:\\Users\\yaolin\\AppData\\Roaming\\npm\\node_modules\\@reconcrap\\boss-recommend-mcp",
+  });
+  assert.equal(installedSpecifier, "@reconcrap/boss-recommend-mcp@1.3.25");
+
+  const cachedSpecifier = cliTestables.getDefaultMcpPackageSpecifier({
+    packageVersion: "1.3.25",
+    packageRootPath: "C:\\Users\\yaolin\\AppData\\Local\\npm-cache\\_npx\\abcd1234\\node_modules\\@reconcrap\\boss-recommend-mcp",
+  });
+  assert.equal(cachedSpecifier, "@reconcrap/boss-recommend-mcp@1.3.25");
+
+  const sourceSpecifier = cliTestables.getDefaultMcpPackageSpecifier({
+    packageVersion: "1.3.25-dev",
+    packageRootPath: "C:\\Users\\yaolin\\Documents\\codex_projects\\boss recommend pipeline\\boss-recommend-mcp",
+  });
+  assert.equal(sourceSpecifier, "@reconcrap/boss-recommend-mcp@latest");
+
+  const launchConfig = cliTestables.buildMcpLaunchConfig({});
+  assert.equal(launchConfig.command, "npx");
+  assert.equal(Array.isArray(launchConfig.args), true);
+  assert.equal(launchConfig.args[0], "-y");
+}
+
 function testBossChatLlmEvidenceGateShouldDemoteMissingEvidence() {
   const parsed = parseLlmJson(
     JSON.stringify({
@@ -902,6 +1015,233 @@ async function testBossChatLlmShouldApplyThinkingDefaultsAndOverrides() {
   assert.deepEqual(responsesPayload.reasoning, { effort: "low" });
 }
 
+async function testBossChatAppShouldResetPrimaryChatLabelBeforeInitialPrime() {
+  const calls = [];
+  const page = {
+    async ensureReady() {
+      calls.push("ensureReady");
+      return { hasListContainer: true, listItemCount: 1 };
+    },
+    async activatePrimaryChatLabel(label) {
+      calls.push(`activatePrimaryChatLabel:${label}`);
+      return { changed: false, verified: true, activeLabel: label };
+    },
+    async selectJob(jobSelection) {
+      calls.push(`selectJob:${jobSelection.label}`);
+      return jobSelection;
+    },
+    async activateUnreadFilter() {
+      calls.push("activateUnreadFilter");
+      return { changed: false, verified: true, activeLabel: "未读" };
+    },
+    async primeConversationByFirstCandidate() {
+      calls.push("primeConversationByFirstCandidate:1");
+      return {
+        candidate: {
+          customerId: "1001",
+          name: "候选人A",
+          sourceJob: "算法工程师",
+          domIndex: 0,
+        },
+        totalVisibleCandidates: 1,
+        readyState: {
+          hasOnlineResume: true,
+          hasAskResume: true,
+          hasAttachmentResume: false,
+        },
+      };
+    },
+    async getLoadedCustomers() {
+      calls.push("getLoadedCustomers:1");
+      return [];
+    },
+    async closeResumeModalDomOnce() {
+      return {
+        closed: true,
+        method: "already-closed",
+        finalState: { scopeCount: 0, iframeCount: 0, closeCount: 0, topScopeClass: "" },
+      };
+    },
+  };
+  const stateStore = {
+    async load() {},
+    hasAny() {
+      return false;
+    },
+    async record() {},
+  };
+  const app = new BossChatApp({
+    page,
+    llmClient: {},
+    interaction: {
+      async sleepRange() {},
+      async maybeRest() {},
+    },
+    resumeCaptureService: {},
+    stateStore,
+    reportStore: {
+      async write() {
+        return "report.json";
+      },
+    },
+    logger: { log() {} },
+    dryRun: true,
+    artifactRootDir: os.tmpdir(),
+    resumeOpenCooldownMs: 0,
+  });
+  app.processCustomer = async (_customer, _profile, _runId, options = {}) => {
+    calls.push(`processCustomer:${options.skipCardClick === true ? "skip" : "click"}`);
+    return {
+      name: "候选人A",
+      passed: false,
+      requested: false,
+      reason: "skip",
+      error: "",
+      artifacts: {},
+    };
+  };
+
+  const summary = await app.run({
+    screeningCriteria: "有 AI 项目经验",
+    targetCount: 1,
+    startFrom: "unread",
+    jobSelection: { label: "算法工程师", value: "job-1" },
+    chrome: { port: 9222 },
+    llm: { model: "gpt-test" },
+  });
+
+  assert.deepEqual(calls.slice(0, 5), [
+    "ensureReady",
+    "activatePrimaryChatLabel:全部",
+    "selectJob:算法工程师",
+    "activateUnreadFilter",
+    "primeConversationByFirstCandidate:1",
+  ]);
+  assert.equal(calls.includes("processCustomer:skip"), true);
+  assert.equal(summary.inspected, 1);
+  assert.equal(summary.skipped, 1);
+}
+
+async function testBossChatAppShouldRestoreListContextAfterRecovery() {
+  const calls = [];
+  let primeCount = 0;
+  let loadedCount = 0;
+  const page = {
+    async ensureReady() {
+      return { hasListContainer: true, listItemCount: 1 };
+    },
+    async activatePrimaryChatLabel(label) {
+      calls.push(`activatePrimaryChatLabel:${label}`);
+      return { changed: false, verified: true, activeLabel: label };
+    },
+    async selectJob(jobSelection) {
+      calls.push(`selectJob:${jobSelection.label}`);
+      return jobSelection;
+    },
+    async activateUnreadFilter() {
+      calls.push("activateUnreadFilter");
+      return { changed: false, verified: true, activeLabel: "未读" };
+    },
+    async primeConversationByFirstCandidate() {
+      primeCount += 1;
+      calls.push(`primeConversationByFirstCandidate:${primeCount}`);
+      if (primeCount === 1) {
+        throw new Error("NO_FIRST_CANDIDATE");
+      }
+      return {
+        candidate: {
+          customerId: "1002",
+          name: "候选人B",
+          sourceJob: "算法工程师",
+          domIndex: 0,
+        },
+        totalVisibleCandidates: 1,
+        readyState: {
+          hasOnlineResume: true,
+          hasAskResume: true,
+          hasAttachmentResume: false,
+        },
+      };
+    },
+    async getLoadedCustomers() {
+      loadedCount += 1;
+      calls.push(`getLoadedCustomers:${loadedCount}`);
+      if (loadedCount === 1) {
+        throw new Error("CHAT_CARD_LIST_NOT_FOUND");
+      }
+      return [];
+    },
+    async recoverToChatIndex() {
+      calls.push("recoverToChatIndex");
+      return { changed: true, href: "https://www.zhipin.com/web/chat/index" };
+    },
+    async closeResumeModalDomOnce() {
+      return {
+        closed: true,
+        method: "already-closed",
+        finalState: { scopeCount: 0, iframeCount: 0, closeCount: 0, topScopeClass: "" },
+      };
+    },
+  };
+  const stateStore = {
+    async load() {},
+    hasAny() {
+      return false;
+    },
+    async record() {},
+  };
+  const app = new BossChatApp({
+    page,
+    llmClient: {},
+    interaction: {
+      async sleepRange() {},
+      async maybeRest() {},
+    },
+    resumeCaptureService: {},
+    stateStore,
+    reportStore: {
+      async write() {
+        return "report.json";
+      },
+    },
+    logger: { log() {} },
+    dryRun: true,
+    artifactRootDir: os.tmpdir(),
+    resumeOpenCooldownMs: 0,
+  });
+  app.processCustomer = async (_customer, _profile, _runId, options = {}) => {
+    calls.push(`processCustomer:${options.skipCardClick === true ? "skip" : "click"}`);
+    return {
+      name: "候选人B",
+      passed: false,
+      requested: false,
+      reason: "skip",
+      error: "",
+      artifacts: {},
+    };
+  };
+
+  const summary = await app.run({
+    screeningCriteria: "有 AI 项目经验",
+    targetCount: 1,
+    startFrom: "unread",
+    jobSelection: { label: "算法工程师", value: "job-1" },
+    chrome: { port: 9222 },
+    llm: { model: "gpt-test" },
+  });
+
+  assert.equal(calls.filter((item) => item === "activatePrimaryChatLabel:全部").length, 2);
+  const recoverIndex = calls.indexOf("recoverToChatIndex");
+  assert.equal(recoverIndex >= 0, true);
+  assert.equal(calls[recoverIndex + 1], "activatePrimaryChatLabel:全部");
+  assert.equal(calls[recoverIndex + 2], "selectJob:算法工程师");
+  assert.equal(calls[recoverIndex + 3], "activateUnreadFilter");
+  assert.equal(calls[recoverIndex + 4], "primeConversationByFirstCandidate:2");
+  assert.equal(calls.includes("processCustomer:skip"), true);
+  assert.equal(summary.inspected, 1);
+  assert.equal(summary.skipped, 1);
+}
+
 async function testBossChatAppShouldPersistEvidenceArtifacts() {
   const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "boss-chat-artifacts-"));
   await mkdir(tempDir, { recursive: true });
@@ -1030,10 +1370,15 @@ async function main() {
   await testBossChatRecoverToChatIndexShouldForceNavigateAndWaitForCompleteLoad();
   await testBossChatMcpToolsShouldValidateAndRoute();
   await testBossChatCliShouldSupportRunAndFollowUpParsing();
+  await testVendorBossChatCliShouldWaitForHydratedChatShell();
+  await testVendorBossChatCliShouldRetryJobListDuringPromptRunProfile();
+  testCliShouldPinInstalledPackageVersionInGeneratedMcpConfig();
   testBossChatLlmEvidenceGateShouldDemoteMissingEvidence();
   testBossChatLlmEvidenceGateShouldDemoteUnmatchedEvidence();
   await testBossChatLlmTextChunkFallbackShouldWork();
   await testBossChatLlmShouldApplyThinkingDefaultsAndOverrides();
+  await testBossChatAppShouldResetPrimaryChatLabelBeforeInitialPrime();
+  await testBossChatAppShouldRestoreListContextAfterRecovery();
   await testBossChatAppShouldPersistEvidenceArtifacts();
   console.log("boss-chat tests passed");
 }

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

@@ -142,6 +142,16 @@ export class BossChatApp {
     } catch {}
   }
 
+  async restoreListContext(profile) {
+    if (typeof this.page.activatePrimaryChatLabel === 'function') {
+      await this.page.activatePrimaryChatLabel('全部');
+    }
+    await this.page.selectJob(profile.jobSelection);
+    return profile.startFrom === 'all'
+      ? this.page.activateAllFilter()
+      : this.page.activateUnreadFilter();
+  }
+
   async run(profile) {
     const startedAt = new Date().toISOString();
     const runId = runToken(new Date());
@@ -158,12 +168,7 @@ export class BossChatApp {
     } catch (error) {
       this.logger.log(`页面就绪检查告警：${error?.message || error}，将继续执行预热恢复流程。`);
     }
-    await this.page.selectJob(profile.jobSelection);
-
-    const filterResult =
-      startFrom === 'all'
-        ? await this.page.activateAllFilter()
-        : await this.page.activateUnreadFilter();
+    const filterResult = await this.restoreListContext(profile);
     await this.interaction.sleepRange(420, 160);
     this.logger.log('预热步骤：准备点击首位人选初始化聊天容器...');
     let primedCustomer = null;
@@ -270,6 +275,16 @@ export class BossChatApp {
                 `页面恢复：changed=${recover.changed} | href=${recover.href || 'unknown'}，准备重新预热并继续。`,
               );
               await this.interaction.sleepRange(900, 220);
+              const recoveredFilterResult = await this.restoreListContext(profile);
+              this.logger.log(
+                `恢复后列表上下文：岗位=${profile.jobSelection?.label || profile.jobSelection?.value || '未知'}；列表范围: ${filterLabel}${
+                  recoveredFilterResult.changed
+                    ? recoveredFilterResult.verified === false
+                      ? '（已尝试切换，未验证 active）'
+                      : '（已切换）'
+                    : '（已在目标筛选）'
+                }${recoveredFilterResult?.activeLabel ? ` | active=${recoveredFilterResult.activeLabel}` : ''}`,
+              );
               const prime = await this.page.primeConversationByFirstCandidate();
               const candidate = prime?.candidate || {};
               const candidateBase = {

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

@@ -276,6 +276,63 @@ async function browserActivateFilterTab(label) {
   };
 }
 
+async function browserActivatePrimaryChatLabel(label) {
+  const normalize = (value) => String(value || '').replace(/\s+/g, ' ').trim();
+  const isVisible = (node) => {
+    if (!(node instanceof HTMLElement)) return false;
+    const rect = node.getBoundingClientRect();
+    if (rect.width <= 2 || rect.height <= 2) return false;
+    const style = getComputedStyle(node);
+    return style.display !== 'none' && style.visibility !== 'hidden' && Number(style.opacity || '1') > 0.01;
+  };
+  const matchesLabel = (node) => {
+    const text = normalize(node?.textContent || '');
+    return text === label || text.startsWith(`${label}(`);
+  };
+  const hasActiveState = (node) =>
+    node instanceof HTMLElement &&
+    (
+      node.classList.contains('active') ||
+      node.classList.contains('selected') ||
+      node.getAttribute('aria-selected') === 'true' ||
+      node.getAttribute('data-active') === 'true'
+    );
+  const getLabels = () =>
+    Array.from(document.querySelectorAll('.label-list .chat-label-item, .chat-label-item'))
+      .filter((node) => node instanceof HTMLElement && isVisible(node));
+  const getActiveLabel = () => {
+    const activeNode = getLabels().find((node) => hasActiveState(node));
+    return normalize(activeNode?.textContent || '');
+  };
+
+  const labels = getLabels();
+  const candidates = labels.filter((node) => matchesLabel(node));
+  if (candidates.length === 0) {
+    return { ok: false, error: `PRIMARY_CHAT_LABEL_NOT_FOUND:${label}` };
+  }
+
+  const activeLabelBefore = getActiveLabel();
+  if (candidates.some((node) => hasActiveState(node)) || matchesLabel({ textContent: activeLabelBefore })) {
+    return { ok: true, changed: false, verified: true, activeLabel: activeLabelBefore || label };
+  }
+
+  candidates[0].click();
+  await new Promise((resolve) => window.setTimeout(resolve, 420));
+
+  const refreshedCandidates = getLabels().filter((node) => matchesLabel(node));
+  const activeLabelAfter = getActiveLabel();
+  const verified =
+    matchesLabel({ textContent: activeLabelAfter }) ||
+    refreshedCandidates.some((node) => hasActiveState(node));
+
+  return {
+    ok: true,
+    changed: true,
+    verified,
+    activeLabel: activeLabelAfter || '',
+  };
+}
+
 function browserGetLoadedCustomers() {
   const normalize = (value) => String(value || '').replace(/\s+/g, ' ').trim();
   const isScrollable = (el) =>
@@ -2317,6 +2374,14 @@ export class BossChatPage {
     return result;
   }
 
+  async activatePrimaryChatLabel(label = '全部') {
+    const result = await this.chromeClient.callFunction(browserActivatePrimaryChatLabel, label);
+    if (!result?.ok) {
+      throw new Error(result?.error || `ACTIVATE_PRIMARY_CHAT_LABEL_FAILED:${label}`);
+    }
+    return result;
+  }
+
   async getLoadedCustomers() {
     let lastError = 'GET_LOADED_CUSTOMERS_FAILED';
     for (let attempt = 0; attempt < 6; attempt += 1) {

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

@@ -45,6 +45,10 @@ 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;
+const CHAT_PAGE_HYDRATION_MAX_ATTEMPTS = 12;
+const CHAT_PAGE_HYDRATION_DELAY_MS = 250;
+const CHAT_JOB_LIST_MAX_ATTEMPTS = 16;
+const CHAT_JOB_LIST_DELAY_MS = 250;
 
 function sanitizePathToken(value, fallback = 'run') {
   const token = String(value || '')
@@ -71,6 +75,10 @@ function shouldPrintToMinimalTerminal(message) {
   return MINIMAL_TERMINAL_PATTERNS.some((pattern) => pattern.test(message));
 }
 
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 async function createRunLogger(dataDir, { runId = '', detachedWorker = false } = {}) {
   const logsDir = path.join(dataDir, 'logs');
   await mkdir(logsDir, { recursive: true });
@@ -498,7 +506,7 @@ function resolveJobSelection(jobs, input) {
 }
 
 async function promptRunProfile({ page, persistentProfile, overrides }) {
-  const jobs = await page.listJobs();
+  const jobs = await resolveJobsWithRetry({ page });
   if (!Array.isArray(jobs) || jobs.length === 0) {
     throw new Error('未解析到岗位列表，请确认岗位下拉可见。');
   }
@@ -647,6 +655,102 @@ function buildPreparePendingQuestions(args, jobs = []) {
   return pendingQuestions;
 }
 
+function hasHydratedChatShell(pageState, jobs = []) {
+  const hasChatList =
+    Boolean(pageState?.hasListContainer)
+    || Number(pageState?.listItemCount || 0) > 0;
+  return hasChatList || (Array.isArray(jobs) && jobs.length > 0);
+}
+
+async function waitForChatShellHydration({
+  page,
+  maxAttempts = CHAT_PAGE_HYDRATION_MAX_ATTEMPTS,
+  delayMs = CHAT_PAGE_HYDRATION_DELAY_MS,
+} = {}) {
+  let lastPageState = null;
+  let lastJobs = [];
+  let lastError = null;
+
+  for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+    try {
+      lastPageState = await page.ensureOnChatPage();
+    } catch (error) {
+      lastError = error;
+      break;
+    }
+
+    try {
+      lastJobs = await page.listJobs();
+    } catch (error) {
+      lastError = error;
+      lastJobs = [];
+    }
+
+    if (hasHydratedChatShell(lastPageState, lastJobs)) {
+      return {
+        pageState: lastPageState,
+        jobs: lastJobs,
+      };
+    }
+
+    if (attempt < maxAttempts) {
+      await sleep(delayMs);
+    }
+  }
+
+  const lastErrorMessage = String(lastError?.message || lastError || '');
+  if (/ACTIVE_TAB_IS_NOT_BOSS_CHAT_PAGE/.test(lastErrorMessage)) {
+    throw lastError;
+  }
+
+  return {
+    pageState: lastPageState,
+    jobs: lastJobs,
+  };
+}
+
+async function resolveJobsWithRetry({
+  page,
+  maxAttempts = CHAT_JOB_LIST_MAX_ATTEMPTS,
+  delayMs = CHAT_JOB_LIST_DELAY_MS,
+} = {}) {
+  let lastError = null;
+
+  for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+    try {
+      const jobs = await page.listJobs();
+      if (Array.isArray(jobs) && jobs.length > 0) {
+        return jobs;
+      }
+    } catch (error) {
+      lastError = error;
+      const message = String(error?.message || error || '');
+      if (/ACTIVE_TAB_IS_NOT_BOSS_CHAT_PAGE/.test(message)) {
+        throw error;
+      }
+    }
+
+    const hydrated = await waitForChatShellHydration({
+      page,
+      maxAttempts: 1,
+      delayMs,
+    });
+    if (Array.isArray(hydrated?.jobs) && hydrated.jobs.length > 0) {
+      return hydrated.jobs;
+    }
+
+    if (attempt < maxAttempts) {
+      await sleep(delayMs);
+    }
+  }
+
+  if (lastError) {
+    throw lastError;
+  }
+
+  return [];
+}
+
 async function connectBossChatPage(chromeClient) {
   const isBossDomainTarget = (target) =>
     target?.type === 'page' && /zhipin\.com/i.test(String(target?.url || ''));
@@ -674,13 +778,25 @@ async function connectBossChatPage(chromeClient) {
       };
     } catch (error) {
       const message = String(error?.message || error || '');
+      if (/CHAT_LIST_CONTAINER_NOT_FOUND/.test(message)) {
+        blankChatPage = true;
+        const hydrated = await waitForChatShellHydration({ page });
+        if (hasHydratedChatShell(hydrated?.pageState, hydrated?.jobs)) {
+          return {
+            target,
+            page,
+            recoveredToChatIndex,
+            blankChatPage,
+            renavigateAttempts,
+          };
+        }
+      }
       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;
         }
@@ -734,7 +850,7 @@ async function handlePrepareRunCommand(args, dataDir) {
   try {
     chromeClient = new ChromeClient(mergedProfile.chrome.port);
     const { target, page, recoveredToChatIndex, blankChatPage, renavigateAttempts } = await connectBossChatPage(chromeClient);
-    const jobs = await page.listJobs();
+    const jobs = await resolveJobsWithRetry({ page });
     if (!Array.isArray(jobs) || jobs.length === 0) {
       return {
         status: 'FAILED',
@@ -1423,12 +1539,22 @@ async function main() {
   }
 }
 
-main().catch((error) => {
-  const runLogPath = String(error?.runLogPath || '').trim();
-  if (runLogPath) {
-    console.error(`执行失败，详细日志见: ${runLogPath}`);
-  } else {
-    console.error(`执行失败: ${error.message}`);
-  }
-  process.exitCode = 1;
-});
+export const __testables = {
+  connectBossChatPage,
+  hasHydratedChatShell,
+  promptRunProfile,
+  resolveJobsWithRetry,
+  waitForChatShellHydration,
+};
+
+if (process.argv[1] && path.resolve(process.argv[1]) === CLI_FILE_PATH) {
+  main().catch((error) => {
+    const runLogPath = String(error?.runLogPath || '').trim();
+    if (runLogPath) {
+      console.error(`执行失败，详细日志见: ${runLogPath}`);
+    } else {
+      console.error(`执行失败: ${error.message}`);
+    }
+    process.exitCode = 1;
+  });
+}