@reconcrap/boss-recruit-mcp 1.0.7 → 1.0.8

package/README.md

@@ -84,6 +84,18 @@ $CODEX_HOME/boss-recruit-mcp/screening-config.json
 2. 填写以下字段：
 
 - `baseUrl` / `apiKey` / `model` 必填
+- OpenAI 推荐：
+  - `baseUrl`: `https://api.openai.com/v1`
+  - `apiKey`: OpenAI API Key
+  - `model`: 例如 `gpt-4.1-mini`
+- 也支持通过环境变量注入：
+  - `OPENAI_API_KEY`（可替代配置文件中的 `apiKey`）
+  - `OPENAI_BASE_URL`（可替代配置文件中的 `baseUrl`）
+  - `OPENAI_MODEL`（可替代配置文件中的 `model`）
+  - `OPENAI_ORG_ID` / `OPENAI_PROJECT_ID`（可选）
+- 配置文件可选字段：
+  - `openaiOrganization`
+  - `openaiProject`
 - `debugPort` 可选，默认 `9222`
 - `calibrationFile` 可选；不填时默认使用 `$CODEX_HOME/boss-recruit-mcp/favorite-calibration.json`
 - `outputDir` 可选；不填时默认输出到用户桌面
@@ -111,6 +123,12 @@ boss-recruit-mcp run --instruction "在 Boss 上找做过推荐系统的人，
 boss-recruit-mcp run --instruction "在 Boss 上找做过推荐系统的人" --confirmation-json "{\"keyword_confirmed\":true,\"keyword_value\":\"推荐系统\",\"search_params_confirmed\":true}" --overrides-json "{\"city\":\"杭州\",\"degree\":\"本科\",\"schools\":[\"985\",\"211\",\"qs100\"],\"filter_recent_viewed\":true,\"target_count\":10}"
 ```
 
+PowerShell 下更推荐用文件方式，避免引号转义导致 `INVALID_CLI_INPUT`：
+
+```bash
+boss-recruit-mcp run --instruction-file request.txt --confirmation-file confirmation.json --overrides-file overrides.json
+```
+
 如果命令行中放长文本不方便，改用文件：
 
 ```bash
@@ -124,19 +142,16 @@ boss-recruit-mcp run --instruction-file request.txt --confirmation-file confirma
 
 先确认你要使用的 Chrome 远程调试端口。推荐 `9222`，但如果你已经有一个正在运行的远程调试 Chrome，也可以继续使用那个端口。确认端口后，再执行下面的命令。
 
-推荐先启动调试 Chrome：
+执行校准（会自动尝试打开 Boss 搜索页）：
 
 ```bash
-boss-recruit-mcp launch-chrome --port <port>
+boss-recruit-mcp calibrate --port <port>
 ```
 
-`launch-chrome` 会自动为该端口创建独立的 Chrome profile 目录，避免复用已有 Chrome 实例导致调试端口未生效。
-命令还会检查新打开的 Boss 页面是否仍停留在 `search` 页面；如果跳转到了登录页或其他页面，说明需要用户先手动登录 Boss。
-
-然后执行校准：
+如果你想自定义监听窗口（默认 60 秒）：
 
 ```bash
-boss-recruit-mcp calibrate --port <port>
+boss-recruit-mcp calibrate --port <port> --timeout-ms 60000
 ```
 
 如果你的 `screening-config.json` 里配置了自定义 `calibrationFile` 路径，而该路径当前不存在，直接把校准结果输出到那个路径：
@@ -200,6 +215,34 @@ boss-recruit-mcp doctor --port <port>
 - 若当前运行环境不允许启动子进程，会返回更明确的权限错误码而不是笼统失败
 - 配置文件查找顺序：`BOSS_RECRUIT_SCREEN_CONFIG` > 工作区 `boss-recruit-mcp/config/screening-config.json` > 用户目录 `$CODEX_HOME/boss-recruit-mcp/screening-config.json` > 包内示例配置
 
