开发者文档 · 本机值守

运行方式

常驻值守、后台调度、中转唤醒三种方式的区别、前提、怎么看处理过程和怎么切换。

三种方式对比

方式谁来处理怎么看过程前提
常驻值守(仅 Claude Code)Claude App 侧边栏里一直开着的「【值守】项目名」会话,自己挂监听侧边栏实时看App 开着,会话一直在跑
后台调度(推荐)本机调度程序有活时在后台拉起会话,处理完退出H5 单子详情「处理过程」+ yqpj-agent watch-tail已执行 yqpj-agent watch-dispatch-install
中转唤醒(仅 Claude Code)调度程序发现有活 → 通知侧边栏的「【调度】值守中转」会话 → 它把单子发给该项目的「【值守】项目名」会话处理侧边栏实时看,可随时插话已装调度程序 + App 开着 + 中转会话在跑 + 侧边栏已有该项目的值守会话
常驻值守和中转唤醒依赖 Claude App 侧边栏;用 Codex、Gemini 等其它 AI 工具时请用后台调度,见 支持的 AI 工具。

资源占用

  • 常驻值守:每个项目一个会话一直开着,项目多时最占资源。
  • 后台调度:平时只有一个很轻的调度程序;有活才启动会话,处理完退出。
  • 中转唤醒:一个中转会话 + 每个项目一个侧边栏会话常开,但没活时都在等待,不消耗额度。

处理过程怎么看

  • H5 单子详情的「处理过程」时间线:任何方式下都显示摘要(后台调度最完整),处理中每 5 秒刷新。
  • 处理电脑本机:yqpj-agent watch-tail <项目> 实时跟随后台会话;结束后 yqpj-agent watch-open <项目> 打开它接着聊。
  • 常驻值守与中转唤醒:直接在侧边栏的「【值守】项目名」会话里看。

怎么切换

  1. 打开 H5 项目详情 → 「处理端」卡片 → 「设置」;
  2. 在「运行方式」里选一项并保存;
  3. 按所选方式完成切换后的准备:
    • 常驻值守:在侧边栏会话里执行 /feedback-watch <处理端名>;
    • 后台调度:确认已执行 yqpj-agent watch-dispatch-install,原来的常驻会话可以关掉;
    • 中转唤醒:在侧边栏开「【值守】项目名」会话,再开一个会话执行 /feedback-relay 作为中转。

命令行也可以切换:yqpj-agent watch-dispatch-adopt <处理端> 改为后台调度,yqpj-agent watch-dispatch-release <处理端> 改回常驻值守。

中转唤醒的兜底规则

  • 中转会话 90 秒内没有心跳,或任务 60 秒内没被取走:自动按后台调度处理,单子不会卡住;
  • 找不到该项目的侧边栏值守会话:改为后台调度,并私聊负责人一次(同一原因 24 小时内不重复);
  • 同一项目已转交、还没处理完时不重复转交(45 分钟内视为处理中)。

常见问题

中转为什么不能自己新建侧边栏会话?

会话内没有新建侧边栏会话的能力,只能唤醒已经存在的会话,所以要先在侧边栏开好「【值守】项目名」会话。

电脑关了 App 会怎样?

常驻值守没人处理,单子排队等你回来;中转唤醒自动退回后台调度;后台调度不受影响(调度程序开机常驻)。

不知道选哪个?

选后台调度。想看着处理过程时,用 H5 时间线或 watch-tail 就够了。