@reconcrap/boss-recommend-mcp 1.3.5 → 1.3.7

package/README.md

@@ -215,6 +215,7 @@ 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` 启动任务。
+- `target_count` 支持正整数；若用户给出 `全部候选人` / `所有候选人`，会自动按不限（扫到底）处理。
 
 Trae-CN / 长对话防循环建议：
 

package/package.json

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

package/skills/boss-chat/README.md

@@ -23,4 +23,11 @@ Anti-loop rules:
 - 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.
+
+target_count mapping:
+- Positive integer means explicit cap (for example 20).
+- `all` / `unlimited` / `全部` / `不限` / `扫到底` / `全量` means unlimited.
+- `全部候选人` / `所有候选人` must also be treated as unlimited.
+- Always write the argument key as `target_count`.
+- For unlimited mode, send `"target_count": "all"` in the tool call.
 ```

package/skills/boss-chat/SKILL.md

@@ -37,6 +37,12 @@ description: "Use when users want Boss chat-page screening/outreach via the bund
 - `safe_pacing`
 - `batch_rest_enabled`
 
+`target_count` 填写规则（关键）：
+
+- 正整数：如 `20`
+- 扫到底：`all` / `unlimited` / `全部` / `不限` / `扫到底` / `全量`
+- 同义短语也可直接用：`全部候选人` / `所有候选人`（等价于扫到底）
+
 ## Hard Rules
 
 - LLM 配置必须复用 `boss-recommend-mcp` 的 `screening-config.json`；不要再向用户单独要 `baseUrl/apiKey/model`。
@@ -46,6 +52,9 @@ description: "Use when users want Boss chat-page screening/outreach via the bund
   - 不得在 recommend 任务尚未完成时并行启动独立 chat run。
 - `job` / `start_from` / `criteria` 缺一不可；缺参时只补缺口。
 - `target_count` 在 chat-only 启动前也是必填项，不能默认省略。
+- 当用户说“全部候选人/所有候选人”时，必须按“扫到底（unlimited）”处理，不要再追问正整数。
+- 参数名必须写 `target_count`（不要写“目标数量”等中文键名）。
+- 当用户选择“扫到底/全部候选人/所有候选人”时，调用参数统一写：`"target_count": "all"`。
 - 禁止 agent 自行补全 `job/start_from/criteria` 并直接执行，必须由用户明确给出或确认。
 - chat-only 启动流程必须先进入聊天页并拉取岗位列表，再让用户从列表中选择 `job`。
 - 允许先用空参调用 `start_boss_chat_run` 触发 `NEED_INPUT`；若返回了 `job_options`，必须完整展示所有岗位选项给用户确认。

package/src/boss-chat.js

