开发者文档 · 本机值守

常见问题

电脑关机、多台电脑、换设备、费用与停用。

电脑关机或睡眠了怎么办?

反馈会留在平台上排队,不会丢。电脑开机或唤醒后,调度程序会自动恢复并处理积压的单。如果有单等待过久没人领取,平台会私聊处理端负责人提醒。

有多台电脑可以一起用吗?

可以。每台电脑各执行一次安装、登录和 yqpj-agent watch-dispatch-install。一个项目同一时间只由一台电脑处理:项目处理端设置里单独指定的「处理电脑」优先,其次是「我的 → 接入本机值守」里的默认处理电脑,都没设则任一在线电脑。不同项目可以分布在不同电脑上。

会话在后台跑,怎么看它在做什么?

H5 单子详情的「处理过程」时间线实时显示摘要;处理电脑上用 yqpj-agent watch-tail <项目> 看完整过程,会话结束后用 yqpj-agent watch-open <项目> 打开它。会话名统一为「【值守】项目名」。

提示「项目未登记代码仓库」?

处理电脑上找不到这个项目的代码,且平台上没登记仓库地址。在 H5 项目详情「处理端 → 代码仓库」补填仓库地址和分支即可,下次唤醒会自动克隆并绑定。

换了新电脑怎么办?

  1. 新电脑上执行安装命令并 yqpj-agent login;
  2. 在各项目仓库里重新执行 yqpj-agent attach <项目名>,仓库路径与电脑名会更新为新电脑;
  3. 执行 yqpj-agent watch-dispatch-install 与 yqpj-agent doctor;
  4. 旧电脑上卸载调度程序,并在「我的 → API 密钥」吊销旧电脑用的密钥。

单和处理记录都在平台上,换电脑不会丢。

费用怎么算?

会话运行在你自己电脑上的 AI 编程工具里,消耗的是你自己在该工具上的额度(默认 Claude Code)。会话按需启动、处理完即退出,没有反馈时不消耗。

不用 Claude,可以用别的 AI 吗?

可以。执行 yqpj-agent runner codex 这类命令即可切换,目前已接入 Codex、Gemini CLI、opencode、Cursor CLI、Qwen Code,其它工具可以用命令模板接入。详见 支持的 AI 工具。

命令行需要手动更新吗?

不需要。平台发布新版本后,命令行会自动更新并同步值守规约。

支持哪些系统?

本机调度目前支持 macOS。其他系统即将支持。

如何停用?

  • 暂停整台电脑:执行 yqpj-agent watch-dispatch-uninstall 卸载调度程序;
  • 暂停某个项目:在平台项目详情的「处理端」卡片点「停用」;
  • 彻底收回:在「我的 → API 密钥」吊销密钥。

问题和需求怎么区分?

问题是需要回答或排查的事:功能不对、报错、查询数据、咨询怎么用,单号以 #F 开头。需求是要新增功能或改变现有行为,单号以 #R 开头。机器人会自动判断;想指定时在消息里加 #反馈 或 #需求,分错了也可以点回执上的按钮转换。值守 AI 读完内容发现分错了,也会自己改过来。

AI 处理错了怎么办?

群里有人质疑 AI 的结论或要求人工时,会话会立即转人工,不争论。涉及不可逆操作的事情(改数据、资金、权限、上线)本来就需要人来决定或审批,AI 无法自行完成。