Documentation
定时任务、通知与安装包清理
定时任务、通知与安装包清理
适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。
定时任务
当前任务使用 Core 调度能力，时区为 Asia/Shanghai。在相应设置项选择有效 Cron 后才启用；留空、关闭值或非法表达式会禁用任务，不能把代码中的兜底时间理解为已自动开启。
| 任务 | 设置项 | 行为 |
|---|---|---|
| 同步订单支付状态 | 支付设置中的订单同步 | 查询原订单的支付结果并同步 |
| 授权订单动作重试 | 通用设置中的失败重试 | 按规则恢复通知、Webhook 等待处理动作 |
| 清理过期授权 | 通用设置中的授权清理 | 将到期授权标记为已过期 |
| 清理过期优惠券 | 通用设置中的优惠券清理 | 将到期优惠券标记为已过期 |
| 清理未引用安装包 | 版本推送中的安装包清理 | 按引用与保留规则删除可回收附件 |
配置步骤
- 在设置中启用确有业务需要的任务并保存。
- 核对 Core 调度状态及实际执行记录，确认任务启用和最近结果。
- 使用少量符合条件的业务记录检查处理结果。
- 执行异常时检查任务日志、关联服务及目标资源，不以“Cron 已保存”作为执行成功证据。
安装包回收
默认未引用包保留期为 7 天，可调整。任务会核对版本引用，清理超过保留期的未引用包；被新包替换的旧附件有独立回收条件，不应简单认为所有附件都统一保留 7 天。
版本推送上传和版本删除是不同操作。MCP 删除版本保留安装包附件，不能据删除成功推断存储已经回收。
通知
| 模板 | 场景 |
|---|---|
product-auth-expired-notification | 授权过期 |
product-coupon-expired-notification | 优惠券过期 |
product-order-paid-notification | 授权产品订单支付成功 |
product-new-version-notification | 版本通知 |
通知还依赖 Halo 的通知设置和可用渠道。模板存在不等于已发送或送达；检查触发、通知记录与接收渠道。MCP 版本发布明确不发送通知。
关闭与验收
关闭任务后核对实际调度禁用状态；保留已有订单、履约和动作记录用于恢复。验收时分别确认任务运行、业务状态变化以及外部通知送达，避免将其中一项代替全部结果。
评论