> 网页发布副本：本机研究底稿未随站点发布；固定源码证据保持不变。

信息截止与访问日：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](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/README.md#L1)，2026-10-15 15:07:48 UTC，提交主题 Motor Compatibility |
| SDK 新进展 | [官方社区公告](https://community.doly.ai/public/d/30-doly-sdk-has-arrived)宣布随 v1.007 提供 C++ / Python SDK，检索日期元数据为 2026-02-22。当前 GitHub releases 列表为空，不把社区固件号当 GitHub release |
| 众筹原页 | [Kickstarter](https://www.kickstarter.com/projects/doly/doly-more-than-a-robot)：2024-02-13 至 03-14，CAD 301,597、747 位支持者。本次重读一致 |
| 商业证据限制 | 众筹支持者不是已交付销量，也不是 2026 年新增销量。未取得独立核验的累计出货数 |

# 实际实现边界

代码链路是自定义 Python 应用 → pybind11 模块 → Doly C++ 共享库 → Raspberry Pi CM4 硬件。以驱动为例，[bindings.cpp](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/examples/python/DriveControl/source/bindings.cpp#L250)将 `go_distance`、`go_rotate`、`go_xy`、`free_drive` 映射至 DriveControl 命名空间函数。[CMakeLists.txt](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/examples/python/DriveControl/source/CMakeLists.txt#L9)编译的是绑定，链接 `/.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](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/include/DriveControl.h#L20)，[Python 示例](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/examples/python/DriveControl/example.py#L32) | init / dispose、命令 ID、异步完成/错误/状态事件。距离、旋转、XY 与单轮低层控制分层，提供 abort | 0–100 速度是接口约定，未取得库内部限幅实现。防跌落、停止时延、轨迹精度没有实测 |
| Python 回调桥接 | [bindings.cpp](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/examples/python/DriveControl/source/bindings.cpp#L21) | GIL 获取、互斥锁、强引用保活、移除监听器和清理回调的公开实现 | 可研究跨语言异步事件生命周期，但带 NC 许可，不能当不受限商用代码直接复制 |
| 边缘与触摸传感 | [EdgeControl.h](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/include/EdgeControl.h#L6)、[TouchControl.h](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/include/TouchControl.h#L6) | init / enable / disable、按地面状态筛选 IR 传感器、异步触摸回调与当前状态查询 | 头文件标称边缘约 21 Hz、触摸约 20 Hz，这是文档陈述，不是测试结果。不能据此保证跌落拦截 |
| 眼睛表达 | [EyeControl.h](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/include/EyeControl.h#L50) | 预设形状、颜色、图像内容、左右眼、注视坐标、动画 ID、start/complete/abort 事件与异步播放 | 表情名称公开不等于渲染器、全部图像资源和底层动画实现可移植 |
| 相机与音频 | [Camera/example.py](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/examples/python/Camera/example.py#L1)、[AI 集成 FAQ](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/docs/AI_Integration_Developer_FAQ.md#L52) | 实际示例配置照片 3280×2464、视频 1280×960 / 15 fps，读取 NumPy 帧交给 OpenCV。FAQ 允许 ALSA 麦克风及扬声器 | 示例中的帧率是配置值。持续帧性能、AEC、麦克风与电机并行噪声未测试，流媒体网络传输需自行实现 |
| 本地 TTS 接口 | [TtsControl.h](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/include/TtsControl.h#L7) | 明确是 Piper 包装层，init 选模型，produce 写语音文件，调用阻塞 | 模型名仅 MODEL_1/2/3，实际模型映射和语音权重许可未知。未取得包装内部实现，不能将平台许可套到 Piper 与声音模型 |

[官方 FAQ](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/docs/AI_Integration_Developer_FAQ.md#L34)和驱动示例都要求自定义应用启动前停止标准 Doly service，避免同一硬件控制库冲突。[驱动示例](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/examples/python/DriveControl/example.py#L37)实际调用 `helper.stop_doly_service()`，随后注册回调、初始化、发送 100 mm 前进并轮询 Running，最后 dispose。

官方 FAQ 允许本地控制独立于手机 App 和云服务，也允许开发者自行接 OpenAI、Gemini 或局域网模型。**这不是已经实现的 OpenAI / Gemini 对话应用。** 在已读目录中，本轮核实的是传感/动作接口及普通 Linux 媒体接入，实时会话、视觉选择、模型调用、回声消除、记忆与线程同步仍需应用开发。

# 许可与复用判断

[LICENSE.txt](https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/LICENSE.txt#L8)明确将硬件设计、机械结构、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](<doly-assets.json>)。固定源码材料和仓库树保存在 商业候选临时目录（研究底稿，未随本专区发布）。
