@yixinkj/priority-buyer-alert-cli 0.1.11 → 0.1.13

package/index.js

@@ -129,6 +129,7 @@ function printHelp() {
   ${SKILL_ID} --skill-path <SKILL.md> --poll-run <RUN_ID>
   ${SKILL_ID} --skill-path <SKILL.md> --run-status <RUN_ID>
   ${SKILL_ID} --skill-path <SKILL.md> --cancel-run <RUN_ID>
+  ${SKILL_ID} --skill-path <SKILL.md> --first-response-scan [--since 24] [--limit 100]
 
 通用：
   --skill-path <PATH>       本次实际读取的 SKILL.md 绝对路径
@@ -146,6 +147,10 @@ function printHelp() {
   --verify-all-replied      对全部已回复的重点买家做详情核验
   --mark                    推进提醒水位；只有心跳式调用才应使用
 
+首响扫描选项（仅与 --first-response-scan 一起使用）：
+  --since <HOURS>           只看最近 N 小时内有消息的询盘，默认 24
+  --limit <N>               本轮最多核验多少条会话详情，默认 100
+
 环境变量：
   PRIORITY_BUYER_ALERT_DETAIL_CONCURRENCY   详情核验并发度，默认 3，范围 1-8
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yixinkj/priority-buyer-alert-cli",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "重点买家未回复预警独立启动器，只读扫描询盘并提醒，不发送任何消息。",
   "type": "module",
   "bin": {

package/skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: 哨兵预警-0812
 description: 重点买家未回复预警。只读扫描阿里国际站询盘列表，挑出 L2 及以上（出口通店铺为 L1+）的重点买家，判断买家最后一句是否超过 SLA 仍没有真人业务员回复，并输出中文预警清单；机器人自动接待不算人工回复。Use when 用户要求检查重点买家有没有超时未回复、查询盘超时提醒、看 L3/L4 有没有快凉的，或要求运行重点买家预警。
-version: "0.1.11"
+version: "0.1.13"
 ---
 
 # 重点买家预警
@@ -19,14 +19,14 @@ version: "0.1.11"
 ## 运行入口
 
 ```bash
-npx -y @yixinkj/priority-buyer-alert-cli@latest \
+npx -y @yixinkj/priority-buyer-alert-cli@beta \
   --skill-path "本次实际读取的 SKILL.md 绝对路径" \
   --start
 ```
 
 启动成功后立即记录返回的 `run_id`，此后只用同一个 `run_id` 轮询，不要再次执行 `--start`。
 
-常用参数（都只能与 `--start` 一起使用）：
+预警扫描参数（与 `--start` 一起使用）：
 
 - `--minutes 30`：SLA，超过多少分钟没有人工回复算超时。默认 30，严格大于才触发。
 - `--lookback-hours 24`：只看最近多少小时内有过消息的询盘。默认 24。询盘列表按最近联系时间倒序，因此翻到某页最旧一行早于窗口就可以安全停止，心跳通常只读一页。传 0 表示不按时间停止翻页。
@@ -59,7 +59,7 @@ npx -y @yixinkj/priority-buyer-alert-cli@latest \
 按返回的 `poll_after_seconds` 静默轮询，不逐条播报进度：
 
 ```bash
-npx -y @yixinkj/priority-buyer-alert-cli@latest \
+npx -y @yixinkj/priority-buyer-alert-cli@beta \
   --skill-path "本次实际读取的 SKILL.md 绝对路径" \
   --poll-run "run_id"
 ```
@@ -82,6 +82,45 @@ npx -y @yixinkj/priority-buyer-alert-cli@latest \
 - 「盲区大小」那一条是当前等级口径没有覆盖的等待买家数量。如实转述，但不要据此自行把它们当作预警冒泡。
 - 不输出原始 JSON、绝对路径、买家邮箱电话或任何 token。
 
+## 首响待办扫描
+
+这是与预警**完全独立**的另一种用法：找出窗口内**从来没被真人回复过**的询盘，供新询盘首响
+Skill 起草第一次回复。
+
+```bash
+npx -y @yixinkj/priority-buyer-alert-cli@beta \
+  --skill-path "本次实际读取的 SKILL.md 绝对路径" \
+  --first-response-scan --since 24
+```
+
+同样返回 `run_id`，用同一条 `--poll-run` 轮询到 `completed`，然后读 `artifacts.first_response`
+（JSON Lines，每行一条）和 `artifacts.digest`（中文清单）。
+
+- `--since 24`：窗口小时数，默认 24。「早上清夜里积压」用 12–24 即可。
+- `--limit 100`：本轮最多取多少条会话详情，默认 100。超出的如实记为未判定，不猜。
+
+与预警的区别，不要混用：
+
+| | 预警 | 首响扫描 |
+| --- | --- | --- |
+| 语义 | 事件流，冒泡一次就被水位压住 | 待办清单，可重复拉取、结果一致 |
+| 等级白名单 | 生效，缺等级不冒泡 | **不生效**，等级只作附加信息输出 |
+| 回复时限 | 生效，超过 SLA 才成立 | **不生效**，越快回越好 |
+| 提醒水位 | `--mark` 会推进 | **永不推进**，传了也不生效 |
+
+每条记录的 `first_response_pending` 是三态：
+
+- `yes` 首响待办：整条会话里我方一条真人消息都没发过。
+- `no` 后续待办：我方至少发过一条真人消息。
+- `unknown` 本轮没取到详情，无法判定。
+
+**`unknown` 不等于 `yes`。** 没取到详情就是不知道，不要当作待办转给首响 Skill —— 那会让它
+对一条其实已经回过的会话生成「第一次回复」。数据提醒里会写明有多少条未判定、其中多少条是
+末条为我方发出（列表接口区分不了真人回复和机器人自动接待，这批里可能藏着真正的首响待办）。
+
+看到 `yes` 可以转去新询盘首响 Skill 起草第一次回复；`no` 暂不处理。本 Skill 只输出只读元
+数据，不解析询盘卡片或 RFQ 内容，也不调用其他 Skill。
+
 ## 定时与推送
 
 本 Skill 不自建定时任务，也不自己发消息到任何群。无人值守时由你按固定间隔（建议取 SLA 的三分之一到二分之一，例如 SLA 30 分钟就每 10–15 分钟一次）执行下面这条心跳命令：
@@ -93,7 +132,7 @@ npx -y @yixinkj/priority-buyer-alert-cli@latest \
 ```
 
 ```bash
-npx -y @yixinkj/priority-buyer-alert-cli@latest \
+npx -y @yixinkj/priority-buyer-alert-cli@beta \
   --skill-path "本次实际读取的 SKILL.md 绝对路径" \
   --start --minutes 30 --re-alert 30 --mark
 ```

package/skills.json

@@ -1,5 +1,5 @@
 {
-  "runtimeVersion": "0.1.4",
+  "runtimeVersion": "0.1.6",
   "platforms": {
     "darwin-arm64": {
       "id": "mac-arm64",
@@ -24,7 +24,7 @@
   "skill": {
     "name": "哨兵预警-0812",
     "id": "priority-buyer-alert",
-    "version": "0.1.11",
+    "version": "0.1.13",
     "bin": "priority-buyer-alert-cli"
   }
 }