信息截止与访问日:2026-10-27。研究 Doly 作为桌面机器人开发平台的传感、表达和运动接口。已读固定仓库的公开头文件、Python 绑定、示例、构建文件、许可正文与官方 FAQ。未加载二进制库、编译 SDK、连接硬件或调用云模型。
适合作为 SDK 接口设计与产品交互研究对象,不能列为可直接商用移植的完整开源实现。 2026 年新增 C++ / Python SDK 使开发接口较新,但核心驱动以 .so 提供,而且非商业许可明确覆盖 SDK 和示例软件。
版本与商业依据
| 项目 | 固定记录 |
|---|---|
| 官方仓库 | robotdoly/DOLY-DIY,创建于 2023-03-20 22:34:10 UTC,访问时 558 stars、97 forks |
| 默认分支 | main,提交 dc6f9c6b,2026-10-15 15:07:48 UTC,提交主题 Motor Compatibility |
| SDK 新进展 | 官方社区公告宣布随 v1.007 提供 C++ / Python SDK,检索日期元数据为 2026-02-22。当前 GitHub releases 列表为空,不把社区固件号当 GitHub release |
| 众筹原页 | Kickstarter:2024-02-13 至 03-14,CAD 301,597、747 位支持者。本次重读一致 |
| 商业证据限制 | 众筹支持者不是已交付销量,也不是 2026 年新增销量。未取得独立核验的累计出货数 |
实际实现边界
代码链路是自定义 Python 应用 → pybind11 模块 → Doly C++ 共享库 → Raspberry Pi CM4 硬件。以驱动为例,bindings.cpp将 go_distance、go_rotate、go_xy、free_drive 映射至 DriveControl 命名空间函数。CMakeLists.txt编译的是绑定,链接 /.doly/libs/sdk/lib 下的 DriveControl、MotorControl、Gpio、Helper、ImuControl。
固定树的 SDK/lib 有 23 个 .so,包括 libDriveControl.so、libEyeControl.so、libEdgeControl.so、libTtsControl.so。该目录未见 libMotorControl.so,但驱动绑定明确依赖 MotorControl,因此仍需要设备侧 SDK/系统提供相应库。公开树中未找到这些核心控制库对应的实现源文件。能读到接口和包装层,不等于能重编译整个底层 SDK。
| 研究模块 | 实际源码定位 | 可以学到的设计 | 不能从现有材料推出的能力 |
|---|---|---|---|
| 动作生命周期 | DriveControl.h,Python 示例 | init / dispose、命令 ID、异步完成/错误/状态事件。距离、旋转、XY 与单轮低层控制分层,提供 abort | 0–100 速度是接口约定,未取得库内部限幅实现。防跌落、停止时延、轨迹精度没有实测 |
| Python 回调桥接 | bindings.cpp | GIL 获取、互斥锁、强引用保活、移除监听器和清理回调的公开实现 | 可研究跨语言异步事件生命周期,但带 NC 许可,不能当不受限商用代码直接复制 |
| 边缘与触摸传感 | EdgeControl.h、TouchControl.h | init / enable / disable、按地面状态筛选 IR 传感器、异步触摸回调与当前状态查询 | 头文件标称边缘约 21 Hz、触摸约 20 Hz,这是文档陈述,不是测试结果。不能据此保证跌落拦截 |
| 眼睛表达 | EyeControl.h | 预设形状、颜色、图像内容、左右眼、注视坐标、动画 ID、start/complete/abort 事件与异步播放 | 表情名称公开不等于渲染器、全部图像资源和底层动画实现可移植 |
| 相机与音频 | Camera/example.py、AI 集成 FAQ | 实际示例配置照片 3280×2464、视频 1280×960 / 15 fps,读取 NumPy 帧交给 OpenCV。FAQ 允许 ALSA 麦克风及扬声器 | 示例中的帧率是配置值。持续帧性能、AEC、麦克风与电机并行噪声未测试,流媒体网络传输需自行实现 |
| 本地 TTS 接口 | TtsControl.h | 明确是 Piper 包装层,init 选模型,produce 写语音文件,调用阻塞 | 模型名仅 MODEL_1/2/3,实际模型映射和语音权重许可未知。未取得包装内部实现,不能将平台许可套到 Piper 与声音模型 |
官方 FAQ和驱动示例都要求自定义应用启动前停止标准 Doly service,避免同一硬件控制库冲突。驱动示例实际调用 helper.stop_doly_service(),随后注册回调、初始化、发送 100 mm 前进并轮询 Running,最后 dispose。
官方 FAQ 允许本地控制独立于手机 App 和云服务,也允许开发者自行接 OpenAI、Gemini 或局域网模型。这不是已经实现的 OpenAI / Gemini 对话应用。 在已读目录中,本轮核实的是传感/动作接口及普通 Linux 媒体接入,实时会话、视觉选择、模型调用、回声消除、记忆与线程同步仍需应用开发。
许可与复用判断
LICENSE.txt明确将硬件设计、机械结构、CAD、电路、固件、SDK、库、API、示例和配置统称为 Licensed Material,使用 CC BY-NC-SA 4.0。第 52 行起又单独澄清软件也受此限制,商业使用须事先取得许可方书面许可。固定递归树只找到这一份 LICENSE.txt,未找到 SDK 目录的宽松许可例外。
| 使用目标 | 本轮判断 |
|---|---|
| 研究接口、读示例、比较事件和媒体组织方式 | 值得保留为研究对象,按原许可条件使用 |
| 在商业陪伴产品中复制 SDK、绑定或示例 | 当前许可不足,需要另取得书面商业授权。不能因只取几段软件就忽略 NC |
| 独立实现相似的设备抽象和事件接口 | 可以提出自己的设计方案,但不得把本报告当作具体代码复制授权 |
| 将 .so 搬到自家硬件 | 除授权外仍有 ABI、系统镜像、板级驱动、传感器和模型资产依赖。现有二进制接口不提供可移植实现 |
| 克隆完整机器人 | 本轮未完成制造资料完整性及供应链核查,不作可制造性结论 |
Doly 相较 Reachy 的价值是桌面移动机器人传感/眼睛/轮子/胳膊的接口组织。相较 StackChan 的可抽取表达代码,它更多提供现成设备 API。若选型首要目标改成“可直接商用复用的软件”,其优先级应低于 Petoi、StackChan 以及许可已确定的 Reachy 独立模块。
验证状态与后续指标
本轮只完成源码和文件树静态核验,没有将接口声明、示例配置或 .so 存在写成运行成功。后续应先取得使用授权与匹配系统镜像,再验证命令拒绝/接受语义、回调线程与重入、init/dispose 重复调用、断链或异常时停止、边缘事件到电机停止的时延,以及录音/视频/动作并行时丢帧和音频质量。SDK 文档没有给这些测试结果,本报告也未补造。
可复用记录见 doly-assets.json。固定源码材料和仓库树保存在 商业候选临时目录(研究底稿,未随本专区发布)。