@reconcrap/boss-recommend-mcp 2.0.54 → 2.0.56

package/package.json

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

package/src/domains/chat/constants.js

@@ -1,4 +1,9 @@
-export const CHAT_TARGET_URL = "https://www.zhipin.com/web/chat/index";
+import {
+  BOSS_ACCOUNT_RIGHTS_PANEL_CLOSE_SELECTORS,
+  BOSS_ACCOUNT_RIGHTS_PANEL_TEXT_QUERIES
+} from "../common/account-rights-panel.js";
+
+export const CHAT_TARGET_URL = "https://www.zhipin.com/web/chat/index";
 
 export const CHAT_CARD_SELECTORS = Object.freeze([
   ".geek-item[data-id]",
@@ -208,29 +213,9 @@ export const CHAT_RESUME_CLOSE_SELECTORS = Object.freeze([
   '[title*="关闭"]'
 ]);
 
-export const CHAT_BLOCKING_PANEL_TEXT_QUERIES = Object.freeze([
-  "我的权益",
-  "VVIP账号-精选版专享权益",
-  "全部账号权益使用量",
-  "职位发布权益总量",
-  "每日使用权益总量"
-]);
-
-export const CHAT_BLOCKING_PANEL_CLOSE_SELECTORS = Object.freeze([
-  ".boss-popup__close",
-  ".boss-dialog__close",
-  ".side-panel-close",
-  ".drawer-close",
-  ".panel-close",
-  ".popup-close",
-  ".modal-close",
-  ".dialog-close",
-  ".close-btn",
-  ".icon-close",
-  "[class*=\"close\"]",
-  '[aria-label*="关闭"]',
-  '[title*="关闭"]'
-]);
+export const CHAT_BLOCKING_PANEL_TEXT_QUERIES = BOSS_ACCOUNT_RIGHTS_PANEL_TEXT_QUERIES;
+
+export const CHAT_BLOCKING_PANEL_CLOSE_SELECTORS = BOSS_ACCOUNT_RIGHTS_PANEL_CLOSE_SELECTORS;
 
 export const CHAT_PROFILE_NETWORK_PATTERNS = Object.freeze([
   /\/wapi\/zpjob\/view\/geek\/info(?:\/v2)?\b/i,

package/src/domains/chat/detail.js

@@ -12,13 +12,17 @@ import {
   querySelectorAll,
   sleep
 } from "../../core/browser/index.js";
-import {
-  buildScreeningCandidateFromDetail,
-  htmlToText
-} from "../../core/screening/index.js";
-import {
-  CHAT_ACTIVE_CANDIDATE_SELECTORS,
-  CHAT_ASK_RESUME_BUTTON_SELECTORS,
+import {
+  buildScreeningCandidateFromDetail,
+  htmlToText
+} from "../../core/screening/index.js";
+import {
+  closeBossAccountRightsBlockingPanel,
+  findBossAccountRightsBlockingPanel
+} from "../common/account-rights-panel.js";
+import {
+  CHAT_ACTIVE_CANDIDATE_SELECTORS,
+  CHAT_ASK_RESUME_BUTTON_SELECTORS,
   CHAT_ATTACHMENT_RESUME_BUTTON_SELECTORS,
   CHAT_BLOCKING_PANEL_CLOSE_SELECTORS,
   CHAT_BLOCKING_PANEL_TEXT_QUERIES,
@@ -735,185 +739,29 @@ export async function quickChatResumeModalOpenProbe(client, {
   };
 }
 
-async function performDomTextSearch(client, query, {
-  limit = 6
-} = {}) {
-  if (typeof client?.DOM?.performSearch !== "function"
-    || typeof client?.DOM?.getSearchResults !== "function") {
-    return [];
-  }
-  const searchOnce = async () => {
-    let searchId = "";
-    try {
-      const search = await client.DOM.performSearch({
-        query,
-        includeUserAgentShadowDOM: true
-      });
-      searchId = search?.searchId || "";
-      const resultCount = Math.min(Number(search?.resultCount) || 0, Math.max(0, Number(limit) || 0));
-      if (!searchId || resultCount <= 0) return [];
-      const results = await client.DOM.getSearchResults({
-        searchId,
-        fromIndex: 0,
-        toIndex: resultCount
-      });
-      return results?.nodeIds || [];
-    } catch {
-      return [];
-    } finally {
-      if (searchId && typeof client?.DOM?.discardSearchResults === "function") {
-        try {
-          await client.DOM.discardSearchResults({ searchId });
-        } catch {
-          // Best-effort cleanup only.
-        }
-      }
-    }
-  };
-
-  const firstPass = await searchOnce();
-  if (!firstPass.length) return [];
-  const firstPassNodeIds = firstPass.filter((nodeId) => Number(nodeId) > 0);
-  if (firstPassNodeIds.length || typeof client?.DOM?.getDocument !== "function") return firstPassNodeIds;
-  try {
-    await client.DOM.getDocument({
-      depth: -1,
-      pierce: true
-    });
-  } catch {
-    return firstPassNodeIds;
-  }
-  return (await searchOnce()).filter((nodeId) => Number(nodeId) > 0);
-}
-
-export async function findChatBlockingPanel(client, {
-  textQueries = CHAT_BLOCKING_PANEL_TEXT_QUERIES
-} = {}) {
-  for (const query of textQueries || []) {
-    const nodeIds = await performDomTextSearch(client, query);
-    for (const nodeId of nodeIds) {
-      try {
-        const box = await getNodeBox(client, nodeId);
-        if (box?.rect?.width > 2 && box?.rect?.height > 2) {
-          return {
-            open: true,
-            reason: "blocking_panel_text_visible",
-            query,
-            node_id: nodeId,
-            rect: box.rect,
-            center: box.center
-          };
-        }
-      } catch {
-        // Hidden or stale text hits are ignored.
-      }
-    }
-  }
-  return {
-    open: false
-  };
-}
-
-function blockingPanelOutsideClickPoint(probe = {}) {
-  const rect = probe?.rect || {};
-  // Click the empty lower-left sidebar area. It is outside the rights drawer
-  // and avoids top nav, chat rows, message controls, and candidate actions.
-  const x = 84;
-  const y = Number.isFinite(Number(rect.y))
-    ? Math.max(560, Math.min(680, Number(rect.y) + 600))
-    : 660;
-  return {
-    x,
-    y,
-    mode: "empty-lower-left-sidebar"
-  };
-}
-
-export async function closeChatBlockingPanels(client, {
-  attemptsLimit = 2
-} = {}) {
-  const attempts = [];
-  let probe = await findChatBlockingPanel(client);
-  if (!probe.open) {
-    return {
-      closed: true,
-      already_closed: true,
-      probe,
-      attempts
-    };
-  }
-
-  for (let index = 0; index < attemptsLimit; index += 1) {
-    const outsidePoint = blockingPanelOutsideClickPoint(probe);
-    try {
-      await clickPoint(client, outsidePoint.x, outsidePoint.y, DETERMINISTIC_CLICK_OPTIONS);
-      attempts.push({
-        mode: "outside-click",
-        point: outsidePoint
-      });
-    } catch (error) {
-      attempts.push({
-        mode: "outside-click-error",
-        point: outsidePoint,
-        error: error?.message || String(error)
-      });
-    }
-    await sleep(700);
-
-    probe = await findChatBlockingPanel(client);
-    if (!probe.open) {
-      return {
-        closed: true,
-        already_closed: false,
-        probe,
-        attempts
-      };
-    }
-
-    const rootState = await getChatRoots(client);
-    const closeTarget = await findVisibleTarget(client, rootState.roots, CHAT_BLOCKING_PANEL_CLOSE_SELECTORS);
-    if (closeTarget) {
-      try {
-        await clickPoint(client, closeTarget.center.x, closeTarget.center.y, DETERMINISTIC_CLICK_OPTIONS);
-        attempts.push({
-          mode: "close-selector",
-          selector: closeTarget.selector,
-          root: closeTarget.root
-        });
-      } catch (error) {
-        attempts.push({
-          mode: "close-selector-error",
-          selector: closeTarget.selector,
-          root: closeTarget.root,
-          error: error?.message || String(error)
-        });
-      }
-    } else {
-      await pressEscape(client);
-      attempts.push({ mode: "Escape" });
-    }
-    await sleep(700);
-
-    probe = await findChatBlockingPanel(client);
-    if (!probe.open) {
-      return {
-        closed: true,
-        already_closed: false,
-        probe,
-        attempts
-      };
-    }
-  }
-
-  return {
-    closed: false,
-    already_closed: false,
-    probe,
-    attempts
-  };
-}
-
-export async function readChatResumeHtml(client, resumeState) {
+export async function findChatBlockingPanel(client, {
+  textQueries = CHAT_BLOCKING_PANEL_TEXT_QUERIES
+} = {}) {
+  const panel = await findBossAccountRightsBlockingPanel(client, { textQueries });
+  return panel.open
+    ? { ...panel, reason: "blocking_panel_text_visible" }
+    : panel;
+}
+
+export async function closeChatBlockingPanels(client, {
+  attemptsLimit = 2,
+  closeSelectors = CHAT_BLOCKING_PANEL_CLOSE_SELECTORS,
+  textQueries = CHAT_BLOCKING_PANEL_TEXT_QUERIES
+} = {}) {
+  return closeBossAccountRightsBlockingPanel(client, {
+    attemptsLimit,
+    closeSelectors,
+    resolveRoots: getChatRoots,
+    textQueries
+  });
+}
+
+export async function readChatResumeHtml(client, resumeState) {
   let popupHTML = "";
   let contentHTML = "";
   let resumeIframeHTML = "";

package/src/domains/common/account-rights-panel.js

@@ -0,0 +1,314 @@
+import {
+  clickPoint,
+  DETERMINISTIC_CLICK_OPTIONS,
+  getDocumentRoot,
+  getNodeBox,
+  pressKey,
+  querySelectorAll,
+  sleep
+} from "../../core/browser/index.js";
+
+export const BOSS_ACCOUNT_RIGHTS_PANEL_TEXT_QUERIES = Object.freeze([
+  "我的权益",
+  "VVIP账号-精选版专享权益",
+  "全部账号权益使用量",
+  "职位发布权益总量",
+  "每日使用权益总量"
+]);
+
+export const BOSS_ACCOUNT_RIGHTS_PANEL_CLOSE_SELECTORS = Object.freeze([
+  ".boss-popup__close",
+  ".boss-dialog__close",
+  ".side-panel-close",
+  ".drawer-close",
+  ".panel-close",
+  ".popup-close",
+  ".modal-close",
+  ".dialog-close",
+  ".close-btn",
+  ".icon-close",
+  "[class*=\"close\"]",
+  '[aria-label*="关闭"]',
+  '[title*="关闭"]'
+]);
+
+async function performDomTextSearch(client, query, {
+  limit = 6
+} = {}) {
+  if (typeof client?.DOM?.performSearch !== "function"
+    || typeof client?.DOM?.getSearchResults !== "function") {
+    return [];
+  }
+
+  const searchOnce = async () => {
+    let searchId = "";
+    try {
+      const search = await client.DOM.performSearch({
+        query,
+        includeUserAgentShadowDOM: true
+      });
+      searchId = search?.searchId || "";
+      const resultCount = Math.min(Number(search?.resultCount) || 0, Math.max(0, Number(limit) || 0));
+      if (!searchId || resultCount <= 0) return [];
+      const results = await client.DOM.getSearchResults({
+        searchId,
+        fromIndex: 0,
+        toIndex: resultCount
+      });
+      return results?.nodeIds || [];
+    } catch {
+      return [];
+    } finally {
+      if (searchId && typeof client?.DOM?.discardSearchResults === "function") {
+        try {
+          await client.DOM.discardSearchResults({ searchId });
+        } catch {
+          // Best-effort cleanup only.
+        }
+      }
+    }
+  };
+
+  const firstPass = await searchOnce();
+  if (!firstPass.length) return [];
+  const firstPassNodeIds = firstPass.filter((nodeId) => Number(nodeId) > 0);
+  if (firstPassNodeIds.length || typeof client?.DOM?.getDocument !== "function") return firstPassNodeIds;
+
+  try {
+    await client.DOM.getDocument({
+      depth: -1,
+      pierce: true
+    });
+  } catch {
+    return firstPassNodeIds;
+  }
+  return (await searchOnce()).filter((nodeId) => Number(nodeId) > 0);
+}
+
+export async function findBossAccountRightsBlockingPanel(client, {
+  textQueries = BOSS_ACCOUNT_RIGHTS_PANEL_TEXT_QUERIES
+} = {}) {
+  for (const query of textQueries || []) {
+    const nodeIds = await performDomTextSearch(client, query);
+    for (const nodeId of nodeIds) {
+      try {
+        const box = await getNodeBox(client, nodeId);
+        if (box?.rect?.width > 2 && box?.rect?.height > 2) {
+          return {
+            open: true,
+            reason: "account_rights_panel_text_visible",
+            query,
+            node_id: nodeId,
+            rect: box.rect,
+            center: box.center
+          };
+        }
+      } catch {
+        // Hidden or stale text hits are ignored.
+      }
+    }
+  }
+  return {
+    open: false
+  };
+}
+
+export function accountRightsPanelOutsideClickPoint(probe = {}) {
+  const rect = probe?.rect || {};
+  // Click the empty lower-left sidebar area. It is outside the rights drawer
+  // and avoids top nav, chat rows, message controls, and candidate actions.
+  const x = 84;
+  const y = Number.isFinite(Number(rect.y))
+    ? Math.max(560, Math.min(680, Number(rect.y) + 600))
+    : 660;
+  return {
+    x,
+    y,
+    mode: "empty-lower-left-sidebar"
+  };
+}
+
+async function resolveBlockingPanelRoots(client, {
+  roots = null,
+  rootState = null,
+  resolveRoots = null
+} = {}) {
+  if (Array.isArray(roots) && roots.some((root) => root?.nodeId)) {
+    return roots.filter((root) => root?.nodeId);
+  }
+  if (Array.isArray(rootState?.roots) && rootState.roots.some((root) => root?.nodeId)) {
+    return rootState.roots.filter((root) => root?.nodeId);
+  }
+  if (typeof resolveRoots === "function") {
+    try {
+      const resolved = await resolveRoots(client);
+      if (Array.isArray(resolved)) return resolved.filter((root) => root?.nodeId);
+      if (Array.isArray(resolved?.roots)) return resolved.roots.filter((root) => root?.nodeId);
+    } catch {
+      // Fall through to the top document. The rights panel lives there.
+    }
+  }
+  try {
+    const topRoot = await getDocumentRoot(client);
+    return [{ name: "top", nodeId: topRoot.nodeId }];
+  } catch {
+    return [];
+  }
+}
+
+async function findVisibleCloseTarget(client, roots, selectors) {
+  let fallback = null;
+  for (const root of roots || []) {
+    if (!root?.nodeId) continue;
+    for (const selector of selectors || []) {
+      let nodeIds = [];
+      try {
+        nodeIds = await querySelectorAll(client, root.nodeId, selector);
+      } catch {
+        nodeIds = [];
+      }
+      for (const nodeId of nodeIds) {
+        const target = {
+          root: root.name,
+          root_node_id: root.nodeId,
+          selector,
+          node_id: nodeId
+        };
+        if (!fallback) fallback = target;
+        try {
+          const box = await getNodeBox(client, nodeId);
+          if (box?.rect?.width > 2 && box?.rect?.height > 2) {
+            return {
+              ...target,
+              center: box.center,
+              rect: box.rect
+            };
+          }
+        } catch {
+          // Stale close candidates are ignored.
+        }
+      }
+    }
+  }
+  return fallback;
+}
+
+async function pressEscape(client) {
+  await pressKey(client, "Escape", {
+    code: "Escape",
+    windowsVirtualKeyCode: 27,
+    nativeVirtualKeyCode: 27
+  });
+}
+
+export async function closeBossAccountRightsBlockingPanel(client, {
+  attemptsLimit = 2,
+  closeSelectors = BOSS_ACCOUNT_RIGHTS_PANEL_CLOSE_SELECTORS,
+  resolveRoots = null,
+  roots = null,
+  rootState = null,
+  textQueries = BOSS_ACCOUNT_RIGHTS_PANEL_TEXT_QUERIES,
+  waitMs = 700
+} = {}) {
+  const attempts = [];
+  let probe = await findBossAccountRightsBlockingPanel(client, { textQueries });
+  if (!probe.open) {
+    return {
+      closed: true,
+      already_closed: true,
+      probe,
+      attempts
+    };
+  }
+
+  for (let index = 0; index < attemptsLimit; index += 1) {
+    const outsidePoint = accountRightsPanelOutsideClickPoint(probe);
+    try {
+      await clickPoint(client, outsidePoint.x, outsidePoint.y, DETERMINISTIC_CLICK_OPTIONS);
+      attempts.push({
+        mode: "outside-click",
+        point: outsidePoint
+      });
+    } catch (error) {
+      attempts.push({
+        mode: "outside-click-error",
+        point: outsidePoint,
+        error: error?.message || String(error)
+      });
+    }
+    await sleep(waitMs);
+
+    probe = await findBossAccountRightsBlockingPanel(client, { textQueries });
+    if (!probe.open) {
+      return {
+        closed: true,
+        already_closed: false,
+        probe,
+        attempts
+      };
+    }
+
+    const resolvedRoots = await resolveBlockingPanelRoots(client, { roots, rootState, resolveRoots });
+    const closeTarget = await findVisibleCloseTarget(client, resolvedRoots, closeSelectors);
+    if (closeTarget) {
+      try {
+        if (closeTarget.center) {
+          await clickPoint(client, closeTarget.center.x, closeTarget.center.y, DETERMINISTIC_CLICK_OPTIONS);
+        }
+        attempts.push({
+          mode: "close-selector",
+          selector: closeTarget.selector,
+          root: closeTarget.root
+        });
+      } catch (error) {
+        attempts.push({
+          mode: "close-selector-error",
+          selector: closeTarget.selector,
+          root: closeTarget.root,
+          error: error?.message || String(error)
+        });
+      }
+      await sleep(waitMs);
+
+      probe = await findBossAccountRightsBlockingPanel(client, { textQueries });
+      if (!probe.open) {
+        return {
+          closed: true,
+          already_closed: false,
+          probe,
+          attempts
+        };
+      }
+    }
+
+    try {
+      await pressEscape(client);
+      attempts.push({ mode: closeTarget ? "Escape-fallback" : "Escape" });
+    } catch (error) {
+      attempts.push({
+        mode: "Escape-error",
+        error: error?.message || String(error)
+      });
+    }
+    await sleep(waitMs);
+
+    probe = await findBossAccountRightsBlockingPanel(client, { textQueries });
+    if (!probe.open) {
+      return {
+        closed: true,
+        already_closed: false,
+        probe,
+        attempts
+      };
+    }
+  }
+
+  return {
+    closed: false,
+    already_closed: false,
+    reason: "account_rights_panel_still_visible_after_close_attempts",
+    probe,
+    attempts
+  };
+}
+

package/src/domains/recommend/constants.js

@@ -108,6 +108,23 @@ export const DETAIL_RESUME_IFRAME_SELECTORS = Object.freeze([
   'iframe[name*="resume"]'
 ]);
 
+export const RECOMMEND_AVATAR_PREVIEW_SELECTORS = Object.freeze([
+  ".boss-dialog__wrapper.avatar-preview",
+  ".avatar-preview",
+  ".dialog-wrap.active .avatar-preview",
+  ".figure-preview"
+]);
+
+export const RECOMMEND_AVATAR_PREVIEW_CLOSE_SELECTORS = Object.freeze([
+  ".avatar-preview .boss-popup__close",
+  ".dialog-wrap.active .avatar-preview .boss-popup__close",
+  ".dialog-wrap.active .boss-popup__close",
+  ".boss-dialog__wrapper.avatar-preview .boss-popup__close",
+  ".boss-popup__close",
+  ".icon-close",
+  '[class*="close"]'
+]);
+
 export const DETAIL_CLOSE_SELECTORS = Object.freeze([
   ".boss-popup__close",
   ".popup-close",