`exec`

用途

执行 shell 命令，可直接等待，也可后台运行。

常见参数

参数	说明
`command`	要执行的 shell 命令
`workdir`	工作目录
`timeout`	超时时间，单位秒
`yieldMs`	等待多久后返回部分结果或转后台
`background`	是否立即后台运行
`pty`	是否尝试使用伪终端
`host` / `node`	指定执行宿主

请求示例

json

{
  "command": "npm test",
  "workdir": "/workspace/project",
  "timeout": 120
}

json

{
  "command": "npm run dev",
  "workdir": "/workspace/project",
  "background": true
}

返回示例

可能是：

直接命令输出
后台 session 信息
超时或非零退出码

常见误用

明明有第一方工具却硬上 shell
长任务高频 poll
需要 TTY 的程序却没开 pty