@reconcrap/boss-recommend-mcp 1.0.4 → 1.0.6

package/README.md

@@ -74,9 +74,9 @@ npx -y @reconcrap/boss-recommend-mcp@latest run --instruction "推荐页筛选98
 `screening-config.json` 默认写入路径（按优先级）：
 
 1. `BOSS_RECOMMEND_SCREEN_CONFIG`（若已设置）
-2. `<workspace>/config/screening-config.json`（本地 `npm install` / `npx ... install` 默认会优先写这里）
-3. `<workspace>/boss-recommend-mcp/config/screening-config.json`
-4. `~/.boss-recommend-mcp/screening-config.json`（当 workspace 不可写或无 workspace 时回退）
+2. `~/.boss-recommend-mcp/screening-config.json`（默认主路径）
+3. `<workspace>/config/screening-config.json`（兼容历史路径）
+4. `<workspace>/boss-recommend-mcp/config/screening-config.json`（兼容历史路径）
 5. 兼容旧路径：`$CODEX_HOME/boss-recommend-mcp/screening-config.json`
 
 配置路径优先级：
@@ -91,6 +91,7 @@ npx -y @reconcrap/boss-recommend-mcp@latest run --instruction "推荐页筛选98
 
 - `install` / `postinstall` 会自动创建 `screening-config.json` 模板（若目标路径可写）
 - 当当前目录是系统目录（例如 `C:\\Windows\\System32`）、用户主目录根（例如 `C:\\Users\\<name>`）或磁盘根目录时，不会再写入 `<cwd>/config`，而是回退到 `~/.boss-recommend-mcp/screening-config.json`
+- `doctor` / `run` 默认优先读取 `~/.boss-recommend-mcp/screening-config.json`；如需强制其它路径，请设置 `BOSS_RECOMMEND_SCREEN_CONFIG`
 - 首次运行时，若仍检测到默认占位词（如 `replace-with-openai-api-key`），pipeline 会返回配置目录并要求用户修改后确认“已修改完成”再继续
 - 在 `npx` 临时目录（如 `AppData\\Local\\npm-cache\\_npx\\...`）执行时，不会再把该临时目录当作 `screening-config.json` 目标路径
 

package/package.json

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

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

@@ -8,16 +8,19 @@ description: "Use when users ask to run Boss recommend-page filtering and screen
 ## Purpose
 
 当用户希望在 Boss 推荐页按条件筛选候选人时，优先调用 MCP 工具 `run_recommend_pipeline` 完成端到端任务：
-
-1. 解析推荐页筛选指令
-2. 结构化推荐页 filters
-3. 确认筛选 criteria
-4. 在运行开始时询问 `target_count`（可选，可留空）
-5. 在运行开始时一次性确认 `post_action`
-6. 若 `post_action=greet`，同时确认 `max_greet_count`
-7. 在页面就绪后先提取岗位列表，列出全部岗位并让用户确认本次岗位
-8. 用户确认岗位后先点击该岗位，再执行 recommend-search-cli 与 recommend-screen-cli
-9. 返回结果摘要
+
+1. 解析推荐页筛选指令
+2. 第一阶段仅确认非岗位参数（filters / criteria / target_count / post_action / max_greet_count）
+3. 先执行页面就绪检查（端口、登录态、是否在 recommend 页面）
+4. 页面就绪后再提取岗位列表，列出全部岗位并让用户确认本次岗位
+5. 用户确认岗位后先点击该岗位，再执行 recommend-search-cli 与 recommend-screen-cli
+6. 返回结果摘要
+
+严格顺序约束（必须遵守）：
+
+- 在页面就绪前，禁止询问“岗位（job）要选哪个”
+- 只有在工具返回 `job_options` 后，才允许发起岗位确认
+- 岗位确认时必须展示 `job_options` 里的全部岗位，禁止只列一部分或让用户盲填
 
 路由约束（必须遵守）：
 
@@ -32,13 +35,15 @@ description: "Use when users ask to run Boss recommend-page filtering and screen
 - “在 Boss 搜索页面帮我找人” -> `boss-recruit-pipeline`
 - “Find candidates on Boss search page” -> `boss-recruit-pipeline`
 
