电商物流延迟检测 + 安抚短信技能

概述

为电商卖家提供「物流监控→延迟检测→安抚话术→短信发送」一站式服务。 检测到异常后，自动生成专业安抚短信并发送给客户，降低差评率和客诉。

核心能力

1. 物流轨迹查询 — 支持60+快递公司，自动识别快递公司
2. 延迟风险检测 — 4条规则引擎：发货超时、运输停滞、派送异常、预计超时
3. AI安抚话术 — 根据延迟原因个性化生成短信内容
4. 短信发送 — 阿里云/腾讯云短信，支持dry-run预览

工作模式

快速开始

模式 1：CSV批量导入

准备CSV文件（UTF-8编码），包含以下列：

order_id,customer_name,customer_phone,tracking_number,carrier_code,order_date,product_name
20260615001,张三,13800138000,SF1234567890,SF,2026-06-10,新款T恤
20260615002,李四,13900139000,YT9876543210,,2026-06-11,运动鞋
20260615003,王五,13700137000,JD000111222333,,2026-06-08,手机壳

必填列：order_id, customer_phone, tracking_number 可选列：customer_name, carrier_code（不填则自动识别）, order_date, product_name

模式 2：手动单号查询

直接提供运单号，逐一手动输入客户信息。

使用流程

Step 1: 获取订单数据

# WorkBuddy 将执行：
python scripts/order_processor.py --input orders.csv --validate

Step 2: 查询物流状态并检测延迟

python scripts/logistics_checker.py --input orders.csv --output results.json

Step 3: 生成安抚短信预览

python scripts/sms_sender.py --input results.json --mode dry-run --output preview.html

Step 4: 确认并发送短信（可选）

python scripts/sms_sender.py --input results.json --mode send --provider aliyun

延迟检测规则

API 配置

物流查询 — UAPI

• 接口地址：https://uapis.cn/api/v1/misc/tracking/query
• 认证方式：API Key（免费注册即送积分）
• 费用：40积分/次（访客积分有限，建议注册）

配置方式：在 ~/.workbuddy/skills/logistics-care/references/api_config.md 中填写 API Key

短信发送 — 阿里云短信

• SDK：dysmsapi20170525
• 需要：AccessKey + 短信签名 + 模板CODE

短信发送 — 腾讯云短信（备用）

• SDK：tencentcloud-sdk-python
• 需要：SecretId + SecretKey + SDK AppID + 模板ID

安抚短信模板策略

根据延迟原因选择话术风格：

• 发货超时：致歉 + 解释原因 + 新发货时间 + 补偿
• 运输停滞：告知已催促快递 + 预计到达时间 + 致谢耐心
• 派送异常：紧急通知 + 已联系快递处理 + 替代方案
• 预计超时：温和提醒 + 更新预计时间 + 随时联系

每条短信控制在70字以内（1条短信），减少成本。

输出

1. HTML报告 — 可视化展示所有订单物流状态、延迟摘要、短信发送结果
2. JSON结果 — 结构化数据，可二次处理
3. 短信预览 — 每条短信内容 + 发送状态

技能维护

• 物流API如有变动，更新 references/api_config.md
• 延迟规则阈值可在 scripts/logistics_checker.py 的 DELAY_RULES 字典中调整
• 安抚话术模板在 scripts/sms_sender.py 的 MESSAGE_TEMPLATES 中维护