@reconcrap/boss-recommend-mcp 1.3.9 → 1.3.11

package/README.md

@@ -2,6 +2,11 @@
 
 Boss 推荐页自动化流水线 MCP（stdio）服务。
 
+发布入口：
+
+- npm: `@reconcrap/boss-recommend-mcp`（https://www.npmjs.com/package/@reconcrap/boss-recommend-mcp）
+- GitHub: `reconcrap-cpu/boss-recommend-mcp`（https://github.com/reconcrap-cpu/boss-recommend-mcp）
+
 它把 recommend 页面上的两段能力串起来：
 
 - `boss-recommend-search-cli`: 只负责推荐页筛选项
@@ -79,13 +84,25 @@ MCP 工具：
 
 ## 安装
 
+推荐（npm 全局安装）：
+
 ```bash
-npm install
+npm install -g @reconcrap/boss-recommend-mcp@latest
+boss-recommend-mcp start
+```
+
+无需安装（npx 直接运行）：
+
+```bash
+npx -y @reconcrap/boss-recommend-mcp@latest start
 ```
 
-安装后可以直接运行：
+从 GitHub 源码运行（开发/调试）：
 
 ```bash
+git clone https://github.com/reconcrap-cpu/boss-recommend-mcp.git
+cd boss-recommend-mcp
+npm install
 node src/cli.js start
 ```
 
@@ -101,8 +118,9 @@ BOSS_RECOMMEND_EXTERNAL_SKILL_DIRS  # JSON 数组或系统 path 分隔路径列
 或使用 CLI fallback：
 
 ```bash
-node src/cli.js run --instruction "推荐页筛选985男生，近14天没有，有大模型平台经验，符合标准的收藏"
 npx -y @reconcrap/boss-recommend-mcp@latest run --instruction "推荐页筛选985男生，近14天没有，有大模型平台经验，符合标准的收藏"
+# 源码模式（GitHub clone 后）
+node src/cli.js run --instruction "推荐页筛选985男生，近14天没有，有大模型平台经验，符合标准的收藏"
 ```
 
 ## 配置
@@ -152,6 +170,8 @@ config/screening-config.example.json
 
 ## 常用命令
 
+npm 包安装后可直接使用可执行命令 `boss-recommend-mcp`。以下示例展示源码模式（`node src/cli.js`）：
+
 ```bash
 node src/cli.js install --agent trae-cn
 node src/cli.js init-config
@@ -217,7 +237,7 @@ chat-only 交互建议：
 
 - 先调用一次 `prepare_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` 支持正整数；若用户给出 `全部候选人` / `所有候选人`，会自动按不限（扫到底）处理。
+- `target_count` 支持正整数、`all`、`-1`；若用户给出 `全部候选人` / `所有候选人`，会自动按不限（扫到底）处理。
 
 Trae-CN / 长对话防循环建议：
 

package/package.json

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

package/skills/boss-chat/README.md

@@ -2,6 +2,9 @@
 
 Bundled chat-page automation skill shipped with `boss-recommend-mcp`.
 
+Package: `@reconcrap/boss-recommend-mcp` (npm)
+Source: `https://github.com/reconcrap-cpu/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)
@@ -27,9 +30,9 @@ Anti-loop rules:
 
 target_count mapping:
 - Positive integer means explicit cap (for example 20).
-- `all` / `unlimited` / `全部` / `不限` / `扫到底` / `全量` means unlimited.
+- `all` / `-1` / `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.
+- For unlimited mode, prefer `"target_count": "all"` in the tool call; `-1` is accepted for compatibility and used internally by the CLI.
 - If start_boss_chat_run returns NEED_INPUT for `target_count`, the previous tool call omitted the argument. Retry once using `next_call_example` and include `"target_count": "all"` or a positive integer.
 ```

package/skills/boss-chat/SKILL.md

@@ -40,7 +40,7 @@ description: "Use when users want Boss chat-page screening/outreach via the bund
 `target_count` 填写规则（关键）：
 
 - 正整数：如 `20`
-- 扫到底：`all` / `unlimited` / `全部` / `不限` / `扫到底` / `全量`
+- 扫到底：`all` / `-1` / `unlimited` / `全部` / `不限` / `扫到底` / `全量`
 - 同义短语也可直接用：`全部候选人` / `所有候选人`（等价于扫到底）
 
 ## Hard Rules
