@yixinkj/priority-buyer-alert-cli 0.1.10 → 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 绝对路径
@@ -139,13 +140,17 @@ function printHelp() {
   --minutes <N>             回复时限（SLA），默认 30
   --lookback-hours <N>      只看最近 N 小时内有过消息的询盘，默认 24；0 表示不限
   --max-pages <N>           翻页上限，每页 100 条，默认 3
-  --levels <LEVELS>         重点买家等级白名单，默认 L1+,L2,L3,L4,L5,L6
+  --levels <LEVELS>         重点买家等级白名单，默认 L1+,L2,L3,L4  (阿里等级 L0-L4，L4 封顶)
   --re-alert <N>            升级重提间隔；不给则只提醒一次
   --assignee <NAME>         只看某个负责人
   --no-strict-bot           关闭机器人核验
   --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.10",
+  "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.10"
+version: "0.1.13"
 ---
 
 # 重点买家预警
@@ -19,19 +19,19 @@ version: "0.1.10"
 ## 运行入口
 
 ```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 表示不按时间停止翻页。
 - `--max-pages 3`：翻页上限，每页 100 条，给忙店铺兜底。
-- `--levels "L2,L3,L4"`：收紧重点等级。不传时默认 `L1+,L2,L3,L4,L5,L6`，即「等级存在且高于 L1」，金品店铺和出口通店铺都适用。
+- `--levels "L3,L4"`：收紧重点等级。不传时默认 `L1+,L2,L3,L4`，即「等级存在且高于 L1」，金品店铺和出口通店铺都适用。
 - `--assignee "业务员名"`：只看某个负责人。
 - `--re-alert 30`：仍未回复时每隔多少分钟升级重提。不传表示同一轮等待只提醒一次。
 - `--mark`：推进提醒水位与升级计数。只有无人值守的心跳式调用才使用；人工查看不要带。
@@ -39,16 +39,27 @@ npx -y @yixinkj/priority-buyer-alert-cli@latest \
 
 ### 关于买家等级
 
-- 金品店铺可以看到真实档 L1–L6。
+阿里国际站买家等级共 **L0–L4 五档，L4 封顶**，不存在 L5、L6：
+
+| 等级 | 名称 | 判定 |
+| --- | --- | --- |
+| L0 | 注册买家 | 仅完成平台注册，无身份标识 |
+| L1 | 潜力买家 | 填了基础公司信息，或近 365 天消费满 50 美金 |
+| L2 | 小 B 买家 | 近 365 天消费达 300 美金，或已认证但年营业额低于 50 万美金 |
+| L3 | 企业买家 | 企业认证且年营业额超 50 万美金，或近 365 天消费 1 万美金 / 单笔超 5000 美金 |
+| L4 | 百万买家 | 企业认证且年营业额超 100 万美金，或近 365 天消费达 30 万美金（俗称金标买家） |
+
+- 金品店铺可以看到真实档。
 - 出口通店铺被阿里统一脱敏，L1 以上一律显示为整体值 `L1+`，采集端无法还原真实档。
-- 默认白名单同时包含 `L1+` 和 L2–L6，因此不需要先判断店铺套餐。显式传 `--levels` 时按值精确匹配，`L1+` 必须原样带引号传入。
+- 默认白名单是 `L1+,L2,L3,L4`，即「等级存在且高于 L1」，因此不需要先判断店铺套餐。显式传 `--levels` 时按值精确匹配，`L1+` 必须原样带引号传入。
+- 转述预警时可以点出等级含义（例如 L4 是最高档的百万买家），帮助业务员判断优先级；但不要自行推断买家的营业额或消费额。
 
 ## 轮询
 
 按返回的 `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"
 ```
@@ -71,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 分钟一次）执行下面这条心跳命令：
@@ -82,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.3",
+  "runtimeVersion": "0.1.6",
   "platforms": {
     "darwin-arm64": {
       "id": "mac-arm64",
@@ -24,7 +24,7 @@
   "skill": {
     "name": "哨兵预警-0812",
     "id": "priority-buyer-alert",
-    "version": "0.1.10",
+    "version": "0.1.13",
     "bin": "priority-buyer-alert-cli"
   }
 }