@joohw/boss-cli 0.1.3 → 0.1.5

package/dist/toolset/send_message.js

@@ -1,4 +1,74 @@
-import { createWaitManualLoginRequiredText, isBossChatIndexUrl, sleep, withChatPage, } from '../browser/index.js';
+import { createWaitManualLoginRequiredText, isBossChatIndexUrl, randomIntInclusive, SEND_AFTER_ENTER_MS, SEND_BEFORE_RESUME_MS, SEND_INPUT_CLICK_MS, SEND_TYPING_GAP_MS, sleepRandom, typeTextWithRandomKeyDelay, withChatPage, } from '../browser/index.js';
+/**
+ * 对方「附件简历」确认卡片上点击「同意」或「拒绝」。
+ * 对应按钮 disabled 时视为已处理。
+ */
+async function runIncomingResumeCardAction(page, which) {
+    const currentUrl = page.url();
+    if (!isBossChatIndexUrl(currentUrl)) {
+        throw new Error('请先进入聊天列表页（/web/chat/index）并打开候选人聊天。');
+    }
+    const inCandidateChat = await page.$('.base-info-single-container');
+    if (!inCandidateChat) {
+        throw new Error('请先打开候选人聊天详情页，再操作附件简历卡片。');
+    }
+    await sleepRandom(200, 550);
+    const result = (await page.evaluate((w) => {
+        function norm(v) {
+            return (v ?? "").replace(/\\s+/g, " ").trim();
+        }
+        function isDisabledBtn(el) {
+            const cls = el.className ?? "";
+            if (/disabled|forbid|ban/i.test(cls))
+                return true;
+            if (el.getAttribute("disabled") !== null)
+                return true;
+            const st = window.getComputedStyle(el);
+            return st.pointerEvents === "none" || Number(st.opacity) < 0.35;
+        }
+        function matchesLabel(t, mode) {
+            if (mode === "agree") {
+                return t === "同意" || t.indexOf("同意") === 0;
+            }
+            return t === "拒绝" || t.indexOf("拒绝") === 0;
+        }
+        const items = Array.from(document.querySelectorAll(".chat-message-list .message-item"));
+        for (let i = items.length - 1; i >= 0; i--) {
+            const friend = items[i].querySelector(".item-friend");
+            if (!friend)
+                continue;
+            const title = norm(friend.querySelector(".message-card-top-title")?.textContent);
+            if (!title || title.indexOf("附件简历") === -1)
+                continue;
+            const buttons = friend.querySelectorAll(".message-card-buttons .card-btn");
+            for (let j = 0; j < buttons.length; j++) {
+                const btn = buttons[j];
+                const t = norm(btn.textContent);
+                if (!matchesLabel(t, w))
+                    continue;
+                if (isDisabledBtn(btn)) {
+                    return { kind: "already_handled", which: w };
+                }
+                btn.scrollIntoView({ block: "center", inline: "nearest" });
+                btn.click();
+                return { kind: "clicked", which: w };
+            }
+        }
+        return { kind: "not_found", which: w };
+    }, which));
+    if (result.kind === 'not_found') {
+        throw new Error('未找到待处理的「对方发送附件简历」确认卡片（标题需含「附件简历」）。');
+    }
+    if (result.kind === 'already_handled') {
+        return result.which === 'agree'
+            ? '对方发来的附件简历请求已处理（同意按钮已禁用）。'
+            : '对方发来的附件简历请求已处理（拒绝按钮已禁用）。';
+    }
+    await sleepRandom(350, 900);
+    return result.which === 'agree'
+        ? '已点击「同意」，接受对方发送的附件简历。'
+        : '已点击「拒绝」，拒绝接收对方附件简历。';
+}
 async function runRequestOfflineResume(page) {
     try {
         const currentUrl = page.url();
@@ -31,6 +101,7 @@ async function runRequestOfflineResume(page) {
         if (!availability.found || !availability.available) {
             throw new Error('当前不可索取离线简历。通常需要双方至少各发送过一条消息后，才会变为可索取状态。');
         }
+        await sleepRandom(280, 720);
         const clicked = (await page.evaluate(`(() => {
       const items = Array.from(document.querySelectorAll(".operate-icon-item"));
       const target = items.find((el) => {
@@ -47,6 +118,7 @@ async function runRequestOfflineResume(page) {
         if (!clicked) {
             throw new Error('未找到“求简历”按钮，无法执行索取。');
         }
+        await sleepRandom(400, 980);
         const confirmed = (await page.evaluate(`(() => {
       const confirms = Array.from(document.querySelectorAll(".exchange-tooltip .boss-btn-primary.boss-btn"));
       const visible = confirms.find((el) => {
@@ -70,10 +142,12 @@ async function runRequestOfflineResume(page) {
         throw new Error(`索取离线简历失败：${message}`);
     }
 }
-export async function runSendChatMessage(text, alsoRequestResume = false, signal) {
-    const messageText = text.trim();
-    if (!messageText) {
-        throw new Error('消息内容为空，未发送。');
+export async function runSendChatMessage(options) {
+    const messageText = (options.text ?? '').trim();
+    const action = options.action;
+    const signal = options.signal;
+    if (!messageText && !action) {
+        throw new Error('请指定 --text 或 --action 至少其一。');
     }
     try {
         return await withChatPage(async (page) => {
@@ -81,28 +155,53 @@ export async function runSendChatMessage(text, alsoRequestResume = false, signal
             if (!isBossChatIndexUrl(currentUrl)) {
                 throw new Error('请先进入聊天列表页（/web/chat/index）并打开候选人聊天。');
             }
-            const input = await page.$('#boss-chat-editor-input');
-            if (!input) {
-                throw new Error('未找到聊天输入框（#boss-chat-editor-input）。');
+            const lines = [];
+            if (messageText) {
+                const input = await page.$('#boss-chat-editor-input');
+                if (!input) {
+                    throw new Error('未找到聊天输入框（#boss-chat-editor-input）。');
+                }
+                await input.click({
+                    delay: randomIntInclusive(SEND_INPUT_CLICK_MS.min, SEND_INPUT_CLICK_MS.max),
+                });
+                await sleepRandom(60, 220, signal);
+                await page.keyboard.down('Control');
+                await page.keyboard.press('KeyA');
+                await page.keyboard.up('Control');
+                await sleepRandom(45, 180, signal);
+                await page.keyboard.press('Backspace');
+                await sleepRandom(80, 260, signal);
+                await typeTextWithRandomKeyDelay(page, messageText, SEND_TYPING_GAP_MS.min, SEND_TYPING_GAP_MS.max, signal);
+                await sleepRandom(120, 420, signal);
+                await page.keyboard.press('Enter');
+                await sleepRandom(SEND_AFTER_ENTER_MS.min, SEND_AFTER_ENTER_MS.max, signal);
+                lines.push(`已发送消息：${messageText}`);
             }
-            await input.click({ delay: 20 });
-            await page.keyboard.down('Control');
-            await page.keyboard.press('KeyA');
-            await page.keyboard.up('Control');
-            await page.keyboard.press('Backspace');
-            await page.keyboard.type(messageText, { delay: 15 });
-            await page.keyboard.press('Enter');
-            if (!alsoRequestResume) {
-                return `已发送消息：${messageText}`;
+            if (action) {
+                if (lines.length > 0) {
+                    await sleepRandom(SEND_BEFORE_RESUME_MS.min, SEND_BEFORE_RESUME_MS.max, signal);
+                }
+                switch (action) {
+                    case 'request-resume':
+                        lines.push(await runRequestOfflineResume(page));
+                        break;
+                    case 'agree-resume':
+                        lines.push(await runIncomingResumeCardAction(page, 'agree'));
+                        break;
+                    case 'confuse-resume':
+                        lines.push(await runIncomingResumeCardAction(page, 'refuse'));
+                        break;
+                    default: {
+                        const _x = action;
+                        throw new Error(`未知的 action: ${String(_x)}`);
+                    }
+                }
             }
-            await sleep(1_500, signal);
-            const resumeLine = await runRequestOfflineResume(page);
-            return [`已发送消息：${messageText}`, resumeLine].filter(Boolean).join('\n\n');
+            return lines.join('\n\n');
         });
     }
     catch (e) {
         const message = e instanceof Error ? e.message : String(e);
-        console.error(`[boss-cli] send_chat_message error: ${message}`);
         if (e instanceof Error) {
             if (e.message.includes('浏览器会话尚未初始化')) {
                 throw new Error(createWaitManualLoginRequiredText('发送消息'));

package/dist/toolset/send_message.js.map

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

package/dist/toolset/skill.d.ts

@@ -0,0 +1,13 @@
+/** 包内唯一 skill 目录名（与文件夹一致） */
+export declare const PACKAGE_SKILL_NAME = "boss-cli";
+/** 与 `dist/toolset/skill.js` 相对：包根目录下的 `skills/` */
+export declare function bundledSkillsRoot(): string;
+export declare function implSkillInstall(): Promise<string>;
+export declare function implSkillUninstall(): Promise<string>;
+/** `boss skill`：仅输出说明，不安装。 */
+export declare function implSkillDescribe(): string;
+/**
+ * `boss skill` 仅描述；`boss skill install` / `uninstall` 才改磁盘。
+ */
+export declare function implSkillCli(tail: string[]): Promise<string>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/toolset/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/toolset/skill.ts"],"names":[],"mappings":"AASA,6BAA6B;AAC7B,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C,oDAAoD;AACpD,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAMD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAiBxD;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAQ1D;AAED,8BAA8B;AAC9B,wBAAgB,iBAAiB,IAAI,MAAM,CAgB1C;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBlE"}

package/dist/toolset/skill.js

@@ -0,0 +1,85 @@
+/**
+ * 本 npm 包仅含一个 Agent Skill：`skills/boss-cli/` → 安装到 ~/.agents/skills/boss-cli/
+ */
+import { existsSync } from 'node:fs';
+import { cp, rm } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ensureAppDataLayout, getAgentSkillsDir } from '../config.js';
+/** 包内唯一 skill 目录名（与文件夹一致） */
+export const PACKAGE_SKILL_NAME = 'boss-cli';
+/** 与 `dist/toolset/skill.js` 相对：包根目录下的 `skills/` */
+export function bundledSkillsRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return join(here, '..', '..', 'skills');
+}
+function bundledSkillSourcePath() {
+    return join(bundledSkillsRoot(), PACKAGE_SKILL_NAME);
+}
+export async function implSkillInstall() {
+    ensureAppDataLayout();
+    const skillsRoot = getAgentSkillsDir();
+    const src = bundledSkillSourcePath();
+    if (!existsSync(join(src, 'SKILL.md'))) {
+        throw new Error(`❌ 包内缺少 ${src}/SKILL.md（本包应自带唯一 skill）`);
+    }
+    const dest = join(skillsRoot, PACKAGE_SKILL_NAME);
+    await rm(dest, { recursive: true, force: true }).catch(() => { });
+    await cp(src, dest, { recursive: true });
+    return [
+        `已安装 Agent Skill「${PACKAGE_SKILL_NAME}」`,
+        `目录: ${dest}`,
+        '',
+        '多数客户端已将 ~/.agents/skills 列为默认扫描路径；若未识别，请在该应用的 Skills 设置中指向上述目录。',
+    ].join('\n');
+}
+export async function implSkillUninstall() {
+    ensureAppDataLayout();
+    const dest = join(getAgentSkillsDir(), PACKAGE_SKILL_NAME);
+    if (!existsSync(dest)) {
+        throw new Error(`❌ 未安装「${PACKAGE_SKILL_NAME}」：${dest}`);
+    }
+    await rm(dest, { recursive: true, force: true });
+    return `已移除「${PACKAGE_SKILL_NAME}」\n${dest}`;
+}
+/** `boss skill`：仅输出说明，不安装。 */
+export function implSkillDescribe() {
+    const dest = join(getAgentSkillsDir(), PACKAGE_SKILL_NAME);
+    return [
+        'boss-cli Agent Skill（本 npm 包唯一公开 Skill）',
+        '',
+        '用途：为 Claude / Cursor 等 Agent 提供说明，指导如何配合 `boss` CLI 操作 Boss 直聘（本机 Chrome/Edge + CDP、聊天、在线简历截图、可选百度 OCR 等）。目录结构与 Anthropic Agent Skills 一致（SKILL.md）。',
+        '',
+        `安装后的目标路径: ${dest}`,
+        '',
+        '命令:',
+        '  boss skill           显示本说明（不写入磁盘）',
+        '  boss skill install   将包内 skills/boss-cli/ 复制到上述路径',
+        '  boss skill uninstall 删除该路径',
+        '',
+        '安装根目录默认 ~/.agents/skills，可用 BOSS_AGENT_SKILLS_DIR 设为绝对路径覆盖。',
+    ].join('\n');
+}
+/**
+ * `boss skill` 仅描述；`boss skill install` / `uninstall` 才改磁盘。
+ */
+export async function implSkillCli(tail) {
+    if (tail.length === 0) {
+        return implSkillDescribe();
+    }
+    const first = tail[0]?.trim().toLowerCase() ?? '';
+    if (first === 'install') {
+        if (tail.length > 1) {
+            throw new Error('❌ 本包仅提供一个 skill，用法: boss skill install（不要附加参数）');
+        }
+        return implSkillInstall();
+    }
+    if (first === 'uninstall') {
+        if (tail.length > 1) {
+            throw new Error('❌ 用法: boss skill uninstall（不要附加参数）');
+        }
+        return implSkillUninstall();
+    }
+    throw new Error('❌ 用法: boss skill  |  boss skill install  |  boss skill uninstall');
+}
+//# sourceMappingURL=skill.js.map

package/dist/toolset/skill.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joohw/boss-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Boss 直聘浏览器自动化 CLI（CDP + Puppeteer），供 Agent 运行时调用",
   "type": "module",
   "main": "dist/cli/index.js",
@@ -10,15 +10,18 @@
   },
   "files": [
     "dist",
+    "skills",
     "README.md",
     "AGENTS.md",
     "LICENSE"
   ],
   "scripts": {
     "build": "tsc",
-    "dev": "npm run build && node dist/cli/index.js"
+    "dev": "npm run build && node dist/cli/index.js",
+    "test:baidu": "node --env-file=.env scripts/test-baidu-ocr.mjs"
   },
   "dependencies": {
+    "dotenv": "^17.4.2",
     "puppeteer-core": "^24.29.1"
   },
   "devDependencies": {

package/skills/README.md

@@ -0,0 +1,11 @@
+# 公开 Agent Skill（本包唯一）
+
+本目录仅含 **`boss-cli/`** 一处，与 [Anthropic Agent Skills](https://github.com/anthropics/skills) 格式一致，随 npm 包发布。
+
+```bash
+boss skill              # 仅打印 Skill 说明（不安装）
+boss skill install      # 安装到 ~/.agents/skills/boss-cli/
+boss skill uninstall    # 移除该目录
+```
+
+可用环境变量 **`BOSS_AGENT_SKILLS_DIR`** 指定安装根目录（默认为用户目录下的 `.agents/skills`）。

package/skills/boss-cli/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: boss-cli
+description: >-
+  Automates Boss 直聘 (zhipin.com) in a real Chrome/Edge via Puppeteer and CDP:
+  login, chat list, open candidate chat, online resume screenshot, and optional
+  Baidu OCR. Use when the user mentions boss-cli, Boss 直聘 automation, 招聘
+  聊天, 候选人, 在线简历截图, or running the `boss` CLI.
+---
+
+# Boss 直聘 CLI (`boss-cli`)
+
+## What this is
+
+- **Repository**: local Node/TypeScript CLI (`boss` binary) that drives **already installed** Chrome or Edge with **puppeteer-core** (no bundled browser).
+- **Not** a hosted API: the agent runs `boss` in a terminal with network access; the user must be logged in (or use `login`).
+
+## Alignment with Anthropic “Agent Skills”
+
+Anthropic’s open repo [anthropics/skills](https://github.com/anthropics/skills) defines skills as **folders with `SKILL.md`** (YAML frontmatter + instructions). The cross-tool spec lives at [agentskills.io](https://agentskills.io). This file follows the same **frontmatter + body** pattern so it can be reused in Cursor, Claude Code plugins, or other Agent Skills hosts.
+
+## Agent Skill 安装路径
+
+- **`boss skill`** 仅输出 Skill 说明，不安装；**`boss skill install`**（无附加参数）才复制到 **`~/.agents/skills/boss-cli/`**（Windows：`%USERPROFILE%\.agents\skills\boss-cli`）。**`boss skill uninstall`** 移除该目录。根目录可用 `BOSS_AGENT_SKILLS_DIR` 覆盖。
+
+## Prerequisites
+
+- **Build**: `npm install` then `npm run build`; entry is `dist/cli/index.js` (see `package.json` `bin`).
+- **Chrome/Edge path**: set `CHROME_PATH` or `PUPPETEER_EXECUTABLE_PATH` if auto-detection fails (Windows common paths are tried).
+- **Credentials**: never commit secrets. Config goes to **`%USERPROFILE%\.boss-cli\.env`** and/or **cwd `.env`** (loaded in that order; cwd overrides). Baidu OCR needs `API_KEY` + `SECRET_KEY` when `BOSS_RESUME_OCR` is enabled.
+
+## How to run
+
+- **Interactive REPL** (default): run `node dist/cli/index.js` or `boss` **with no arguments** → `boss> ` prompt.
+- **One-shot**: `boss <subcommand> ...` (non-interactive; exits after the command).
+
+## Subcommands (normalize short names)
+
+| Intent | Example |
+|--------|---------|
+| Login | `login` |
+| List candidates | `list` |
+| Open chat with candidate | `chat <name>` |
+| Send message / resume actions | `send ...` |
+| List JD / positions | `jd` |
+
+Exact flags and `--action` values are defined in `src/cli/cliRouter.ts` and `help` output.
+
+## Automation notes for the agent
+
+1. Prefer **documented env vars** over hardcoding paths; read `src/config.ts` and `src/browser/cdp_browser.ts` for directories and viewport defaults.
+2. **Online resume + OCR**: flow lives in `src/toolset/open_chat.ts` and `src/ocr/`; failures should surface real errors (Baidu quota, missing keys, network).
+3. **Puppeteer `evaluate`**: this project prefers **string scripts** for `page.evaluate` / `waitForFunction` to avoid build artifacts like `__name is not defined` in the browser context (see `AGENTS.md`).
+4. Do not add silent fallbacks; match project rules in `AGENTS.md`.
+
+## When not to use this skill
+
+- Tasks that only need public web scraping without a logged-in Boss account.
+- Headless-only sandboxes where Chrome cannot run or CDP cannot attach (unless the user explicitly uses headless and accepts limits).