@joohw/boss-cli 0.1.1

package/README.md

@@ -0,0 +1,81 @@
+# boss-cli
+
+在终端里使用的 Boss 直聘沟通页自动化工具：**登录**、**候选人列表**、**打开会话**、**发送消息**，以及读取本地 `jd/` 岗位说明（纯 CLI，无 Agent 运行时）。
+
+---
+
+## 依赖
+
+- Node.js **≥ 20**
+- 本机 **Chrome/Chromium**（不随包下载；由 Puppeteer 连接本机浏览器）
+
+---
+
+## 安装与本地运行
+
+全局安装（推荐）：
+
+```bash
+npm install -g @joohw/boss-cli
+```
+
+安装后使用：
+
+```bash
+boss help
+```
+
+从源码：
+
+```bash
+npm install
+npm run build
+```
+
+构建产物入口为 `dist/cli/index.js`，等价于命令 `boss`（见 `package.json` 的 `bin`）。
+
+---
+
+## 命令
+
+与 `boss help` 一致：
+
+
+| 用法                                                           | 说明                                |
+| ------------------------------------------------------------ | --------------------------------- |
+| `boss`                                                       | 交互模式                              |
+| `boss help`                                                  | 打印帮助                              |
+| `boss login`                                                 | 打开登录页并等待你完成登录                     |
+| `boss list-candidates [--unread]`                           | 读取「全部」聊天列表候选人；`--unread` 仅显示未读 |
+| `boss open-chat <姓名> [--fuzzy]`                             | 打开指定联系人会话；默认精确匹配，`--fuzzy` 为包含匹配 |
+| `boss send-message --text <内容> [--also-request-resume]`      | 发送消息；可选在发送后触发「求简历」                |
+| `boss list-positions`                                        | 读取本地 `jd/` 目录下的岗位 Markdown        |
+
+
+**交互模式**
+
+- 支持单引号/双引号包裹含空格的参数。
+- 输入 `help` 查看帮助，`exit` / `quit` 退出；**Ctrl+C** 正常退出，不当作错误。
+
+---
+
+## 数据目录
+
+默认数据在 `~/.boss-cli/.cache/`（Cookie、缓存、浏览器用户数据目录等），细节见 `src/config.ts`。仓库内 **[AGENTS.md](./AGENTS.md)** 供自动化/协作参考。
+
+---
+
+## 开发脚本
+
+
+| 命令              | 作用                             |
+| --------------- | ------------------------------ |
+| `npm run build` | `tsc` 编译到 `dist/`              |
+| `npm run dev`   | 先 `build` 再执行无参 `boss`（进入交互模式） |
+
+
+---
+
+## 许可
+
+本项目以 **GNU General Public License v3.0**（**GPL-3.0**）发布，全文见仓库根目录 [LICENSE](./LICENSE)。

package/dist/browser/auth.d.ts

@@ -0,0 +1,34 @@
+import type { Page } from 'puppeteer-core';
+/** Boss 直聘首页 */
+export declare const BOSS_ZHIPIN_HOME = "https://www.zhipin.com/";
+/** 默认落地页（杭州 SEO 首页）；CLI 等未配置环境变量时使用 */
+export declare const BOSS_DEFAULT_LANDING_URL = "https://www.zhipin.com/hangzhou/?seoRefer=index";
+/** 沟通页（登录成功后的典型落地页之一） */
+export declare const BOSS_CHAT_INDEX_URL = "https://www.zhipin.com/web/chat/index";
+/** 尚未有可用的浏览器会话时的提示文本（供工具抛错复用）。 */
+export declare function createWaitManualLoginRequiredText(action: string): string;
+/** 当前 URL 是否为沟通页 `/web/chat/index`（允许带 query） */
+export declare function isBossChatIndexUrl(url: string): boolean;
+/** 未登录时常见跳转：如 `https://www.zhipin.com/web/user/?ka=bticket` */
+export declare function isWebUserLoginUrl(url: string): boolean;
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+export type ProbeLoggedInSignals = {
+    hasNickname: boolean;
+    navLoginCta: boolean;
+    hasLogoutHint: boolean;
+};
+/**
+ * 根据当前页判断是否已登录（不导航）。
+ *
+ * **已登录（true）**：检测到顶栏昵称、或「退出登录」/logout 等信号。
+ * 会短轮询等待 SPA 渲染，避免 `goto` 后立即读静态 HTML 误判。
+ *
+ * **未登录（false）**：`/web/user/` 登录流 URL、顶栏出现「我要登录」入口、且轮询结束仍无昵称/退出类信号。
+ */
+export declare function probeLoggedInFromPage(page: Page): Promise<{
+    loggedIn: boolean;
+    url: string;
+}>;
+/** 沟通页且已登录（与 {@link probeLoggedInFromPage} 一致）。 */
+export declare function probeBossChatIndexLoggedIn(page: Page): Promise<boolean>;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/browser/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,gBAAgB;AAChB,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAE1D,uCAAuC;AACvC,eAAO,MAAM,wBAAwB,oDACc,CAAC;AAEpD,yBAAyB;AACzB,eAAO,MAAM,mBAAmB,0CAA0C,CAAC;AAE3E,kCAAkC;AAClC,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWvD;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUtD;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBrE;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AA6DF;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,IAAI,GACT,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB7C;AAED,mDAAmD;AACnD,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7E"}

