@reconcrap/boss-recommend-mcp 2.0.45 → 2.0.47

package/bin/boss-recommend-mcp.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
-import { runCli } from "../src/cli.js";
-
-await runCli(process.argv);
+#!/usr/bin/env node
+import { runCli } from "../src/cli.js";
+
+await runCli(process.argv);

package/config/screening-config.example.json

@@ -1,28 +1,28 @@
 {
-  "baseUrl": "https://api.openai.com/v1",
-  "apiKey": "replace-with-openai-api-key",
-  "model": "gpt-4.1-mini",
-  "llmModels": [],
-  "greetingMessage": "Hi同学，能麻烦发下简历吗？",
-  "llmThinkingLevel": "low",
-  "llmTimeoutMs": 60000,
-  "llmMaxTokens": 512,
-  "llmMaxRetries": 3,
-  "llmImageLimit": 8,
-  "llmImageDetail": "low",
-  "debugPort": 9222,
-  "outputDir": "",
-  "humanRestEnabled": true,
-  "humanBehavior": {
-    "enabled": true,
-    "profile": "paced_with_rests",
-    "clickMovement": true,
-    "textEntry": true,
-    "listScrollJitter": true,
-    "shortRest": true,
-    "batchRest": true,
-    "actionCooldown": true
-  },
-  "openaiOrganization": "optional-org-id",
-  "openaiProject": "optional-project-id"
-}
+  "baseUrl": "https://api.openai.com/v1",
+  "apiKey": "replace-with-openai-api-key",
+  "model": "gpt-4.1-mini",
+  "llmModels": [],
+  "greetingMessage": "Hi同学，能麻烦发下简历吗？",
+  "llmThinkingLevel": "low",
+  "llmTimeoutMs": 60000,
+  "llmMaxTokens": 512,
+  "llmMaxRetries": 3,
+  "llmImageLimit": 8,
+  "llmImageDetail": "low",
+  "debugPort": 9222,
+  "outputDir": "",
+  "humanRestEnabled": true,
+  "humanBehavior": {
+    "enabled": true,
+    "profile": "paced_with_rests",
+    "clickMovement": true,
+    "textEntry": true,
+    "listScrollJitter": true,
+    "shortRest": true,
+    "batchRest": true,
+    "actionCooldown": true
+  },
+  "openaiOrganization": "optional-org-id",
+  "openaiProject": "optional-project-id"
+}

package/package.json

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

package/scripts/postinstall.cjs

@@ -1,44 +1,44 @@
-#!/usr/bin/env node
-const fs = require("node:fs");
-const path = require("node:path");
-const { spawnSync } = require("node:child_process");
-
-function isGlobalInstall() {
-  if (String(process.env.npm_config_global || "").toLowerCase() === "true") return true;
-  if (String(process.env.npm_config_location || "").toLowerCase() === "global") return true;
-
-  const argvRaw = String(process.env.npm_config_argv || "");
-  if (argvRaw.includes("--global") || argvRaw.includes(" -g ")) return true;
-
-  return false;
-}
-
-function main() {
-  const cliPath = path.join(__dirname, "..", "src", "cli.js");
-  if (!fs.existsSync(cliPath)) {
-    return;
-  }
-
-  const initCwd = String(process.env.INIT_CWD || "").trim();
-  const workspaceArgs = initCwd ? ["--workspace-root", path.resolve(initCwd)] : [];
-  const cliArgs = isGlobalInstall()
-    ? [cliPath, "install", ...workspaceArgs]
-    : [cliPath, "init-config", ...workspaceArgs];
-
-  const result = spawnSync(process.execPath, cliArgs, {
-    cwd: path.join(__dirname, ".."),
-    stdio: "inherit",
-    windowsHide: true,
-    shell: false
-  });
-
-  if (result.error) {
-    console.warn(`[boss-recommend-mcp] postinstall warning: ${result.error.message}`);
-    return;
-  }
-  if (typeof result.status === "number" && result.status !== 0) {
-    console.warn(`[boss-recommend-mcp] postinstall warning: install exited with code ${result.status}`);
-  }
-}
-
-main();
+#!/usr/bin/env node
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+function isGlobalInstall() {
+  if (String(process.env.npm_config_global || "").toLowerCase() === "true") return true;
+  if (String(process.env.npm_config_location || "").toLowerCase() === "global") return true;
+
+  const argvRaw = String(process.env.npm_config_argv || "");
+  if (argvRaw.includes("--global") || argvRaw.includes(" -g ")) return true;
+
+  return false;
+}
+
+function main() {
+  const cliPath = path.join(__dirname, "..", "src", "cli.js");
+  if (!fs.existsSync(cliPath)) {
+    return;
+  }
+
+  const initCwd = String(process.env.INIT_CWD || "").trim();
+  const workspaceArgs = initCwd ? ["--workspace-root", path.resolve(initCwd)] : [];
+  const cliArgs = isGlobalInstall()
+    ? [cliPath, "install", ...workspaceArgs]
+    : [cliPath, "init-config", ...workspaceArgs];
+
+  const result = spawnSync(process.execPath, cliArgs, {
+    cwd: path.join(__dirname, ".."),
+    stdio: "inherit",
+    windowsHide: true,
+    shell: false
+  });
+
+  if (result.error) {
+    console.warn(`[boss-recommend-mcp] postinstall warning: ${result.error.message}`);
+    return;
+  }
+  if (typeof result.status === "number" && result.status !== 0) {
+    console.warn(`[boss-recommend-mcp] postinstall warning: install exited with code ${result.status}`);
+  }
+}
+
+main();

