QoderWake脚本超时设置支持脚本头声明（timeout=60，须首行）、命令行参数（--timeout或-t，优先级更高）及subprocess子进程控制（需捕获TimeoutExpired异常）。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

QoderWake脚本执行超时设置用于强制中断长时间无响应的数字员工任务，避免因网络卡顿、接口假死或逻辑缺陷导致进程持续占用资源、阻塞后续流程。

在脚本头部声明超时阈值

打开QoderWake脚本文件（.qwk后缀），在第一行添加timeout=60，数值单位为秒，支持整数和小数（如timeout=30.5）。

这一步必须放在import语句之前，否则QoderWake解析器无法识别；若写在第二行及以后，超时机制将完全失效。

通过run命令显式传入超时参数

方法一：在终端执行时附加--timeout选项→qoderwake run task.qwk --timeout 45。

方法二：使用短参数形式→qoderwake run task.qwk -t 90。

Agent CLI (Cursor + Qoder)

代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。

下载

【-t参数优先级高于脚本内timeout声明】，当两者同时存在时，以命令行参数为准。

在Python子流程中嵌套控制超时

第一步：在脚本中导入subprocess模块→import subprocess。

第二步：调用subprocess.run()时传入timeout关键字参数，例如：subprocess.run(['ping', '-c', '3', 'qoder.ai'], timeout=10)。

第三步：捕获subprocess.TimeoutExpired异常并做清理处理，否则子进程可能残留为僵尸进程。

注意：该方式仅对当前subprocess.run()调用生效，不影响主脚本整体超时行为。