@viyzhu/boss-cli-fork 0.6.8

package/dist/common/boss_paywall_popup.js

@@ -0,0 +1,158 @@
+import { GREET_PAYWALL_WAIT_MAX_MS, ONLINE_RESUME_IFRAME_WAIT_MAX_MS } from '../browser/human_delay.js';
+import { sleepRandom } from '../browser/timing.js';
+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"),
+  );
+  for (const root of roots) {
+    if (!(root instanceof HTMLElement)) continue;
+    const st = window.getComputedStyle(root);
+    if (st.display === "none" || st.visibility === "hidden" || Number(st.opacity) < 0.05) {
+      continue;
+    }
+    const rect = root.getBoundingClientRect();
+    if (rect.width < 20 || rect.height < 20) continue;
+    const hasVipUi = root.querySelector(
+      ".block-vip2, .vip2-layout, .payment-layout-v2, .rights-table-vip, .qrcode-v1, .pay-wrap-qrcode-v1, .panel-deadline",
+    );
+    const text = (root.textContent || "").replace(/\\s+/g, " ");
+    const hasPayText =
+      /VIP账号|商品需付|直豆|扫码支付|请使用.*支付宝|请使用.*微信|增值服务协议|VIP\\s*\\d+项|限时特惠|直豆抵扣/.test(
+        text,
+      );
+    if (!hasVipUi && !hasPayText) continue;
+    return true;
+  }
+  return false;
+})()`;
+/**
+ * 轮询直到出现 c-resume iframe、或出现付费墙、或超时。
+ * c-resume 可能在主文档，也可能在 `recommendFrame` 等子 frame 内（推荐预览），故遍历 {@link Page.frames}。
+ */
+export async function waitForCResumeIframeOrPaywall(page, timeoutMs = ONLINE_RESUME_IFRAME_WAIT_MAX_MS) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const paywall = (await page.evaluate(HAS_PAYWALL_SCRIPT));
+        if (paywall) {
+            return 'paywall';
+        }
+        const frames = page.frames();
+        for (const frame of frames) {
+            if (await frameHasVisibleCResumeIframe(frame)) {
+                return 'iframe';
+            }
+        }
+        await sleepRandom(160, 240);
+    }
+    return 'neither';
+}
+/**
+ * 单次探测：主文档是否当前正显示付费弹层（与 {@link describeBossPaywallPopupIfPresent} 判定一致）。
+ * 供合并轮询（同一循环内同时检测多类弹层）使用，避免重复编写检测脚本。
+ */
+export async function detectBossPaywallPopup(page) {
+    return (await page.evaluate(HAS_PAYWALL_SCRIPT));
+}
+/**
+ * 打招呼等操作后，轮询主文档是否出现付费弹层（与 {@link describeBossPaywallPopupIfPresent} 判定一致）。
+ * 命中则返回 true；超时未出现则返回 false。
+ */
+export async function waitForBossPaywallPopup(page, timeoutMs = GREET_PAYWALL_WAIT_MAX_MS) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await detectBossPaywallPopup(page)) {
+            return true;
+        }
+        await sleepRandom(160, 240);
+    }
+    return false;
+}
+/**
+ * 若当前存在 VIP/付费类弹层（判定规则与 {@link describeBossPaywallPopupIfPresent} 一致），
+ * 则点击关闭按钮以恢复页面可操作状态。返回是否执行了关闭。
+ */
+export async function closeBossPaywallPopupIfPresent(page) {
+    const closed = (await page.evaluate(`(() => {
+    const roots = Array.from(
+      document.querySelectorAll(".boss-popup__wrapper, .boss-dialog__wrapper"),
+    );
+    for (const root of roots) {
+      if (!(root instanceof HTMLElement)) continue;
+      const st = window.getComputedStyle(root);
+      if (st.display === "none" || st.visibility === "hidden" || Number(st.opacity) < 0.05) {
+        continue;
+      }
+      const rect = root.getBoundingClientRect();
+      if (rect.width < 20 || rect.height < 20) continue;
+      const hasVipUi = root.querySelector(
+        ".block-vip2, .vip2-layout, .payment-layout-v2, .rights-table-vip, .qrcode-v1, .pay-wrap-qrcode-v1, .panel-deadline",
+      );
+      const text = (root.textContent || "").replace(/\\s+/g, " ");
+      const hasPayText =
+        /VIP账号|商品需付|直豆|扫码支付|请使用.*支付宝|请使用.*微信|增值服务协议|VIP\\s*\\d+项|限时特惠|直豆抵扣/.test(
+          text,
+        );
+      if (!hasVipUi && !hasPayText) continue;
+      const closeBtn = root.querySelector(
+        ".boss-popup__close, .boss-dialog__close, .drawer-close, .icon-close",
+      );
+      if (closeBtn instanceof HTMLElement) {
+        closeBtn.click();
+        return true;
+      }
+    }
+    return false;
+  })()`));
+    if (closed) {
+        await sleepRandom(220, 480);
+    }
+    return closed;
+}
+/**
+ * 检测 Boss 页面上是否出现 VIP/付费购买类弹层（如点击「在线简历」、推荐预览或打招呼后拦截权益时）。
+ * 命中则返回简短中文说明，供与「未出现 c-resume iframe」类错误拼接。
+ * @param purpose `greet` 时将「查看在线简历」类措辞改为适合打招呼的说明。
+ */
+export async function describeBossPaywallPopupIfPresent(page, purpose = 'resume') {
+    const msg = (await page.evaluate(`(() => {
+    const roots = Array.from(
+      document.querySelectorAll(".boss-popup__wrapper, .boss-dialog__wrapper"),
+    );
+    for (const root of roots) {
+      if (!(root instanceof HTMLElement)) continue;
+      const st = window.getComputedStyle(root);
+      if (st.display === "none" || st.visibility === "hidden" || Number(st.opacity) < 0.05) {
+        continue;
+      }
+      const rect = root.getBoundingClientRect();
+      if (rect.width < 20 || rect.height < 20) continue;
+      const hasVipUi = root.querySelector(
+        ".block-vip2, .vip2-layout, .payment-layout-v2, .rights-table-vip, .qrcode-v1, .pay-wrap-qrcode-v1, .panel-deadline",
+      );
+      const text = (root.textContent || "").replace(/\\s+/g, " ");
+      const hasPayText =
+        /VIP账号|商品需付|直豆|扫码支付|请使用.*支付宝|请使用.*微信|增值服务协议|VIP\\s*\\d+项|限时特惠|直豆抵扣/.test(
+          text,
+        );
+      if (!hasVipUi && !hasPayText) continue;
+      const h = root.querySelector("h3.title, h4.title, .card-header .title");
+      const title = (h?.textContent || "").replace(/\\s+/g, " ").trim();
+      if (title) {
+        return (
+          "页面出现付费弹层（" +
+          title +
+          "），可能需开通 VIP 或购买权益后才能查看在线简历。"
+        );
+      }
+      return "页面出现 VIP/付费购买弹层，可能需开通权益后才能查看在线简历。";
+    }
+    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

@@ -0,0 +1 @@
+{"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,sBAAsB,CAAC,IAAU;IACrD,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAY,CAAC;AAC9D,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,IAAI,MAAM,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,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_lock.d.ts

@@ -0,0 +1,2 @@
+export declare function withBossSessionLock<T>(callback: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=boss_session_lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boss_session_lock.d.ts","sourceRoot":"","sources":["../../src/common/boss_session_lock.ts"],"names":[],"mappings":"AAmGA,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA4CnF"}

package/dist/common/boss_session_lock.js

@@ -0,0 +1,127 @@
+import { open, readFile, rm } from 'node:fs/promises';
+import { hostname } from 'node:os';
+import { join } from 'node:path';
+import { sleepRandom } from '../browser/timing.js';
+import { CACHE_DIR, ensureAppDataLayout } from '../config.js';
+const SESSION_LOCK_FILE = join(CACHE_DIR, 'session.lock');
+const SESSION_LOCK_WAIT_MAX_MS = 30_000;
+const SESSION_LOCK_POLL_MS = 250;
+function buildSessionLockMeta() {
+    return {
+        pid: process.pid,
+        createdAt: Date.now(),
+        hostname: hostname(),
+        cwd: process.cwd(),
+        command: process.argv.join(' ').trim(),
+    };
+}
+async function readSessionLockMeta() {
+    try {
+        const raw = await readFile(SESSION_LOCK_FILE, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.pid !== 'number' ||
+            typeof parsed.createdAt !== 'number' ||
+            typeof parsed.hostname !== 'string' ||
+            typeof parsed.cwd !== 'string' ||
+            typeof parsed.command !== 'string') {
+            return null;
+        }
+        return {
+            pid: parsed.pid,
+            createdAt: parsed.createdAt,
+            hostname: parsed.hostname,
+            cwd: parsed.cwd,
+            command: parsed.command,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function processExists(pid) {
+    if (!Number.isInteger(pid) || pid <= 0) {
+        return false;
+    }
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        const code = error && typeof error === 'object' && 'code' in error ? error.code : '';
+        return code === 'EPERM';
+    }
+}
+async function clearStaleSessionLockIfNeeded() {
+    const meta = await readSessionLockMeta();
+    if (!meta) {
+        await rm(SESSION_LOCK_FILE, { force: true }).catch(() => { });
+        return;
+    }
+    if (meta.hostname !== hostname()) {
+        if (!(await processExists(meta.pid))) {
+            await rm(SESSION_LOCK_FILE, { force: true }).catch(() => { });
+        }
+        return;
+    }
+    if (await processExists(meta.pid)) {
+        return;
+    }
+    await rm(SESSION_LOCK_FILE, { force: true }).catch(() => { });
+}
+function formatSessionLockOwner(meta) {
+    if (!meta) {
+        return 'unknown';
+    }
+    const ageSeconds = Math.max(0, Math.floor((Date.now() - meta.createdAt) / 1000));
+    return [
+        'pid=' + meta.pid,
+        'host=' + meta.hostname,
+        'age=' + ageSeconds + 's',
+        meta.command ? 'cmd=' + meta.command : '',
+    ]
+        .filter(Boolean)
+        .join(', ');
+}
+export async function withBossSessionLock(callback) {
+    ensureAppDataLayout();
+    const deadline = Date.now() + SESSION_LOCK_WAIT_MAX_MS;
+    while (true) {
+        try {
+            const handle = await open(SESSION_LOCK_FILE, 'wx');
+            let lockCreated = false;
+            try {
+                await handle.writeFile(JSON.stringify(buildSessionLockMeta()), 'utf8');
+                lockCreated = true;
+            }
+            finally {
+                await handle.close().catch(() => { });
+            }
+            if (!lockCreated) {
+                await rm(SESSION_LOCK_FILE, { force: true }).catch(() => { });
+                throw new Error('Boss session lock creation failed.');
+            }
+            try {
+                return await callback();
+            }
+            finally {
+                await rm(SESSION_LOCK_FILE, { force: true }).catch(() => { });
+            }
+        }
+        catch (error) {
+            const code = error && typeof error === 'object' && 'code' in error ? error.code : '';
+            if (code !== 'EEXIST') {
+                throw error;
+            }
+            await clearStaleSessionLockIfNeeded();
+            if (Date.now() >= deadline) {
+                const meta = await readSessionLockMeta();
+                throw new Error('Boss session is busy for more than 30s. Lock owner: ' +
+                    formatSessionLockOwner(meta) +
+                    '. If stale, delete ' +
+                    SESSION_LOCK_FILE);
+            }
+            await sleepRandom(SESSION_LOCK_POLL_MS, SESSION_LOCK_POLL_MS);
+        }
+    }
+}
+//# sourceMappingURL=boss_session_lock.js.map

package/dist/common/boss_session_lock.js.map

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

package/dist/common/boss_session_page.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Boss B 端「主壳」会话：选页、必要时进入沟通页、侧栏 `.menu-list` 探测，
+ * 再执行 {@link withBossSessionPage} 回调。与 `src/toolset/chat.ts`（按姓名打开会话等业务）无关。
+ */
+import type { Page } from 'puppeteer-core';
+type BossSessionPageOptions = {
+    ensureChatShell?: boolean;
+    ensureMenuList?: boolean;
+};
+/**
+ * 先按 URL 判断：不在 Boss 已登录主壳页（`/web/chat/*`）时跳到沟通页 `/web/chat/index`，
+ * 再交由 {@link ensureMenuListMountedAfterLoad} 查 `.menu-list`。
+ * 已经在 `/web/chat/recommend`、`/web/chat/aiform` 等主壳子页时直接跳过 goto，
+ * 避免触发"先回到聊天页再切回业务页"的额外跳转。
+ */
+/** 页面守卫熔断（风控页反弹 / 自刷新循环）导致的中止，与普通页面异常区分开。 */
+export declare class BossPageRiskError extends Error {
+    constructor(message: string);
+}
+/**
+ * 在已连接浏览器、且当前页为 Boss 主壳（含侧栏 `.menu-list`）的前提下执行回调。
+ * 默认会先按 URL 确保落在 `/web/chat/*` 主壳页（已在主壳子页则保留原路径，否则跳回沟通页 `/web/chat/index`），
+ * 再校验侧栏；需要严格使用当前页面的命令可通过 options 关闭这些预检查。
+ */
+export declare function withBossSessionPage<T>(callback: (page: Page) => Promise<T>, options?: BossSessionPageOptions): Promise<T>;
+export {};
+//# 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;AAmDpD,KAAK,sBAAsB,GAAG;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAwBF;;;;;GAKG;AACH,6CAA6C;AAC7C,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAsDD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EACpC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,CAAC,CAAC,CAoEZ"}

package/dist/common/boss_session_page.js

@@ -0,0 +1,173 @@
+import { BOSS_CHAT_INDEX_URL, isBossChatShellUrl } from './auth.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';
+import { getBossPageRiskState, installBossPageGuards } from './boss_page_guards.js';
+import { withBossSessionLock } from './boss_session_lock.js';
+const SHOULD_DISABLE_JS = process.env.BOSS_BROWSER_DISABLE_JS === 'true' || process.env.BOSS_BROWSER_DISABLE_JS === '1';
+/** 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("|") };
+  })()`));
+}
+/**
+ * 先按 URL 判断：不在 Boss 已登录主壳页（`/web/chat/*`）时跳到沟通页 `/web/chat/index`，
+ * 再交由 {@link ensureMenuListMountedAfterLoad} 查 `.menu-list`。
+ * 已经在 `/web/chat/recommend`、`/web/chat/aiform` 等主壳子页时直接跳过 goto，
+ * 避免触发"先回到聊天页再切回业务页"的额外跳转。
+ */
+/** 页面守卫熔断（风控页反弹 / 自刷新循环）导致的中止，与普通页面异常区分开。 */
+export class BossPageRiskError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BossPageRiskError';
+    }
+}
+/**
+ * 熔断后立刻停下：继续自动操作既拿不到正确页面，也会让风控进一步升级。
+ * 错误信息直接给出人工处置动作。
+ */
+function assertNoPageRisk(page) {
+    const risk = getBossPageRiskState(page);
+    if (!risk)
+        return;
+    throw new BossPageRiskError(`${risk.message}\n处理方式：在浏览器中完成验证/重新登录，确认能正常停留在沟通页后再重试；` +
+        `若确认无需拦截，可设 BOSS_BROWSER_ALLOW_RISK_NAV=1 让验证页直接渲染。`);
+}
+async function ensureBossChatShellUrlBeforeMenuList(page) {
+    if (isBossChatShellUrl(page.url())) {
+        return;
+    }
+    await page.goto(BOSS_CHAT_INDEX_URL, { waitUntil: 'load', timeout: 60_000 });
+}
+async function ensureMenuListMountedAfterLoad(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 但菜单内容为空，当前页面状态异常。');
+    }
+}
+/**
+ * 在已连接浏览器、且当前页为 Boss 主壳（含侧栏 `.menu-list`）的前提下执行回调。
+ * 默认会先按 URL 确保落在 `/web/chat/*` 主壳页（已在主壳子页则保留原路径，否则跳回沟通页 `/web/chat/index`），
+ * 再校验侧栏；需要严格使用当前页面的命令可通过 options 关闭这些预检查。
+ */
+export async function withBossSessionPage(callback, options = {}) {
+    const shouldEnsureChatShell = options.ensureChatShell !== false;
+    const shouldEnsureMenuList = options.ensureMenuList !== false;
+    return withBossSessionLock(async () => {
+        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++) {
+            let page = null;
+            try {
+                await ensureBrowserSession();
+                const browser = getBrowserRef();
+                if (!browser) {
+                    throw new Error('无法获取浏览器实例。');
+                }
+                page = getPageRef();
+                if (!page || page.isClosed()) {
+                    page = (await pickExistingPage(browser)) ?? (await browser.newPage());
+                }
+                setSessionPage(page);
+                await page.bringToFront();
+                await installBossPageGuards(page);
+                if (shouldEnsureChatShell) {
+                    await ensureBossChatShellUrlBeforeMenuList(page);
+                }
+                assertNoPageRisk(page);
+                if (SHOULD_DISABLE_JS) {
+                    await page.setJavaScriptEnabled(false);
+                }
+                if (shouldEnsureMenuList) {
+                    try {
+                        await ensureMenuListMountedAfterLoad(page);
+                    }
+                    catch (e) {
+                        // 主壳加载不出来时，风控熔断信息比「未出现侧栏」更能定位问题。
+                        assertNoPageRisk(page);
+                        throw e;
+                    }
+                }
+                return await callback(page);
+            }
+            catch (e) {
+                lastErr = e;
+                // 守卫熔断时，把「上下文被销毁」这类次生错误换成风控原因，并且不再重试。
+                if (page && !(e instanceof BossPageRiskError)) {
+                    assertNoPageRisk(page);
+                }
+                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":"AAKA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,iBAAiB,GACrB,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,CAAC;AAEhG,wDAAwD;AACxD,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAE1C,KAAK,UAAU,gBAAgB,CAAC,OAAgB;IAC9C,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACd,IAAI,CAAC;YACH,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,aAAa,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IACH,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACnC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,IAAI,IAAI,CAAC;AAC1B,CAAC;AAYD,SAAS,iBAAiB,CAAC,GAA8B;IACvD,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAU;IAC5C,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;OAcvB,CAAC,CAAqB,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,6CAA6C;AAC7C,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,IAAU;IAClC,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,IAAI,iBAAiB,CACzB,GAAG,IAAI,CAAC,OAAO,wCAAwC;QACrD,oDAAoD,CACvD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,oCAAoC,CAAC,IAAU;IAC5D,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QACnC,OAAO;IACT,CAAC;IACD,MAAM,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,KAAK,UAAU,8BAA8B,CAAC,IAAU;IACtD,MAAM,IAAI,CAAC,eAAe,CACxB,uFAAuF,EACvF,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,eAAe,CACxB,kDAAkD,EAClD,EAAE,OAAO,EAAE,0BAA0B,EAAE,CACxC,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,QAAQ,GACZ,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7E,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,KAAK,0BAA0B,GAAG,IAAI,0CAA0C,CACjF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAoC,EACpC,UAAkC,EAAE;IAEpC,MAAM,qBAAqB,GAAG,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC;IAChE,MAAM,oBAAoB,GAAG,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC;IAE9D,OAAO,mBAAmB,CAAC,KAAK,IAAI,EAAE;QACpC,MAAM,kBAAkB,GAAG,CAAC,CAAU,EAAW,EAAE;YACnD,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,CACL,GAAG,CAAC,QAAQ,CAAC,iCAAiC,CAAC;gBAC/C,GAAG,CAAC,QAAQ,CAAC,uCAAuC,CAAC;gBACrD,GAAG,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CACpD,CAAC;QACJ,CAAC,CAAC;QAEA,MAAM,WAAW,GAAG,CAAC,CAAC;QACtB,IAAI,OAAgB,CAAC;QACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACzD,IAAI,IAAI,GAAgB,IAAI,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,oBAAoB,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;gBAChC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;gBAChC,CAAC;gBAED,IAAI,GAAG,UAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;oBAC7B,IAAI,GAAG,CAAC,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;gBACxE,CAAC;gBACD,cAAc,CAAC,IAAI,CAAC,CAAC;gBACrB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAE1B,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAElC,IAAI,qBAAqB,EAAE,CAAC;oBAC1B,MAAM,oCAAoC,CAAC,IAAI,CAAC,CAAC;gBACnD,CAAC;gBACD,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACvB,IAAI,iBAAiB,EAAE,CAAC;oBACtB,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;gBACzC,CAAC;gBACD,IAAI,oBAAoB,EAAE,CAAC;oBACzB,IAAI,CAAC;wBACH,MAAM,8BAA8B,CAAC,IAAI,CAAC,CAAC;oBAC7C,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,iCAAiC;wBACjC,gBAAgB,CAAC,IAAI,CAAC,CAAC;wBACvB,MAAM,CAAC,CAAC;oBACV,CAAC;gBACH,CAAC;gBAED,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,CAAC,CAAC;gBACZ,sCAAsC;gBACtC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,iBAAiB,CAAC,EAAE,CAAC;oBAC9C,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC;gBACD,IAAI,OAAO,GAAG,WAAW,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvD,uCAAuC;oBACvC,MAAM,WAAW,CAAC,wBAAwB,CAAC,GAAG,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC;oBAC9E,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,CAAC;YACV,CAAC;QACH,CAAC;QACC,MAAM,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/common/boss_sidebar_nav.d.ts

@@ -0,0 +1,7 @@
+import type { Page } from 'puppeteer-core';
+/**
+ * 点击 Boss 左侧 `.menu-list` 中的菜单项，并等待导航到给定 pathname（如 `/web/chat/index`）。
+ * 若合成点击未触发导航（Boss v10718+ SPA 对程序化点击无响应），回退到 `page.goto` 直达目标 URL。
+ */
+export declare function clickBossSidebarMenuToPath(page: Page, menuLabel: string, targetPath: string): Promise<void>;
+//# sourceMappingURL=boss_sidebar_nav.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boss_sidebar_nav.d.ts","sourceRoot":"","sources":["../../src/common/boss_sidebar_nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAkB3C;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAyCf"}

package/dist/common/boss_sidebar_nav.js

@@ -0,0 +1,53 @@
+import { SIDEBAR_NAV_AFTER_CLICK_MS, sleepRandom } from '../browser/index.js';
+const SIDEBAR_NAV_WAIT_MS = 15_000;
+// 2026-07 起 Boss（index v10718+）SPA 侧栏菜单项对程序化 click / dispatchMouseEvent
+// 不再触发路由导航，只有真实指针事件才跳转。故点击后先短等，超时则回退到 page.goto 直达。
+const SIDEBAR_CLICK_NAV_WAIT_MS = 5_000;
+const buildPathReachedPredicate = () => `((path) => {
+      try {
+        const p = window.location.pathname.replace(/\\/+$/, "") || "/";
+        return p === path;
+      } catch {
+        return false;
+      }
+    })`;
+/**
+ * 点击 Boss 左侧 `.menu-list` 中的菜单项，并等待导航到给定 pathname（如 `/web/chat/index`）。
+ * 若合成点击未触发导航（Boss v10718+ SPA 对程序化点击无响应），回退到 `page.goto` 直达目标 URL。
+ */
+export async function clickBossSidebarMenuToPath(page, menuLabel, targetPath) {
+    const clicked = (await page.evaluate(`(({ label, path }) => {
+      const norm = (v) => (v ?? "").replace(/\\s+/g, "");
+      const links = Array.from(document.querySelectorAll(".menu-list a"));
+      const target = links.find((a) => {
+        const href = a.getAttribute("href") ?? "";
+        if (href.includes(path)) {
+          return true;
+        }
+        const text = norm(a.querySelector(".menu-item-content span")?.textContent ?? a.textContent);
+        return text.includes(label);
+      });
+      if (!(target instanceof HTMLElement)) {
+        return false;
+      }
+      target.scrollIntoView({ block: "center", inline: "nearest" });
+      target.click();
+      return true;
+    })`, { label: menuLabel, path: targetPath }));
+    if (!clicked) {
+        throw new Error(`未找到侧边栏菜单“${menuLabel}”，无法跳转到 ${targetPath}。`);
+    }
+    await sleepRandom(SIDEBAR_NAV_AFTER_CLICK_MS.min, SIDEBAR_NAV_AFTER_CLICK_MS.max);
+    const pathReached = buildPathReachedPredicate();
+    try {
+        await page.waitForFunction(pathReached, { timeout: SIDEBAR_CLICK_NAV_WAIT_MS }, targetPath);
+        return;
+    }
+    catch {
+        // 合成点击未导航（Boss v10718+），回退到直接 goto 目标 URL。
+    }
+    const targetUrl = new URL(targetPath, page.url()).toString();
+    await page.goto(targetUrl, { waitUntil: 'load', timeout: 60_000 });
+    await page.waitForFunction(pathReached, { timeout: SIDEBAR_NAV_WAIT_MS }, targetPath);
+}
+//# sourceMappingURL=boss_sidebar_nav.js.map

package/dist/common/boss_sidebar_nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boss_sidebar_nav.js","sourceRoot":"","sources":["../../src/common/boss_sidebar_nav.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,wEAAwE;AACxE,oDAAoD;AACpD,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAExC,MAAM,yBAAyB,GAAG,GAAW,EAAE,CAC7C;;;;;;;OAOK,CAAC;AAER;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAU,EACV,SAAiB,EACjB,UAAkB;IAElB,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAClC;;;;;;;;;;;;;;;;;OAiBG,EACH,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CACvC,CAAY,CAAC;IAEd,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,WAAW,UAAU,GAAG,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,WAAW,CAAC,0BAA0B,CAAC,GAAG,EAAE,0BAA0B,CAAC,GAAG,CAAC,CAAC;IAElF,MAAM,WAAW,GAAG,yBAAyB,EAAE,CAAC;IAEhD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,EAAE,UAAU,CAAC,CAAC;QAC5F,OAAO;IACT,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7D,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,UAAU,CAAC,CAAC;AACxF,CAAC"}

package/dist/common/c_resume_capture.d.ts

@@ -0,0 +1,19 @@
+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 的弹层（聊天「在线简历」与推荐「预览」共用）。含 `.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>;
+export declare function waitForVisibleCResumeIframeReady(page: Page, timeoutMs?: number): Promise<boolean>;
+/**
+ * 在已出现 `c-resume` iframe 的页面上，对 iframe 整框截图并关闭弹层。
+ * `preOpenViewport` 为打开弹层前的视口快照，请用 `snapshotBossPageViewport(page)`（`page.viewport()` 常为 null 时勿直接用默认尺寸）。
+ */
+export declare function captureCResumeIframeToFile(page: Page, preOpenViewport: Awaited<ReturnType<Page['viewport']>>, absPath: string): Promise<boolean>;
+//# sourceMappingURL=c_resume_capture.d.ts.map

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

@@ -0,0 +1 @@
+{"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;AAmDpE,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,CAoBjE;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAevG;AAED,wBAAsB,gCAAgC,CACpD,IAAI,EAAE,IAAI,EACV,SAAS,SAAQ,GAChB,OAAO,CAAC,OAAO,CAAC,CAoClB;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,CAuClB"}