-## Required Confirmation
-
-在真正执行前，必须先确认：
-
+## Required Confirmation
+
+在真正执行前，按两个阶段确认：
+
+阶段 A（页面就绪前，禁止问岗位）：
+
 - 学校标签（`school_tag`，支持多选）
   - 若输入混合了有效与无效选项（如 `985,211,qs100`），必须忽略无效项并保留有效项；不要直接回退到“不限”
-- 学历（`degree`）
+- 学历（`degree`）
 - 性别（`gender`）
 - 是否过滤近14天已看（`recent_not_view`）
 - screening criteria 是否正确
@@ -49,13 +54,22 @@ description: "Use when users ask to run Boss recommend-page filtering and screen
 - `post_action` 是否确定为 `favorite` 或 `greet`
 - 当 `post_action=greet` 时，`max_greet_count`（最多打招呼人数）是否确定
   - 严禁在未询问用户的情况下自动把 `max_greet_count` 设为 `target_count` 或其他默认值
+
+阶段 B（页面就绪后，且已拿到岗位列表）：
+
 - 岗位（`job`）是否确定
-  - 必须先列出 recommend 页岗位栏里识别到的全部岗位，让用户明确选择
+  - 必须先列出 recommend 页岗位栏里识别到的全部岗位（来自工具返回的 `job_options`），让用户明确选择
   - 即使前序步骤已提取到 `job` 参数，执行前也必须再次展示岗位列表并让用户二次确认
   - 用户确认后必须先点击该岗位，再开始 search 和 screen
 - 正式开始 search/screen 前，必须做最后一轮“全参数总确认”
   - 需要向用户复述并确认：岗位、school_tag、degree、gender、recent_not_view、criteria、target_count、post_action、max_greet_count
   - 只有用户明确最终确认后才允许执行
+
+禁止行为（必须避免）：
+
+- 第一轮就问“你要绑定哪个岗位”
+- 让用户在未登录或未进入推荐页时先填岗位
+- 在岗位确认时只展示部分岗位
 
 `post_action` 的确认是**单次运行级别**的：
 
@@ -174,9 +188,11 @@ CLI fallback 的状态机与 MCP 保持一致：
 - 没有 Python 时，不能先装 Pillow
 
 ## Response Style
-
+
 - 用结构化中文输出
 - 先给用户确认卡片，再正式执行
+- 第一轮确认卡片不得包含 `job` 字段
+- 只有当工具返回 `job_options` 后，岗位确认卡片才允许出现 `job` 字段，且必须完整列出 `job_options`
 - 对 `school_tag/degree/gender/recent_not_view` 必须逐项提问并逐项确认，不可合并成一句“filters已确认”
 - 询问 `criteria` 时必须使用开放式文本输入，不要提供“严格执行/宽松执行”等枚举选项
 - 当页面就绪检查失败时，提示文案里必须包含 `debug_port` 和 recommend 页面 URL

package/src/adapters.js

@@ -161,8 +161,8 @@ function resolveScreenConfigCandidates(workspaceRoot) {
   const candidateMap = buildScreenConfigCandidateMap(workspaceRoot);
   return [
     candidateMap.env_path,
-    ...candidateMap.workspace_paths,
     candidateMap.user_path,
+    ...candidateMap.workspace_paths,
     candidateMap.legacy_path
   ].filter(Boolean);
 }
@@ -183,12 +183,12 @@ function resolveWritableScreenConfigPath(workspaceRoot) {
   if (candidateMap.env_path) {
     return candidateMap.env_path;
   }
-  if (workspacePreferred && canWriteDirectory(path.dirname(workspacePreferred))) {
-    return workspacePreferred;
-  }
   if (candidateMap.user_path && canWriteDirectory(path.dirname(candidateMap.user_path))) {
     return candidateMap.user_path;
   }
+  if (workspacePreferred && canWriteDirectory(path.dirname(workspacePreferred))) {
+    return workspacePreferred;
+  }
   if (workspacePreferred) {
     return workspacePreferred;
   }
@@ -200,6 +200,9 @@ function resolveScreenConfigPath(workspaceRoot) {
   if (candidateMap.env_path) {
     return candidateMap.env_path;
   }
+  if (candidateMap.user_path && pathExists(candidateMap.user_path)) {
+    return candidateMap.user_path;
+  }
   const existingWorkspacePath = candidateMap.workspace_paths.find((item) => pathExists(item));
   if (existingWorkspacePath) {
     return existingWorkspacePath;