@reconcrap/boss-recommend-mcp 1.3.29 → 1.3.31

package/README.md

@@ -68,6 +68,7 @@ MCP 工具：
 - 在真正开始 search/screen 前，会进行最后一轮全参数总确认（岗位 + 全部筛选参数 + criteria + target_count + post_action + max_greet_count）
 - npm 全局安装后会自动执行 install：生成 skill、导出 MCP 模板，并自动尝试写入已检测到的外部 agent MCP 配置（含 Trae / trae-cn / Cursor / Claude / OpenClaw）
 - npm / npx 安装后会自动初始化 `screening-config.json` 模板（优先写入 workspace 的 `config/`，不可写时回退到用户目录）
+- npm 安装流程会预创建运行目录（跨平台）：`~/.boss-recommend-mcp`、`~/.boss-recommend-mcp/runs`、`<workspace>/.boss-chat` 及其 `logs/runs/profiles/reports/artifacts`
 - `post_action` 必须在每次完整运行开始时确认一次
 - `target_count` 会在每次运行开始时询问一次（可留空，不设上限）
 - 当 `post_action=greet` 时，必须在运行开始时确认 `max_greet_count`

package/config/screening-config.example.json

@@ -3,6 +3,8 @@
   "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"

package/package.json

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

package/src/adapters.js

@@ -27,6 +27,8 @@ const LLM_THINKING_LEVEL_FIELDS = [
   "reasoningEffort",
   "reasoning_effort"
 ];
+const DEFAULT_SHARED_LLM_TIMEOUT_MS = 60000;
+const DEFAULT_SHARED_LLM_MAX_RETRIES = 3;
 const DEFAULT_RECOMMEND_SCREEN_TIMEOUT_MS = 24 * 60 * 60 * 1000;
 const PAGE_SCOPE_TO_TAB_STATUS = {
   recommend: "0",
@@ -405,6 +407,19 @@ function resolveLlmThinkingLevel(config = {}) {
   }
   return "";
 }
