@reconcrap/boss-recruit-mcp 1.0.3 → 1.0.5

package/README.md

@@ -50,6 +50,29 @@ boss-recruit-mcp start
 
 该服务通过 stdio 与 MCP client 通信。
 
+## CLI Fallback
+
+如果当前 AI agent 无法添加新的 MCP、MCP 数量受限，或者只支持 shell/命令执行，也可以直接调用同一后端的 CLI fallback：
+
+```bash
+boss-recruit-mcp run --instruction "在 Boss 上找做过推荐系统的人，城市杭州，本科，学校 985/211/QS100，目标 10 人"
+```
+
+也支持通过 JSON 传确认信息与覆盖参数：
+
+```bash
+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\"],\"target_count\":10}"
+```
+
+如果命令行中放长文本不方便，改用文件：
+
+```bash
+boss-recruit-mcp run --instruction-file request.txt --confirmation-file confirmation.json --overrides-file overrides.json
+```
+
+`run` 的输出是 JSON，状态字段与 MCP 工具一致：`NEED_INPUT` / `NEED_CONFIRMATION` / `COMPLETED` / `FAILED`。
+只要命令成功产出结构化结果，即使状态是 `FAILED` 也会继续输出 JSON，便于 AI agent 直接解析；只有 CLI 参数错误或未处理异常时才会返回非零退出码。
+
 ## Chrome 与校准
 
 先确认你要使用的 Chrome 远程调试端口。推荐 `9222`，但如果你已经有一个正在运行的远程调试 Chrome，也可以继续使用那个端口。确认端口后，再执行下面的命令。
@@ -60,6 +83,9 @@ boss-recruit-mcp start
 boss-recruit-mcp launch-chrome --port <port>
 ```
 
+`launch-chrome` 会自动为该端口创建独立的 Chrome profile 目录，避免复用已有 Chrome 实例导致调试端口未生效。
+命令还会检查新打开的 Boss 页面是否仍停留在 `search` 页面；如果跳转到了登录页或其他页面，说明需要用户先手动登录 Boss。
+
 然后执行校准：
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recruit-mcp",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Unified MCP pipeline for boss-search-cli and boss-screen-cli",
   "keywords": [
     "boss",

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

@@ -23,9 +23,11 @@ npx @reconcrap/boss-recruit-mcp install
 
 ## 运行注意事项
 
+- 默认优先走 MCP；如果当前 agent 无法再添加 MCP，也可以改用 `boss-recruit-mcp run` 作为 CLI fallback。
 - 正式开始前，必须先做一轮参数确认，分开展示已识别参数、待确认参数、缺失参数。
 - 参数确认尽量复用统一模板：`已识别参数` / `待确认或待修正` / `缺失参数` / `默认值提醒` / `请用户回复`。
 - 端口未确认时，必须先询问用户是否使用推荐的 `9222`，或提供一个已有的其他远程调试端口，不能直接默认 `9222`。
+- 新打开 Chrome 实例后，要检查页面是否仍停留在 Boss search；如果跳转到其他页面，必须提示用户先手动登录 Boss，再继续。
 - 如果识别结果里出现明显脏值或可疑字段，例如“杭州筛选做过”，必须要求用户改成标准值后再继续。
 - 如果缺少 `favorite-calibration.json`，必须指导用户在当前环境重新校准，不能搜索或复制历史遗留校准文件来顶替。
 - 若缺失参数仍未补齐，只能在用户明确确认接受默认值和质量风险后继续，不能静默按默认执行。

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

@@ -31,7 +31,11 @@
 5. 若 Chrome 未以远程调试模式启动，优先帮助用户启动：
    - `boss-recruit-mcp launch-chrome --port <port>`
    - 打开页面：`https://www.zhipin.com/web/chat/search`
-6. 只有在以上条件满足后，才继续调用流水线。
+6. 启动新的 Chrome debugging 实例后，必须检查页面是否仍停留在 `https://www.zhipin.com/web/chat/search`：
+   - 若仍在 search 页面，可继续；
+   - 若跳转到登录页、首页或其他 Boss 页面，视为“需要重新登录”；
+   - 必须明确提示用户手动登录 Boss，并等待用户回复“已登录/可以继续”后，才能继续后续动作。
+7. 只有在以上条件满足后，才继续调用流水线。
 
 ## Calibration Requirement
 
