@reconcrap/boss-recommend-mcp 1.3.3 → 1.3.5

package/README.md

@@ -216,6 +216,13 @@ chat-only 交互建议：
 - 先调用一次 `start_boss_chat_run`（可不带参数），服务会先导航到 `https://www.zhipin.com/web/chat/index` 并返回 `NEED_INPUT`，其中包含岗位 `job_options` 与待补字段。
 - 然后基于 `job_options` 让用户选择 `job`，并补齐 `start_from`、`target_count`、`criteria` 后再次调用 `start_boss_chat_run` 启动任务。
 
+Trae-CN / 长对话防循环建议：
+
+- 固定流程：`boss_chat_health_check` -> `start_boss_chat_run(空参可)` -> 一次性补齐 `job/start_from/target_count/criteria` -> 再次 `start_boss_chat_run`。
+- `start_boss_chat_run` 返回 `ACCEPTED` 后直接结束当前回合，不要自动轮询。
+- 缺参或校验失败时，一次性列出全部缺失/错误项，避免重复同一句提示触发宿主“陷入循环”保护。
+- 仅当用户明确要求“查进度”时再调用 `get_boss_chat_run`。
+
 ## 长流程 Agent 兼容模式
 
 当宿主 agent 对“长时间无回包”敏感（容易误判失败）时，建议改用异步工具：

package/package.json

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

package/skills/boss-chat/README.md

@@ -3,3 +3,24 @@
 Bundled chat-page automation skill shipped with `boss-recommend-mcp`.
 
 Use this skill when the user wants a chat-only Boss workflow without installing `boss-chat` separately.
+
+## Stable Prompt Template (Trae-CN)
+
+Use the following prompt when host agents are prone to loop detection in long conversations:
+
+```text
+Please run a Boss chat-only task (do not switch to recommend flow).
+
+Execution order:
+1) Call boss_chat_health_check.
+2) Call start_boss_chat_run once (empty params allowed) to fetch job_options and missing fields.
+3) Ask for these required fields in one shot: job, start_from (unread/all), target_count, criteria.
+4) After user reply, call start_boss_chat_run exactly once to start the run.
+5) If ACCEPTED, reply only with run_id and "task started"; no auto polling.
+
+Anti-loop rules:
+- Do not repeat the same sentence across turns.
+- On validation errors, list all missing/invalid fields once.
+- Do not call start_boss_chat_run repeatedly in one turn.
+- Do not call get_boss_chat_run unless user explicitly asks for progress.
+```

package/src/boss-chat.js

@@ -30,6 +30,69 @@ function parsePositiveInteger(value, fallback = null) {
   return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
 }
 
