@reconcrap/boss-recommend-mcp 1.0.7 → 1.0.8

package/package.json

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

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

@@ -27,6 +27,7 @@ description: "Use when users ask to run Boss recommend-page filtering and screen
 - 当用户请求中出现 “recommend / 推荐页 / boss recommend / recommend page” 语义时，只能走 `boss-recommend-pipeline`
 - 当用户请求中出现 “search / 搜索页 / boss search / search page” 语义时，不能走本技能，必须转交 `boss-recruit-pipeline` 并调用 `run_recruit_pipeline`
 - 不要调用 `boss-recruit-pipeline`，也不要调用 `run_recruit_pipeline`，除非上一条（search/搜索页语义）命中
+- 当 recommend 流程返回任何错误（包括 `JOB_TRIGGER_NOT_FOUND` / `NO_RECOMMEND_IFRAME` / `BOSS_LOGIN_REQUIRED`）时，禁止把 recommend 请求降级到 recruit 流程；必须先修复 recommend 的页面就绪或登录态问题
 
 路由示例（中英文都要兼容）：
 

package/src/pipeline.js

@@ -534,6 +534,54 @@ export async function runRecommendPipeline(
     port: preflight.debug_port
   });
   if (!jobListResult.ok) {
+    const jobListErrorCode = String(jobListResult.error?.code || "");
+    const jobListErrorMessage = String(jobListResult.error?.message || "");
+    const pageReadinessFailure = (
+      jobListErrorCode === "JOB_TRIGGER_NOT_FOUND"
+      || jobListErrorCode === "NO_RECOMMEND_IFRAME"
+      || jobListErrorCode === "LOGIN_REQUIRED"
+      || jobListErrorMessage.includes("JOB_TRIGGER_NOT_FOUND")
+      || jobListErrorMessage.includes("NO_RECOMMEND_IFRAME")
+      || jobListErrorMessage.includes("LOGIN_REQUIRED")
+    );
+    if (pageReadinessFailure) {
+      const recheck = await ensureRecommendPageReady(workspaceRoot, {
+        port: preflight.debug_port
+      });
+      const loginRelated = new Set(["LOGIN_REQUIRED", "LOGIN_REQUIRED_AFTER_REDIRECT"]);
+      const connectivityRelated = new Set(["DEBUG_PORT_UNREACHABLE"]);
+      const guidance = buildChromeSetupGuidance({
+        debugPort: preflight.debug_port,
+        pageState: recheck.page_state
+      });
+      if (!recheck.ok || loginRelated.has(recheck.state) || connectivityRelated.has(recheck.state)) {
+        return buildFailedResponse(
+          connectivityRelated.has(recheck.state)
+            ? "BOSS_CHROME_NOT_CONNECTED"
+            : loginRelated.has(recheck.state)
+              ? "BOSS_LOGIN_REQUIRED"
+              : "BOSS_RECOMMEND_PAGE_NOT_READY",
+          loginRelated.has(recheck.state)
+            ? `检测到当前 Boss 处于未登录状态，请先登录后再继续。登录页：https://www.zhipin.com/web/user/?ka=bticket`
+            : connectivityRelated.has(recheck.state)
+              ? `读取岗位列表前需要先连接到端口 ${preflight.debug_port} 的 Chrome 远程调试实例。`
+              : `读取岗位列表前，请先在端口 ${preflight.debug_port} 的 Chrome 停留在 Boss recommend 页面。`,
+          {
+            search_params: parsed.searchParams,
+            screen_params: parsed.screenParams,
+            required_user_action: "prepare_boss_recommend_page",
+            guidance,
+            diagnostics: {
+              debug_port: preflight.debug_port,
+              page_state: recheck.page_state,
+              stdout: jobListResult.stdout?.slice(-1000),
+              stderr: jobListResult.stderr?.slice(-1000),
+              result: jobListResult.structured || null
+            }
+          }
+        );
+      }
+    }
     return buildFailedResponse(
       jobListResult.error?.code || "RECOMMEND_JOB_LIST_FAILED",
       jobListResult.error?.message || "读取推荐岗位列表失败，无法开始筛选。",

package/src/test-pipeline.js

@@ -344,6 +344,50 @@ async function testSearchNoIframeWithLoginShouldReturnLoginRequired() {
   assert.equal(result.guidance.agent_prompt.includes("https://www.zhipin.com/web/user/?ka=bticket"), true);
 }
 
+async function testJobTriggerNotFoundShouldMapToLoginRequiredWhenRecheckShowsLogin() {
+  const result = await runRecommendPipeline(
+    {
+      workspaceRoot: process.cwd(),
+      instruction: "test",
+      confirmation: {},
+      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 () => ({
+        ok: false,
+        stdout: "",
+        stderr: "",
+        structured: null,
+        jobs: [],
+        error: {
+          code: "JOB_TRIGGER_NOT_FOUND",
+          message: "JOB_TRIGGER_NOT_FOUND"
+        }
+      }),
+      runRecommendSearchCli: async () => ({ ok: true, summary: {} }),
+      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(
     {
@@ -721,6 +765,7 @@ async function main() {
   await testCompletedPipeline();
   await testSearchFailure();
   await testSearchNoIframeWithLoginShouldReturnLoginRequired();
+  await testJobTriggerNotFoundShouldMapToLoginRequiredWhenRecheckShowsLogin();
   await testLoginRequiredShouldReturnGuidance();
   await testDebugPortUnreachableShouldReturnConnectionCode();
   await testPreflightRecoveryPlanOrder();