@@ -81,6 +85,28 @@
   - `review.default_preview`
   - `review.applied_defaults`
 
+## Backend Selection
+
+- 默认执行路径：优先使用 MCP 工具 `run_recruit_pipeline`。
+- 如果当前 AI agent 无法添加新的 MCP、MCP 数量受限、或当前会话拿不到该工具：
+  - 直接切换到 CLI fallback；
+  - 不要放弃流程，也不要要求用户手动把所有步骤重新翻译一遍。
+- CLI fallback 必须调用与 MCP 相同后端的命令：
+  - `boss-recruit-mcp run --instruction "<user request>"`
+- 如果命令行里直接放长文本不稳定，改用文件输入：
+  - `boss-recruit-mcp run --instruction-file <path>`
+- 如果需要传确认信息或覆盖参数，使用这些参数：
+  - `--confirmation-json '<json>'`
+  - `--confirmation-file <path>`
+  - `--overrides-json '<json>'`
+  - `--overrides-file <path>`
+- CLI fallback 的输出是 JSON，字段语义与 MCP 返回保持一致；优先按同一套状态机处理：
+  - `NEED_INPUT`
+  - `NEED_CONFIRMATION`
+  - `COMPLETED`
+  - `FAILED`
+- 当 CLI fallback 可用时，不要再自行拼接搜索 CLI / 筛选 CLI 的底层命令来重建业务逻辑；优先继续复用 `boss-recruit-mcp run`。
+
 ## Confirmation First
 
 - 在任何一次正式搜索 / 筛选开始前，必须先单开一轮“参数确认对话”，不能在首轮解析后直接开跑。
@@ -99,19 +125,30 @@
 
 1. 收到招聘指令后，先做 setup 检查：
    - MCP 是否可用
+   - 若 MCP 不可用，CLI fallback 是否可用
    - Chrome 调试端口是否已确认
    - Chrome 是否已启动到 Boss 搜索页面
+   - 如果刚启动了新的 Chrome 实例，是否仍停留在 Boss search 页面而未跳转登录
    - `favorite-calibration.json` 是否存在
 2. 若缺少依赖或 MCP 未启动：
    - 自动安装依赖并帮助用户启动 MCP；
    - 优先使用 `npx @reconcrap/boss-recruit-mcp install`
-   - 然后使用用户的 MCP 配置启动 `boss-recruit-mcp`
+   - 然后优先尝试使用用户的 MCP 配置启动 `boss-recruit-mcp`
+   - 如果当前 agent 因平台限制无法配置 MCP，切换到 CLI fallback
 3. 若缺少校准文件：
    - 明确提示用户先完成校准，不要直接调用流水线；
    - 明确给出校准步骤与命令；
    - 明确指出期望生成到哪个路径；
    - 不要在本机搜索并复用其他 `favorite-calibration.json`。
-4. 只有当以上条件满足时，才首次调用 `run_recruit_pipeline`（只传 `instruction`），用于“解析”，不是立刻执行最终搜索结论。
+4. 若 `launch-chrome` 后发现页面没有停留在 search，而是跳到了登录页、首页或其他页面：
+   - 明确告诉用户“当前需要手动登录 Boss”；
+   - 明确要求用户在新打开的 Chrome 窗口中完成登录；
+   - 等用户回复“已登录，可以继续”后，再继续下一步；
+   - 不要在用户未确认登录完成前直接执行搜索、校准或流水线。
+5. 只有当以上条件满足时，才首次进入流水线解析：
+   - 若 MCP 可用，调用 `run_recruit_pipeline`（只传 `instruction`）
+   - 若 MCP 不可用，调用 `boss-recruit-mcp run --instruction ...`
+   - 这一步用于“解析”，不是立刻执行最终搜索结论。
 5. 拿到首次解析结果后，先进入单独的“参数确认对话”：
    - 列出当前已提取到的参数；
    - 单独标出需要用户确认的参数；
