qoderwake单次执行需绕过周期调度，可通过控制台ai定时任务模块点击「立即执行」、cli命令加--one-time=true参数或http api调用实现；三者均不修改原cron配置且不影响后续计划。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让QoderWake执行一次就结束，而不是反复运行或等待下次定时触发，比如紧急回滚、临时数据快照、手动触发的周报生成等场景，必须绕过默认的周期性调度机制，直接调用单次执行通道。
通过AI定时任务模块手动触发
这是最直观、无需命令行权限的方式，适合桌面端用户快速发起单次任务。
登录QoderWake控制台→进入【自动化】→【AI定时任务】模块→找到目标任务（如“每日增量备份”）→点击右侧「立即执行」按钮。
任务状态栏将实时显示“正在执行中”，完成后自动变为“成功”，【该操作不会修改原任务的Cron配置，也不会影响后续定时计划】。
使用CLI提交一次性事件
适用于服务器环境、脚本集成或需要精确控制上下文参数的场景，比界面操作更底层、更可控。
在终端中执行：qoderwake submit --event-type=emergency-rollback --target-context="prod:main" --one-time=true。
注意：必须显式添加 【--one-time=true】 参数，否则QoderWake会按默认策略将其纳入持久化调度队列；若省略此参数，即使当前未配置Cron，系统仍可能在后台尝试重试或归档该事件。
执行后返回类似Submitted event ID: ev-9a3f8d21-b7c4-4e0e-9b55-1e8a6f0b2c3a的唯一标识，可用于日志追踪。
调用HTTP API触发单次任务
当你的业务系统需要从外部系统（如ERP、监控平台）直接驱动QoderWake执行某项动作时，应使用REST API方式，避免依赖客户端状态。
向 http://[your-qoderwake-host]:18789/api/v1/trigger/once 发送 POST 请求，Body 为 JSON：
{"task_id": "weekly-report-gen", "params": {"format": "pdf", "include": ["code", "pr"]}}。
请求头需包含 Authorization: Bearer [your-api-token]，该token需提前在【设置】→【API密钥管理】中生成并启用；【未携带有效token将返回401且不记录任何审计日志】。
响应体含 "status": "accepted" 即表示已入队，可在【执行监控】页按 event_id 实时查看进度。
