# Computer Control API
SUMMARY: 远程控制已注册的计算机 — 排队命令、截屏、在远程机器上运行脚本。

KEY CONTEXT:
Two sides: user-facing (Mind Key/JWT) and agent-facing (Computer Token)
Register agent: POST /computers/register { install_code } → returns computer_token
List: GET /computers/list (Mind Key or JWT)
Queue command: POST /computers/:id/commands { type, payload }
Command types: screenshot, click, move, type, key, scroll, drag
Agent poll: GET /computers/me/poll?wait=5 (Computer Token)
Agent result: POST /computers/me/commands/:cid/result (Computer Token)
One-shot screenshot: GET /computers/:id/screenshot (waits 30s for result)
Pattern: register agent on remote machine → user queues commands → agent polls and executes

Computer Control API
Computer Control API 让你能够远程控制已注册的计算机。目标机器上会运行一个小型 Agent（），轮询命令、执行命令并回传结果。这使 LLM 驱动的 GUI 自动化成为可能。
架构
[CODE BLOCK]
用户侧端点（Mind Key 或 JWT）
GET /computers/list
列出所有已注册的计算机。
[CODE BLOCK]
GET /computers/:id
获取单台计算机的详情。
[CODE BLOCK]
POST /computers/install-code
为注册新计算机生成一个安装码。
[CODE BLOCK]
响应：
POST /computers/:id/commands
为远程 Agent 排队一条待执行的命令。
[CODE BLOCK]
响应：
GET /computers/:id/command（通过查询参数）
通过 GET 方式排队命令（用于简单场景）。
[CODE BLOCK]
GET /computers/:id/commands
列出某台计算机最近的命令。
[CODE BLOCK]
GET /computers/:id/commands/:cid
获取某条具体命令的状态与结果。
[CODE BLOCK]
GET /computers/:id/screenshot
一次性操作：排队截图命令并等待最多 30 秒拿结果。
[CODE BLOCK]
POST /computers/:id/disable
禁用某台计算机（吊销其令牌，保留记录以备审计）。
[CODE BLOCK]
DELETE /computers/:id
永久删除某台计算机。
[CODE BLOCK]
Agent 侧端点（Computer Token）
以下端点由运行在目标机器上的  使用。它们使用 Computer Token（由  返回），而不是 Mind Key。
POST /computers/register
兑换安装码并获取 Computer Token。
[CODE BLOCK]
响应：
> [!CRITICAL]
> 请妥善保存  — 它只显示一次，且所有 Agent 侧端点都需要它。
GET /computers/me/poll
长轮询新命令。Agent 会在循环中调用此端点。
[CODE BLOCK]
如果有待执行命令，则立即返回；否则等待  秒后返回。
POST /computers/me/commands/:cid/result
提交某条命令的执行结果。
[CODE BLOCK]
命令类型
| 类型 | Payload | 说明 |
|------|---------|-------------|
|  |  | 截屏为 PNG（base64） |
|  |  | 在指定坐标点击 |
|  |  | 将鼠标移动到指定坐标 |
|  |  | 在光标处输入文本 |
|  |  | 按下组合键 |
|  |  | 滚动滚轮 |
|  |  | 拖拽 |
常见模式：LLM 驱动的 GUI 自动化
[CODE BLOCK]
下一步
- Browser 代理 — 用于浏览器自动化的独立服务
- 自托管 Agent 指南