@@ -33,19 +33,29 @@ function parsePositiveInteger(value, fallback = null) {
 function isUnlimitedTargetCountToken(value) {
   const token = normalizeText(value).toLowerCase();
   if (!token) return false;
-  return [
+  const compact = token.replace(/\s+/g, "");
+  const knownTokens = new Set([
     "all",
     "unlimited",
     "infinity",
     "inf",
     "max",
     "full",
+    "allcandidates",
     "全部",
     "全量",
     "不限",
     "扫到底",
+    "全部候选人",
+    "所有候选人",
+    "全部人选",
+    "所有人选",
     "直到完成所有人选"
-  ].includes(token);
+  ]);
+  if (knownTokens.has(token) || knownTokens.has(compact)) return true;
+  if (/^(?:all|unlimited|infinity|inf|max|full)(?:candidate|candidates)?$/i.test(compact)) return true;
+  if (/^(?:全部|所有|全量|不限)(?:候选人|人选|牛人|人才|人员)?$/u.test(compact)) return true;
+  return false;
 }
 
 function parseBossChatTargetCount(value) {
@@ -251,6 +261,42 @@ function getMissingBossChatStartFields(input = {}) {
   return missing;
 }
 
+function buildTargetCountQuestionHint(item = {}) {
+  const next = { ...item };
+  next.question = "请输入 target_count：正整数，或 all（扫到底）。";
+  next.options = [
+    { label: "扫到底（推荐）", value: "all" },
+    { label: "不限", value: "unlimited" },
+    { label: "全部候选人", value: "全部候选人" },
+    { label: "所有候选人", value: "所有候选人" }
+  ];
+  next.examples = ["all", 20];
+  next.argument_name = "target_count";
+  return next;
+}
+
+function normalizePendingQuestions(pendingQuestions = []) {
+  return pendingQuestions.map((item) => {
+    if (String(item?.field || "") !== "target_count") return item;
+    return buildTargetCountQuestionHint(item);
+  });
+}
+
+function buildNextCallExample(input = {}, missingFields = []) {
+  if (!Array.isArray(missingFields) || missingFields.length === 0) return null;
+  const normalized = normalizeBossChatStartInput(input);
+  const sample = {};
+  if (normalized.job) sample.job = normalized.job;
+  if (normalized.startFrom) sample.start_from = normalized.startFrom;
+  if (normalized.criteria) sample.criteria = normalized.criteria;
+  if (normalized.targetCountProvided) {
+    sample.target_count = normalized.targetCountArg === "-1" ? "all" : normalized.targetCount;
+  } else if (missingFields.includes("target_count")) {
+    sample.target_count = "all";
+  }
+  return Object.keys(sample).length > 0 ? sample : null;
+}
+
 function buildBossChatCliArgs(command, input, resolvedConfig) {
   const args = [command, "--json"];
   if (command === "prepare-run") {
@@ -445,12 +491,15 @@ export async function startBossChatRun({ workspaceRoot, input = {} }) {
     const pendingQuestions = Array.isArray(prepared?.pending_questions)
       ? prepared.pending_questions.filter((item) => missingFields.includes(String(item?.field || "")))
       : [];
+    const normalizedPendingQuestions = normalizePendingQuestions(pendingQuestions);
+    const nextCallExample = buildNextCallExample(input, missingFields);
     return {
       ...prepared,
       status: "NEED_INPUT",
       required_fields: CHAT_REQUIRED_FIELDS.slice(),
       missing_fields: missingFields,
-      pending_questions: pendingQuestions,
+      pending_questions: normalizedPendingQuestions,
+      ...(nextCallExample ? { next_call_example: nextCallExample } : {}),
       message: prepared?.message
         || "已获取 Boss 聊天页岗位列表，请先补齐 job / start_from / target_count / criteria。"
     };

package/src/cli.js

@@ -195,6 +195,14 @@ function parsePositivePort(raw) {
   return Number.isFinite(port) && port > 0 ? port : null;
 }
 
+function parseBossChatTargetCountOption(raw) {
+  if (raw === undefined || raw === null) return undefined;
+  const text = String(raw).trim();
+  if (!text) return undefined;
+  const parsed = parsePositivePort(text);
+  return parsed ?? text;
+}
+
 function parseBooleanOption(raw, fallback = undefined) {
   if (raw === undefined || raw === null || raw === "") return fallback;
   if (raw === true) return true;
@@ -1327,7 +1335,7 @@ function buildBossChatCliInput(options = {}) {
     job: typeof options.job === "string" ? options.job.trim() : undefined,
     start_from: String(options["start-from"] || options.start_from || "").trim().toLowerCase() || undefined,
     criteria: typeof options.criteria === "string" ? options.criteria.trim() : undefined,
-    target_count: parsePositivePort(options.targetCount || options["target-count"] || options.target_count),
+    target_count: parseBossChatTargetCountOption(options.targetCount || options["target-count"] || options.target_count),
     port: parsePositivePort(options.port),
     dry_run: options["dry-run"] === true || options.dryRun === true,
     no_state: options["no-state"] === true || options.noState === true,

package/src/index.js

@@ -77,19 +77,29 @@ function normalizeText(value) {
 function isUnlimitedTargetCountToken(value) {
   const token = normalizeText(value).toLowerCase();
   if (!token) return false;
-  return [
+  const compact = token.replace(/\s+/g, "");
+  const knownTokens = new Set([
     "all",
     "unlimited",
     "infinity",
     "inf",
     "max",
     "full",
+    "allcandidates",
     "全部",
     "全量",
     "不限",
     "扫到底",
+    "全部候选人",
+    "所有候选人",
+    "全部人选",
+    "所有人选",
     "直到完成所有人选"
-  ].includes(token);
+  ]);
+  if (knownTokens.has(token) || knownTokens.has(compact)) return true;
+  if (/^(?:all|unlimited|infinity|inf|max|full)(?:candidate|candidates)?$/i.test(compact)) return true;
+  if (/^(?:全部|所有|全量|不限)(?:候选人|人选|牛人|人才|人员)?$/u.test(compact)) return true;
+  return false;
 }
 
 function parsePositiveInteger(raw, fallback) {
@@ -383,7 +393,7 @@ function createRunInputSchema() {
                   },
                   {
                     type: "string",
-                    enum: ["all", "unlimited", "全部", "不限", "扫到底", "全量"]
+                    enum: ["all", "unlimited", "全部", "不限", "扫到底", "全量", "全部候选人", "所有候选人"]
                   }
                 ]
               },
@@ -432,10 +442,10 @@ function createBossChatStartInputSchema() {
           },
           {
             type: "string",
-            enum: ["all", "unlimited", "全部", "不限", "扫到底", "全量"]
+            enum: ["all", "unlimited", "全部", "不限", "扫到底", "全量", "全部候选人", "所有候选人"]
           }
         ],
-        description: "本次处理人数上限；支持正整数或 all/不限（扫到底）"
+        description: "本次处理人数上限；支持正整数或 all/不限/全部候选人（扫到底）"
       },
       port: {
         type: "integer",
@@ -713,7 +723,7 @@ function validateBossChatStartArgs(args) {
       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, 全部, 不限, 扫到底, 全量";
+      return "target_count must be a positive integer or one of: all, unlimited, 全部, 不限, 扫到底, 全量, 全部候选人, 所有候选人";
     }
   }
   if (Object.prototype.hasOwnProperty.call(args, "port")) {

package/src/test-boss-chat.js

@@ -210,6 +210,11 @@ async function testBossChatAdapterShouldResolveSharedConfigAndInvokeLocalCli() {
     assert.deepEqual(preflight.required_fields, ["job", "start_from", "target_count", "criteria"]);
     assert.equal(Array.isArray(preflight.job_options), true);
     assert.equal(preflight.job_options.length, 2);
+    assert.equal(Array.isArray(preflight.pending_questions), true);
+    const preflightTargetQuestion = preflight.pending_questions.find((item) => item.field === "target_count");
+    assert.equal(Boolean(preflightTargetQuestion), true);
+    assert.equal(preflightTargetQuestion.argument_name, "target_count");
+    assert.equal(Array.isArray(preflightTargetQuestion.options), true);
 
     const stateAfterPrepare = readStubState(workspaceRoot);
     assert.equal(stateAfterPrepare.last_prepare_args.profile, "default");
@@ -242,6 +247,20 @@ async function testBossChatAdapterShouldResolveSharedConfigAndInvokeLocalCli() {
     assert.equal(stateAfterStart.last_start_args.model, "gpt-4.1-mini");
     assert.equal(stateAfterStart.last_start_args.port, "9666");
 
+    const startedAll = await startBossChatRun({
+      workspaceRoot,
+      input: {
+        profile: "default",
+        job: "算法工程师",
+        start_from: "all",
+        criteria: "全部候选人都过一遍",
+        target_count: "全部候选人"
+      }
+    });
+    assert.equal(startedAll.status, "ACCEPTED");
+    const stateAfterStartAll = readStubState(workspaceRoot);
+    assert.equal(stateAfterStartAll.last_start_args.targetCount, "-1");
+
     const running = await getBossChatRun({
       workspaceRoot,
       input: {
@@ -287,6 +306,19 @@ async function testBossChatMcpToolsShouldValidateAndRoute() {
     assert.deepEqual(needInput.required_fields, ["job", "start_from", "target_count", "criteria"]);
     assert.equal(Array.isArray(needInput.job_options), true);
     assert.equal(needInput.job_options.length, 2);
+    const targetQuestion = needInput.pending_questions.find((item) => item.field === "target_count");
+    assert.equal(Boolean(targetQuestion), true);
+    assert.equal(targetQuestion.argument_name, "target_count");
+    assert.equal(targetQuestion.options.some((item) => item.value === "all"), true);
+
+    const missingTargetOnly = await callTool(workspaceRoot, TOOL_BOSS_CHAT_START_RUN, {
+      job: "算法工程师",
+      start_from: "all",
+      criteria: "全部候选人都过一遍"
+    }, 111);
+    assert.equal(missingTargetOnly.status, "NEED_INPUT");
+    assert.deepEqual(missingTargetOnly.missing_fields, ["target_count"]);
+    assert.equal(missingTargetOnly.next_call_example.target_count, "all");
 
     const invalidStartResponse = await handleRequest(
       makeToolCall(11, TOOL_BOSS_CHAT_START_RUN, {
@@ -313,6 +345,16 @@ async function testBossChatMcpToolsShouldValidateAndRoute() {
     }, 14);
     assert.equal(started.status, "ACCEPTED");
 
+    const startedAll = await callTool(workspaceRoot, TOOL_BOSS_CHAT_START_RUN, {
+      job: "算法工程师",
+      start_from: "all",
+      criteria: "全部候选人都过一遍",
+      target_count: "全部候选人"
+    }, 140);
+    assert.equal(startedAll.status, "ACCEPTED");
+    const stateAfterStartAll = readStubState(workspaceRoot);
+    assert.equal(stateAfterStartAll.last_start_args.targetCount, "-1");
+
     const running = await callTool(workspaceRoot, TOOL_BOSS_CHAT_GET_RUN, {
       run_id: started.run_id,
       profile: "default"
@@ -386,6 +428,18 @@ async function testBossChatCliShouldSupportRunAndFollowUpParsing() {
     assert.equal(typeof payload.run_id, "string");
     const state = readStubState(workspaceRoot);
     assert.equal(state.get_calls[payload.run_id] || 0, 0);
+
+    await captureConsoleLogs(async () => {
+      await cliTestables.runBossChatCliCommand("run", {
+        "workspace-root": workspaceRoot,
+        job: "算法工程师",
+        "start-from": "all",
+        criteria: "全部候选人都过一遍",
+        targetCount: "全部候选人"
+      });
+    });
+    const allState = readStubState(workspaceRoot);
+    assert.equal(allState.last_start_args.targetCount, "-1");
   });
 }