@reconcrap/boss-recommend-mcp 0.1.10 → 0.1.12

package/README.md

@@ -34,6 +34,7 @@ MCP 工具名：`run_recommend_pipeline`
 - 简历提取采用“分段滚动截图 + 拼成长图”的方式，再交给多模态模型判断
 - 运行前会自动做依赖体检（Node.js、Python、Pillow、`chrome-remote-interface`、`ws`），缺失时会在 `doctor` 与流水线失败诊断中明确提示
 - 若 preflight 失败，返回 `diagnostics.recovery`（含有序修复步骤与 `agent_prompt`），可直接交给 AI agent 自动按顺序安装依赖
+- 不依赖 PowerShell；Windows / macOS 均可运行（命令提示会按平台给出）
 
 ## 安装
 
@@ -82,6 +83,7 @@ node src/cli.js run --instruction "推荐页筛选985男生，近14天没有，
 
 - `install` 阶段不会自动创建 `screening-config.json`
 - 首次运行若缺配置，会由 doctor / pipeline 明确提示用户填写 `baseUrl`、`apiKey`、`model`
+- 在 `npx` 临时目录（如 `AppData\\Local\\npm-cache\\_npx\\...`）执行时，不会再把该临时目录当作 `screening-config.json` 目标路径
 
 配置样例见：
 

package/package.json

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

package/src/adapters.js

