跳到主要内容

Process

process 不是独立起任务的工具,而是 exec 的后台会话管理面。只要命令进入后台,你基本就要靠它继续观察和干预。

常用操作

操作功能说明
list列出运行中和最近结束的 session
poll取增量输出,并判断是否结束
log按偏移读取完整聚合日志
write往 stdin 写入文本
send-keys发送按键序列
submit发送回车
paste以 bracketed paste 模式粘贴文本
kill结束运行中的 session
clear清理已结束 session
remove删除 session;运行中会先杀掉再删

典型流程

  1. Start a job

    execbackground=true 启动后台任务。

  2. Track it

    process listprocess poll 查看运行状态。

  3. Interact if needed

    如果任务在等待输入,可以用 writesend-keyssubmitpaste

  4. Collect or clean up

    结束后用 log 看完整输出,再按需要 clearremove

示例

{ "tool": "exec", "command": "npm run dev", "background": true }

接着:

{ "tool": "process", "action": "poll", "sessionId": "<id>" }

注意事项

  • process 只管理后台 session
  • 没有进入后台的前台命令,不能再交给 process
  • session 结果里会带 sessionId、运行时长、tail、exitCode 等信息

相关

  • Execprocess 的入口