快递物流查询 Skill#

目标#

根据用户提供的快递单号，查询物流轨迹，识别承运商，判断物流状态，识别异常，并给出建议。

使用场景#

用户说帮我查一下快递 用户说快递到哪了 用户说物流怎么还没更新

---

执行流程#

第一步：识别承运商#

运行 scripts/identify.py 识别快递公司 或使用正则匹配，详见 references/carriers.md

第二步：查询物流#

推荐路径按优先级：

第一选择是快递100聚合查询，打开浏览器访问 https://www.kuaidi100.com 输入单号查询

第二选择是官网查询，直接访问对应快递公司官网

第三选择是浏览器自动化，如果以上都失败，用 browser 工具打开查询页面

第三步：解析轨迹#

从查询结果网页中提取以下信息：

第一步是找到物流轨迹区域，通常在页面中间位置

第二步是提取时间，格式为 YYYY.MM.DD HH:MM

第三步是提取地点和状态，描述中包含地点和状态信息

第四步是按时间倒序排列，最新的在前

第四步：异常判断#

根据以下规则判断异常情况：

停滞规则是最新一条轨迹距离今天超过3天

滞留规则是轨迹中出现同一站点重复超过2次

派送异常规则是状态包含派送中且超过2天

签收未收到规则是状态显示已签收但用户说没收到

退件规则是状态包含退件、退回、拒收

第五步：生成回复#

按以下结构输出：

第一行是快递公司和单号，用中文冒号分隔

第二行是状态，运输中或派送中或已签收

第三行是最新轨迹，时间地点状态用空格分隔

第四部分是物流时间线，用数字编号，每条一行

第五部分是异常判断，有问题时写具体问题，没问题时写正常

第六部分是建议动作，根据状态给出相应建议

---

回答原则#

只信官方来源，优先使用快递100或官网数据

不编造轨迹，查不到就是查不到，不要编造

诚实告知，查不到、异常、无法判断都要诚实说

给出建议，异常时给用户具体的处理建议

---

技术实现#

识别算法#

详见 references/carriers.md

核心逻辑是步骤一前缀匹配、步骤二长度特征匹配、步骤三兜底判断

查询工具#

browser 用于打开快递100或官网查询页面，是主要工具

web_fetch 用于抓取查询结果页面，是备用工具

脚本#

scripts/identify.py 是单号识别脚本，测试命令 python3 identify.py SF1234567890

scripts/query.py 是查询主脚本，测试命令 python3 query.py 单号

---

测试样例#

测试单号一：SF1234567890，预期识别为顺丰速运

测试单号二：JT12345678901，预期识别为极兔速递

测试单号三：JD0012345678901，预期识别为京东物流

测试单号四：781234567890，预期识别为中通快递

---

异常判断详细规则#

规则一：停滞

判断方法是最新轨迹时间距离今天超过3天

处理方式是建议联系发件人核实或联系快递公司客服

规则二：滞留

判断方法是同一站点出现3次以上

处理方式是建议直接联系快递公司客服催办

规则三：派送中超时

判断方法是状态为派送中且超过48小时

处理方式是建议联系快递员或客服询问情况

规则四：已签收未收到

判断方法是状态显示已签收但用户说没收到

处理方式是建议先确认家人同事是否代收，然后联系快递员或客服投诉

规则五：退件

判断方法是状态包含退件、退回、拒收

处理方式是建议联系发件人确认原因

---

输出模板#

标准输出格式如下：

快递公司：XXX 单号：XXX 状态：运输中/派送中/已签收/异常

最新轨迹： 2025.11.20 14:39 地点 - 状态描述

物流时间线：

1. 2025.11.20 14:39 地点 - 状态描述
2. 2025.11.20 12:26 地点 - 状态描述
3. 2025.11.19 10:00 地点 - 状态描述

异常判断：正常 / 停滞3天 / 派送超时 / 签收未收到

建议动作：暂无 / 请联系客服催办 / 请确认是否代收 / 请联系发件人核实

---

版本：v0.3 最后更新：2026-03-20