采集与接口
定时采集与任务调度
建立 MacCMS 定时任务，理解任务名称、触发地址、执行时间和 enforce 参数，检查任务是否真正完成。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
定时任务需要「后台定义任务」与「外部定期触发」两部分。后台保存一个任务，并不等于操作系统已经替它定时运行。
配置一个小任务
- 在后台定时任务中新增名称，例如 cj_day，选择采集资源操作。
- 从已经测试成功的资源库操作中取得当前采集参数，不使用别人站点的示例地址。
- 设置启用状态、日期与小时；先执行少量数据，核对日志和新增／更新数量。
- 外部计划任务访问本站 api.php/timming/index，可通过 name=cj_day 选择任务。
触发与执行是两件事
本版本还会检查上次运行时间和时间窗口。请求返回200可能只是检查后跳过，并不代表完成采集。读取执行输出，检查后台最后运行时间及目标数据变化。
enforce=1 的强制执行只对已登录管理员的请求放行，匿名调度请求不能靠该参数绕过时间窗口。不要把管理员 Cookie 写进定时任务来规避检查。
避免重叠
第一次任务未完成前不要反复手动触发；给长任务预留时间，采集失败先修复接口或网络。升级后检查任务类型、参数和生成的地址仍有效。
应保留的结果
记录触发时间、任务名、实际是否执行、成功／失败数量和最后完成时间。涉及 AI 或外部付费服务的任务先确认预算与凭据配置，本教程不自动开启。