package/dist/browser/auth.js

@@ -0,0 +1,153 @@
+/** 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 是否为沟通页 `/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;
+    }
+}
+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 });
+    });
+}
+/**
+ * 必须在页面里执行的探测脚本（纯字符串）。
+ * `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;
+    const delayMs = 400;
+    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 sleep(delayMs);
+        }
+    }
+    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/browser/auth.js.map

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

package/dist/browser/browser_session.d.ts

@@ -0,0 +1,17 @@
+import type { Browser, Page } from 'puppeteer-core';
+/**
+ * 在 {@link ensureBrowserSession} 之后返回当前已连接的 Browser；
+ * 用于工具内单次获取句柄，避免与异步 ensure 不同步的 `getBrowser()` 竞态。
+ */
+export declare function ensureAndGetBrowser(): Promise<Browser | null>;
+export declare function ensureBrowserSession(): Promise<void>;
+export declare function getBrowserRef(): Browser | null;
+export declare function getPageRef(): Page | null;
+/**
+ * 将当前会话的主操作页设为 `page`（须属于已连接的 `browserRef`）。
+ * 供“导航/打开页面”类流程在新建或选中标签后同步，便于其它工具通过 `getPageRef` 复用。
+ */
+export declare function setSessionPage(page: Page): void;
+/** 进程退出时断开 CDP，避免残留子进程 */
+export declare function disconnectBrowserSession(): Promise<void>;
+//# sourceMappingURL=browser_session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser_session.d.ts","sourceRoot":"","sources":["../../src/browser/browser_session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAiFpD;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAGnE;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAmC1D;AAED,wBAAgB,aAAa,IAAI,OAAO,GAAG,IAAI,CAE9C;AAED,wBAAgB,UAAU,IAAI,IAAI,GAAG,IAAI,CAIxC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAS/C;AAED,0BAA0B;AAC1B,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAW9D"}

package/dist/browser/browser_session.js

