@reconcrap/boss-recommend-mcp 1.3.19 → 1.3.21

package/README.md

@@ -167,7 +167,8 @@ config/screening-config.example.json
 - `openaiProject`
 - `debugPort`
 - `outputDir`
-- `llmThinkingLevel`：默认 `off`。可设为 `off/minimal/low/medium/high/auto/current`，用于控制 OpenAI-compatible LLM 的 thinking/reasoning 强度。
+- `llmThinkingLevel`：默认 `low`。可设为 `off/minimal/low/medium/high/auto/current`，用于控制 OpenAI-compatible LLM 的 thinking/reasoning 强度。
+- `humanRestEnabled`：默认 `false`。`false` 时 recommend-screen 随机休息/批次休息与 boss-chat 批次休息均为 `0ms`；`true` 时恢复随机休息节奏。
 
 ## 常用命令
 

package/config/screening-config.example.json

@@ -2,7 +2,8 @@
   "baseUrl": "https://api.openai.com/v1",
   "apiKey": "replace-with-openai-api-key",
   "model": "gpt-4.1-mini",
-  "llmThinkingLevel": "off",
+  "llmThinkingLevel": "low",
+  "humanRestEnabled": false,
   "openaiOrganization": "optional-org-id",
   "openaiProject": "optional-project-id"
 }

package/package.json

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

package/src/adapters.js

@@ -121,6 +121,30 @@ function normalizeText(value) {
   return String(value || "").replace(/\s+/g, " ").trim();
 }
 
