qoderwake定时任务需正确配置触发策略、cron表达式及时区，推荐生产环境用定时触发策略（七字段cron+独立沙盒+审计日志），快速验证可用ai定时任务，高级用户可cli守护部署，并需macos用户执行防睡眠配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
您需要让QoderWake在固定时间自动执行数据库备份、日志归档或指标快照等运维操作，但发现任务未按时运行或状态不可见，这通常是因为定时触发策略未启用、Cron表达式格式错误或执行沙盒未通过审计校验。
配置定时触发策略（推荐用于生产环境）
该方式基于标准Cron七字段表达式驱动，在独立沙盒中运行所有周期性任务，并自动生成完整审计日志，适用于对稳定性与可追溯性要求高的场景。
第一步：登录QoderWake管理控制台，进入「触发管理」→「定时触发」模块。
第二步：点击「添加计划」，输入计划名称，例如“每日01:30核心库备份”——名称中必须包含时间点和用途关键词，否则后续无法快速定位任务。
第三步：选择执行时区，默认为服务器本地时区；如需统一按北京时间调度，【必须手动切换为Asia/Shanghai】，若选错时区，任务将在UTC时间01:30执行，相当于北京时间09:30，导致错过低峰期。
第四步：在Cron表达式输入框中填写时间规则，例如0 30 1 * * *表示每天01:30:00准时触发（注意是七字段格式：秒 分 时 日 月 周 年，末位年份可省略）。
第五步：点击「关联任务」，从已启用的AI脚本或预设工作流中选择目标执行体，确保其参数校验已通过且状态为“启用中”，否则保存后任务将始终处于待激活态。
第六步：勾选「启用审计日志记录」，系统将为每次执行生成唯一trace_id、开始时间、结束时间、退出码及标准输出摘要。
第七步：点击「保存并激活」，QoderWake将立即编译该计划至调度中心，并在下次匹配时间点自动触发。
使用平台内置AI定时任务（适合快速验证与轻量场景）
该方式无需脱离控制台即可完成全链路部署与状态监控，所有逻辑封装在平台内，适合临时调试或非关键路径任务。
方法一：可视化创建Python AI脚本任务
1、进入【自动化】→【AI定时任务】模块，点击“新建任务”，任务类型选择“Python AI脚本”，名称设为“每日增量备份”。
2、在脚本编辑区输入导出指令，例如：import qoderwake.db as db; db.export_table(export_format="parquet", tables=["users", "orders"], output_path="/backup/daily_{{now|strftime:%Y%m%d}}.parquet")。
3、在「调度设置」区域点击「设置定时」，选择「按Cron表达式」，填入0 30 1 * * ?（兼容Quartz六字段语法）。
4、开启「执行状态推送」，绑定企业微信/钉钉机器人Webhook地址，任务成功或失败时将实时通知。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
方法二：调用预设指令型任务
1、点击“新建任务”，任务类型选择“周报生成”，名称设为“每周五17:00研发周报自动产出”。
2、在触发设置中填写Cron表达式：0 0 0 17 ? FRI *，表示每周五下午5点整执行。
3、在任务脚本区输入指令：/report weekly --format=pdf --include=code,pr,alert。
4、启用“失败重试三次”与“异常邮件通知”选项，保存并激活任务。
通过CLI配置本地守护式定时任务（适合高级用户与Linux/macOS环境）
该方式绕过图形界面依赖，以纯命令行方式部署QoderWake CLI作为系统级守护进程，彻底规避GUI锁屏影响，并支持开机自启与崩溃自动重启。
1、编辑task_helloworld.qw，将第一行替换为trigger: cron "0 0 * * *"，表示每天00:00执行。
2、确保系统时间区域与QoderWake运行时配置一致，可通过qwrun --info查看timezone字段值。
3、执行qwrun --daemon --config conf/default.yaml启动守护进程。
4、检查D:\qoderwake\logs\qoderwake.log（Windows）或/var/log/qoderwake/qoderwake.log（Linux/macOS）中是否出现Scheduled task_helloworld.qw at 00:00 daily日志条目。
防睡眠配置（macOS用户必做）
若您使用Mac设备，系统休眠会导致QoderWake进程被挂起、定时任务完全失效，必须执行以下三项强制保活措施。
1、打开“终端”应用，执行：sudo pmset -a sleep 0 displaysleep 0 disksleep 0，输入管理员密码后无反馈即表示设置成功。
2、启动QoderWake桌面客户端，点击左上角菜单栏「QoderWake」→「偏好设置」→「自动化」标签页，勾选“任务执行期间保持系统唤醒”和“定时任务触发前5分钟自动唤醒系统”。
3、打开「系统设置」→「锁屏」，将「启用屏幕锁定」设为“从不”；再进入「节能」→「电池」和「电源适配器」，将「防止自动睡眠」滑块拖至最右端。
