@reconcrap/boss-recommend-mcp 1.0.6 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",

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

@@ -155,6 +155,7 @@ CLI fallback 的状态机与 MCP 保持一致：
 - 检查 Chrome DevTools 端口是否可连接
 - 检查 Boss 是否已登录
 - 检查当前页面是否已停留在 recommend 页面
+- 若检测到当前 URL 为 `https://www.zhipin.com/web/user/?ka=bticket`（或同类登录页 URL），立即判定为“未登录”，只提示用户登录；不要继续做页面脚本修改
 - 若端口不可连接：先自动尝试启动 Chrome，并且必须使用 `--remote-debugging-port=<port>` + `--user-data-dir=<profile>`
 - 若检测到 Boss 已登录但不在 recommend 页面：先自动 navigate 到 `https://www.zhipin.com/web/chat/recommend`
 - 若检测到 Boss 未登录：提示用户先登录；用户登录后先 navigate 到 recommend 页面再继续
@@ -196,5 +197,6 @@ CLI fallback 的状态机与 MCP 保持一致：
 - 对 `school_tag/degree/gender/recent_not_view` 必须逐项提问并逐项确认，不可合并成一句“filters已确认”
 - 询问 `criteria` 时必须使用开放式文本输入，不要提供“严格执行/宽松执行”等枚举选项
 - 当页面就绪检查失败时，提示文案里必须包含 `debug_port` 和 recommend 页面 URL
+- 若失败原因是未登录，提示文案必须明确给出登录 URL：`https://www.zhipin.com/web/user/?ka=bticket`
 - 不要跳过 `post_action` 的首轮确认
 - 不要把 recommend 流程说成 search 流程

package/src/pipeline.js