package/skills/boss-chat/README.md

@@ -1,39 +1,39 @@
-# boss-chat
-
-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)
-
-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 prepare_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 use start_boss_chat_run for preflight. It is only for the final start call and must include job/start_from/target_count/criteria.
-- 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` / `-1` / `unlimited` / `全部` / `不限` / `扫到底` / `全量` means unlimited.
-- `全部候选人` / `所有候选人` must also be treated as unlimited.
-- Always write the argument key as `target_count`.
-- For unlimited mode, prefer `"target_count": "all"` in the tool call; `-1` is accepted for compatibility and used internally by the CLI.
-- If the tool/UI shows `扫到底（必须传 target_count="all"）`, copy that literal into the next tool call instead of paraphrasing it.
-- 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.
-```
+# boss-chat
+
+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)
+
+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 prepare_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 use start_boss_chat_run for preflight. It is only for the final start call and must include job/start_from/target_count/criteria.
+- 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` / `-1` / `unlimited` / `全部` / `不限` / `扫到底` / `全量` means unlimited.
+- `全部候选人` / `所有候选人` must also be treated as unlimited.
+- Always write the argument key as `target_count`.
+- For unlimited mode, prefer `"target_count": "all"` in the tool call; `-1` is accepted for compatibility and used internally by the CLI.
+- If the tool/UI shows `扫到底（必须传 target_count="all"）`, copy that literal into the next tool call instead of paraphrasing it.
+- 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

@@ -1,93 +1,93 @@
----
-name: "boss-chat"
-description: "Use when users want Boss chat-page screening/outreach via the bundled boss-chat runtime inside boss-recommend-mcp."
----
-
-# Boss Chat Skill
-
-## Goal
-
-当用户要在 Boss 聊天页单独跑筛选/沟通任务时，必须走内置的 chat 工具，而不是要求用户单独安装 `boss-chat`。
-
-适用范围是“chat-only 会话”。若用户意图包含推荐页找人（尤其是“先推荐再沟通”），必须先让 `boss-recommend-pipeline` 完成推荐页任务；推荐完成后如用户仍要聊天页处理，再显式走本 skill。
-
-## Tool Routing
-
-- 健康检查：`boss_chat_health_check`
-- 预备并获取岗位列表：`prepare_boss_chat_run`
-- 启动异步任务：`start_boss_chat_run`
-- 查询进度：`get_boss_chat_run`
-- 暂停：`pause_boss_chat_run`
-- 继续：`resume_boss_chat_run`
-- 取消：`cancel_boss_chat_run`
-
-## Required Inputs
-
-- `job`
-- `start_from`: `unread|all`
-- `target_count`
-- `criteria`
-
-可选：
-
-- `profile`（默认 `default`）
-- `greeting_text`（兼容 `greetingText`，可选自定义首条打招呼消息）
-- `port`
-- `dry_run`
-- `no_state`
-- `safe_pacing`
-- `batch_rest_enabled`
-
-`greeting_text` 默认规则：
-
-- 本次显式传入 `greeting_text`：使用本次值
-- 本次未传，但当前 `profile` 有历史输入：使用历史值
-- 两者都没有：使用内置默认招呼语（`Hi同学，能麻烦发下简历吗？`）
-
-`target_count` 填写规则（关键）：
-
-- 正整数：如 `20`
-- 扫到底：`all` / `-1` / `unlimited` / `全部` / `不限` / `扫到底` / `全量`
-- 同义短语也可直接用：`全部候选人` / `所有候选人`（等价于扫到底）
-
-## Hard Rules
-
-- LLM 配置必须复用 `boss-recommend-mcp` 的 `screening-config.json`；不要再向用户单独要 `baseUrl/apiKey/model`。
-- 路由护栏（强制）：
-  - 只在用户明确是 chat-only 任务时使用本 skill。
-  - 只要用户提到推荐页、先找人后沟通、或需要推荐筛选阶段，禁止直接调用 `start_boss_chat_run`；必须先交给 `boss-recommend-pipeline` 完成推荐页任务。
-  - 不得在 recommend 任务尚未完成时并行启动独立 chat run。
-- 启动或准备 chat run 时，若本机默认 `127.0.0.1:9222` Chrome DevTools 端口不可连，工具会自动打开 Chrome 并导航到 `https://www.zhipin.com/web/chat/index`。
-- 只有工具返回 `BOSS_LOGIN_REQUIRED` / `requires_login=true` 时，才要求用户在自动打开的 Chrome 窗口人工登录 Boss 后重试；不要把“没开 9222 Chrome”当作缺参。
-- 若本机找不到 Chrome，可提示用户设置 `BOSS_MCP_CHROME_PATH` 或 `BOSS_RECOMMEND_CHROME_PATH`；非本机 debug host 不自动启动。
-- `job` / `start_from` / `criteria` 缺一不可；缺参时只补缺口。
-- `target_count` 在 chat-only 启动前也是必填项，不能默认省略。
-- 当用户说“全部候选人/所有候选人”时，必须按“扫到底（unlimited）”处理，不要再追问正整数。
-- 参数名必须写 `target_count`（不要写“目标数量”等中文键名）。
-- 当用户选择“扫到底/全部候选人/所有候选人”时，调用参数优先写：`"target_count": "all"`；`-1` 只作为兼容输入和内部 CLI 表示。
-- `greeting_text` 是可选项，不能因为缺少它阻塞启动或追加必填追问。
-- 若工具或提问选项里出现“扫到底（必须传 `target_count=\"all\"`）”之类字样，下一次工具调用时必须直接照抄这个字面量，不要只保留“扫到底”语义。
-- 禁止 agent 自行补全 `job/start_from/criteria` 并直接执行，必须由用户明确给出或确认。
-- chat-only 启动流程必须先进入聊天页并拉取岗位列表，再让用户从列表中选择 `job`。
-- 必须先用空参调用 `prepare_boss_chat_run` 获取 `job_options`；不要用 `start_boss_chat_run` 做预备调用。
-- `start_boss_chat_run` 只能用于真正启动，必须一次性传齐 `job` / `start_from` / `target_count` / `criteria`。
-- 若 `start_boss_chat_run` 返回 `NEED_INPUT` 且 `missing_fields` 包含 `target_count`，说明你没有把用户选择写入工具参数；下一次调用必须照 `next_call_example` 原样补上 `"target_count": "all"` 或正整数，不要重复空调用。
-- 默认不自动轮询；只有用户要求查进度时才调用 `get_boss_chat_run`。
-- `start_boss_chat_run` 返回 `ACCEPTED` 后，默认立即结束当前回合，不得主动连续调用 `get_boss_chat_run`。
-- 只有当用户明确给出“轮询频率/间隔”（例如“每30分钟查一次”）时，才允许按该频率查询进度。
-- 长任务场景禁止高频轮询；若需持续观察，默认按 30 分钟间隔查询一次状态（除非用户明确要求更频繁）。
-- `pause/resume/cancel` 必须复用同一个 `run_id`。
-
-## Handoff Rule (Recommend -> Chat)
-
-- 若用户先运行了 recommend 流水线，并在手动状态检查时确认 recommend 已完成，且用户目标是“立即进入聊天沟通”：
-  - 先调用 `prepare_boss_chat_run` 获取聊天页岗位列表与缺参。
-  - 显式确认 `job/start_from/target_count/criteria` 后再调用 `start_boss_chat_run`。
-  - 不要查找或依赖 `follow_up.chat`；该自动衔接路径属于 legacy-only 行为。
-
-## Response Style
-
-- 用结构化中文。
-- 首轮建议先调用一次 `prepare_boss_chat_run`（可空参）获取 `job_options` 与 `pending_questions`。
-- 缺参时必须逐项确认：`job`（来自岗位列表）、`start_from`（`unread|all`）、`target_count`、`criteria`。
-- 若健康检查失败，明确提示共享配置文件 `screening-config.json` 不可用。
+---
+name: "boss-chat"
+description: "Use when users want Boss chat-page screening/outreach via the bundled boss-chat runtime inside boss-recommend-mcp."
+---
+
+# Boss Chat Skill
+
+## Goal
+
+当用户要在 Boss 聊天页单独跑筛选/沟通任务时，必须走内置的 chat 工具，而不是要求用户单独安装 `boss-chat`。
+
+适用范围是“chat-only 会话”。若用户意图包含推荐页找人（尤其是“先推荐再沟通”），必须先让 `boss-recommend-pipeline` 完成推荐页任务；推荐完成后如用户仍要聊天页处理，再显式走本 skill。
+
+## Tool Routing
+
+- 健康检查：`boss_chat_health_check`
+- 预备并获取岗位列表：`prepare_boss_chat_run`
+- 启动异步任务：`start_boss_chat_run`
+- 查询进度：`get_boss_chat_run`
+- 暂停：`pause_boss_chat_run`
+- 继续：`resume_boss_chat_run`
+- 取消：`cancel_boss_chat_run`
+
+## Required Inputs
+
+- `job`
+- `start_from`: `unread|all`
+- `target_count`
+- `criteria`
+
+可选：
+
+- `profile`（默认 `default`）
+- `greeting_text`（兼容 `greetingText`，可选自定义首条打招呼消息）
+- `port`
+- `dry_run`
+- `no_state`
+- `safe_pacing`
+- `batch_rest_enabled`
+
+`greeting_text` 默认规则：
+
+- 本次显式传入 `greeting_text`：使用本次值
+- 本次未传，但当前 `profile` 有历史输入：使用历史值
+- 两者都没有：使用内置默认招呼语（`Hi同学，能麻烦发下简历吗？`）
+
+`target_count` 填写规则（关键）：
+
+- 正整数：如 `20`
+- 扫到底：`all` / `-1` / `unlimited` / `全部` / `不限` / `扫到底` / `全量`
+- 同义短语也可直接用：`全部候选人` / `所有候选人`（等价于扫到底）
+
+## Hard Rules
+
+- LLM 配置必须复用 `boss-recommend-mcp` 的 `screening-config.json`；不要再向用户单独要 `baseUrl/apiKey/model`。
+- 路由护栏（强制）：
+  - 只在用户明确是 chat-only 任务时使用本 skill。
+  - 只要用户提到推荐页、先找人后沟通、或需要推荐筛选阶段，禁止直接调用 `start_boss_chat_run`；必须先交给 `boss-recommend-pipeline` 完成推荐页任务。
+  - 不得在 recommend 任务尚未完成时并行启动独立 chat run。
+- 启动或准备 chat run 时，若本机默认 `127.0.0.1:9222` Chrome DevTools 端口不可连，工具会自动打开 Chrome 并导航到 `https://www.zhipin.com/web/chat/index`。
+- 只有工具返回 `BOSS_LOGIN_REQUIRED` / `requires_login=true` 时，才要求用户在自动打开的 Chrome 窗口人工登录 Boss 后重试；不要把“没开 9222 Chrome”当作缺参。
+- 若本机找不到 Chrome，可提示用户设置 `BOSS_MCP_CHROME_PATH` 或 `BOSS_RECOMMEND_CHROME_PATH`；非本机 debug host 不自动启动。
+- `job` / `start_from` / `criteria` 缺一不可；缺参时只补缺口。
+- `target_count` 在 chat-only 启动前也是必填项，不能默认省略。
+- 当用户说“全部候选人/所有候选人”时，必须按“扫到底（unlimited）”处理，不要再追问正整数。
+- 参数名必须写 `target_count`（不要写“目标数量”等中文键名）。
+- 当用户选择“扫到底/全部候选人/所有候选人”时，调用参数优先写：`"target_count": "all"`；`-1` 只作为兼容输入和内部 CLI 表示。
+- `greeting_text` 是可选项，不能因为缺少它阻塞启动或追加必填追问。
+- 若工具或提问选项里出现“扫到底（必须传 `target_count=\"all\"`）”之类字样，下一次工具调用时必须直接照抄这个字面量，不要只保留“扫到底”语义。
+- 禁止 agent 自行补全 `job/start_from/criteria` 并直接执行，必须由用户明确给出或确认。
+- chat-only 启动流程必须先进入聊天页并拉取岗位列表，再让用户从列表中选择 `job`。
+- 必须先用空参调用 `prepare_boss_chat_run` 获取 `job_options`；不要用 `start_boss_chat_run` 做预备调用。
+- `start_boss_chat_run` 只能用于真正启动，必须一次性传齐 `job` / `start_from` / `target_count` / `criteria`。
+- 若 `start_boss_chat_run` 返回 `NEED_INPUT` 且 `missing_fields` 包含 `target_count`，说明你没有把用户选择写入工具参数；下一次调用必须照 `next_call_example` 原样补上 `"target_count": "all"` 或正整数，不要重复空调用。
+- 默认不自动轮询；只有用户要求查进度时才调用 `get_boss_chat_run`。
+- `start_boss_chat_run` 返回 `ACCEPTED` 后，默认立即结束当前回合，不得主动连续调用 `get_boss_chat_run`。
+- 只有当用户明确给出“轮询频率/间隔”（例如“每30分钟查一次”）时，才允许按该频率查询进度。
+- 长任务场景禁止高频轮询；若需持续观察，默认按 30 分钟间隔查询一次状态（除非用户明确要求更频繁）。
+- `pause/resume/cancel` 必须复用同一个 `run_id`。
+
+## Handoff Rule (Recommend -> Chat)
+
+- 若用户先运行了 recommend 流水线，并在手动状态检查时确认 recommend 已完成，且用户目标是“立即进入聊天沟通”：
+  - 先调用 `prepare_boss_chat_run` 获取聊天页岗位列表与缺参。
+  - 显式确认 `job/start_from/target_count/criteria` 后再调用 `start_boss_chat_run`。
+  - 不要查找或依赖 `follow_up.chat`；该自动衔接路径属于 legacy-only 行为。
+
+## Response Style
+
+- 用结构化中文。
+- 首轮建议先调用一次 `prepare_boss_chat_run`（可空参）获取 `job_options` 与 `pending_questions`。
+- 缺参时必须逐项确认：`job`（来自岗位列表）、`start_from`（`unread|all`）、`target_count`、`criteria`。
+- 若健康检查失败，明确提示共享配置文件 `screening-config.json` 不可用。

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

@@ -1,12 +1,12 @@
-# Boss Recommend Pipeline Skill
-
-用于 Boss 推荐页的人选筛选流水线。
-
-核心规则：
-
-- 先确认推荐页 filters
-- 再确认筛选 criteria
-- 再确认本次运行统一动作 `favorite` 或 `greet`
-- 只确认一次 `post_action`，不要逐个候选人反复确认
-- 运行中临时中断请使用 `pause_recommend_pipeline_run`（按 run_id），不要靠自然语言“暂停/继续”指令
-- 继续执行请使用 `resume_recommend_pipeline_run`；状态查询默认按用户指令触发，不自动轮询
+# Boss Recommend Pipeline Skill
+
+用于 Boss 推荐页的人选筛选流水线。
+
+核心规则：
+
+- 先确认推荐页 filters
+- 再确认筛选 criteria
+- 再确认本次运行统一动作 `favorite` 或 `greet`
+- 只确认一次 `post_action`，不要逐个候选人反复确认
+- 运行中临时中断请使用 `pause_recommend_pipeline_run`（按 run_id），不要靠自然语言“暂停/继续”指令
+- 继续执行请使用 `resume_recommend_pipeline_run`；状态查询默认按用户指令触发，不自动轮询