+## 终版测试方案
+
+回归脚本位置：`scripts/regression.ps1`
+
+1. 快速回归（不依赖 Boss 页面，验证 CLI 输入与状态机基础逻辑）：
+
+```bash
+npm run test:regression:win
+```
+
+2. 全链路回归（依赖 Chrome 调试端口 + 已登录 Boss）：
+
+```bash
+powershell -ExecutionPolicy Bypass -File scripts/regression.ps1 -Mode full -Port 9222
+```
+
+3. 负向回归（错误端口，确保不会误返回 `COMPLETED`）：
+
+```bash
+powershell -ExecutionPolicy Bypass -File scripts/regression.ps1 -Mode negative
+```
+
+判定标准：
+
+- 不应出现 `INVALID_CLI_INPUT`
+- 正常场景允许 `COMPLETED` 或可诊断的 `FAILED`
+- 错误端口场景必须是 `FAILED`，且不是参数解析类错误
+
 ## 发布
 
 ```bash

package/config/screening-config.example.json

@@ -1,5 +1,7 @@
 {
-  "baseUrl": "https://your-llm-endpoint.example.com/v1",
-  "apiKey": "replace-with-your-api-key",
-  "model": "replace-with-your-model-name"
+  "baseUrl": "https://api.openai.com/v1",
+  "apiKey": "replace-with-openai-api-key",
+  "model": "gpt-4.1-mini",
+  "openaiOrganization": "optional-org-id",
+  "openaiProject": "optional-project-id"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recruit-mcp",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Unified MCP pipeline for boss-search-cli and boss-screen-cli",
   "keywords": [
     "boss",
@@ -18,7 +18,8 @@
     "start": "node src/index.js",
     "cli": "node src/cli.js",
     "install:local": "node src/cli.js install",
-    "test:parser": "node src/test-parser.js"
+    "test:parser": "node src/test-parser.js",
+    "test:regression:win": "powershell -ExecutionPolicy Bypass -File scripts/regression.ps1 -Mode quick"
   },
   "files": [
     "bin",

package/skills/boss-recruit-pipeline/README.md

@@ -33,8 +33,13 @@ boss-recruit-mcp mcp-config --client all
 - 默认优先走 MCP；如果当前 agent 无法再添加 MCP，也可以改用 `boss-recruit-mcp run` 作为 CLI fallback。
 - 正式开始前，必须先做一轮参数确认，分开展示已识别参数、待确认参数、缺失参数。
 - 参数确认尽量复用统一模板：`已识别参数` / `待确认或待修正` / `缺失参数` / `默认值提醒` / `请用户回复`。
+- 在正式执行前，必须单独让用户确认筛选 `criteria`（尤其学历/学校/论文等硬性条件）无误，不能只确认关键词和搜索参数。
 - 端口未确认时，必须先询问用户是否使用推荐的 `9222`，或提供一个已有的其他远程调试端口，不能直接默认 `9222`。
-- 新打开 Chrome 实例后，要检查页面是否仍停留在 Boss search；如果跳转到其他页面，必须提示用户先手动登录 Boss，再继续。
+- 任何需要打开 Chrome 的动作前，先检查调试端口是否已有可用实例；端口可连时必须复用，不要再新开一个 9222 实例。
+- 若页面未停留在 Boss search（例如跳到登录页或首页），必须提示用户先手动登录 Boss，再继续。
 - 如果识别结果里出现明显脏值或可疑字段，例如“杭州筛选做过”，必须要求用户改成标准值后再继续。
+- 学历/学校硬性条件不能在 criteria 清洗时被剔除；即使已提取到搜索参数，criteria 仍需保留原始约束语义（例如“本科学历必须是985”）。
 - 如果缺少 `favorite-calibration.json`，必须指导用户在当前环境重新校准，不能搜索或复制历史遗留校准文件来顶替。
+- 校准提示使用两阶段：先问“是否准备好开始校准”，不要问“是否已完成校准”；用户确认后应直接启动 `boss-recruit-mcp calibrate --port <port>`。
+- 校准里的“打开详情 -> 收藏 -> 取消收藏 -> 关闭详情”属于动作说明，不要要求用户先手动完成这些步骤后再回复“可以校准”。
 - 若缺失参数仍未补齐，只能在用户明确确认接受默认值和质量风险后继续，不能静默按默认执行。

package/skills/boss-recruit-pipeline/SKILL.md

@@ -27,12 +27,12 @@
    - 建议使用 `9222`
    - 但也允许用户明确提供一个已在使用的其他远程调试端口
 3. 在用户确认端口前，不要直接假设 `9222` 并执行任何依赖端口的命令。
-4. 端口确认后，再检查依赖与配置：
+4. 端口确认后，先检查依赖与端口状态：
    - `boss-recruit-mcp doctor --port <port>`
-5. 若 Chrome 未以远程调试模式启动，优先帮助用户启动：
-   - `boss-recruit-mcp launch-chrome --port <port>`
-   - 打开页面：`https://www.zhipin.com/web/chat/search`
-6. 启动新的 Chrome debugging 实例后，必须检查页面是否仍停留在 `https://www.zhipin.com/web/chat/search`：
+5. 任何“准备打开 Chrome”的动作前，必须先判断该端口是否已有可用实例：
+   - 若调试端口可连，禁止再新开 Chrome；直接复用现有实例，并确保页面在 `https://www.zhipin.com/web/chat/search`
+   - 仅当调试端口不可连时，才执行 `boss-recruit-mcp launch-chrome --port <port>`
+6. 若执行 `launch-chrome` 后页面没有停留在 `https://www.zhipin.com/web/chat/search`：
    - 若仍在 search 页面，可继续；
    - 若跳转到登录页、首页或其他 Boss 页面，视为“需要重新登录”；
    - 必须明确提示用户手动登录 Boss，并等待用户回复“已登录/可以继续”后，才能继续后续动作。
