@reconcrap/boss-recommend-mcp 2.0.43 → 2.0.45

package/README.md

@@ -259,7 +259,13 @@ config/screening-config.example.json
 - `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`。当前 CDP-only recommend / search / chat run 尚未实现随机休息层，因此会读取并保留该字段但不改变节奏；如后续重新加入 human rest，应以此字段为默认值。
+- `humanBehavior`：默认 `{ "enabled": true, "profile": "paced_with_rests" }`。用于 recommend / search / chat 的可靠性实验，支持：
+  - `profile: "baseline"`：关闭人类节奏，保持确定性行为。
+  - `profile: "paced"`：启用 CDP-only Bezier 鼠标移动、较大按钮的安全 inset 点击点、分块 `Input.insertText`、列表 wheel/settle jitter，以及小的动作前后读秒。
+  - `profile: "paced_with_rests"`：在 `paced` 基础上启用候选人短休和批次休息。
+- `humanRestEnabled`：兼容旧配置。设为 `true` 时等价于 `humanBehavior.profile="paced_with_rests"`；设为 `false` 时不会关闭当前默认节奏。如需关闭，请显式设置 `humanBehavior.enabled=false` 或 `humanBehavior.profile="baseline"`。
+  - recommend / search / chat 图片简历 fallback 与主列表滚动都会在启用 `listScrollJitter` 时使用 coverage-safe scroll jitter：每次 wheel delta 在安全范围内变化，并保留截图重叠、重复检测、bottom-marker / stop-boundary 逻辑，实际 delta 和 settle 时间会写入 artifact metadata。
+  - chat/recommend/search run 也兼容显式参数 `safe_pacing` 与 `batch_rest_enabled`：run 参数优先于配置文件。
 
 ## 常用命令
 

package/config/screening-config.example.json

@@ -12,7 +12,17 @@
   "llmImageDetail": "low",
   "debugPort": 9222,
   "outputDir": "",
-  "humanRestEnabled": false,
+  "humanRestEnabled": true,
+  "humanBehavior": {
+    "enabled": true,
+    "profile": "paced_with_rests",
+    "clickMovement": true,
+    "textEntry": true,
+    "listScrollJitter": true,
+    "shortRest": true,
+    "batchRest": true,
+    "actionCooldown": true
+  },
   "openaiOrganization": "optional-org-id",
   "openaiProject": "optional-project-id"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "2.0.43",
+  "version": "2.0.45",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",
@@ -83,7 +83,6 @@
     "config/screening-config.example.json",
     "skills",
     "scripts/postinstall.cjs",
-    "scripts/live-recommend-recovery-smoke.js",
     "src/core",
     "src/domains",
     "src/chat-mcp.js",

package/src/chat-mcp.js

@@ -48,6 +48,7 @@ import {
   normalizeTargetCountInput,
   resolveBossConfiguredOutputDir,
   resolveBossChatRuntimeLayout,
+  resolveHumanBehaviorForRun,
   resolveBossScreeningConfig
 } from "./chat-runtime-config.js";
 import { DEFAULT_MAX_IMAGE_PAGES } from "./core/cv-acquisition/index.js";
