@reconcrap/boss-recommend-mcp 0.1.9 → 0.1.10

package/README.md

@@ -20,6 +20,7 @@ MCP 工具名：`run_recommend_pipeline`
 
 - 页面目标固定为 `https://www.zhipin.com/web/chat/recommend`
 - 支持推荐页原生筛选：学校标签 / 学历 / 性别 / 近14天没有
+- 学校标签支持多选语义：如“985、211”会同时勾选这两项
 - 学历支持单选与多选语义：如“本科及以上”会展开为 `本科/硕士/博士`；如“大专、本科”只勾选这两项
 - 执行前会逐项确认筛选参数：学校标签 / 学历 / 性别 / 是否过滤近14天已看
 - npm 全局安装后会自动执行 install：生成 skill、导出 MCP 模板，并自动尝试写入已检测到的外部 agent MCP 配置（含 Trae / trae-cn / Cursor / Claude / OpenClaw）
@@ -72,9 +73,10 @@ node src/cli.js run --instruction "推荐页筛选985男生，近14天没有，
 配置路径优先级：
 
 1. `BOSS_RECOMMEND_SCREEN_CONFIG`
-2. `<workspace>/boss-recommend-mcp/config/screening-config.json`
-3. `~/.boss-recommend-mcp/screening-config.json`
-4. 兼容旧路径：`$CODEX_HOME/boss-recommend-mcp/screening-config.json`
+2. `<workspace>/config/screening-config.json`
+3. `<workspace>/boss-recommend-mcp/config/screening-config.json`
+4. `~/.boss-recommend-mcp/screening-config.json`（若可写）
+5. 兼容旧路径：`$CODEX_HOME/boss-recommend-mcp/screening-config.json`
 
 注意：
 
