@reconcrap/boss-recommend-mcp 1.2.10 → 1.3.1

package/src/test-pipeline.js

@@ -1,5 +1,5 @@
 import assert from "node:assert/strict";
-import { runRecommendPipeline } from "./pipeline.js";
+import { runRecommendPipeline as runRecommendPipelineImpl } from "./pipeline.js";
 
 const DEFAULT_JOB_OPTIONS = [
   {
@@ -85,6 +85,40 @@ function createParsed(overrides = {}) {
   };
 }
 
+function createBasePipelineDeps(overrides = {}) {
+  return {
+    readRecommendTabState: async () => ({
+      ok: true,
+      active_status: "0",
+      active_tab_status: "0"
+    }),
+    switchRecommendTab: async () => ({
+      ok: true,
+      state: "TAB_READY",
+      after_state: {
+        active_status: "0",
+        active_tab_status: "0"
+      }
+    }),
+    ...overrides
+  };
+}
+
+async function runRecommendPipeline(args, dependencies = {}, runtime = null) {
+  return runRecommendPipelineImpl(args, createBasePipelineDeps(dependencies), runtime);
+}
+
+function createFollowUpChat(overrides = {}) {
+  return {
+    chat: {
+      criteria: "有 AI Agent 经验",
+      start_from: "unread",
+      target_count: 5,
+      ...overrides
+    }
+  };
+}
+
 async function testPauseRequestedBeforeScreenShouldReturnPaused() {
   let screenCalled = false;
   const result = await runRecommendPipeline(
@@ -1178,6 +1212,62 @@ async function testLatestPipelineShouldRunSearchThenSwitchTabThenScreen() {
   assert.equal(result.result.resume_source, "image_fallback");
 }
 
+async function testPipelineShouldPassInputSummaryToScreenCli() {
+  let capturedInputSummary = null;
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "帮我找有 AI/LLM 项目经验的人",
+      confirmation: createJobConfirmedConfirmation(),
+      overrides: {}
+    },
+    {
+      parseRecommendInstruction: () => createParsed(),
+      runPipelinePreflight: () => ({ ok: true, checks: [], debug_port: 9222 }),
+      ensureBossRecommendPageReady: async () => ({ ok: true, state: "RECOMMEND_READY", page_state: { state: "RECOMMEND_READY" } }),
+      listRecommendJobs: async () => createJobListResult(),
+      runRecommendSearchCli: async () => ({
+        ok: true,
+        summary: {
+          candidate_count: 3,
+          applied_filters: {
+            school_tag: ["985"],
+            degree: ["本科"],
+            gender: "男",
+            recent_not_view: "近14天没有"
+          }
+        }
+      }),
+      runRecommendScreenCli: async ({ inputSummary }) => {
+        capturedInputSummary = inputSummary;
+        return {
+          ok: true,
+          summary: {
+            processed_count: 3,
+            passed_count: 1,
+            skipped_count: 2,
+            output_csv: "C:/temp/result.csv",
+            active_tab_status: "0",
+            resume_source: "network"
+          }
+        };
+      }
+    }
+  );
+
+  assert.equal(result.status, "COMPLETED");
+  assert.equal(Boolean(capturedInputSummary), true);
+  assert.equal(capturedInputSummary.instruction, "帮我找有 AI/LLM 项目经验的人");
+  assert.equal(capturedInputSummary.selected_page, "recommend");
+  assert.equal(capturedInputSummary.selected_job?.title, "数据分析实习生 _ 杭州");
+  assert.equal(capturedInputSummary.user_search_params?.recent_not_view, "近14天没有");
+  assert.equal(capturedInputSummary.effective_search_params?.recent_not_view, "近14天没有");
+  assert.equal(capturedInputSummary.screen_params?.criteria, "候选人需要有大模型平台经验");
+  assert.equal(Object.prototype.hasOwnProperty.call(capturedInputSummary, "baseUrl"), false);
+  assert.equal(Object.prototype.hasOwnProperty.call(capturedInputSummary, "apiKey"), false);
+  assert.equal(Object.prototype.hasOwnProperty.call(capturedInputSummary, "model"), false);
+}
+
 async function testFeaturedMissingCalibrationShouldAutoCalibrateThenContinue() {
   const calls = [];
   let preflightCallCount = 0;
@@ -1687,6 +1777,8 @@ async function testNeedJobConfirmationGate() {
       runPipelinePreflight: () => ({ ok: true, checks: [], debug_port: 9222 }),
       ensureBossRecommendPageReady: async () => ({ ok: true, state: "RECOMMEND_READY", page_state: {} }),
       listRecommendJobs: async () => createJobListResult(),
+      readRecommendTabState: async () => ({ ok: true, active_tab_status: "0" }),
+      switchRecommendTab: async () => ({ ok: true, state: "TAB_READY" }),
       runRecommendSearchCli: async () => ({ ok: true, summary: {} }),
       runRecommendScreenCli: async () => ({ ok: true, summary: {} })
     }
@@ -2038,6 +2130,312 @@ async function testScreenConfigRecoveryStepShouldBeFirst() {
   assert.equal(result.diagnostics.recovery.ordered_steps[0].id, "fill_screening_config");
 }
 
+async function testFollowUpChatMissingCriteriaShouldNeedInput() {
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: {},
+      overrides: {},
+      followUp: createFollowUpChat({ criteria: "" })
+    },
+    {
+      parseRecommendInstruction: () => createParsed()
+    }
+  );
+
+  assert.equal(result.status, "NEED_INPUT");
+  assert.equal(result.missing_fields.includes("follow_up.chat.criteria"), true);
+  assert.equal(result.pending_questions.some((item) => item.field === "follow_up.chat.criteria"), true);
+}
+
+async function testFollowUpChatMissingFieldsShouldExposeRecommendDefaults() {
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: {},
+      overrides: {},
+      followUp: createFollowUpChat({
+        criteria: "",
+        start_from: "",
+        target_count: null
+      })
+    },
+    {
+      parseRecommendInstruction: () => createParsed({
+        screenParams: {
+          criteria: "默认沿用 recommend 的筛选条件",
+          target_count: 18,
+          post_action: "favorite",
+          max_greet_count: null
+        }
+      })
+    }
+  );
+
+  assert.equal(result.status, "NEED_INPUT");
+  assert.equal(result.missing_fields.includes("follow_up.chat.criteria"), true);
+  assert.equal(result.missing_fields.includes("follow_up.chat.start_from"), true);
+  assert.equal(result.missing_fields.includes("follow_up.chat.target_count"), true);
+  const criteriaQuestion = result.pending_questions.find((item) => item.field === "follow_up.chat.criteria");
+  const startFromQuestion = result.pending_questions.find((item) => item.field === "follow_up.chat.start_from");
+  const targetCountQuestion = result.pending_questions.find((item) => item.field === "follow_up.chat.target_count");
+  assert.equal(criteriaQuestion?.value, "默认沿用 recommend 的筛选条件");
+  assert.equal(startFromQuestion?.value, "unread");
+  assert.equal(targetCountQuestion?.value, 18);
+}
+
+async function testFollowUpChatMissingStartFromShouldNeedInput() {
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: {},
+      overrides: {},
+      followUp: createFollowUpChat({ start_from: "" })
+    },
+    {
+      parseRecommendInstruction: () => createParsed()
+    }
+  );
+
+  assert.equal(result.status, "NEED_INPUT");
+  assert.equal(result.missing_fields.includes("follow_up.chat.start_from"), true);
+  assert.equal(result.pending_questions.some((item) => item.field === "follow_up.chat.start_from"), true);
+}
+
+async function testFollowUpChatMissingTargetCountShouldNeedInput() {
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: {},
+      overrides: {},
+      followUp: createFollowUpChat({ target_count: null })
+    },
+    {
+      parseRecommendInstruction: () => createParsed()
+    }
+  );
+
+  assert.equal(result.status, "NEED_INPUT");
+  assert.equal(result.missing_fields.includes("follow_up.chat.target_count"), true);
+  assert.equal(result.pending_questions.some((item) => item.field === "follow_up.chat.target_count"), true);
+}
+
+async function testFinalReviewShouldIncludeFollowUpChatSummary() {
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: createJobConfirmedWithoutFinalConfirmation(),
+      overrides: {},
+      followUp: createFollowUpChat()
+    },
+    {
+      parseRecommendInstruction: () => createParsed(),
+      runPipelinePreflight: () => ({ ok: true, checks: [], debug_port: 9222 }),
+      ensureBossRecommendPageReady: async () => ({ ok: true, state: "RECOMMEND_READY", page_state: {} }),
+      listRecommendJobs: async () => createJobListResult(),
+      runRecommendSearchCli: async () => ({ ok: true, summary: {} }),
+      runRecommendScreenCli: async () => ({ ok: true, summary: {} })
+    }
+  );
+
+  assert.equal(result.status, "NEED_CONFIRMATION");
+  assert.equal(result.follow_up?.chat?.criteria, "有 AI Agent 经验");
+  const finalReview = result.pending_questions.find((item) => item.field === "final_review");
+  assert.equal(finalReview?.value?.follow_up?.chat?.start_from, "unread");
+  assert.equal(finalReview?.value?.follow_up?.chat?.target_count, 5);
+}
+
+async function testCompletedPipelineShouldRunChatFollowUp() {
+  let getChatRunCalls = 0;
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: createJobConfirmedConfirmation(),
+      overrides: {},
+      followUp: createFollowUpChat()
+    },
+    {
+      parseRecommendInstruction: () => createParsed(),
+      runPipelinePreflight: () => ({ ok: true, checks: [], debug_port: 9555 }),
+      ensureBossRecommendPageReady: async () => ({ ok: true, state: "RECOMMEND_READY", page_state: {} }),
+      listRecommendJobs: async () => createJobListResult(),
+      readRecommendTabState: async () => ({ ok: true, active_tab_status: "0" }),
+      switchRecommendTab: async () => ({ ok: true, state: "TAB_READY" }),
+      runRecommendSearchCli: async () => ({
+        ok: true,
+        summary: {
+          candidate_count: 8,
+          applied_filters: { degree: ["本科"] },
+          selected_job: DEFAULT_JOB_OPTIONS[0]
+        }
+      }),
+      runRecommendScreenCli: async () => ({
+        ok: true,
+        summary: {
+          processed_count: 6,
+          passed_count: 2,
+          skipped_count: 4,
+          output_csv: "C:/temp/recommend.csv",
+          completion_reason: "screen_completed"
+        }
+      }),
+      startBossChatRun: async ({ input }) => {
+        assert.equal(input.job, DEFAULT_JOB_OPTIONS[0].title);
+        assert.equal(input.port, 9555);
+        return {
+          status: "ACCEPTED",
+          run_id: "chat-run-1",
+          message: "chat started"
+        };
+      },
+      getBossChatRun: async () => {
+        getChatRunCalls += 1;
+        if (getChatRunCalls === 1) {
+          return {
+            status: "RUN_STATUS",
+            run: {
+              runId: "chat-run-1",
+              state: "running",
+              lastMessage: "chat running",
+              progress: {
+                inspected: 1,
+                passed: 0,
+                requested: 0,
+                skipped: 1,
+                errors: 0
+              }
+            }
+          };
+        }
+        return {
+          status: "RUN_STATUS",
+          run: {
+            runId: "chat-run-1",
+            state: "completed",
+            lastMessage: "chat completed",
+            progress: {
+              inspected: 3,
+              passed: 1,
+              requested: 1,
+              skipped: 2,
+              errors: 0
+            },
+            result: {
+              requested_count: 1
+            }
+          }
+        };
+      }
+    }
+  );
+
+  assert.equal(result.status, "COMPLETED");
+  assert.equal(result.result.output_csv, "C:/temp/recommend.csv");
+  assert.equal(result.follow_up?.chat?.run_id, "chat-run-1");
+  assert.equal(result.follow_up?.chat?.state, "completed");
+  assert.equal(result.follow_up?.chat?.input?.port, 9555);
+}
+
+async function testCompletedPipelineShouldFailWhenChatLaunchFails() {
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: createJobConfirmedConfirmation(),
+      overrides: {},
+      followUp: createFollowUpChat()
+    },
+    {
+      parseRecommendInstruction: () => createParsed(),
+      runPipelinePreflight: () => ({ ok: true, checks: [], debug_port: 9222 }),
+      ensureBossRecommendPageReady: async () => ({ ok: true, state: "RECOMMEND_READY", page_state: {} }),
+      listRecommendJobs: async () => createJobListResult(),
+      readRecommendTabState: async () => ({ ok: true, active_tab_status: "0" }),
+      switchRecommendTab: async () => ({ ok: true, state: "TAB_READY" }),
+      runRecommendSearchCli: async () => ({ ok: true, summary: { candidate_count: 1, applied_filters: {} } }),
+      runRecommendScreenCli: async () => ({
+        ok: true,
+        summary: {
+          processed_count: 1,
+          passed_count: 1,
+          skipped_count: 0,
+          output_csv: "C:/temp/recommend.csv",
+          completion_reason: "screen_completed"
+        }
+      }),
+      startBossChatRun: async () => ({
+        status: "FAILED",
+        error: {
+          code: "CHAT_START_FAILED",
+          message: "cannot start chat"
+        }
+      })
+    }
+  );
+
+  assert.equal(result.status, "FAILED");
+  assert.equal(result.error.code, "CHAT_START_FAILED");
+  assert.equal(result.follow_up?.chat?.launch_result?.status, "FAILED");
+}
+
+async function testCompletedPipelineShouldFailWhenChatRunFails() {
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: createJobConfirmedConfirmation(),
+      overrides: {},
+      followUp: createFollowUpChat()
+    },
+    {
+      parseRecommendInstruction: () => createParsed(),
+      runPipelinePreflight: () => ({ ok: true, checks: [], debug_port: 9222 }),
+      ensureBossRecommendPageReady: async () => ({ ok: true, state: "RECOMMEND_READY", page_state: {} }),
+      listRecommendJobs: async () => createJobListResult(),
+      readRecommendTabState: async () => ({ ok: true, active_tab_status: "0" }),
+      switchRecommendTab: async () => ({ ok: true, state: "TAB_READY" }),
+      runRecommendSearchCli: async () => ({ ok: true, summary: { candidate_count: 1, applied_filters: {} } }),
+      runRecommendScreenCli: async () => ({
+        ok: true,
+        summary: {
+          processed_count: 1,
+          passed_count: 1,
+          skipped_count: 0,
+          output_csv: "C:/temp/recommend.csv",
+          completion_reason: "screen_completed"
+        }
+      }),
+      startBossChatRun: async () => ({
+        status: "ACCEPTED",
+        run_id: "chat-run-2",
+        message: "chat started"
+      }),
+      getBossChatRun: async () => ({
+        status: "RUN_STATUS",
+        run: {
+          runId: "chat-run-2",
+          state: "failed",
+          lastMessage: "chat failed",
+          error: {
+            code: "CHAT_RUNTIME_FAILED",
+            message: "chat runtime failed"
+          }
+        }
+      })
+    }
+  );
+
+  assert.equal(result.status, "FAILED");
+  assert.equal(result.error.code, "CHAT_RUNTIME_FAILED");
+  assert.equal(result.follow_up?.chat?.state, "failed");
+}
+
 async function main() {
   await testPauseRequestedBeforeScreenShouldReturnPaused();
   await testPausedScreenResultShouldBubbleUp();
@@ -2057,6 +2455,7 @@ async function main() {
   await testNeedInputGate();
   await testFeaturedPipelineShouldRunSearchThenSwitchTabThenScreen();
   await testLatestPipelineShouldRunSearchThenSwitchTabThenScreen();
+  await testPipelineShouldPassInputSummaryToScreenCli();
   await testFeaturedMissingCalibrationShouldAutoCalibrateThenContinue();
   await testFeaturedCalibrationFailureShouldReturnCalibrationRequired();
   await testFeaturedTabSwitchFailureShouldReturnRetryableError();
@@ -2076,6 +2475,14 @@ async function main() {
   await testScreenConfigFailureShouldRequireUserProvidedConfig();
   await testScreenConfigPlaceholderShouldRequireUserConfirmationAfterUpdate();
   await testScreenConfigRecoveryStepShouldBeFirst();
+  await testFollowUpChatMissingCriteriaShouldNeedInput();
+  await testFollowUpChatMissingFieldsShouldExposeRecommendDefaults();
+  await testFollowUpChatMissingStartFromShouldNeedInput();
+  await testFollowUpChatMissingTargetCountShouldNeedInput();
+  await testFinalReviewShouldIncludeFollowUpChatSummary();
+  await testCompletedPipelineShouldRunChatFollowUp();
+  await testCompletedPipelineShouldFailWhenChatLaunchFails();
+  await testCompletedPipelineShouldFailWhenChatRunFails();
   console.log("pipeline tests passed");
 }
 

package/vendor/boss-chat-cli/README.md

@@ -0,0 +1,134 @@
+# boss-chat
+
+基于 Chrome DevTools Protocol 和 OpenAI 兼容 LLM 的 Boss 直聘聊天页教育筛选与自动沟通 CLI。
+
+## 功能
+
+- 连接已登录、已打开聊天页的 Chrome
+- 遍历聊天列表客户卡片，读取教育信息
+- 用自定义 `baseUrl + apiKey + model` 调用大模型判断是否符合教育要求
+- 命中时自动生成简短话术并写入聊天框，随后发送
+- 默认记录已处理客户，避免重复触达
+- 支持选择从`未读`或`全部`列表开始处理
+- 支持 `--dry-run` 先验证页面稳定性和命中效果
+
+## 依赖
+
+- Node.js（建议 18+）
+- Google Chrome（需开启远程调试端口）
+- npm 包依赖：
+  - `chrome-remote-interface@^0.33.3`
+
+## 使用前准备
+
+1. 用远程调试模式启动 Chrome：
+
+```powershell
+chrome.exe --remote-debugging-port=9222
+```
+
+2. 登录 Boss 直聘并打开聊天页：
+
+```text
+https://www.zhipin.com/web/chat/index
+```
+
+3. 全局安装：
+
+```powershell
+npm install -g @reconcrap/boss-chat-cli
+```
+
+也可以直接用 `npx`（适合 agent 平台托管 MCP 时）：
+
+```powershell
+npx -y -p @reconcrap/boss-chat-cli@latest boss-chat-mcp
+```
+
+## 运行
+
+首次运行会交互式询问教育要求、话术样例、LLM 参数等配置；每次运行也可选择从`未读`或`全部`开始：
+
+```powershell
+boss-chat run
+```
+
+建议先用 dry-run：
+
+```powershell
+boss-chat run --dry-run --targetCount 3
+```
+
+## MCP Agent 集成（openclaw / codex / trae-cn）
+
+包内已内置 MCP stdio server，可直接被三类平台调用：
+
+- `openclaw-boss-chat-mcp`
+- `codex-boss-chat-mcp`
+- `trae-cn-boss-chat-mcp`
+- 通用入口：`boss-chat-mcp`
+
+### 工具列表
+
+- `health_check`: 检查服务是否可用
+- `start_run`: 启动异步任务，返回 `run_id`
+- `get_run`: 查询任务状态
+- `pause_run`: 暂停任务
+- `resume_run`: 继续任务
+- `cancel_run`: 取消任务
+
+### 平台配置示例
+
+项目里提供了三份可直接复制的模板：
+
+- `configs/mcp/openclaw.json`
+- `configs/mcp/codex.json`
+- `configs/mcp/trae-cn.json`
+
+三份配置都通过 `npx` 拉取最新包并启动对应 MCP 入口，例如：
+
+```json
+{
+  "mcpServers": {
+    "boss-chat": {
+      "command": "npx",
+      "args": ["-y", "-p", "@reconcrap/boss-chat-cli@latest", "boss-chat-mcp"]
+    }
+  }
+}
+```
+
+> 不同平台的 MCP 配置文件路径可能不同，但 `command + args` 可直接复用。
+
+## 运行中控制
+
+程序运行时可以直接用键盘控制：
+
+- `p`: 暂停；再次按 `p` 或按 `r` 继续
+- `r`: 继续运行
+- `q`: 请求停止，当前步骤结束后安全退出
+- `Ctrl+C`: 请求停止，当前步骤结束后安全退出
+
+停止后仍会写入本次运行报告，已记录的客户状态也会保留。
+
+## 常用参数
+
+- `--profile <name>`: 使用指定 profile
+- `--dry-run`: 只检查和生成文案，不实际发送
+- `--no-state`: 不记录已处理客户
+- `--targetCount <n>`: 覆盖本次检查人数
+- `--educationRequirement <text>`: 覆盖教育要求
+- `--messageSample <text>`: 覆盖话术样例
+- `--start-from <unread|all>`: 本次从未读或全部列表开始
+- `--baseurl <url>`: 覆盖 LLM base URL
+- `--apikey <key>`: 覆盖 LLM API key
+- `--model <name>`: 覆盖 LLM 模型
+- `--port <n>`: 覆盖 Chrome 远程调试端口
+
+## 数据目录
+
+运行产生的数据默认保存在项目下的 `.boss-chat/`：
+
+- `profiles/`: 保存 profile 配置
+- `state/`: 保存已处理客户状态
+- `reports/`: 保存每次运行的 JSON 报告

package/vendor/boss-chat-cli/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@reconcrap/boss-chat-cli",
+  "version": "1.1.0",
+  "description": "Boss chat education screening and outreach CLI with MCP agent bridge",
+  "type": "module",
+  "bin": {
+    "boss-chat": "src/cli.js",
+    "boss-chat-mcp": "src/mcp/server.js",
+    "openclaw-boss-chat-mcp": "src/mcp/server.js",
+    "codex-boss-chat-mcp": "src/mcp/server.js",
+    "trae-cn-boss-chat-mcp": "src/mcp/server.js"
+  },
+  "main": "./src/cli.js",
+  "files": [
+    "src/",
+    "configs/",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node ./src/cli.js run",
+    "start:mcp": "node ./src/mcp/server.js",
+    "test": "node --test"
+  },
+  "keywords": [
+    "boss",
+    "zhipin",
+    "chrome-devtools",
+    "cli",
+    "automation",
+    "mcp",
+    "openclaw",
+    "codex",
+    "trae-cn"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.1",
+    "chrome-remote-interface": "^0.33.3",
+    "sharp": "^0.34.5",
+    "zod": "^4.1.12"
+  }
+}