@reconcrap/boss-recommend-mcp 2.1.2 → 2.1.4

package/README.md

@@ -83,6 +83,8 @@ MCP 工具：
 
 - `list_recommend_jobs`（只读读取推荐页岗位下拉框，返回可直接用于 cron/一次性任务的 `job_names`）
 - `prepare_recommend_pipeline_run`（只校验完整 payload 是否已可用于 cron/一次性任务；不启动筛选，返回 `READY + cron_ready=true` 后才应创建 cron）
+- `schedule_recommend_pipeline_run`（创建 package-owned 定时任务；保存已 READY 的完整 payload，启动 detached scheduler，到点后直接调用 `start_recommend_pipeline_run`）
+- `get_recommend_scheduled_run`（查询 package-owned 定时任务；到点后会显示内层 `run_id` 和 run 快照）
 - `start_recommend_pipeline_run`（异步启动；同样先经过前置门禁，通过后返回 run_id）
 - `get_recommend_pipeline_run`（轮询 run_id 状态）
 - `cancel_recommend_pipeline_run`（取消运行中任务）
@@ -114,21 +116,24 @@ MCP 工具：
 boss-recommend-mcp list-jobs --slow-live --port 9222
 ```
 
-返回的 `job_names` 可直接作为后续 `start_recommend_pipeline_run` 的 `confirmation.job_value` / `overrides.job`。
+返回的 `job_names` 可直接作为后续 `start_recommend_pipeline_run` 的 `overrides.job`；旧版 `confirmation.job_value` 仍兼容。
 
-Cron / 一次性定时任务设置建议先在设置阶段完成 Chrome/登录/岗位发现与全部确认：
+Cron / 一次性定时任务设置建议先在设置阶段完成 Chrome/登录/岗位发现与一次总确认；确认文件推荐只包含 `{ "final_confirmed": true }`：
 
 ```bash
 boss-recommend-mcp prepare-run --instruction-file boss-recommend-instruction.txt --overrides-file boss-recommend-overrides.json --confirmation-file boss-recommend-confirmation.json --slow-live --port 9222
