淘宝老客复购分层

适用场景

当淘宝店铺已有脱敏订单导出，但运营不知道哪些老客进入复购窗口、哪些商品应先做补货提醒时使用。

输入与输出

• - 输入：orders.json，每条记录包含 buyer_ref、paid_at、amount、category，可选 refunded；日期使用 ISO 8601，买家仅使用不可逆引用标识。
• 输出：segment_report.json、followup_queue.csv。输出只包含引用标识、分层、最近购买日、订单数、消费额、估算复购日和推荐类别。

安装与运行

无需联网。运行 python scripts/segment_taobao_repeat_purchase.py orders.json --as-of 2026-08-26 --output-dir out。

执行规则

按买家聚合订单，排除明确退款记录；用最近购买日、订单频次和同类目相邻订单的中位间隔估算复购窗口。样本不足时输出 INSUFFICIENT_HISTORY，不伪造预测。

错误恢复

若字段缺失、日期无法解析或金额为负，脚本返回非零状态并列出原因；修正脱敏导出后重新运行。不会覆盖原始输入。

权限与隐私边界

该技能不登录淘宝、不读取Cookie、不发送消息、不创建优惠券、不改变会员权益。买家引用标识由买家自行脱敏，输出应按店铺内部权限保存。

验收

用 examples/orders.json 运行后，应生成 3 个买家分层，并保留 send_executed=false 以证明没有触达动作。