@@ -0,0 +1,156 @@
+import { connectBrowser } from './cdp_browser.js';
+let browserRef = null;
+let pageRef = null;
+let connectPromise = null;
+function attachDisconnectedHandler(b) {
+    b.once('disconnected', () => {
+        if (browserRef === b) {
+            browserRef = null;
+            pageRef = null;
+            console.error('[boss-cli] 与浏览器断开连接（窗口关闭或进程退出）；下次使用工具时会自动重连。');
+        }
+    });
+}
+/**
+ * 选一个「主」标签：避免始终把 `pages()[0]` 当主页——用户常在第二个及以后的 Boss 标签上操作，
+ * 而第一个是 `about:blank` 或残留空页时，错误地读到 blank 会让登录/页面检查类操作误判。
+ */
+async function pickOrCreatePage(b) {
+    const pages = (await b.pages()).filter((p) => !p.isClosed());
+    if (pages.length === 0) {
+        return b.newPage();
+    }
+    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';
+    });
+    if (nonBlank) {
+        return nonBlank;
+    }
+    return pages[0];
+}
+function isSessionHealthy() {
+    return !!(browserRef?.connected && pageRef && !pageRef.isClosed());
+}
+async function establishSession() {
+    const prev = browserRef;
+    if (prev) {
+        try {
+            prev.removeAllListeners('disconnected');
+            await prev.close();
+        }
+        catch {
+            /* 已断开时忽略 */
+        }
+        browserRef = null;
+        pageRef = null;
+    }
+    const b = await connectBrowser();
+    browserRef = b;
+    attachDisconnectedHandler(b);
+    pageRef = await pickOrCreatePage(b);
+    console.error('[boss-cli] 已连接浏览器，当前页:', pageRef.url());
+}
+/**
+ * 在 {@link ensureBrowserSession} 之后返回当前已连接的 Browser；
+ * 用于工具内单次获取句柄，避免与异步 ensure 不同步的 `getBrowser()` 竞态。
+ */
+export async function ensureAndGetBrowser() {
+    await ensureBrowserSession();
+    return getBrowserRef();
+}
+export async function ensureBrowserSession() {
+    if (browserRef?.connected) {
+        if (pageRef && !pageRef.isClosed()) {
+            try {
+                const u = pageRef.url();
+                if (u === 'about:blank' || u === '') {
+                    const preferred = await pickOrCreatePage(browserRef);
+                    if (preferred !== pageRef && !(preferred.url() === 'about:blank')) {
+                        pageRef = preferred;
+                    }
+                }
+            }
+            catch {
+                /* ignore */
+            }
+            return;
+        }
+        pageRef = await pickOrCreatePage(browserRef);
+        return;
+    }
+    if (connectPromise) {
+        await connectPromise;
+        return;
+    }
+    connectPromise = (async () => {
+        if (isSessionHealthy())
+            return;
+        await establishSession();
+    })();
+    try {
+        await connectPromise;
+    }
+    finally {
+        connectPromise = null;
+    }
+}
+export function getBrowserRef() {
+    return browserRef?.connected ? browserRef : null;
+}
+export function getPageRef() {
+    if (!pageRef || pageRef.isClosed())
+        return null;
+    if (!browserRef?.connected)
+        return null;
+    return pageRef;
+}
+/**
+ * 将当前会话的主操作页设为 `page`（须属于已连接的 `browserRef`）。
+ * 供“导航/打开页面”类流程在新建或选中标签后同步，便于其它工具通过 `getPageRef` 复用。
+ */
+export function setSessionPage(page) {
+    if (!browserRef?.connected)
+        return;
+    try {
+        if (page.browser() !== browserRef)
+            return;
+    }
+    catch {
+        return;
+    }
+    if (page.isClosed())
+        return;
+    pageRef = page;
+}
+/** 进程退出时断开 CDP，避免残留子进程 */
+export async function disconnectBrowserSession() {
+    const b = browserRef;
+    if (!b)
+        return;
+    try {
+        b.removeAllListeners('disconnected');
+        await b.close();
+    }
+    catch {
+        /* ignore */
+    }
+    browserRef = null;
+    pageRef = null;
+}
+//# sourceMappingURL=browser_session.js.map

package/dist/browser/browser_session.js.map

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

package/dist/browser/cdp_browser.d.ts

