@reconcrap/boss-recruit-mcp 1.0.0 → 1.0.1

package/README.md

@@ -25,6 +25,7 @@ npx @reconcrap/boss-recruit-mcp install
 - 安装 Codex skill 到 `$CODEX_HOME/skills/boss-recruit-pipeline`
 - 初始化用户配置到 `$CODEX_HOME/boss-recruit-mcp/screening-config.json`
 - 包内自带 `boss-search-cli` 与 `boss-screen-cli` 运行时文件，无需额外目录结构
+- 不包含 `favorite-calibration.json`，首次使用前需要自行校准生成
 
 ## 准备配置
 
@@ -37,8 +38,9 @@ $CODEX_HOME/boss-recruit-mcp/screening-config.json
 2. 填写以下字段：
 
 - `baseUrl` / `apiKey` / `model` 必填
-- `calibrationFile` 可选，默认走 `boss-screen-cli/favorite-calibration.json`
-- `outputDir` 可选，不填则输出到 `boss-screen-cli` 目录
+- `debugPort` 可选，默认 `9222`
+- `calibrationFile` 可选；不填时默认使用 `$CODEX_HOME/boss-recruit-mcp/favorite-calibration.json`
+- `outputDir` 可选；不填时默认输出到用户桌面
 
 ## 运行
 
@@ -48,6 +50,40 @@ boss-recruit-mcp start
 
 该服务通过 stdio 与 MCP client 通信。
 
+## Chrome 与校准
+
+推荐先启动调试 Chrome：
+
+```bash
+boss-recruit-mcp launch-chrome --port 9222
+```
+
+然后执行校准：
+
+```bash
+boss-recruit-mcp calibrate --port 9222
+```
+
+校准前请按这个顺序操作：
+
+1. 打开 Boss 直聘搜索页
+2. 随便打开一位人选的详情页
+3. 点击收藏按钮
+4. 再次点击，取消这位人选的收藏
+5. 关闭详情页
+
+校准文件默认生成到：
+
+```bash
+$CODEX_HOME/boss-recruit-mcp/favorite-calibration.json
+```
+
+也可以用下面的命令检查依赖、配置和校准文件：
+
+```bash
+boss-recruit-mcp doctor --port 9222
+```
+
 ## 工具输入
 
 ```json
@@ -70,6 +106,7 @@ boss-recruit-mcp start
 - 确认后自动执行：搜索 CLI -> 筛选 CLI
 - 返回摘要：目标数、已处理、通过数、耗时、输出 CSV
 - 执行前会先做本地依赖预检查，若目录 / 入口 / 配置文件缺失则返回 `PIPELINE_PREFLIGHT_FAILED`
+- 若缺少 `favorite-calibration.json`，会返回 `CALIBRATION_REQUIRED`
 - 若当前运行环境不允许启动子进程，会返回更明确的权限错误码而不是笼统失败
 - 配置文件查找顺序：`BOSS_RECRUIT_SCREEN_CONFIG` > 工作区 `boss-recruit-mcp/config/screening-config.json` > 用户目录 `$CODEX_HOME/boss-recruit-mcp/screening-config.json` > 包内示例配置
 

package/config/screening-config.example.json

@@ -1,7 +1,5 @@
 {
   "baseUrl": "https://your-llm-endpoint.example.com/v1",
   "apiKey": "replace-with-your-api-key",
-  "model": "replace-with-your-model-name",
-  "calibrationFile": "../boss-screen-cli/favorite-calibration.json",
-  "outputDir": "../boss-screen-cli/output"
+  "model": "replace-with-your-model-name"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recruit-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Unified MCP pipeline for boss-search-cli and boss-screen-cli",
   "keywords": [
     "boss",

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

@@ -5,16 +5,18 @@
 ## 安装
 
 ```powershell
