共伴协议 / 开发文档
一步一步跑通 Reachy&Us
开发路线
用智能眼镜、本地电脑和 Reachy Mini 构建第一条 A→B 链路。
设备 A智能眼镜拍照 · 图像事件
→桥接层本地电脑 + Agent理解 · 动作请求
→设备 BReachy Mini语音 · 动作回应
执行结果返回主机，形成可追踪的一次交接。
Step 1 · 单独验证设备 A
先让智能眼镜把一张照片传到本地电脑，并确认文件可打开。我们此前用 Luma 工具完成过单图 smoke。下面是已配置 luma 命令时的示例；如果你使用另一款眼镜，换成它自己的采集命令。
mkdir data
luma photo --ai data/smoke-test.jpg- 通过条件：本地生成非空图像文件，画面内容与拍摄现场一致。
- 记录：文件路径、拍摄时间、工具版本，以及一次失败时的报错。
Step 2 · 用一张图驱动 Agent
由本地主机读取图像，先得到简短的场景描述，再形成结构化动作意图。第一轮只保留一种可观察的回应，例如“轻微歪头并说一句话”。
- 输入：图像文件、事件 ID、时间。
- 输出：场景摘要、动作类型、语音文本、事件 ID。
- 通过条件：相同测试图像可生成格式正确、可追踪到输入的动作请求。
Step 3 · 接上设备 B
将动作意图交给 Reachy Mini 适配器。适配器负责调用本地设备接口，并返回“已接收、已完成或失败”的结果。先测试一个简单动作，再组合语音。
- 通过条件：主机发出请求后，机器人执行相应动作，主机收到结果。
- 记录：请求、返回值和实际表现；断连或超时也要有结果。
Step 4 · 串起来复测
按“拍照 → 图像到主机 → Agent 决策 → Reachy 表达 → 执行结果”完整走一遍。连续重复三次，分别记录成功、延迟和失败位置。随后再尝试换场景。
- 最小交付：一份架构图、一条可回放的事件记录、一段真机演示。
- 若暂时没有硬件，先用项目页的预设样例理解流程，并用模拟输入和输出调试桥接层。