@reconcrap/boss-recruit-mcp 1.0.14 → 1.0.16

package/README.md

@@ -25,10 +25,12 @@ npx @reconcrap/boss-recruit-mcp install
 - 安装 Codex skill 到 `$CODEX_HOME/skills/boss-recruit-pipeline`
 - 初始化用户配置到 `$CODEX_HOME/boss-recruit-mcp/screening-config.json`
 - 生成通用 MCP 配置模板到 `$CODEX_HOME/boss-recruit-mcp/agent-mcp-configs`
+- 自动尝试写入已检测到的外部 agent MCP 配置（含 Trae / trae-cn / Cursor / Claude / OpenClaw）
+- 自动尝试把 skill 镜像到已检测到的外部 agent skills 目录
 - 包内自带 `boss-search-cli` 与 `boss-screen-cli` 运行时文件，无需额外目录结构
 - 不包含 `favorite-calibration.json`，首次使用前需要自行校准生成
 
-## 跨 Agent 快速接入（Cursor / Trae / Claude Code / OpenClaw）
+## 跨 Agent 快速接入（Cursor / Trae / trae-cn / Claude Code / OpenClaw）
 
 生成 MCP 配置模板：
 
@@ -58,6 +60,7 @@ $CODEX_HOME/boss-recruit-mcp/agent-mcp-configs
 boss-recruit-mcp mcp-config --client cursor
 boss-recruit-mcp mcp-config --client claudecode
 boss-recruit-mcp mcp-config --client trae
+boss-recruit-mcp mcp-config --client trae-cn
 boss-recruit-mcp mcp-config --client openclaw
 boss-recruit-mcp mcp-config --client generic
 ```
@@ -73,6 +76,13 @@ boss-recruit-mcp mcp-config --client generic
 boss-recruit-mcp mcp-config --client generic --command boss-recruit-mcp --args-json "[\"start\"]"
 ```
 
+可选环境变量（用于跨 agent 自动配置）：
+
+```bash
+BOSS_RECRUIT_MCP_CONFIG_TARGETS   # JSON 数组或系统 path 分隔路径列表，指定额外 mcp.json 目标文件
+BOSS_RECRUIT_EXTERNAL_SKILL_DIRS  # JSON 数组或系统 path 分隔路径列表，指定额外 skills 根目录
+```
+
 ## 准备配置
 
 1. 初始化后编辑用户配置文件：
@@ -218,11 +228,14 @@ boss-recruit-mcp doctor --port <port>
 - 正式执行前应先单独做一轮参数确认，把已识别参数、待确认项、缺失项、默认值风险分开给用户确认
 - 若用户没提“是否过滤近14天查看”，会在 `pending_questions` 里返回该问题，调用方应先补问再继续
 - 用户未补齐缺失参数时，只有在明确同意默认值及其质量风险后，才允许继续
-- `target_count` 表示“目标处理人数”，不是“目标通过人数”；状态一旦是 `COMPLETED`，就表示本轮已完成，不应因通过人数不足而自动重跑
-- 确认后自动执行：搜索 CLI -> 点击搜索 -> 勾选“过滤近14天查看”（如启用） -> 筛选 CLI
+- `target_count` 表示“目标处理人数”，不是“目标通过人数”；会按“累计处理人数”自动多轮执行，直到达到目标处理人数，或新一轮搜索返回 0 个可筛选人选
+- 若搜索页出现 `i.tip-nodata`（即使仍能看到候选人卡片），也会判定候选池已耗尽并结束多轮流程
+- 第 2 轮及后续轮次会强制 `filter_recent_viewed=true`（即过滤近 14 天查看过的人选），不受首轮开关影响
+- 确认后自动执行：搜索 CLI -> 点击搜索 -> 勾选“过滤近14天查看”（按轮次规则） -> 筛选 CLI
 - 返回摘要：目标数、已处理、通过数、耗时、输出 CSV
 - 执行前会先做本地依赖预检查，若目录 / 入口 / 配置文件缺失则返回 `PIPELINE_PREFLIGHT_FAILED`
 - 若缺少 `favorite-calibration.json`，会返回 `CALIBRATION_REQUIRED`