-npx boss-recruit-mcp install
+npx @reconcrap/boss-recruit-mcp install
 ```
 
 这条命令会：
 
 - 把 skill 安装到 `$CODEX_HOME/skills/boss-recruit-pipeline`
 - 在 `$CODEX_HOME/boss-recruit-mcp/screening-config.json` 创建配置模板
+- 默认把筛选结果输出到用户桌面
 
 ## 前置要求
 
 - Chrome 已使用 `--remote-debugging-port=9222` 启动
 - Boss 页面已登录
 - 已在用户配置中填写有效的 `baseUrl`、`apiKey`、`model`
+- 已生成 `$CODEX_HOME/boss-recruit-mcp/favorite-calibration.json`

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

@@ -16,6 +16,37 @@
 - 再按自然语言 criteria 做二次 LLM 筛选
 - 适合“做过某方向 + 额外论文/项目/经历要求”的招聘请求
 
+## Setup First
+
+在真正调用 `run_recruit_pipeline` 前，先检查运行条件，不要直接进入搜索：
+
+1. 先检查 MCP 是否已安装 / 可调用；若未安装，优先执行：
+   - `npx @reconcrap/boss-recruit-mcp install`
+2. 先检查依赖与配置；优先执行：
+   - `boss-recruit-mcp doctor --port 9222`
+3. 若用户还未确认 Chrome 调试端口，先提议 `9222`。
+4. 若用户同意 `9222`，或给出新的端口，后续所有动作都使用该端口。
+5. 若 Chrome 未以远程调试模式启动，优先帮助用户启动：
+   - `boss-recruit-mcp launch-chrome --port <port>`
+   - 打开页面：`https://www.zhipin.com/web/chat/search`
+6. 只有在以上条件满足后，才继续调用流水线。
+
+## Calibration Requirement
+
+- 如果缺少 `favorite-calibration.json`，不要直接搜索筛选。
+- 需要明确提醒用户先做校准。
+- 提示语必须包含这几步：
+  - 打开 Boss 直聘
+  - 去到搜索页面
+  - 随便打开一位人选的详情页
+  - 点击收藏按钮
+  - 再次点击取消该人选的收藏
+  - 关闭详情页
+- 然后执行：
+  - `boss-recruit-mcp calibrate --port <port>`
+- 默认校准文件路径：
+  - `$CODEX_HOME/boss-recruit-mcp/favorite-calibration.json`
+
 ## Required MCP Tool
 
 - Tool name: `run_recruit_pipeline`
@@ -26,7 +57,18 @@
 
 ## Execution Policy
 
-1. 收到招聘指令后，先调用一次 `run_recruit_pipeline`（只传 `instruction`）。
+1. 收到招聘指令后，先做 setup 检查：
+   - MCP 是否可用
+   - Chrome 调试端口是否已确认
+   - Chrome 是否已启动到 Boss 搜索页面
+   - `favorite-calibration.json` 是否存在
+2. 若缺少依赖或 MCP 未启动：
+   - 自动安装依赖并帮助用户启动 MCP；
+   - 优先使用 `npx @reconcrap/boss-recruit-mcp install`
+   - 然后使用用户的 MCP 配置启动 `boss-recruit-mcp`
+3. 若缺少校准文件：
+   - 明确提示用户先完成校准，不要直接调用流水线。
+4. 只有当以上条件满足时，才首次调用 `run_recruit_pipeline`（只传 `instruction`）。
 2. 若返回 `NEED_INPUT`：
    - 一次性向用户列出 `missing_fields` 所有缺失项；
    - 缺失项常见含义：
@@ -44,6 +86,7 @@
 5. 若返回 `FAILED`：
    - 先提炼 `error.code`、`error.message`、`diagnostics`；
    - 如果是 `PIPELINE_PREFLIGHT_FAILED`，明确指出缺失的本地目录 / 文件；
+   - 如果是 `CALIBRATION_REQUIRED`，明确提醒用户执行校准，并给出校准步骤；
    - 如果是 `SEARCH_PROCESS_PERMISSION_DENIED` 或 `SCREEN_PROCESS_PERMISSION_DENIED`，明确说明“当前环境拒绝创建子进程”，建议用户在本地终端直接运行 MCP；
    - 如果是 `SEARCH_CLI_MISSING` / `SCREEN_CLI_MISSING` / `SCREEN_CONFIG_ERROR`，直接告诉用户缺什么，不要只说“重试”；
    - 若是可修复输入问题，提示用户修正条件后重试。
@@ -61,6 +104,8 @@
 - 如果失败原因明显是环境问题，要直接说明不是用户输入有误。
 - 如果工具已经返回 `diagnostics.checks`，优先基于这些检查项生成排障建议。
 - 如果工具返回 `output_csv`，在摘要里给出路径，避免重复解释内部流程。
+- 如果端口还没确认，优先询问用户是否使用 `9222`，并把它作为推荐值。
+- 如果需要打开 Chrome，优先帮用户执行而不是只给命令。
 
 ## Example
 