@@ -219,6 +256,7 @@
 - 如果工具返回 `output_csv`，在摘要里给出路径，避免重复解释内部流程。
 - 如果端口还没确认，必须先问用户“是否使用推荐的 `9222`，还是你已经有别的远程调试端口”，不能直接把 `9222` 当成已确认值。
 - 如果需要打开 Chrome，优先帮用户执行而不是只给命令。
+- 如果新打开的 Chrome 页面跳离了 search 页面，必须判断为“需要登录”，提示用户手动登录后再继续。
 
 ## Example
 
@@ -245,5 +283,7 @@
 - 参数确认阶段尽量复用统一模板，减少自由表述带来的漏项。
 - 端口未确认时，用“推荐值 + 可选其他端口”的话术，不要直接替用户决定。
 - 校准缺失时，直接指导用户重新校准，不要建议复制或复用任何历史 calibration 文件。
+- 若当前 agent 受 MCP 数量限制，明确告诉用户“本轮改走 CLI fallback”，但用户体验上仍保持同一套确认和状态输出。
+- 新开 Chrome 后若检测到跳转登录，先提示用户手动登录并等待确认，再继续。
 - 若要使用默认值，必须写明“请确认是否按默认值继续”，不能模糊带过。
 - 若运行失败，优先给用户“现在卡在哪一步 + 怎么继续”。

package/src/cli.js

@@ -7,6 +7,7 @@ import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import { startServer } from "./index.js";
 import { runPipelinePreflight } from "./adapters.js";
+import { runRecruitPipeline } from "./pipeline.js";
 
 const require = createRequire(import.meta.url);
 const currentFilePath = fileURLToPath(import.meta.url);
@@ -43,6 +44,15 @@ function getUserCalibrationPath() {
   return path.join(getCodexHome(), "boss-recruit-mcp", "favorite-calibration.json");
 }
 
