@reconcrap/boss-recruit-mcp 1.0.4 → 1.0.5

package/README.md

@@ -84,6 +84,7 @@ boss-recruit-mcp launch-chrome --port <port>
 ```
 
 `launch-chrome` 会自动为该端口创建独立的 Chrome profile 目录，避免复用已有 Chrome 实例导致调试端口未生效。
+命令还会检查新打开的 Boss 页面是否仍停留在 `search` 页面；如果跳转到了登录页或其他页面，说明需要用户先手动登录 Boss。
 
 然后执行校准：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recruit-mcp",
-  "version": "1.0.4",
+  "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

@@ -27,6 +27,7 @@ npx @reconcrap/boss-recruit-mcp install
 - 正式开始前，必须先做一轮参数确认，分开展示已识别参数、待确认参数、缺失参数。
 - 参数确认尽量复用统一模板：`已识别参数` / `待确认或待修正` / `缺失参数` / `默认值提醒` / `请用户回复`。
 - 端口未确认时，必须先询问用户是否使用推荐的 `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
 
@@ -124,6 +128,7 @@
    - 若 MCP 不可用，CLI fallback 是否可用
    - Chrome 调试端口是否已确认
    - Chrome 是否已启动到 Boss 搜索页面
+   - 如果刚启动了新的 Chrome 实例，是否仍停留在 Boss search 页面而未跳转登录
    - `favorite-calibration.json` 是否存在
 2. 若缺少依赖或 MCP 未启动：
    - 自动安装依赖并帮助用户启动 MCP；
@@ -135,7 +140,12 @@
    - 明确给出校准步骤与命令；
    - 明确指出期望生成到哪个路径；
    - 不要在本机搜索并复用其他 `favorite-calibration.json`。
-4. 只有当以上条件满足时，才首次进入流水线解析：
+4. 若 `launch-chrome` 后发现页面没有停留在 search，而是跳到了登录页、首页或其他页面：
+   - 明确告诉用户“当前需要手动登录 Boss”；
+   - 明确要求用户在新打开的 Chrome 窗口中完成登录；
+   - 等用户回复“已登录，可以继续”后，再继续下一步；
+   - 不要在用户未确认登录完成前直接执行搜索、校准或流水线。
+5. 只有当以上条件满足时，才首次进入流水线解析：
    - 若 MCP 可用，调用 `run_recruit_pipeline`（只传 `instruction`）
    - 若 MCP 不可用，调用 `boss-recruit-mcp run --instruction ...`
    - 这一步用于“解析”，不是立刻执行最终搜索结论。
@@ -246,6 +256,7 @@
 - 如果工具返回 `output_csv`，在摘要里给出路径，避免重复解释内部流程。
 - 如果端口还没确认，必须先问用户“是否使用推荐的 `9222`，还是你已经有别的远程调试端口”，不能直接把 `9222` 当成已确认值。
 - 如果需要打开 Chrome，优先帮用户执行而不是只给命令。
+- 如果新打开的 Chrome 页面跳离了 search 页面，必须判断为“需要登录”，提示用户手动登录后再继续。
 
 ## Example
 
@@ -273,5 +284,6 @@
 - 端口未确认时，用“推荐值 + 可选其他端口”的话术，不要直接替用户决定。
 - 校准缺失时，直接指导用户重新校准，不要建议复制或复用任何历史 calibration 文件。
 - 若当前 agent 受 MCP 数量限制，明确告诉用户“本轮改走 CLI fallback”，但用户体验上仍保持同一套确认和状态输出。
+- 新开 Chrome 后若检测到跳转登录，先提示用户手动登录并等待确认，再继续。
 - 若要使用默认值，必须写明“请确认是否按默认值继续”，不能模糊带过。
 - 若运行失败，优先给用户“现在卡在哪一步 + 怎么继续”。

package/src/cli.js

@@ -135,6 +135,106 @@ 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);
@@ -195,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",
@@ -225,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));
 }
 
@@ -251,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.");
@@ -275,6 +380,25 @@ function launchChrome(options) {
   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() {
@@ -289,7 +413,7 @@ function printHelp() {
   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:");
@@ -322,7 +446,7 @@ 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`.");
 }
@@ -381,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();