快递查询

查询快递物流状态。支持主流快递公司（顺丰、中通、圆通、韵达、申通、极兔、京东、EMS等），自动识别快递公司。当用户询问快递状态、物流信息、包裹位置时触发。

快递查询 Skill

查询国内主流快递公司的物流状态，支持自动识别快递公司。

功能特点

• 自动识别快递公司：根据单号前缀自动判断快递公司
• 多公司支持：顺丰、中通、圆通、韵达、申通、极兔、京东、EMS、百世
• 实时物流轨迹：查询包裹的实时位置和运输状态
• 格式化输出：清晰展示物流时间线

使用方法

基本用法

python3 scripts/track.py <快递单号>

指定快递公司

python3 scripts/track.py <快递单号> <快递公司编码>

顺丰快递（需要手机号后四位）

python3 scripts/track.py SF1234567890 shunfeng 1234

支持的快递公司

编码	名称	备注
shunfeng	顺丰速运	需要手机号后四位
zhongtong	中通快递	自动识别
yuantong	圆通速递	自动识别
yunda	韵达快递	自动识别
shentong	申通快递	自动识别
jtexpress	极兔速递	自动识别
jd	京东物流	自动识别
ems	邮政EMS	自动识别
huitongkuaidi	百世快递	自动识别

配置说明

在 config.json 中配置快递100 API 密钥：

{
  "key": "YOUR_API_KEY",
  "customer": "YOUR_CUSTOMER_ID",
  "default_phone": "手机号后四位（顺丰用）"
}

API 限制

• 免费额度：100次/天
• 顺丰快递需要提供手机号后四位

工作流程

1. 用户询问快递状态
2. 优先询问单号（而非自动查询历史）
3. 自动识别快递公司或手动指定
4. 调用快递100 API 查询
5. 格式化返回物流轨迹

示例输出

📦 顺丰速运
📌 单号: SF1234567890
📍 状态: 派件中

📋 物流轨迹:
📍 2024-03-07 10:30 正在派送中，派送员：张三，电话：138****1234
   2024-03-07 08:15 到达 北京朝阳区分拨中心
   2024-03-06 22:00 离开 上海转运中心
   2024-03-06 18:30 已揽收