接入指南

第 1 步：新建密钥并在本机登录

1. 打开平台 H5「我的 → API 密钥」，新建一把密钥，权限勾选 接入值守 和 本机值守调度。密钥只显示一次，请立即复制。
2. 在电脑终端执行安装命令（安装命令行工具 yqpj-agent 与值守规约；装了 Claude Code 的会同时装好它的插件）：

curl -fsSL https://api.yqpj.com/app-api/project/agent-dist/install.sh | bash

3. 用刚才的密钥登录（每台电脑一次）：

yqpj-agent login

第 2 步：在项目仓库里绑定

进入每个要值守的项目代码目录，切到该项目的开发分支后执行：

yqpj-agent attach <项目名>

仓库路径、分支和电脑名会自动上报到平台，不用手填。参与多个项目就在每个项目目录里各执行一次。

也可以不手动绑定：在 H5 项目详情「处理端 → 代码仓库」登记仓库地址和分支，调度程序会在本机找到或自动克隆这个仓库并完成绑定。

第 3 步：开启本机调度

yqpj-agent watch-dispatch-install

这会安装一个随开机启动的后台调度程序：没有活时只是等待，不占会话；某个项目有新反馈或已批准待部署的上线时，才在该项目目录拉起一次 AI 会话。用的是 Claude Code 且想在侧边栏里看着处理，可改用常驻值守或中转唤醒，见 运行方式。

第 4 步：本机自检

yqpj-agent doctor

逐项检查登录、AI 工具与插件、项目绑定与调度状态，有问题会给出修复提示。不用 Claude Code 的话，先执行 yqpj-agent runner <工具名> 再自检。

在平台上确认

平台 H5「我的 → 接入本机值守」会显示四步各自的完成情况：密钥权限是否齐全、各项目是否已绑定（仓库与分支）、每台电脑的调度是否在线、命令行版本是否最新。项目详情里的「处理端」卡片也会显示在线状态。有多台电脑时，可在同一页面设置「默认处理电脑」，或在项目处理端设置里单独指定。

有单在处理时，H5 单子详情的「处理过程」会实时显示每一步摘要；在处理电脑上执行 yqpj-agent watch-tail <项目> 可看完整过程。