+function parseBooleanValue(value) {
+  if (typeof value === "boolean") return value;
+  const normalized = normalizeText(value).toLowerCase();
+  if (!normalized) return null;
+  if (["1", "true", "yes", "y", "on", "是"].includes(normalized)) return true;
+  if (["0", "false", "no", "n", "off", "否"].includes(normalized)) return false;
+  return null;
+}
+
+function resolveHumanRestEnabled(config = {}) {
+  if (!config || typeof config !== "object" || Array.isArray(config)) return false;
+  const candidates = [
+    config.humanRestEnabled,
+    config.human_rest_enabled,
+    config.humanLikeRestEnabled,
+    config.human_like_rest_enabled
+  ];
+  for (const candidate of candidates) {
+    const parsed = parseBooleanValue(candidate);
+    if (typeof parsed === "boolean") return parsed;
+  }
+  return false;
+}
+
 function serializeInputSummary(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return null;
   try {
@@ -2937,6 +2961,7 @@ export async function runRecommendScreenCli({
   if (llmThinkingLevel) {
     args.push("--thinking-level", llmThinkingLevel);
   }
+  args.push("--human-rest", String(resolveHumanRestEnabled(loaded.config)));
   if (Number.isInteger(screenParams.target_count) && screenParams.target_count > 0) {
     args.push("--targetCount", String(screenParams.target_count));
   }

package/src/boss-chat.js

@@ -40,6 +40,30 @@ function parsePositiveInteger(value, fallback = null) {
   return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
 }
 
+function parseBooleanValue(value) {
+  if (typeof value === "boolean") return value;
+  const normalized = normalizeText(value).toLowerCase();
+  if (!normalized) return null;
+  if (["1", "true", "yes", "y", "on", "是"].includes(normalized)) return true;
+  if (["0", "false", "no", "n", "off", "否"].includes(normalized)) return false;
+  return null;
+}
+
+function resolveHumanRestEnabled(config = {}) {
+  if (!config || typeof config !== "object" || Array.isArray(config)) return false;
+  const candidates = [
+    config.humanRestEnabled,
+    config.human_rest_enabled,
+    config.humanLikeRestEnabled,
+    config.human_like_rest_enabled
+  ];
+  for (const candidate of candidates) {
+    const parsed = parseBooleanValue(candidate);
+    if (typeof parsed === "boolean") return parsed;
+  }
+  return false;
+}
+
 function isUnlimitedTargetCountToken(value) {
   const token = normalizeText(value).toLowerCase();
   if (!token) return false;
@@ -290,7 +314,8 @@ function resolveBossChatScreenConfig(workspaceRoot) {
       apiKey: normalizeText(parsed.apiKey),
       model: normalizeText(parsed.model),
       llmThinkingLevel: resolveLlmThinkingLevel(parsed),
-      debugPort: parsePositiveInteger(parsed.debugPort, 9222)
+      debugPort: parsePositiveInteger(parsed.debugPort, 9222),
+      humanRestEnabled: resolveHumanRestEnabled(parsed)
     },
     config_path: configPath,
     config_dir: path.dirname(configPath)
@@ -430,6 +455,8 @@ function buildBossChatCliArgs(command, input, resolvedConfig) {
     }
     if (typeof normalized.batchRestEnabled === "boolean") {
       args.push("--batch-rest", String(normalized.batchRestEnabled));
+    } else if (typeof resolvedConfig?.humanRestEnabled === "boolean") {
+      args.push("--batch-rest", String(resolvedConfig.humanRestEnabled));
     }
     return args;
   }

package/src/cli.js

@@ -45,6 +45,10 @@ const recommendMcpBinaryName = "boss-recommend-mcp";
 const autoSyncSkipCommands = new Set(["install", "install-skill", "where", "help", "--help", "-h"]);
 const externalMcpTargetsEnv = "BOSS_RECOMMEND_MCP_CONFIG_TARGETS";
 const externalSkillDirsEnv = "BOSS_RECOMMEND_EXTERNAL_SKILL_DIRS";
+const installConfigDefaults = Object.freeze({
+  llmThinkingLevel: "low",
+  humanRestEnabled: false
+});
 
 function getSkillSourceDir(name = skillName) {
   return path.join(packageRoot, "skills", name);
@@ -655,6 +659,21 @@ function resolveCliConfigTarget(options = {}) {
   };
 }
 
+function applyMissingInstallConfigDefaults(config = {}) {
+  const nextConfig = { ...config };
+  const patchedKeys = [];
+  for (const [key, defaultValue] of Object.entries(installConfigDefaults)) {
+    if (!Object.prototype.hasOwnProperty.call(nextConfig, key)) {
+      nextConfig[key] = defaultValue;
+      patchedKeys.push(key);
+    }
+  }
+  return {
+    nextConfig,
+    patchedKeys
+  };
+}
+
 function ensureUserConfig(options = {}) {
   const { configPath, workspacePreferred } = resolveCliConfigTarget(options);
   const writeTargets = dedupePaths([configPath, workspacePreferred]).filter(Boolean);
@@ -671,7 +690,27 @@ function ensureUserConfig(options = {}) {
       }
       const stat = fs.statSync(targetPath);
       if (stat.isFile()) {
-        return { path: targetPath, created: false };
+        try {
+          const existingConfig = readJsonObjectFile(targetPath);
+          const patched = applyMissingInstallConfigDefaults(existingConfig);
+          if (patched.patchedKeys.length > 0) {
+            fs.writeFileSync(targetPath, JSON.stringify(patched.nextConfig, null, 2), "utf8");
+          }
+          return {
+            path: targetPath,
+            created: false,
+            patched: patched.patchedKeys.length > 0,
+            patched_keys: patched.patchedKeys
+          };
+        } catch (error) {
+          return {
+            path: targetPath,
+            created: false,
+            patched: false,
+            patched_keys: [],
+            patch_error: error?.message || "screening-config.json 解析失败，跳过自动补字段。"
+          };
+        }
       }
       lastError = new Error(`Config target is a directory and cannot be used as file: ${targetPath}`);
     } catch (error) {
@@ -1286,6 +1325,11 @@ function installAll(options = {}) {
       ? `screening-config.json created: ${configResult.path}`
       : `screening-config.json already exists: ${configResult.path}`
   );
+  if (Array.isArray(configResult.patched_keys) && configResult.patched_keys.length > 0) {
+    console.log(`screening-config.json patched missing defaults: ${configResult.patched_keys.join(", ")}`);
+  } else if (configResult.patch_error) {
+    console.warn(`screening-config.json skip default patch: ${configResult.patch_error}`);
+  }
   console.log(`请在该目录修改 baseUrl/apiKey/model 并替换占位词后再运行：${path.dirname(configResult.path)}`);
   console.log(`MCP config templates exported to: ${mcpTemplateResult.outputDir}`);
   for (const item of mcpTemplateResult.files) {
@@ -1482,6 +1526,11 @@ export async function runCli(argv = process.argv) {
     case "init-config": {
       const result = ensureUserConfig(options);
       console.log(result.created ? `Config template created at: ${result.path}` : `Config already exists at: ${result.path}`);
+      if (Array.isArray(result.patched_keys) && result.patched_keys.length > 0) {
+        console.log(`Config patched missing defaults: ${result.patched_keys.join(", ")}`);
+      } else if (result.patch_error) {
+        console.warn(`Config skip default patch: ${result.patch_error}`);
+      }
       break;
     }
     case "set-port": {

package/src/test-boss-chat.js

@@ -755,8 +755,8 @@ async function testBossChatLlmShouldApplyThinkingDefaultsAndOverrides() {
     },
   });
   await volcClient.requestCompletions({ prompt: "prompt", evidenceCorpus: "resume" });
-  assert.deepEqual(volcCompletionPayload.thinking, { type: "disabled" });
-  assert.equal(volcCompletionPayload.reasoning_effort, "minimal");
+  assert.deepEqual(volcCompletionPayload.thinking, { type: "enabled" });
+  assert.equal(volcCompletionPayload.reasoning_effort, "low");
 
   let lowCompletionPayload = null;
   const lowClient = new LlmClient({
@@ -787,7 +787,7 @@ async function testBossChatLlmShouldApplyThinkingDefaultsAndOverrides() {
   });
   await openaiClient.requestCompletions({ prompt: "prompt", evidenceCorpus: "resume" });
   assert.equal(openaiCompletionPayload.thinking, undefined);
-  assert.equal(openaiCompletionPayload.reasoning_effort, "minimal");
+  assert.equal(openaiCompletionPayload.reasoning_effort, "low");
 
   let responsesPayload = null;
   const responsesClient = new LlmClient({

package/vendor/boss-chat-cli/src/runtime/interaction.js

@@ -47,7 +47,7 @@ export class InteractionController {
       return 0;
     }
 
-    const restMs = 0;
+    const restMs = 4000 + Math.floor(Math.random() * 4000);
     logger.log(`短暂休息 ${restMs}ms，保持处理节奏稳定...`);
     await this.wait(restMs);
     this.nextRestAt = processedCount + this.randomRestThreshold();

package/vendor/boss-chat-cli/src/services/llm.js

@@ -104,7 +104,7 @@ function resolveLlmThinkingLevel(config = {}, options = {}) {
     normalizeLlmThinkingLevel(config.reasoningEffort) ||
     normalizeLlmThinkingLevel(config.reasoning_effort) ||
     getEnvLlmThinkingLevel() ||
-    'off'
+    'low'
   );
 }
 
@@ -118,7 +118,7 @@ function isVolcengineModel(baseUrl, model) {
 }
 
 function applyChatCompletionThinking(payload, { baseUrl = '', model = '', thinkingLevel = '' } = {}) {
-  const level = normalizeLlmThinkingLevel(thinkingLevel) || 'off';
+  const level = normalizeLlmThinkingLevel(thinkingLevel) || 'low';
   if (isProviderDefaultThinkingLevel(level)) return payload;
   const isVolc = isVolcengineModel(baseUrl, model);
   if (isVolc) {
@@ -142,7 +142,7 @@ function applyChatCompletionThinking(payload, { baseUrl = '', model = '', thinki
 }
 
 function applyResponsesThinking(payload, { thinkingLevel = '' } = {}) {
-  const level = normalizeLlmThinkingLevel(thinkingLevel) || 'off';
+  const level = normalizeLlmThinkingLevel(thinkingLevel) || 'low';
   if (isProviderDefaultThinkingLevel(level) || level === 'auto') return payload;
   payload.reasoning = {
     ...(payload.reasoning || {}),

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

@@ -1288,7 +1288,7 @@ function getEnvLlmThinkingLevel() {
 }
 
 function resolveLlmThinkingLevel(value) {
-  return normalizeLlmThinkingLevel(value) || getEnvLlmThinkingLevel() || "off";
+  return normalizeLlmThinkingLevel(value) || getEnvLlmThinkingLevel() || "low";
 }
 
 function isVolcengineModel(baseUrl, model) {
@@ -1339,6 +1339,7 @@ function parseArgs(argv) {
     checkpointPath: null,
     pauseControlPath: null,
     resume: false,
+    humanRestEnabled: false,
     postAction: null,
     postActionConfirmed: null,
     help: false,
@@ -1353,6 +1354,7 @@ function parseArgs(argv) {
       pageScope: false,
       calibrationPath: false,
       port: false,
+      humanRest: false,
       postAction: false,
       postActionConfirmed: false
     }
@@ -1421,6 +1423,11 @@ function parseArgs(argv) {
     } else if (token === "--pause-control-path" && (inlineValue || next)) {
       parsed.pauseControlPath = path.resolve(inlineValue || next);
       if (!inlineValue) index += 1;
+    } else if ((token === "--human-rest" || token === "--humanRest" || token === "--human_rest") && (inlineValue || next)) {
+      const parsedBoolean = parseBoolean(inlineValue || next);
+      parsed.humanRestEnabled = parsedBoolean === true;
+      parsed.__provided.humanRest = parsedBoolean !== null;
+      if (!inlineValue) index += 1;
     } else if (token === "--resume") {
       parsed.resume = true;
     } else if ((token === "--post-action" || token === "--postAction") && (inlineValue || next)) {
@@ -5743,12 +5750,12 @@ class RecommendScreenCli {
   async takeBreakIfNeeded() {
     this.restCounter += 1;
     if (Math.random() < 0.08) {
-      const pauseMs = 0;
+      const pauseMs = this.args.humanRestEnabled ? 3000 + Math.floor(Math.random() * 4000) : 0;
       log(`[随机休息] 暂停 ${Math.round(pauseMs / 1000)} 秒`);
       await sleep(pauseMs);
     }
     if (this.restCounter >= this.restThreshold) {
-      const pauseMs = 0;
+      const pauseMs = this.args.humanRestEnabled ? 15000 + Math.floor(Math.random() * 15000) : 0;
       log(`[批次休息] 已连续处理 ${this.restCounter} 人，暂停 ${Math.round(pauseMs / 1000)} 秒`);
       await sleep(pauseMs);
       this.restCounter = 0;
@@ -6469,7 +6476,7 @@ async function main() {
     console.log(JSON.stringify({
         status: "COMPLETED",
         result: {
-          usage: "node boss-recommend-screen-cli.cjs --criteria \"有 MCP 开发经验\" --post-action <favorite|greet|none> --max-greet-count 10 --post-action-confirmed true --baseurl <url> --apikey <key> --model <model> --thinking-level off|low|medium|high|current --page-scope recommend|latest|featured --calibration <favorite-calibration.json> --port 9222 --output <csv-path> [--input-summary-json <json>] --checkpoint-path <checkpoint.json> --pause-control-path <pause-control.json> [--resume]"
+          usage: "node boss-recommend-screen-cli.cjs --criteria \"有 MCP 开发经验\" --post-action <favorite|greet|none> --max-greet-count 10 --post-action-confirmed true --baseurl <url> --apikey <key> --model <model> --thinking-level off|low|medium|high|current --page-scope recommend|latest|featured --calibration <favorite-calibration.json> --port 9222 --human-rest <true|false> --output <csv-path> [--input-summary-json <json>] --checkpoint-path <checkpoint.json> --pause-control-path <pause-control.json> [--resume]"
         }
       }));
     return;

package/vendor/boss-recommend-screen-cli/test-recoverable-resume-failures.cjs

@@ -1525,8 +1525,8 @@ async function testCallTextModelShouldFallbackToChunkModeOnContextLimit() {
   }
 }
 
-async function testTextModelShouldDefaultThinkingOffForVolcengine() {
-  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-thinking-off-"));
+async function testTextModelShouldDefaultThinkingLowForVolcengine() {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-thinking-low-default-"));
   const cli = new RecommendScreenCli(createArgs(tempDir));
   cli.args.baseUrl = "https://ark.cn-beijing.volces.com/api/v3";
   cli.args.model = "doubao-seed-2-0-mini-260215";
@@ -1552,8 +1552,8 @@ async function testTextModelShouldDefaultThinkingOffForVolcengine() {
   };
   try {
     await cli.callTextModel("resume");
-    assert.deepEqual(capturedPayload?.thinking, { type: "disabled" });
-    assert.equal(capturedPayload?.reasoning_effort, "minimal");
+    assert.deepEqual(capturedPayload?.thinking, { type: "enabled" });
+    assert.equal(capturedPayload?.reasoning_effort, "low");
   } finally {
     global.fetch = originalFetch;
   }
@@ -1812,7 +1812,7 @@ async function main() {
   testParseArgsShouldSupportInputSummaryJson();
   await testCallTextModelShouldNotTruncateLongResume();
   await testCallTextModelShouldFallbackToChunkModeOnContextLimit();
-  await testTextModelShouldDefaultThinkingOffForVolcengine();
+  await testTextModelShouldDefaultThinkingLowForVolcengine();
   await testTextModelShouldSupportLowThinkingForVolcengine();
   await testPrepareVisionImageSegmentsShouldSplitLongImage();
   await testVisionEvidenceGateShouldDemoteImageFallbackWithoutEvidence();