@@ -629,9 +629,46 @@ export async function runRecommendPipeline(
     selectedJob: selectedJobToken
   });
   if (!searchResult.ok) {
+    const searchErrorCode = String(searchResult.error?.code || "");
+    const searchErrorMessage = String(searchResult.error?.message || "");
+    const loginRelatedSearchFailure = (
+      searchErrorCode === "LOGIN_REQUIRED"
+      || searchErrorCode === "NO_RECOMMEND_IFRAME"
+      || searchErrorMessage.includes("LOGIN_REQUIRED")
+      || searchErrorMessage.includes("NO_RECOMMEND_IFRAME")
+    );
+    if (loginRelatedSearchFailure) {
+      const recheck = await ensureRecommendPageReady(workspaceRoot, {
+        port: preflight.debug_port
+      });
+      if (recheck.state === "LOGIN_REQUIRED" || recheck.state === "LOGIN_REQUIRED_AFTER_REDIRECT") {
+        const guidance = buildChromeSetupGuidance({
+          debugPort: preflight.debug_port,
+          pageState: recheck.page_state
+        });
+        return buildFailedResponse(
+          "BOSS_LOGIN_REQUIRED",
+          "检测到当前 Boss 处于未登录状态，请先登录后再继续。登录页：https://www.zhipin.com/web/user/?ka=bticket",
+          {
+            search_params: parsed.searchParams,
+            screen_params: parsed.screenParams,
+            selected_job: selectedJob,
+            required_user_action: "prepare_boss_recommend_page",
+            guidance,
+            diagnostics: {
+              debug_port: preflight.debug_port,
+              page_state: recheck.page_state,
+              stdout: searchResult.stdout?.slice(-1000),
+              stderr: searchResult.stderr?.slice(-1000),
+              result: searchResult.structured || null
+            }
+          }
+        );
+      }
+    }
     return buildFailedResponse(
-      searchResult.error?.code || "RECOMMEND_SEARCH_FAILED",
-      searchResult.error?.message || "推荐页筛选执行失败。",
+      searchResult.error?.code || "RECOMMEND_SEARCH_FAILED",
+      searchResult.error?.message || "推荐页筛选执行失败。",
       {
         search_params: parsed.searchParams,
         screen_params: parsed.screenParams,

package/src/test-pipeline.js

@@ -301,6 +301,49 @@ async function testSearchFailure() {
   assert.equal(result.error.code, "RECOMMEND_FILTER_PANEL_UNAVAILABLE");
 }
 
+async function testSearchNoIframeWithLoginShouldReturnLoginRequired() {
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: createJobConfirmedConfirmation(),
+      overrides: {}
+    },
+    {
+      parseRecommendInstruction: () => createParsed(),
+      runPipelinePreflight: () => ({ ok: true, checks: [], debug_port: 9222 }),
+      ensureBossRecommendPageReady: async () => ({
+        ok: false,
+        debug_port: 9222,
+        state: "LOGIN_REQUIRED",
+        page_state: {
+          state: "LOGIN_REQUIRED",
+          expected_url: "https://www.zhipin.com/web/chat/recommend",
+          current_url: "https://www.zhipin.com/web/user/?ka=bticket",
+          login_url: "https://www.zhipin.com/web/user/?ka=bticket"
+        }
+      }),
+      listRecommendJobs: async () => createJobListResult(),
+      runRecommendSearchCli: async () => ({
+        ok: false,
+        stdout: "",
+        stderr: "NO_RECOMMEND_IFRAME",
+        structured: null,
+        error: {
+          code: "NO_RECOMMEND_IFRAME",
+          message: "NO_RECOMMEND_IFRAME"
+        }
+      }),
+      runRecommendScreenCli: async () => ({ ok: true, summary: {} })
+    }
+  );
+
+  assert.equal(result.status, "FAILED");
+  assert.equal(result.error.code, "BOSS_LOGIN_REQUIRED");
+  assert.equal(result.required_user_action, "prepare_boss_recommend_page");
+  assert.equal(result.guidance.agent_prompt.includes("https://www.zhipin.com/web/user/?ka=bticket"), true);
+}
+
 async function testNeedJobConfirmationGate() {
   const result = await runRecommendPipeline(
     {
@@ -677,6 +720,7 @@ async function main() {
   await testNeedFinalReviewConfirmationGate();
   await testCompletedPipeline();
   await testSearchFailure();
+  await testSearchNoIframeWithLoginShouldReturnLoginRequired();
   await testLoginRequiredShouldReturnGuidance();
   await testDebugPortUnreachableShouldReturnConnectionCode();
   await testPreflightRecoveryPlanOrder();

package/vendor/boss-recommend-search-cli/src/cli.js

@@ -4,9 +4,12 @@ import readline from "node:readline";
 import { pathToFileURL } from "node:url";
 import CDP from "chrome-remote-interface";
 
-const DEFAULT_PORT = 9222;
-const RECOMMEND_URL_FRAGMENT = "/web/chat/recommend";
-const SCHOOL_TAG_OPTIONS = ["不限", "985", "211", "双一流院校", "留学", "国内外名校", "公办本科"];
+const DEFAULT_PORT = 9222;
+const RECOMMEND_URL_FRAGMENT = "/web/chat/recommend";
+const BOSS_LOGIN_URL = "https://www.zhipin.com/web/user/?ka=bticket";
+const BOSS_LOGIN_URL_PATTERN = /(?:zhipin\.com\/web\/user(?:\/|\?|$)|passport\.zhipin\.com)/i;
+const BOSS_LOGIN_TITLE_PATTERN = /登录|signin|扫码登录|BOSS直聘登录/i;
+const SCHOOL_TAG_OPTIONS = ["不限", "985", "211", "双一流院校", "留学", "国内外名校", "公办本科"];
 const DEGREE_OPTIONS = ["不限", "初中及以下", "中专/中技", "高中", "大专", "本科", "硕士", "博士"];
 const DEGREE_ORDER = ["初中及以下", "中专/中技", "高中", "大专", "本科", "硕士", "博士"];
 const GENDER_OPTIONS = ["不限", "男", "女"];
@@ -383,21 +386,39 @@ class RecommendSearchCli {
     });
   }
 
-  async getFrameState() {
-    return this.evaluate(`(() => {
-      const frame = document.querySelector('iframe[name="recommendFrame"]')
-        || document.querySelector('iframe[src*="/web/frame/recommend/"]')
-        || document.querySelector('iframe');
-      if (!frame || !frame.contentDocument) {
-        return { ok: false, error: 'NO_RECOMMEND_IFRAME' };
-      }
-      return {
-        ok: true,
-        frameUrl: (() => {
-          try { return String(frame.contentWindow.location.href || ''); } catch { return ''; }
-        })()
-      };
-    })()`);
+  async getFrameState() {
+    return this.evaluate(`(() => {
+      const currentUrl = (() => {
+        try { return String(window.location.href || ''); } catch { return ''; }
+      })();
+      const title = (() => {
+        try { return String(document.title || ''); } catch { return ''; }
+      })();
+      const isLogin = ${BOSS_LOGIN_URL_PATTERN}.test(currentUrl)
+        || ${BOSS_LOGIN_TITLE_PATTERN}.test(title);
+      if (isLogin) {
+        return {
+          ok: false,
+          error: 'LOGIN_REQUIRED',
+          currentUrl: currentUrl || ${JSON.stringify(BOSS_LOGIN_URL)},
+          title
+        };
+      }
+      const frame = document.querySelector('iframe[name="recommendFrame"]')
+        || document.querySelector('iframe[src*="/web/frame/recommend/"]')
+        || document.querySelector('iframe');
+      if (!frame || !frame.contentDocument) {
+        return { ok: false, error: 'NO_RECOMMEND_IFRAME', currentUrl, title };
+      }
+      return {
+        ok: true,
+        currentUrl,
+        title,
+        frameUrl: (() => {
+          try { return String(frame.contentWindow.location.href || ''); } catch { return ''; }
+        })()
+      };
+    })()`);
   }
 
   async getFilterEntryPoint() {
@@ -1467,6 +1488,9 @@ class RecommendSearchCli {
     try {
       const frameState = await this.getFrameState();
       if (!frameState?.ok) {
+        if (frameState?.error === "LOGIN_REQUIRED") {
+          throw new Error("LOGIN_REQUIRED");
+        }
         throw new Error(frameState?.error || 'NO_RECOMMEND_IFRAME');
       }