本地控制台
观察机器人画面、发送任务并管理指令与录像。
本地控制台运行在连接机器人的控制电脑上。完成 安装 与 坐标标定，打开 http://127.0.0.1:8080/。在 设置 → 设备 中确认相机持续更新、设备已连接且控制已启用。
发送与停止任务
在画面底部输入任务，点击发送或按 Shift+Enter；Enter 换行。指令支持 1–1000 字符。在输入框第一行／最后一行按上／下方向键，可将历史指令带回草稿。
运行时，画面顶部显示当前指令、运行时长与推理延迟，输入区提供 停止（Robot Stop）。任务持续运行，直到你停止或发生故障；一次推理成功不代表任务完成。
运行期间可以编辑下一条指令。发送新指令会先停止当前运行，等待停止完成，再开始新任务。只编辑文字或选择预设不会执行。
| 操作 | 作用 |
|---|---|
| 停止 | 中断当前策略或受控运动，结束本次运行。 |
| 初始位置（Home） | 空闲且控制就绪时，打开夹爪并返回已标定的初始位置。 |
| 恢复并返回初始位置 | 恢复设备后返回初始位置，会移动机械臂。 |
停止后，输入框为空时再次发送可继续当前任务；继续会追加录像，停止等待时间不计入录像。关闭浏览器标签页不会停止后台运行。
使用常用指令
输入框上方显示已保存的指令，点击即可填入草稿。左侧 ＋ 打开指令列表，支持新增、编辑和删除。一个工位最多保存 20 条，每条 1–1000 字符。
预设保存在控制电脑，同一工位的浏览器共用。选择预设或历史指令后，仍需发送才会运行。
连接模型与调整运行参数
点击输入区右侧的模型名称，进入 设置 → 模型与运行。停止任务后：
- 确认 Base URL，默认使用
https://api.pokebot.com/v1；也支持兼容服务的地址。填写 API Key，已配置时可留空沿用。 - 点击 连接 获取当前 Key 可用的模型列表。当前模型仍可用时保留选中状态；否则从列表中选择。
- 按需调整运行参数，点击 保存，应用模型与连接设置。
修改地址或 Key 后需重新连接并选择模型。连接只查询模型列表，不保存本次输入的凭据，也不创建任务会话。连接失败保留已保存的配置和本次输入，可修正后重试。新输入的 Key 默认隐藏。服务须满足 本地运行接入要求。
动作块间隔 / s 控制执行完一组动作后等待多久再观察和推理，默认 0.5 秒。设为 0 不改变动作本身的 30 Hz 执行频率。
设置活动范围
在 设置 → 设备 → 活动范围 中设置机械臂的任务范围。默认启用，X、Y、Z 三轴均为初始位置向正负方向各 60 cm。页面以厘米输入距初始位置的距离；停止任务并结束标定后才能保存，保存本身不会移动机器人。
范围限制的是法兰中心的目标位置。超出范围的动作目标会被收敛到边界，任务继续执行。它不限制旋转，也不表示整条机械臂的覆盖范围或障碍物边界；外力、柔顺运动和跟踪误差仍可能使实际位置越界。
开始、继续任务或手动运动前，如果当前位置已在范围外，先使用 初始位置 返回。显式返回初始位置允许从范围外执行；坐标标定不受这项范围限制。程序使用的坐标与单位见 本地 HTTP API。
查看画面与运行信息
- 拖动画面查看边缘；使用 完整视野 查看全部画面，或 画面回中 恢复位置。
- 相机图标只隐藏或显示预览。平移、裁切和隐藏均不改变模型接收的图像或录像的完整视野。
- 预览中断或切回浏览器标签页后，页面会尝试重新连接；若设备也显示相机不可用，按 相机排查 检查控制电脑。
- 顶部显示最近一轮推理延迟；运行信息和可筛选的日志提供活动记录与请求编号。
管理任务记录与录像
历史任务保留指令、评价、备注和录像。在 设置 → 录制与存储 中开关后续运行的录制、查看占用并清理本机存储。
| 操作 | 保留内容 |
|---|---|
| 清理录像 | 删除录像，保留指令、评价和备注。 |
| 删除任务 | 同时删除指令、评价、备注和录像。 |
批量清理会跳过正在运行或正在保存录像的任务，单项删除也不能删除这些任务。任务记录、评价、备注和录像保存在控制电脑；评价和备注不会发送给模型服务。
与 Agent 共用设备
Agent 通过 MCP 可操作同一台机器人。Agent 发起的运行在网页中为只读，停止仍可用；切换操作入口前先停止当前运行。
网页发送新指令采用“停止后开始新任务”。HTTP API 和 MCP 还提供暂停、恢复与活动指令更新：活动指令更新在下一轮推理生效，不截断当前动作块。