@@ -48,15 +48,18 @@
   - 必须明确告诉用户“当前期望的校准文件路径”；
   - 应指导用户用 `boss-recruit-mcp calibrate --port <port> --output <expected-path>` 直接生成到该路径；
   - 不要静默改写配置，也不要把别处的文件复制过去。
-- 提示语必须包含这几步：
-  - 打开 Boss 直聘
-  - 去到搜索页面
-  - 随便打开一位人选的详情页
-  - 点击收藏按钮
-  - 再次点击取消该人选的收藏
+- 校准动作说明用于“让用户了解流程”，不要求用户先手动点击页面：
+  - 打开 Boss 直聘搜索页面
+  - 打开任意一位人选详情页
+  - 执行一次收藏，再取消收藏
   - 关闭详情页
+- 校准对话必须是“两阶段”：
+  - 第一阶段：先完整说明校准步骤，然后只问“是否准备好开始校准”；
+  - 第二阶段：用户确认“准备好了”后，直接启动校准命令，并明确说明“你不需要先手动完成页面点击，我会立即启动校准流程”。
+- 不要把“请确认你已完成校准”当作启动校准的前置问题；启动前应确认“准备开始”，不是“已经完成”。
+- 不要要求用户先完成页面操作再回复“可以校准/已完成校准”；应在用户确认“准备开始”后立即执行校准。
 - 然后执行：
-  - `boss-recruit-mcp calibrate --port <port>`
+  - `boss-recruit-mcp calibrate --port <port>`（默认监听 60 秒）
 - 默认校准文件路径：
   - `$CODEX_HOME/boss-recruit-mcp/favorite-calibration.json`
 
@@ -69,6 +72,7 @@
     - `keyword_confirmed` (boolean): 是否确认关键词
     - `keyword_value` (string): 用户确认或改写后的关键词
     - `search_params_confirmed` (boolean): 用户是否已明确确认当前参数集
+    - `criteria_confirmed` (boolean): 用户是否已明确确认筛选 criteria（尤其硬性约束）
     - `use_default_for_missing` (boolean): 用户是否明确同意对缺失参数使用默认值
   - `overrides` (object, optional)
     - `city` (string)