@@ -0,0 +1,34 @@
+import { type Browser, type CDPSession, type Page } from 'puppeteer-core';
+/** 减轻「正受到自动测试软件的控制」提示与常见自动化特征（非万能，站点仍可能用其它方式检测）。手动开 Chrome 并接 CDP 时可复用。 */
+export declare const LAUNCH_ARGS_LESS_AUTOMATION: readonly ["--disable-blink-features=AutomationControlled", "--disable-infobars"];
+/** 仅用于本地调试：尽量放宽同源/CORS 限制，便于跨域 iframe/canvas 处理。 */
+export declare const LAUNCH_ARGS_ALLOW_ALL_CORS: readonly ["--disable-web-security", "--allow-running-insecure-content"];
+export type ConnectBrowserOptions = {
+    /** 用于启动本机 Chrome/Edge */
+    executablePath?: string;
+    /** 启动浏览器时复用的用户数据目录（登录态/缓存等） */
+    userDataDir?: string;
+    /** 启动浏览器时指定 profile（如 `Default` / `Profile 1`） */
+    profileDirectory?: string;
+    /** 默认 `false`（有界面）。也可用环境变量 `BOSS_BROWSER_HEADLESS=true` 开无头。 */
+    headless?: boolean;
+    /** 仅本地调试用：放宽同源/CORS 策略（高风险，默认关闭）。 */
+    allowAllCors?: boolean;
+};
+/**
+ * 启动本机浏览器（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_ALLOW_ALL_CORS` — 设为 `true` 时附加放宽同源/CORS 的启动参数（仅调试）
+ * - `BOSS_BROWSER_DISABLE_GPU` — 设为 `true` 时附加 `--disable-gpu`
+ *
+ * 若以上均未设置，会按系统尝试常见 Chrome / Edge / Chromium 安装路径。
+ * - `BOSS_BROWSER_HEADLESS` — 设为 `true` 时启用无头；默认**有界面**。
+ */
+export declare function connectBrowser(options?: ConnectBrowserOptions): Promise<Browser>;
+/** 对某一页创建原生 CDP Session（需要低层域如 `Network.*`、`Fetch.*` 时使用）。 */
+export declare function createPageCDPSession(page: Page): Promise<CDPSession>;
+//# sourceMappingURL=cdp_browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cdp_browser.d.ts","sourceRoot":"","sources":["../../src/browser/cdp_browser.ts"],"names":[],"mappings":"AAEA,OAAkB,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AA4CrF,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,kFAG9B,CAAC;AAEX,oDAAoD;AACpD,eAAO,MAAM,0BAA0B,yEAG7B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG;IAClC,yBAAyB;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,OAAO,CAAC,CAyC1F;AAED,8DAA8D;AAC9D,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAE1E"}

package/dist/browser/cdp_browser.js

@@ -0,0 +1,95 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import puppeteer from 'puppeteer-core';
+import { BROWSER_USER_DATA_DIR, ensureAppDataLayout } from '../config.js';
+/** 在未配置路径时，尝试常见安装位置（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-blink-features=AutomationControlled',
+    '--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_ALLOW_ALL_CORS` — 设为 `true` 时附加放宽同源/CORS 的启动参数（仅调试）
+ * - `BOSS_BROWSER_DISABLE_GPU` — 设为 `true` 时附加 `--disable-gpu`
+ *
+ * 若以上均未设置，会按系统尝试常见 Chrome / Edge / Chromium 安装路径。
+ * - `BOSS_BROWSER_HEADLESS` — 设为 `true` 时启用无头；默认**有界面**。
+ */
+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';
+    return puppeteer.launch({
+        executablePath,
+        userDataDir,
+        headless,
+        /** 去掉 Chrome 默认的 `--enable-automation`，可消除顶部「正受到自动测试软件的控制」提示 */
+        ignoreDefaultArgs: ['--enable-automation'],
+        defaultViewport: headless ? { width: 1280, height: 800 } : null,
+        args: [
+            ...LAUNCH_ARGS_LESS_AUTOMATION,
+            ...(disableGpu ? ['--disable-gpu'] : []),
+            ...(allowAllCors ? LAUNCH_ARGS_ALLOW_ALL_CORS : []),
+            ...(profileDirectory ? [`--profile-directory=${profileDirectory}`] : []),
+        ],
+    });
+}
+/** 对某一页创建原生 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/chat.d.ts

@@ -0,0 +1,7 @@
+import type { Page } from 'puppeteer-core';
+/**
+ * 获取 chat page 来执行回调：确保已启动浏览器并导航到 Boss 沟通列表页（/web/chat/index）。
+ * 仅负责“浏览器状态/导航”，不在这里做登录成功与否的业务判断。
+ */
+export declare function withChatPage<T>(callback: (page: Page) => Promise<T>): Promise<T>;
+//# sourceMappingURL=chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/browser/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAkCpD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA+BtF"}