@joohw/boss-cli 0.1.9 → 0.2.1

package/dist/common/auth.js

@@ -0,0 +1,150 @@
+import { PROBE_LOGIN_POLL_MS } from '../browser/human_delay.js';
+import { sleepRandom } from '../browser/timing.js';
+/** Boss 直聘首页 */
+export const BOSS_ZHIPIN_HOME = 'https://www.zhipin.com/';
+/** 默认落地页（杭州 SEO 首页）；CLI 等未配置环境变量时使用 */
+export const BOSS_DEFAULT_LANDING_URL = 'https://www.zhipin.com/hangzhou/?seoRefer=index';
+/** 沟通页（登录成功后的典型落地页之一） */
+export const BOSS_CHAT_INDEX_URL = 'https://www.zhipin.com/web/chat/index';
+/** 尚未有可用的浏览器会话时的提示文本（供工具抛错复用）。 */
+export function createWaitManualLoginRequiredText(action) {
+    return `浏览器尚未初始化，无法${action}。请先运行 boss login 并在浏览器中完成登录。`;
+}
+/** 当前 URL 是否属于 Boss 直聘站点（hostname 含 `zhipin.com`）；`about:blank` / 空 / 非法视为否 */
+export function isBossZhipinSiteUrl(url) {
+    if (!url || url === 'about:blank') {
+        return false;
+    }
+    try {
+        const u = new URL(url);
+        return u.hostname.includes('zhipin.com');
+    }
+    catch {
+        return false;
+    }
+}
+/** 当前 URL 是否为沟通页 `/web/chat/index`（允许带 query） */
+export function isBossChatIndexUrl(url) {
+    try {
+        const u = new URL(url);
+        if (!u.hostname.includes('zhipin.com')) {
+            return false;
+        }
+        const p = u.pathname.replace(/\/+$/, '') || '/';
+        return p === '/web/chat/index';
+    }
+    catch {
+        return false;
+    }
+}
+/** 未登录时常见跳转：如 `https://www.zhipin.com/web/user/?ka=bticket` */
+export function isWebUserLoginUrl(url) {
+    try {
+        const u = new URL(url);
+        if (!u.hostname.includes('zhipin.com')) {
+            return false;
+        }
+        return u.pathname.includes('/web/user/');
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 必须在页面里执行的探测脚本（纯字符串）。
+ * `tsx`/esbuild 转译 `page.evaluate(() => { ... })` 时可能注入 `__name(...)`，序列化到浏览器后会报 `__name is not defined`。
+ */
+const PROBE_LOGGED_IN_SIGNALS_SCRIPT = `(() => {
+  function isNick(t) {
+    const s = t.replace(/\\s+/g, " ").trim();
+    if (s.length < 2 || s.length > 64) return false;
+    return !/^(我要登录|登录|注册|登录\\/注册)$/u.test(s);
+  }
+  var hasNickname = false;
+  var nickSelectors = [
+    ".user-name",
+    "span.user-name",
+    "[class*='user-name']",
+    ".label-name",
+    ".nav-user .name",
+    ".nav-user-name",
+    "a.nav-user",
+    ".header-nav [class*='name']",
+  ];
+  var si, i, els, el, t;
+  for (si = 0; si < nickSelectors.length; si++) {
+    els = document.querySelectorAll(nickSelectors[si]);
+    for (i = 0; i < els.length; i++) {
+      el = els[i];
+      t = (el.textContent || "").trim();
+      if (isNick(t)) {
+        hasNickname = true;
+        break;
+      }
+    }
+    if (hasNickname) break;
+  }
+  var navRoots = [];
+  var navSels = ["header", ".nav-header", ".nav-wrap", ".top-header", "#header", ".header", ".navbar"];
+  var j, ne;
+  for (j = 0; j < navSels.length; j++) {
+    ne = document.querySelector(navSels[j]);
+    if (ne instanceof HTMLElement) navRoots.push(ne);
+  }
+  var navLoginCta = false;
+  for (i = 0; i < navRoots.length; i++) {
+    if (/\\b我要登录\\b/u.test(navRoots[i].innerText || "")) {
+      navLoginCta = true;
+      break;
+    }
+  }
+  var bodyText = document.body instanceof HTMLElement ? document.body.innerText || "" : "";
+  var hasLogoutHint =
+    /\\b退出登录\\b/u.test(bodyText) ||
+    !!document.querySelector("a[href*='logout'], a[href*='signout'], [data-url*='logout']");
+  return { hasNickname: hasNickname, navLoginCta: navLoginCta, hasLogoutHint: hasLogoutHint };
+})()`;
+async function probeLoggedInSignals(page) {
+    return (await page.evaluate(PROBE_LOGGED_IN_SIGNALS_SCRIPT));
+}
+/**
+ * 根据当前页判断是否已登录（不导航）。
+ *
+ * **已登录（true）**：检测到顶栏昵称、或「退出登录」/logout 等信号。
+ * 会短轮询等待 SPA 渲染，避免 `goto` 后立即读静态 HTML 误判。
+ *
+ * **未登录（false）**：`/web/user/` 登录流 URL、顶栏出现「我要登录」入口、且轮询结束仍无昵称/退出类信号。
+ */
+export async function probeLoggedInFromPage(page) {
+    const url = page.url();
+    if (!url || url === 'about:blank') {
+        return { loggedIn: false, url: url || '' };
+    }
+    if (isWebUserLoginUrl(url)) {
+        return { loggedIn: false, url };
+    }
+    const maxAttempts = 25;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const s = await probeLoggedInSignals(page);
+        if (s.hasNickname || s.hasLogoutHint) {
+            return { loggedIn: true, url };
+        }
+        if (s.navLoginCta) {
+            return { loggedIn: false, url };
+        }
+        if (attempt < maxAttempts - 1) {
+            await sleepRandom(PROBE_LOGIN_POLL_MS.min, PROBE_LOGIN_POLL_MS.max);
+        }
+    }
+    return { loggedIn: false, url };
+}
+/** 沟通页且已登录（与 {@link probeLoggedInFromPage} 一致）。 */
+export async function probeBossChatIndexLoggedIn(page) {
+    const url = page.url();
+    if (!isBossChatIndexUrl(url)) {
+        return false;
+    }
+    const { loggedIn } = await probeLoggedInFromPage(page);
+    return loggedIn;
+}
+//# sourceMappingURL=auth.js.map

package/dist/common/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/common/auth.ts"],"names":[],"mappings":"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"}

package/dist/common/boss_paywall_popup.d.ts

@@ -1,16 +1,23 @@
 import type { Page } from 'puppeteer-core';
 /**
- * 轮询直到出现 c-resume iframe、或出现付费墙、或超时。付费墙出现时不必再等满 {@link ONLINE_RESUME_IFRAME_WAIT_MAX_MS}。
+ * 轮询直到出现 c-resume iframe、或出现付费墙、或超时。
+ * c-resume 可能在主文档，也可能在 `recommendFrame` 等子 frame 内（推荐预览），故遍历 {@link Page.frames}。
  */
 export declare function waitForCResumeIframeOrPaywall(page: Page, timeoutMs?: number): Promise<'iframe' | 'paywall' | 'neither'>;
+/**
+ * 打招呼等操作后，轮询主文档是否出现付费弹层（与 {@link describeBossPaywallPopupIfPresent} 判定一致）。
+ * 命中则返回 true；超时未出现则返回 false。
+ */
+export declare function waitForBossPaywallPopup(page: Page, timeoutMs?: number): Promise<boolean>;
 /**
  * 若当前存在 VIP/付费类弹层（判定规则与 {@link describeBossPaywallPopupIfPresent} 一致），
  * 则点击关闭按钮以恢复页面可操作状态。返回是否执行了关闭。
  */
 export declare function closeBossPaywallPopupIfPresent(page: Page): Promise<boolean>;
 /**
- * 检测 Boss 页面上是否出现 VIP/付费购买类弹层（如点击「在线简历」或推荐预览后拦截权益时）。
+ * 检测 Boss 页面上是否出现 VIP/付费购买类弹层（如点击「在线简历」、推荐预览或打招呼后拦截权益时）。
  * 命中则返回简短中文说明，供与「未出现 c-resume iframe」类错误拼接。
+ * @param purpose `greet` 时将「查看在线简历」类措辞改为适合打招呼的说明。
  */
-export declare function describeBossPaywallPopupIfPresent(page: Page): Promise<string | null>;
+export declare function describeBossPaywallPopupIfPresent(page: Page, purpose?: 'resume' | 'greet'): Promise<string | null>;
 //# sourceMappingURL=boss_paywall_popup.d.ts.map

package/dist/common/boss_paywall_popup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boss_paywall_popup.d.ts","sourceRoot":"","sources":["../../src/common/boss_paywall_popup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAsC3C;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,IAAI,EACV,SAAS,GAAE,MAAyC,GACnD,OAAO,CAAC,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,CAkB3C;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAoCjF;AAED;;;GAGG;AACH,wBAAsB,iCAAiC,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmC1F"}
+{"version":3,"file":"boss_paywall_popup.d.ts","sourceRoot":"","sources":["../../src/common/boss_paywall_popup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAgC3C;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,IAAI,EACV,SAAS,GAAE,MAAyC,GACnD,OAAO,CAAC,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,CAkB3C;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,SAAS,GAAE,MAAkC,GAC5C,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAoCjF;AAED;;;;GAIG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,QAAQ,GAAG,OAAkB,GACrC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuCxB"}

package/dist/common/boss_paywall_popup.js

@@ -1,14 +1,8 @@
-import { ONLINE_RESUME_IFRAME_WAIT_MAX_MS } from '../browser/human_delay.js';
+import { GREET_PAYWALL_WAIT_MAX_MS, ONLINE_RESUME_IFRAME_WAIT_MAX_MS } from '../browser/human_delay.js';
 import { sleepRandom } from '../browser/timing.js';
-/** 与 {@link describeBossPaywallPopupIfPresent} 中付费层判定一致；先匹配到 c-resume iframe 则返回 iframe。 */
-const WAIT_FOR_IFRAME_OR_PAYWALL_SCRIPT = `(() => {
-  const iframe = document.querySelector(
-    'iframe[src*="c-resume"], iframe[src*="frame/c-resume"]',
-  );
-  if (iframe instanceof HTMLElement) {
-    const r = iframe.getBoundingClientRect();
-    if (r.width > 8 && r.height > 8) return "iframe";
-  }
+import { frameHasVisibleCResumeIframe } from './c_resume_capture.js';
+/** 付费墙仅在主文档轮询（遮罩层挂在顶层）；与 {@link describeBossPaywallPopupIfPresent} 判定一致 */
+const HAS_PAYWALL_SCRIPT = `(() => {
   const roots = Array.from(
     document.querySelectorAll(".boss-popup__wrapper, .boss-dialog__wrapper"),
   );
@@ -29,32 +23,45 @@ const WAIT_FOR_IFRAME_OR_PAYWALL_SCRIPT = `(() => {
         text,
       );
     if (!hasVipUi && !hasPayText) continue;
-    return "paywall";
+    return true;
   }
-  return "";
+  return false;
 })()`;
 /**
- * 轮询直到出现 c-resume iframe、或出现付费墙、或超时。付费墙出现时不必再等满 {@link ONLINE_RESUME_IFRAME_WAIT_MAX_MS}。
+ * 轮询直到出现 c-resume iframe、或出现付费墙、或超时。
+ * c-resume 可能在主文档，也可能在 `recommendFrame` 等子 frame 内（推荐预览），故遍历 {@link Page.frames}。
  */
 export async function waitForCResumeIframeOrPaywall(page, timeoutMs = ONLINE_RESUME_IFRAME_WAIT_MAX_MS) {
-    try {
-        const handle = await page.waitForFunction(WAIT_FOR_IFRAME_OR_PAYWALL_SCRIPT, {
-            timeout: timeoutMs,
-            polling: 200,
-        });
-        const v = (await handle.jsonValue());
-        if (v === 'iframe' || v === 'paywall') {
-            return v;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const paywall = (await page.evaluate(HAS_PAYWALL_SCRIPT));
+        if (paywall) {
+            return 'paywall';
         }
-        return 'neither';
+        const frames = page.frames();
+        for (const frame of frames) {
+            if (await frameHasVisibleCResumeIframe(frame)) {
+                return 'iframe';
+            }
+        }
+        await sleepRandom(160, 240);
     }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        if (/timeout|Timeout|exceeded|Waiting failed/i.test(msg)) {
-            return 'neither';
+    return 'neither';
+}
+/**
+ * 打招呼等操作后，轮询主文档是否出现付费弹层（与 {@link describeBossPaywallPopupIfPresent} 判定一致）。
+ * 命中则返回 true；超时未出现则返回 false。
+ */
+export async function waitForBossPaywallPopup(page, timeoutMs = GREET_PAYWALL_WAIT_MAX_MS) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const paywall = (await page.evaluate(HAS_PAYWALL_SCRIPT));
+        if (paywall) {
+            return true;
         }
-        throw e;
+        await sleepRandom(160, 240);
     }
+    return false;
 }
 /**
  * 若当前存在 VIP/付费类弹层（判定规则与 {@link describeBossPaywallPopupIfPresent} 一致），
@@ -98,11 +105,12 @@ export async function closeBossPaywallPopupIfPresent(page) {
     return closed;
 }
 /**
- * 检测 Boss 页面上是否出现 VIP/付费购买类弹层（如点击「在线简历」或推荐预览后拦截权益时）。
+ * 检测 Boss 页面上是否出现 VIP/付费购买类弹层（如点击「在线简历」、推荐预览或打招呼后拦截权益时）。
  * 命中则返回简短中文说明，供与「未出现 c-resume iframe」类错误拼接。
+ * @param purpose `greet` 时将「查看在线简历」类措辞改为适合打招呼的说明。
  */
-export async function describeBossPaywallPopupIfPresent(page) {
-    return (await page.evaluate(`(() => {
+export async function describeBossPaywallPopupIfPresent(page, purpose = 'resume') {
+    const msg = (await page.evaluate(`(() => {
     const roots = Array.from(
       document.querySelectorAll(".boss-popup__wrapper, .boss-dialog__wrapper"),
     );
@@ -136,5 +144,9 @@ export async function describeBossPaywallPopupIfPresent(page) {
     }
     return null;
   })()`));
+    if (!msg || purpose === 'resume') {
+        return msg;
+    }
+    return msg.replace(/后才能查看在线简历/g, '后才能完成打招呼');
 }
 //# sourceMappingURL=boss_paywall_popup.js.map

package/dist/common/boss_paywall_popup.js.map

@@ -1 +1 @@
-{"version":3,"file":"boss_paywall_popup.js","sourceRoot":"","sources":["../../src/common/boss_paywall_popup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,4FAA4F;AAC5F,MAAM,iCAAiC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA+BrC,CAAC;AAEN;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAAU,EACV,YAAoB,gCAAgC;IAEpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,iCAAiC,EAAE;YAC3E,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,GAAG;SACb,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,EAAE,CAAY,CAAC;QAChD,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,0CAA0C,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACzD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,IAAU;IAC7D,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8B/B,CAAC,CAAY,CAAC;IACnB,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CAAC,IAAU;IAChE,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCvB,CAAC,CAAkB,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"boss_paywall_popup.js","sourceRoot":"","sources":["../../src/common/boss_paywall_popup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AACxG,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,2EAA2E;AAC3E,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;KAwBtB,CAAC;AAEN;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAAU,EACV,YAAoB,gCAAgC;IAEpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAY,CAAC;QACrE,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,MAAM,4BAA4B,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9C,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAU,EACV,YAAoB,yBAAyB;IAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAY,CAAC;QACrE,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,IAAU;IAC7D,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8B/B,CAAC,CAAY,CAAC;IACnB,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,IAAU,EACV,UAA8B,QAAQ;IAEtC,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiC5B,CAAC,CAAkB,CAAC;IACzB,IAAI,CAAC,GAAG,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC"}

package/dist/common/boss_session_page.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Boss B 端「已登录主壳」会话：选页、必要时进入沟通页、侧栏 `.menu-list` 探测与稳定检测，
+ * 再执行 {@link withBossSessionPage} 回调。与 `src/toolset/chat.ts`（按姓名打开会话等业务）无关。
+ */
+import type { Page } from 'puppeteer-core';
+/**
+ * 在已连接浏览器、且当前页为 Boss 已登录主壳（含侧栏 `.menu-list` 稳定）的前提下执行回调。
+ * 若当前不在 zhipin.com 则先进入沟通页 `/web/chat/index`，再校验侧栏；已在 Boss 站内（如推荐页）则不强制跳转。
+ */
+export declare function withBossSessionPage<T>(callback: (page: Page) => Promise<T>): Promise<T>;
+//# sourceMappingURL=boss_session_page.d.ts.map

package/dist/common/boss_session_page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boss_session_page.d.ts","sourceRoot":"","sources":["../../src/common/boss_session_page.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAwIpD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAuD7F"}

package/dist/common/boss_session_page.js

@@ -0,0 +1,155 @@
+import { BOSS_CHAT_INDEX_URL, isBossZhipinSiteUrl } from './auth.js';
+import { hideAgentOperatingIndicator, showAgentOperatingIndicator, } from '../browser/agent_operating_indicator.js';
+import { ensureBrowserSession, getBrowserRef, getPageRef, setSessionPage, } from '../browser/browser_session.js';
+import { CONTEXT_DESTROY_RETRY_MS } from '../browser/human_delay.js';
+import { sleepRandom } from '../browser/timing.js';
+const SHOULD_DISABLE_JS = process.env.BOSS_BROWSER_DISABLE_JS === 'true' || process.env.BOSS_BROWSER_DISABLE_JS === '1';
+/** 设为 `1` / `true` 时不注入顶栏滚动提示（调试或截图对比用）。 */
+const SKIP_AGENT_OPERATING_OVERLAY = process.env.BOSS_CLI_NO_AGENT_OVERLAY === '1' ||
+    process.env.BOSS_CLI_NO_AGENT_OVERLAY === 'true';
+/** Boss 为 SPA：`load` 后侧栏可能尚未挂载，需单独等待 `.menu-list` 出现 */
+const MENU_LIST_MOUNT_TIMEOUT_MS = 30_000;
+async function pickExistingPage(browser) {
+    const pages = (await browser.pages()).filter((p) => !p.isClosed());
+    if (pages.length === 0)
+        return null;
+    const urls = await Promise.all(pages.map((p) => {
+        try {
+            return p.url();
+        }
+        catch {
+            return '';
+        }
+    }));
+    const zhipin = pages.find((p, i) => {
+        const u = urls[i] ?? '';
+        return u.length > 0 && u !== 'about:blank' && u.includes('zhipin.com');
+    });
+    if (zhipin)
+        return zhipin;
+    const nonBlank = pages.find((p, i) => {
+        const u = urls[i] ?? '';
+        return u.length > 0 && u !== 'about:blank';
+    });
+    return nonBlank ?? null;
+}
+function normalizeMenuText(raw) {
+    return (raw ?? '').replace(/\s+/g, ' ').trim();
+}
+async function readMenuListSnapshot(page) {
+    return (await page.evaluate(`(() => {
+    const root = document.querySelector(".menu-list");
+    if (!root) {
+      return { exists: false, signature: "" };
+    }
+    const norm = (v) => (v ?? "").replace(/\\s+/g, " ").trim();
+    const links = Array.from(root.querySelectorAll("dl > dt > a"));
+    const entries = links.map((a) => {
+      const href = a.getAttribute("href") ?? "";
+      const labelNode = a.querySelector(".menu-item-content span");
+      const label = norm(labelNode?.textContent || a.textContent || "");
+      return label + "::" + href;
+    });
+    return { exists: true, signature: entries.join("|") };
+  })()`));
+}
+/** 仅当当前页不在 Boss 站点（非 zhipin.com / 空白等）时进入沟通页，再交由 {@link ensureMenuListStableAfterLoad} 查 `.menu-list` */
+async function ensureBossZhipinLandingBeforeMenuList(page) {
+    if (isBossZhipinSiteUrl(page.url())) {
+        return;
+    }
+    await page.goto(BOSS_CHAT_INDEX_URL, { waitUntil: 'load', timeout: 60_000 });
+}
+async function ensureMenuListStableAfterLoad(page) {
+    await page.waitForFunction(`(() => document.readyState === "complete" || document.readyState === "interactive")()`, { timeout: 12_000 });
+    try {
+        await page.waitForFunction(`(() => !!document.querySelector(".menu-list"))()`, { timeout: MENU_LIST_MOUNT_TIMEOUT_MS });
+    }
+    catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        const timedOut = err.name === 'TimeoutError' || /timeout|waiting failed/i.test(err.message);
+        if (timedOut) {
+            throw new Error(`在 ${MENU_LIST_MOUNT_TIMEOUT_MS / 1000}s 内未出现侧栏 .menu-list（页面或仍在加载，或未登录无法进入主壳）。`);
+        }
+        throw e;
+    }
+    const first = await readMenuListSnapshot(page);
+    if (!first.exists) {
+        throw new Error('当前页面可能未登录或未进入 Boss 主界面。');
+    }
+    if (!normalizeMenuText(first.signature)) {
+        throw new Error('检测到 .menu-list 但菜单内容为空，当前页面状态异常。');
+    }
+    const stableWindowMs = 3_000;
+    const pollMs = 300;
+    const deadline = Date.now() + stableWindowMs;
+    const expected = first.signature;
+    while (Date.now() < deadline) {
+        await sleepRandom(pollMs, pollMs);
+        const snap = await readMenuListSnapshot(page);
+        if (!snap.exists) {
+            throw new Error('页面中的 .menu-list 在 3 秒稳定检测内消失，疑似未登录或页面仍在跳转。');
+        }
+        if (snap.signature !== expected) {
+            throw new Error('页面中的 .menu-list 在 3 秒稳定检测内发生变化，疑似页面仍在重定向或刷新。');
+        }
+    }
+}
+/**
+ * 在已连接浏览器、且当前页为 Boss 已登录主壳（含侧栏 `.menu-list` 稳定）的前提下执行回调。
+ * 若当前不在 zhipin.com 则先进入沟通页 `/web/chat/index`，再校验侧栏；已在 Boss 站内（如推荐页）则不强制跳转。
+ */
+export async function withBossSessionPage(callback) {
+    const isContextDestroyed = (e) => {
+        const msg = e instanceof Error ? e.message : String(e);
+        return (msg.includes('Execution context was destroyed') ||
+            msg.includes('Cannot find context with specified id') ||
+            msg.includes('Most likely because of a navigation'));
+    };
+    const maxAttempts = 2;
+    let lastErr;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            await ensureBrowserSession();
+            const browser = getBrowserRef();
+            if (!browser) {
+                throw new Error('无法获取浏览器实例。');
+            }
+            let page = getPageRef();
+            if (!page || page.isClosed()) {
+                page = (await pickExistingPage(browser)) ?? (await browser.newPage());
+            }
+            setSessionPage(page);
+            await page.bringToFront();
+            await ensureBossZhipinLandingBeforeMenuList(page);
+            if (SHOULD_DISABLE_JS) {
+                await page.setJavaScriptEnabled(false);
+            }
+            await ensureMenuListStableAfterLoad(page);
+            if (!SHOULD_DISABLE_JS && !SKIP_AGENT_OPERATING_OVERLAY) {
+                await showAgentOperatingIndicator(page).catch(() => {
+                    /* 注入失败不阻断业务 */
+                });
+            }
+            try {
+                return await callback(page);
+            }
+            finally {
+                if (!SHOULD_DISABLE_JS && !SKIP_AGENT_OPERATING_OVERLAY) {
+                    await hideAgentOperatingIndicator(page);
+                }
+            }
+        }
+        catch (e) {
+            lastErr = e;
+            if (attempt < maxAttempts - 1 && isContextDestroyed(e)) {
+                // Boss 页面偶发跳转/重渲染会销毁执行上下文；短暂等待并重试一次即可。
+                await sleepRandom(CONTEXT_DESTROY_RETRY_MS.min, CONTEXT_DESTROY_RETRY_MS.max);
+                continue;
+            }
+            throw e;
+        }
+    }
+    throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+}
+//# sourceMappingURL=boss_session_page.js.map

package/dist/common/boss_session_page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boss_session_page.js","sourceRoot":"","sources":["../../src/common/boss_session_page.ts"],"names":[],"mappings":"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"}

package/dist/common/c_resume_capture.d.ts

@@ -1,8 +1,15 @@
-import type { Page } from 'puppeteer-core';
+import type { ElementHandle, Frame, Page } from 'puppeteer-core';
+/** 在线简历 iframe：`src` 常为相对路径 `/web/frame/c-resume/...`，故用子串匹配 */
+export declare const C_RESUME_IFRAME_SELECTOR: "iframe[src*=\"c-resume\"], iframe[src*=\"frame/c-resume\"]";
+export declare function frameHasVisibleCResumeIframe(frame: Frame): Promise<boolean>;
 /** 截图文件名安全段（在线简历 / 推荐预览共用） */
 export declare function safeResumeScreenshotFileBase(name: string): string;
-/** 关闭含 `c-resume` iframe 的弹层（聊天「在线简历」与推荐「预览」共用）。 */
+/** 关闭含 `c-resume` iframe 的弹层（聊天「在线简历」与推荐「预览」共用）。含 `.boss-popup__close`、`.btn-quxiao`（取消）等。会在主文档与各子 frame 中尝试。 */
 export declare function closeCResumePanel(page: Page): Promise<void>;
+/**
+ * 在任意 frame（含主 frame、`recommendFrame` 等）中查找已挂载且尺寸可见的 c-resume iframe。
+ */
+export declare function findVisibleCResumeIframeHandle(page: Page): Promise<ElementHandle<Element> | null>;
 /**
  * 在已出现 `c-resume` iframe 的页面上，对 iframe 整框截图并关闭弹层。
  * `preOpenViewport` 为打开弹层前的视口快照，请用 `snapshotBossPageViewport(page)`（`page.viewport()` 常为 null 时勿直接用默认尺寸）。

package/dist/common/c_resume_capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"c_resume_capture.d.ts","sourceRoot":"","sources":["../../src/common/c_resume_capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAI3C,8BAA8B;AAC9B,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED,oDAAoD;AACpD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BjE;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EACtD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAmClB"}
+{"version":3,"file":"c_resume_capture.d.ts","sourceRoot":"","sources":["../../src/common/c_resume_capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAIjE,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,EACnC,4DAAiE,CAAC;AAqCpE,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAMjF;AAED,8BAA8B;AAC9B,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED,iHAAiH;AACjH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAajE;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAevG;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EACtD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAmClB"}

package/dist/common/c_resume_capture.js

@@ -1,41 +1,90 @@
 import { sleepRandom } from '../browser/timing.js';
 import { resumeHeight, setTempHeight } from '../browser/viewport_temp.js';
+/** 在线简历 iframe：`src` 常为相对路径 `/web/frame/c-resume/...`，故用子串匹配 */
+export const C_RESUME_IFRAME_SELECTOR = 'iframe[src*="c-resume"], iframe[src*="frame/c-resume"]';
+const CLOSE_C_RESUME_PANEL_SCRIPT = `(() => {
+  const sel = ${JSON.stringify(C_RESUME_IFRAME_SELECTOR)};
+  const wraps = Array.from(document.querySelectorAll('.boss-popup__wrapper'));
+  for (var wi = 0; wi < wraps.length; wi++) {
+    var w = wraps[wi];
+    if (w.querySelector(sel)) {
+      var c = w.querySelector('.boss-popup__close') || w.querySelector('.btn-quxiao');
+      if (c) {
+        c.click();
+        return true;
+      }
+    }
+  }
+  var iframe = document.querySelector(sel);
+  var node = iframe ? iframe.parentElement : null;
+  for (var i = 0; i < 12 && node; i++) {
+    var closeBtn = node.querySelector(
+      '.boss-popup__close, .drawer-close, .icon-close, .btn-quxiao',
+    );
+    if (closeBtn) {
+      closeBtn.click();
+      return true;
+    }
+    node = node.parentElement;
+  }
+  return false;
+})()`;
+const VISIBLE_C_RESUME_IN_FRAME_SCRIPT = `(() => {
+  var iframe = document.querySelector(${JSON.stringify(C_RESUME_IFRAME_SELECTOR)});
+  if (!(iframe instanceof HTMLElement)) return false;
+  var r = iframe.getBoundingClientRect();
+  return r.width > 8 && r.height > 8;
+})()`;
+export async function frameHasVisibleCResumeIframe(frame) {
+    try {
+        return (await frame.evaluate(VISIBLE_C_RESUME_IN_FRAME_SCRIPT));
+    }
+    catch {
+        return false;
+    }
+}
 /** 截图文件名安全段（在线简历 / 推荐预览共用） */
 export function safeResumeScreenshotFileBase(name) {
     const t = name.replace(/[/\\?%*:|"<>]/g, '_').trim().slice(0, 64);
     return t.length > 0 ? t : 'candidate';
 }
-/** 关闭含 `c-resume` iframe 的弹层（聊天「在线简历」与推荐「预览」共用）。 */
+/** 关闭含 `c-resume` iframe 的弹层（聊天「在线简历」与推荐「预览」共用）。含 `.boss-popup__close`、`.btn-quxiao`（取消）等。会在主文档与各子 frame 中尝试。 */
 export async function closeCResumePanel(page) {
     try {
-        await page.evaluate(() => {
-            const wraps = Array.from(document.querySelectorAll('.boss-popup__wrapper'));
-            for (const w of wraps) {
-                if (w.querySelector('iframe[src*="c-resume"], iframe[src*="frame/c-resume"]')) {
-                    const c = w.querySelector('.boss-popup__close');
-                    if (c) {
-                        c.click();
-                        return;
-                    }
-                }
+        for (const frame of page.frames()) {
+            try {
+                await frame.evaluate(CLOSE_C_RESUME_PANEL_SCRIPT);
             }
-            const iframe = document.querySelector('iframe[src*="c-resume"], iframe[src*="frame/c-resume"]');
-            let node = iframe?.parentElement ?? null;
-            for (let i = 0; i < 12 && node; i++) {
-                const c = node.querySelector('.boss-popup__close, .drawer-close, .icon-close');
-                if (c) {
-                    c.click();
-                    return;
-                }
-                node = node.parentElement;
+            catch {
+                /* detached / 无权限 */
             }
-        });
+        }
         await sleepRandom(200, 450);
     }
     catch {
         /* ignore */
     }
 }
+/**
+ * 在任意 frame（含主 frame、`recommendFrame` 等）中查找已挂载且尺寸可见的 c-resume iframe。
+ */
+export async function findVisibleCResumeIframeHandle(page) {
+    for (const frame of page.frames()) {
+        try {
+            if (!(await frameHasVisibleCResumeIframe(frame))) {
+                continue;
+            }
+            const h = await frame.$(C_RESUME_IFRAME_SELECTOR);
+            if (h) {
+                return h;
+            }
+        }
+        catch {
+            /* detached */
+        }
+    }
+    return null;
+}
 /**
  * 在已出现 `c-resume` iframe 的页面上，对 iframe 整框截图并关闭弹层。
  * `preOpenViewport` 为打开弹层前的视口快照，请用 `snapshotBossPageViewport(page)`（`page.viewport()` 常为 null 时勿直接用默认尺寸）。
@@ -44,7 +93,7 @@ export async function captureCResumeIframeToFile(page, preOpenViewport, absPath)
     try {
         await setTempHeight(page, preOpenViewport);
         await sleepRandom(100, 320);
-        const iframe = await page.$('iframe[src*="c-resume"], iframe[src*="frame/c-resume"]');
+        const iframe = await findVisibleCResumeIframeHandle(page);
         if (!iframe) {
             return false;
         }