机器人技术 — 用户指南

机器人技术 — 用户指南

什么是机器人技术？

OrbitingFox 的机器人技术部分允许您直接从浏览器控制外部设备 — 例如，机器人假肢手或任何其他具有网络 API 的设备。 您只需注册一次设备，然后使用控制台发送命令并实时查看结果。

快速入门

1. 从导航菜单中选择 机器人技术（或访问 /robotics/）。
2. 点击 添加设备 API 注册您的设备。 您需要设备的 URL（由设备服务器的管理者提供）。
3. 保存后，点击您设备旁边的 打开控制台。

命令控制台

控制台是单个设备的控制面板。它有三个部分：

• 预设按钮 — 每个支持的命令一个按钮（例如，打开手，关闭手，夹持）。点击任何按钮即可立即发送该命令。
• 状态栏 — 显示当前的情况：准备就绪，正在发送…，或结果（成功/错误）。实时计时器在命令发送过程中不断计时。
• 命令日志 — 您发送的最后 30 个命令，包括 HTTP 状态码，来源（控制台/OrbitPilot），时间和持续时间。点击复制图标将日志复制到剪贴板。

发送命令

1. 点击任何预设按钮（例如 打开手）。
2. 状态栏变为琥珀色，计时器开始。当命令正在发送时，预设按钮将被禁用。
3. 当响应到达时，状态栏会显示绿色勾（成功）或红色叉（错误），以及经过的时间。
4. 结果也会添加到页面底部的命令日志中。

为什么有时需要这么长时间？

如果设备托管在免费的托管计划上（如 Render 的免费版），在 15 分钟不活动后将进入休眠状态。休眠期后的第一条命令会唤醒设备 — 这可能需要 30 到 50 秒。在您等待时，计时器会变为琥珀色，然后变为红色。 在接下来的 15 分钟内发送的后续命令将会很快（通常在 1 秒以内）。

命令日志

您发送的每个命令都会保存在日志中，无论是成功还是失败。您可以看到：

• 命令名称
• HTTP 状态码（200 = 成功，422 = 未识别的命令，500 = 设备错误等）
• 来源（控制台 = 您点击了一个按钮；OrbitPilot = 通过 AI 助手发送）
• 发送时间和耗时（以毫秒为单位）
• 设备的任何错误消息

点击日志头中的 复制图标 将完整日志以纯文本形式复制。

管理您的设备

从 /robotics/ 您可以：

• 添加 新设备通过 添加设备 API
• 编辑 设备（更改 URL，命令列表等）
• 停用 设备，使其不再出现在您的控制台列表中（不丢失其历史记录）