+- 若某轮搜索返回可筛选候选人但筛选 `processed_count` 非法或为 0，会先导出当前累计 CSV，再返回 `SCREEN_NO_PROGRESS`
 - 若当前运行环境不允许启动子进程，会返回更明确的权限错误码而不是笼统失败
 - 配置文件查找顺序：`BOSS_RECRUIT_SCREEN_CONFIG` > 工作区 `boss-recruit-mcp/config/screening-config.json` > 用户目录 `$CODEX_HOME/boss-recruit-mcp/screening-config.json` > 包内示例配置
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recruit-mcp",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Unified MCP pipeline for boss-search-cli and boss-screen-cli",
   "keywords": [
     "boss",
@@ -20,6 +20,8 @@
     "install:local": "node src/cli.js install",
     "postinstall": "node scripts/postinstall.cjs",
     "test:parser": "node src/test-parser.js",
+    "test:pipeline": "node src/test-pipeline.js",
+    "test:protocol:win": "powershell -ExecutionPolicy Bypass -File scripts/verify-multi-round-protocol.ps1 -Mode unit",
     "test:regression:win": "powershell -ExecutionPolicy Bypass -File scripts/regression.ps1 -Mode quick"
   },
   "files": [

package/src/adapters.js

@@ -3,6 +3,7 @@ import os from "node:os";
 import path from "node:path";
 import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
+import CDP from "chrome-remote-interface";
 const currentFilePath = fileURLToPath(import.meta.url);
 const packagedMcpDir = path.resolve(path.dirname(currentFilePath), "..");
 const bossSearchUrl = "https://www.zhipin.com/web/chat/search";
@@ -161,6 +162,82 @@ function parseSearchCount(output) {
   return Number.parseInt(m[1], 10);
 }
 
+async function detectSearchNoDataTip(debugPort) {
+  let client = null;
+  try {
+    const targets = await CDP.List({ port: debugPort });
+    const target = targets.find(
+      (item) => typeof item?.url === "string" && item.url.includes("/web/chat/search")
+    ) || targets.find((item) => item?.type === "page");
+    if (!target) {
+      return {
+        ok: false,
+        exhausted: null,
+        error: "No page target found on Chrome DevTools"
+      };
+    }
+
+    client = await CDP({
+      port: debugPort,
+      target
+    });
+    const { Runtime } = client;
+    await Runtime.enable();
+
+    const expression = `(function () {
+      try {
+        var rootDoc = document;
+        var iframe = document.querySelector("iframe");
+        if (iframe && iframe.contentWindow && iframe.contentWindow.document) {
+          rootDoc = iframe.contentWindow.document;
+        }
+        var tip = rootDoc.querySelector("i.tip-nodata");
+        return {
+          exhausted: Boolean(tip),
+          selector: "i.tip-nodata"
+        };
+      } catch (err) {
+        return {
+          exhausted: false,
+          selector: "i.tip-nodata",
+          error: String(err && err.message ? err.message : err)
+        };
+      }
+    })()`;
+    const evaluated = await Runtime.evaluate({
+      expression,
+      returnByValue: true,
+      awaitPromise: true
+    });
+    if (evaluated.exceptionDetails) {
+      return {
+        ok: false,
+        exhausted: null,
+        error: evaluated.exceptionDetails.exception?.description || "Runtime.evaluate failed"
+      };
+    }
+
+    const value = evaluated.result?.value || {};
+    return {
+      ok: true,
+      exhausted: value.exhausted === true,
+      details: value
+    };
+  } catch (error) {
+    return {
+      ok: false,
+      exhausted: null,
+      error: error.message
+    };
+  } finally {
+    if (client) {
+      try {
+        await client.close();
+      } catch {}
+    }
+  }
+}
+
 function parseScreenSummary(output) {
   const processed = output.match(/已处理:\s*(\d+)\s*人/);
   const passed = output.match(/通过筛选:\s*(\d+)\s*人/);
@@ -569,11 +646,18 @@ export async function runSearchCli({ workspaceRoot, searchParams }) {
 
   const combined = `${result.stdout}\n${result.stderr}`;
   const candidateCount = parseSearchCount(combined);
+  const tipCheck = result.code === 0
+    ? await detectSearchNoDataTip(debugPort)
+    : { ok: false, exhausted: null, error: null };
 
   return {
     ok: result.code === 0,
     exit_code: result.code,
     candidate_count: candidateCount,
+    no_data_tip_present: tipCheck.ok ? tipCheck.exhausted : null,
+    no_data_tip_check: tipCheck.ok
+      ? { ok: true, details: tipCheck.details || null }
+      : { ok: false, error: tipCheck.error || null },
     stdout: result.stdout,
     stderr: result.stderr,
     error_code: result.error_code || null

package/src/cli.js

@@ -28,14 +28,16 @@ const SUPPORTED_MCP_CLIENTS = ["generic", "cursor", "trae", "claudecode", "openc
 const DEFAULT_MCP_SERVER_NAME = "boss-recruit";
 const DEFAULT_MCP_COMMAND = "npx";
 const DEFAULT_MCP_ARGS = ["-y", "@reconcrap/boss-recruit-mcp@latest", "start"];
-const AUTO_SYNC_SKIP_COMMANDS = new Set([
-  "install",
-  "install-skill",
-  "where",
-  "help",
-  "--help",
-  "-h"
-]);
+const AUTO_SYNC_SKIP_COMMANDS = new Set([
+  "install",
+  "install-skill",
+  "where",
+  "help",
+  "--help",
+  "-h"
+]);
+const EXTERNAL_MCP_TARGETS_ENV = "BOSS_RECRUIT_MCP_CONFIG_TARGETS";
+const EXTERNAL_SKILL_DIRS_ENV = "BOSS_RECRUIT_EXTERNAL_SKILL_DIRS";
 
 function getPackageVersion() {
   try {
@@ -58,13 +60,46 @@ function getCodexHome() {
     : path.join(os.homedir(), ".codex");
 }
 
-function ensureDir(targetPath) {
-  fs.mkdirSync(targetPath, { recursive: true });
-}
-
-function getDesktopDir() {
-  return path.join(os.homedir(), "Desktop");
-}
+function ensureDir(targetPath) {
+  fs.mkdirSync(targetPath, { recursive: true });
+}
+
+function pathExists(targetPath) {
+  try {
+    return fs.existsSync(targetPath);
+  } catch {
+    return false;
+  }
+}
+
+function readJsonObjectFileSafe(filePath) {
+  if (!pathExists(filePath)) return {};
+  try {
+    const parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+  } catch {
+    // Fallback below.
+  }
+  return {};
+}
+
+function dedupePaths(items) {
+  const result = [];
+  const seen = new Set();
+  for (const item of items || []) {
+    const resolved = path.resolve(String(item || ""));
+    if (!resolved || seen.has(resolved)) continue;
+    seen.add(resolved);
+    result.push(resolved);
+  }
+  return result;
+}
+
+function getDesktopDir() {
+  return path.join(os.homedir(), "Desktop");
+}
 
 function getUserConfigPath() {
   return path.join(getCodexHome(), "boss-recruit-mcp", "screening-config.json");
@@ -146,12 +181,13 @@ function parseStringArrayOption(value, label) {
   return parsed;
 }
 
-function normalizeMcpClientName(value) {
-  const raw = String(value || "").trim().toLowerCase();
-  if (!raw) return "";
-  if (raw === "claude-code") return "claudecode";
-  return raw;
-}
+function normalizeMcpClientName(value) {
+  const raw = String(value || "").trim().toLowerCase();
+  if (!raw) return "";
+  if (raw === "claude-code") return "claudecode";
+  if (raw === "trae-cn") return "trae";
+  return raw;
+}
 
 function parseMcpClientTargets(rawValue) {
   if (!rawValue) return SUPPORTED_MCP_CLIENTS.slice();
@@ -214,7 +250,7 @@ function buildMcpConfigFileContent(options = {}) {
   };
 }
 
-function writeMcpConfigFiles(options = {}) {
+function writeMcpConfigFiles(options = {}) {
   const clients = parseMcpClientTargets(options.client);
   const outputDir = getAgentConfigOutputDir(options);
   ensureDir(outputDir);
@@ -227,8 +263,142 @@ function writeMcpConfigFiles(options = {}) {
     files.push({ client, file: filePath });
   }
 
-  return { outputDir, files };
-}
+  return { outputDir, files };
+}
+
+function parsePathListFromEnv(raw) {
+  if (!raw) return [];
+  const text = String(raw).trim();
+  if (!text) return [];
+  try {
+    const parsed = JSON.parse(text);
+    if (Array.isArray(parsed)) {
+      return dedupePaths(parsed.filter(Boolean));
+    }
+  } catch {
+    // Fallback to delimiter split.
+  }
+  return dedupePaths(
+    text
+      .split(path.delimiter)
+      .map((item) => item.trim())
+      .filter(Boolean)
+  );
+}
+
+function getKnownExternalMcpConfigPaths() {
+  const home = os.homedir();
+  const appData = process.env.APPDATA || path.join(home, "AppData", "Roaming");
+  return dedupePaths([
+    path.join(appData, "Cursor", "User", "mcp.json"),
+    path.join(appData, "Trae", "User", "mcp.json"),
+    path.join(appData, "Trae CN", "User", "mcp.json"),
+    path.join(home, ".trae", "mcp.json"),
+    path.join(home, ".trae-cn", "mcp.json"),
+    path.join(home, ".claude", "mcp.json"),
+    path.join(home, ".openclaw", "mcp.json")
+  ]);
+}
+
+function resolveExternalMcpConfigTargets() {
+  const fromEnv = parsePathListFromEnv(process.env[EXTERNAL_MCP_TARGETS_ENV]);
+  const known = getKnownExternalMcpConfigPaths().filter((filePath) => {
+    if (pathExists(filePath)) return true;
+    return pathExists(path.dirname(filePath));
+  });
+  return dedupePaths([...fromEnv, ...known]);
+}
+
+function mergeMcpServerConfigFile(filePath, options = {}) {
+  const nextConfig = buildMcpConfigFileContent(options);
+  const serverName = Object.keys(nextConfig.mcpServers || {})[0] || DEFAULT_MCP_SERVER_NAME;
+  const launchConfig = nextConfig.mcpServers?.[serverName] || buildMcpLaunchConfig(options);
+  const current = readJsonObjectFileSafe(filePath);
+  const existingServers =
+    current?.mcpServers && typeof current.mcpServers === "object" && !Array.isArray(current.mcpServers)
+      ? current.mcpServers
+      : {};
+  const existingEntry = existingServers[serverName];
+  const merged = {
+    ...current,
+    mcpServers: {
+      ...existingServers,
+      [serverName]: launchConfig
+    }
+  };
+
+  ensureDir(path.dirname(filePath));
+  fs.writeFileSync(filePath, JSON.stringify(merged, null, 2), "utf8");
+  const updated = JSON.stringify(existingEntry || null) !== JSON.stringify(launchConfig);
+  return {
+    file: filePath,
+    server: serverName,
+    updated
+  };
+}
+
+function installExternalMcpConfigs(options = {}) {
+  const targets = resolveExternalMcpConfigTargets();
+  const applied = [];
+  const skipped = [];
+  for (const target of targets) {
+    try {
+      const existed = pathExists(target);
+      const merged = mergeMcpServerConfigFile(target, options);
+      applied.push({
+        file: target,
+        server: merged.server,
+        created: !existed,
+        updated: merged.updated
+      });
+    } catch (error) {
+      skipped.push({
+        file: target,
+        reason: error.message
+      });
+    }
+  }
+  return { targets, applied, skipped };
+}
+
+function getKnownExternalSkillBaseDirs() {
+  const home = os.homedir();
+  const appData = process.env.APPDATA || path.join(home, "AppData", "Roaming");
+  return dedupePaths([
+    path.join(home, ".cursor", "skills"),
+    path.join(home, ".trae", "skills"),
+    path.join(home, ".trae-cn", "skills"),
+    path.join(home, ".claude", "skills"),
+    path.join(home, ".openclaw", "skills"),
+    path.join(appData, "Cursor", "User", "skills"),
+    path.join(appData, "Trae", "User", "skills"),
+    path.join(appData, "Trae CN", "User", "skills"),
+    path.join(appData, "OpenClaw", "User", "skills")
+  ]);
+}
+
+function resolveExternalSkillBaseDirs() {
+  const fromEnv = parsePathListFromEnv(process.env[EXTERNAL_SKILL_DIRS_ENV]);
+  const known = getKnownExternalSkillBaseDirs().filter((dirPath) => pathExists(dirPath));
+  return dedupePaths([...fromEnv, ...known]);
+}
+
+function mirrorSkillToExternalDirs() {
+  const baseDirs = resolveExternalSkillBaseDirs();
+  const mirrored = [];
+  const skipped = [];
+  for (const baseDir of baseDirs) {
+    try {
+      const targetDir = path.join(baseDir, skillName);
+      ensureDir(path.dirname(targetDir));
+      fs.cpSync(skillSourceDir, targetDir, { recursive: true, force: true });
+      mirrored.push({ base_dir: baseDir, target_dir: targetDir });
+    } catch (error) {
+      skipped.push({ base_dir: baseDir, reason: error.message });
+    }
+  }
+  return { baseDirs, mirrored, skipped };
+}
 
 function readTextFile(filePath, label) {
   const resolved = path.resolve(String(filePath));
@@ -909,7 +1079,7 @@ async function launchChrome(options) {
   };
 }
 
-function printHelp() {
+function printHelp() {
   console.log("boss-recruit-mcp");
   console.log("");
   console.log("Usage:");
@@ -920,7 +1090,7 @@ function printHelp() {
   console.log("  boss-recruit-mcp install-skill Install only the Codex skill");
   console.log("  boss-recruit-mcp init-config  Create ~/.codex/boss-recruit-mcp/screening-config.json if missing");
   console.log("  boss-recruit-mcp set-port     Persist preferred Chrome debug port to active screening-config");
-  console.log("  boss-recruit-mcp mcp-config   Generate MCP config JSON for Cursor/Trae/Claude Code/OpenClaw");
+  console.log("  boss-recruit-mcp mcp-config   Generate MCP config JSON for Cursor/Trae(含 trae-cn)/Claude Code/OpenClaw");
   console.log("  boss-recruit-mcp doctor       Check config, calibration, and runtime prerequisites");
   console.log("  boss-recruit-mcp calibrate    Auto-open Boss search page, then run favorite-button calibration");
   console.log("  boss-recruit-mcp launch-chrome Reuse existing Chrome debug instance when possible; otherwise launch one, open Boss search, and check login state");
@@ -972,22 +1142,41 @@ function printMcpConfig(options = {}) {
   console.log("2. Merge its mcpServers block into that client's MCP config.");
 }
 
-function installAll() {
-  const skillTarget = installSkill();
-  const configResult = ensureUserConfig();
-  const mcpTemplateResult = writeMcpConfigFiles({ client: "all" });
-  console.log(`Skill installed to: ${skillTarget}`);
-  if (configResult.created) {
-    console.log(`Config template created at: ${configResult.path}`);
-  } else {
-    console.log(`Config already exists at: ${configResult.path}`);
+function installAll() {
+  const skillTarget = installSkill();
+  const configResult = ensureUserConfig();
+  const mcpTemplateResult = writeMcpConfigFiles({ client: "all" });
+  const externalMcpResult = installExternalMcpConfigs({});
+  const externalSkillResult = mirrorSkillToExternalDirs();
+  console.log(`Skill installed to: ${skillTarget}`);
+  if (configResult.created) {
+    console.log(`Config template created at: ${configResult.path}`);
+  } else {
+    console.log(`Config already exists at: ${configResult.path}`);
   }
   console.log(`MCP config templates exported to: ${mcpTemplateResult.outputDir}`);
-  for (const item of mcpTemplateResult.files) {
-    console.log(`- ${item.client}: ${item.file}`);
-  }
-  console.log("");
-  console.log("Next steps:");
+  for (const item of mcpTemplateResult.files) {
+    console.log(`- ${item.client}: ${item.file}`);
+  }
+  if (externalMcpResult.targets.length > 0) {
+    console.log(`Auto-configured external MCP files: ${externalMcpResult.applied.length}`);
+    for (const item of externalMcpResult.applied) {
+      const action = item.created ? "created" : item.updated ? "updated" : "unchanged";
+      console.log(`- ${item.file} (${action})`);
+    }
+  } else {
+    console.log("No external MCP config target detected. Set BOSS_RECRUIT_MCP_CONFIG_TARGETS to auto-configure custom agents.");
+  }
+  if (externalSkillResult.baseDirs.length > 0) {
+    console.log(`Mirrored skill to external dirs: ${externalSkillResult.mirrored.length}`);
+    for (const item of externalSkillResult.mirrored) {
+      console.log(`- ${item.target_dir}`);
+    }
+  } else {
+    console.log("No external skill dir detected. Set BOSS_RECRUIT_EXTERNAL_SKILL_DIRS to mirror skill for non-Codex agents.");
+  }
+  console.log("");
+  console.log("Next steps:");
   console.log("1. Fill in baseUrl/apiKey/model in the config file above.");
   console.log("2. Choose a client template from the exported MCP config files and merge it into your AI client config.");
   console.log("3. Choose a Chrome remote-debugging port (9222 is recommended, but you can reuse an existing port).");