@@ -1078,6 +1079,7 @@ function getRunOptions(args, normalized, session, { workspaceRoot = "", configRe
   const shouldRequestResume = shouldRequestChatResume(args);
   const useLlm = shouldUseChatLlm(args);
   const resolvedConfig = configResolution || (useLlm ? resolveBossScreeningConfig(workspaceRoot) : { ok: false });
+  const humanBehavior = resolveHumanBehaviorForRun(args, resolvedConfig?.config || {});
   return {
     client: session.client,
     targetUrl: CHAT_TARGET_URL,
@@ -1124,6 +1126,8 @@ function getRunOptions(args, normalized, session, { workspaceRoot = "", configRe
     listSettleMs: parsePositiveInteger(args.list_settle_ms, slowLive ? 1800 : 1200),
     listFallbackPoint: null,
     imageOutputDir: resolveBossConfiguredOutputDir("", getChatRunsDir()),
+    humanRestEnabled: humanBehavior.restEnabled,
+    humanBehavior,
     name: "mcp-boss-chat-run"
   };
 }

package/src/chat-runtime-config.js

@@ -2,6 +2,7 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import process from "node:process";
+import { normalizeHumanBehaviorOptions } from "./core/browser/index.js";
 
 const BOSS_CHAT_RUNTIME_SUBDIR = "boss-chat";
 const TARGET_COUNT_WRAPPER_KEYS = ["target_count", "targetCount", "value", "count", "limit"];
@@ -238,6 +239,84 @@ function parseConfigBoolean(raw, fallback = false) {
   return fallback;
 }
 
+function readFirstOwn(source, keys = []) {
+  if (!source || typeof source !== "object") return undefined;
+  for (const key of keys) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) return source[key];
+  }
+  return undefined;
+}
+
+function parseOptionalConfigBoolean(raw) {
+  if (raw === undefined || raw === null || raw === "") return null;
+  return parseConfigBoolean(raw, null);
+}
+
+function applyHumanBehaviorProfileDefaults(target, profileRaw) {
+  const defaults = normalizeHumanBehaviorOptions(String(profileRaw || ""));
+  Object.assign(target, {
+    enabled: defaults.enabled,
+    profile: defaults.profile,
+    clickMovement: defaults.clickMovement,
+    textEntry: defaults.textEntry,
+    listScrollJitter: defaults.listScrollJitter,
+    shortRest: defaults.shortRest,
+    batchRest: defaults.batchRest,
+    actionCooldown: defaults.actionCooldown
+  });
+}
+
+export function resolveHumanBehaviorForRun(args = {}, config = {}) {
+  const base = normalizeHumanBehaviorOptions(config.humanBehavior || config.human_behavior || null, {
+    legacyEnabled: config.humanRestEnabled === true
+  });
+  const override = {};
+  const rawBehavior = readFirstOwn(args, ["human_behavior", "humanBehavior"]);
+  if (typeof rawBehavior === "boolean") {
+    override.enabled = rawBehavior;
+  } else if (typeof rawBehavior === "string") {
+    applyHumanBehaviorProfileDefaults(override, rawBehavior);
+  } else if (rawBehavior && typeof rawBehavior === "object" && !Array.isArray(rawBehavior)) {
+    const rawProfile = readFirstOwn(rawBehavior, ["profile", "mode", "behaviorProfile", "behavior_profile"]);
+    if (rawProfile !== undefined) applyHumanBehaviorProfileDefaults(override, rawProfile);
+    Object.assign(override, rawBehavior);
+  }
+
+  const profile = readFirstOwn(args, ["human_behavior_profile", "humanBehaviorProfile"]);
+  if (profile !== undefined) applyHumanBehaviorProfileDefaults(override, profile);
+  const enabled = parseOptionalConfigBoolean(readFirstOwn(args, [
+    "human_behavior_enabled",
+    "humanBehaviorEnabled"
+  ]));
+  if (enabled !== null) {
+    override.enabled = enabled;
+    if (enabled === true && !override.profile) applyHumanBehaviorProfileDefaults(override, "paced");
+  }
+
+  const safePacing = parseOptionalConfigBoolean(readFirstOwn(args, ["safe_pacing", "safePacing"]));
+  if (safePacing === true) {
+    applyHumanBehaviorProfileDefaults(override, "paced");
+  } else if (safePacing === false) {
+    override.enabled = false;
+  }
+
+  const batchRest = parseOptionalConfigBoolean(readFirstOwn(args, [
+    "batch_rest_enabled",
+    "batchRestEnabled",
+    "batch_rest"
+  ]));
+  if (batchRest === true) {
+    applyHumanBehaviorProfileDefaults(override, "paced_with_rests");
+  } else if (batchRest === false) {
+    override.batchRest = false;
+  }
+
+  return normalizeHumanBehaviorOptions({
+    ...base,
+    ...override
+  });
+}
+
 function normalizeLlmThinkingLevel(raw, fallback = "low") {
   const normalized = normalizeText(raw).toLowerCase();
   return LLM_THINKING_LEVELS.has(normalized) ? normalized : fallback;
@@ -455,6 +534,10 @@ export function resolveBossScreeningConfig(workspaceRoot) {
     || parsed.greeting_text
     || parsed.greeting
   );
+  const humanRestEnabled = parseConfigBoolean(parsed.humanRestEnabled, false);
+  const humanBehavior = normalizeHumanBehaviorOptions(parsed.humanBehavior || parsed.human_behavior || null, {
+    legacyEnabled: humanRestEnabled
+  });
   return {
     ok: true,
     config: {
@@ -469,7 +552,8 @@ export function resolveBossScreeningConfig(workspaceRoot) {
       greetingText,
       debugPort: parsePositiveInteger(parsed.debugPort, 9222),
       outputDir: resolveConfigPathValue(parsed.outputDir, configDir),
-      humanRestEnabled: parseConfigBoolean(parsed.humanRestEnabled, false)
+      humanRestEnabled,
+      humanBehavior
     },
     config_path: configPath,
     config_dir: configDir,

package/src/cli.js

@@ -63,7 +63,11 @@ const installConfigDefaults = Object.freeze({
   llmMaxRetries: 3,
   llmImageLimit: 8,
   llmImageDetail: "low",
-  humanRestEnabled: false
+  humanRestEnabled: true,
+  humanBehavior: {
+    enabled: true,
+    profile: "paced_with_rests"
+  }
 });
 const bossChatRuntimeChildDirs = ["logs", "runs", "profiles", "reports", "artifacts", "state"];
 const bossChatCliUnsupportedStartCode = "CHAT_CLI_ASYNC_UNSUPPORTED_CDP_ONLY";
@@ -2687,6 +2691,10 @@ async function runPipelineOnce(options = {}) {
     "action_timeout_ms",
     "action_interval_ms",
     "action_after_click_delay_ms",
+    "human_behavior_enabled",
+    "human_behavior_profile",
+    "safe_pacing",
+    "batch_rest_enabled",
     "llm_timeout_ms",
     "llm_image_limit",
     "llm_image_detail"
@@ -2761,6 +2769,10 @@ function buildBossChatCliInput(options = {}) {
     max_candidates: parseNonNegativeInteger(options["max-candidates"] ?? options.max_candidates),
     dry_run: options["dry-run"] === true || options.dryRun === true,
     no_state: options["no-state"] === true || options.noState === true,
+    human_behavior_enabled: parseBooleanOption(options["human-behavior-enabled"] ?? options.human_behavior_enabled),
+    human_behavior_profile: typeof (options["human-behavior-profile"] ?? options.human_behavior_profile) === "string"
+      ? (options["human-behavior-profile"] ?? options.human_behavior_profile).trim()
+      : undefined,
     safe_pacing: parseBooleanOption(options["safe-pacing"] ?? options.safe_pacing),
     batch_rest_enabled: parseBooleanOption(options["batch-rest"] ?? options.batch_rest_enabled)
   };