@viyzhu/boss-cli-fork 0.6.8

package/dist/browser/cdp_browser.js

@@ -0,0 +1,315 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import readline from 'node:readline';
+import path from 'node:path';
+import puppeteer from 'puppeteer-core';
+import { BROWSER_USER_DATA_DIR, ensureAppDataLayout } from '../config.js';
+/** 与 @puppeteer/browsers 一致，解析 Chrome 启动日志中的 CDP WebSocket URL（可能在 stdout 或 stderr）。 */
+const CDP_WEBSOCKET_ENDPOINT_REGEX = /^DevTools listening on (ws:\/\/.*)$/;
+const LAUNCH_READY_MS = 30_000;
+/**
+ * 固定的远程调试端口：boss-cli 使用独立的 user-data-dir，因此可以稳定占用一个端口，
+ * 让多个命令直接通过 `http://127.0.0.1:<port>/json/version` 复用同一只浏览器。
+ * 可用 `BOSS_BROWSER_REMOTE_DEBUGGING_PORT` 覆盖。
+ */
+export const REMOTE_DEBUGGING_PORT = (() => {
+    const raw = process.env.BOSS_BROWSER_REMOTE_DEBUGGING_PORT?.trim();
+    if (raw) {
+        const n = Number.parseInt(raw, 10);
+        if (Number.isFinite(n) && n > 0 && n <= 65535)
+            return n;
+    }
+    return 53470;
+})();
+let spawnedChromeChild = null;
+/** 最近一次 `connectBrowser` 是否以无头方式启动（`browser.process()` 在 connect 模式下不可用，供 login 等逻辑判断）。 */
+let lastChromeLaunchHeadless = false;
+export function clearSpawnedChromeProcessRef() {
+    spawnedChromeChild = null;
+}
+/** 最近一次启动是否为无头（仅本进程内、与当前会话一致时有效）。 */
+export function wasLastChromeLaunchHeadless() {
+    return lastChromeLaunchHeadless;
+}
+/**
+ * 探测固定调试端口上是否已有在跑的 Chrome：直接命中 `/json/version` 拿当前
+ * `webSocketDebuggerUrl`，避免依赖 `DevToolsActivePort` 这种二级状态文件
+ * （可能被陈旧/清理/路径 UUID 漂移影响）。命中即可复用，未命中表示需要 spawn。
+ */
+async function probeRemoteDebuggingWsEndpoint(port, timeoutMs) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+    try {
+        const res = await fetch(`http://127.0.0.1:${port}/json/version`, {
+            signal: ctrl.signal,
+        });
+        if (!res.ok)
+            return undefined;
+        const data = (await res.json());
+        const ws = data.webSocketDebuggerUrl;
+        return typeof ws === 'string' && ws.length > 0 ? ws : undefined;
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function waitForDevToolsWebSocketUrl(proc, userDataDir, timeoutMs) {
+    const streams = [proc.stdout, proc.stderr].filter((s) => s != null);
+    if (streams.length === 0) {
+        return Promise.reject(new Error('浏览器子进程无 stdout/stderr，无法获取 CDP 地址'));
+    }
+    return new Promise((resolve, reject) => {
+        const rls = [];
+        let settled = false;
+        let timer;
+        const cleanup = () => {
+            for (const rl of rls) {
+                try {
+                    rl.close();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            rls.length = 0;
+        };
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer !== undefined) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+            proc.off('exit', onExit);
+            proc.off('error', onProcError);
+            cleanup();
+            fn();
+        };
+        timer = setTimeout(() => {
+            finish(() => {
+                reject(new Error(`等待 Chrome 输出 DevTools 地址超时（${timeoutMs}ms）`));
+            });
+        }, timeoutMs);
+        const onExit = (code) => {
+            finish(() => {
+                reject(new Error(code === 0
+                    ? `浏览器进程立即以代码 0 退出：user-data-dir「${userDataDir}」可能正被另一只「无远程调试端口」的 Chrome 持有（Chrome 单例锁会让我们 spawn 的新进程把命令行交还给它后立刻退出）。请关闭占用该目录的 Chrome 窗口后重试。`
+                    : `浏览器进程在就绪前退出（代码 ${code ?? 'unknown'}）`));
+            });
+        };
+        const onProcError = (err) => {
+            finish(() => {
+                reject(err);
+            });
+        };
+        const onLine = (line) => {
+            const m = line.trim().match(CDP_WEBSOCKET_ENDPOINT_REGEX);
+            if (m?.[1]) {
+                finish(() => {
+                    resolve(m[1]);
+                });
+            }
+        };
+        proc.once('exit', onExit);
+        proc.once('error', onProcError);
+        for (const s of streams) {
+            const rl = readline.createInterface(s);
+            rls.push(rl);
+            rl.on('line', onLine);
+        }
+    });
+}
+/** 在未配置路径时，尝试常见安装位置（Chrome / Edge / Chromium）。 */
+function findLocalChromiumExecutable() {
+    const candidates = [];
+    if (process.platform === 'win32') {
+        const local = process.env.LOCALAPPDATA;
+        const pf = process.env.PROGRAMFILES;
+        const pf86 = process.env['PROGRAMFILES(X86)'];
+        if (local) {
+            candidates.push(path.join(local, 'Google', 'Chrome', 'Application', 'chrome.exe'));
+        }
+        if (pf) {
+            candidates.push(path.join(pf, 'Google', 'Chrome', 'Application', 'chrome.exe'));
+            candidates.push(path.join(pf, 'Microsoft', 'Edge', 'Application', 'msedge.exe'));
+        }
+        if (pf86) {
+            candidates.push(path.join(pf86, 'Google', 'Chrome', 'Application', 'chrome.exe'));
+            candidates.push(path.join(pf86, 'Microsoft', 'Edge', 'Application', 'msedge.exe'));
+        }
+    }
+    else if (process.platform === 'darwin') {
+        candidates.push('/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge', '/Applications/Chromium.app/Contents/MacOS/Chromium');
+    }
+    else {
+        candidates.push('/usr/bin/google-chrome-stable', '/usr/bin/google-chrome', '/usr/bin/chromium', '/usr/bin/chromium-browser', '/usr/bin/microsoft-edge-stable', '/usr/bin/microsoft-edge');
+    }
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    return undefined;
+}
+/** 减轻「正受到自动测试软件的控制」提示与常见自动化特征（非万能，站点仍可能用其它方式检测）。手动开 Chrome 并接 CDP 时可复用。 */
+export const LAUNCH_ARGS_LESS_AUTOMATION = [
+    '--disable-infobars',
+];
+/** 仅用于本地调试：尽量放宽同源/CORS 限制，便于跨域 iframe/canvas 处理。 */
+export const LAUNCH_ARGS_ALLOW_ALL_CORS = [
+    '--disable-web-security',
+    '--allow-running-insecure-content',
+];
+/**
+ * 启动本机浏览器（puppeteer-core 底层为 Chrome DevTools Protocol）。
+ *
+ * 环境变量（可选）：
+ * - `CHROME_PATH` / `PUPPETEER_EXECUTABLE_PATH` — 启动本机浏览器可执行文件路径（高于自动探测）
+ * - `BOSS_BROWSER_USER_DATA_DIR` — 启动浏览器时复用的用户数据目录；未设置时默认 `~/.boss-cli/.cache/browser-data`
+ * - `BOSS_BROWSER_PROFILE_DIRECTORY` — 启动浏览器时指定 profile（如 `Default`）
+ * - `BOSS_BROWSER_REMOTE_DEBUGGING_PORT` — 远程调试端口（默认 53470）；同一 user-data-dir 跨命令复用该端口
+ * - `BOSS_BROWSER_ALLOW_ALL_CORS` — 设为 `true` 时附加放宽同源/CORS 的启动参数（仅调试）
+ * - `BOSS_BROWSER_DISABLE_GPU` — 设为 `true` 时附加 `--disable-gpu`
+ *
+ * 若以上均未设置，会按系统尝试常见 Chrome / Edge / Chromium 安装路径。
+ * - `BOSS_BROWSER_HEADLESS` — 设为 `true` 时启用无头；默认**有界面**。
+ * - `BOSS_BROWSER_VIEWPORT_WIDTH` / `BOSS_BROWSER_VIEWPORT_HEIGHT` — 启动时显式指定视口；未设置时不覆盖浏览器窗口尺寸
+ */
+/** 启动浏览器时的默认视口（与环境变量一致）；截图恢复时 `viewport()` 为 null 也可用其兜底。 */
+export function defaultViewportFromEnv() {
+    const w = Number.parseInt(process.env.BOSS_BROWSER_VIEWPORT_WIDTH?.trim() ?? '', 10);
+    const h = Number.parseInt(process.env.BOSS_BROWSER_VIEWPORT_HEIGHT?.trim() ?? '', 10);
+    return {
+        width: Number.isFinite(w) && w > 0 ? w : 1280,
+        height: Number.isFinite(h) && h > 0 ? h : 1200,
+    };
+}
+/** 仅在显式配置了视口环境变量时返回启动视口；否则返回 null，不覆盖浏览器实际窗口尺寸。 */
+function launchViewportFromEnv() {
+    const rawW = process.env.BOSS_BROWSER_VIEWPORT_WIDTH?.trim() ?? '';
+    const rawH = process.env.BOSS_BROWSER_VIEWPORT_HEIGHT?.trim() ?? '';
+    if (!rawW && !rawH) {
+        return null;
+    }
+    return defaultViewportFromEnv();
+}
+export async function connectBrowser(options = {}) {
+    const executablePath = options.executablePath?.trim() ||
+        process.env.CHROME_PATH?.trim() ||
+        process.env.PUPPETEER_EXECUTABLE_PATH?.trim() ||
+        findLocalChromiumExecutable();
+    const envUserData = process.env.BOSS_BROWSER_USER_DATA_DIR?.trim();
+    if (!envUserData) {
+        ensureAppDataLayout();
+    }
+    const userDataDir = options.userDataDir?.trim() || envUserData || BROWSER_USER_DATA_DIR;
+    const profileDirectory = options.profileDirectory?.trim() || process.env.BOSS_BROWSER_PROFILE_DIRECTORY?.trim();
+    if (!executablePath) {
+        throw new Error('未找到本机 Chrome/Edge：请设置 CHROME_PATH / PUPPETEER_EXECUTABLE_PATH（可执行文件路径）。');
+    }
+    const headless = options.headless ?? process.env.BOSS_BROWSER_HEADLESS === 'true';
+    const allowAllCors = options.allowAllCors ?? process.env.BOSS_BROWSER_ALLOW_ALL_CORS === 'true';
+    const disableGpu = process.env.BOSS_BROWSER_DISABLE_GPU === 'true';
+    clearSpawnedChromeProcessRef();
+    lastChromeLaunchHeadless = !!headless;
+    /**
+     * 优先直连固定调试端口上的已有实例：boss-cli 使用独立 user-data-dir，
+     * 端口稳定可期，命中即跨命令复用同一只浏览器（同一登录态、同一标签）。
+     */
+    const existingWsUrl = await probeRemoteDebuggingWsEndpoint(REMOTE_DEBUGGING_PORT, 800);
+    if (existingWsUrl) {
+        return await puppeteer.connect({
+            browserWSEndpoint: existingWsUrl,
+            defaultViewport: launchViewportFromEnv(),
+        });
+    }
+    // 默认保留 WebAssembly：`typeof WebAssembly === 'undefined'` 本身就是强自动化指纹。
+    // aegis_bg.wasm 已在 CDP `Fetch.enable` 层被阻断，不需要再禁用 WASM 引擎。
+    // 仅当显式设置 BOSS_BROWSER_DISABLE_WASM=true/1 时才追加 --noexpose_wasm。
+    const disableWasm = process.env.BOSS_BROWSER_DISABLE_WASM === 'true' || process.env.BOSS_BROWSER_DISABLE_WASM === '1';
+    const userArgs = [
+        ...LAUNCH_ARGS_LESS_AUTOMATION,
+        ...(disableGpu ? ['--disable-gpu'] : []),
+        ...(disableWasm ? ['--js-flags=--noexpose_wasm'] : []),
+        ...(allowAllCors ? LAUNCH_ARGS_ALLOW_ALL_CORS : []),
+        ...(profileDirectory ? [`--profile-directory=${profileDirectory}`] : []),
+    ];
+    let chromeArgs = puppeteer
+        .defaultArgs({
+        browser: 'chrome',
+        userDataDir,
+        headless,
+        args: userArgs,
+    })
+        .filter((a) => a !== '--enable-automation' && a !== 'about:blank' && a !== 'data:,');
+    if (!chromeArgs.some((a) => a.startsWith('--remote-debugging-'))) {
+        chromeArgs.push(`--remote-debugging-port=${REMOTE_DEBUGGING_PORT}`);
+    }
+    /**
+     * 不使用 `puppeteer.launch()`：其依赖的 `@puppeteer/browsers` 会在 **Node 进程 `exit` 时 kill 浏览器子进程**，
+     * 导致交互模式 / `npm run dev` 退出时窗口被一并关掉。改为自行 `spawn` + `connect`，退出时只断 CDP，浏览器可保留。
+     */
+    const proc = spawn(executablePath, chromeArgs, {
+        detached: true,
+        env: process.env,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    spawnedChromeChild = proc;
+    let wsUrl;
+    try {
+        wsUrl = await waitForDevToolsWebSocketUrl(proc, userDataDir, LAUNCH_READY_MS);
+    }
+    catch (e) {
+        try {
+            proc.kill();
+        }
+        catch {
+            /* ignore */
+        }
+        clearSpawnedChromeProcessRef();
+        throw e;
+    }
+    try {
+        proc.stdout?.resume();
+        proc.stderr?.resume();
+    }
+    catch {
+        /* ignore */
+    }
+    /** 单例移交时子进程已退出，无句柄可 unref；仅在本进程真正拉起 Chrome 时 unref，避免拖住 Node 退出。 */
+    if (proc.exitCode === null && proc.signalCode === null) {
+        try {
+            proc.unref();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    else {
+        clearSpawnedChromeProcessRef();
+    }
+    try {
+        return await puppeteer.connect({
+            browserWSEndpoint: wsUrl,
+            defaultViewport: launchViewportFromEnv(),
+        });
+    }
+    catch (e) {
+        try {
+            proc.kill();
+        }
+        catch {
+            /* ignore */
+        }
+        clearSpawnedChromeProcessRef();
+        throw e;
+    }
+}
+/** 对某一页创建原生 CDP Session（需要低层域如 `Network.*`、`Fetch.*` 时使用）。 */
+export async function createPageCDPSession(page) {
+    return page.createCDPSession();
+}
+//# sourceMappingURL=cdp_browser.js.map

package/dist/browser/cdp_browser.js.map

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

package/dist/browser/human_delay.d.ts

@@ -0,0 +1,117 @@
+import type { Page } from 'puppeteer-core';
+/** macOS 用 Meta，其余平台用 Control */
+export declare function selectAllModifierKey(): 'Meta' | 'Control';
+/** 导航到沟通页并 load 后，等待 SPA/接口渲染 */
+export declare const CHAT_GOTO_SETTLE_MS: {
+    readonly min: 2800;
+    readonly max: 5200;
+};
+/** 页面执行上下文被销毁后重试前 */
+export declare const CONTEXT_DESTROY_RETRY_MS: {
+    readonly min: 900;
+    readonly max: 1800;
+};
+/** 侧栏导航点击后，等待路由与 SPA 状态开始变化 */
+export declare const SIDEBAR_NAV_AFTER_CLICK_MS: {
+    readonly min: 420;
+    readonly max: 1100;
+};
+/** 列表滚动查找候选人时，每轮之间的间隔 */
+export declare const OPEN_CHAT_SCROLL_GAP_MS: {
+    readonly min: 240;
+    readonly max: 760;
+};
+/** 点击会话行后，等待右侧面板出现的短停顿 */
+export declare const OPEN_CHAT_AFTER_ROW_CLICK_MS: {
+    readonly min: 420;
+    readonly max: 1200;
+};
+/** mouse.click 的按下/抬起间隔（Puppeteer delay 选项） */
+export declare const MOUSE_CLICK_PRESS_MS: {
+    readonly min: 55;
+    readonly max: 180;
+};
+/** 筛选「全部」等操作之间的停顿 */
+export declare const LIST_FILTER_GAP_MS: {
+    readonly min: 780;
+    readonly max: 1400;
+};
+/** 岗位下拉打开、搜索输入、选择岗位等连续动作之间的停顿 */
+export declare const JOB_SELECT_ACTION_GAP_MS: {
+    readonly min: 280;
+    readonly max: 760;
+};
+/** 岗位搜索输入后，等待前端过滤/接口刷新开始响应 */
+export declare const JOB_SEARCH_ACTION_GAP_MS: {
+    readonly min: 420;
+    readonly max: 980;
+};
+/** 点击候选人卡片打开简历预览后，等待弹层/iframe 开始挂载 */
+export declare const RESUME_PREVIEW_OPEN_GAP_MS: {
+    readonly min: 420;
+    readonly max: 1100;
+};
+/** 列表稳定轮询间隔（随机） */
+export declare const LIST_POLL_MS: {
+    readonly min: 420;
+    readonly max: 780;
+};
+/** 列表为空时至少等待多久才认为稳定 */
+export declare const LIST_MIN_BEFORE_EMPTY_OK_MS = 5000;
+/** 登录态探测轮询间隔 */
+export declare const PROBE_LOGIN_POLL_MS: {
+    readonly min: 520;
+    readonly max: 980;
+};
+/** 点击聊天输入框 */
+export declare const SEND_INPUT_CLICK_MS: {
+    readonly min: 45;
+    readonly max: 160;
+};
+/** 逐字输入：字符间隔（随机） */
+export declare const SEND_TYPING_GAP_MS: {
+    readonly min: 38;
+    readonly max: 125;
+};
+/** 按下 Enter 后、流程结束前短停顿 */
+export declare const SEND_AFTER_ENTER_MS: {
+    readonly min: 260;
+    readonly max: 920;
+};
+/** `send` 中先发完文字后、再执行 `--action` 前的默认随机间隔（求简历 / 同意或拒绝附件等） */
+export declare const SEND_BEFORE_RESUME_MS: {
+    readonly min: 2800;
+    readonly max: 5600;
+};
+/** 点击「沟通记录」后等待弹窗与列表渲染 */
+export declare const CHAT_HISTORY_DIALOG_WAIT_MS: {
+    readonly min: 500;
+    readonly max: 1400;
+};
+/** 「同事沟通」/「我的沟通」切换后等待列表刷新 */
+export declare const CHAT_HISTORY_TAB_SWITCH_MS: {
+    readonly min: 350;
+    readonly max: 900;
+};
+/** 点击「在线简历」后等待 iframe 出现 */
+export declare const ONLINE_RESUME_IFRAME_APPEAR_MS: {
+    readonly min: 600;
+    readonly max: 1600;
+};
+/**
+ * 点击后等待 c-resume iframe 出现、或判定为付费墙弹层的上限（毫秒）。
+ * 仅在未出现付费墙时才会接近该时长；若先出现付费墙会提前结束（见 `waitForCResumeIframeOrPaywall`）。
+ */
+export declare const ONLINE_RESUME_IFRAME_WAIT_MAX_MS = 15000;
+/** 打招呼点击后主文档付费弹层轮询上限（毫秒）；命中则提前结束，未命中时最多增加约此时长。 */
+export declare const GREET_PAYWALL_WAIT_MAX_MS = 3500;
+/** iframe 出现后等待简历区域渲染 */
+export declare const ONLINE_RESUME_IFRAME_SETTLE_MS: {
+    readonly min: 1800;
+    readonly max: 4200;
+};
+/**
+ * 逐字符输入，字符之间为随机间隔（末尾字符后不再额外等待）。
+ */
+export declare function typeTextWithRandomKeyDelay(page: Page, text: string, minGapMs: number, maxGapMs: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=human_delay.d.ts.map

package/dist/browser/human_delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human_delay.d.ts","sourceRoot":"","sources":["../../src/browser/human_delay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAG3C,iCAAiC;AACjC,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAEzD;AAED,iCAAiC;AACjC,eAAO,MAAM,mBAAmB;;;CAAoC,CAAC;AAErE,qBAAqB;AACrB,eAAO,MAAM,wBAAwB;;;CAAmC,CAAC;AAEzE,+BAA+B;AAC/B,eAAO,MAAM,0BAA0B;;;CAAmC,CAAC;AAE3E,yBAAyB;AACzB,eAAO,MAAM,uBAAuB;;;CAAkC,CAAC;AAEvE,0BAA0B;AAC1B,eAAO,MAAM,4BAA4B;;;CAAmC,CAAC;AAE7E,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB;;;CAAiC,CAAC;AAEnE,qBAAqB;AACrB,eAAO,MAAM,kBAAkB;;;CAAmC,CAAC;AAEnE,iCAAiC;AACjC,eAAO,MAAM,wBAAwB;;;CAAkC,CAAC;AAExE,8BAA8B;AAC9B,eAAO,MAAM,wBAAwB;;;CAAkC,CAAC;AAExE,sCAAsC;AACtC,eAAO,MAAM,0BAA0B;;;CAAmC,CAAC;AAE3E,mBAAmB;AACnB,eAAO,MAAM,YAAY;;;CAAkC,CAAC;AAE5D,uBAAuB;AACvB,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD,gBAAgB;AAChB,eAAO,MAAM,mBAAmB;;;CAAkC,CAAC;AAEnE,cAAc;AACd,eAAO,MAAM,mBAAmB;;;CAAiC,CAAC;AAElE,oBAAoB;AACpB,eAAO,MAAM,kBAAkB;;;CAAiC,CAAC;AAEjE,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB;;;CAAkC,CAAC;AAEnE,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB;;;CAAoC,CAAC;AAEvE,yBAAyB;AACzB,eAAO,MAAM,2BAA2B;;;CAAmC,CAAC;AAE5E,6BAA6B;AAC7B,eAAO,MAAM,0BAA0B;;;CAAkC,CAAC;AAE1E,4BAA4B;AAC5B,eAAO,MAAM,8BAA8B;;;CAAmC,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAEvD,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,yBAAyB;AACzB,eAAO,MAAM,8BAA8B;;;CAAoC,CAAC;AAEhF;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/browser/human_delay.js

@@ -0,0 +1,71 @@
+import { randomIntInclusive, sleep } from './timing.js';
+/** macOS 用 Meta，其余平台用 Control */
+export function selectAllModifierKey() {
+    return process.platform === 'darwin' ? 'Meta' : 'Control';
+}
+/** 导航到沟通页并 load 后，等待 SPA/接口渲染 */
+export const CHAT_GOTO_SETTLE_MS = { min: 2800, max: 5200 };
+/** 页面执行上下文被销毁后重试前 */
+export const CONTEXT_DESTROY_RETRY_MS = { min: 900, max: 1800 };
+/** 侧栏导航点击后，等待路由与 SPA 状态开始变化 */
+export const SIDEBAR_NAV_AFTER_CLICK_MS = { min: 420, max: 1100 };
+/** 列表滚动查找候选人时，每轮之间的间隔 */
+export const OPEN_CHAT_SCROLL_GAP_MS = { min: 240, max: 760 };
+/** 点击会话行后，等待右侧面板出现的短停顿 */
+export const OPEN_CHAT_AFTER_ROW_CLICK_MS = { min: 420, max: 1200 };
+/** mouse.click 的按下/抬起间隔（Puppeteer delay 选项） */
+export const MOUSE_CLICK_PRESS_MS = { min: 55, max: 180 };
+/** 筛选「全部」等操作之间的停顿 */
+export const LIST_FILTER_GAP_MS = { min: 780, max: 1400 };
+/** 岗位下拉打开、搜索输入、选择岗位等连续动作之间的停顿 */
+export const JOB_SELECT_ACTION_GAP_MS = { min: 280, max: 760 };
+/** 岗位搜索输入后，等待前端过滤/接口刷新开始响应 */
+export const JOB_SEARCH_ACTION_GAP_MS = { min: 420, max: 980 };
+/** 点击候选人卡片打开简历预览后，等待弹层/iframe 开始挂载 */
+export const RESUME_PREVIEW_OPEN_GAP_MS = { min: 420, max: 1100 };
+/** 列表稳定轮询间隔（随机） */
+export const LIST_POLL_MS = { min: 420, max: 780 };
+/** 列表为空时至少等待多久才认为稳定 */
+export const LIST_MIN_BEFORE_EMPTY_OK_MS = 5000;
+/** 登录态探测轮询间隔 */
+export const PROBE_LOGIN_POLL_MS = { min: 520, max: 980 };
+/** 点击聊天输入框 */
+export const SEND_INPUT_CLICK_MS = { min: 45, max: 160 };
+/** 逐字输入：字符间隔（随机） */
+export const SEND_TYPING_GAP_MS = { min: 38, max: 125 };
+/** 按下 Enter 后、流程结束前短停顿 */
+export const SEND_AFTER_ENTER_MS = { min: 260, max: 920 };
+/** `send` 中先发完文字后、再执行 `--action` 前的默认随机间隔（求简历 / 同意或拒绝附件等） */
+export const SEND_BEFORE_RESUME_MS = { min: 2800, max: 5600 };
+/** 点击「沟通记录」后等待弹窗与列表渲染 */
+export const CHAT_HISTORY_DIALOG_WAIT_MS = { min: 500, max: 1400 };
+/** 「同事沟通」/「我的沟通」切换后等待列表刷新 */
+export const CHAT_HISTORY_TAB_SWITCH_MS = { min: 350, max: 900 };
+/** 点击「在线简历」后等待 iframe 出现 */
+export const ONLINE_RESUME_IFRAME_APPEAR_MS = { min: 600, max: 1600 };
+/**
+ * 点击后等待 c-resume iframe 出现、或判定为付费墙弹层的上限（毫秒）。
+ * 仅在未出现付费墙时才会接近该时长；若先出现付费墙会提前结束（见 `waitForCResumeIframeOrPaywall`）。
+ */
+export const ONLINE_RESUME_IFRAME_WAIT_MAX_MS = 15_000;
+/** 打招呼点击后主文档付费弹层轮询上限（毫秒）；命中则提前结束，未命中时最多增加约此时长。 */
+export const GREET_PAYWALL_WAIT_MAX_MS = 3500;
+/** iframe 出现后等待简历区域渲染 */
+export const ONLINE_RESUME_IFRAME_SETTLE_MS = { min: 1800, max: 4200 };
+/**
+ * 逐字符输入，字符之间为随机间隔（末尾字符后不再额外等待）。
+ */
+export async function typeTextWithRandomKeyDelay(page, text, minGapMs, maxGapMs, signal) {
+    const codepoints = Array.from(text);
+    for (let i = 0; i < codepoints.length; i++) {
+        if (signal?.aborted) {
+            throw new Error('Aborted');
+        }
+        const ch = codepoints[i];
+        await page.keyboard.type(ch, { delay: 0 });
+        if (i < codepoints.length - 1) {
+            await sleep(randomIntInclusive(minGapMs, maxGapMs), signal);
+        }
+    }
+}
+//# sourceMappingURL=human_delay.js.map

package/dist/browser/human_delay.js.map

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

package/dist/browser/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 浏览器：CDP 连接与会话（统一出口）。
+ */
+export * from './timing.js';
+export * from './human_delay.js';
+export { resumeHeight, setTempHeight, snapshotBossPageViewport, type BossViewportSnapshot, } from './viewport_temp.js';
+export { connectBrowser, createPageCDPSession, defaultViewportFromEnv, LAUNCH_ARGS_ALLOW_ALL_CORS, LAUNCH_ARGS_LESS_AUTOMATION, type ConnectBrowserOptions, wasLastChromeLaunchHeadless, } from './cdp_browser.js';
+export { detachBrowserSession, disconnectBrowserSession, ensureAndGetBrowser, ensureBrowserSession, getBrowserRef, getPageRef, setSessionPage, } from './browser_session.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,9 @@
+/**
+ * 浏览器：CDP 连接与会话（统一出口）。
+ */
+export * from './timing.js';
+export * from './human_delay.js';
+export { resumeHeight, setTempHeight, snapshotBossPageViewport, } from './viewport_temp.js';
+export { connectBrowser, createPageCDPSession, defaultViewportFromEnv, LAUNCH_ARGS_ALLOW_ALL_CORS, LAUNCH_ARGS_LESS_AUTOMATION, wasLastChromeLaunchHeadless, } from './cdp_browser.js';
+export { detachBrowserSession, disconnectBrowserSession, ensureAndGetBrowser, ensureBrowserSession, getBrowserRef, getPageRef, setSessionPage, } from './browser_session.js';
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,wBAAwB,GAEzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAE3B,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/dist/browser/timing.d.ts

@@ -0,0 +1,7 @@
+/** 固定休眠（支持 AbortSignal，与原先 auth.sleep 行为一致） */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+/** 含两端在内的随机整数（使用 crypto.randomInt） */
+export declare function randomIntInclusive(min: number, max: number): number;
+/** 在 [minMs, maxMs] 内随机等待 */
+export declare function sleepRandom(minMs: number, maxMs: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=timing.d.ts.map

package/dist/browser/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/browser/timing.ts"],"names":[],"mappings":"AAEA,+CAA+C;AAC/C,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBrE;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,6BAA6B;AAC7B,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/browser/timing.js

@@ -0,0 +1,34 @@
+import { randomInt } from 'node:crypto';
+/** 固定休眠（支持 AbortSignal，与原先 auth.sleep 行为一致） */
+export function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new Error('Aborted'));
+            return;
+        }
+        const id = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(id);
+            reject(new Error('Aborted'));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/** 含两端在内的随机整数（使用 crypto.randomInt） */
+export function randomIntInclusive(min, max) {
+    if (max < min) {
+        const t = min;
+        min = max;
+        max = t;
+    }
+    return randomInt(min, max + 1);
+}
+/** 在 [minMs, maxMs] 内随机等待 */
+export async function sleepRandom(minMs, maxMs, signal) {
+    const ms = randomIntInclusive(minMs, maxMs);
+    return sleep(ms, signal);
+}
+//# sourceMappingURL=timing.js.map

package/dist/browser/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/browser/timing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,+CAA+C;AAC/C,MAAM,UAAU,KAAK,CAAC,EAAU,EAAE,MAAoB;IACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE;YACzB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,EAAE,CAAC,CAAC;YACjB,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,GAAW;IACzD,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,GAAG,CAAC;QACd,GAAG,GAAG,GAAG,CAAC;QACV,GAAG,GAAG,CAAC,CAAC;IACV,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,KAAa,EACb,MAAoB;IAEpB,MAAM,EAAE,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC3B,CAAC"}

package/dist/browser/viewport_temp.d.ts

@@ -0,0 +1,15 @@
+import type { Page } from 'puppeteer-core';
+type ViewportState = Awaited<ReturnType<Page['viewport']>>;
+export type BossViewportSnapshot = NonNullable<ViewportState>;
+/**
+ * 供临时拉高/恢复视口使用。未设置 Puppeteer 固定视口时 `page.viewport()` 常为 `null`；
+ * 若此时仍用 {@link defaultViewportFromEnv}（如 1280×1200）恢复，会改掉用户真实窗口对应的布局视口。
+ * 在打开弹层/截图**之前**调用，用页面 `innerWidth`/`innerHeight` 作为恢复基准。
+ */
+export declare function snapshotBossPageViewport(page: Page): Promise<BossViewportSnapshot>;
+/** 截图前临时拉高视口高度；`prev` 一般为进入流程前 `await page.viewport()` 的快照。 */
+export declare function setTempHeight(page: Page, prev: ViewportState, heightPx?: number): Promise<void>;
+/** 与 {@link setTempHeight} 配对，恢复截图前的视口。 */
+export declare function resumeHeight(page: Page, prev: ViewportState): Promise<void>;
+export {};
+//# sourceMappingURL=viewport_temp.d.ts.map

package/dist/browser/viewport_temp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport_temp.d.ts","sourceRoot":"","sources":["../../src/browser/viewport_temp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAM3C,KAAK,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC3D,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;AAwC9D;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2BxF;AAED,+DAA+D;AAC/D,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,aAAa,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,2CAA2C;AAC3C,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF"}