+boss-recommend-mcp schedule-run --schedule-delay-minutes 10 --instruction-file boss-recommend-instruction.txt --overrides-file boss-recommend-overrides.json --confirmation-file boss-recommend-confirmation.json --slow-live --port 9222
+boss-recommend-mcp schedule-status --schedule-id <schedule_id>
 ```
 
-只有输出 `status: "READY"` 且 `cron_ready: true` 后，才把同一份 payload 写入 cron 并在到点时调用 `start_recommend_pipeline_run` / `boss-recommend-mcp run --detached`。如果设置阶段返回 `BOSS_LOGIN_REQUIRED`、`NEED_INPUT` 或 `NEED_CONFIRMATION`，先让用户登录或补齐确认，不要创建 cron。
+只有 `prepare-run` 输出 `status: "READY"` 且 `cron_ready: true` 后，才继续调用 `schedule-run`。只有 `schedule-run` 输出 `status: "SCHEDULED"` 且带有 `schedule_id` 后，才算定时任务真的创建成功。不要让外部 AI harness 自己拼 `/tmp/*.log` shell cron 或未来对话提醒；那类 cron 容易丢失 JSON/file 参数并在到点后重新卡确认门禁。
 
 状态机：
 
 - `NEED_INPUT`
 - `NEED_CONFIRMATION`
 - `READY`（仅准备工具）
+- `SCHEDULED`（仅定时工具）
 - `COMPLETED`
 - `FAILED`
 
@@ -153,18 +158,16 @@ boss-recommend-mcp prepare-run --instruction-file boss-recommend-instruction.txt
 - 学校标签支持多选语义：如“985、211”会同时勾选这两项
 - 学校标签对“混合输入”按容错处理：如“985、211、qs100”会忽略无效项 `qs100`，保留并应用有效项；仅当全部无效或用户明确“不限”时才回落到“不限”
 - 学历支持单选与多选语义：如“本科及以上”会展开为 `本科/硕士/博士`；如“大专、本科”只勾选这两项
-- 执行前会逐项确认筛选参数：学校标签 / 学历 / 性别 / 是否过滤近14天已看
-- 页面就绪（已登录且在 recommend 页）后，会先提取岗位栏全部岗位并要求用户确认本次岗位；确认后先点击岗位，再执行 search/screen
-- 在真正开始 search/screen 前，会进行最后一轮全参数总确认（岗位 + 全部筛选参数 + criteria + target_count + post_action + max_greet_count）
+- 执行前会先补齐筛选值、岗位、后置动作和休息强度，然后只做一次总确认
+- 页面就绪（已登录且在 recommend 页）后，会先提取岗位栏全部岗位，使用精确岗位名填入 run payload，再进入总确认
+- 在真正开始 search/screen 或创建 cron 前，总确认需包含岗位、全部筛选参数、criteria、target_count、post_action、max_greet_count、restLevel 和定时信息（如适用）
 - npm 全局安装后会自动执行 install：生成 skill、导出 MCP 模板，并自动尝试写入已检测到的外部 agent MCP 配置（含 Trae / trae-cn / Cursor / Claude / OpenClaw）
 - 2.x installer 会迁移已存在的 legacy Boss MCP 配置：把 `boss-recommend` 指向统一 `@reconcrap/boss-recommend-mcp`，并从同一个 `mcp.json` 中移除旧 `boss-recruit-mcp` / standalone `boss-chat` / 本地 legacy Boss 路径；写入前会生成 `.boss-mcp-migration-*.bak` 备份
 - 2.x installer 会刷新外部 agent skills：`boss-recommend-pipeline`、`boss-recruit-pipeline`、`boss-chat` 都来自当前包，旧 recruit/chat skill 会被覆盖为统一 MCP 路由
 - npm / npx 安装后会自动初始化 `screening-config.json` 模板（优先写入 workspace 的 `config/`，不可写时回退到用户目录）
 - npm 安装流程会预创建运行目录（跨平台）：`~/.boss-recommend-mcp`、`~/.boss-recommend-mcp/runs`、`~/.boss-recommend-mcp/boss-chat` 及其 `logs/runs/profiles/reports/artifacts/state`
-- `post_action` 必须在每次完整运行开始时确认一次
-- `target_count` 会在每次运行开始时询问一次（可留空，不设上限）
-- 当 `post_action=greet` 时，必须在运行开始时确认 `max_greet_count`
-- 若检测到 `max_greet_count` 可能由 agent 自动默认（例如与 `target_count` 相同且原始指令未明确），会强制再次向用户确认
+- `post_action`、`target_count` 和 `max_greet_count`（当 `post_action=greet`）通过同一次总确认锁定
+- 新流程中 `confirmation.final_confirmed=true` 是总确认；旧版逐字段 `*_confirmed` JSON 仍兼容但不是推荐写法
 - 一旦确认 `post_action`，本次运行内所有通过人选都统一按该动作执行
 - 若达到 `max_greet_count` 但流程仍需继续，后续通过人选会自动改为收藏
 - 不会对每位候选人重复确认
@@ -269,6 +272,16 @@ npx -y @reconcrap/boss-recommend-mcp@latest run --detached --instruction-file bo
 
 `--detached` 会让父进程输出 `ACCEPTED + run_id` 后退出，子进程继续持有 Chrome DevTools 会话并执行长任务。岗位发现可以使用只读 CLI：
 
+如果是稍后启动/cron/定时任务，不要手写系统 cron；用 package-owned scheduler：
+
+```bash
+npx -y @reconcrap/boss-recommend-mcp@latest prepare-run --instruction-file boss-recommend-instruction.txt --overrides-file boss-recommend-overrides.json --confirmation-file boss-recommend-confirmation.json --slow-live --port 9222
+npx -y @reconcrap/boss-recommend-mcp@latest schedule-run --schedule-delay-minutes 10 --instruction-file boss-recommend-instruction.txt --overrides-file boss-recommend-overrides.json --confirmation-file boss-recommend-confirmation.json --slow-live --port 9222
+npx -y @reconcrap/boss-recommend-mcp@latest schedule-status --schedule-id <schedule_id>
+```
+
+`schedule-run` 会保存同一份已验证 payload 并启动 detached scheduler worker；到点后 worker 会直接调用包内 `start_recommend_pipeline_run`，不会重新让 AI harness 拼参数。
+
 ```bash
 npx -y @reconcrap/boss-recommend-mcp@latest list-jobs --slow-live --port 9222
 # 源码模式（GitHub clone 后）
@@ -463,6 +476,7 @@ Trae-CN / 长对话防循环建议：
 
 - `start_recommend_pipeline_run` 为异步入口，但不会跳过同步确认流程。
 - `prepare_recommend_pipeline_run` / `boss-recommend-mcp prepare-run` 用于 cron 设置阶段；它不启动筛选，只确认 payload 已经不需要到点后再问用户。
+- `schedule_recommend_pipeline_run` / `boss-recommend-mcp schedule-run` 是推荐页定时启动的唯一推荐路径；它创建真实 package-owned detached scheduler，并返回 `schedule_id`。
 - 定时心跳默认 120 秒一次；`updated_at` 仍会在阶段或进度变化时刷新。
 - 每个 run 会持久化到 `~/.boss-recommend-mcp/runs/<run_id>.json`（可通过 `BOSS_RECOMMEND_HOME` 覆盖）。
 - screen 阶段会持久化 checkpoint：`~/.boss-recommend-mcp/runs/<run_id>.checkpoint.json`。
@@ -476,27 +490,10 @@ Trae-CN / 长对话防循环建议：
 {
   "instruction": "推荐页筛选211女生，近14天没有，有 AI Agent 经验，符合标准的直接沟通",
   "confirmation": {
-    "filters_confirmed": true,
-    "school_tag_confirmed": true,
-    "school_tag_value": ["985", "211"],
-    "degree_confirmed": true,
-    "degree_value": ["本科", "硕士", "博士"],
-    "gender_confirmed": true,
-    "gender_value": "女",
-    "recent_not_view_confirmed": true,
-    "recent_not_view_value": "近14天没有",
-    "criteria_confirmed": true,
-    "target_count_confirmed": true,
-    "target_count_value": 20,
-    "post_action_confirmed": true,
-    "post_action_value": "greet",
-    "final_confirmed": true,
-    "job_confirmed": true,
-    "job_value": "算法工程师（视频/图像模型方向） _ 杭州",
-    "max_greet_count_confirmed": true,
-    "max_greet_count_value": 10
+    "final_confirmed": true
   },
   "overrides": {
+    "page_scope": "recommend",
     "school_tag": ["985", "211"],
     "degree": ["本科", "硕士", "博士"],
     "gender": "女",
@@ -507,18 +504,14 @@ Trae-CN / 长对话防循环建议：
     "post_action": "greet",
     "max_greet_count": 10
   },
-  "follow_up": {
-    "chat": {
-      "criteria": "继续在聊天页处理有 AI Agent 或 MCP 项目经验的人选",
-      "start_from": "unread",
-      "target_count": 20,
-      "profile": "default",
-      "safe_pacing": true
-    }
+  "human_behavior": {
+    "restLevel": "medium"
   }
 }
 ```
 
+`confirmation.final_confirmed=true` 表示用户已经看过并确认总览。旧版 `page_confirmed`、`school_tag_confirmed`、`job_confirmed` 等逐字段布尔值仍兼容，但新流程不需要主动生成它们。
+
 ## 测试
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",
@@ -79,11 +79,11 @@
     "live:chat-image-screening": "node scripts/live-chat-image-screening-smoke.js"
   },
   "files": [
-    "bin",
-    "config/screening-config.example.json",
-    "skills",
-    "scripts/install-macos.sh",
-    "scripts/postinstall.cjs",
+    "bin",
+    "config/screening-config.example.json",
+    "skills",
+    "scripts/install-macos.sh",
+    "scripts/postinstall.cjs",
     "src/core",
     "src/domains",
     "src/chat-mcp.js",
@@ -93,6 +93,7 @@
     "src/index.js",
     "src/parser.js",
     "src/recommend-mcp.js",
+    "src/recommend-scheduler.js",
     "src/recruit-mcp.js",
     "src/run-state.js",
     "README.md"

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

@@ -1,13 +1,13 @@
 ---
 name: "boss-recommend-pipeline"
-description: "Use when users want Boss recommend-page filtering/screening via boss-recommend-mcp. Confirm required params first, then run in two-stage confirmation with strict recommend routing."
+description: "Use when users want Boss recommend-page filtering/screening via boss-recommend-mcp. Gather required params, show one consolidated review, then run or schedule through the recommend MCP tools."
 ---
 
 # Boss Recommend Pipeline Skill
 
 ## Goal
 
-当用户要在 Boss 推荐页筛人时，必须走 `start_recommend_pipeline_run`，并按“两阶段确认 -> 页面就绪 -> 岗位确认 -> 最终确认 -> 执行”的顺序完成。2.0 CDP-only 路径不再支持 legacy recommend -> chat 自动衔接；若用户要聊天页筛选或求简历，必须在推荐页任务完成后显式改用 `boss-chat` 工具。
+当用户要在 Boss 推荐页筛人时，必须走 `start_recommend_pipeline_run`；若是稍后/cron 启动，必须走 `schedule_recommend_pipeline_run`。先补齐缺失值并读取岗位列表，然后展示一次包含岗位、筛选项、criteria、目标人数、后置动作、最大招呼数、休息强度和定时信息的总确认；用户确认后设置 `final_confirmed=true` 即可启动或创建定时任务。2.0 CDP-only 路径不再支持 legacy recommend -> chat 自动衔接；若用户要聊天页筛选或求简历，必须在推荐页任务完成后显式改用 `boss-chat` 工具。
 
 ## Hard Rules (Must Follow)
 
@@ -19,10 +19,11 @@ description: "Use when users want Boss recommend-page filtering/screening via bo
 
 - **确认不可代填（强制）**
   - 禁止 agent 自行“设置合理参数”并代替用户确认。
-  - 禁止在用户未明确回复前，把任意 `*_confirmed` 字段设为 `true`。
+  - 禁止在用户未明确回复前，把 `final_confirmed=true`。
+  - 旧版 `*_confirmed` 字段仍兼容，但新流程不要逐项设置；把规范化后的值写入 `overrides`，总确认后只需要 `confirmation.final_confirmed=true`。
   - 禁止在用户未明确回复前，自行填充 `page_scope/school_tag/degree/gender/recent_not_view/criteria/target_count/post_action/max_greet_count/job/rest_level`。
   - 每次 run 必须明确询问用户本次休息强度 `rest_level`：`low`（旧策略）/ `medium`（约 5 小时或 700 人累计休息 30 分钟）/ `high`（约 5 小时或 700 人累计休息 1 小时）；不得默认使用配置文件里的值替用户决定。
-  - 若工具返回 `pending_questions`，必须逐项向用户提问并等待用户回复；不得跳过提问直接执行。
+  - 若工具返回 `pending_questions`，只追问这些缺口；若只返回 `final_review`，不要再拆成逐字段确认。
 
 - **岗位确认时机**
   - 页面未就绪前，禁止询问 `job`。
@@ -30,7 +31,7 @@ description: "Use when users want Boss recommend-page filtering/screening via bo
 
 - **参数确认**
   - `criteria` 必须是用户开放式自然语言；禁止“严格/宽松执行”等预设替代。
-  - `post_action=greet` 时，必须确认 `max_greet_count`；禁止自动默认为 `target_count`。
+  - `post_action=greet` 时，`max_greet_count` 必须出现在总确认里；禁止未告知用户就自动默认为 `target_count`。
   - 正式执行前必须 `final_confirmed=true`。
   - 真实筛选禁止传 `detail_limit: 0`；recommend 默认必须打开候选人详情/CV。只有用户明确要求“卡片-only 调试”时，才允许同时传 `detail_limit: 0` 和 `allow_card_only_screening: true`。
 
@@ -40,29 +41,29 @@ description: "Use when users want Boss recommend-page filtering/screening via bo
   - 最终执行前逐字回显将提交的 `instruction`；若与锁定值不一致，先修正再执行。
   - 禁止在中途把用户意图拆成“recommend 已默认确认 + chat 单独执行”两条链路。
 
-## Two-Stage Confirmation
+## Single Review Confirmation
 
-### Stage A (页面就绪前，禁止问岗位)
-
-必须确认：
+先收集这些值：
 
 - `page_scope`：`recommend|latest|featured`
-- `school_tag`（多选）
-- `degree`（多选）
-- `gender`
-- `recent_not_view`
+- `school_tag`、`degree`、`gender`、`recent_not_view`
 - `criteria`（开放文本）
 - `target_count`（可空）
 - `post_action`：`favorite|greet|none`
 - `max_greet_count`（仅当 `post_action=greet`）
 - `rest_level`：`low|medium|high`
+- `job`（来自 `list_recommend_jobs` / `job_options` 的精确岗位名）
+- cron/定时任务的启动时间（如适用）
 
-### Stage B (页面就绪后)
+然后只做一次总确认。用户回复“确认 / 全部确认 / 无需调整”后，下一次工具调用写入：
 
-必须确认：
+```json
+{
+  "confirmation": { "final_confirmed": true }
+}
+```
 
-- `job`（来自 `job_options`，必须全量展示）
-- `final_review`（岗位 + 全参数总确认）
+已确认值放在 `overrides` 和 `human_behavior.restLevel`。不要因为工具返回 `final_review` 就再问页面、学历、学校、性别、14天、criteria、目标人数、动作、最大招呼数等逐项确认。
 
 ## Chat Handoff
 
@@ -94,12 +95,18 @@ description: "Use when users want Boss recommend-page filtering/screening via bo
   - 限制：只读岗位列表，不启动筛选任务；若返回 `BOSS_LOGIN_REQUIRED`，必须让用户在自动打开的 Chrome 完成登录后重试，本次 cron 不得创建。
 - Cron 准备工具：`prepare_recommend_pipeline_run`
   - 用途：只校验参数是否已可用于 cron / 一次性任务，不启动筛选任务。
-  - 要求：只有返回 `status=READY` 且 `cron_ready=true` 后，才允许创建 cron。
+  - 要求：只有返回 `status=READY` 且 `cron_ready=true` 后，才允许继续创建定时任务。
   - 若返回 `NEED_INPUT` / `NEED_CONFIRMATION` / `FAILED`：继续补齐 `pending_questions` 或修复登录/页面/config；不得先创建 cron。
+- Cron 创建工具：`schedule_recommend_pipeline_run`
+  - 用途：保存已经 READY 的完整 payload，并启动 package-owned detached scheduler；到点后由包内 worker 直接调用 `start_recommend_pipeline_run`。
+  - 必填：同 `start_recommend_pipeline_run` 的完整 payload，另加 `schedule_delay_minutes` / `schedule_delay_seconds` / `schedule_run_at` 之一。
+  - 成功标准：必须返回 `status=SCHEDULED`、`schedule_created=true`、`schedule_id`、`run_at`。只有这个返回后，才可以告诉用户定时任务已创建。
+- Cron 查询工具：`get_recommend_scheduled_run`
+  - 用途：用户问“任务是否启动/进度”时，先查 `schedule_id`。若到点后已启动，会返回内层 `run_id` 和 run 快照。
 - 主工具：`start_recommend_pipeline_run`
 - 必填：`instruction`
 - 关键输入：
-  - `confirmation`：`page_confirmed/page_value/filters_confirmed/school_tag_confirmed.../job_confirmed/job_value/final_confirmed`
+  - `confirmation`：新流程只需要 `{ "final_confirmed": true }`；旧版 `page_confirmed/page_value/.../job_confirmed/job_value` 仍兼容但不要主动制造逐项确认。
   - `overrides`：`page_scope/school_tag/degree/gender/recent_not_view/criteria/job/target_count/post_action/max_greet_count`
   - `human_behavior`：必须包含本次用户确认的 `restLevel`（例如 `{ "restLevel": "medium" }`）
   - 不要传 `follow_up.chat`；该路径属于 legacy-only 行为
@@ -116,19 +123,33 @@ description: "Use when users want Boss recommend-page filtering/screening via bo
 创建 cron 时必须在设置 cron 的当下完成全部交互：
 
 1. 锁定用户原始 instruction，不改写、不摘要，criteria 放入 `overrides.criteria` 时必须逐字保留。
-2. 收集 Stage A 全部筛选项、`target_count`、`post_action`、`max_greet_count`（如需要）和本次 `rest_level`。
+2. 收集全部筛选项、`target_count`、`post_action`、`max_greet_count`（如需要）和本次 `rest_level`。
 3. 调用 `list_recommend_jobs`；若 Chrome 未打开，工具会尝试自动打开本机 9222 Chrome 并进入推荐页。若返回 `BOSS_LOGIN_REQUIRED` 或页面不可用，停止 cron 创建，让用户登录/修复后重试。
-4. 用 `job_names` 中的精确岗位名完成岗位确认，并完成最终总确认，写入 `job_confirmed=true` 与 `final_confirmed=true`。
-5. 调用 `prepare_recommend_pipeline_run` 传入将来要执行的完整 payload；只有 `READY + cron_ready=true` 才能创建 cron。
-6. cron 到点时只调用 `start_recommend_pipeline_run`，并传入准备阶段验证过的同一份 payload。到点后若 Chrome/登录异常，应作为运行失败处理，不得再向用户追问参数。
+4. 用 `job_names` 中的精确岗位名填入 `overrides.job`，展示包含启动时间的最终总确认；用户确认后写入 `final_confirmed=true`。
+5. 调用 `prepare_recommend_pipeline_run` 传入将来要执行的完整 payload；只有 `READY + cron_ready=true` 才能继续。
+6. 立即调用 `schedule_recommend_pipeline_run`，传入同一份完整 payload 和 `schedule_delay_minutes` / `schedule_run_at`。禁止让 OpenClaw 自己写 `/tmp/*.log` shell cron、自然语言提醒、或未来对话回调来代替此工具。
+7. 只有拿到 `SCHEDULED + schedule_id` 后才告诉用户定时任务已创建。回复必须包含 `schedule_id`，而不是只说“10 分钟后会启动”。
+8. 到点后由 package-owned detached scheduler 启动；若 Chrome/登录异常，应作为 schedule/run 失败处理，不得再向用户追问参数。
 
-Shell-only OpenClaw/QClaw cron 设置同样先运行：
+Shell-only OpenClaw/QClaw cron 设置同样先运行 prepare：
 
 ```powershell
 npx -y @reconcrap/boss-recommend-mcp@latest prepare-run --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --slow-live --port 9222
 ```
 
-仅当上述命令输出 `READY` 且 `cron_ready=true` 后，才把对应的 detached `run` 命令写入 cron。
+仅当上述命令输出 `READY` 且 `cron_ready=true` 后，才允许继续创建定时任务。
+
+然后必须用 package-owned scheduler 创建定时任务，不要手写系统 cron：
+
+```powershell
+npx -y @reconcrap/boss-recommend-mcp@latest schedule-run --schedule-delay-minutes 10 --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --slow-live --port 9222
+```
+
+用户查询时：
+
+```powershell
+npx -y @reconcrap/boss-recommend-mcp@latest schedule-status --schedule-id <schedule_id>
+```
 
 ## Async Run Policy
 
@@ -172,15 +193,16 @@ npx -y @reconcrap/boss-recommend-mcp@latest prepare-run --instruction-file .\bos
 
 推荐做法：
 
-1. 将锁定的用户原文写入 instruction 文件，将已确认参数写入 `overrides` 与 `confirmation` JSON 文件。
-2. 先用 `prepare-run` 校验完整 payload 已 cron-ready；未返回 `READY + cron_ready=true` 不得创建 cron 或启动 run。
-3. 用 detached CLI 启动，让父命令返回启动证据，子进程继续持有 CDP 会话：
+1. 将锁定的用户原文写入 instruction 文件，将已确认参数写入 `overrides` JSON；`confirmation` JSON 只需要 `{ "final_confirmed": true }`。
+2. 先用 `prepare-run` 校验完整 payload 已 cron-ready；未返回 `READY + cron_ready=true` 不得创建定时任务或启动 run。
+3. 若用户要“现在启动”，用 detached CLI 启动，让父命令返回启动证据，子进程继续持有 CDP 会话：
 
 ```powershell
 npx -y @reconcrap/boss-recommend-mcp@latest run --detached --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --slow-live --port 9222
 ```
 
-4. 若返回 `ACCEPTED + run_id`，即任务已启动；记录 `run_id/stdout_path/stderr_path`。若返回 `NEED_INPUT` 或 `NEED_CONFIRMATION`，说明 cron 设置阶段漏掉了准备门禁，应回到 `prepare-run` 补齐，不能在到点后继续问用户确认。
+4. 若用户要“稍后/cron/定时启动”，用 `schedule-run`，不是 `run --detached`。若 `schedule-run` 未返回 `SCHEDULED + schedule_id`，不得告诉用户定时任务已创建。
+5. 若即时 `run --detached` 返回 `ACCEPTED + run_id`，即任务已启动；记录 `run_id/stdout_path/stderr_path`。若返回 `NEED_INPUT` 或 `NEED_CONFIRMATION`，说明设置阶段漏掉了准备门禁，应回到 `prepare-run` 补齐，不能在到点后继续问用户确认。
 
 兼容路径：
 
@@ -199,8 +221,8 @@ npx -y @reconcrap/boss-recommend-mcp@latest run --detached --instruction-file .\
 ## Response Style
 
 - 用结构化中文。
-- 第一轮确认卡片不出现 `job`。
-- 仅在 `job_options` 出现后给岗位确认卡片，且岗位选项必须全量。
+- 未读取岗位列表前不要要求用户最终确认。
+- 仅在 `job_options` 出现后选择精确岗位；最终确认卡片必须包含岗位和全部参数。
 - 封闭式问题必须带完整标签选项；开放式问题（如 `criteria`）保持自由输入。
 - 页面就绪失败提示必须包含 `debug_port`、recommend URL、以及登录 URL（若未登录）：
   - `https://www.zhipin.com/web/chat/recommend`

package/src/cli.js

@@ -28,6 +28,10 @@ import {
   prepareRecommendPipelineRunTool,
   startRecommendPipelineRunTool
 } from "./recommend-mcp.js";
+import {
+  getRecommendScheduledRunTool,
+  scheduleRecommendPipelineRunTool
+} from "./recommend-scheduler.js";
 import {
   getBossScreenConfigResolution,
   resolveBossChatRuntimeLayout as resolveCdpBossChatRuntimeLayout,
@@ -2694,6 +2698,8 @@ function printHelp() {
   console.log("  boss-recommend-mcp              Start the MCP server");
   console.log("  boss-recommend-mcp start        Start the MCP server");
   console.log("  boss-recommend-mcp prepare-run  Validate a cron-ready recommend run payload without starting screening");
+  console.log("  boss-recommend-mcp schedule-run Create a package-owned delayed recommend run");
+  console.log("  boss-recommend-mcp schedule-status Check a package-owned delayed recommend run");
   console.log("  boss-recommend-mcp run          Start a CDP-only recommend run through the shared run service");
   console.log("  boss-recommend-mcp list-jobs    CDP-only list of exact recommend job names for cron/one-shot inputs");
   console.log("  boss-recommend-mcp chat <subcommand>  Run CDP-only boss-chat health/prepare/status commands");
@@ -2711,6 +2717,8 @@ function printHelp() {
   console.log("");
   console.log("Run command:");
   console.log("  boss-recommend-mcp prepare-run --instruction \"...\" --overrides-file overrides.json --confirmation-file confirmation.json");
+  console.log("  boss-recommend-mcp schedule-run --schedule-delay-minutes 10 --instruction-file boss-recommend-instruction.txt --overrides-file overrides.json --confirmation-file confirmation.json");
+  console.log("  boss-recommend-mcp schedule-status --schedule-id <id>");
   console.log("  boss-recommend-mcp run --instruction \"推荐页上筛选211男生，近14天没有，有大模型平台经验\" --overrides-file overrides.json --confirmation-file confirmation.json");
   console.log("  boss-recommend-mcp run --detached --instruction \"...\" --overrides-file overrides.json --confirmation-file confirmation.json");
   console.log("  boss-recommend-mcp list-jobs --slow-live --port 9222");
@@ -2907,6 +2915,62 @@ async function preparePipelineOnce(options = {}) {
   }
 }
 
+function addScheduleOptions(args, options = {}) {
+  const scheduleId = String(options["schedule-id"] || options.schedule_id || options.scheduleId || "").trim();
+  if (scheduleId) args.schedule_id = scheduleId;
+  const runAt = String(options["schedule-run-at"] || options.schedule_run_at || options.scheduleRunAt || options["run-at"] || options.run_at || "").trim();
+  if (runAt) args.schedule_run_at = runAt;
+  const delayMinutes = parseNonNegativeInteger(options["schedule-delay-minutes"] ?? options.schedule_delay_minutes ?? options.scheduleDelayMinutes);
+  if (delayMinutes !== undefined) args.schedule_delay_minutes = delayMinutes;
+  const delaySeconds = parseNonNegativeInteger(options["schedule-delay-seconds"] ?? options.schedule_delay_seconds ?? options.scheduleDelaySeconds);
+  if (delaySeconds !== undefined) args.schedule_delay_seconds = delaySeconds;
+  return args;
+}
+
+async function schedulePipelineOnce(options = {}) {
+  const workspaceRoot = getWorkspaceRoot(options);
+  const { args, port } = buildRecommendRunCliInput(options);
+  addScheduleOptions(args, options);
+  const result = await scheduleRecommendPipelineRunTool({
+    workspaceRoot,
+    args
+  });
+  printJson({
+    ...result,
+    cli: {
+      ...(result.cli || {}),
+      command: "schedule-run",
+      cdp_only: true,
+      package_owned_scheduler: true,
+      workspace_root: workspaceRoot,
+      port
+    }
+  });
+  if (result.status !== "SCHEDULED") {
+    process.exitCode = 1;
+  }
+}
+
+function scheduleStatusCli(options = {}) {
+  const scheduleId = String(options["schedule-id"] || options.schedule_id || options.scheduleId || "").trim();
+  const result = getRecommendScheduledRunTool({
+    args: {
+      schedule_id: scheduleId
+    }
+  });
+  printJson({
+    ...result,
+    cli: {
+      command: "schedule-status",
+      cdp_only: true,
+      package_owned_scheduler: true
+    }
+  });
+  if (result.status !== "OK") {
+    process.exitCode = 1;
+  }
+}
+
 async function runPipelineOnce(options = {}) {
   const workspaceRoot = getWorkspaceRoot(options);
   const { args, port } = buildRecommendRunCliInput(options);
@@ -3120,6 +3184,39 @@ export async function runCli(argv = process.argv) {
         process.exitCode = 1;
       }
       break;
+    case "schedule-run":
+    case "schedule":
+      try {
+        await schedulePipelineOnce(options);
+      } catch (error) {
+        printJson({
+          status: "FAILED",
+          schedule_created: false,
+          error: {
+            code: "INVALID_CLI_INPUT",
+            message: error.message || "Invalid CLI input",
+            retryable: false
+          }
+        });
+        process.exitCode = 1;
+      }
+      break;
+    case "schedule-status":
+    case "scheduled-run":
+      try {
+        scheduleStatusCli(options);
+      } catch (error) {
+        printJson({
+          status: "FAILED",
+          error: {
+            code: "INVALID_CLI_INPUT",
+            message: error.message || "Invalid CLI input",
+            retryable: false
+          }
+        });
+        process.exitCode = 1;
+      }
+      break;
     case "list-jobs":
     case "jobs":
     case "recommend-jobs":
@@ -3282,6 +3379,8 @@ export const __testables = {
   resolveBossChatRuntimeLayout: resolveCdpBossChatRuntimeLayout,
   runBossChatCliCommand,
   preparePipelineOnce,
+  schedulePipelineOnce,
+  scheduleStatusCli,
   runPipelineOnce
 };
 

package/src/index.js

@@ -39,6 +39,12 @@ import {
   startRecruitPipelineRunTool,
   validateRecruitPipelineArgs
 } from "./recruit-mcp.js";
+import {
+  __setRecommendSchedulerSpawnForTests,
+  getRecommendScheduledRunTool,
+  runScheduledRecommendWorker,
+  scheduleRecommendPipelineRunTool
+} from "./recommend-scheduler.js";
 import {
   __resetRecommendMcpStateForTests,
   __setRecommendMcpConnectorForTests,
@@ -90,6 +96,8 @@ const require = createRequire(import.meta.url);
 const { version: SERVER_VERSION } = require("../package.json");
 
 const TOOL_PREPARE_RUN = "prepare_recommend_pipeline_run";
+const TOOL_SCHEDULE_RUN = "schedule_recommend_pipeline_run";
+const TOOL_GET_SCHEDULED_RUN = "get_recommend_scheduled_run";
 const TOOL_START_RUN = "start_recommend_pipeline_run";
 const TOOL_GET_RUN = "get_recommend_pipeline_run";
 const TOOL_CANCEL_RUN = "cancel_recommend_pipeline_run";
@@ -512,6 +520,7 @@ function createRunInputSchema() {
       },
       confirmation: {
         type: "object",
+        description: "推荐页确认状态。新流程推荐只在用户看过总览后传 final_confirmed=true；逐字段 *_confirmed 为兼容旧调用保留。",
         properties: {
           page_confirmed: { type: "boolean" },
           page_value: {
@@ -576,7 +585,10 @@ function createRunInputSchema() {
             type: "string",
             enum: ["favorite", "greet", "none"]
           },
-          final_confirmed: { type: "boolean" },
+          final_confirmed: {
+            type: "boolean",
+            description: "用户已确认包含岗位、筛选项、criteria、目标、动作、最大招呼数和 restLevel 的总览。"
+          },
           job_confirmed: { type: "boolean" },
           job_value: { type: "string" },
           max_greet_count_confirmed: { type: "boolean" },
@@ -706,8 +718,8 @@ function createRunInputSchema() {
         type: "boolean",
         description: "可选，VPN/慢页面 live 测试模式，放宽等待时间"
       },
-      human_behavior: createHumanBehaviorInputSchema("可选，recommend 可靠性实验用节奏配置；默认 paced_with_rests/on"),
-      humanBehavior: createHumanBehaviorInputSchema("兼容字段；优先使用 human_behavior"),
+      human_behavior: createHumanBehaviorInputSchema("recommend 运行必须显式包含本次用户确认的 restLevel: low|medium|high；其他节奏配置可选"),
+      humanBehavior: createHumanBehaviorInputSchema("兼容字段；优先使用 human_behavior；recommend 运行同样必须显式包含 restLevel"),
       human_behavior_enabled: {
         type: "boolean",
         description: "兼容字段；true 等同启用 paced 默认配置，false 等同 baseline"
@@ -1083,6 +1095,36 @@ function createListRecommendJobsInputSchema() {
   };
 }
 
+function createScheduleRunInputSchema() {
+  const base = createRunInputSchema();
+  return {
+    ...base,
+    properties: {
+      ...base.properties,
+      schedule_id: {
+        type: "string",
+        description: "可选，自定义定时任务 id；默认自动生成"
+      },
+      schedule_run_at: {
+        type: "string",
+        description: "ISO 时间字符串；到点后由 package-owned detached scheduler 启动已准备好的 payload"
+      },
+      schedule_delay_minutes: {
+        type: "number",
+        minimum: 0,
+        description: "从现在开始延迟多少分钟后启动；适合 OpenClaw cron/定时任务设置"
+      },
+      schedule_delay_seconds: {
+        type: "number",
+        minimum: 0,
+        description: "从现在开始延迟多少秒后启动；主要用于短延迟或测试"
+      }
+    },
+    required: ["instruction"],
+    additionalProperties: false
+  };
+}
+
 function createToolsSchema() {
   return [
     {
@@ -1095,6 +1137,23 @@ function createToolsSchema() {
       description: "只校验 Boss 推荐页流水线参数是否已可用于 cron/一次性任务；不会启动筛选任务。只有返回 READY/cron_ready=true 后才应创建定时任务。",
       inputSchema: createRunInputSchema()
     },
+    {
+      name: TOOL_SCHEDULE_RUN,
+      description: "创建 package-owned Boss 推荐页定时任务：先校验 READY/cron_ready，再保存完整 payload，并由 detached scheduler 到点直接启动，不再依赖 AI harness 自己拼 shell cron。",
+      inputSchema: createScheduleRunInputSchema()
+    },
+    {
+      name: TOOL_GET_SCHEDULED_RUN,
+      description: "查询 package-owned 推荐页定时任务状态；返回 schedule_id、worker 状态、到点后启动的 run_id 与运行快照。",
+      inputSchema: {
+        type: "object",
+        properties: {
+          schedule_id: { type: "string" }
+        },
+        required: ["schedule_id"],
+        additionalProperties: false
+      }
+    },
     {
       name: TOOL_START_RUN,
       description: "异步启动 Boss 推荐页流水线（含同步门禁预检）；只有在前置确认与页面就绪通过后才返回 run_id。",
@@ -2626,6 +2685,10 @@ async function handleRequest(message, workspaceRoot) {
         payload = await listRecommendJobsTool({ workspaceRoot, args });
       } else if (toolName === TOOL_PREPARE_RUN) {
         payload = prepareRecommendPipelineRunTool({ workspaceRoot, args });
+      } else if (toolName === TOOL_SCHEDULE_RUN) {
+        payload = await scheduleRecommendPipelineRunTool({ workspaceRoot, args });
+      } else if (toolName === TOOL_GET_SCHEDULED_RUN) {
+        payload = getRecommendScheduledRunTool({ args });
       } else if (toolName === TOOL_START_RUN) {
         payload = await handleStartRunTool({ workspaceRoot, args });
       } else if (toolName === TOOL_GET_RUN) {
@@ -2825,6 +2888,12 @@ export const __testables = {
   resetRecommendMcpStateForTests() {
     __resetRecommendMcpStateForTests();
   },
+  setRecommendSchedulerSpawnForTests(nextImpl) {
+    __setRecommendSchedulerSpawnForTests(nextImpl);
+  },
+  runScheduledRecommendWorkerForTests(options = {}) {
+    return runScheduledRecommendWorker(options);
+  },
   setChatMcpConnectorForTests(nextImpl) {
     forceChatInProcForTests = typeof nextImpl === "function";
     __setChatMcpConnectorForTests(nextImpl);