@@ -142,9 +146,13 @@
    - 明确给出校准步骤与命令；
    - 明确指出期望生成到哪个路径；
    - 不要在本机搜索并复用其他 `favorite-calibration.json`。
-4. 若 `launch-chrome` 后发现页面没有停留在 search，而是跳到了登录页、首页或其他页面：
+   - 校准引导必须先问“是否准备好开始校准”；用户确认准备好后，再执行：
+     - `boss-recruit-mcp calibrate --port <port>`
+   - 不要要求用户先手动完成“收藏/取消收藏”等页面动作，再触发 `calibrate`。
+   - 除非调试端口不可连，否则不要额外先执行 `launch-chrome`。
+4. 若校准流程中发现页面没有停留在 search，或跳到了登录页、首页或其他页面：
    - 明确告诉用户“当前需要手动登录 Boss”；
-   - 明确要求用户在新打开的 Chrome 窗口中完成登录；
+   - 明确要求用户在当前可见的 Chrome 窗口中完成登录；
    - 等用户回复“已登录，可以继续”后，再继续下一步；
    - 不要在用户未确认登录完成前直接执行搜索、校准或流水线。
 5. 只有当以上条件满足时，才首次进入流水线解析：
@@ -171,6 +179,7 @@
 8. 若返回 `NEED_CONFIRMATION`：
    - 询问用户是否确认 `proposed_keyword`；
    - 同时也要让用户确认其他已提取参数里是否有误；
+   - 必须单独确认筛选 `criteria` 是否准确（尤其学历/学校/论文等硬性条件不能丢失）；
    - 若 `required_confirmations` 或 `pending_questions` 里包含 `filter_recent_viewed`，必须明确补问：是否需要过滤近 14 天查看过的人选；
    - 若确认，带 `confirmation.keyword_confirmed=true` 和 `keyword_value` 再次调用；
    - 若用户修改关键词，传用户给的新词作为 `keyword_value` 再次调用；
@@ -180,6 +189,7 @@
    - 必须得到用户明确确认“可以按默认值继续”后，才能继续执行。
 10. 只有在以下条件都满足后，才允许正式开始：
    - 用户已经确认已提取参数无误；
+   - 用户已经明确确认 `criteria` 无误；
    - 缺失参数已补齐，或用户已明确接受默认值；
    - `NEED_CONFIRMATION` 分支中的关键词也已确认。
 11. 若返回 `COMPLETED`：
@@ -200,6 +210,7 @@
 - 优先鼓励用户一次性给全这些字段：城市、学历、学校标签、目标人数、核心方向关键词。
 - 当用户提到“做过 AI infra / 推荐系统 / 搜索 / 广告 / 多模态”等经历，但没有显式写“关键词”，默认允许流水线先自动抽取，再走确认分支。
 - 当用户附带筛选要求（如“必须发表过 CCF-A 区论文”“有开源项目”“带过团队”），这些要求应该保留在 `criteria` 中，不应被误当作搜索过滤条件。
+- 当用户明确给出“学历/学校”硬性条件（如“本科学历必须是985”），即使这些信息已被提取到搜索参数，`criteria` 里也必须保留原始约束，不可剔除。
 - 若参数提取结果出现明显噪声、截断、短语串接、非标准枚举值，优先视为“识别不可靠”，要求用户确认，不要为了推进流程直接采用。
 - 若用户输入 `qs50`、`qs200`、`qs500` 等任意 `QS数字` 学校标签，统一按 `<=100 -> qs100`、`>100 -> qs500` 处理；不要把原始 `QS200` 再传到底层搜索命令。
 - 若用户没有明确提到“是否过滤近 14 天查看过的人选”，必须在参数确认阶段主动补问，不能静默默认开启或关闭。

package/src/cli.js

@@ -194,10 +194,53 @@ function parseJsonOption(value, label) {
     return undefined;
   }
 