+function getChromeUserDataDir(port, options = {}) {
+  const rawProvided = options.userDataDir ?? options["user-data-dir"];
+  const provided = typeof rawProvided === "string" ? rawProvided.trim() : "";
+  const basePath = provided || path.join(getCodexHome(), "boss-recruit-mcp", `chrome-profile-${port}`);
+  const targetPath = path.resolve(basePath);
+  ensureDir(targetPath);
+  return targetPath;
+}
+
 function parseOptions(args) {
   const options = {};
   for (let i = 0; i < args.length; i++) {
@@ -60,6 +70,171 @@ function parseOptions(args) {
   return options;
 }
 
+function readTextFile(filePath, label) {
+  const resolved = path.resolve(String(filePath));
+  try {
+    return fs.readFileSync(resolved, "utf8");
+  } catch (error) {
+    throw new Error(`Failed to read ${label} file: ${resolved}. ${error.message}`);
+  }
+}
+
+function parseJsonOption(value, label) {
+  if (value === undefined || value === null || value === "") {
+    return undefined;
+  }
+
+  try {
+    return JSON.parse(String(value));
+  } catch (error) {
+    throw new Error(`Invalid ${label} JSON: ${error.message}`);
+  }
+}
+
+function getRunInstruction(options) {
+  if (typeof options.instruction === "string" && options.instruction.trim()) {
+    return options.instruction.trim();
+  }
+
+  const instructionFile = options["instruction-file"];
+  if (typeof instructionFile === "string" && instructionFile.trim()) {
+    return readTextFile(instructionFile, "instruction").trim();
+  }
+
+  throw new Error("Missing required --instruction or --instruction-file");
+}
+
+function getRunConfirmation(options) {
+  if (typeof options["confirmation-file"] === "string" && options["confirmation-file"].trim()) {
+    return parseJsonOption(
+      readTextFile(options["confirmation-file"], "confirmation"),
+      "confirmation"
+    );
+  }
+
+  return parseJsonOption(options["confirmation-json"], "confirmation");
+}
+
+function getRunOverrides(options) {
+  if (typeof options["overrides-file"] === "string" && options["overrides-file"].trim()) {
+    return parseJsonOption(
+      readTextFile(options["overrides-file"], "overrides"),
+      "overrides"
+    );
+  }
+
+  return parseJsonOption(options["overrides-json"], "overrides");
+}
+
+function getWorkspaceRoot(options) {
+  const raw = options["workspace-root"] || process.env.BOSS_WORKSPACE_ROOT || process.cwd();
+  return path.resolve(String(raw));
+}
+
+function printJson(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function listChromeTabs(port) {
+  const response = await fetch(`http://127.0.0.1:${port}/json/list`);
+  if (!response.ok) {
+    throw new Error(`DevTools endpoint returned ${response.status}`);
+  }
+  const data = await response.json();
+  return Array.isArray(data) ? data : [];
+}
+
+function buildBossPageState(payload) {
+  return {
+    key: "boss_page_state",
+    ...payload
+  };
+}
+
+async function inspectBossPageState(port, options = {}) {
+  const timeoutMs = Number.isFinite(options.timeoutMs) ? options.timeoutMs : 8000;
+  const pollMs = Number.isFinite(options.pollMs) ? options.pollMs : 1000;
+  const expectedUrl = options.expectedUrl || bossUrl;
+  const deadline = Date.now() + timeoutMs;
+  let lastError = null;
+  let lastTabs = [];
+
+  while (Date.now() < deadline) {
+    try {
+      const tabs = await listChromeTabs(port);
+      lastTabs = tabs;
+
+      const exactSearchTab = tabs.find(
+        (tab) => typeof tab?.url === "string" && tab.url.includes("/web/chat/search")
+      );
+      if (exactSearchTab) {
+        return buildBossPageState({
+          ok: true,
+          state: "SEARCH_READY",
+          path: exactSearchTab.url,
+          current_url: exactSearchTab.url,
+          title: exactSearchTab.title || null,
+          requires_login: false,
+          message: "Boss 搜索页已打开，且当前仍停留在 search 页面。"
+        });
+      }
+
+      const bossTab = tabs.find(
+        (tab) => typeof tab?.url === "string" && tab.url.includes("zhipin.com")
+      );
+      if (bossTab) {
+        return buildBossPageState({
+          ok: false,
+          state: "LOGIN_REQUIRED",
+          path: bossTab.url,
+          current_url: bossTab.url,
+          title: bossTab.title || null,
+          requires_login: true,
+          expected_url: expectedUrl,
+          message: "Boss 页面没有停留在 search 页面，通常表示需要重新登录。请用户手动登录 Boss 后再继续。"
+        });
+      }
+    } catch (error) {
+      lastError = error;
+    }
+
+    await sleep(pollMs);
+  }
+
+  if (lastError) {
+    return buildBossPageState({
+      ok: false,
+      state: "DEBUG_PORT_UNREACHABLE",
+      path: `http://127.0.0.1:${port}`,
+      current_url: null,
+      title: null,
+      requires_login: false,
+      expected_url: expectedUrl,
+      message: `无法连接到 Chrome DevTools 端口 ${port}。请确认 Chrome 已以远程调试模式启动。`,
+      error: lastError.message
+    });
+  }
+
+  return buildBossPageState({
+    ok: false,
+    state: "BOSS_TAB_NOT_FOUND",
+    path: expectedUrl,
+    current_url: null,
+    title: null,
+    requires_login: false,
+    expected_url: expectedUrl,
+    message: "未检测到 Boss 页面标签页。请确认 Chrome 已打开 Boss 搜索页。",
+    sample_urls: lastTabs
+      .map((tab) => tab?.url)
+      .filter(Boolean)
+      .slice(0, 5)
+  });
+}
+
 function hasModule(moduleName) {
   try {
     require.resolve(moduleName);
@@ -120,9 +295,10 @@ function ensureUserConfig() {
   return { path: targetPath, created: false };
 }
 
-function printDoctor(options) {
+async function printDoctor(options) {
   const port = getDebugPort(options);
   const checks = runPipelinePreflight(process.cwd()).checks.slice();
+  const pageState = await inspectBossPageState(port, { timeoutMs: 2000, pollMs: 500 });
   const userConfigPath = getUserConfigPath();
   checks.push({
     key: "user_config",
@@ -150,10 +326,14 @@ function printDoctor(options) {
   });
   checks.push({
     key: "chrome_debug_port",
-    ok: true,
+    ok: pageState.state !== "DEBUG_PORT_UNREACHABLE",
     path: `http://localhost:${port}`,
-    message: `建议使用 Chrome 调试端口 ${port}`
+    message:
+      pageState.state === "DEBUG_PORT_UNREACHABLE"
+        ? `无法连接 Chrome 调试端口 ${port}`
+        : `Chrome 调试端口 ${port} 可连接`
   });
+  checks.push(pageState);
   console.log(JSON.stringify({ ok: checks.every((item) => item.ok), port, checks }, null, 2));
 }
 
@@ -176,7 +356,7 @@ async function calibrate(options) {
   process.exitCode = code;
 }
 
-function launchChrome(options) {
+async function launchChrome(options) {
   const chromePath = getChromeExecutable();
   if (!chromePath) {
     console.error("Chrome executable not found. Set BOSS_RECRUIT_CHROME_PATH or install Google Chrome.");
@@ -184,8 +364,10 @@ function launchChrome(options) {
     return;
   }
   const port = getDebugPort(options);
+  const userDataDir = getChromeUserDataDir(port, options);
   const args = [
     `--remote-debugging-port=${port}`,
+    `--user-data-dir=${userDataDir}`,
     "--new-window",
     bossUrl
   ];
@@ -196,7 +378,27 @@ function launchChrome(options) {
   });
   child.unref();
   console.log(`Chrome launched with remote debugging port ${port}`);
+  console.log(`User data dir: ${userDataDir}`);
   console.log(`URL: ${bossUrl}`);
+
+  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;
+  }
+
+  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;
+  }
+
+  console.log(pageState.message);
+  if (pageState.current_url) {
+    console.log(`Current URL: ${pageState.current_url}`);
+  }
 }
 
 function printHelp() {
@@ -205,13 +407,18 @@ function printHelp() {
   console.log("Usage:");
   console.log("  boss-recruit-mcp              Start the MCP server");
   console.log("  boss-recruit-mcp start        Start the MCP server");
+  console.log("  boss-recruit-mcp run          Run the pipeline once via CLI and print JSON");
   console.log("  boss-recruit-mcp install      Install Codex skill and initialize user config");
   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 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 and open Boss search");
+  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 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]");
 }
 
 function printPaths() {
@@ -239,11 +446,27 @@ function installAll() {
   console.log("1. Fill in baseUrl/apiKey/model in the config file above.");
   console.log("2. Choose a Chrome remote-debugging port (9222 is recommended, but you can reuse an existing port).");
   console.log("3. Run `boss-recruit-mcp doctor --port <your-port>` to verify config, calibration, and runtime prerequisites.");
-  console.log("4. Run `boss-recruit-mcp launch-chrome --port <your-port>` and log in to Boss if needed.");
+  console.log("4. Run `boss-recruit-mcp launch-chrome --port <your-port>`; if it reports the page redirected away from search, log in to Boss manually in that Chrome window.");
   console.log("5. Run `boss-recruit-mcp calibrate --port <your-port>` to generate favorite-calibration.json for this environment.");
   console.log("6. Run `boss-recruit-mcp start` or configure your MCP client to launch `boss-recruit-mcp`.");
 }
 
+async function runPipelineOnce(options) {
+  const instruction = getRunInstruction(options);
+  const confirmation = getRunConfirmation(options);
+  const overrides = getRunOverrides(options);
+  const workspaceRoot = getWorkspaceRoot(options);
+
+  const result = await runRecruitPipeline({
+    workspaceRoot,
+    instruction,
+    confirmation,
+    overrides
+  });
+
+  printJson(result);
+}
+
 const command = process.argv[2] || "start";
 const options = parseOptions(process.argv.slice(3));
 
@@ -251,6 +474,21 @@ switch (command) {
   case "start":
     startServer();
     break;
+  case "run":
+    try {
+      await runPipelineOnce(options);
+    } catch (error) {
+      printJson({
+        status: "FAILED",
+        error: {
+          code: "INVALID_CLI_INPUT",
+          message: error.message || "Invalid CLI input",
+          retryable: false
+        }
+      });
+      process.exitCode = 1;
+    }
+    break;
   case "install":
     installAll();
     break;
@@ -267,13 +505,13 @@ switch (command) {
     break;
   }
   case "doctor":
-    printDoctor(options);
+    await printDoctor(options);
     break;
   case "calibrate":
     await calibrate(options);
     break;
   case "launch-chrome":
-    launchChrome(options);
+    await launchChrome(options);
     break;
   case "where":
     printPaths();

package/src/parser.js

@@ -39,6 +39,9 @@ function normalizeSchoolLabel(value) {
   }
 
   const compact = raw.toLowerCase().replace(/\s+/g, "");
+  if (/^qs\d+$/.test(compact)) {
+    return SEARCH_SCHOOL_MAP.qs100;
+  }
   return SEARCH_SCHOOL_MAP[compact] || SEARCH_SCHOOL_MAP[raw] || raw;
 }
 
@@ -88,7 +91,7 @@ function extractSchools(text) {
   const schools = [];
   if (/(^|[^0-9])985([^0-9]|$)/.test(text)) schools.push(SEARCH_SCHOOL_MAP["985"]);
   if (/(^|[^0-9])211([^0-9]|$)/.test(text)) schools.push(SEARCH_SCHOOL_MAP["211"]);
-  if (/(qs\s*100|QS\s*100|qs100|QS100)/.test(text)) schools.push(SEARCH_SCHOOL_MAP["qs100"]);
+  if (/\bqs\s*\d+\b/i.test(text)) schools.push(SEARCH_SCHOOL_MAP["qs100"]);
   return uniqueList(schools);
 }
 
@@ -183,7 +186,7 @@ function buildScreenCriteria(text, searchParams) {
     if (/搜索关键词|关键词|keyword/i.test(clause)) return false;
     if (/地点|城市/.test(clause)) return false;
     if (/学历|本科|硕士|博士/.test(clause) && !/论文|项目|经验/.test(clause)) return false;
-    if (/985|211|qs\s*100|QS\s*100|院校/.test(clause) && !/论文|经验|项目/.test(clause)) return false;
+    if (/985|211|qs\s*\d+|院校/i.test(clause) && !/论文|经验|项目/.test(clause)) return false;
     if (/至少筛选|目标人数|目标数量|筛选\d+位/.test(clause)) return false;
     return true;
   });

package/src/test-parser.js

@@ -86,6 +86,34 @@ function testStructuredInputAndCriteriaCleanup() {
   );
 }
 
+function testQsVariantsNormalizeToQs100() {
+  const byInstruction = parseRecruitInstruction({
+    instruction: "帮我找做过推荐系统的人，城市杭州，学历本科，学校要求 qs50、985，目标人数 20 人",
+    confirmation: {
+      keyword_confirmed: true,
+      keyword_value: "推荐系统",
+      search_params_confirmed: true
+    },
+    overrides: null
+  });
+
+  assert.deepEqual(byInstruction.searchParams.schools.sort(), ["985院校", "QS 100"].sort());
+
+  const byOverride = parseRecruitInstruction({
+    instruction: "帮我找做过推荐系统的人，城市杭州，学历本科，目标人数 20 人",
+    confirmation: {
+      keyword_confirmed: true,
+      keyword_value: "推荐系统",
+      search_params_confirmed: true
+    },
+    overrides: {
+      schools: ["qs50", "qs500", "211"]
+    }
+  });
+
+  assert.deepEqual(byOverride.searchParams.schools.sort(), ["211院校", "QS 100"].sort());
+}
+
 function testCitySanitizationAndConfirmationGate() {
   const r = parseRecruitInstruction({
     instruction:
@@ -128,6 +156,7 @@ function main() {
   testExampleExtraction();
   testMissingFieldsBatch();
   testStructuredInputAndCriteriaCleanup();
+  testQsVariantsNormalizeToQs100();
   testCitySanitizationAndConfirmationGate();
   testDefaultsCanOnlyApplyWhenExplicitlyRequested();
   // eslint-disable-next-line no-console