littlebalalafairy/xianyu-auto-reply

Fork 0

mirror of https://github.com/zhinianboke/xianyu-auto-reply.git synced 2025-08-02 20:47:35 +08:00

zhinianboke 73b274cce8 首次提交

2025-07-24 12:05:21 +08:00

5.6 KiB

Raw Blame History

🚚 自动发货功能使用说明

📋 功能概述

自动发货功能可以在买家付款成功后，根据商品信息自动匹配发货规则，并发送对应的卡券内容给买家。

🎯 工作流程

1. 触发条件

系统收到"等待卖家发货"消息时自动触发
表示买家已完成付款，等待卖家发货

2. 商品信息获取

买家付款成功 → 提取商品ID → 调用闲鱼API → 获取商品详情

获取的信息包括：

商品标题
商品描述
商品分类
商品价格
其他相关信息

3. 智能匹配规则

商品信息 → 组合搜索文本 → 匹配发货规则 → 选择最佳规则

匹配策略：

优先匹配关键字长度较长的规则（更精确）
支持商品标题、描述、分类的综合匹配
支持模糊匹配和部分匹配

4. 自动发货执行

匹配规则 → 获取卡券内容 → 发送给买家 → 更新统计

🎫 卡券类型说明

1. API接口类型

适用场景： 需要动态获取内容的卡券

调用外部API获取实时数据
支持GET/POST请求
可配置请求头和参数
自动处理API响应

配置示例：

{
  "url": "https://api.example.com/get-card",
  "method": "GET",
  "timeout": 10,
  "headers": "{\"Authorization\": \"Bearer token\"}",
  "params": "{\"type\": \"recharge\", \"amount\": 100}"
}

2. 固定文字类型

适用场景： 标准化的文字内容

发送预设的固定文字
适合使用说明、激活码等
内容固定不变

内容示例：

🎉 恭喜您获得VIP会员卡！

会员卡号：VIP2024001
有效期：2024年12月31日

专属权益：
✅ 免费配送
✅ 专属客服
✅ 会员折扣

感谢您的支持！

3. 批量数据类型

适用场景： 唯一性数据，如卡密

逐条消费预设数据
线程安全，防止重复发送
自动管理库存

数据格式：

CARD001:PASS001
CARD002:PASS002
CARD003:PASS003

⚙️ 配置步骤

1. 创建卡券

登录管理界面
点击"卡券管理"菜单
点击"添加卡券"按钮
选择卡券类型并配置相应参数
启用卡券

2. 配置发货规则

点击"自动发货"菜单
点击"添加规则"按钮
设置商品关键字
选择对应的卡券
设置发货数量
启用规则

3. 关键字配置建议

商品分类关键字：

手机 - 匹配手机类商品
数码 - 匹配数码产品
服装 - 匹配服装类商品
鞋子 - 匹配鞋类商品
家居 - 匹配家居用品

品牌关键字：

iPhone - 匹配iPhone商品
小米 - 匹配小米商品
华为 - 匹配华为商品

功能关键字：

充值 - 匹配充值类商品
会员 - 匹配会员服务
游戏 - 匹配游戏相关商品

📊 统计功能

发货统计

总发货次数
各规则发货次数
发货成功率
卡券消耗情况

库存管理

批量数据剩余数量
卡券启用状态
规则启用状态

🔧 高级配置

环境变量

# 启用自动发货
AUTO_DELIVERY_ENABLED=true

# 自动发货超时时间
AUTO_DELIVERY_TIMEOUT=30

# API卡券请求超时
API_CARD_TIMEOUT=10

# 批量数据并发保护
BATCH_DATA_LOCK_TIMEOUT=5

日志配置

系统会记录详细的发货日志：

商品信息获取日志
规则匹配日志
发货执行日志
错误处理日志

🚨 注意事项

1. 商品ID提取

系统会尝试从多个字段提取商品ID
如果提取失败，会使用默认ID
建议检查日志确认提取是否成功

2. API卡券配置

确保API地址可访问
检查请求头和参数格式
设置合适的超时时间
处理API异常情况

3. 批量数据管理

定期检查数据库存
及时补充批量数据
监控消耗速度
设置库存预警

4. 规则优先级

关键字越长，优先级越高
避免关键字冲突
定期优化匹配规则
测试匹配效果

🧪 测试方法

1. 功能测试

python test-item-info-delivery.py

2. 手动测试

创建测试卡券和规则
模拟"等待卖家发货"消息
检查发货是否正常
验证统计数据更新

3. 日志检查

查看日志文件确认：

商品信息获取是否成功
规则匹配是否正确
发货内容是否正确发送

🔍 故障排除

常见问题

1. 未触发自动发货

检查发货规则是否启用
检查卡券是否启用
检查关键字是否匹配
查看错误日志

2. 商品信息获取失败

检查Cookie是否有效
检查网络连接
检查商品ID是否正确
查看API调用日志

3. 批量数据用完

检查数据库存
及时补充数据
考虑使用其他类型卡券

4. API卡券调用失败

检查API地址和参数
检查网络连接
增加超时时间
查看API响应日志

📈 性能优化

1. 数据库优化

定期清理过期数据
优化查询索引
监控数据库性能

2. 网络优化

设置合适的超时时间
使用连接池
实现重试机制

3. 并发控制

批量数据消费使用锁机制
避免重复发货
控制并发数量

💡 最佳实践

规则设计：关键字要具体明确，避免过于宽泛
库存管理：定期检查批量数据库存，及时补充
监控告警：设置发货失败告警，及时处理异常
测试验证：新规则上线前充分测试
日志分析：定期分析发货日志，优化匹配规则

🎉 自动发货功能让您的闲鱼店铺实现真正的自动化运营！

5.6 KiB Raw Blame History Unescape Escape