@@ -132,7 +134,7 @@ node src/cli.js run --instruction-file request.txt --confirmation-file confirmat
     "max_greet_count_value": 10
   },
   "overrides": {
-    "school_tag": "211",
+    "school_tag": ["985", "211"],
     "degree": ["本科", "硕士", "博士"],
     "gender": "女",
     "recent_not_view": "近14天没有",

package/package.json

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

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

@@ -35,7 +35,7 @@ description: "Use when users ask to run Boss recommend-page filtering and screen
 
 在真正执行前，必须先确认：
 
-- 学校标签（`school_tag`）
+- 学校标签（`school_tag`，支持多选）
 - 学历（`degree`）
 - 性别（`gender`）
 - 是否过滤近14天已看（`recent_not_view`）
@@ -72,7 +72,7 @@ description: "Use when users ask to run Boss recommend-page filtering and screen
     - `max_greet_count_confirmed`
     - `max_greet_count_value` (integer)
   - `overrides`
-    - `school_tag`
+  - `school_tag`（可传单值或数组，如 `["985","211"]`）
     - `degree`（可传单值或数组；如“本科及以上”应展开为 `["本科","硕士","博士"]`）
     - `gender`
     - `recent_not_view`

package/src/adapters.js

@@ -7,8 +7,10 @@ import { fileURLToPath } from "node:url";
 const currentFilePath = fileURLToPath(import.meta.url);
 const packagedMcpDir = path.resolve(path.dirname(currentFilePath), "..");
 const bossRecommendUrl = "https://www.zhipin.com/web/chat/recommend";
+const bossLoginUrl = "https://www.zhipin.com/web/user/?ka=bticket";
 const chromeOnboardingUrlPattern = /^chrome:\/\/(welcome|intro|newtab|signin|history-sync|settings\/syncSetup)/i;
-const bossLoginUrlPattern = /zhipin\.com\/web\/user|passport\.zhipin\.com/i;
+const bossLoginUrlPattern = /(?:zhipin\.com\/web\/user(?:\/|\?|$)|passport\.zhipin\.com)/i;
+const bossLoginTitlePattern = /登录|signin|扫码登录|BOSS直聘登录/i;
 const screenConfigTemplateDefaults = {
   baseUrl: "https://api.openai.com/v1",
   apiKey: "replace-with-openai-api-key",
@@ -76,6 +78,33 @@ function serializeDegreeSelection(value) {
   return normalized || "不限";
 }
 
+function serializeSchoolTagSelection(value) {
+  if (Array.isArray(value)) {
+    const normalized = value.map((item) => String(item || "").trim()).filter(Boolean);
+    if (!normalized.length) return "不限";
+    if (normalized.includes("不限")) {
+      return normalized.length === 1
+        ? "不限"
+        : normalized.filter((item) => item !== "不限").join(",");
+    }
+    return normalized.join(",");
+  }
+  const normalized = String(value || "").trim();
+  return normalized || "不限";
+}
+
+function canWriteConfigPath(filePath) {
+  if (!filePath) return false;
+  try {
+    const dirPath = path.dirname(filePath);
+    ensureDir(dirPath);
+    fs.accessSync(dirPath, fs.constants.W_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function buildScreenConfigCandidateMap(workspaceRoot) {
   return {
     env_path: process.env.BOSS_RECOMMEND_SCREEN_CONFIG
@@ -106,6 +135,13 @@ function resolveScreenConfigPath(workspaceRoot) {
   if (existingWorkspacePath) {
     return existingWorkspacePath;
   }
+  if (canWriteConfigPath(candidateMap.user_path)) {
+    return candidateMap.user_path;
+  }
+  const writableWorkspacePath = candidateMap.workspace_paths.find((item) => canWriteConfigPath(item));
+  if (writableWorkspacePath) {
+    return writableWorkspacePath;
+  }
   // 默认固定写入/读取 Agent 无关路径，避免意外落到 .codex 旧路径。
   if (candidateMap.user_path) {
     return candidateMap.user_path;
@@ -782,6 +818,16 @@ function findChromeOnboardingUrl(tabs) {
   return null;
 }
 
+function isBossLoginTab(tab) {
+  const url = String(tab?.url || "");
+  const title = String(tab?.title || "");
+  return (
+    url === bossLoginUrl
+    || bossLoginUrlPattern.test(url)
+    || bossLoginTitlePattern.test(title)
+  );
+}
+
 export async function inspectBossRecommendPageState(port, options = {}) {
   const timeoutMs = Number.isFinite(options.timeoutMs) ? options.timeoutMs : 6000;
   const pollMs = Number.isFinite(options.pollMs) ? options.pollMs : 1000;
@@ -809,6 +855,21 @@ export async function inspectBossRecommendPageState(port, options = {}) {
         });
       }
 
+      const loginTab = tabs.find((tab) => isBossLoginTab(tab));
+      if (loginTab) {
+        return buildBossPageState({
+          ok: false,
+          state: "LOGIN_REQUIRED",
+          path: loginTab.url || bossLoginUrl,
+          current_url: loginTab.url || bossLoginUrl,
+          title: loginTab.title || null,
+          requires_login: true,
+          expected_url: expectedUrl,
+          login_url: bossLoginUrl,
+          message: "Boss 页面未登录，需先完成登录后再进入 recommend 页面。"
+        });
+      }
+
       const bossTab = tabs.find(
         (tab) => typeof tab?.url === "string" && tab.url.includes("zhipin.com")
       );
@@ -946,6 +1007,17 @@ export async function ensureBossRecommendPageReady(workspaceRoot, options = {})
   }
 
   let launchAttempt = null;
+  if (pageState.state === "LOGIN_REQUIRED" || pageState.state === "LOGIN_REQUIRED_AFTER_REDIRECT") {
+    return {
+      ok: false,
+      debug_port: debugPort,
+      state: pageState.state,
+      page_state: {
+        ...pageState,
+        launch_attempt: launchAttempt
+      }
+    };
+  }
   if (pageState.state === "DEBUG_PORT_UNREACHABLE") {
     launchAttempt = launchChromeWithDebugPort(debugPort);
     if (launchAttempt.ok) {
@@ -954,6 +1026,17 @@ export async function ensureBossRecommendPageReady(workspaceRoot, options = {})
         timeoutMs: inspectTimeoutMs,
         pollMs
       });
+      if (pageState.state === "LOGIN_REQUIRED" || pageState.state === "LOGIN_REQUIRED_AFTER_REDIRECT") {
+        return {
+          ok: false,
+          debug_port: debugPort,
+          state: pageState.state,
+          page_state: {
+            ...pageState,
+            launch_attempt: launchAttempt
+          }
+        };
+      }
       if (pageState.state === "RECOMMEND_READY") {
         const stableState = await verifyRecommendPageStable(debugPort, { settleMs, pollMs });
         return {
@@ -980,7 +1063,11 @@ export async function ensureBossRecommendPageReady(workspaceRoot, options = {})
   }
 
   for (let attempt = 1; attempt <= attempts; attempt += 1) {
-    if (pageState.state === "DEBUG_PORT_UNREACHABLE") {
+    if (
+      pageState.state === "DEBUG_PORT_UNREACHABLE"
+      || pageState.state === "LOGIN_REQUIRED"
+      || pageState.state === "LOGIN_REQUIRED_AFTER_REDIRECT"
+    ) {
       break;
     }
     await openBossRecommendTab(debugPort);
@@ -1031,7 +1118,7 @@ export async function runRecommendSearchCli({ workspaceRoot, searchParams }) {
   const args = [
     cliPath,
     "--school-tag",
-    searchParams.school_tag,
+    serializeSchoolTagSelection(searchParams.school_tag),
     "--degree",
     serializeDegreeSelection(searchParams.degree),
     "--gender",
@@ -1047,14 +1134,20 @@ export async function runRecommendSearchCli({ workspaceRoot, searchParams }) {
     cwd: searchDir,
     timeoutMs: 180000
   });
-  const structured = parseJsonOutput(result.stdout);
+  const structured = parseJsonOutput(result.stdout) || parseJsonOutput(result.stderr);
+  const missingOutputError = result.code === 0 && !structured
+    ? {
+        code: "RECOMMEND_SEARCH_NO_OUTPUT",
+        message: "推荐页筛选命令执行结束但未返回可解析结果。"
+      }
+    : null;
   return {
     ok: result.code === 0 && structured?.status === "COMPLETED",
     stdout: result.stdout,
     stderr: result.stderr,
     structured,
     summary: structured?.result || null,
-    error: structured?.error || (
+    error: structured?.error || missingOutputError || (
       result.code === 0
         ? null
         : {
@@ -1146,14 +1239,20 @@ export async function runRecommendScreenCli({ workspaceRoot, screenParams }) {
     cwd: screenDir,
     timeoutMs: 60 * 60 * 1000
   });
-  const structured = parseJsonOutput(result.stdout);
+  const structured = parseJsonOutput(result.stdout) || parseJsonOutput(result.stderr);
+  const missingOutputError = result.code === 0 && !structured
+    ? {
+        code: "RECOMMEND_SCREEN_NO_OUTPUT",
+        message: "推荐页筛选命令执行结束但未返回可解析结果。"
+      }
+    : null;
   return {
     ok: result.code === 0 && structured?.status === "COMPLETED",
     stdout: result.stdout,
     stderr: result.stderr,
     structured,
     summary: structured?.result || null,
-    error: structured?.error || (
+    error: structured?.error || missingOutputError || (
       result.code === 0
         ? null
         : {

package/src/cli.js

@@ -687,13 +687,18 @@ async function printDoctor(options = {}) {
   const checks = preflight.checks.slice();
   const configResolution = getScreenConfigResolution(workspaceRoot);
   const pageState = await inspectBossRecommendPageState(port, { timeoutMs: 2000, pollMs: 500 });
-  const userConfigExists = fs.existsSync(configResolution.writable_path) || fs.existsSync(configResolution.legacy_path);
+  const resolvedConfigPath = configResolution.resolved_path || configResolution.writable_path;
+  const userConfigExists = (
+    (resolvedConfigPath && fs.existsSync(resolvedConfigPath))
+    || fs.existsSync(configResolution.writable_path)
+    || fs.existsSync(configResolution.legacy_path)
+  );
   checks.push({
     key: "user_config",
     ok: userConfigExists,
-    path: configResolution.writable_path,
+    path: resolvedConfigPath,
     message: userConfigExists
-      ? "检测到用户配置文件。"
+      ? `检测到配置文件（resolved_path）：${resolvedConfigPath}`
       : "用户配置不存在（可通过 `boss-recommend-mcp init-config` 创建模板，或 `boss-recommend-mcp config set` 写入真实值）"
   });
   checks.push({

package/src/index.js

@@ -72,8 +72,21 @@ function createToolSchema() {
           type: "object",
           properties: {
             school_tag: {
-              type: "string",
-              enum: ["不限", "985", "211", "双一流院校", "留学", "国内外名校", "公办本科"]
+              oneOf: [
+                {
+                  type: "string",
+                  enum: ["不限", "985", "211", "双一流院校", "留学", "国内外名校", "公办本科"]
+                },
+                {
+                  type: "array",
+                  items: {
+                    type: "string",
+                    enum: ["不限", "985", "211", "双一流院校", "留学", "国内外名校", "公办本科"]
+                  },
+                  minItems: 1,
+                  uniqueItems: true
+                }
+              ]
             },
             degree: {
               oneOf: [
@@ -222,9 +235,11 @@ async function handleRequest(message, workspaceRoot) {
 
 export function startServer() {
   const envRoot = process.env.BOSS_WORKSPACE_ROOT;
-  const thisFile = fileURLToPath(import.meta.url);
-  const mcpRoot = path.resolve(path.dirname(thisFile), "..");
-  const workspaceRoot = envRoot ? path.resolve(envRoot) : path.resolve(mcpRoot, "..");
+  const workspaceRoot = envRoot
+    ? path.resolve(envRoot)
+    : process.env.INIT_CWD
+      ? path.resolve(process.env.INIT_CWD)
+      : path.resolve(process.cwd());
   let buffer = Buffer.alloc(0);
   let framing = FRAMING_UNKNOWN;
 

package/src/parser.js

@@ -118,6 +118,44 @@ function normalizeSchoolTag(value) {
   return null;
 }
 
+function sortSchoolTagSelections(values) {
+  const order = new Map(SCHOOL_TAG_OPTIONS.map((item, index) => [item, index]));
+  const unique = Array.from(
+    new Set((values || []).map((item) => normalizeSchoolTag(item)).filter(Boolean))
+  );
+  if (!unique.length) return [];
+  if (unique.includes("不限")) {
+    return unique.length === 1
+      ? ["不限"]
+      : unique.filter((item) => item !== "不限").sort((left, right) => order.get(left) - order.get(right));
+  }
+  return unique.sort((left, right) => order.get(left) - order.get(right));
+}
+
+function normalizeSchoolTagSelections(input) {
+  if (Array.isArray(input)) {
+    const normalized = sortSchoolTagSelections(input);
+    return normalized.length ? normalized : null;
+  }
+
+  const text = normalizeText(input);
+  if (!text) return null;
+  if (text === "不限") return ["不限"];
+  const selected = [];
+  const chunks = text.split(/[，,、/|]/).map((item) => normalizeSchoolTag(item)).filter(Boolean);
+  selected.push(...chunks);
+  for (const label of SCHOOL_TAG_OPTIONS) {
+    if (label === "不限") continue;
+    if (text.includes(label)) {
+      selected.push(label);
+    }
+  }
+  const normalized = sortSchoolTagSelections(selected);
+  if (normalized.length > 0) return normalized;
+  const single = normalizeSchoolTag(text);
+  return single ? [single] : null;
+}
+
 function normalizeDegree(value) {
   const normalized = normalizeText(value);
   if (!normalized) return null;
@@ -386,30 +424,23 @@ function resolveMaxGreetCount({ instruction, confirmation, overrides, postAction
 }
 
 function collectSuspiciousFields({ detectedSchoolTags }) {
-  const suspicious = [];
-  if (detectedSchoolTags.length > 1) {
-    suspicious.push({
-      field: "school_tag",
-      value: detectedSchoolTags,
-      reason: "推荐页学校标签当前是单选，指令里同时提到了多个学校标签，请确认最终要应用哪一个。"
-    });
-  }
-  return suspicious;
+  void detectedSchoolTags;
+  return [];
 }
 
 export function parseRecommendInstruction({ instruction, confirmation, overrides }) {
   const text = normalizeText(instruction);
   const detectedSchoolTags = extractSchoolTags(text);
   const detectedDegrees = extractDegrees(text);
-  const overrideSchoolTag = normalizeSchoolTag(overrides?.school_tag);
+  const overrideSchoolTag = normalizeSchoolTagSelections(overrides?.school_tag);
   const overrideDegrees = normalizeDegreeSelections(overrides?.degree);
   const overrideGender = normalizeGender(overrides?.gender);
   const overrideRecentNotView = normalizeRecentNotView(overrides?.recent_not_view);
   const overrideCriteria = overrides?.criteria;
 
-  const inferredSchoolTag = detectedSchoolTags.length > 1
-    ? "不限"
-    : detectedSchoolTags[0] || "不限";
+  const inferredSchoolTag = detectedSchoolTags.length > 0
+    ? sortSchoolTagSelections(detectedSchoolTags)
+    : ["不限"];
   const searchParams = {
     school_tag: overrideSchoolTag || inferredSchoolTag,
     degree: (
@@ -465,8 +496,8 @@ export function parseRecommendInstruction({ instruction, confirmation, overrides
 
   if (needs_school_tag_confirmation) {
     const schoolTagQuestion = detectedSchoolTags.length > 1
-      ? `检测到多个学校标签（${detectedSchoolTags.join(" / ")}）。推荐页学校标签为单选，请确认本次最终选择。`
-      : "请确认学校标签筛选。";
+      ? `检测到学校标签：${detectedSchoolTags.join(" / ")}。请确认学校标签筛选（可多选）。`
+      : "请确认学校标签筛选（可多选）。";
     pending_questions.push({
       field: "school_tag",
       question: schoolTagQuestion,

package/src/pipeline.js

@@ -208,6 +208,7 @@ function buildFailedResponse(code, message, extra = {}) {
 
 function buildChromeSetupGuidance({ debugPort, pageState }) {
   const expectedUrl = pageState?.expected_url || "https://www.zhipin.com/web/chat/recommend";
+  const loginUrl = pageState?.login_url || "https://www.zhipin.com/web/user/?ka=bticket";
   const currentUrl = pageState?.current_url || null;
   const state = pageState?.state || "UNKNOWN";
   const isPortIssue = state === "DEBUG_PORT_UNREACHABLE";
@@ -224,7 +225,7 @@ function buildChromeSetupGuidance({ debugPort, pageState }) {
       ? `2) 若端口不可连接，请用远程调试方式启动 Chrome（示例：chrome.exe --remote-debugging-port=${debugPort}）。`
       : "2) 确认端口可连接且浏览器窗口保持打开。",
     needsLogin
-      ? "3) 当前检测到 Boss 未登录，请先在该 Chrome 实例完成登录。"
+      ? `3) 当前检测到 Boss 未登录，请先打开并完成登录：${loginUrl}`
       : "3) 如 Boss 登录态失效，请先重新登录。",
     `4) 登录完成后先导航并停留在推荐页：${expectedUrl}`,
     "5) 完成后回复“已就绪”，我会继续执行并优先自动导航到推荐页。"

package/src/test-parser.js

@@ -8,7 +8,7 @@ function testNeedConfirmationIncludesPostAction() {
     overrides: null
   });
 
-  assert.equal(result.searchParams.school_tag, "985");
+  assert.deepEqual(result.searchParams.school_tag, ["985"]);
   assert.deepEqual(result.searchParams.degree, ["不限"]);
   assert.equal(result.searchParams.gender, "男");
   assert.equal(result.searchParams.recent_not_view, "近14天没有");
@@ -48,7 +48,7 @@ function testConfirmedPostActionAndOverrides() {
     }
   });
 
-  assert.equal(result.searchParams.school_tag, "211");
+  assert.deepEqual(result.searchParams.school_tag, ["211"]);
   assert.deepEqual(result.searchParams.degree, ["本科"]);
   assert.equal(result.searchParams.gender, "女");
   assert.equal(result.searchParams.recent_not_view, "近14天没有");
@@ -83,10 +83,9 @@ function testMultipleSchoolTagsMarkedSuspicious() {
     overrides: null
   });
 
-  assert.equal(result.searchParams.school_tag, "不限");
+  assert.deepEqual(result.searchParams.school_tag, ["985", "211"]);
   assert.deepEqual(result.searchParams.degree, ["不限"]);
-  assert.equal(result.suspicious_fields.length, 1);
-  assert.equal(result.suspicious_fields[0].field, "school_tag");
+  assert.equal(result.suspicious_fields.length, 0);
 }
 
 function testDegreeCanBeExtracted() {
@@ -131,6 +130,18 @@ function testDegreeOverrideCanBeArray() {
   assert.deepEqual(result.searchParams.degree, ["大专", "本科"]);
 }
 
+function testSchoolTagOverrideCanBeArray() {
+  const result = parseRecommendInstruction({
+    instruction: "推荐页筛选985候选人，有算法经验",
+    confirmation: null,
+    overrides: {
+      school_tag: ["985", "211"]
+    }
+  });
+
+  assert.deepEqual(result.searchParams.school_tag, ["985", "211"]);
+}
+
 function testCriteriaCanBeProvidedViaOverrides() {
   const result = parseRecommendInstruction({
     instruction: "推荐页筛选211女生",
@@ -281,6 +292,7 @@ function main() {
   testDegreeAtOrAboveExpansion();
   testDegreeExplicitListOnly();
   testDegreeOverrideCanBeArray();
+  testSchoolTagOverrideCanBeArray();
   testCriteriaCanBeProvidedViaOverrides();
   testMissingCriteriaTriggersNeedInput();
   testMcpMentionShouldStayInCriteria();

package/src/test-pipeline.js

@@ -4,7 +4,7 @@ import { runRecommendPipeline } from "./pipeline.js";
 function createParsed(overrides = {}) {
   return {
     searchParams: {
-      school_tag: "985",
+      school_tag: ["985"],
       degree: ["本科"],
       gender: "男",
       recent_not_view: "近14天没有"
@@ -267,7 +267,8 @@ async function testLoginRequiredShouldReturnGuidance() {
         page_state: {
           state: "LOGIN_REQUIRED",
           expected_url: "https://www.zhipin.com/web/chat/recommend",
-          current_url: "https://www.zhipin.com/web/geek/job"
+          current_url: "https://www.zhipin.com/web/geek/job",
+          login_url: "https://www.zhipin.com/web/user/?ka=bticket"
         }
       }),
       runRecommendSearchCli: async () => ({ ok: true, summary: {} }),
@@ -281,6 +282,7 @@ async function testLoginRequiredShouldReturnGuidance() {
   assert.equal(result.guidance.debug_port, 9555);
   assert.equal(result.guidance.expected_url, "https://www.zhipin.com/web/chat/recommend");
   assert.equal(result.guidance.agent_prompt.includes("9555"), true);
+  assert.equal(result.guidance.agent_prompt.includes("https://www.zhipin.com/web/user/?ka=bticket"), true);
   assert.equal(result.guidance.agent_prompt.includes("已就绪"), true);
 }
 

package/vendor/boss-recommend-screen-cli/boss-recommend-screen-cli.cjs

@@ -1559,6 +1559,18 @@ class RecommendScreenCli {
 
     await this.connect();
     try {
+      const startupDetailState = await this.getDetailClosedState();
+      if (!startupDetailState?.closed) {
+        log("[恢复] 检测到详情页处于打开状态，先尝试关闭后再继续筛选");
+        const startupClosed = await this.closeDetailPage(4);
+        if (!startupClosed) {
+          throw this.buildError("DETAIL_CLOSE_FAILED_AT_START", "启动时未能关闭遗留详情页");
+        }
+      }
+      const startupListReady = await this.waitForListReady(18);
+      if (!startupListReady) {
+        throw this.buildError("RECOMMEND_PAGE_NOT_READY", "推荐列表未就绪（可能仍停留在详情页）");
+      }
       const initialList = await this.evaluate(jsGetListState);
       if (!initialList?.ok) {
         throw this.buildError("RECOMMEND_PAGE_NOT_READY", initialList?.error || "推荐列表不可用");