+  const raw = String(value).replace(/^\uFEFF/, "").trim();
+  const normalizedQuotes = raw
+    .replace(/[“”]/g, "\"")
+    .replace(/[‘’]/g, "'");
+
+  const candidates = [];
+  const pushCandidate = (item) => {
+    if (typeof item === "string" && item.trim()) {
+      candidates.push(item.trim());
+    }
+  };
+
+  pushCandidate(raw);
+  if (normalizedQuotes !== raw) {
+    pushCandidate(normalizedQuotes);
+  }
+  if (
+    normalizedQuotes.length >= 2
+    && normalizedQuotes.startsWith("'")
+    && normalizedQuotes.endsWith("'")
+  ) {
+    pushCandidate(normalizedQuotes.slice(1, -1));
+  }
+
+  let lastError = null;
+  for (const candidate of candidates) {
+    try {
+      return JSON.parse(candidate);
+    } catch (error) {
+      lastError = error;
+      try {
+        const unwrapped = JSON.parse(candidate);
+        if (typeof unwrapped === "string") {
+          return JSON.parse(unwrapped);
+        }
+      } catch {
+        // Continue trying next candidate.
+      }
+    }
+  }
+
   try {
-    return JSON.parse(String(value));
+    return JSON.parse(raw);
   } catch (error) {
-    throw new Error(`Invalid ${label} JSON: ${error.message}`);
+    const hint = "Tip: in PowerShell prefer --*-file or wrap JSON with single quotes.";
+    const reason = lastError?.message || error.message;
+    throw new Error(`Invalid ${label} JSON: ${reason}. ${hint}`);
   }
 }
 
@@ -345,6 +388,29 @@ async function inspectBossPageState(port, options = {}) {
   });
 }
 
