QoderWake任务未触发的主因是触发条件未正确配置，需按关键词、API回调、定时、手动四类方式精准设置：关键词须含完整词且关联启用Skill；API回调需严格使用生成Webhook URL并校验签名与JSON Schema；定时触发须用七字段Cron并选对时区；手动触发需通过Quest快捷入口或Mac快捷指令绑定确认机制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QoderWake在特定时机自动执行数据库备份、日志归档或周报生成，但任务始终没被唤起——这通常不是脚本写错了，而是触发条件压根没接通。
配置关键词触发条件
关键词触发适合内部协作中用自然语言快速唤起任务，比如输入“生成周报”就自动拉取数据、渲染模板、发邮件。
第一步：登录QoderWake管理控制台，进入「触发管理」页面。
第二步：点击「新建关键词触发」，填写触发名称（如“周报指令”）与描述（如“响应用户输入中的‘周报’相关词”）。
第三步：在「关键词列表」中至少填入一个完整词，支持中英文混合，例如“我要周报”“weekly report”“生成上周数据”。【注意：单字词如“报”“数”会被过滤，不生效】
第四步：勾选关联的Skill，确保该Skill已通过参数校验且状态为启用——未启用的Skill即使匹配成功也不会执行。
第五步：点击「保存并启用」，系统立刻将规则编译至边缘监听模块，无需重启服务。
绑定API回调触发源
当你需要QoderWake响应CRM工单创建、监控平台告警或审批流完成事件时，必须走API回调路径。
方法一：Webhook端点直连
1. 在「触发管理」→「API回调触发」中点击「创建新端点」。
2. 系统生成唯一Webhook URL，形如https://wake.qoder.ai/v1/webhook/abc123，【该URL一旦生成不可修改，调用方必须严格使用此地址】
3. 点击「生成密钥」获取HMAC-SHA256签名密钥，并同步配置到你的外部系统请求头中（如X-Hub-Signature-256）。
4. 在「请求体映射」区域定义JSON Schema，声明必需字段，例如："event_type"、"target_env"、"urgency_level"——缺少任一字段或类型不符，QoderWake直接返回401拒绝处理。
启用定时触发策略
定时触发是运维类任务最稳定的启动方式，所有任务在独立沙盒中运行，自带审计日志，但Cron表达式错一位，任务就永不再来。
① 进入「触发管理」→「定时触发」，点击「添加计划」。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
② 输入计划名称，例如“每日02:15核心库备份”，名称中包含时间点便于后续排查。
③ 选择执行时区——【若服务器时区为UTC而你希望按北京时间执行，必须手动切换为Asia/Shanghai，否则02:15实际对应UTC时间18:15】
④ 填写Cron表达式：QoderWake采用七字段格式（秒 分 时 日 月 周 年），例如0 15 2 * * * ?表示每天02:15:00执行；若填成0 15 2 * * *（少?），系统会误判为八字段而静默忽略。
⑤ 点击「关联任务」，从已启用的AI脚本或预设工作流中选择目标执行体，确保其参数校验已通过——未通过校验的任务无法被调度中心加载。
⑥ 勾选「启用审计日志记录」，每次执行将生成trace_id、开始时间、结束时间、退出码及stdout摘要，用于事后追溯。
⑦ 点击「保存并激活」，QoderWake立即编译该计划至调度中心，下次匹配时间点自动触发。
设置手动触发入口
手动触发适用于需人工确认的关键操作，比如生产环境回滚、敏感数据导出，避免误触导致事故。
方法一：发布Quest快捷入口
在中栏会话流中输入指令：/create shortcut --name "PROD紧急回滚" --event-type=rollback --target-context="prod:main"。
确认返回“Shortcut registered: emergency-rollback-001”，右栏Preview区域即出现带图标按钮。
将鼠标移至右栏顶部边缘等待2秒，悬浮按钮展开为横向面板；右键该按钮，选择「固定至全局悬浮栏」，按钮即常驻所有Quest界面右上角。
方法二：绑定Mac快捷指令右键菜单
在Mac「快捷指令」App中新建快捷指令，添加「运行shell脚本」操作。
脚本内容为：/usr/local/bin/qoderwake submit --event-type=rollback --target-context="prod:main" --require-human-approval=true。
保存后，该指令将出现在访达、Safari、VS Code等任意App的右键菜单中，点击即弹出二次确认对话框。