+function isUnlimitedTargetCountToken(value) {
+  const token = normalizeText(value).toLowerCase();
+  if (!token) return false;
+  return [
+    "all",
+    "unlimited",
+    "infinity",
+    "inf",
+    "max",
+    "full",
+    "全部",
+    "全量",
+    "不限",
+    "扫到底",
+    "直到完成所有人选"
+  ].includes(token);
+}
+
+function parseBossChatTargetCount(value) {
+  if (value === undefined || value === null) {
+    return {
+      provided: false,
+      targetCount: null,
+      cliArg: null
+    };
+  }
+  const raw = normalizeText(value);
+  if (!raw) {
+    return {
+      provided: false,
+      targetCount: null,
+      cliArg: null
+    };
+  }
+  if (isUnlimitedTargetCountToken(raw)) {
+    return {
+      provided: true,
+      targetCount: null,
+      cliArg: "-1"
+    };
+  }
+  const parsed = Number.parseInt(String(raw), 10);
+  if (Number.isFinite(parsed) && parsed === -1) {
+    return {
+      provided: true,
+      targetCount: null,
+      cliArg: "-1"
+    };
+  }
+  if (Number.isFinite(parsed) && parsed > 0) {
+    return {
+      provided: true,
+      targetCount: parsed,
+      cliArg: String(parsed)
+    };
+  }
+  return {
+    provided: false,
+    targetCount: null,
+    cliArg: null
+  };
+}
+
 function parseJsonOutput(text) {
   const trimmed = String(text || "").trim();
   if (!trimmed) return null;
@@ -152,14 +215,16 @@ function normalizeBossChatStartInput(input = {}) {
   const startFromRaw = normalizeText(input.startFrom || input.start_from).toLowerCase();
   const startFrom = startFromRaw === "all" ? "all" : startFromRaw === "unread" ? "unread" : "";
   const criteria = normalizeText(input.criteria);
-  const targetCount = parsePositiveInteger(input.targetCount ?? input.target_count);
+  const parsedTarget = parseBossChatTargetCount(input.targetCount ?? input.target_count);
   const port = parsePositiveInteger(input.port);
   return {
     profile,
     job,
     startFrom,
     criteria,
-    targetCount,
+    targetCount: parsedTarget.targetCount,
+    targetCountArg: parsedTarget.cliArg,
+    targetCountProvided: parsedTarget.provided,
     port,
     dryRun: input.dryRun === true || input.dry_run === true,
     noState: input.noState === true || input.no_state === true,
@@ -181,7 +246,7 @@ function getMissingBossChatStartFields(input = {}) {
   const missing = [];
   if (!normalized.job) missing.push("job");
   if (!normalized.startFrom) missing.push("start_from");
-  if (!normalized.targetCount) missing.push("target_count");
+  if (!normalized.targetCountProvided) missing.push("target_count");
   if (!normalized.criteria) missing.push("criteria");
   return missing;
 }
@@ -194,7 +259,7 @@ function buildBossChatCliArgs(command, input, resolvedConfig) {
     if (normalized.job) args.push("--job", normalized.job);
     if (normalized.startFrom) args.push("--start-from", normalized.startFrom);
     if (normalized.criteria) args.push("--criteria", normalized.criteria);
-    if (normalized.targetCount) args.push("--targetCount", String(normalized.targetCount));
+    if (normalized.targetCountArg) args.push("--targetCount", normalized.targetCountArg);
     args.push("--port", String(normalized.port || resolvedConfig.debugPort || 9222));
     args.push("--baseurl", resolvedConfig.baseUrl);
     args.push("--apikey", resolvedConfig.apiKey);
@@ -210,8 +275,8 @@ function buildBossChatCliArgs(command, input, resolvedConfig) {
     args.push("--job", normalized.job);
     args.push("--start-from", normalized.startFrom);
     args.push("--criteria", normalized.criteria);
-    if (normalized.targetCount) {
-      args.push("--targetCount", String(normalized.targetCount));
+    if (normalized.targetCountArg) {
+      args.push("--targetCount", normalized.targetCountArg);
     }
     args.push("--baseurl", resolvedConfig.baseUrl);
     args.push("--apikey", resolvedConfig.apiKey);

package/src/index.js

@@ -70,9 +70,27 @@ let runSelfHealImpl = runRecommendSelfHeal;
 let spawnProcessImpl = spawn;
 const TERMINAL_RUN_STATES = new Set([RUN_STATE_COMPLETED, RUN_STATE_FAILED, RUN_STATE_CANCELED]);
 
-function normalizeText(value) {
-  return String(value || "").replace(/\s+/g, " ").trim();
-}
+function normalizeText(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+
+function isUnlimitedTargetCountToken(value) {
+  const token = normalizeText(value).toLowerCase();
+  if (!token) return false;
+  return [
+    "all",
+    "unlimited",
+    "infinity",
+    "inf",
+    "max",
+    "full",
+    "全部",
+    "全量",
+    "不限",
+    "扫到底",
+    "直到完成所有人选"
+  ].includes(token);
+}
 
 function parsePositiveInteger(raw, fallback) {
   const value = Number.parseInt(String(raw || ""), 10);
@@ -358,8 +376,16 @@ function createRunInputSchema() {
                 enum: ["unread", "all"]
               },
               target_count: {
-                type: "integer",
-                minimum: 1
+                oneOf: [
+                  {
+                    type: "integer",
+                    minimum: 1
+                  },
+                  {
+                    type: "string",
+                    enum: ["all", "unlimited", "全部", "不限", "扫到底", "全量"]
+                  }
+                ]
               },
               dry_run: { type: "boolean" },
               no_state: { type: "boolean" },
@@ -399,9 +425,17 @@ function createBossChatStartInputSchema() {
         description: "boss-chat 的筛选 criteria"
       },
       target_count: {
-        type: "integer",
-        minimum: 1,
-        description: "本次处理人数上限；chat-only 模式必填（可先不传，服务会返回 NEED_INPUT 引导补齐）"
+        oneOf: [
+          {
+            type: "integer",
+            minimum: 1
+          },
+          {
+            type: "string",
+            enum: ["all", "unlimited", "全部", "不限", "扫到底", "全量"]
+          }
+        ],
+        description: "本次处理人数上限；支持正整数或 all/不限（扫到底）"
       },
       port: {
         type: "integer",
@@ -673,9 +707,13 @@ function validateBossChatStartArgs(args) {
     }
   }
   if (Object.prototype.hasOwnProperty.call(args, "target_count")) {
-    const targetCount = Number.parseInt(String(args.target_count), 10);
-    if (!Number.isFinite(targetCount) || targetCount <= 0) {
-      return "target_count must be a positive integer";
+    const rawTargetCount = args.target_count;
+    const targetCount = Number.parseInt(String(rawTargetCount), 10);
+    const tokenAllowed =
+      typeof rawTargetCount === "string" && isUnlimitedTargetCountToken(rawTargetCount);
+    const numericUnlimited = Number.isFinite(targetCount) && targetCount === -1;
+    if ((!Number.isFinite(targetCount) || targetCount <= 0) && !tokenAllowed && !numericUnlimited) {
+      return "target_count must be a positive integer or one of: all, unlimited, 全部, 不限, 扫到底, 全量";
     }
   }
   if (Object.prototype.hasOwnProperty.call(args, "port")) {

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

@@ -226,6 +226,7 @@ export class BossChatApp {
 
     let consecutiveErrors = 0;
     let exhaustedScrolls = 0;
+    const exhaustedScrollLimit = targetCount ? 3 : 8;
 
     try {
       while (shouldContinue(summary, targetCount)) {
@@ -336,7 +337,7 @@ export class BossChatApp {
             `列表滚动：ratio=${ratio.toFixed(2)} | didScroll=${Boolean(scrollResult.didScroll)} | top=${scrollResult.after?.top ?? 'n/a'} | scrollRetry=${exhaustedScrolls + 1}`,
           );
           exhaustedScrolls = scrollResult.didScroll ? exhaustedScrolls + 1 : exhaustedScrolls + 2;
-          if (exhaustedScrolls >= 3) {
+          if (exhaustedScrolls >= exhaustedScrollLimit) {
             summary.exhausted = true;
             this.logger.log('列表滚动终止：连续无可处理候选人，判定为 exhausted。');
             break;

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

@@ -630,6 +630,40 @@ function browserActivateCandidate(options = {}) {
 function browserScrollCustomerList(options = {}) {
   const ratio = Number(options.ratio || 0.72);
   const clamp = (value, low, high) => Math.max(low, Math.min(high, value));
+  const isOverflowScrollable = (el) => {
+    if (!(el instanceof HTMLElement)) return false;
+    const style = getComputedStyle(el);
+    return /(auto|scroll|overlay)/i.test(String(style.overflowY || ''));
+  };
+  const findBestScrollableContainer = (seedCard) => {
+    const candidates = [];
+    const pushCandidate = (node) => {
+      if (node instanceof HTMLElement) candidates.push(node);
+    };
+    if (seedCard instanceof HTMLElement) {
+      let current = seedCard.parentElement;
+      let depth = 0;
+      while (current && depth < 30) {
+        pushCandidate(current);
+        current = current.parentElement;
+        depth += 1;
+      }
+    }
+    const unique = Array.from(new Set(candidates));
+    let best = null;
+    let bestScore = -Infinity;
+    for (const node of unique) {
+      const scrollRange = Number(node.scrollHeight || 0) - Number(node.clientHeight || 0);
+      const styleBonus = isOverflowScrollable(node) ? 80 : 0;
+      const classBonus = /user|list|chat/i.test(String(node.className || '')) ? 24 : 0;
+      const score = scrollRange + styleBonus + classBonus;
+      if (score > bestScore) {
+        best = node;
+        bestScore = score;
+      }
+    }
+    return best;
+  };
   const isScrollable = (el) =>
     el instanceof HTMLElement &&
     Number(el.scrollHeight || 0) > Number(el.clientHeight || 0) + 16 &&
@@ -672,27 +706,59 @@ function browserScrollCustomerList(options = {}) {
     return { ok: false, error: 'CHAT_LIST_CONTAINER_NOT_FOUND' };
   }
 
+  const firstCard = listContainer.querySelector('div[role="listitem"]') || document.querySelector('div[role="listitem"]');
+  if (firstCard instanceof HTMLElement) {
+    const best = findBestScrollableContainer(firstCard);
+    if (best instanceof HTMLElement) {
+      listContainer = best;
+    }
+  }
+
   const before = {
     top: Number(listContainer.scrollTop || 0),
     height: Number(listContainer.scrollHeight || 0),
     clientHeight: Number(listContainer.clientHeight || 0),
+    cardCount: Number(listContainer.querySelectorAll('div[role="listitem"]').length || 0),
   };
   const amount = Math.max(120, Math.round(before.clientHeight * Math.max(0.35, Math.min(0.95, ratio))));
   const maxScroll = Math.max(0, before.height - before.clientHeight);
-  listContainer.scrollTop = clamp(before.top + amount, 0, maxScroll);
+  if (maxScroll > 0) {
+    listContainer.scrollTop = clamp(before.top + amount, 0, maxScroll);
+  } else {
+    const cards = Array.from(listContainer.querySelectorAll('div[role="listitem"]')).filter(
+      (node) => node instanceof HTMLElement,
+    );
+    const tail = cards[cards.length - 1];
+    if (tail instanceof HTMLElement) {
+      tail.scrollIntoView({ block: 'end', inline: 'nearest' });
+      try {
+        listContainer.dispatchEvent(
+          new WheelEvent('wheel', {
+            deltaY: amount,
+            bubbles: true,
+            cancelable: true,
+          }),
+        );
+      } catch {}
+    }
+  }
   listContainer.dispatchEvent(new Event('scroll', { bubbles: true }));
 
   const after = {
     top: Number(listContainer.scrollTop || 0),
     height: Number(listContainer.scrollHeight || 0),
     clientHeight: Number(listContainer.clientHeight || 0),
+    cardCount: Number(listContainer.querySelectorAll('div[role="listitem"]').length || 0),
   };
 
   return {
     ok: true,
     before,
     after,
-    didScroll: before.top !== after.top || before.height !== after.height,
+    didScroll:
+      before.top !== after.top ||
+      before.height !== after.height ||
+      before.cardCount !== after.cardCount,
   };
 }
 
@@ -725,29 +791,46 @@ function browserConversationReadyState() {
     const disabledAttr = Boolean(el?.hasAttribute?.('disabled'));
     return classText.includes('disabled') || ariaDisabled || disabledAttr;
   };
+  const isDisabledDeep = (el) => {
+    if (!(el instanceof HTMLElement)) return true;
+    let current = el;
+    let depth = 0;
+    while (current && depth < 5) {
+      if (isDisabled(current)) return true;
+      current = current.parentElement;
+      depth += 1;
+    }
+    return false;
+  };
+  const resolveAttachmentButton = () => {
+    const candidates = Array.from(
+      document.querySelectorAll(
+        '.resume-btn-file, .btn.resume-btn-file, [class*="resume-btn-file"]',
+      ),
+    ).filter((el) => isVisible(el));
+    const match = candidates.find((el) => {
+      const text = normalize(el.textContent || '');
+      if (!text) return false;
+      if (!text.includes('附件简历')) return false;
+      if (text.includes('求附件简历')) return false;
+      return true;
+    });
+    return match || null;
+  };
   const onlineResume = Array.from(
     document.querySelectorAll(
       'a.btn.resume-btn-online, a.resume-btn-online, .resume-btn-online, .btn.resume-btn-online',
     ),
   ).find((el) => {
     if (!isVisible(el)) return false;
-    if (!normalize(el.textContent || '').includes('在线简历')) return false;
-    return !isDisabled(el);
-  });
-  const attachmentResume = Array.from(
-    document.querySelectorAll(
-      '.btn.resume-btn-file, .resume-btn-file, [class*="resume-btn-file"], button, a, div, span',
-    ),
-  ).find((el) => {
-    if (!isVisible(el)) return false;
-    if (!normalize(el.textContent || '').includes('附件简历')) return false;
-    const classText = String(el.className || '').toLowerCase();
-    return classText.includes('resume-btn-file') || classText.includes('resume') || classText.includes('btn');
+      if (!normalize(el.textContent || '').includes('在线简历')) return false;
+      return !isDisabled(el);
   });
+  const attachmentResume = resolveAttachmentButton();
   const askResume = Array.from(document.querySelectorAll('span.operate-btn, button, a, span')).find(
     (el) => isVisible(el) && isAskResumeText(el.textContent || ''),
   );
-  const attachmentResumeEnabled = Boolean(attachmentResume) && !isDisabled(attachmentResume);
+  const attachmentResumeEnabled = Boolean(attachmentResume) && !isDisabledDeep(attachmentResume);
   return {
     hasOnlineResume: Boolean(onlineResume),
     hasAskResume: Boolean(askResume),

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

@@ -131,11 +131,35 @@ function parseStartFrom(value, fallback = 'unread') {
   return fallback;
 }
 
+function isUnlimitedTargetCountToken(value) {
+  const token = String(value || '').trim().toLowerCase();
+  if (!token) return false;
+  return [
+    'all',
+    'unlimited',
+    'infinity',
+    'inf',
+    'max',
+    'full',
+    '全部',
+    '全量',
+    '不限',
+    '扫到底',
+    '直到完成所有人选',
+  ].includes(token);
+}
+
 function parseTargetCount(value) {
   if (value === undefined || value === null || String(value).trim() === '') {
     return null;
   }
+  if (isUnlimitedTargetCountToken(value)) {
+    return -1;
+  }
   const parsed = Number.parseInt(String(value), 10);
+  if (Number.isFinite(parsed) && parsed === -1) {
+    return -1;
+  }
   return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
 }
 
@@ -266,7 +290,7 @@ function printUsage() {
   console.log('  --job <text|value|index>        Select job by label/value/index');
   console.log('  --criteria <text>               Screening criteria for resume evaluation');
   console.log('  --start-from <unread|all>       Start from unread or all list');
-  console.log('  --targetCount <n>               Maximum candidates to process; empty means unlimited');
+  console.log('  --targetCount <n|all>           Maximum candidates to process; all means unlimited');
   console.log('  --baseurl <url>                 Override LLM base URL');
   console.log('  --apikey <key>                  Override LLM API key');
   console.log('  --model <name>                  Override LLM model');
@@ -540,7 +564,9 @@ function validateStartRunArgs(args) {
   const missing = [];
   if (!args?.overrides?.jobSelection) missing.push('--job');
   if (!args?.overrides?.startFrom) missing.push('--start-from');
-  if (!args?.overrides?.targetCount) missing.push('--targetCount');
+  if (args?.overrides?.targetCount === undefined || args?.overrides?.targetCount === null) {
+    missing.push('--targetCount');
+  }
   if (!args?.overrides?.screeningCriteria) missing.push('--criteria');
 
   if (missing.length === 0) return null;
@@ -557,7 +583,12 @@ function validateStartRunArgs(args) {
 function buildPreparePendingQuestions(args, jobs = []) {
   const pendingQuestions = [];
   const startFromValue = String(args?.overrides?.startFrom || '').trim().toLowerCase();
-  const targetCountValue = Number.parseInt(String(args?.overrides?.targetCount || ''), 10);
+  const targetCountValue = Number.parseInt(String(args?.overrides?.targetCount ?? ''), 10);
+  const hasTargetCount =
+    args?.overrides?.targetCount !== undefined &&
+    args?.overrides?.targetCount !== null &&
+    Number.isFinite(targetCountValue) &&
+    (targetCountValue > 0 || targetCountValue === -1);
   const criteriaValue = String(args?.overrides?.screeningCriteria || '').trim();
   const jobValue = String(args?.overrides?.jobSelection || '').trim();
   const jobOptions = jobs.map((job, index) => ({
@@ -586,10 +617,10 @@ function buildPreparePendingQuestions(args, jobs = []) {
       ],
     });
   }
-  if (!Number.isFinite(targetCountValue) || targetCountValue <= 0) {
+  if (!hasTargetCount) {
     pendingQuestions.push({
       field: 'target_count',
-      question: '请输入目标数量（正整数）',
+      question: '请输入目标数量（正整数）或 all（扫到底）',
       required: true,
     });
   }
@@ -1198,8 +1229,12 @@ async function executeRunCommand(args, dataDir) {
     cleanupRuntimeControls = setupRuntimeControls(runControl);
 
     logger.log('开始处理 Boss 聊天候选人列表...');
+    const targetCountLabel =
+      Number.isFinite(Number(runProfile.targetCount)) && Number(runProfile.targetCount) > 0
+        ? String(runProfile.targetCount)
+        : '扫到底';
     logger.log(
-      `本次设置: 岗位=${runProfile.jobSelection.label}, 范围=${runProfile.startFrom === 'all' ? '全部' : '未读'}, 上限=${runProfile.targetCount || '扫到底'}`,
+      `本次设置: 岗位=${runProfile.jobSelection.label}, 范围=${runProfile.startFrom === 'all' ? '全部' : '未读'}, 上限=${targetCountLabel}`,
     );
     logger.log('运行中快捷键: p=暂停/继续, r=继续, q=停止, Ctrl+C=停止');