@@ -54,7 +54,7 @@ description: "Use when users want Boss chat-page screening/outreach via the bund
 - `target_count` 在 chat-only 启动前也是必填项，不能默认省略。
 - 当用户说“全部候选人/所有候选人”时，必须按“扫到底（unlimited）”处理，不要再追问正整数。
 - 参数名必须写 `target_count`（不要写“目标数量”等中文键名）。
-- 当用户选择“扫到底/全部候选人/所有候选人”时，调用参数统一写：`"target_count": "all"`。
+- 当用户选择“扫到底/全部候选人/所有候选人”时，调用参数优先写：`"target_count": "all"`；`-1` 只作为兼容输入和内部 CLI 表示。
 - 禁止 agent 自行补全 `job/start_from/criteria` 并直接执行，必须由用户明确给出或确认。
 - chat-only 启动流程必须先进入聊天页并拉取岗位列表，再让用户从列表中选择 `job`。
 - 必须先用空参调用 `prepare_boss_chat_run` 获取 `job_options`；不要用 `start_boss_chat_run` 做预备调用。

package/src/boss-chat.js

@@ -12,6 +12,8 @@ const VENDORED_BOSS_CHAT_DIR = path.join(packageRoot, "vendor", "boss-chat-cli")
 const DEFAULT_BOSS_CHAT_POLL_MS = 1500;
 const BOSS_CHAT_TERMINAL_STATES = new Set(["completed", "failed", "canceled"]);
 const CHAT_REQUIRED_FIELDS = ["job", "start_from", "target_count", "criteria"];
