@reconcrap/boss-recommend-mcp 2.0.3 → 2.0.5

package/README.md

@@ -221,10 +221,10 @@ config/screening-config.example.json
 
 - `openaiOrganization`
 - `openaiProject`
-- `debugPort`
-- `outputDir`
+- `debugPort`：未显式传 `port` 时，recommend / search / chat CDP-only MCP run 和健康检查默认连接这个 Chrome 调试端口。
+- `outputDir`：recommend / search / chat 完成后的最终 CSV 与 report JSON 会写入这里；run state / checkpoint 仍保留在各自状态目录，方便 pause/resume/cancel。
 - `llmThinkingLevel`：默认 `low`。可设为 `off/minimal/low/medium/high/auto/current`，用于控制 OpenAI-compatible LLM 的 thinking/reasoning 强度。
-- `humanRestEnabled`：默认 `false`。`false` 时 recommend-screen 随机休息/批次休息与 boss-chat 批次休息均为 `0ms`；`true` 时恢复随机休息节奏。
+- `humanRestEnabled`：默认 `false`。当前 CDP-only recommend / search / chat run 尚未实现随机休息层，因此会读取并保留该字段但不改变节奏；如后续重新加入 human rest，应以此字段为默认值。
 
 ## 常用命令
 

package/config/screening-config.example.json

@@ -1,11 +1,13 @@
 {
   "baseUrl": "https://api.openai.com/v1",
   "apiKey": "replace-with-openai-api-key",
-  "model": "gpt-4.1-mini",
-  "llmThinkingLevel": "low",
-  "llmTimeoutMs": 60000,
-  "llmMaxRetries": 3,
-  "humanRestEnabled": false,
-  "openaiOrganization": "optional-org-id",
-  "openaiProject": "optional-project-id"
-}
+  "model": "gpt-4.1-mini",
+  "llmThinkingLevel": "low",
+  "llmTimeoutMs": 60000,
+  "llmMaxRetries": 3,
+  "debugPort": 9222,
+  "outputDir": "",
+  "humanRestEnabled": false,
+  "openaiOrganization": "optional-org-id",
+  "openaiProject": "optional-project-id"
+}

package/package.json

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

package/src/chat-mcp.js

@@ -45,6 +45,7 @@ import {
   getBossChatDataDir,
   getBossChatTargetCountValue,
   normalizeTargetCountInput,
+  resolveBossConfiguredOutputDir,
   resolveBossChatRuntimeLayout,
   resolveBossScreeningConfig
 } from "./chat-runtime-config.js";
@@ -123,12 +124,14 @@ function getChatRunArtifacts(runId) {
   const normalized = normalizeRunId(runId);
   if (!normalized) return null;
   const runsDir = getChatRunsDir();
+  const outputDir = resolveBossConfiguredOutputDir("", runsDir);
   return {
     runs_dir: runsDir,
+    output_dir: outputDir,
     run_state_path: path.join(runsDir, `${normalized}.json`),
     checkpoint_path: path.join(runsDir, `${normalized}.checkpoint.json`),
-    output_csv: path.join(runsDir, `${normalized}.results.csv`),
-    report_json: path.join(runsDir, `${normalized}.report.json`)
+    output_csv: path.join(outputDir, `${normalized}.results.csv`),
+    report_json: path.join(outputDir, `${normalized}.report.json`)
   };
 }
 
@@ -491,7 +494,8 @@ async function waitForHealthyChat(client, config, {
       domain: "chat",
       roots: roots.roots,
       selectorProbes: config.selectorProbes,
-      accessibilityProbes: config.accessibilityProbes
+      accessibilityProbes: config.accessibilityProbes,
+      viewportProbes: config.viewportProbes
     });
     if (lastCheck.status === HEALTH_STATUS.HEALTHY) return lastCheck;
     await sleep(intervalMs);
@@ -633,7 +637,7 @@ async function readChatJobOptionsFromSession(session) {
   return readChatJobOptions(session.client, roots.rootNodes.top);
 }
 
