qoderwake定时任务未触发的主因是cron格式错误、时区未显式指定或沙盒权限未校验；推荐配置定时触发策略，需在管理控制台设置asia/shanghai时区、七字段cron表达式“0 0 3 *”、关联已启用工作流并启用审计日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
您希望QoderWake自动化任务在每天凌晨3点自动执行数据库快照，但发现任务从未触发或只运行了一次，这通常是因为Cron表达式格式错误、时区未显式指定或沙盒权限未通过校验。
配置定时触发策略（推荐用于运维类任务）
该方式强制任务在独立沙盒中运行，自带审计日志与秒级精度，适用于备份、归档、指标采集等需强隔离与可追溯的场景。
1、登录QoderWake管理控制台，进入「触发管理」→「定时触发」模块。
2、点击「添加计划」，输入名称“每日03:00核心库快照”，名称中必须含具体时间与用途关键词，否则后续无法快速定位异常计划。
3、选择执行时区为【Asia/Shanghai】；若选错时区，任务将在UTC时间03:00执行，相当于北京时间11:00，导致错过低峰期。
4、在Cron表达式输入框填写【0 0 3 * * *】（七字段格式：秒 分 时 日 月 周 年），表示每天03:00:00整点触发；末位年份字段可省略，但前六字段缺一不可。
5、点击「关联任务」，从已启用的AI工作流中选择“db-snapshot-v2”，该工作流必须已通过参数校验且状态为“启用中”，否则保存后任务将始终处于待激活态。
6、勾选「启用审计日志记录」，系统将为每次执行生成唯一trace_id、开始时间、结束时间、退出码及标准输出摘要。
7、点击「保存并激活」，QoderWake将立即编译该计划至调度中心，并在下次匹配时间点自动触发。
使用AI定时任务（适合快速部署与可视化调试）
无需脱离控制台即可完成全链路部署与状态监控，所有逻辑封装在平台内，适合非运维人员快速上手。
方法一：新建Python AI脚本任务
1、进入【自动化】→【AI定时任务】模块，点击“新建任务”。
2、任务类型选择“Python AI脚本”，名称设为“每日增量备份”。
3、在脚本编辑区输入导出指令：
import qoderwake.db as db
db.export_table(export_format="parquet", tables=["users", "orders"], output_path="/backup/daily_{{now|strftime:%Y%m%d}}.parquet")
4、在「调度设置」区域点击「设置定时」，选择「按Cron表达式」，填入【0 0 0 3 ? *】（Quartz六字段语法，兼容平台自动转换）。
5、开启「执行状态推送」，绑定企业微信/钉钉机器人Webhook地址，任务成功或失败时将实时通知。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
方法二：调用内置指令生成周报
1、在【AI定时任务】中新建任务，类型选“周报生成”，名称设为“每周五17:00研发周报自动产出”。
2、触发设置填写Cron表达式：【0 0 0 17 ? FRI *】，表示每周五下午5点整执行。
3、脚本区输入指令：
/report weekly --format=pdf --include=code,pr,alert
4、启用“失败重试三次”与“异常邮件通知”选项，保存并激活任务。
CLI+crontab联合调度（Linux/macOS高级用户专用）
绕过图形界面依赖，以纯命令行方式部署QoderWake CLI作为系统级守护进程，彻底规避GUI锁屏影响。
第一步：确认QoderWake CLI已安装并可执行
在终端运行 qwrun --info，检查输出中 timezone 字段是否为 Asia/Shanghai；若不一致，需在 conf/default.yaml 中显式设置 timezone: "Asia/Shanghai"。
第二步：编辑本地 crontab
执行 crontab -e，新增一行：
0 3 * * * /usr/local/bin/qwrun --task daily-snapshot --config /etc/qoderwake/conf.yaml
第三步：赋予脚本执行权限
确保 /usr/local/bin/qwrun 具有可执行权限：chmod +x /usr/local/bin/qwrun
第四步：启动守护进程
执行 qwrun --daemon --config /etc/qoderwake/conf.yaml，系统将后台常驻监听cron调度信号。
第五步：验证日志输出
检查 /var/log/qoderwake/qoderwake.log 是否出现 Scheduled daily-snapshot at 03:00 daily 日志条目。
防睡眠配置（Mac用户必做）
macOS系统默认休眠会导致QoderWake进程被挂起，定时任务完全失效。以下三步缺一不可。
1、禁用系统级自动睡眠：打开“终端”，执行 sudo pmset -a sleep 0 displaysleep 0 disksleep 0，输入管理员密码后无反馈即表示设置成功。
2、启用QoderWake内置唤醒功能：在客户端菜单栏「QoderWake」→「偏好设置」→「自动化」标签页中，勾选“任务执行期间保持系统唤醒”和“定时任务触发前5分钟自动唤醒系统”。
3、关闭屏幕锁定：进入「系统设置」→「锁屏」，将「启用屏幕锁定」设为“从不”；同时在「节能」设置中将「防止自动睡眠」滑块拖至最右端。