+export const TARGET_COUNT_ACCEPTED_EXAMPLES = ["all", -1, 20, "全部候选人"];
+const TARGET_COUNT_WRAPPER_KEYS = ["target_count", "targetCount", "value", "count", "limit"];
 
 function normalizeText(value) {
   return String(value || "").replace(/\s+/g, " ").trim();
@@ -34,6 +36,7 @@ function isUnlimitedTargetCountToken(value) {
   const token = normalizeText(value).toLowerCase();
   if (!token) return false;
   const compact = token.replace(/\s+/g, "");
+  const withoutAnnotation = compact.replace(/[（(【[].*?[）)】\]]/gu, "");
   const knownTokens = new Set([
     "all",
     "unlimited",
@@ -52,33 +55,81 @@ function isUnlimitedTargetCountToken(value) {
     "所有人选",
     "直到完成所有人选"
   ]);
-  if (knownTokens.has(token) || knownTokens.has(compact)) return true;
+  if (knownTokens.has(token) || knownTokens.has(compact) || knownTokens.has(withoutAnnotation)) return true;
   if (/^(?:all|unlimited|infinity|inf|max|full)(?:candidate|candidates)?$/i.test(compact)) return true;
+  if (/^(?:all|unlimited|infinity|inf|max|full)(?:候选人|人选|牛人|人才|人员)?$/iu.test(withoutAnnotation)) return true;
   if (/^(?:全部|所有|全量|不限)(?:候选人|人选|牛人|人才|人员)?$/u.test(compact)) return true;
+  if (!/\d/.test(compact) && /(?:扫到底|全部候选人|所有候选人|全部人选|所有人选)/u.test(compact)) return true;
   return false;
 }
 
-function parseBossChatTargetCount(value) {
+function getWrappedTargetCountValue(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return value;
+  for (const key of TARGET_COUNT_WRAPPER_KEYS) {
+    if (Object.prototype.hasOwnProperty.call(value, key)) {
+      return value[key];
+    }
+  }
+  return value;
+}
+
+export function getBossChatTargetCountValue(input = {}) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return undefined;
+  if (Object.prototype.hasOwnProperty.call(input, "target_count") && input.target_count !== undefined && input.target_count !== null) {
+    return input.target_count;
+  }
+  if (Object.prototype.hasOwnProperty.call(input, "targetCount") && input.targetCount !== undefined && input.targetCount !== null) {
+    return input.targetCount;
+  }
+  if (Object.prototype.hasOwnProperty.call(input, "target_count")) return input.target_count;
+  if (Object.prototype.hasOwnProperty.call(input, "targetCount")) return input.targetCount;
+  return undefined;
+}
+
+function cloneForDiagnostics(value) {
+  if (value === undefined) return undefined;
+  if (value === null || ["string", "number", "boolean"].includes(typeof value)) return value;
+  try {
+    return JSON.parse(JSON.stringify(value));
+  } catch {
+    return String(value);
+  }
+}
+
+export function normalizeTargetCountInput(value) {
   if (value === undefined || value === null) {
     return {
       provided: false,
       targetCount: null,
-      cliArg: null
+      cliArg: null,
+      publicValue: null,
+      rawValue: value,
+      parseError: null
     };
   }
-  const raw = normalizeText(value);
+  const unwrapped = getWrappedTargetCountValue(value);
+  if (unwrapped !== value) {
+    return normalizeTargetCountInput(unwrapped);
+  }
+  const raw = normalizeText(unwrapped);
   if (!raw) {
     return {
       provided: false,
       targetCount: null,
-      cliArg: null
+      cliArg: null,
+      publicValue: null,
+      rawValue: value,
+      parseError: null
     };
   }
   if (isUnlimitedTargetCountToken(raw)) {
     return {
       provided: true,
       targetCount: null,
-      cliArg: "-1"
+      cliArg: "-1",
+      publicValue: "all",
+      rawValue: cloneForDiagnostics(value),
+      parseError: null
     };
   }
   const parsed = Number.parseInt(String(raw), 10);
@@ -86,20 +137,29 @@ function parseBossChatTargetCount(value) {
     return {
       provided: true,
       targetCount: null,
-      cliArg: "-1"
+      cliArg: "-1",
+      publicValue: "all",
+      rawValue: cloneForDiagnostics(value),
+      parseError: null
     };
   }
   if (Number.isFinite(parsed) && parsed > 0) {
     return {
       provided: true,
       targetCount: parsed,
-      cliArg: String(parsed)
+      cliArg: String(parsed),
+      publicValue: parsed,
+      rawValue: cloneForDiagnostics(value),
+      parseError: null
     };
   }
   return {
     provided: false,
     targetCount: null,
-    cliArg: null
+    cliArg: null,
+    publicValue: null,
+    rawValue: cloneForDiagnostics(value),
+    parseError: "target_count must be a positive integer, -1, or one of: all, unlimited, 全部, 不限, 扫到底, 全量, 全部候选人, 所有候选人"
   };
 }
 
@@ -225,7 +285,7 @@ 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 parsedTarget = parseBossChatTargetCount(input.targetCount ?? input.target_count);
+  const parsedTarget = normalizeTargetCountInput(getBossChatTargetCountValue(input));
   const port = parsePositiveInteger(input.port);
   return {
     profile,
@@ -235,6 +295,9 @@ function normalizeBossChatStartInput(input = {}) {
     targetCount: parsedTarget.targetCount,
     targetCountArg: parsedTarget.cliArg,
     targetCountProvided: parsedTarget.provided,
+    targetCountPublicValue: parsedTarget.publicValue,
+    targetCountRawValue: parsedTarget.rawValue,
+    targetCountParseError: parsedTarget.parseError,
     port,
     dryRun: input.dryRun === true || input.dry_run === true,
     noState: input.noState === true || input.no_state === true,
@@ -270,7 +333,7 @@ function buildTargetCountQuestionHint(item = {}) {
     { label: "全部候选人", value: "全部候选人" },
     { label: "所有候选人", value: "所有候选人" }
   ];
-  next.examples = ["all", 20];
+  next.examples = TARGET_COUNT_ACCEPTED_EXAMPLES.slice();
   next.argument_name = "target_count";
   return next;
 }
@@ -290,13 +353,23 @@ function buildNextCallExample(input = {}, missingFields = []) {
   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;
+    sample.target_count = normalized.targetCountPublicValue || (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 buildTargetCountNeedInputDiagnostics(input = {}, missingFields = []) {
+  if (!Array.isArray(missingFields) || !missingFields.includes("target_count")) return {};
+  const normalized = normalizeBossChatStartInput(input);
+  return {
+    accepted_examples: TARGET_COUNT_ACCEPTED_EXAMPLES.slice(),
+    ...(normalized.targetCountRawValue !== undefined ? { received_target_count: normalized.targetCountRawValue } : {}),
+    ...(normalized.targetCountParseError ? { target_count_parse_error: normalized.targetCountParseError } : {})
+  };
+}
+
 function buildBossChatCliArgs(command, input, resolvedConfig) {
   const args = [command, "--json"];
   if (command === "prepare-run") {
@@ -493,12 +566,14 @@ export async function startBossChatRun({ workspaceRoot, input = {} }) {
       : [];
     const normalizedPendingQuestions = normalizePendingQuestions(pendingQuestions);
     const nextCallExample = buildNextCallExample(input, missingFields);
+    const targetCountDiagnostics = buildTargetCountNeedInputDiagnostics(input, missingFields);
     return {
       ...prepared,
       status: "NEED_INPUT",
       required_fields: CHAT_REQUIRED_FIELDS.slice(),
       missing_fields: missingFields,
       pending_questions: normalizedPendingQuestions,
+      ...targetCountDiagnostics,
       ...(nextCallExample ? { next_call_example: nextCallExample } : {}),
       message: prepared?.message
         || "已获取 Boss 聊天页岗位列表，请先补齐 job / start_from / target_count / criteria。"
@@ -518,11 +593,13 @@ export async function prepareBossChatRun({ workspaceRoot, input = {} }) {
     ))
     : [];
   const nextCallExample = buildNextCallExample(input, missingFields);
+  const targetCountDiagnostics = buildTargetCountNeedInputDiagnostics(input, missingFields);
   return {
     ...payload,
     required_fields: CHAT_REQUIRED_FIELDS.slice(),
     missing_fields: missingFields,
     pending_questions: normalizePendingQuestions(pendingQuestions),
+    ...targetCountDiagnostics,
     ...(nextCallExample ? { next_call_example: nextCallExample } : {})
   };
 }

package/src/index.js

@@ -12,6 +12,8 @@ import {
   cancelBossChatRun,
   getBossChatHealthCheck,
   getBossChatRun,
+  getBossChatTargetCountValue,
+  normalizeTargetCountInput,
   pauseBossChatRun,
   prepareBossChatRun,
   resumeBossChatRun,
@@ -119,6 +121,53 @@ function getLongRunPollAfterSec() {
   return Math.max(60, fromEnv);
 }
 
+function createTargetCountInputSchema(description) {
+  return {
+    oneOf: [
+      {
+        type: "integer",
+        minimum: 1
+      },
+      {
+        type: "integer",
+        enum: [-1]
+      },
+      {
+        type: "string",
+        enum: ["all", "unlimited", "-1", "全部", "不限", "扫到底", "全量", "全部候选人", "所有候选人"]
+      },
+      {
+        type: "object",
+        properties: {
+          value: {
+            oneOf: [
+              { type: "integer", minimum: 1 },
+              { type: "integer", enum: [-1] },
+              { type: "string" }
+            ]
+          },
+          target_count: {
+            oneOf: [
+              { type: "integer", minimum: 1 },
+              { type: "integer", enum: [-1] },
+              { type: "string" }
+            ]
+          },
+          targetCount: {
+            oneOf: [
+              { type: "integer", minimum: 1 },
+              { type: "integer", enum: [-1] },
+              { type: "string" }
+            ]
+          }
+        },
+        additionalProperties: true
+      }
+    ],
+    description
+  };
+}
+
 function getRecommendedPollAfterSec(args = {}) {
   return hasFollowUpChatRequest(args)
     ? getLongRunPollAfterSec()
@@ -387,18 +436,7 @@ function createRunInputSchema() {
                 type: "string",
                 enum: ["unread", "all"]
               },
-              target_count: {
-                oneOf: [
-                  {
-                    type: "integer",
-                    minimum: 1
-                  },
-                  {
-                    type: "string",
-                    enum: ["all", "unlimited", "全部", "不限", "扫到底", "全量", "全部候选人", "所有候选人"]
-                  }
-                ]
-              },
+              target_count: createTargetCountInputSchema("boss-chat follow-up 本次处理人数上限；支持正整数、all 或 -1（扫到底）"),
               dry_run: { type: "boolean" },
               no_state: { type: "boolean" },
               safe_pacing: { type: "boolean" },
@@ -436,19 +474,8 @@ function createBossChatStartInputSchema({ requireFullInput = false } = {}) {
         type: "string",
         description: "boss-chat 的筛选 criteria"
       },
-      target_count: {
-        oneOf: [
-          {
-            type: "integer",
-            minimum: 1
-          },
-          {
-            type: "string",
-            enum: ["all", "unlimited", "全部", "不限", "扫到底", "全量", "全部候选人", "所有候选人"]
-          }
-        ],
-        description: "本次处理人数上限；支持正整数或 all/不限/全部候选人（扫到底）"
-      },
+      target_count: createTargetCountInputSchema("本次处理人数上限；支持正整数、all 或 -1（扫到底），也兼容 { value: \"all\" } 等包装对象"),
+      targetCount: createTargetCountInputSchema("兼容字段；优先使用 target_count。本次处理人数上限，支持正整数、all 或 -1（扫到底）"),
       port: {
         type: "integer",
         minimum: 1,
@@ -462,7 +489,11 @@ function createBossChatStartInputSchema({ requireFullInput = false } = {}) {
     additionalProperties: false
   };
   if (requireFullInput) {
-    schema.required = ["job", "start_from", "target_count", "criteria"];
+    schema.required = ["job", "start_from", "criteria"];
+    schema.anyOf = [
+      { required: ["target_count"] },
+      { required: ["targetCount"] }
+    ];
   }
   return schema;
 }
@@ -727,15 +758,11 @@ function validateBossChatStartArgs(args) {
       return "criteria must be a non-empty string when provided";
     }
   }
-  if (Object.prototype.hasOwnProperty.call(args, "target_count")) {
-    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, "target_count")
+    || Object.prototype.hasOwnProperty.call(args, "targetCount")
+  ) {
+    normalizeTargetCountInput(getBossChatTargetCountValue(args));
   }
   if (Object.prototype.hasOwnProperty.call(args, "port")) {
     const port = Number.parseInt(String(args.port), 10);

package/src/pipeline.js

@@ -16,6 +16,7 @@ import {
 import {
   cancelBossChatRun,
   getBossChatRun,
+  normalizeTargetCountInput,
   pauseBossChatRun,
   resumeBossChatRun,
   startBossChatRun
@@ -66,6 +67,10 @@ function parsePositiveIntegerValue(value) {
   return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
 }
 
+function normalizePipelineTargetCountValue(value) {
+  return normalizeTargetCountInput(value).publicValue;
+}
+
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -388,16 +393,17 @@ function normalizeFollowUpChatInput(followUp = null, defaults = null) {
   const defaultCriteria = normalizeText(defaults?.criteria || "");
   const defaultStartFromRaw = normalizeText(defaults?.start_from || "").toLowerCase();
   const defaultStartFrom = defaultStartFromRaw === "all" ? "all" : "unread";
-  const defaultTargetCount = parsePositiveIntegerValue(defaults?.target_count);
+  const defaultTargetCount = normalizePipelineTargetCountValue(defaults?.target_count);
 
   const explicitCriteria = normalizeText(raw.criteria);
   const explicitStartFromRaw = normalizeText(raw.start_from).toLowerCase();
   const explicitStartFrom = explicitStartFromRaw === "all" ? "all" : explicitStartFromRaw === "unread" ? "unread" : "";
-  const explicitTargetCount = parsePositiveIntegerValue(raw.target_count);
+  const explicitTarget = normalizeTargetCountInput(raw.target_count);
+  const explicitTargetCount = explicitTarget.publicValue;
 
   const hasExplicitCriteria = Boolean(explicitCriteria);
   const hasExplicitStartFrom = Boolean(explicitStartFrom);
-  const hasExplicitTargetCount = Number.isInteger(explicitTargetCount) && explicitTargetCount > 0;
+  const hasExplicitTargetCount = explicitTarget.provided;
 
   const criteria = explicitCriteria || defaultCriteria;
   const startFrom = explicitStartFrom || defaultStartFrom;
@@ -442,8 +448,11 @@ function normalizeFollowUpChatInput(followUp = null, defaults = null) {
     missing_fields.push("follow_up.chat.target_count");
     pending_questions.push({
       field: "follow_up.chat.target_count",
-      question: "请填写 boss-chat follow-up 本次处理人数上限（正整数，必填）。",
-      value: summary.target_count
+      question: "请填写 boss-chat follow-up 本次处理人数上限（正整数，或 all/-1 表示扫到底，必填）。",
+      value: summary.target_count,
+      accepted_examples: ["all", -1, 20, "全部候选人"],
+      ...(explicitTarget.rawValue !== undefined ? { received_target_count: explicitTarget.rawValue } : {}),
+      ...(explicitTarget.parseError ? { target_count_parse_error: explicitTarget.parseError } : {})
     });
   }
 
@@ -523,7 +532,7 @@ function buildBossChatFollowUpStatus({ payload, runId, fallbackInput = null, sta
     job: normalizeText(fallbackInput?.job) || null,
     start_from: normalizeText(fallbackInput?.start_from) || null,
     criteria: normalizeText(fallbackInput?.criteria) || null,
-    target_count: parsePositiveIntegerValue(fallbackInput?.target_count),
+    target_count: normalizePipelineTargetCountValue(fallbackInput?.target_count),
     port: parsePositiveIntegerValue(fallbackInput?.port),
     progress: {
       inspected: Number.isInteger(progress.inspected) ? progress.inspected : 0,