@reconcrap/boss-recommend-mcp 1.1.4 → 1.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",
@@ -39,6 +39,7 @@
   ],
   "dependencies": {
     "chrome-remote-interface": "^0.33.3",
+    "sharp": "^0.34.4",
     "ws": "^8.19.0"
   },
   "engines": {
@@ -47,5 +48,15 @@
   "publishConfig": {
     "access": "public"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "devDependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reconcrap-cpu/boss-recommend-mcp.git"
+  },
+  "author": "",
+  "bugs": {
+    "url": "https://github.com/reconcrap-cpu/boss-recommend-mcp/issues"
+  },
+  "homepage": "https://github.com/reconcrap-cpu/boss-recommend-mcp#readme"
 }

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

@@ -213,16 +213,13 @@ CLI fallback 的状态机与 MCP 保持一致：
 ```text
 你是环境修复 agent。请根据 diagnostics.checks 修复依赖，必须串行执行：
 1) 若 node_cli 失败：先安装 Node.js >=18，未成功前禁止执行 npm install。
-2) 若任意 npm_dep_* 失败：再安装 npm 依赖（chrome-remote-interface / ws）。
-3) 若 python_cli 失败：安装 Python，并确保 python 命令可用。
-4) 若 python_pillow 失败：最后执行 python -m pip install pillow。
+2) 若任意 npm_dep_* 失败：再安装 npm 依赖（chrome-remote-interface / ws / sharp）。
 每一步完成后重新运行 doctor，全部通过后再重试 start_recommend_pipeline_run。
 ```
 
 安装顺序约束（必须遵守）：
 
 - 没有 Node.js 时，不能先装 npm 包
-- 没有 Python 时，不能先装 Pillow
 
 ## Response Style
 

package/src/adapters.js

@@ -1,9 +1,9 @@
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { spawn, spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import CDP from "chrome-remote-interface";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawn, spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import CDP from "chrome-remote-interface";
 
 const currentFilePath = fileURLToPath(import.meta.url);
 const packagedMcpDir = path.resolve(path.dirname(currentFilePath), "..");
@@ -679,88 +679,6 @@ function buildNodeCommandCheck() {
   };
 }
 