+
+export function resolveSharedLlmTransportConfig(config = {}) {
+  const timeoutMs = parsePositiveInteger(config?.llmTimeoutMs)
+    || parsePositiveInteger(config?.llm_timeout_ms)
+    || DEFAULT_SHARED_LLM_TIMEOUT_MS;
+  const maxRetries = parsePositiveInteger(config?.llmMaxRetries)
+    || parsePositiveInteger(config?.llm_max_retries)
+    || DEFAULT_SHARED_LLM_MAX_RETRIES;
+  return {
+    llmTimeoutMs: timeoutMs,
+    llmMaxRetries: maxRetries
+  };
+}
 
 function resolveWorkspaceDebugPort(workspaceRoot) {
   const fromEnv = parsePositiveInteger(process.env.BOSS_RECOMMEND_CHROME_PORT);
@@ -2961,6 +2976,13 @@ export async function runRecommendScreenCli({
   if (llmThinkingLevel) {
     args.push("--thinking-level", llmThinkingLevel);
   }
+  const sharedLlmTransport = resolveSharedLlmTransportConfig(loaded.config);
+  if (sharedLlmTransport.llmTimeoutMs) {
+    args.push("--llm-timeout-ms", String(sharedLlmTransport.llmTimeoutMs));
+  }
+  if (sharedLlmTransport.llmMaxRetries) {
+    args.push("--llm-max-retries", String(sharedLlmTransport.llmMaxRetries));
+  }
   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

@@ -4,7 +4,7 @@ import process from "node:process";
 import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 
-import { getScreenConfigResolution } from "./adapters.js";
+import { getScreenConfigResolution, resolveSharedLlmTransportConfig } from "./adapters.js";
 
 const currentFilePath = fileURLToPath(import.meta.url);
 const packageRoot = path.resolve(path.dirname(currentFilePath), "..");
@@ -364,6 +364,7 @@ function resolveBossChatScreenConfig(workspaceRoot) {
       apiKey: normalizeText(parsed.apiKey),
       model: normalizeText(parsed.model),
       llmThinkingLevel: resolveLlmThinkingLevel(parsed),
+      ...resolveSharedLlmTransportConfig(parsed),
       debugPort: parsePositiveInteger(parsed.debugPort, 9222),
       humanRestEnabled: resolveHumanRestEnabled(parsed)
     },
@@ -484,6 +485,12 @@ function buildBossChatCliArgs(command, input, resolvedConfig) {
     if (resolvedConfig.llmThinkingLevel) {
       args.push("--thinking-level", resolvedConfig.llmThinkingLevel);
     }
+    if (resolvedConfig.llmTimeoutMs) {
+      args.push("--llm-timeout-ms", String(resolvedConfig.llmTimeoutMs));
+    }
+    if (resolvedConfig.llmMaxRetries) {
+      args.push("--llm-max-retries", String(resolvedConfig.llmMaxRetries));
+    }
     return args;
   }
 
@@ -504,6 +511,12 @@ function buildBossChatCliArgs(command, input, resolvedConfig) {
     if (resolvedConfig.llmThinkingLevel) {
       args.push("--thinking-level", resolvedConfig.llmThinkingLevel);
     }
+    if (resolvedConfig.llmTimeoutMs) {
+      args.push("--llm-timeout-ms", String(resolvedConfig.llmTimeoutMs));
+    }
+    if (resolvedConfig.llmMaxRetries) {
+      args.push("--llm-max-retries", String(resolvedConfig.llmMaxRetries));
+    }
     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

@@ -742,6 +742,70 @@ function ensureUserConfig(options = {}) {
   throw lastError || new Error("No writable target for screening-config.json");
 }
 
+function getBossChatDataDir(workspaceRoot) {
+  return path.join(path.resolve(String(workspaceRoot || process.cwd())), ".boss-chat");
+}
+
+function collectRuntimeDirectories(options = {}) {
+  const workspaceRoot = getWorkspaceRoot(options);
+  const stateHome = getStateHome();
+  const bossChatRoot = getBossChatDataDir(workspaceRoot);
+  const recommendRuntimeDirs = [
+    stateHome,
+    path.join(stateHome, "runs")
+  ];
+  const bossChatRuntimeDirs = [
+    bossChatRoot,
+    path.join(bossChatRoot, "logs"),
+    path.join(bossChatRoot, "runs"),
+    path.join(bossChatRoot, "profiles"),
+    path.join(bossChatRoot, "reports"),
+    path.join(bossChatRoot, "artifacts")
+  ];
+  return {
+    workspaceRoot,
+    stateHome,
+    bossChatRoot,
+    directories: dedupePaths([
+      ...recommendRuntimeDirs,
+      ...bossChatRuntimeDirs
+    ]).filter(Boolean)
+  };
+}
+
+function ensureRuntimeDirectories(options = {}) {
+  const { workspaceRoot, stateHome, bossChatRoot, directories } = collectRuntimeDirectories(options);
+  const created = [];
+  const existed = [];
+  const failed = [];
+
+  for (const directory of directories) {
+    try {
+      const existedBefore = fs.existsSync(directory);
+      ensureDir(directory);
+      if (existedBefore) {
+        existed.push(directory);
+      } else {
+        created.push(directory);
+      }
+    } catch (error) {
+      failed.push({
+        path: directory,
+        message: error?.message || String(error)
+      });
+    }
+  }
+
+  return {
+    workspaceRoot,
+    stateHome,
+    bossChatRoot,
+    created,
+    existed,
+    failed
+  };
+}
+
 function readJsonObjectFile(filePath) {
   const raw = fs.readFileSync(filePath, "utf8");
   const parsed = JSON.parse(raw);
@@ -1333,11 +1397,22 @@ function printMcpConfig(options = {}) {
 }
 
 function installAll(options = {}) {
+  const runtimeDirsResult = ensureRuntimeDirectories(options);
   const skillResults = installSkill();
   const configResult = ensureUserConfig(options);
   const mcpTemplateResult = writeMcpConfigFiles({ client: "all" });
   const externalMcpResult = installExternalMcpConfigs(options);
   const externalSkillResult = mirrorSkillToExternalDirs(options);
+  console.log(
+    `Runtime directories prepared: created=${runtimeDirsResult.created.length}, existing=${runtimeDirsResult.existed.length}, failed=${runtimeDirsResult.failed.length}`
+  );
+  console.log(`- recommend runtime: ${runtimeDirsResult.stateHome}`);
+  console.log(`- boss-chat runtime: ${runtimeDirsResult.bossChatRoot}`);
+  if (runtimeDirsResult.failed.length > 0) {
+    for (const item of runtimeDirsResult.failed) {
+      console.warn(`Runtime dir warning: ${item.path} -> ${item.message}`);
+    }
+  }
   console.log(`Bundled skills installed: ${skillResults.length}`);
   for (const item of skillResults) {
     console.log(`- ${item.skill}: ${item.targetDir}`);
@@ -1546,7 +1621,18 @@ export async function runCli(argv = process.argv) {
       }
       break;
     case "init-config": {
+      const runtimeDirsResult = ensureRuntimeDirectories(options);
       const result = ensureUserConfig(options);
+      console.log(
+        `Runtime directories prepared: created=${runtimeDirsResult.created.length}, existing=${runtimeDirsResult.existed.length}, failed=${runtimeDirsResult.failed.length}`
+      );
+      console.log(`- recommend runtime: ${runtimeDirsResult.stateHome}`);
+      console.log(`- boss-chat runtime: ${runtimeDirsResult.bossChatRoot}`);
+      if (runtimeDirsResult.failed.length > 0) {
+        for (const item of runtimeDirsResult.failed) {
+          console.warn(`Runtime dir warning: ${item.path} -> ${item.message}`);
+        }
+      }
       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(", ")}`);
@@ -1635,6 +1721,7 @@ export const __testables = {
   getRunFollowUp,
   installSkill,
   isInstalledPackageRoot,
+  ensureRuntimeDirectories,
   runBossChatCliCommand,
   runPipelineOnce
 };

package/src/test-adapters-runtime.js

@@ -7,6 +7,7 @@ import {
   runPipelinePreflight,
   runRecommendSearchCli,
   runRecommendScreenCli,
+  resolveSharedLlmTransportConfig,
   __testables as adapterTestables
 } from "./adapters.js";
 
@@ -107,6 +108,23 @@ function testResolveScreenTimeoutDefaultsTo24Hours() {
   }
 }
 
+function testResolveSharedLlmTransportConfigShouldUseDefaultsAndOverrides() {
+  assert.deepEqual(resolveSharedLlmTransportConfig({}), {
+    llmTimeoutMs: 60000,
+    llmMaxRetries: 3,
+  });
+  assert.deepEqual(
+    resolveSharedLlmTransportConfig({
+      llmTimeoutMs: 90000,
+      llmMaxRetries: 5,
+    }),
+    {
+      llmTimeoutMs: 90000,
+      llmMaxRetries: 5,
+    },
+  );
+}
+
 function testBuildRecommendScreenProcessErrorMapsTimeout() {
   const error = buildRecommendScreenProcessError({ code: -1, error_code: "TIMEOUT" }, 86400000);
   assert.equal(error?.code, "TIMEOUT");
@@ -155,6 +173,76 @@ async function testResumeRequiresCheckpointFile() {
   }
 }
 
+async function testRecommendScreenCliShouldPassSharedLlmTransportArgs() {
+  const workspaceRoot = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-screen-stub-"));
+  const screenDir = path.join(workspaceRoot, "boss-recommend-screen-cli");
+  const tempHome = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-screen-home-"));
+  const previousHome = process.env.BOSS_RECOMMEND_HOME;
+  fs.mkdirSync(screenDir, { recursive: true });
+  fs.writeFileSync(
+    path.join(screenDir, "boss-recommend-screen-cli.cjs"),
+    [
+      "#!/usr/bin/env node",
+      "const fs = require('node:fs');",
+      "const path = require('node:path');",
+      "const argv = process.argv.slice(2);",
+      "const parsed = {};",
+      "for (let i = 0; i < argv.length; i += 1) {",
+      "  const token = argv[i];",
+      "  if (!token.startsWith('--')) continue;",
+      "  const next = argv[i + 1];",
+      "  parsed[token.slice(2)] = next && !next.startsWith('--') ? next : true;",
+      "  if (next && !next.startsWith('--')) i += 1;",
+      "}",
+      "const output = path.join(process.env.BOSS_RECOMMEND_HOME, 'screen-cli-args.json');",
+      "fs.writeFileSync(output, JSON.stringify(parsed, null, 2));",
+      "console.log(JSON.stringify({ status: 'COMPLETED', result: { processed_count: 0, output_csv: parsed.output || '' } }));",
+    ].join("\n"),
+    "utf8",
+  );
+
+  process.env.BOSS_RECOMMEND_HOME = tempHome;
+  fs.writeFileSync(
+    path.join(tempHome, "screening-config.json"),
+    JSON.stringify(
+      {
+        baseUrl: "https://api.openai.com/v1",
+        apiKey: "sk-valid-test",
+        model: "gpt-4.1-mini",
+        llmTimeoutMs: 75000,
+        llmMaxRetries: 6,
+      },
+      null,
+      2,
+    ),
+  );
+
+  try {
+    const result = await runRecommendScreenCli({
+      workspaceRoot,
+      screenParams: {
+        criteria: "有 MCP 经验",
+        target_count: null,
+        post_action: "none",
+        max_greet_count: null,
+      },
+      pageScope: "recommend",
+    });
+    assert.equal(result.ok, true);
+    const parsed = JSON.parse(fs.readFileSync(path.join(tempHome, "screen-cli-args.json"), "utf8"));
+    assert.equal(parsed["llm-timeout-ms"], "75000");
+    assert.equal(parsed["llm-max-retries"], "6");
+  } finally {
+    if (previousHome === undefined) {
+      delete process.env.BOSS_RECOMMEND_HOME;
+    } else {
+      process.env.BOSS_RECOMMEND_HOME = previousHome;
+    }
+    fs.rmSync(workspaceRoot, { recursive: true, force: true });
+    fs.rmSync(tempHome, { recursive: true, force: true });
+  }
+}
+
 function testPreflightShouldCheckSharpInsteadOfPython() {
   const preflight = runPipelinePreflight(process.cwd());
   const keys = new Set((preflight.checks || []).map((item) => item?.key));
@@ -520,8 +608,10 @@ async function main() {
   testParsePausedStructuredOutput();
   testParseScreenProgressLineShouldCountFavoriteFailureAsSkipped();
   testResolveScreenTimeoutDefaultsTo24Hours();
+  testResolveSharedLlmTransportConfigShouldUseDefaultsAndOverrides();
   testBuildRecommendScreenProcessErrorMapsTimeout();
   await testResumeRequiresCheckpointFile();
+  await testRecommendScreenCliShouldPassSharedLlmTransportArgs();
   testPreflightShouldCheckSharpInsteadOfPython();
   testPreflightFeaturedShouldRequireFavoriteCalibration();
   testPreflightRecommendShouldKeepFavoriteCalibrationOptional();