-function normalizeChatStartInput(args = {}) {
+function normalizeChatStartInput(args = {}, configResolution = null) {
   const target = normalizeTargetCountInput(getBossChatTargetCountValue(args));
   return {
     profile: normalizeText(args.profile) || "default",
@@ -645,7 +649,10 @@ function normalizeChatStartInput(args = {}) {
     targetCount: target.targetCount,
     publicTargetCount: target.publicValue,
     host: normalizeText(args.host) || DEFAULT_CHAT_HOST,
-    port: parsePositiveInteger(args.port, DEFAULT_CHAT_PORT),
+    port: parsePositiveInteger(
+      args.port,
+      configResolution?.ok ? configResolution.config.debugPort : DEFAULT_CHAT_PORT
+    ),
     targetUrlIncludes: normalizeText(args.target_url_includes) || CHAT_TARGET_URL,
     allowNavigate: args.allow_navigate !== false,
     slowLive: args.slow_live === true
@@ -800,7 +807,6 @@ function getRunOptions(args, normalized, session, { workspaceRoot = "" } = {}) {
   const shouldRequestResume = shouldRequestChatResume(args);
   const useLlm = shouldUseChatLlm(args, shouldRequestResume);
   const configResolution = useLlm ? resolveBossScreeningConfig(workspaceRoot) : { ok: false };
-  const configFile = configResolution.ok ? readJsonFile(configResolution.config_path) : null;
   return {
     client: session.client,
     targetUrl: CHAT_TARGET_URL,
@@ -827,8 +833,7 @@ function getRunOptions(args, normalized, session, { workspaceRoot = "" } = {}) {
     maxImagePages: parsePositiveInteger(args.max_image_pages, 8),
     imageWheelDeltaY: parsePositiveInteger(args.image_wheel_delta_y, 650),
     llmConfig: configResolution.ok ? {
-      ...configResolution.config,
-      apiKey: configFile?.apiKey || ""
+      ...configResolution.config
     } : null,
     llmTimeoutMs: parsePositiveInteger(args.llm_timeout_ms, slowLive ? 180000 : 120000),
     llmImageLimit: parsePositiveInteger(args.llm_image_limit, 8),
@@ -888,7 +893,8 @@ function trackChatRun(runId) {
 }
 
 async function startBossChatRunInternal(args = {}, { workspaceRoot = "" } = {}) {
-  const normalized = normalizeChatStartInput(args);
+  const defaultConfigResolution = resolveBossScreeningConfig(workspaceRoot);
+  const normalized = normalizeChatStartInput(args, defaultConfigResolution);
   const missingFields = getMissingChatStartFields(args, normalized);
   if (missingFields.length) {
     return buildNeedInputResponse({
@@ -987,7 +993,8 @@ async function startBossChatRunInternal(args = {}, { workspaceRoot = "" } = {})
 }
 
 export async function prepareBossChatRunTool({ workspaceRoot = "", args = {} } = {}) {
-  const normalized = normalizeChatStartInput(args);
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
+  const normalized = normalizeChatStartInput(args, configResolution);
   let session;
   try {
     session = await chatConnectorImpl({
@@ -1129,6 +1136,7 @@ export async function bossChatHealthCheckTool({ workspaceRoot = "", args = {} }
     cli_path: null,
     config_path: configResolution.config_path || null,
     config_dir: configResolution.config_dir || null,
+    output_dir: configResolution.ok ? configResolution.config.outputDir || null : null,
     debug_port: port,
     shared_llm_config: configResolution.ok === true,
     data_dir: runtimeLayout.data_dir,

package/src/chat-runtime-config.js

@@ -223,6 +223,22 @@ function parsePositiveInteger(raw, fallback = null) {
   return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
 }
 
+function parseConfigBoolean(raw, fallback = false) {
+  if (typeof raw === "boolean") return raw;
+  const normalized = normalizeText(raw).toLowerCase();
+  if (["true", "1", "yes", "y", "on", "enabled"].includes(normalized)) return true;
+  if (["false", "0", "no", "n", "off", "disabled"].includes(normalized)) return false;
+  return fallback;
+}
+
+function resolveConfigPathValue(raw, configDir) {
+  const normalized = normalizeText(raw);
+  if (!normalized) return "";
+  return path.isAbsolute(normalized)
+    ? path.resolve(normalized)
+    : path.resolve(configDir || process.cwd(), normalized);
+}
+
 function validateScreeningConfig(config) {
   if (!config || typeof config !== "object" || Array.isArray(config)) {
     return {
@@ -369,8 +385,12 @@ export function resolveBossScreeningConfig(workspaceRoot) {
     ok: true,
     config: {
       baseUrl: normalizeText(parsed.baseUrl).replace(/\/+$/, ""),
+      apiKey: normalizeText(parsed.apiKey),
       model: normalizeText(parsed.model),
-      debugPort: parsePositiveInteger(parsed.debugPort, 9222)
+      debugPort: parsePositiveInteger(parsed.debugPort, 9222),
+      llmThinkingLevel: normalizeText(parsed.llmThinkingLevel || parsed.thinkingLevel || parsed.reasoningEffort),
+      outputDir: resolveConfigPathValue(parsed.outputDir, configDir),
+      humanRestEnabled: parseConfigBoolean(parsed.humanRestEnabled, false)
     },
     config_path: configPath,
     config_dir: configDir,
@@ -378,6 +398,13 @@ export function resolveBossScreeningConfig(workspaceRoot) {
   };
 }
 
+export function resolveBossConfiguredOutputDir(workspaceRoot, fallbackDir = "") {
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
+  const configuredDir = configResolution.ok ? normalizeText(configResolution.config.outputDir) : "";
+  if (configuredDir) return configuredDir;
+  return fallbackDir ? path.resolve(fallbackDir) : "";
+}
+
 function isUnlimitedTargetCountToken(value) {
   const token = normalizeText(value).toLowerCase();
   if (!token) return false;

package/src/core/browser/index.js

@@ -10,6 +10,7 @@ export const BOSS_LOGIN_URL = "https://www.zhipin.com/web/user/?ka=bticket";
 
 export const ALLOWED_CDP_DOMAINS = new Set([
   "Accessibility",
+  "Browser",
   "DOM",
   "Input",
   "Network",

package/src/core/screening/index.js

@@ -37,7 +37,7 @@ const GENDER_CODE_MAP = {
   2: "女"
 };
 
-const LLM_THINKING_LEVELS = new Set(["off", "low", "medium", "high", "current"]);
+const LLM_THINKING_LEVELS = new Set(["off", "minimal", "low", "medium", "high", "auto", "current"]);
 
 function nowIso() {
   return new Date().toISOString();
@@ -64,9 +64,9 @@ function isVolcengineModel(baseUrl, model) {
 
 function applyChatCompletionThinking(payload, { baseUrl = "", model = "", thinkingLevel = "" } = {}) {
   const level = normalizeLlmThinkingLevel(thinkingLevel);
-  if (!level || level === "current") return payload;
+  if (!level || level === "current" || level === "auto") return payload;
   if (isVolcengineModel(baseUrl, model)) {
-    if (level === "off") {
+    if (level === "off" || level === "minimal") {
       payload.thinking = { type: "disabled" };
     } else {
       payload.thinking = { type: "enabled" };

package/src/core/self-heal/index.js

@@ -5,6 +5,26 @@ import {
   querySelectorAll,
   sleep
 } from "../browser/index.js";
+import {
+  compactViewportHealthResult,
+  ensureHealthyViewport
+} from "./viewport.js";
+
+export {
+  buildViewportHealthDiagnostics,
+  compactViewportHealthResult,
+  compactViewportState,
+  createViewportRunGuard,
+  ensureHealthyViewport,
+  getCurrentWindowInfo,
+  isListViewportCollapsed,
+  readViewportState,
+  setWindowStateIfPossible,
+  toggleWindowStateForViewportRecovery,
+  VIEWPORT_COLLAPSE_MIN_EXPECTED_WIDTH,
+  VIEWPORT_COLLAPSE_NEAR_FULLSCREEN_RATIO,
+  VIEWPORT_COLLAPSE_RATIO_THRESHOLD
+} from "./viewport.js";
 
 export const PROBE_STATUS = Object.freeze({
   PASS: "pass",
@@ -245,6 +265,26 @@ export function createNetworkProbe({
   };
 }
 
+export function createViewportCollapseProbe({
+  id = "viewport_collapse",
+  root = "frame",
+  frameOwnerRoot = "frameOwner",
+  required = true,
+  repair = true,
+  description = ""
+} = {}) {
+  if (!id) throw new Error("Viewport collapse probe requires an id");
+  return {
+    type: "viewport",
+    id,
+    root,
+    frameOwnerRoot,
+    required: Boolean(required),
+    repair: Boolean(repair),
+    description
+  };
+}
+
 export async function runSelectorProbe(client, roots, probe) {
   const nodeId = rootNodeId(roots, probe.root);
   if (!nodeId) {
@@ -338,6 +378,52 @@ export function runNetworkProbe(networkEvents = [], probe) {
   };
 }
 
+export async function runViewportCollapseProbe(client, roots, probe) {
+  const nodeId = rootNodeId(roots, probe.root);
+  if (!nodeId) {
+    return {
+      ...probe,
+      ok: !probe.required,
+      status: probe.required ? PROBE_STATUS.BLOCKED : PROBE_STATUS.OPTIONAL_ABSENT,
+      count: 0,
+      collapsed: false,
+      recovered: false,
+      error: `Root not found: ${probe.root}`
+    };
+  }
+
+  try {
+    const health = await ensureHealthyViewport(client, {
+      roots,
+      root: probe.root,
+      frameOwnerRoot: probe.frameOwnerRoot,
+      reason: probe.id,
+      repair: probe.repair
+    });
+    const ok = Boolean(health.ok);
+    return {
+      ...probe,
+      ok: probe.required ? ok : true,
+      status: ok ? PROBE_STATUS.PASS : probe.required ? PROBE_STATUS.FAIL : PROBE_STATUS.OPTIONAL_ABSENT,
+      count: ok ? 1 : 0,
+      collapsed: Boolean(health.collapsed),
+      recovered: Boolean(health.recovered),
+      viewport_health: compactViewportHealthResult(health),
+      error: health.error || null
+    };
+  } catch (error) {
+    return {
+      ...probe,
+      ok: !probe.required,
+      status: probe.required ? PROBE_STATUS.ERROR : PROBE_STATUS.OPTIONAL_ABSENT,
+      count: 0,
+      collapsed: false,
+      recovered: false,
+      error: error?.message || String(error)
+    };
+  }
+}
+
 export function summarizeProbeResults(probes = []) {
   const required = probes.filter((probe) => probe.required);
   const blocked = required.filter((probe) => probe.status === PROBE_STATUS.BLOCKED);
@@ -370,6 +456,7 @@ export function buildDriftReport(probes = []) {
       expected_min_count: probe.minCount,
       observed_count: probe.count || 0,
       selectors: probe.selectors || [],
+      viewport_health: probe.viewport_health || undefined,
       error: probe.error || null
     }));
 }
@@ -380,6 +467,7 @@ export async function runSelfHealCheck({
   roots = {},
   selectorProbes = [],
   accessibilityProbes = [],
+  viewportProbes = [],
   networkProbes = [],
   networkEvents = []
 } = {}) {
@@ -393,8 +481,13 @@ export async function runSelfHealCheck({
     accessibilityResults.push(await runAccessibilityProbe(client, probe));
   }
 
+  const viewportResults = [];
+  for (const probe of viewportProbes) {
+    viewportResults.push(await runViewportCollapseProbe(client, roots, probe));
+  }
+
   const networkResults = networkProbes.map((probe) => runNetworkProbe(networkEvents, probe));
-  const probes = [...selectorResults, ...accessibilityResults, ...networkResults];
+  const probes = [...selectorResults, ...accessibilityResults, ...viewportResults, ...networkResults];
   const summary = summarizeProbeResults(probes);
 
   return {
@@ -507,6 +600,16 @@ export function buildRecommendSelfHealConfig(rules = {}) {
         description: "Candidate detail popup may mount inside the recommend frame"
       })
     ],
+    viewportProbes: [
+      createViewportCollapseProbe({
+        id: "recommend_viewport_collapse",
+        root: "frame",
+        frameOwnerRoot: "frameOwner",
+        required: true,
+        repair: true,
+        description: "Recommend frame/list viewport has not collapsed relative to the Chrome window"
+      })
+    ],
     accessibilityProbes: [
       createAccessibilityProbe({
         id: "accessibility_tree",
@@ -610,6 +713,16 @@ export function buildRecruitSelfHealConfig(rules = {}) {
         description: "Candidate detail popup may mount inside the search frame"
       })
     ],
+    viewportProbes: [
+      createViewportCollapseProbe({
+        id: "recruit_viewport_collapse",
+        root: "frame",
+        frameOwnerRoot: "frameOwner",
+        required: true,
+        repair: true,
+        description: "Search frame/list viewport has not collapsed relative to the Chrome window"
+      })
+    ],
     accessibilityProbes: [
       createAccessibilityProbe({
         id: "accessibility_tree",
@@ -711,6 +824,16 @@ export function buildChatSelfHealConfig(rules = {}) {
         description: "Resume iframe appears after the online resume is opened"
       })
     ],
+    viewportProbes: [
+      createViewportCollapseProbe({
+        id: "chat_viewport_collapse",
+        root: "top",
+        frameOwnerRoot: "top",
+        required: true,
+        repair: true,
+        description: "Chat list viewport has not collapsed relative to the Chrome window"
+      })
+    ],
     accessibilityProbes: [
       createAccessibilityProbe({
         id: "accessibility_tree",
@@ -756,7 +879,8 @@ export async function resolveRecommendSelfHealRoots(client, config = buildRecomm
   return {
     roots: {
       top: topRoot.nodeId,
-      frame: iframe.documentNodeId
+      frame: iframe.documentNodeId,
+      frameOwner: iframe.nodeId
     },
     topRoot,
     iframe
@@ -779,7 +903,8 @@ export async function resolveRecruitSelfHealRoots(client, config = buildRecruitS
   return {
     roots: {
       top: topRoot.nodeId,
-      frame: iframe.documentNodeId
+      frame: iframe.documentNodeId,
+      frameOwner: iframe.nodeId
     },
     topRoot,
     iframe