@reconcrap/boss-recommend-mcp 1.3.38 → 1.3.39

package/package.json

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

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

@@ -83,8 +83,11 @@ const PAGE_SCOPE_TAB_STATUS = {
   latest: "1",
   featured: "3"
 };
-const BOTTOM_HINT_KEYWORDS = ["没有更多", "已显示全部", "已经到底", "暂无更多", "推荐完了", "没有更多人选"];
-const LOAD_MORE_HINT_KEYWORDS = ["滚动加载更多", "下滑加载更多", "继续下滑", "继续滑动", "滑动加载", "正在加载", "加载中"];
+const BOTTOM_HINT_KEYWORDS = ["没有更多", "已显示全部", "已经到底", "暂无更多", "推荐完了", "没有更多人选"];
+const LOAD_MORE_HINT_KEYWORDS = ["滚动加载更多", "下滑加载更多", "继续下滑", "继续滑动", "滑动加载", "正在加载", "加载中"];
+const VIEWPORT_COLLAPSE_RATIO_THRESHOLD = 0.6;
+const VIEWPORT_COLLAPSE_MIN_EXPECTED_WIDTH = 1000;
+const VIEWPORT_COLLAPSE_NEAR_FULLSCREEN_RATIO = 0.85;
 
 function getHealingRulesPath() {
   const fromEnv = normalizeText(process.env.BOSS_RECOMMEND_HEALING_RULES_FILE || "");
@@ -2465,17 +2468,28 @@ const jsGetListState = `(() => {
     scrollHeight: body ? body.scrollHeight : 0,
     clientHeight: body ? body.clientHeight : 0,
     clientWidth: body ? body.clientWidth : 0,
-    frameRect: {
-      width: frameRect.width,
-      height: frameRect.height
-    },
-    viewport: {
-      width: (doc.defaultView && Number.isFinite(doc.defaultView.innerWidth)) ? doc.defaultView.innerWidth : 0,
-      height: (doc.defaultView && Number.isFinite(doc.defaultView.innerHeight)) ? doc.defaultView.innerHeight : 0
-    },
-    candidateCount: effectiveCount,
-    recommendCandidateCount: candidateCards.length,
-    featuredCandidateCount: featuredCandidates.length,
+    frameRect: {
+      width: frameRect.width,
+      height: frameRect.height
+    },
+    viewport: {
+      width: (doc.defaultView && Number.isFinite(doc.defaultView.innerWidth)) ? doc.defaultView.innerWidth : 0,
+      height: (doc.defaultView && Number.isFinite(doc.defaultView.innerHeight)) ? doc.defaultView.innerHeight : 0
+    },
+    topViewport: {
+      innerWidth: Number.isFinite(window.innerWidth) ? window.innerWidth : 0,
+      innerHeight: Number.isFinite(window.innerHeight) ? window.innerHeight : 0,
+      outerWidth: Number.isFinite(window.outerWidth) ? window.outerWidth : 0,
+      outerHeight: Number.isFinite(window.outerHeight) ? window.outerHeight : 0,
+      visualWidth: (window.visualViewport && Number.isFinite(window.visualViewport.width)) ? window.visualViewport.width : 0,
+      visualHeight: (window.visualViewport && Number.isFinite(window.visualViewport.height)) ? window.visualViewport.height : 0,
+      screenAvailWidth: (window.screen && Number.isFinite(window.screen.availWidth)) ? window.screen.availWidth : 0,
+      screenAvailHeight: (window.screen && Number.isFinite(window.screen.availHeight)) ? window.screen.availHeight : 0,
+      devicePixelRatio: Number.isFinite(window.devicePixelRatio) ? window.devicePixelRatio : 0
+    },
+    candidateCount: effectiveCount,
+    recommendCandidateCount: candidateCards.length,
+    featuredCandidateCount: featuredCandidates.length,
     latestCandidateCount: latestCandidates.length,
     totalCards: Math.max(cards.length, featuredCards.length, latestCards.length),
     activeTabStatus: inferredStatus || null
@@ -4650,23 +4664,25 @@ class RecommendScreenCli {
     return state?.closed === false;
   }
 
-  async getListState() {
-    const state = await this.evaluate(jsGetListState);
-    if (state && typeof state === "object") {
-      const activeStatus = normalizeText(state.activeTabStatus || "");
-      if (activeStatus) {
-        this.lastActiveTabStatus = activeStatus;
-      }
-      return state;
-    }
-    return { ok: false, error: "INVALID_LIST_STATE" };
-  }
-
-  isListViewportCollapsed(state) {
-    if (!state?.ok) return false;
-    const clientHeight = Number(state.clientHeight || 0);
-    const clientWidth = Number(state.clientWidth || 0);
-    const frameWidth = Number(state.frameRect?.width || 0);
+  async getListState() {
+    const state = await this.evaluate(jsGetListState);
+    if (state && typeof state === "object") {
+      const activeStatus = normalizeText(state.activeTabStatus || "");
+      if (activeStatus) {
+        this.lastActiveTabStatus = activeStatus;
+      }
+      state.viewportDiagnostics = await this.getViewportHealthDiagnostics(state);
+      return state;
+    }
+    return { ok: false, error: "INVALID_LIST_STATE" };
+  }
+
+  isListViewportCollapsed(state) {
+    if (!state?.ok) return false;
+    if (state.viewportDiagnostics?.relativeCollapsed === true) return true;
+    const clientHeight = Number(state.clientHeight || 0);
+    const clientWidth = Number(state.clientWidth || 0);
+    const frameWidth = Number(state.frameRect?.width || 0);
     const frameHeight = Number(state.frameRect?.height || 0);
     const viewportWidth = Number(state.viewport?.width || 0);
     const viewportHeight = Number(state.viewport?.height || 0);
@@ -4676,23 +4692,147 @@ class RecommendScreenCli {
       || (clientWidth > 0 && clientWidth < 280)
       || (frameHeight > 0 && frameHeight < 320)
       || (frameWidth > 0 && frameWidth < 460)
-      || (viewportHeight > 0 && viewportHeight < 260)
-      || (viewportWidth > 0 && viewportWidth < 360)
-    );
-  }
-
-  async getCurrentWindowState() {
-    if (!this.Browser || !this.windowId || typeof this.Browser.getWindowBounds !== "function") {
-      return null;
-    }
-    try {
-      const info = await this.Browser.getWindowBounds({ windowId: this.windowId });
-      const state = String(info?.bounds?.windowState || "").toLowerCase();
-      return state || null;
-    } catch {
-      return null;
-    }
-  }
+      || (viewportHeight > 0 && viewportHeight < 260)
+      || (viewportWidth > 0 && viewportWidth < 360)
+    );
+  }
+
+  getPositiveNumber(...values) {
+    for (const value of values) {
+      const number = Number(value);
+      if (Number.isFinite(number) && number > 0) return number;
+    }
+    return 0;
+  }
+
+  async getWindowBoundsInfo() {
+    if (!this.Browser || !this.windowId || typeof this.Browser.getWindowBounds !== "function") {
+      return null;
+    }
+    try {
+      const info = await this.Browser.getWindowBounds({ windowId: this.windowId });
+      return info && typeof info === "object" ? info : null;
+    } catch {
+      return null;
+    }
+  }
+
+  async getPageLayoutMetrics() {
+    if (!this.Page || typeof this.Page.getLayoutMetrics !== "function") {
+      return null;
+    }
+    try {
+      const metrics = await this.Page.getLayoutMetrics();
+      return metrics && typeof metrics === "object" ? metrics : null;
+    } catch {
+      return null;
+    }
+  }
+
+  buildViewportHealthDiagnostics(state, windowInfo = null, layoutMetrics = null) {
+    const topViewport = state?.topViewport || {};
+    const bounds = windowInfo?.bounds || null;
+    const windowState = normalizeText(bounds?.windowState || "").toLowerCase() || null;
+    const windowWidth = this.getPositiveNumber(bounds?.width);
+    const screenAvailWidth = this.getPositiveNumber(topViewport.screenAvailWidth);
+    const topOuterWidth = this.getPositiveNumber(topViewport.outerWidth);
+    const actualWidth = this.getPositiveNumber(
+      layoutMetrics?.cssVisualViewport?.clientWidth,
+      layoutMetrics?.cssLayoutViewport?.clientWidth,
+      topViewport.visualWidth,
+      topViewport.innerWidth,
+      state?.viewport?.width,
+      state?.clientWidth,
+      state?.frameRect?.width
+    );
+    const actualHeight = this.getPositiveNumber(
+      layoutMetrics?.cssVisualViewport?.clientHeight,
+      layoutMetrics?.cssLayoutViewport?.clientHeight,
+      topViewport.visualHeight,
+      topViewport.innerHeight,
+      state?.viewport?.height,
+      state?.clientHeight,
+      state?.frameRect?.height
+    );
+    const nearFullscreen = (
+      windowState === "maximized"
+      || (
+        windowWidth > 0
+        && screenAvailWidth > 0
+        && windowWidth >= screenAvailWidth * VIEWPORT_COLLAPSE_NEAR_FULLSCREEN_RATIO
+      )
+      || (
+        topOuterWidth > 0
+        && screenAvailWidth > 0
+        && topOuterWidth >= screenAvailWidth * VIEWPORT_COLLAPSE_NEAR_FULLSCREEN_RATIO
+      )
+    );
+    let expectedWidth = 0;
+    if (windowState === "maximized" && screenAvailWidth > 0) {
+      expectedWidth = screenAvailWidth;
+    } else if (windowWidth > 0) {
+      expectedWidth = screenAvailWidth > 0 && windowWidth >= screenAvailWidth * VIEWPORT_COLLAPSE_NEAR_FULLSCREEN_RATIO
+        ? Math.min(windowWidth, screenAvailWidth)
+        : windowWidth;
+    } else if (topOuterWidth > 0) {
+      expectedWidth = screenAvailWidth > 0 && topOuterWidth >= screenAvailWidth * VIEWPORT_COLLAPSE_NEAR_FULLSCREEN_RATIO
+        ? Math.min(topOuterWidth, screenAvailWidth)
+        : topOuterWidth;
+    }
+    const widthRatio = actualWidth > 0 && expectedWidth > 0 ? actualWidth / expectedWidth : null;
+    const relativeCollapsed = Boolean(
+      nearFullscreen
+      && expectedWidth >= VIEWPORT_COLLAPSE_MIN_EXPECTED_WIDTH
+      && actualWidth > 0
+      && widthRatio !== null
+      && widthRatio <= VIEWPORT_COLLAPSE_RATIO_THRESHOLD
+    );
+    return {
+      relativeCollapsed,
+      threshold: VIEWPORT_COLLAPSE_RATIO_THRESHOLD,
+      minExpectedWidth: VIEWPORT_COLLAPSE_MIN_EXPECTED_WIDTH,
+      nearFullscreen,
+      windowState,
+      actualWidth,
+      actualHeight,
+      expectedWidth,
+      widthRatio,
+      windowBounds: bounds ? {
+        left: bounds.left ?? null,
+        top: bounds.top ?? null,
+        width: bounds.width ?? null,
+        height: bounds.height ?? null,
+        windowState: bounds.windowState ?? null
+      } : null,
+      cssLayoutViewport: layoutMetrics?.cssLayoutViewport || null,
+      cssVisualViewport: layoutMetrics?.cssVisualViewport || null,
+      topViewport: {
+        innerWidth: topViewport.innerWidth || 0,
+        innerHeight: topViewport.innerHeight || 0,
+        outerWidth: topViewport.outerWidth || 0,
+        outerHeight: topViewport.outerHeight || 0,
+        visualWidth: topViewport.visualWidth || 0,
+        visualHeight: topViewport.visualHeight || 0,
+        screenAvailWidth: topViewport.screenAvailWidth || 0,
+        screenAvailHeight: topViewport.screenAvailHeight || 0,
+        devicePixelRatio: topViewport.devicePixelRatio || 0
+      }
+    };
+  }
+
+  async getViewportHealthDiagnostics(state) {
+    const [windowInfo, layoutMetrics] = await Promise.all([
+      this.getWindowBoundsInfo(),
+      this.getPageLayoutMetrics()
+    ]);
+    return this.buildViewportHealthDiagnostics(state, windowInfo, layoutMetrics);
+  }
+
+  async getCurrentWindowState() {
+    const info = await this.getWindowBoundsInfo();
+    const state = String(info?.bounds?.windowState || "").toLowerCase();
+    return state || null;
+  }
 
   async setWindowStateIfPossible(windowState, reason = "unknown") {
     if (!this.Browser || !this.windowId || typeof this.Browser.setWindowBounds !== "function") {
@@ -4734,26 +4874,31 @@ class RecommendScreenCli {
     return applied;
   }
 
-  async ensureHealthyListViewport(reason = "unknown") {
-    let state = await this.getListState();
-    if (!this.isListViewportCollapsed(state)) {
-      return { ok: true, recovered: false, state };
-    }
-
-    log(`[视口恢复] 检测到推荐列表视口异常缩小，尝试自动恢复。原因: ${reason}`);
-    await this.toggleWindowStateForViewportRecovery(reason);
-    await sleep(humanDelay(900, 130));
-    state = await this.getListState();
+  async ensureHealthyListViewport(reason = "unknown") {
+    let state = await this.getListState();
+    if (!this.isListViewportCollapsed(state)) {
+      return { ok: true, recovered: false, state };
+    }
+
+    const diagnostics = state?.viewportDiagnostics || null;
+    const ratioText = Number.isFinite(diagnostics?.widthRatio)
+      ? `，宽度比例: ${diagnostics.widthRatio.toFixed(3)}`
+      : "";
+    log(`[视口恢复] 检测到推荐列表视口异常缩小，尝试自动恢复。原因: ${reason}${ratioText}`);
+    await this.toggleWindowStateForViewportRecovery(reason);
+    await sleep(humanDelay(900, 130));
+    state = await this.getListState();
     if (!this.isListViewportCollapsed(state)) {
       return { ok: true, recovered: true, state };
     }
 
-    return {
-      ok: false,
-      recovered: false,
-      state
-    };
-  }
+    return {
+      ok: false,
+      recovered: false,
+      state,
+      diagnostics: state?.viewportDiagnostics || diagnostics || null
+    };
+  }
 
   async discoverCandidates() {
     const health = await this.ensureHealthyListViewport("discover_candidates");

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

@@ -185,6 +185,62 @@ function createResumeCaptureError(message = "Resume canvas not found") {
   return error;
 }
 
+function createViewportState(cli, {
+  actualWidth,
+  actualHeight = 585,
+  screenAvailWidth = 1440,
+  windowState = "maximized",
+  windowWidth = 1454
+}) {
+  const state = {
+    ok: true,
+    clientWidth: actualWidth,
+    clientHeight: actualHeight,
+    frameRect: {
+      width: actualWidth,
+      height: actualHeight
+    },
+    viewport: {
+      width: actualWidth,
+      height: actualHeight
+    },
+    topViewport: {
+      innerWidth: actualWidth,
+      innerHeight: actualHeight,
+      outerWidth: actualWidth,
+      outerHeight: actualHeight,
+      visualWidth: actualWidth,
+      visualHeight: actualHeight,
+      screenAvailWidth,
+      screenAvailHeight: 860,
+      devicePixelRatio: 2
+    }
+  };
+  state.viewportDiagnostics = cli.buildViewportHealthDiagnostics(
+    state,
+    {
+      bounds: {
+        left: -7,
+        top: -7,
+        width: windowWidth,
+        height: 874,
+        windowState
+      }
+    },
+    {
+      cssVisualViewport: {
+        clientWidth: actualWidth,
+        clientHeight: actualHeight
+      },
+      cssLayoutViewport: {
+        clientWidth: actualWidth,
+        clientHeight: actualHeight
+      }
+    }
+  );
+  return state;
+}
+
 function createArgs(tempDir) {
   return {
     baseUrl: "https://example.invalid/v1",
@@ -219,6 +275,75 @@ function createArgs(tempDir) {
   };
 }
 
+function testViewportCollapseRiskShouldUseRelativeWidth() {
+  const cli = new RecommendScreenCli(createArgs(os.tmpdir()));
+  const state = createViewportState(cli, {
+    actualWidth: 785,
+    screenAvailWidth: 1440,
+    windowState: "maximized",
+    windowWidth: 1454
+  });
+  assert.equal(state.viewportDiagnostics.relativeCollapsed, true);
+  assert.equal(cli.isListViewportCollapsed(state), true);
+  assert.equal(Math.round(state.viewportDiagnostics.widthRatio * 1000), 545);
+}
+
+function testNormalMaximizedViewportShouldNotCollapse() {
+  const cli = new RecommendScreenCli(createArgs(os.tmpdir()));
+  const state = createViewportState(cli, {
+    actualWidth: 1280,
+    screenAvailWidth: 1440,
+    windowState: "maximized",
+    windowWidth: 1454
+  });
+  assert.equal(state.viewportDiagnostics.relativeCollapsed, false);
+  assert.equal(cli.isListViewportCollapsed(state), false);
+}
+
+function testSmallNormalWindowShouldNotUseScreenWidthRatio() {
+  const cli = new RecommendScreenCli(createArgs(os.tmpdir()));
+  const state = createViewportState(cli, {
+    actualWidth: 785,
+    screenAvailWidth: 1440,
+    windowState: "normal",
+    windowWidth: 800
+  });
+  assert.equal(state.viewportDiagnostics.nearFullscreen, false);
+  assert.equal(state.viewportDiagnostics.relativeCollapsed, false);
+  assert.equal(cli.isListViewportCollapsed(state), false);
+}
+
+async function testViewportCollapseRiskShouldTriggerRecovery() {
+  const cli = new RecommendScreenCli(createArgs(os.tmpdir()));
+  const collapsedState = createViewportState(cli, {
+    actualWidth: 785,
+    screenAvailWidth: 1440,
+    windowState: "maximized",
+    windowWidth: 1454
+  });
+  const healthyState = createViewportState(cli, {
+    actualWidth: 1280,
+    screenAvailWidth: 1440,
+    windowState: "maximized",
+    windowWidth: 1454
+  });
+  let listStateCalls = 0;
+  let recoveryCalled = false;
+  cli.getListState = async () => {
+    listStateCalls += 1;
+    return listStateCalls === 1 ? collapsedState : healthyState;
+  };
+  cli.toggleWindowStateForViewportRecovery = async () => {
+    recoveryCalled = true;
+    return true;
+  };
+  const result = await cli.ensureHealthyListViewport("test_relative_viewport");
+  assert.equal(recoveryCalled, true);
+  assert.equal(result.ok, true);
+  assert.equal(result.recovered, true);
+  assert.equal(result.state, healthyState);
+}
+
 async function withLongResumeChunkEnv(overrides, fn) {
   const envKeys = [
     "BOSS_RECOMMEND_TEXT_CHUNK_SIZE_CHARS",
@@ -2225,6 +2350,10 @@ async function testVisionModelShouldSendAllOrderedChunks() {
 async function main() {
   testShouldAbortResumeProbeEarly();
   testResumeViewportStabilityRequiresSettledScrollAndClip();
+  testViewportCollapseRiskShouldUseRelativeWidth();
+  testNormalMaximizedViewportShouldNotCollapse();
+  testSmallNormalWindowShouldNotUseScreenWidthRatio();
+  await testViewportCollapseRiskShouldTriggerRecovery();
   await testSingleResumeCaptureFailureIsSkipped();
   await testConsecutiveResumeCaptureFailuresStillAbort();
   await testPageExhaustedBeforeTargetShouldRaiseRecoverableError();