+async function openBossSearchTab(port) {
+  const endpoint = `http://127.0.0.1:${port}/json/new?${encodeURIComponent(bossUrl)}`;
+  const attempts = ["PUT", "GET"];
+  let lastError = null;
+
+  for (const method of attempts) {
+    try {
+      const response = await fetch(endpoint, { method });
+      if (response.ok) {
+        return { ok: true, method };
+      }
+      lastError = new Error(`DevTools /json/new returned ${response.status}`);
+    } catch (error) {
+      lastError = error;
+    }
+  }
+
+  return {
+    ok: false,
+    error: lastError?.message || "Failed to open Boss search tab via DevTools /json/new"
+  };
+}
+
 function hasModule(moduleName) {
   try {
     require.resolve(moduleName);
@@ -360,6 +426,15 @@ function getDebugPort(options = {}) {
   return Number.isFinite(port) && port > 0 ? port : 9222;
 }
 
+function getCalibrationTimeoutMs(options = {}) {
+  const raw = options["timeout-ms"] || options.timeoutMs || options.timeout || "60000";
+  const timeout = Number.parseInt(String(raw), 10);
+  if (!Number.isFinite(timeout) || timeout <= 0) {
+    return 60000;
+  }
+  return Math.max(5000, timeout);
+}
+
 function getChromeExecutable() {
   const candidates = [
     process.env.BOSS_RECRUIT_CHROME_PATH,
@@ -450,65 +525,161 @@ async function printDoctor(options) {
 async function calibrate(options) {
   const port = getDebugPort(options);
   const output = options.output ? path.resolve(String(options.output)) : getUserCalibrationPath();
-  console.log("Before calibration:");
-  console.log("1. Open Boss search page.");
-  console.log("2. Open any candidate detail page.");
-  console.log("3. Click the favorite button once.");
-  console.log("4. Click again to cancel favorite for that candidate.");
-  console.log("5. Close the detail page after calibration completes.");
+  const timeoutMs = getCalibrationTimeoutMs(options);
+
+  console.log("Calibration checklist:");
+  console.log("1. The tool will auto-open Boss search page now.");
+  console.log("2. Open any candidate detail page in that Boss window.");
+  console.log("3. Click favorite once, then click again to unfavorite.");
+  console.log("4. Close the detail page.");
+  console.log(`5. The calibration listener will wait for ${Math.round(timeoutMs / 1000)} seconds.`);
   console.log("");
+
+  let launchResult = null;
+  const preState = await inspectBossPageState(port, { timeoutMs: 2000, pollMs: 500 });
+  if (preState.state === "DEBUG_PORT_UNREACHABLE") {
+    launchResult = await launchChrome(options);
+    if (process.exitCode && process.exitCode !== 0) {
+      return;
+    }
+  } else {
+    console.log(`Detected existing Chrome debug instance on port ${port}; calibration will reuse it.`);
+    let pageState = preState;
+    if (pageState.state !== "SEARCH_READY") {
+      const openResult = await openBossSearchTab(port);
+      if (openResult.ok) {
+        console.log(
+          `Requested Boss search tab via DevTools /json/new (${openResult.method}) before calibration`
+        );
+      } else {
+        console.log(
+          `Could not request Boss search tab via DevTools /json/new before calibration: ${openResult.error}`
+        );
+      }
+      pageState = await inspectBossPageState(port, { timeoutMs: 6000, pollMs: 1000 });
+    }
+    launchResult = {
+      ok: pageState.state === "SEARCH_READY",
+      state: pageState.state,
+      pageState,
+      reused_existing_instance: true
+    };
+  }
+
+  if (launchResult?.state === "LOGIN_REQUIRED") {
+    console.log("Boss page requires login. Please log in in the opened Chrome window, then complete the checklist within the listener window.");
+  } else if (launchResult?.state === "SEARCH_READY") {
+    console.log("Boss search page is ready. Start the checklist now.");
+  } else {
+    console.log("Proceeding with calibration listener. If no click is captured, retry after ensuring Boss search page is open.");
+  }
+  console.log("");
+
   const code = await runNodeScript(calibrationScriptPath, [
     "--port",
     String(port),
     "--output",
-    output
+    output,
+    "--timeout-ms",
+    String(timeoutMs)
   ]);
   process.exitCode = code;
 }
 
 async function launchChrome(options) {
-  const chromePath = getChromeExecutable();
-  if (!chromePath) {
-    console.error("Chrome executable not found. Set BOSS_RECRUIT_CHROME_PATH or install Google Chrome.");
-    process.exitCode = 1;
-    return;
-  }
   const port = getDebugPort(options);
-  const userDataDir = getChromeUserDataDir(port, options);
-  const args = [
-    `--remote-debugging-port=${port}`,
-    `--user-data-dir=${userDataDir}`,
-    "--new-window",
-    bossUrl
-  ];
-  const child = spawn(chromePath, args, {
-    detached: true,
-    stdio: "ignore",
-    windowsHide: false
-  });
-  child.unref();
-  console.log(`Chrome launched with remote debugging port ${port}`);
-  console.log(`User data dir: ${userDataDir}`);
-  console.log(`URL: ${bossUrl}`);
+  const initialState = await inspectBossPageState(port, { timeoutMs: 2000, pollMs: 500 });
+  let usedExistingInstance = initialState.state !== "DEBUG_PORT_UNREACHABLE";
+
+  if (usedExistingInstance) {
+    console.log(`Reusing existing Chrome debug instance on port ${port}`);
+
+    if (initialState.state !== "SEARCH_READY") {
+      const openResult = await openBossSearchTab(port);
+      if (openResult.ok) {
+        console.log(
+          `Requested Boss search tab via DevTools /json/new (${openResult.method}) on port ${port}`
+        );
+      } else {
+        console.log(
+          `Could not request Boss search tab via DevTools /json/new: ${openResult.error}`
+        );
+      }
+    }
+  } else {
+    const chromePath = getChromeExecutable();
+    if (!chromePath) {
+      console.error("Chrome executable not found. Set BOSS_RECRUIT_CHROME_PATH or install Google Chrome.");
+      process.exitCode = 1;
+      return { ok: false, state: "CHROME_NOT_FOUND" };
+    }
+
+    const userDataDir = getChromeUserDataDir(port, options);
+    const args = [
+      `--remote-debugging-port=${port}`,
+      `--user-data-dir=${userDataDir}`,
+      "--new-window",
+      bossUrl
+    ];
+    const child = spawn(chromePath, args, {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: false
+    });
+    child.unref();
+    console.log(`Chrome launched with remote debugging port ${port}`);
+    console.log(`User data dir: ${userDataDir}`);
+    console.log(`URL: ${bossUrl}`);
+  }
+
+  let pageState = await inspectBossPageState(port, { timeoutMs: 12000, pollMs: 1000 });
+  if (pageState.state === "BOSS_TAB_NOT_FOUND") {
+    const openResult = await openBossSearchTab(port);
+    if (openResult.ok) {
+      console.log(`Requested Boss search tab via DevTools /json/new (${openResult.method})`);
+      pageState = await inspectBossPageState(port, { timeoutMs: 6000, pollMs: 1000 });
+    } else {
+      console.log(`Could not request Boss search tab via DevTools /json/new: ${openResult.error}`);
+    }
+  }
 
-  const pageState = await inspectBossPageState(port, { timeoutMs: 12000, pollMs: 1000 });
   if (pageState.state === "SEARCH_READY") {
     console.log("Boss search page is ready.");
     console.log(`Current URL: ${pageState.current_url}`);
-    return;
+    return {
+      ok: true,
+      state: "SEARCH_READY",
+      pageState,
+      reused_existing_instance: usedExistingInstance
+    };
   }
 
   if (pageState.state === "LOGIN_REQUIRED") {
     console.log("Boss page redirected away from search. Manual login is required.");
     console.log(`Current URL: ${pageState.current_url}`);
     console.log("Please log in to Boss manually in the opened Chrome window, then tell the AI agent to continue.");
-    return;
+    return {
+      ok: false,
+      state: "LOGIN_REQUIRED",
+      pageState,
+      reused_existing_instance: usedExistingInstance
+    };
   }
 
+  if (usedExistingInstance && pageState.state === "DEBUG_PORT_UNREACHABLE") {
+    // Existing instance may have been closed while launching; surface it clearly.
+    usedExistingInstance = false;
+  }
   console.log(pageState.message);
   if (pageState.current_url) {
     console.log(`Current URL: ${pageState.current_url}`);
   }
+  return {
+    ok: false,
+    state: pageState.state || "UNKNOWN",
+    pageState,
+    reused_existing_instance: usedExistingInstance
+  };
 }
 
 function printHelp() {
@@ -523,14 +694,17 @@ function printHelp() {
   console.log("  boss-recruit-mcp init-config  Create ~/.codex/boss-recruit-mcp/screening-config.json if missing");
   console.log("  boss-recruit-mcp mcp-config   Generate MCP config JSON for Cursor/Trae/Claude Code/OpenClaw");
   console.log("  boss-recruit-mcp doctor       Check config, calibration, and runtime prerequisites");
-  console.log("  boss-recruit-mcp calibrate    Run favorite-button calibration and save favorite-calibration.json");
-  console.log("  boss-recruit-mcp launch-chrome Launch Chrome in remote-debugging mode, open Boss search, and check login state");
+  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");
   console.log("  boss-recruit-mcp where        Print installed package, skill, and config paths");
   console.log("");
   console.log("Run command:");
   console.log("  boss-recruit-mcp run --instruction \"找杭州本科做过推荐系统的人\" [--confirmation-json '{...}'] [--overrides-json '{...}']");
   console.log("  boss-recruit-mcp run --instruction-file request.txt [--confirmation-file confirmation.json] [--overrides-file overrides.json]");
   console.log("");
+  console.log("Calibration command:");
+  console.log("  boss-recruit-mcp calibrate --port 9222 [--timeout-ms 60000] [--output <path>]");
+  console.log("");
   console.log("MCP config command:");
   console.log("  boss-recruit-mcp mcp-config --client cursor");
   console.log("  boss-recruit-mcp mcp-config --client all --output-dir <dir>");

package/src/parser.js

@@ -240,8 +240,6 @@ function buildScreenCriteria(text, searchParams) {
   const filtered = clauses.filter((clause) => {
     if (/搜索关键词|关键词|keyword/i.test(clause)) return false;
     if (/地点|城市/.test(clause)) return false;
-    if (/学历|本科|硕士|博士/.test(clause) && !/论文|项目|经验/.test(clause)) return false;
-    if (/985|211|qs\s*\d+|双一流|统招(?:本科)?|院校/i.test(clause) && !/论文|经验|项目/.test(clause)) return false;
     if (/近?14天(?:内)?查看(?:过)?|过滤近14天查看/.test(clause)) return false;
     if (isCountPlanningClause(clause)) return false;
     return true;
@@ -460,8 +458,10 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
   );
   const suspicious_fields = collectSuspiciousFields(searchParams, screenParams);
   const needs_recent_viewed_filter_confirmation = searchParams.filter_recent_viewed === null;
-  const pending_questions = needs_recent_viewed_filter_confirmation
-    ? [
+  const needs_criteria_confirmation = confirmation?.criteria_confirmed !== true;
+  const pending_questions = [
+    ...(needs_recent_viewed_filter_confirmation
+      ? [
       {
         field: "filter_recent_viewed",
         question: "是否需要过滤近14天查看过的人选？",
@@ -471,7 +471,17 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
         ]
       }
     ]
-    : [];
+      : []),
+    ...(needs_criteria_confirmation
+      ? [
+        {
+          field: "criteria",
+          question: "请确认筛选 criteria 是否准确无误（尤其是硬性约束条件）？",
+          value: baseScreenParams.criteria
+        }
+      ]
+      : [])
+  ];
 
   return {
     parsed,
@@ -482,6 +492,7 @@ export function parseRecruitInstruction({ instruction, confirmation, overrides }
     suspicious_fields,
     needs_keyword_confirmation: keywordResolution.needsConfirmation,
     needs_recent_viewed_filter_confirmation,
+    needs_criteria_confirmation,
     needs_search_params_confirmation: confirmation?.search_params_confirmed !== true,
     proposed_keyword: keywordResolution.proposedKeyword,
     pending_questions,

package/src/pipeline.js

@@ -13,6 +13,9 @@ function buildRequiredConfirmations(parsedResult) {
   if (parsedResult.needs_recent_viewed_filter_confirmation) {
     confirmations.push("filter_recent_viewed");
   }
+  if (parsedResult.needs_criteria_confirmation) {
+    confirmations.push("criteria");
+  }
   if (parsedResult.has_unresolved_missing_fields) {
     confirmations.push("missing_fields_or_defaults");
   }
@@ -155,6 +158,7 @@ export async function runRecruitPipeline({
     parsed.needs_keyword_confirmation
     || parsed.needs_search_params_confirmation
     || parsed.needs_recent_viewed_filter_confirmation
+    || parsed.needs_criteria_confirmation
   ) {
     return buildNeedConfirmationResponse(parsed);
   }
@@ -203,6 +207,22 @@ export async function runRecruitPipeline({
     );
   }
 
+  if (!Number.isInteger(searchResult.candidate_count)) {
+    return buildFailedResponse(
+      "SEARCH_RESULT_UNVERIFIED",
+      "搜索流程未能确认候选人数量，说明搜索步骤可能没有真正完成，已停止后续筛选。",
+      {
+        search_params: parsed.searchParams,
+        screen_params: parsed.screenParams,
+        diagnostics: {
+          candidate_count: searchResult.candidate_count,
+          stdout: searchResult.stdout?.slice(-1200),
+          stderr: searchResult.stderr?.slice(-1200)
+        }
+      }
+    );
+  }
+
   if (searchResult.candidate_count === 0) {
     return buildFailedResponse(
       "SEARCH_EMPTY_RESULT",