@@ -70,10 +115,13 @@
 
 期望行为：
 
-1. 首次调用流水线。
-2. 若 keyword 被自动提取为 `AI infra`，先让用户确认。
-3. 确认后再次调用。
-4. 成功则返回通过人数与 CSV 路径；失败则按错误类型给出下一步。
+1. 先提议 Chrome 调试端口 `9222`。
+2. 用户确认后，启动调试 Chrome 并打开 Boss 搜索页面。
+3. 先检查校准文件是否存在；若不存在，提醒用户按步骤完成校准。
+4. 环境就绪后再首次调用流水线。
+5. 若 keyword 被自动提取为 `AI infra`，先让用户确认。
+6. 确认后再次调用。
+7. 成功则返回通过人数与 CSV 路径；失败则按错误类型给出下一步。
 
 ## Response Style
 

package/src/adapters.js

@@ -16,6 +16,14 @@ function getUserConfigPath() {
   return path.join(getCodexHome(), "boss-recruit-mcp", "screening-config.json");
 }
 
+function getUserCalibrationPath() {
+  return path.join(getCodexHome(), "boss-recruit-mcp", "favorite-calibration.json");
+}
+
+function getDesktopDir() {
+  return path.join(os.homedir(), "Desktop");
+}
+
 function resolveScreenConfigPath(workspaceRoot) {
   const envConfigPath = process.env.BOSS_RECRUIT_SCREEN_CONFIG
     ? path.resolve(process.env.BOSS_RECRUIT_SCREEN_CONFIG)
@@ -182,10 +190,35 @@ function loadScreenConfig(configPath) {
   }
 }
 