-function detectPythonCommand() {
-  const python = runProcessSync({
-    command: "python",
-    args: ["--version"]
-  });
-  if (python.ok) {
-    return {
-      ok: true,
-      command: "python",
-      probe: python
-    };
-  }
-  const python3 = runProcessSync({
-    command: "python3",
-    args: ["--version"]
-  });
-  if (python3.ok) {
-    return {
-      ok: false,
-      command: null,
-      probe: python,
-      fallback: python3
-    };
-  }
-  return {
-    ok: false,
-    command: null,
-    probe: python,
-    fallback: null
-  };
-}
-
-function buildPythonCommandCheck() {
-  const detected = detectPythonCommand();
-  if (detected.ok) {
-    return {
-      key: "python_cli",
-      ok: true,
-      path: "python --version",
-      message: `Python 命令可用 (${detected.probe.output || "unknown version"})`
-    };
-  }
-  if (detected.fallback) {
-    return {
-      key: "python_cli",
-      ok: false,
-      path: "python --version",
-      message: `检测到 ${detected.fallback.output || "python3"}，但当前流程依赖 python 命令；请创建 python 别名后重试。`
-    };
-  }
-  return {
-    key: "python_cli",
-    ok: false,
-    path: "python --version",
-    message: "未找到 python 命令，请安装 Python 并确保 python 在 PATH 中。"
-  };
-}
-
-function buildPillowCheck() {
-  const detected = detectPythonCommand();
-  if (!detected.ok || !detected.command) {
-    return {
-      key: "python_pillow",
-      ok: false,
-      path: "python -c \"import PIL\"",
-      message: "无法校验 Pillow：python 命令不可用。"
-    };
-  }
-  const probe = runProcessSync({
-    command: detected.command,
-    args: ["-c", "import PIL, PIL.Image; print(PIL.__version__)"]
-  });
-  return {
-    key: "python_pillow",
-    ok: probe.ok,
-    path: `${detected.command} -c "import PIL"`,
-    message: probe.ok
-      ? `Pillow 可用 (${probe.output || "version unknown"})`
-      : "Pillow 未安装。请执行 `python -m pip install pillow`。"
-  };
-}
-
 function buildNodePackageCheck({ key, moduleName, cwd, missingMessage }) {
   if (!cwd || !pathExists(cwd)) {
     return {
@@ -792,8 +710,6 @@ function buildNodePackageCheck({ key, moduleName, cwd, missingMessage }) {
 function buildRuntimeDependencyChecks({ searchDir, screenDir }) {
   return [
     buildNodeCommandCheck(),
-    buildPythonCommandCheck(),
-    buildPillowCheck(),
     buildNodePackageCheck({
       key: "npm_dep_chrome_remote_interface_search",
       moduleName: "chrome-remote-interface",
@@ -811,6 +727,12 @@ function buildRuntimeDependencyChecks({ searchDir, screenDir }) {
       moduleName: "ws",
       cwd: screenDir,
       missingMessage: "无法校验 ws：boss-recommend-screen-cli 目录不存在。"
+    }),
+    buildNodePackageCheck({
+      key: "npm_dep_sharp",
+      moduleName: "sharp",
+      cwd: screenDir,
+      missingMessage: "无法校验 sharp：boss-recommend-screen-cli 目录不存在。"
     })
   ];
 }
@@ -1065,7 +987,8 @@ function collectNpmInstallDirsFromChecks(checks = [], workspaceRoot) {
   const npmKeys = new Set([
     "npm_dep_chrome_remote_interface_search",
     "npm_dep_chrome_remote_interface_screen",
-    "npm_dep_ws"
+    "npm_dep_ws",
+    "npm_dep_sharp"
   ]);
   const dirs = checks
     .filter((item) => item && item.ok === false && npmKeys.has(item.key))
@@ -1104,28 +1027,6 @@ function installNpmDependencies(checks, workspaceRoot) {
   };
 }
 
-function installPillowIfPossible() {
-  const detected = detectPythonCommand();
-  if (!detected.ok || !detected.command) {
-    return {
-      ok: false,
-      action: "install_pillow",
-      changed: false,
-      message: "未检测到可用 python 命令，无法自动安装 Pillow。"
-    };
-  }
-  const install = runProcessSync({
-    command: detected.command,
-    args: ["-m", "pip", "install", "pillow"]
-  });
-  return {
-    ok: install.ok,
-    action: "install_pillow",
-    changed: install.ok,
-    message: install.ok ? "Pillow 自动安装完成。" : `Pillow 自动安装失败：${install.output || install.error_message || "unknown"}`
-  };
-}
-
 export function attemptPipelineAutoRepair(workspaceRoot, preflight = {}) {
   const checks = Array.isArray(preflight.checks) ? preflight.checks : [];
   const failed = collectFailedCheckKeys(checks);
@@ -1135,6 +1036,7 @@ export function attemptPipelineAutoRepair(workspaceRoot, preflight = {}) {
     failed.has("npm_dep_chrome_remote_interface_search")
     || failed.has("npm_dep_chrome_remote_interface_screen")
     || failed.has("npm_dep_ws")
+    || failed.has("npm_dep_sharp")
   ) {
     if (!failed.has("node_cli")) {
       actions.push(installNpmDependencies(checks, workspaceRoot));
@@ -1148,19 +1050,6 @@ export function attemptPipelineAutoRepair(workspaceRoot, preflight = {}) {
     }
   }
 
-  if (failed.has("python_pillow")) {
-    if (!failed.has("python_cli")) {
-      actions.push(installPillowIfPossible());
-    } else {
-      actions.push({
-        ok: false,
-        action: "install_pillow",
-        changed: false,
-        message: "python 命令不可用，跳过 Pillow 自动安装。"
-      });
-    }
-  }
-
   const attempted = actions.length > 0;
   const nextPreflight = runPipelinePreflight(workspaceRoot);
   return {
@@ -1361,10 +1250,10 @@ async function openBossRecommendTab(port) {
   };
 }
 
-async function verifyRecommendPageStable(port, options = {}) {
-  const settleMs = Number.isFinite(options.settleMs) ? options.settleMs : 1500;
-  const recheckTimeoutMs = Number.isFinite(options.recheckTimeoutMs) ? options.recheckTimeoutMs : 2500;
-  const pollMs = Number.isFinite(options.pollMs) ? options.pollMs : 600;
+async function verifyRecommendPageStable(port, options = {}) {
+  const settleMs = Number.isFinite(options.settleMs) ? options.settleMs : 1500;
+  const recheckTimeoutMs = Number.isFinite(options.recheckTimeoutMs) ? options.recheckTimeoutMs : 2500;
+  const pollMs = Number.isFinite(options.pollMs) ? options.pollMs : 600;
 
   await sleep(settleMs);
   const recheck = await inspectBossRecommendPageState(port, {
@@ -1381,79 +1270,294 @@ async function verifyRecommendPageStable(port, options = {}) {
       message: "Boss 页面曾进入 recommend 但随后跳转到其他页面，通常表示登录态失效。"
     });
   }
-  return recheck;
-}
-
-function pickBossRecommendReloadTarget(tabs = []) {
-  return tabs.find(
-    (tab) => typeof tab?.url === "string" && tab.url.includes("/web/chat/recommend")
-  ) || tabs.find(
-    (tab) => typeof tab?.url === "string" && tab.url.includes("zhipin.com")
-  ) || null;
-}
-
-export async function reloadBossRecommendPage(workspaceRoot, options = {}) {
-  const debugPort = Number.isFinite(options.port)
-    ? options.port
-    : resolveWorkspaceDebugPort(workspaceRoot);
-  const settleMs = Number.isFinite(options.settleMs) ? options.settleMs : 1200;
-  const recheckTimeoutMs = Number.isFinite(options.recheckTimeoutMs) ? options.recheckTimeoutMs : 4000;
-  const pollMs = Number.isFinite(options.pollMs) ? options.pollMs : 600;
-
-  let client = null;
-  try {
-    const tabs = await listChromeTabs(debugPort);
-    const target = pickBossRecommendReloadTarget(tabs);
-    if (!target) {
-      return {
-        ok: false,
-        debug_port: debugPort,
-        state: "BOSS_TAB_NOT_FOUND",
-        page_state: null,
-        message: "未找到可刷新的 Boss 标签页。"
-      };
-    }
-
-    client = await CDP({ port: debugPort, target });
-    const { Page } = client;
-    if (Page && typeof Page.enable === "function") {
-      await Page.enable();
-    }
-    if (Page && typeof Page.bringToFront === "function") {
-      await Page.bringToFront();
-    }
-    await Page.reload({ ignoreCache: true });
-
-    const stableState = await verifyRecommendPageStable(debugPort, {
-      settleMs,
-      recheckTimeoutMs,
-      pollMs
-    });
-    return {
-      ok: stableState.state === "RECOMMEND_READY",
-      debug_port: debugPort,
-      state: stableState.state,
-      page_state: stableState,
-      reloaded_url: target.url || null
-    };
-  } catch (error) {
-    return {
-      ok: false,
-      debug_port: debugPort,
-      state: "RELOAD_FAILED",
-      page_state: null,
-      message: error?.message || "刷新 Boss recommend 页面失败。"
-    };
-  } finally {
-    if (client) {
-      try {
-        await client.close();
-      } catch {}
-    }
-  }
-}
-
-export async function ensureBossRecommendPageReady(workspaceRoot, options = {}) {
+  return recheck;
+}
+
+function pickBossRecommendReloadTarget(tabs = []) {
+  return tabs.find(
+    (tab) => typeof tab?.url === "string" && tab.url.includes("/web/chat/recommend")
+  ) || tabs.find(
+    (tab) => typeof tab?.url === "string" && tab.url.includes("zhipin.com")
+  ) || null;
+}
+
+async function evaluateCdpExpression(client, expression) {
+  const result = await client.Runtime.evaluate({
+    expression,
+    returnByValue: true,
+    awaitPromise: true
+  });
+  if (result.exceptionDetails) {
+    throw new Error(result.exceptionDetails.exception?.description || "Runtime.evaluate failed");
+  }
+  return result.result?.value;
+}
+
+function buildRecommendRefreshStateExpression() {
+  return `(() => {
+    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' };
+    }
+    const doc = frame.contentDocument;
+    const isVisible = (el) => {
+      if (!el) return false;
+      const win = doc.defaultView;
+      if (!win) return el.offsetParent !== null;
+      const style = win.getComputedStyle(el);
+      if (style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity || '1') < 0.02) {
+        return false;
+      }
+      const rect = el.getBoundingClientRect();
+      return rect.width > 2 && rect.height > 2 && el.offsetParent !== null;
+    };
+    const finishedWrap = Array.from(doc.querySelectorAll('.finished-wrap')).find((el) => isVisible(el)) || null;
+    const refreshButton = Array.from(doc.querySelectorAll('.finished-wrap .btn.btn-refresh, .finished-wrap .btn-refresh, .no-data-refresh .btn-refresh'))
+      .find((el) => isVisible(el)) || null;
+    const cards = Array.from(doc.querySelectorAll('ul.card-list > li.card-item'));
+    const candidateCards = cards.filter((card) => card.querySelector('.card-inner[data-geekid]'));
+    const finishedText = finishedWrap ? String(finishedWrap.textContent || '').replace(/\\s+/g, ' ').trim() : '';
+    const buttonText = refreshButton ? String(refreshButton.textContent || '').replace(/\\s+/g, ' ').trim() : '';
+    return {
+      ok: true,
+      frame_url: (() => {
+        try { return String(frame.contentWindow.location.href || ''); } catch { return ''; }
+      })(),
+      finished_wrap_visible: Boolean(finishedWrap),
+      finished_wrap_text: finishedText || null,
+      refresh_button_visible: Boolean(refreshButton),
+      refresh_button_text: buttonText || null,
+      candidate_count: candidateCards.length,
+      total_card_count: cards.length,
+      list_ready: candidateCards.length > 0
+    };
+  })()`;
+}
+
+function buildRecommendRefreshClickExpression() {
+  return `(() => {
+    const frame = document.querySelector('iframe[name="recommendFrame"]')
+      || document.querySelector('iframe[src*="/web/frame/recommend/"]')
+      || document.querySelector('iframe');
+    if (!frame || !frame.contentDocument) {
+      return { ok: false, state: 'NO_RECOMMEND_IFRAME' };
+    }
+    const doc = frame.contentDocument;
+    const isVisible = (el) => {
+      if (!el) return false;
+      const win = doc.defaultView;
+      if (!win) return el.offsetParent !== null;
+      const style = win.getComputedStyle(el);
+      if (style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity || '1') < 0.02) {
+        return false;
+      }
+      const rect = el.getBoundingClientRect();
+      return rect.width > 2 && rect.height > 2 && el.offsetParent !== null;
+    };
+    const refreshButton = Array.from(doc.querySelectorAll('.finished-wrap .btn.btn-refresh, .finished-wrap .btn-refresh, .no-data-refresh .btn-refresh'))
+      .find((el) => isVisible(el)) || null;
+    if (!refreshButton) {
+      return { ok: false, state: 'REFRESH_BUTTON_NOT_FOUND' };
+    }
+    try {
+      refreshButton.click();
+      return {
+        ok: true,
+        state: 'REFRESH_BUTTON_CLICKED',
+        refresh_button_text: String(refreshButton.textContent || '').replace(/\\s+/g, ' ').trim() || null
+      };
+    } catch (error) {
+      return {
+        ok: false,
+        state: 'REFRESH_BUTTON_CLICK_FAILED',
+        message: error?.message || String(error)
+      };
+    }
+  })()`;
+}
+
+export async function refreshBossRecommendList(workspaceRoot, options = {}) {
+  const debugPort = Number.isFinite(options.port)
+    ? options.port
+    : resolveWorkspaceDebugPort(workspaceRoot);
+  const pollMs = Number.isFinite(options.pollMs) ? options.pollMs : 600;
+  const reloadTimeoutMs = Number.isFinite(options.reloadTimeoutMs) ? options.reloadTimeoutMs : 10000;
+
+  let client = null;
+  try {
+    const tabs = await listChromeTabs(debugPort);
+    const target = pickBossRecommendReloadTarget(tabs);
+    if (!target) {
+      return {
+        ok: false,
+        action: "in_page_refresh",
+        debug_port: debugPort,
+        state: "BOSS_TAB_NOT_FOUND",
+        message: "未找到可操作的 Boss recommend 标签页。",
+        before_state: null,
+        after_state: null
+      };
+    }
+
+    client = await CDP({ port: debugPort, target });
+    const { Page, Runtime } = client;
+    if (Runtime && typeof Runtime.enable === "function") {
+      await Runtime.enable();
+    }
+    if (Page && typeof Page.enable === "function") {
+      await Page.enable();
+    }
+    if (Page && typeof Page.bringToFront === "function") {
+      await Page.bringToFront();
+    }
+
+    const beforeState = await evaluateCdpExpression(client, buildRecommendRefreshStateExpression());
+    if (!beforeState?.ok) {
+      return {
+        ok: false,
+        action: "in_page_refresh",
+        debug_port: debugPort,
+        state: beforeState?.error || "NO_RECOMMEND_IFRAME",
+        message: "未能读取 recommend iframe，无法执行页内刷新。",
+        before_state: beforeState || null,
+        after_state: null
+      };
+    }
+    if (!beforeState.refresh_button_visible) {
+      return {
+        ok: false,
+        action: "in_page_refresh",
+        debug_port: debugPort,
+        state: "REFRESH_BUTTON_NOT_FOUND",
+        message: "推荐列表到底后未发现可点击的刷新按钮。",
+        before_state: beforeState,
+        after_state: beforeState
+      };
+    }
+
+    const clickResult = await evaluateCdpExpression(client, buildRecommendRefreshClickExpression());
+    if (!clickResult?.ok) {
+      return {
+        ok: false,
+        action: "in_page_refresh",
+        debug_port: debugPort,
+        state: clickResult?.state || "REFRESH_BUTTON_CLICK_FAILED",
+        message: clickResult?.message || "页内刷新按钮点击失败。",
+        before_state: beforeState,
+        after_state: null
+      };
+    }
+
+    const deadline = Date.now() + reloadTimeoutMs;
+    let lastState = beforeState;
+    while (Date.now() < deadline) {
+      await sleep(pollMs);
+      lastState = await evaluateCdpExpression(client, buildRecommendRefreshStateExpression());
+      if (lastState?.ok && lastState.finished_wrap_visible === false && lastState.list_ready === true) {
+        return {
+          ok: true,
+          action: "in_page_refresh",
+          debug_port: debugPort,
+          state: "RECOMMEND_READY",
+          message: "已点击页内刷新按钮并重新拿到候选人列表。",
+          before_state: beforeState,
+          after_state: lastState
+        };
+      }
+    }
+
+    return {
+      ok: false,
+      action: "in_page_refresh",
+      debug_port: debugPort,
+      state: "LIST_NOT_RELOADED",
+      message: "已点击页内刷新按钮，但候选人列表未在超时内重新就绪。",
+      before_state: beforeState,
+      after_state: lastState
+    };
+  } catch (error) {
+    return {
+      ok: false,
+      action: "in_page_refresh",
+      debug_port: debugPort,
+      state: "REFRESH_BUTTON_CLICK_FAILED",
+      message: error?.message || "页内刷新失败。",
+      before_state: null,
+      after_state: null
+    };
+  } finally {
+    if (client) {
+      try {
+        await client.close();
+      } catch {}
+    }
+  }
+}
+
+export async function reloadBossRecommendPage(workspaceRoot, options = {}) {
+  const debugPort = Number.isFinite(options.port)
+    ? options.port
+    : resolveWorkspaceDebugPort(workspaceRoot);
+  const settleMs = Number.isFinite(options.settleMs) ? options.settleMs : 1200;
+  const recheckTimeoutMs = Number.isFinite(options.recheckTimeoutMs) ? options.recheckTimeoutMs : 4000;
+  const pollMs = Number.isFinite(options.pollMs) ? options.pollMs : 600;
+
+  let client = null;
+  try {
+    const tabs = await listChromeTabs(debugPort);
+    const target = pickBossRecommendReloadTarget(tabs);
+    if (!target) {
+      return {
+        ok: false,
+        debug_port: debugPort,
+        state: "BOSS_TAB_NOT_FOUND",
+        page_state: null,
+        message: "未找到可刷新的 Boss 标签页。"
+      };
+    }
+
+    client = await CDP({ port: debugPort, target });
+    const { Page } = client;
+    if (Page && typeof Page.enable === "function") {
+      await Page.enable();
+    }
+    if (Page && typeof Page.bringToFront === "function") {
+      await Page.bringToFront();
+    }
+    await Page.reload({ ignoreCache: true });
+
+    const stableState = await verifyRecommendPageStable(debugPort, {
+      settleMs,
+      recheckTimeoutMs,
+      pollMs
+    });
+    return {
+      ok: stableState.state === "RECOMMEND_READY",
+      debug_port: debugPort,
+      state: stableState.state,
+      page_state: stableState,
+      reloaded_url: target.url || null
+    };
+  } catch (error) {
+    return {
+      ok: false,
+      debug_port: debugPort,
+      state: "RELOAD_FAILED",
+      page_state: null,
+      message: error?.message || "刷新 Boss recommend 页面失败。"
+    };
+  } finally {
+    if (client) {
+      try {
+        await client.close();
+      } catch {}
+    }
+  }
+}
+
+export async function ensureBossRecommendPageReady(workspaceRoot, options = {}) {
   const debugPort = Number.isFinite(options.port)
     ? options.port
     : resolveWorkspaceDebugPort(workspaceRoot);