定时任务配置说明
示例命令：php webman auto:cash
已配置的定时任务
- 建议顺序
| 序号 | 任务名称 | 执行频率 | 命令 | 说明 |
|---|---|---|---|---|
| 1 | 自动解冻资金 | 每天10点 | unfreeze:money | 自动解冻商户冻结资金 |
| 2 | 创建商家自动提现 | 每天凌晨11点 | auto:cash | 创建商家自动提现 |
| 3 | 创建商家自动定额提现 | 每10分钟 | auto:cash_ration | 创建商家自动定额提现 |
| 4 | 支付宝批量转账 | 每分钟 | auto:daifu | 支付宝批量转账任务 |
| 5 | 自动发布结算公告 | 每天凌晨1点 | auto:article | 自动发布结算公告 |
| 6 | 清理历史数据 | 每天凌晨3点 | clean:old_data | 清理40天前的历史数据 |
| 7 | 处理超时投诉 | 每半小时 | complaint:handle_timeout | 处理超时投诉 |
| 8 | 每周订单加分 | 每周一0点8分 | score:weekly_reward | 每周订单加分 |
| 9 | 更新优质商家标签 | 每周一0点10分 | update:quality_merchant | 更新优质商家标签 |
| 10 | 更新 USDT/CNY 汇率 | 每5分钟 | usdt:update-rate | 从 CoinGecko 获取最新汇率并更新 |
| 11 | 大厅名片订阅处理 | 每分钟 | hall-card:subscriptions | 自动续费、余额不足关闭续费、到期前三天每日提醒及过期降级 |
| 12 | 用户邀请返佣结算 | 每分钟 | spread:user-rebate-settle | 退款期结束后将用户待结算返佣转入用户余额；投诉处理中暂缓 |
宝塔计划任务配置
任务类型选择“Shell 脚本”，执行周期选择“N 分钟”，填写 5。
示例：
bash
cd /www/wwwroot/项目目录 && /www/server/php/82/bin/php webman usdt:update-rate首次配置后，应先手动执行一次命令并确认输出“USDT/CNY 汇率更新成功”或“USDT/CNY 汇率无需更新”。
该任务会校验 CoinGecko 行情时间和汇率波动。接口请求失败、行情超过 10 分钟或相对数据库旧值变化超过 10% 时，不会覆盖原有汇率。
CoinGecko 返回 429 时，可以申请 Demo API Key，并在任务中传入：
bash
cd /www/wwwroot/项目目录 && COINGECKO_API_KEY='你的Key' php webman usdt:update-rate大厅名片订阅任务
先执行 sql/2026-07-31-add-user-hall-card-subscriptions.sql，再添加每分钟执行的 Shell 计划任务：
bash
cd /www/wwwroot/项目目录/service && /www/server/php/82/bin/php webman hall-card:subscriptions首次配置后手动执行一次，正常输出格式为：处理完成：续费 0，关闭自动续费 0，到期提醒 0，降级 0。
用户邀请返佣结算任务
执行 sql/2026-08-07-split-user-merchant-spread.sql 后，添加每分钟执行的 Shell 计划任务：
bash
cd /www/wwwroot/项目目录/service && /www/server/php/82/bin/php webman spread:user-rebate-settle正常输出格式为：用户邀请返佣结算完成：0/0。存在未结束投诉的订单会输出“暂缓结算”，退款订单的待结算记录会被取消。