+function resolveDebugPort(config) {
+  const fromEnv = Number.parseInt(process.env.BOSS_RECRUIT_CHROME_PORT || "", 10);
+  if (Number.isFinite(fromEnv) && fromEnv > 0) return fromEnv;
+  const fromConfig = Number.parseInt(String(config?.debugPort || ""), 10);
+  if (Number.isFinite(fromConfig) && fromConfig > 0) return fromConfig;
+  return 9222;
+}
+
+function resolveWorkspaceDebugPort(workspaceRoot) {
+  const configPath = resolveScreenConfigPath(workspaceRoot);
+  if (pathExists(configPath)) {
+    const loaded = loadScreenConfig(configPath);
+    if (loaded.ok) {
+      return resolveDebugPort(loaded.config);
+    }
+  }
+  return resolveDebugPort(null);
+}
+
 export function runPipelinePreflight(workspaceRoot) {
   const searchDir = resolveSearchCliDir(workspaceRoot);
   const screenDir = resolveScreenCliDir(workspaceRoot);
   const screenConfigPath = resolveScreenConfigPath(workspaceRoot);
+  const loaded = pathExists(screenConfigPath) ? loadScreenConfig(screenConfigPath) : null;
+  const calibrationPath = loaded?.ok
+    ? (loaded.config.calibrationFile
+      ? path.resolve(path.dirname(screenConfigPath), loaded.config.calibrationFile)
+      : getUserCalibrationPath())
+    : getUserCalibrationPath();
   const checks = [
     {
       key: "search_cli_dir",
@@ -216,6 +249,12 @@ export function runPipelinePreflight(workspaceRoot) {
       ok: pathExists(screenConfigPath),
       path: screenConfigPath,
       message: "screening-config.json 不存在"
+    },
+    {
+      key: "favorite_calibration",
+      ok: pathExists(calibrationPath),
+      path: calibrationPath,
+      message: "favorite-calibration.json 不存在，请先完成收藏按钮校准"
     }
   ];
 
@@ -231,6 +270,7 @@ function localDirHint(workspaceRoot, dirName) {
 
 export async function runSearchCli({ workspaceRoot, searchParams }) {
   const searchDir = resolveSearchCliDir(workspaceRoot);
+  const debugPort = resolveWorkspaceDebugPort(workspaceRoot);
   if (!searchDir) {
     return {
       ok: false,
@@ -251,7 +291,9 @@ export async function runSearchCli({ workspaceRoot, searchParams }) {
     "--schools",
     searchParams.schools.join(","),
     "--city",
-    searchParams.city
+    searchParams.city,
+    "--port",
+    String(debugPort)
   ];
 
   const result = await runProcess({
@@ -304,7 +346,8 @@ export async function runScreenCli({ workspaceRoot, screenParams }) {
 
   const calibration = loaded.config.calibrationFile
     ? path.resolve(configBaseDir, loaded.config.calibrationFile)
-    : path.join(screenDir, "favorite-calibration.json");
+    : getUserCalibrationPath();
+  const debugPort = resolveDebugPort(loaded.config);
 
   const outputName = `筛选结果_${Date.now()}.csv`;
   let outputPath = outputName;
@@ -312,6 +355,10 @@ export async function runScreenCli({ workspaceRoot, screenParams }) {
     const resolvedOutputDir = path.resolve(configBaseDir, loaded.config.outputDir);
     fs.mkdirSync(resolvedOutputDir, { recursive: true });
     outputPath = path.join(resolvedOutputDir, outputName);
+  } else {
+    const desktopDir = getDesktopDir();
+    fs.mkdirSync(desktopDir, { recursive: true });
+    outputPath = path.join(desktopDir, outputName);
   }
 
   const args = [
@@ -322,6 +369,8 @@ export async function runScreenCli({ workspaceRoot, screenParams }) {
     loaded.config.apiKey,
     "--model",
     loaded.config.model,
+    "--port",
+    String(debugPort),
     "--criteria",
     screenParams.criteria,
     "--targetCount",

package/src/cli.js

@@ -2,13 +2,24 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import process from "node:process";
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import { startServer } from "./index.js";
+import { runPipelinePreflight } from "./adapters.js";
 
+const require = createRequire(import.meta.url);
 const currentFilePath = fileURLToPath(import.meta.url);
 const packageRoot = path.resolve(path.dirname(currentFilePath), "..");
 const skillSourceDir = path.join(packageRoot, "skills", "boss-recruit-pipeline");
 const exampleConfigPath = path.join(packageRoot, "config", "screening-config.example.json");
+const calibrationScriptPath = path.join(
+  packageRoot,
+  "vendor",
+  "boss-screen-cli",
+  "calibrate-favorite-position-v2.cjs"
+);
+const bossUrl = "https://www.zhipin.com/web/chat/search";
 
 function getCodexHome() {
   return process.env.CODEX_HOME
@@ -20,6 +31,74 @@ function ensureDir(targetPath) {
   fs.mkdirSync(targetPath, { recursive: true });
 }
 
+function getDesktopDir() {
+  return path.join(os.homedir(), "Desktop");
+}
+
+function getUserConfigPath() {
+  return path.join(getCodexHome(), "boss-recruit-mcp", "screening-config.json");
+}
+
+function getUserCalibrationPath() {
+  return path.join(getCodexHome(), "boss-recruit-mcp", "favorite-calibration.json");
+}
+
+function parseOptions(args) {
+  const options = {};
+  for (let i = 0; i < args.length; i++) {
+    const token = args[i];
+    if (!token.startsWith("--")) continue;
+    const key = token.slice(2);
+    const next = args[i + 1];
+    if (next && !next.startsWith("--")) {
+      options[key] = next;
+      i += 1;
+    } else {
+      options[key] = true;
+    }
+  }
+  return options;
+}
+
+function hasModule(moduleName) {
+  try {
+    require.resolve(moduleName);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function getDebugPort(options = {}) {
+  const raw = options.port || process.env.BOSS_RECRUIT_CHROME_PORT || "9222";
+  const port = Number.parseInt(String(raw), 10);
+  return Number.isFinite(port) && port > 0 ? port : 9222;
+}
+
+function getChromeExecutable() {
+  const candidates = [
+    process.env.BOSS_RECRUIT_CHROME_PATH,
+    path.join(process.env.LOCALAPPDATA || "", "Google", "Chrome", "Application", "chrome.exe"),
+    path.join(process.env.ProgramFiles || "", "Google", "Chrome", "Application", "chrome.exe"),
+    path.join(process.env["ProgramFiles(x86)"] || "", "Google", "Chrome", "Application", "chrome.exe")
+  ].filter(Boolean);
+
+  return candidates.find((candidate) => fs.existsSync(candidate)) || null;
+}
+
+function runNodeScript(scriptPath, args) {
+  return new Promise((resolve) => {
+    const child = spawn(process.execPath, [scriptPath, ...args], {
+      cwd: packageRoot,
+      stdio: "inherit",
+      windowsHide: false,
+      shell: false
+    });
+    child.on("close", (code) => resolve(code ?? 0));
+    child.on("error", () => resolve(1));
+  });
+}
+
 function installSkill() {
   const codexHome = getCodexHome();
   const targetDir = path.join(codexHome, "skills", "boss-recruit-pipeline");
@@ -30,15 +109,96 @@ function installSkill() {
 
 function ensureUserConfig() {
   const targetDir = path.join(getCodexHome(), "boss-recruit-mcp");
-  const targetPath = path.join(targetDir, "screening-config.json");
+  const targetPath = getUserConfigPath();
   ensureDir(targetDir);
   if (!fs.existsSync(targetPath)) {
-    fs.copyFileSync(exampleConfigPath, targetPath);
+    const template = JSON.parse(fs.readFileSync(exampleConfigPath, "utf8"));
+    template.outputDir = getDesktopDir();
+    fs.writeFileSync(targetPath, JSON.stringify(template, null, 2), "utf8");
     return { path: targetPath, created: true };
   }
   return { path: targetPath, created: false };
 }
 
+function printDoctor(options) {
+  const port = getDebugPort(options);
+  const checks = runPipelinePreflight(process.cwd()).checks.slice();
+  const userConfigPath = getUserConfigPath();
+  checks.push({
+    key: "user_config",
+    ok: fs.existsSync(userConfigPath),
+    path: userConfigPath,
+    message: "用户配置不存在"
+  });
+  checks.push({
+    key: "calibration_script",
+    ok: fs.existsSync(calibrationScriptPath),
+    path: calibrationScriptPath,
+    message: "校准脚本不存在"
+  });
+  checks.push({
+    key: "dependency_ws",
+    ok: hasModule("ws"),
+    path: "ws",
+    message: "缺少 ws 依赖"
+  });
+  checks.push({
+    key: "dependency_chrome_remote_interface",
+    ok: hasModule("chrome-remote-interface"),
+    path: "chrome-remote-interface",
+    message: "缺少 chrome-remote-interface 依赖"
+  });
+  checks.push({
+    key: "chrome_debug_port",
+    ok: true,
+    path: `http://localhost:${port}`,
+    message: `建议使用 Chrome 调试端口 ${port}`
+  });
+  console.log(JSON.stringify({ ok: checks.every((item) => item.ok), port, checks }, null, 2));
+}
+
+async function calibrate(options) {
+  const port = getDebugPort(options);
+  const output = options.output ? path.resolve(String(options.output)) : getUserCalibrationPath();
+  console.log("Before calibration:");
+  console.log("1. Open Boss search page.");
+  console.log("2. Open any candidate detail page.");
+  console.log("3. Click the favorite button once.");
+  console.log("4. Click again to cancel favorite for that candidate.");
+  console.log("5. Close the detail page after calibration completes.");
+  console.log("");
+  const code = await runNodeScript(calibrationScriptPath, [
+    "--port",
+    String(port),
+    "--output",
+    output
+  ]);
+  process.exitCode = code;
+}
+
+function launchChrome(options) {
+  const chromePath = getChromeExecutable();
+  if (!chromePath) {
+    console.error("Chrome executable not found. Set BOSS_RECRUIT_CHROME_PATH or install Google Chrome.");
+    process.exitCode = 1;
+    return;
+  }
+  const port = getDebugPort(options);
+  const args = [
+    `--remote-debugging-port=${port}`,
+    "--new-window",
+    bossUrl
+  ];
+  const child = spawn(chromePath, args, {
+    detached: true,
+    stdio: "ignore",
+    windowsHide: false
+  });
+  child.unref();
+  console.log(`Chrome launched with remote debugging port ${port}`);
+  console.log(`URL: ${bossUrl}`);
+}
+
 function printHelp() {
   console.log("boss-recruit-mcp");
   console.log("");
@@ -48,6 +208,9 @@ function printHelp() {
   console.log("  boss-recruit-mcp install      Install Codex skill and initialize user config");
   console.log("  boss-recruit-mcp install-skill Install only the Codex skill");
   console.log("  boss-recruit-mcp init-config  Create ~/.codex/boss-recruit-mcp/screening-config.json if missing");
+  console.log("  boss-recruit-mcp doctor       Check config, calibration, and runtime prerequisites");
+  console.log("  boss-recruit-mcp calibrate    Run favorite-button calibration and save favorite-calibration.json");
+  console.log("  boss-recruit-mcp launch-chrome Launch Chrome in remote-debugging mode and open Boss search");
   console.log("  boss-recruit-mcp where        Print installed package, skill, and config paths");
 }
 
@@ -57,7 +220,9 @@ function printPaths() {
   console.log(`skill_source=${skillSourceDir}`);
   console.log(`codex_home=${codexHome}`);
   console.log(`skill_target=${path.join(codexHome, "skills", "boss-recruit-pipeline")}`);
-  console.log(`config_target=${path.join(codexHome, "boss-recruit-mcp", "screening-config.json")}`);
+  console.log(`config_target=${getUserConfigPath()}`);
+  console.log(`calibration_target=${getUserCalibrationPath()}`);
+  console.log(`desktop_output_default=${getDesktopDir()}`);
 }
 
 function installAll() {
@@ -72,11 +237,13 @@ function installAll() {
   console.log("");
   console.log("Next steps:");
   console.log("1. Fill in baseUrl/apiKey/model in the config file above.");
-  console.log("2. Start Chrome with --remote-debugging-port=9222 and log in to Boss.");
-  console.log("3. Run `boss-recruit-mcp start` or configure your MCP client to launch `boss-recruit-mcp`.");
+  console.log("2. Run `boss-recruit-mcp launch-chrome --port 9222` and log in to Boss if needed.");
+  console.log("3. Run `boss-recruit-mcp calibrate --port 9222` to generate favorite-calibration.json.");
+  console.log("4. Run `boss-recruit-mcp start` or configure your MCP client to launch `boss-recruit-mcp`.");
 }
 
 const command = process.argv[2] || "start";
+const options = parseOptions(process.argv.slice(3));
 
 switch (command) {
   case "start":
@@ -97,6 +264,15 @@ switch (command) {
     );
     break;
   }
+  case "doctor":
+    printDoctor(options);
+    break;
+  case "calibrate":
+    await calibrate(options);
+    break;
+  case "launch-chrome":
+    launchChrome(options);
+    break;
   case "where":
     printPaths();
     break;

package/src/pipeline.js

@@ -131,9 +131,14 @@ export async function runRecruitPipeline({
 
   const preflight = runPipelinePreflight(workspaceRoot);
   if (!preflight.ok) {
+    const missingCalibration = preflight.checks.find(
+      (check) => check.key === "favorite_calibration" && !check.ok
+    );
     return buildFailedResponse(
-      "PIPELINE_PREFLIGHT_FAILED",
-      "招聘流水线运行前检查失败，请先修复缺失的本地依赖或配置文件。",
+      missingCalibration ? "CALIBRATION_REQUIRED" : "PIPELINE_PREFLIGHT_FAILED",
+      missingCalibration
+        ? "尚未完成收藏按钮校准，请先生成 favorite-calibration.json 后再执行筛选。"
+        : "招聘流水线运行前检查失败，请先修复缺失的本地依赖或配置文件。",
       {
         search_params: parsed.searchParams,
         screen_params: parsed.screenParams,

package/vendor/boss-screen-cli/boss-screen-cli.cjs

@@ -18,6 +18,7 @@ const apiKey = args.apikey || args.apiKey;
 const model = args.model;
 const criteria = args.criteria;
 const targetCount = parseInt(args.target || args.targetCount || '10');
+const debugPort = Number.parseInt(args.port || '9222', 10);
 const configFile = args.config || 'favorite-calibration.json';
 const outputCsv = args.output || `筛选结果_${Date.now()}.csv`;
 
@@ -39,7 +40,7 @@ function loadCalibration() {
 
 async function getChromeTab() {
     return new Promise((resolve, reject) => {
-        http.get('http://localhost:9222/json/list', (res) => {
+        http.get(`http://localhost:${debugPort}/json/list`, (res) => {
             let data = '';
             res.on('data', chunk => data += chunk);
             res.on('end', () => {

package/vendor/boss-screen-cli/calibrate-favorite-position-v2.cjs

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+const WebSocket = require('ws');
+const fs = require('fs');
+const path = require('path');
+
+const args = process.argv.slice(2).reduce((acc, arg, i, arr) => {
+    if (arg.startsWith('--')) {
+        const key = arg.slice(2);
+        acc[key] = arr[i + 1] && !arr[i + 1].startsWith('--') ? arr[i + 1] : true;
+    }
+    return acc;
+}, {});
+
+const debugPort = Number.parseInt(args.port || '9222', 10);
+const outputFile = path.resolve(args.output || path.join(process.cwd(), 'favorite-calibration.json'));
+
+console.log('\x1b[36m========================================\x1b[0m');
+console.log('\x1b[36mFavorite Button Calibration Tool\x1b[0m');
+console.log('\x1b[36m========================================\x1b[0m');
+console.log();
+
+async function main() {
+    let tabs;
+    try {
+        const response = await fetch(`http://localhost:${debugPort}/json/list`);
+        tabs = await response.json();
+    } catch (e) {
+        console.log('\x1b[31mFailed to connect to Chrome DevTools: ' + e.message + '\x1b[0m');
+        process.exit(1);
+    }
+
+    const bossTab = tabs.find(tab => tab.url && tab.url.includes('zhipin.com'));
+    if (!bossTab) {
+        console.log('\x1b[31mBOSS page not found!\x1b[0m');
+        process.exit(1);
+    }
+
+    console.log('\x1b[32mFound: ' + bossTab.title + '\x1b[0m');
+    console.log('\x1b[90mURL: ' + bossTab.url + '\x1b[0m');
+
+    const wsUrl = bossTab.webSocketDebuggerUrl;
+    const ws = new WebSocket(wsUrl);
+
+    await new Promise((resolve, reject) => {
+        ws.on('open', resolve);
+        ws.on('error', reject);
+    });
+    console.log('\x1b[32mConnected!\x1b[0m');
+
+    const js = `(function() {
+    window.__calibrationData = null;
+
+    var iframes = document.querySelectorAll('iframe');
+    for (var i = 0; i < iframes.length; i++) {
+        var iframe = iframes[i];
+        if (iframe.src && iframe.src.includes('c-resume')) {
+            try {
+                var iframeDoc = iframe.contentDocument || iframe.contentWindow.document;
+                var canvases = iframeDoc.querySelectorAll('canvas');
+                if (canvases.length > 0) {
+                    var canvas = canvases[0];
+                    canvas.addEventListener('click', function(e) {
+                        window.__calibrationData = {
+                            clicked: true,
+                            pageX: e.pageX,
+                            pageY: e.pageY,
+                            clientX: e.clientX,
+                            clientY: e.clientY,
+                            canvasX: e.clientX - canvas.getBoundingClientRect().left,
+                            canvasY: e.clientY - canvas.getBoundingClientRect().top
+                        };
+                    }, { once: true });
+                    return { success: true, canvasId: canvas.id };
+                }
+            } catch (e) {
+                return { success: false, error: e.message };
+            }
+            break;
+        }
+    }
+    return { success: false, error: 'Canvas not found' };
+})()`;
+
+    let msgId = 1;
+
+    function sendMessage(method, params) {
+        return new Promise((resolve) => {
+            const id = msgId++;
+            const handler = (data) => {
+                try {
+                    const msg = JSON.parse(data);
+                    if (msg.id === id) {
+                        ws.off('message', handler);
+                        resolve(msg);
+                    }
+                } catch (e) {}
+            };
+            ws.on('message', handler);
+            ws.send(JSON.stringify({ id, method, params }));
+        });
+    }
+
+    const result = await sendMessage('Runtime.evaluate', { expression: js, returnByValue: true });
+
+    if (result.result && result.result.result && result.result.result.value) {
+        const val = result.result.result.value;
+        if (val.success) {
+            console.log('\x1b[32mClick listener added to canvas!\x1b[0m');
+        } else {
+            console.log('\x1b[31mFailed to add listener: ' + val.error + '\x1b[0m');
+            ws.close();
+            process.exit(1);
+        }
+    }
+
+    console.log();
+    console.log('\x1b[33m========================================\x1b[0m');
+    console.log('\x1b[33mCALIBRATION MODE - Click the FAVORITE BUTTON now!\x1b[0m');
+    console.log('\x1b[33m========================================\x1b[0m');
+    console.log();
+    console.log('\x1b[36mMonitoring for 30 seconds...\x1b[0m');
+    console.log();
+
+    const checkJs = `(function() {
+    if (window.__calibrationData && window.__calibrationData.clicked) {
+        var data = window.__calibrationData;
+        window.__calibrationData = null;
+        return { clicked: true, position: data };
+    }
+    return { clicked: false };
+})()`;
+
+    const endTime = Date.now() + 30000;
+    let clickResult = null;
+
+    while (Date.now() < endTime && ws.readyState === WebSocket.OPEN && !clickResult) {
+        const checkResult = await sendMessage('Runtime.evaluate', { expression: checkJs, returnByValue: true });
+
+        if (checkResult.result && checkResult.result.result && checkResult.result.result.value) {
+            const val = checkResult.result.result.value;
+            if (val.clicked) {
+                clickResult = val.position;
+                break;
+            }
+        }
+
+        await new Promise(r => setTimeout(r, 300));
+        process.stdout.write('\x1b[90m.\x1b[0m');
+    }
+
+    if (clickResult) {
+        console.log();
+        console.log();
+        console.log('\x1b[32m========================================\x1b[0m');
+        console.log('\x1b[32mCLICK CAPTURED!\x1b[0m');
+        console.log('\x1b[32m========================================\x1b[0m');
+        console.log();
+        console.log('\x1b[37m  pageX: ' + clickResult.pageX + '\x1b[0m');
+        console.log('\x1b[37m  pageY: ' + clickResult.pageY + '\x1b[0m');
+        console.log('\x1b[37m  canvasX: ' + clickResult.canvasX + '\x1b[0m');
+        console.log('\x1b[37m  canvasY: ' + clickResult.canvasY + '\x1b[0m');
+
+        const calibration = {
+            timestamp: new Date().toISOString().replace('T', ' ').slice(0, 19),
+            favoritePosition: {
+                pageX: clickResult.pageX,
+                pageY: clickResult.pageY,
+                canvasX: clickResult.canvasX,
+                canvasY: clickResult.canvasY
+            }
+        };
+
+        fs.mkdirSync(path.dirname(outputFile), { recursive: true });
+        fs.writeFileSync(outputFile, JSON.stringify(calibration, null, 2), 'utf8');
+        console.log();
+        console.log('\x1b[32mCalibration saved to: ' + outputFile + '\x1b[0m');
+    } else {
+        console.log();
+        console.log();
+        console.log('\x1b[31mNo click detected within 30 seconds.\x1b[0m');
+    }
+
+    ws.close();
+    console.log();
+    console.log('\x1b[36mDone.\x1b[0m');
+}
+
+main().catch(err => {
+    console.error('\x1b[31mError: ' + err.message + '\x1b[0m');
+    process.exit(1);
+});

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

@@ -3,7 +3,9 @@ import { BossSearcher } from './boss-searcher.js';
 
 class BossSearchCLI {
   constructor() {
-    this.searcher = new BossSearcher(9222);
+    const args = this.parseArgs();
+    this.args = args;
+    this.searcher = new BossSearcher(args.port);
   }
 
   async run() {
@@ -11,12 +13,10 @@ class BossSearchCLI {
     console.log('  Boss直聘搜索自动化工具');
     console.log('========================================\n');
 
-    const args = this.parseArgs();
-    
     const connected = await this.searcher.connect();
     if (!connected) {
       console.log('\n请确保Chrome已通过以下命令启动：');
-      console.log('chrome.exe --remote-debugging-port=9222');
+      console.log(`chrome.exe --remote-debugging-port=${this.args.port}`);
       process.exit(1);
     }
 
@@ -35,12 +35,12 @@ class BossSearchCLI {
 
       // 第二步：设置其他过滤条件（城市、学历、院校等）
       if (args.city) {
-        await this.searcher.setCity(args.city);
+        await this.searcher.setCity(this.args.city);
         await this.searcher.sleep(500);
         console.log('');
       }
 
-      await this.searchWithConfig(args);
+      await this.searchWithConfig(this.args);
     } catch (error) {
       console.error('❌ 执行出错:', error);
     } finally {
@@ -54,6 +54,7 @@ class BossSearchCLI {
       degree: '不限',
       schools: [],
       city: null,
+      port: 9222,
       experience: '不限',
       ageMin: null,
       ageMax: null
@@ -84,6 +85,11 @@ class BossSearchCLI {
         });
       } else if (arg === '--city' || arg === '-c') {
         args.city = argv[++i];
+      } else if (arg === '--port' || arg === '-p') {
+        const port = Number.parseInt(argv[++i], 10);
+        if (Number.isFinite(port) && port > 0) {
+          args.port = port;
+        }
       }
     }
 

package/vendor/boss-screen-cli/favorite-calibration.json

@@ -1,9 +0,0 @@
-{
-  "timestamp": "2026-03-22 14:06:49",
-  "favoritePosition": {
-    "pageX": 760,
-    "pageY": 64,
-    "canvasX": 760,
-    "canvasY": 64
-  }
-}