@reconcrap/boss-recommend-mcp 2.0.1 → 2.0.2

package/package.json

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

package/skills/boss-recommend-pipeline/SKILL.md

@@ -31,6 +31,7 @@ description: "Use when users want Boss recommend-page filtering/screening via bo
   - `criteria` 必须是用户开放式自然语言；禁止“严格/宽松执行”等预设替代。
   - `post_action=greet` 时，必须确认 `max_greet_count`；禁止自动默认为 `target_count`。
   - 正式执行前必须 `final_confirmed=true`。
+  - 真实筛选禁止传 `detail_limit: 0`；recommend 默认必须打开候选人详情/CV。只有用户明确要求“卡片-only 调试”时，才允许同时传 `detail_limit: 0` 和 `allow_card_only_screening: true`。
 
 - **Instruction 原文锁定**
   - 首次用户需求原文锁定为 `locked_instruction_raw`。

package/src/domains/recommend/run-service.js

@@ -332,7 +332,7 @@ export async function runRecommendWorkflow({
   fallbackPageScope = "recommend",
   filter = {},
   maxCandidates = 5,
-  detailLimit = 0,
+  detailLimit,
   closeDetail = true,
   delayMs = 0,
   cardTimeoutMs = 10000,
@@ -362,7 +362,7 @@ export async function runRecommendWorkflow({
   const normalizedFallbackPageScope = normalizeRecommendPageScope(fallbackPageScope) || "recommend";
   const postActionEnabled = normalizedPostAction !== "none";
   const limit = Math.max(1, Number(maxCandidates) || 1);
-  const detailCountLimit = Math.max(0, Number(detailLimit) || 0);
+  const detailCountLimit = detailLimit == null ? limit : Math.max(0, Number(detailLimit) || 0);
   const effectiveDetailLimit = postActionEnabled ? limit : detailCountLimit;
   const networkRecorder = effectiveDetailLimit > 0
     ? createRecommendDetailNetworkRecorder(client)
@@ -785,7 +785,7 @@ export function createRecommendRunService({
     fallbackPageScope = "recommend",
     filter = {},
     maxCandidates = 5,
-    detailLimit = 0,
+    detailLimit,
     closeDetail = true,
     delayMs = 0,
     cardTimeoutMs = 10000,
@@ -814,6 +814,8 @@ export function createRecommendRunService({
     const normalizedPostAction = normalizeRecommendPostAction(postAction) || "none";
     const requestedPageScope = normalizeRecommendPageScope(pageScope) || "recommend";
     const normalizedFallbackPageScope = normalizeRecommendPageScope(fallbackPageScope) || "recommend";
+    const candidateLimit = Math.max(1, Number(maxCandidates) || 1);
+    const normalizedDetailLimit = detailLimit == null ? candidateLimit : Math.max(0, Number(detailLimit) || 0);
     return manager.startRun({
       name,
       context: {
@@ -825,7 +827,7 @@ export function createRecommendRunService({
         fallback_page_scope: normalizedFallbackPageScope,
         filter: normalizedFilter,
         max_candidates: maxCandidates,
-        detail_limit: detailLimit,
+        detail_limit: normalizedDetailLimit,
         close_detail: closeDetail,
         cv_acquisition_mode: cvAcquisitionMode,
         max_image_pages: maxImagePages,
@@ -846,7 +848,7 @@ export function createRecommendRunService({
       },
       progress: {
         card_count: 0,
-        target_count: Math.max(1, Number(maxCandidates) || 1),
+        target_count: candidateLimit,
         processed: 0,
         screened: 0,
         detail_opened: 0,
@@ -864,7 +866,7 @@ export function createRecommendRunService({
         fallbackPageScope: normalizedFallbackPageScope,
         filter: normalizedFilter,
         maxCandidates,
-        detailLimit,
+        detailLimit: normalizedDetailLimit,
         closeDetail,
         delayMs,
         cardTimeoutMs,

package/src/index.js

@@ -540,7 +540,11 @@ function createRunInputSchema() {
       detail_limit: {
         type: "integer",
         minimum: 0,
-        description: "打开详情的人数上限；默认 0，0 表示只用卡片信息"
+        description: "打开详情/CV 的人数上限；默认跟随 target_count/max_candidates。生产筛选不应传 0；只有 allow_card_only_screening=true 时才会接受 0 作为调试卡片-only 模式"
+      },
+      allow_card_only_screening: {
+        type: "boolean",
+        description: "高级调试开关；默认 false。只有显式为 true 时，recommend 才会尊重 detail_limit=0 并只用卡片信息筛选"
       },
       delay_ms: {
         type: "integer",

package/src/recommend-mcp.js

@@ -75,6 +75,15 @@ function parseNonNegativeInteger(raw, fallback) {
   return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
 }
 
+function resolveRecommendDetailLimit(args = {}, normalized = {}) {
+  const fallback = parsePositiveInteger(normalized.targetCount, 5);
+  const requested = parseNonNegativeInteger(args.detail_limit, fallback);
+  if (requested === 0 && args.allow_card_only_screening !== true) {
+    return fallback;
+  }
+  return requested;
+}
+
 function methodSummary(methodLog = []) {
   const summary = {};
   for (const entry of methodLog || []) {
@@ -867,7 +876,7 @@ function getRunOptions(args, parsed, normalized, session) {
     fallbackPageScope: "recommend",
     filter: normalized.filter,
     maxCandidates: normalized.targetCount,
-    detailLimit: parseNonNegativeInteger(args.detail_limit, 0),
+    detailLimit: resolveRecommendDetailLimit(args, normalized),
     closeDetail: true,
     delayMs: parseNonNegativeInteger(args.delay_ms, 0),
     cardTimeoutMs: slowLive ? 180000 : 90000,