@reconcrap/boss-recommend-mcp 2.0.3 → 2.0.4

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.4",
   "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`)
   };
 }
 
@@ -633,7 +636,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 +648,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 +806,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 +832,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 +892,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 +992,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 +1135,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/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/index.js

@@ -7,7 +7,8 @@ import { fileURLToPath } from "node:url";
 import {
   getFeaturedCalibrationResolution,
   getBossChatTargetCountValue,
-  normalizeTargetCountInput
+  normalizeTargetCountInput,
+  resolveBossScreeningConfig
 } from "./chat-runtime-config.js";
 import {
   __resetChatMcpStateForTests,
@@ -1890,7 +1891,8 @@ async function handleRunRecommendSelfHealTool({ workspaceRoot, args }) {
   }
 
   const host = "127.0.0.1";
-  const port = parsePositiveInteger(args.port, 9222);
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
+  const port = parsePositiveInteger(args.port, configResolution.ok ? configResolution.config.debugPort : 9222);
   let session = null;
   try {
     session = await connectToChromeTarget({

package/src/recommend-mcp.js

@@ -44,6 +44,10 @@ import {
   parseRecommendInstruction
 } from "./parser.js";
 import { getRunsDir } from "./run-state.js";
+import {
+  resolveBossConfiguredOutputDir,
+  resolveBossScreeningConfig
+} from "./chat-runtime-config.js";
 
 const DEFAULT_RECOMMEND_HOST = "127.0.0.1";
 const DEFAULT_RECOMMEND_PORT = 9222;
@@ -115,12 +119,14 @@ function getRecommendRunArtifacts(runId) {
   const normalized = normalizeRunId(runId);
   if (!normalized) return null;
   const runsDir = getRunsDir();
+  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`)
   };
 }
 
@@ -484,8 +490,12 @@ async function readRecommendJobOptionsFromSession(session) {
 }
 
 export async function listRecommendJobsTool({ workspaceRoot = "", args = {} } = {}) {
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
   const host = normalizeText(args.host) || DEFAULT_RECOMMEND_HOST;
-  const port = parsePositiveInteger(args.port, DEFAULT_RECOMMEND_PORT);
+  const port = parsePositiveInteger(
+    args.port,
+    configResolution.ok ? configResolution.config.debugPort : DEFAULT_RECOMMEND_PORT
+  );
   const targetUrlIncludes = normalizeText(args.target_url_includes) || RECOMMEND_TARGET_URL;
   const allowNavigate = args.allow_navigate !== false;
   const slowLive = args.slow_live === true;
@@ -922,7 +932,7 @@ function buildRecommendFilter(parsed, args = {}) {
   return groups.length ? { filterGroups: groups } : { enabled: false };
 }
 
-function normalizeRecommendStartInput(args = {}, parsed) {
+function normalizeRecommendStartInput(args = {}, parsed, configResolution = null) {
   const confirmation = args.confirmation || {};
   const overrides = args.overrides || {};
   const slowLive = args.slow_live === true;
@@ -932,7 +942,10 @@ function normalizeRecommendStartInput(args = {}, parsed) {
   );
   return {
     host: normalizeText(args.host) || DEFAULT_RECOMMEND_HOST,
-    port: parsePositiveInteger(args.port, DEFAULT_RECOMMEND_PORT),
+    port: parsePositiveInteger(
+      args.port,
+      configResolution?.ok ? configResolution.config.debugPort : DEFAULT_RECOMMEND_PORT
+    ),
     targetUrlIncludes: normalizeText(args.target_url_includes) || RECOMMEND_TARGET_URL,
     allowNavigate: args.allow_navigate !== false,
     slowLive,
@@ -1038,7 +1051,8 @@ async function startRecommendPipelineRunInternal(args = {}, { workspaceRoot = ""
   const parsed = parseRecommendPipelineRequest(args);
   const gate = evaluateRecommendPipelineGate(parsed, args);
   if (gate) return gate;
-  const normalized = normalizeRecommendStartInput(args, parsed);
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
+  const normalized = normalizeRecommendStartInput(args, parsed, configResolution);
 
   let session;
   try {

package/src/recruit-mcp.js

@@ -32,6 +32,10 @@ import {
   runRecruitWorkflow,
   waitForRecruitSearchControls
 } from "./domains/recruit/index.js";
+import {
+  resolveBossConfiguredOutputDir,
+  resolveBossScreeningConfig
+} from "./chat-runtime-config.js";
 
 const RUN_MODE_ASYNC = "async";
 const RUN_MODE_SYNC = "sync";
@@ -108,12 +112,14 @@ function getRecruitRunArtifacts(runId) {
   const normalized = normalizeRunId(runId);
   if (!normalized) return null;
   const runsDir = getRecruitRunsDir();
+  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`)
   };
 }
 
@@ -807,12 +813,18 @@ async function startRecruitPipelineRunInternal(args = {}, { workspaceRoot = "" }
   const parsed = parseRecruitPipelineRequest(args);
   const gate = evaluateRecruitPipelineGate(parsed);
   if (gate) return gate;
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
+  const host = normalizeText(args.host) || DEFAULT_RECRUIT_HOST;
+  const port = parsePositiveInteger(
+    args.port,
+    configResolution.ok ? configResolution.config.debugPort : DEFAULT_RECRUIT_PORT
+  );
 
   let session;
   try {
     session = await recruitConnectorImpl({
-      host: normalizeText(args.host) || DEFAULT_RECRUIT_HOST,
-      port: parsePositiveInteger(args.port, DEFAULT_RECRUIT_PORT),
+      host,
+      port,
       targetUrlIncludes: normalizeText(args.target_url_includes) || RECRUIT_TARGET_URL,
       allowNavigate: args.allow_navigate !== false,
       slowLive: args.slow_live === true
@@ -858,8 +870,8 @@ async function startRecruitPipelineRunInternal(args = {}, { workspaceRoot = "" }
     workspaceRoot: normalizeText(workspaceRoot) || globalThis.process?.cwd?.() || "",
     args: clonePlain(args, {}),
     chrome: {
-      host: normalizeText(args.host) || DEFAULT_RECRUIT_HOST,
-      port: parsePositiveInteger(args.port, DEFAULT_RECRUIT_PORT),
+      host,
+      port,
       target_url: session.target?.url || RECRUIT_TARGET_URL,
       target_id: session.target?.id || null,
       auto_launch: session.chrome || null