@reconcrap/boss-recommend-mcp 1.3.16 → 1.3.18

package/README.md

@@ -167,6 +167,7 @@ config/screening-config.example.json
 - `openaiProject`
 - `debugPort`
 - `outputDir`
+- `llmThinkingLevel`：默认 `off`。可设为 `off/minimal/low/medium/high/auto/current`，用于控制 OpenAI-compatible LLM 的 thinking/reasoning 强度。
 
 ## 常用命令
 
@@ -175,7 +176,7 @@ npm 包安装后可直接使用可执行命令 `boss-recommend-mcp`。以下示
 ```bash
 node src/cli.js install --agent trae-cn
 node src/cli.js init-config
-node src/cli.js config set --base-url https://api.openai.com/v1 --api-key <your-key> --model gpt-4o-mini
+node src/cli.js config set --base-url https://api.openai.com/v1 --api-key <your-key> --model gpt-4o-mini --thinking-level off
 node src/cli.js set-port --port 9222
 node src/cli.js doctor --agent trae-cn
 node src/cli.js launch-chrome --port 9222

package/config/screening-config.example.json

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

package/package.json

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

package/src/adapters.js

@@ -21,6 +21,12 @@ const screenConfigTemplateDefaults = {
   apiKey: "replace-with-openai-api-key",
   model: "gpt-4.1-mini"
 };
+const LLM_THINKING_LEVEL_FIELDS = [
+  "llmThinkingLevel",
+  "thinkingLevel",
+  "reasoningEffort",
+  "reasoning_effort"
+];
 const DEFAULT_RECOMMEND_SCREEN_TIMEOUT_MS = 24 * 60 * 60 * 1000;
 const PAGE_SCOPE_TO_TAB_STATUS = {
   recommend: "0",
@@ -324,7 +330,7 @@ function readJsonFile(filePath) {
   }
 }
 
-function validateScreenConfig(config) {
+function validateScreenConfig(config) {
   if (!config || typeof config !== "object" || Array.isArray(config)) {
     return {
       ok: false,
@@ -364,8 +370,17 @@ function validateScreenConfig(config) {
       message: "screening-config.json 仍是默认模板值，请填写 baseUrl、apiKey、model。"
     };
   }
-  return { ok: true, reason: "OK", message: "screening-config.json 校验通过。" };
-}
+  return { ok: true, reason: "OK", message: "screening-config.json 校验通过。" };
+}
+
+function resolveLlmThinkingLevel(config = {}) {
+  if (!config || typeof config !== "object") return "";
+  for (const field of LLM_THINKING_LEVEL_FIELDS) {
+    const value = String(config[field] ?? "").trim();
+    if (value) return value;
+  }
+  return "";
+}
 
 function resolveWorkspaceDebugPort(workspaceRoot) {
   const fromEnv = parsePositiveInteger(process.env.BOSS_RECOMMEND_CHROME_PORT);
@@ -2915,12 +2930,16 @@ export async function runRecommendScreenCli({
   if (loaded.config.openaiOrganization) {
     args.push("--openai-organization", loaded.config.openaiOrganization);
   }
-  if (loaded.config.openaiProject) {
-    args.push("--openai-project", loaded.config.openaiProject);
-  }
-  if (Number.isInteger(screenParams.target_count) && screenParams.target_count > 0) {
-    args.push("--targetCount", String(screenParams.target_count));
-  }
+  if (loaded.config.openaiProject) {
+    args.push("--openai-project", loaded.config.openaiProject);
+  }
+  const llmThinkingLevel = resolveLlmThinkingLevel(loaded.config);
+  if (llmThinkingLevel) {
+    args.push("--thinking-level", llmThinkingLevel);
+  }
+  if (Number.isInteger(screenParams.target_count) && screenParams.target_count > 0) {
+    args.push("--targetCount", String(screenParams.target_count));
+  }
   if (screenParams.post_action === "greet"
     && Number.isInteger(screenParams.max_greet_count)
     && screenParams.max_greet_count > 0) {

package/src/boss-chat.js

@@ -16,6 +16,12 @@ const BOSS_CHAT_TERMINAL_STATES = new Set(["completed", "failed", "canceled"]);
 const CHAT_REQUIRED_FIELDS = ["job", "start_from", "target_count", "criteria"];
 export const TARGET_COUNT_ACCEPTED_EXAMPLES = ["all", -1, 20, "全部候选人"];
 const TARGET_COUNT_WRAPPER_KEYS = ["target_count", "targetCount", "value", "count", "limit"];
+const LLM_THINKING_LEVEL_FIELDS = [
+  "llmThinkingLevel",
+  "thinkingLevel",
+  "reasoningEffort",
+  "reasoning_effort"
+];
 
 function normalizeText(value) {
   return String(value || "").replace(/\s+/g, " ").trim();
@@ -228,6 +234,15 @@ function validateRecommendScreenConfig(config) {
   return { ok: true };
 }
 
+function resolveLlmThinkingLevel(config = {}) {
+  if (!config || typeof config !== "object") return "";
+  for (const field of LLM_THINKING_LEVEL_FIELDS) {
+    const value = normalizeText(config[field]);
+    if (value) return value;
+  }
+  return "";
+}
+
 function resolveBossChatScreenConfig(workspaceRoot) {
   const resolution = getScreenConfigResolution(workspaceRoot);
   const configPath = resolution.resolved_path || resolution.writable_path || resolution.legacy_path || null;
@@ -274,6 +289,7 @@ function resolveBossChatScreenConfig(workspaceRoot) {
       baseUrl: normalizeText(parsed.baseUrl).replace(/\/+$/, ""),
       apiKey: normalizeText(parsed.apiKey),
       model: normalizeText(parsed.model),
+      llmThinkingLevel: resolveLlmThinkingLevel(parsed),
       debugPort: parsePositiveInteger(parsed.debugPort, 9222)
     },
     config_path: configPath,
@@ -385,6 +401,9 @@ function buildBossChatCliArgs(command, input, resolvedConfig) {
     args.push("--baseurl", resolvedConfig.baseUrl);
     args.push("--apikey", resolvedConfig.apiKey);
     args.push("--model", resolvedConfig.model);
+    if (resolvedConfig.llmThinkingLevel) {
+      args.push("--thinking-level", resolvedConfig.llmThinkingLevel);
+    }
     return args;
   }
 
@@ -402,6 +421,9 @@ function buildBossChatCliArgs(command, input, resolvedConfig) {
     args.push("--baseurl", resolvedConfig.baseUrl);
     args.push("--apikey", resolvedConfig.apiKey);
     args.push("--model", resolvedConfig.model);
+    if (resolvedConfig.llmThinkingLevel) {
+      args.push("--thinking-level", resolvedConfig.llmThinkingLevel);
+    }
     args.push("--port", String(normalized.port || resolvedConfig.debugPort || 9222));
     if (typeof normalized.safePacing === "boolean") {
       args.push("--safe-pacing", String(normalized.safePacing));

package/src/cli.js

@@ -768,6 +768,11 @@ function setScreeningConfig(options = {}) {
     apiKey,
     model
   };
+  if (typeof options["thinking-level"] === "string" && options["thinking-level"].trim()) {
+    nextConfig.llmThinkingLevel = options["thinking-level"].trim();
+  } else if (typeof options.llmThinkingLevel === "string" && options.llmThinkingLevel.trim()) {
+    nextConfig.llmThinkingLevel = options.llmThinkingLevel.trim();
+  }
   if (typeof options["openai-organization"] === "string") {
     nextConfig.openaiOrganization = options["openai-organization"];
   }
@@ -1247,7 +1252,7 @@ function printHelp() {
   console.log("Run command:");
   console.log("  boss-recommend-mcp run --instruction \"推荐页上筛选211男生，近14天没有，有大模型平台经验\" [--confirmation-json '{...}'] [--overrides-json '{...}'] [--follow-up-json '{...}']");
   console.log("  boss-recommend-mcp chat run --job \"算法工程师\" --start-from unread --criteria \"有 AI Agent 经验\" --targetCount 20    # 后台启动，不自动轮询");
-  console.log("  boss-recommend-mcp config set --base-url <url> --api-key <key> --model <model> [--openai-organization <id>] [--openai-project <id>]");
+  console.log("  boss-recommend-mcp config set --base-url <url> --api-key <key> --model <model> [--thinking-level off|low|medium|high|current] [--openai-organization <id>] [--openai-project <id>]");
   console.log("  boss-recommend-mcp install --agent trae-cn");
   console.log("  boss-recommend-mcp doctor --agent trae-cn --page-scope featured");
   console.log("  boss-recommend-mcp calibrate --port 9222 [--timeout-ms 60000] [--output <path>]");

package/src/test-boss-chat.js

@@ -717,6 +717,94 @@ async function testBossChatLlmTextChunkFallbackShouldWork() {
   }
 }
 
+async function testBossChatLlmShouldApplyThinkingDefaultsAndOverrides() {
+  const completionResponse = {
+    ok: true,
+    status: 200,
+    async json() {
+      return {
+        choices: [
+          {
+            message: {
+              content: "{\"passed\": false, \"reason\": \"not matched\", \"summary\": \"not matched\", \"evidence\": [\"resume\"]}"
+            }
+          }
+        ]
+      };
+    }
+  };
+  const responsesResponse = {
+    ok: true,
+    status: 200,
+    async json() {
+      return {
+        output_text: "{\"passed\": false, \"reason\": \"not matched\", \"summary\": \"not matched\", \"evidence\": [\"resume\"]}"
+      };
+    }
+  };
+
+  let volcCompletionPayload = null;
+  const volcClient = new LlmClient({
+    baseUrl: "https://ark.cn-beijing.volces.com/api/v3",
+    apiKey: "sk-test",
+    model: "doubao-seed-2-0-mini-260215",
+  }, {
+    fetchImpl: async (_url, options = {}) => {
+      volcCompletionPayload = JSON.parse(String(options.body || "{}"));
+      return completionResponse;
+    },
+  });
+  await volcClient.requestCompletions({ prompt: "prompt", evidenceCorpus: "resume" });
+  assert.deepEqual(volcCompletionPayload.thinking, { type: "disabled" });
+  assert.equal(volcCompletionPayload.reasoning_effort, "minimal");
+
+  let lowCompletionPayload = null;
+  const lowClient = new LlmClient({
+    baseUrl: "https://ark.cn-beijing.volces.com/api/v3",
+    apiKey: "sk-test",
+    model: "doubao-seed-2-0-mini-260215",
+    thinkingLevel: "low",
+  }, {
+    fetchImpl: async (_url, options = {}) => {
+      lowCompletionPayload = JSON.parse(String(options.body || "{}"));
+      return completionResponse;
+    },
+  });
+  await lowClient.requestCompletions({ prompt: "prompt", evidenceCorpus: "resume" });
+  assert.deepEqual(lowCompletionPayload.thinking, { type: "enabled" });
+  assert.equal(lowCompletionPayload.reasoning_effort, "low");
+
+  let openaiCompletionPayload = null;
+  const openaiClient = new LlmClient({
+    baseUrl: "https://api.openai.com/v1",
+    apiKey: "sk-test",
+    model: "gpt-test",
+  }, {
+    fetchImpl: async (_url, options = {}) => {
+      openaiCompletionPayload = JSON.parse(String(options.body || "{}"));
+      return completionResponse;
+    },
+  });
+  await openaiClient.requestCompletions({ prompt: "prompt", evidenceCorpus: "resume" });
+  assert.equal(openaiCompletionPayload.thinking, undefined);
+  assert.equal(openaiCompletionPayload.reasoning_effort, "minimal");
+
+  let responsesPayload = null;
+  const responsesClient = new LlmClient({
+    baseUrl: "https://api.openai.com/v1",
+    apiKey: "sk-test",
+    model: "gpt-test",
+    thinkingLevel: "low",
+  }, {
+    fetchImpl: async (_url, options = {}) => {
+      responsesPayload = JSON.parse(String(options.body || "{}"));
+      return responsesResponse;
+    },
+  });
+  await responsesClient.requestResponses({ prompt: "prompt", evidenceCorpus: "resume" });
+  assert.deepEqual(responsesPayload.reasoning, { effort: "low" });
+}
+
 async function testBossChatAppShouldPersistEvidenceArtifacts() {
   const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "boss-chat-artifacts-"));
   await mkdir(tempDir, { recursive: true });
@@ -846,6 +934,7 @@ async function main() {
   testBossChatLlmEvidenceGateShouldDemoteMissingEvidence();
   testBossChatLlmEvidenceGateShouldDemoteUnmatchedEvidence();
   await testBossChatLlmTextChunkFallbackShouldWork();
+  await testBossChatLlmShouldApplyThinkingDefaultsAndOverrides();
   await testBossChatAppShouldPersistEvidenceArtifacts();
   console.log("boss-chat tests passed");
 }

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

@@ -249,6 +249,12 @@ function parseArgs(argv) {
       case 'model':
         args.overrides.llm.model = value || '';
         break;
+      case 'thinking-level':
+      case 'thinkingLevel':
+      case 'llm-thinking-level':
+      case 'reasoning-effort':
+        args.overrides.llm.thinkingLevel = value || '';
+        break;
       case 'port':
         args.overrides.chrome.port = Number.parseInt(value, 10);
         break;
@@ -299,6 +305,7 @@ function printUsage() {
   console.log('  --baseurl <url>                 Override LLM base URL');
   console.log('  --apikey <key>                  Override LLM API key');
   console.log('  --model <name>                  Override LLM model');
+  console.log('  --thinking-level <level>        LLM thinking level: off|low|medium|high|current');
   console.log('  --port <n>                      Override Chrome remote debugging port');
 }
 
@@ -768,6 +775,9 @@ function buildDetachedRunArgs(args, runId) {
   if (args.overrides.llm.model) {
     workerArgs.push('--model', String(args.overrides.llm.model));
   }
+  if (args.overrides.llm.thinkingLevel) {
+    workerArgs.push('--thinking-level', String(args.overrides.llm.thinkingLevel));
+  }
   if (Number.isFinite(args.overrides.chrome.port)) {
     workerArgs.push('--port', String(args.overrides.chrome.port));
   }

package/vendor/boss-chat-cli/src/mcp/server.js

@@ -74,6 +74,7 @@ function registerTools(server) {
         baseUrl: z.string().optional().describe('覆盖 LLM baseUrl'),
         apiKey: z.string().optional().describe('覆盖 LLM apiKey'),
         model: z.string().optional().describe('覆盖 LLM 模型'),
+        thinkingLevel: z.string().optional().describe('覆盖 LLM thinking/reasoning 级别：off/low/medium/high/current'),
         port: z.number().int().positive().optional().describe('Chrome 调试端口'),
         safePacing: z.boolean().optional().describe('是否启用安全节奏控制'),
         batchRestEnabled: z.boolean().optional().describe('是否启用批次休息'),
@@ -146,4 +147,3 @@ main().catch((error) => {
   console.error('[boss-chat-mcp] server failed:', error?.stack || error?.message || String(error));
   process.exit(1);
 });
-

package/vendor/boss-chat-cli/src/mcp/tool-runtime.js

@@ -71,6 +71,7 @@ export function buildCliArgs(command, input = {}) {
       pushValueArg(args, 'baseurl', input.baseUrl);
       pushValueArg(args, 'apikey', input.apiKey);
       pushValueArg(args, 'model', input.model);
+      pushValueArg(args, 'thinking-level', input.thinkingLevel || input.llmThinkingLevel || input.reasoningEffort);
 
       const port = normalizePositiveInt(input.port);
       if (port) {
@@ -190,4 +191,3 @@ export async function runCliJsonCommand(command, input = {}) {
     });
   });
 }
-

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

@@ -4,6 +4,12 @@ const DEFAULT_TEXT_MODEL_CHUNK_SIZE_CHARS = 24000;
 const DEFAULT_TEXT_MODEL_CHUNK_OVERLAP_CHARS = 1200;
 const DEFAULT_TEXT_MODEL_MAX_CHUNKS = 12;
 const MAX_EVIDENCE_TOKENS = 12;
+const LLM_THINKING_ENV_KEYS = [
+  'BOSS_CHAT_LLM_THINKING_LEVEL',
+  'BOSS_RECOMMEND_LLM_THINKING_LEVEL',
+  'BOSS_LLM_THINKING_LEVEL',
+  'LLM_THINKING_LEVEL',
+];
 
 function normalizeText(value) {
   return String(value || '').replace(/\s+/g, ' ').trim();
@@ -67,6 +73,84 @@ function normalizeBool(value, fallback = false) {
   return fallback;
 }
 
+function normalizeLlmThinkingLevel(value) {
+  const normalized = normalizeText(value).toLowerCase().replace(/[_\s]+/g, '-');
+  if (!normalized) return '';
+  if (['off', 'disabled', 'disable', 'minimal', 'none', 'false', '0'].includes(normalized)) return 'off';
+  if (
+    ['low', 'medium', 'high', 'auto', 'current', 'default', 'provider-default', 'unchanged', 'inherit'].includes(
+      normalized,
+    )
+  ) {
+    return normalized;
+  }
+  return '';
+}
+
+function getEnvLlmThinkingLevel() {
+  for (const key of LLM_THINKING_ENV_KEYS) {
+    const normalized = normalizeLlmThinkingLevel(process.env[key]);
+    if (normalized) return normalized;
+  }
+  return '';
+}
+
+function resolveLlmThinkingLevel(config = {}, options = {}) {
+  return (
+    normalizeLlmThinkingLevel(options.thinkingLevel) ||
+    normalizeLlmThinkingLevel(options.llmThinkingLevel) ||
+    normalizeLlmThinkingLevel(config.llmThinkingLevel) ||
+    normalizeLlmThinkingLevel(config.thinkingLevel) ||
+    normalizeLlmThinkingLevel(config.reasoningEffort) ||
+    normalizeLlmThinkingLevel(config.reasoning_effort) ||
+    getEnvLlmThinkingLevel() ||
+    'off'
+  );
+}
+
+function isProviderDefaultThinkingLevel(level) {
+  return ['current', 'default', 'provider-default', 'unchanged', 'inherit'].includes(level);
+}
+
+function isVolcengineModel(baseUrl, model) {
+  const combined = `${baseUrl || ''} ${model || ''}`;
+  return /volces\.com|volcengine|ark\.cn-|doubao|seed/i.test(combined);
+}
+
+function applyChatCompletionThinking(payload, { baseUrl = '', model = '', thinkingLevel = '' } = {}) {
+  const level = normalizeLlmThinkingLevel(thinkingLevel) || 'off';
+  if (isProviderDefaultThinkingLevel(level)) return payload;
+  const isVolc = isVolcengineModel(baseUrl, model);
+  if (isVolc) {
+    if (level === 'auto') {
+      payload.thinking = { type: 'auto' };
+      return payload;
+    }
+    if (level === 'off') {
+      payload.thinking = { type: 'disabled' };
+      payload.reasoning_effort = 'minimal';
+      return payload;
+    }
+    payload.thinking = { type: 'enabled' };
+    payload.reasoning_effort = level;
+    return payload;
+  }
+  if (level !== 'auto') {
+    payload.reasoning_effort = level === 'off' ? 'minimal' : level;
+  }
+  return payload;
+}
+
+function applyResponsesThinking(payload, { thinkingLevel = '' } = {}) {
+  const level = normalizeLlmThinkingLevel(thinkingLevel) || 'off';
+  if (isProviderDefaultThinkingLevel(level) || level === 'auto') return payload;
+  payload.reasoning = {
+    ...(payload.reasoning || {}),
+    effort: level === 'off' ? 'minimal' : level,
+  };
+  return payload;
+}
+
 function toStringArray(value, maxItems = 8) {
   if (!Array.isArray(value)) return [];
   const normalized = [];
@@ -378,8 +462,9 @@ export class LlmClient {
       options.preferCompletions !== undefined
         ? normalizeBool(options.preferCompletions, false)
         : config.preferCompletions !== undefined
-          ? normalizeBool(config.preferCompletions, false)
-          : /doubao|seed/i.test(String(this.model || ''));
+        ? normalizeBool(config.preferCompletions, false)
+        : /doubao|seed/i.test(String(this.model || ''));
+    this.thinkingLevel = resolveLlmThinkingLevel(config, options);
   }
 
   async readImageAsDataUrl(imagePath) {
@@ -405,23 +490,26 @@ export class LlmClient {
     if (imageDataUrl) {
       content.push({ type: 'input_image', image_url: imageDataUrl });
     }
+    const payload = {
+      model: this.model,
+      temperature: 0.1,
+      max_output_tokens: this.responseMaxOutputTokens,
+      input: [
+        {
+          role: 'user',
+          content,
+        },
+      ],
+    };
+    applyResponsesThinking(payload, { thinkingLevel: this.thinkingLevel });
+
     const response = await this.fetchImpl(`${this.baseUrl}/responses`, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
         Authorization: `Bearer ${this.apiKey}`,
       },
-      body: JSON.stringify({
-        model: this.model,
-        temperature: 0.1,
-        max_output_tokens: this.responseMaxOutputTokens,
-        input: [
-          {
-            role: 'user',
-            content,
-          },
-        ],
-      }),
+      body: JSON.stringify(payload),
       signal: AbortSignal.timeout(this.timeoutMs),
     });
 
@@ -477,23 +565,30 @@ export class LlmClient {
     if (imageDataUrl) {
       content.push({ type: 'image_url', image_url: { url: imageDataUrl } });
     }
+    const payload = {
+      model: this.model,
+      temperature: 0.1,
+      max_tokens: this.completionMaxTokens,
+      messages: [
+        {
+          role: 'user',
+          content,
+        },
+      ],
+    };
+    applyChatCompletionThinking(payload, {
+      baseUrl: this.baseUrl,
+      model: this.model,
+      thinkingLevel: this.thinkingLevel,
+    });
+
     const response = await this.fetchImpl(`${this.baseUrl}/chat/completions`, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
         Authorization: `Bearer ${this.apiKey}`,
       },
-      body: JSON.stringify({
-        model: this.model,
-        temperature: 0.1,
-        max_tokens: this.completionMaxTokens,
-        messages: [
-          {
-            role: 'user',
-            content,
-          },
-        ],
-      }),
+      body: JSON.stringify(payload),
       signal: AbortSignal.timeout(this.timeoutMs),
     });
 

package/vendor/boss-chat-cli/src/services/profile-store.js

@@ -10,6 +10,7 @@ const DEFAULT_PROFILE = {
     baseUrl: '',
     apiKey: '',
     model: '',
+    thinkingLevel: '',
   },
   chrome: {
     port: 9222,
@@ -78,6 +79,7 @@ export function toPersistentProfile(profile = {}) {
       baseUrl: normalized.llm.baseUrl,
       apiKey: normalized.llm.apiKey,
       model: normalized.llm.model,
+      thinkingLevel: normalized.llm.thinkingLevel,
     },
     chrome: {
       port: normalized.chrome.port,
@@ -99,6 +101,9 @@ export function normalizeProfile(profile = {}) {
   merged.llm.baseUrl = String(merged.llm.baseUrl || '').trim().replace(/\/+$/, '');
   merged.llm.apiKey = String(merged.llm.apiKey || '').trim();
   merged.llm.model = String(merged.llm.model || '').trim();
+  merged.llm.thinkingLevel = String(
+    merged.llm.thinkingLevel || merged.llm.llmThinkingLevel || merged.llm.reasoningEffort || merged.llm.reasoning_effort || '',
+  ).trim();
   merged.runtime.batchRestEnabled = merged.runtime.batchRestEnabled !== false;
   merged.runtime.safePacing = merged.runtime.safePacing !== false;
   return merged;