@@ -60,6 +60,9 @@ function parsePositiveInteger(raw) {
 
 function resolveWorkspaceConfigCandidates(workspaceRoot) {
   const root = path.resolve(String(workspaceRoot || process.cwd()));
+  if (isEphemeralNpxWorkspaceRoot(root)) {
+    return [];
+  }
   const directPath = path.join(root, "config", "screening-config.json");
   const nestedPath = path.join(root, "boss-recommend-mcp", "config", "screening-config.json");
   const candidates = [directPath];
@@ -93,16 +96,13 @@ function serializeSchoolTagSelection(value) {
   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 isEphemeralNpxWorkspaceRoot(workspaceRoot) {
+  const root = path.resolve(String(workspaceRoot || ""));
+  const normalized = root.replace(/\\/g, "/").toLowerCase();
+  return (
+    normalized.includes("/appdata/local/npm-cache/_npx/")
+    || normalized.includes("/node_modules/@reconcrap/boss-recommend-mcp")
+  );
 }
 
 function buildScreenConfigCandidateMap(workspaceRoot) {
@@ -135,14 +135,7 @@ 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 旧路径。
+  // 默认固定写入/读取 Agent 无关路径，避免落到 npx 临时目录或 .codex 旧路径。
   if (candidateMap.user_path) {
     return candidateMap.user_path;
   }
@@ -156,6 +149,8 @@ export function getScreenConfigResolution(workspaceRoot) {
   return {
     resolved_path,
     candidate_paths,
+    workspace_root: path.resolve(String(workspaceRoot || process.cwd())),
+    workspace_ephemeral: isEphemeralNpxWorkspaceRoot(workspaceRoot),
     writable_path: candidateMap.user_path,
     legacy_path: candidateMap.legacy_path
   };
@@ -217,13 +212,34 @@ function resolveWorkspaceDebugPort(workspaceRoot) {
   return parsePositiveInteger(config?.debugPort) || 9222;
 }
 
+function getDefaultChromeExecutableCandidates() {
+  const candidates = [process.env.BOSS_RECOMMEND_CHROME_PATH].filter(Boolean);
+  if (process.platform === "win32") {
+    candidates.push(
+      path.join(process.env.LOCALAPPDATA || "", "Google", "Chrome", "Application", "chrome.exe"),
+      path.join(process.env.ProgramFiles || "", "Google", "Chrome", "Application", "chrome.exe"),
+      path.join(process.env["ProgramFiles(x86)"] || "", "Google", "Chrome", "Application", "chrome.exe")
+    );
+  } else if (process.platform === "darwin") {
+    candidates.push(
+      "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+      path.join(os.homedir(), "Applications", "Google Chrome.app", "Contents", "MacOS", "Google Chrome"),
+      "/Applications/Chromium.app/Contents/MacOS/Chromium"
+    );
+  } else {
+    candidates.push(
+      "/usr/bin/google-chrome",
+      "/usr/bin/google-chrome-stable",
+      "/usr/bin/chromium-browser",
+      "/usr/bin/chromium",
+      "/snap/bin/chromium"
+    );
+  }
+  return Array.from(new Set(candidates.filter(Boolean)));
+}
+
 function getChromeExecutable() {
-  const candidates = [
-    process.env.BOSS_RECOMMEND_CHROME_PATH,
-    path.join(process.env.LOCALAPPDATA || "", "Google", "Chrome", "Application", "chrome.exe"),
-    path.join(process.env.ProgramFiles || "", "Google", "Chrome", "Application", "chrome.exe"),
-    path.join(process.env["ProgramFiles(x86)"] || "", "Google", "Chrome", "Application", "chrome.exe")
-  ].filter(Boolean);
+  const candidates = getDefaultChromeExecutableCandidates();
   return candidates.find((candidate) => pathExists(candidate)) || null;
 }
 

package/src/cli.js

@@ -557,13 +557,34 @@ function findChromeOnboardingUrl(tabs) {
   return null;
 }
 
+function getDefaultChromeExecutableCandidates() {
+  const candidates = [process.env.BOSS_RECOMMEND_CHROME_PATH].filter(Boolean);
+  if (process.platform === "win32") {
+    candidates.push(
+      path.join(process.env.LOCALAPPDATA || "", "Google", "Chrome", "Application", "chrome.exe"),
+      path.join(process.env.ProgramFiles || "", "Google", "Chrome", "Application", "chrome.exe"),
+      path.join(process.env["ProgramFiles(x86)"] || "", "Google", "Chrome", "Application", "chrome.exe")
+    );
+  } else if (process.platform === "darwin") {
+    candidates.push(
+      "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+      path.join(os.homedir(), "Applications", "Google Chrome.app", "Contents", "MacOS", "Google Chrome"),
+      "/Applications/Chromium.app/Contents/MacOS/Chromium"
+    );
+  } else {
+    candidates.push(
+      "/usr/bin/google-chrome",
+      "/usr/bin/google-chrome-stable",
+      "/usr/bin/chromium-browser",
+      "/usr/bin/chromium",
+      "/snap/bin/chromium"
+    );
+  }
+  return Array.from(new Set(candidates.filter(Boolean)));
+}
+
 function getChromeExecutable() {
-  const candidates = [
-    process.env.BOSS_RECOMMEND_CHROME_PATH,
-    path.join(process.env.LOCALAPPDATA || "", "Google", "Chrome", "Application", "chrome.exe"),
-    path.join(process.env.ProgramFiles || "", "Google", "Chrome", "Application", "chrome.exe"),
-    path.join(process.env["ProgramFiles(x86)"] || "", "Google", "Chrome", "Application", "chrome.exe")
-  ].filter(Boolean);
+  const candidates = getDefaultChromeExecutableCandidates();
   return candidates.find((candidate) => fs.existsSync(candidate)) || null;
 }
 

package/src/pipeline.js

@@ -18,7 +18,7 @@ function failedCheckSet(checks = []) {
   return new Set(failed);
 }
 
-function collectNpmInstallDirs(checks = [], workspaceRoot) {
+function collectNpmInstallDirs(checks = [], workspaceRoot) {
   const npmCheckKeys = new Set([
     "npm_dep_chrome_remote_interface_search",
     "npm_dep_chrome_remote_interface_screen",
@@ -28,20 +28,61 @@ function collectNpmInstallDirs(checks = [], workspaceRoot) {
     .filter((item) => item && item.ok === false && npmCheckKeys.has(item.key))
     .map((item) => item.install_cwd)
     .filter((value) => typeof value === "string" && value.trim());
-  if (dirs.length > 0) return dedupe(dirs);
-  return workspaceRoot ? [workspaceRoot] : [];
-}
-
-function buildNpmInstallCommands(checks = [], workspaceRoot) {
-  const dirs = collectNpmInstallDirs(checks, workspaceRoot);
-  const commands = [];
-  for (const dir of dirs) {
-    const escaped = String(dir).replace(/'/g, "''");
-    commands.push(`Set-Location '${escaped}'`);
-    commands.push("npm install");
-  }
-  return commands;
-}
+  if (dirs.length > 0) return dedupe(dirs);
+  return workspaceRoot ? [workspaceRoot] : [];
+}
+
+function quoteForCommand(value) {
+  return JSON.stringify(String(value));
+}
+
+function buildNpmInstallCommands(checks = [], workspaceRoot) {
+  const dirs = collectNpmInstallDirs(checks, workspaceRoot);
+  const commands = [];
+  for (const dir of dirs) {
+    commands.push(`npm install --prefix ${quoteForCommand(dir)}`);
+  }
+  return commands;
+}
+
+function getNodeInstallCommands() {
+  if (process.platform === "win32") {
+    return [
+      "winget install OpenJS.NodeJS.LTS",
+      "node --version"
+    ];
+  }
+  if (process.platform === "darwin") {
+    return [
+      "brew install node",
+      "node --version"
+    ];
+  }
+  return [
+    "使用系统包管理器安装 Node.js >= 18（例如 apt / yum / brew）",
+    "node --version"
+  ];
+}
+
+function getPythonInstallCommands() {
+  if (process.platform === "win32") {
+    return [
+      "winget install Python.Python.3.12",
+      "python --version"
+    ];
+  }
+  if (process.platform === "darwin") {
+    return [
+      "brew install python",
+      "python3 --version",
+      "若系统无 python 命令，请在当前终端建立 python -> python3 别名后重试。"
+    ];
+  }
+  return [
+    "使用系统包管理器安装 Python（例如 apt / yum / brew）",
+    "python --version"
+  ];
+}
 
 function formatCommandBlock(commands = []) {
   return commands.map((command) => `- ${command}`).join("\n");
@@ -79,12 +120,9 @@ function buildPreflightRecovery(checks = [], workspaceRoot) {
       id: "install_nodejs",
       title: "安装 Node.js >= 18",
       blocked_by: [],
-      commands: [
-        "winget install OpenJS.NodeJS.LTS",
-        "node --version"
-      ]
-    });
-  }
+      commands: getNodeInstallCommands()
+    });
+  }
   if (needNpm) {
     ordered_steps.push({
       id: "install_npm_dependencies",
@@ -93,17 +131,14 @@ function buildPreflightRecovery(checks = [], workspaceRoot) {
       commands: buildNpmInstallCommands(checks, workspaceRoot)
     });
   }
-  if (needPython) {
-    ordered_steps.push({
-      id: "install_python",
-      title: "安装 Python（确保 python 命令可用）",
-      blocked_by: [],
-      commands: [
-        "winget install Python.Python.3.12",
-        "python --version"
-      ]
-    });
-  }
+  if (needPython) {
+    ordered_steps.push({
+      id: "install_python",
+      title: "安装 Python（确保 python 命令可用）",
+      blocked_by: [],
+      commands: getPythonInstallCommands()
+    });
+  }
   if (needPillow) {
     ordered_steps.push({
       id: "install_pillow",
@@ -217,12 +252,17 @@ function buildChromeSetupGuidance({ debugPort, pageState }) {
   const launchLine = launchAttempt?.ok
     ? `已自动启动 Chrome（--remote-debugging-port=${debugPort}，--user-data-dir=${launchAttempt.user_data_dir || "auto"}）。`
     : null;
+  const launchExample = process.platform === "win32"
+    ? `chrome.exe --remote-debugging-port=${debugPort} --user-data-dir=<profile-dir>`
+    : process.platform === "darwin"
+      ? `'/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' --remote-debugging-port=${debugPort} --user-data-dir=<profile-dir>`
+      : `google-chrome --remote-debugging-port=${debugPort} --user-data-dir=<profile-dir>`;
   const steps = [
     `请先在可连接到 DevTools 端口 ${debugPort} 的 Chrome 实例中完成以下操作：`,
     ...(launchLine ? [launchLine] : []),
     "1) 确认当前 Chrome 与本次运行使用同一个远程调试端口。",
     isPortIssue
-      ? `2) 若端口不可连接，请用远程调试方式启动 Chrome（示例：chrome.exe --remote-debugging-port=${debugPort}）。`
+      ? `2) 若端口不可连接，请用远程调试方式启动 Chrome（示例：${launchExample}）。`
       : "2) 确认端口可连接且浏览器窗口保持打开。",
     needsLogin
       ? `3) 当前检测到 Boss 未登录，请先打开并完成登录：${loginUrl}`