QoderWake定时任务未执行的三大原因包括定时策略未启用、Cron表达式错误或沙盒未通过审计校验；需按七步完成定时触发配置，支持AI脚本、周报生成及CLI+crontab混合调度，并可启用重试与异常通知机制。
☞☞☞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定时任务
该方式通过QoderWake可视化界面直接创建可执行、可追溯的AI驱动定时任务，所有逻辑封装在平台内，无需脱离控制台即可完成全链路部署与状态监控。
方法一：新建Python AI脚本任务
进入【自动化】→【AI定时任务】模块 → 点击“新建任务” → 任务类型选择“Python AI脚本” → 名称设为“每日增量备份” → 在脚本编辑区输入导出指令，例如：import qoderwake.db as db; db.export_table(export_format="parquet", tables=["users", "orders"], output_path="/backup/daily_{{now|strftime:%Y%m%d}}.parquet") → 在「调度设置」区域点击「设置定时」，选择「按Cron表达式」，填入0 30 1 * * ?（兼容Quartz六字段语法） → 开启「执行状态推送」，绑定企业微信/钉钉机器人Webhook地址。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
方法二：新建周报生成任务
进入【自动化】→【AI定时任务】模块 → 点击“新建任务” → 任务类型选择“周报生成” → 名称设为“每周五17:00研发周报自动产出” → 在触发设置中填写Cron表达式：0 0 0 17 ? FRI * → 在任务脚本区输入指令：/report weekly --format=pdf --include=code,pr,alert → 启用“失败重试三次”与“异常邮件通知”选项，保存并激活任务。
通过CLI+crontab联合调度
此路径适用于已在服务器部署QoderWake CLI且需要复用系统级crontab的场景，适合DevOps人员做混合调度编排。
在Linux终端执行：crontab -e → 添加一行：0 30 1 * * /usr/local/bin/qoderwake submit --event-type=scheduled-backup --target-context="db:core" --metadata='{"schedule_id":"daily-0130"}' → 保存退出。该命令每天01:30调用QoderWake CLI提交结构化事件，由后台数字员工接收并执行。
注意：CLI必须已通过qoderwake login完成身份绑定，且qoderwake status显示active状态，否则任务提交失败。
启用失败重试与异常通知
方法一：平台内置重试机制
在「定时触发」计划详情页，勾选“失败自动重试”，设置重试次数为3次，间隔60秒。该机制仅适用于网络超时或沙盒启动失败，不处理脚本内逻辑错误。
方法二：CLI侧兜底重试
在crontab命令中包裹shell逻辑：0 30 1 * * ( /usr/local/bin/qoderwake submit --event-type=... || sleep 60 && /usr/local/bin/qoderwake submit --event-type=... )。这种方式绕过平台限制，但无法记录重试上下文。
方法三：Webhook异常回调
在「定时触发」计划中开启「执行状态推送」，绑定外部Webhook地址；当任务退出码非0时，QoderWake将携带trace_id、error_message、duration_ms等字段发起POST请求，供下游告警系统消费。
