{
  "accessed": "2026-10-27",
  "focus": "Doly 传感与交互 SDK",
  "report": "Doly 传感与交互 SDK 研究.md",
  "repositories": [
    {
      "repo": "robotdoly/DOLY-DIY",
      "created": "2023-03-20T22:34:10Z",
      "stars": 558,
      "forks": 97,
      "branch": "main",
      "sha": "dc6f9c6bd25510710d23b215c553680d37cd8ded",
      "date": "2026-10-15T15:07:48Z",
      "message": "Motor Compatibility"
    }
  ],
  "releases": [],
  "summary": "2026 C++/Python SDK；公开头文件/绑定/示例，核心库 .so；CC BY-NC-SA4 也覆盖软件。",
  "reusable_assets": [
    {
      "id": "doly-drive-api",
      "module": "驱动 API 与异步生命周期",
      "repo": "robotdoly/DOLY-DIY",
      "commit": "dc6f9c6bd25510710d23b215c553680d37cd8ded",
      "paths": [
        "SDK/include/DriveControl.h",
        "SDK/examples/python/DriveControl/example.py",
        "SDK/examples/python/DriveControl/source/CMakeLists.txt"
      ],
      "symbols": [
        "DriveControl",
        "go_distance",
        "go_xy",
        "go_rotate"
      ],
      "license": "CC BY-NC-SA 4.0，明确覆盖 SDK/示例",
      "reuse": "研究参考，商业使用须书面许可",
      "gap": "实现依赖设备 .so；MotorControl 未在 SDK/lib 列出；不可称可移植驱动",
      "depth": "头文件、示例、构建文件静态阅读",
      "source": "https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/include/DriveControl.h#L20",
      "accessed": "2026-10-27",
      "scope": "主研究对象/受限 SDK",
      "role": "研究参考，商用需授权"
    },
    {
      "id": "doly-python-bridge",
      "module": "Python 事件桥接",
      "repo": "robotdoly/DOLY-DIY",
      "commit": "dc6f9c6bd25510710d23b215c553680d37cd8ded",
      "paths": [
        "SDK/examples/python/DriveControl/source/bindings.cpp"
      ],
      "symbols": [
        "PYBIND11_MODULE(doly_drive)",
        "on_complete_trampoline"
      ],
      "license": "CC BY-NC-SA 4.0",
      "reuse": "跨语言事件参考，商业复制须授权",
      "gap": "pybind11/GIL/线程；依赖 Doly 二进制 API",
      "depth": "公开绑定源码静态阅读",
      "source": "https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/examples/python/DriveControl/source/bindings.cpp#L21",
      "accessed": "2026-10-27",
      "scope": "主研究对象/受限 SDK",
      "role": "研究参考，商用需授权"
    },
    {
      "id": "doly-sensors",
      "module": "边缘与触摸传感接口",
      "repo": "robotdoly/DOLY-DIY",
      "commit": "dc6f9c6bd25510710d23b215c553680d37cd8ded",
      "paths": [
        "SDK/include/EdgeControl.h",
        "SDK/include/TouchControl.h"
      ],
      "symbols": [
        "EdgeControl",
        "TouchControl"
      ],
      "license": "CC BY-NC-SA 4.0",
      "reuse": "接口设计研究",
      "gap": "约 21/20 Hz 只是头文件说明；没有防跌落实测",
      "depth": "头文件静态阅读",
      "source": "https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/include/EdgeControl.h#L6",
      "accessed": "2026-10-27",
      "scope": "主研究对象/受限 SDK",
      "role": "研究参考，商用需授权"
    },
    {
      "id": "doly-eyes",
      "module": "眼睛动画与状态接口",
      "repo": "robotdoly/DOLY-DIY",
      "commit": "dc6f9c6bd25510710d23b215c553680d37cd8ded",
      "paths": [
        "SDK/include/EyeControl.h"
      ],
      "symbols": [
        "EyeControl::setAnimation",
        "setIrisPosition",
        "EyeExpressions"
      ],
      "license": "CC BY-NC-SA 4.0",
      "reuse": "表达接口参考",
      "gap": "核心渲染 .so 及资源依赖，不能直接移植",
      "depth": "头文件静态阅读",
      "source": "https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/include/EyeControl.h#L50",
      "accessed": "2026-10-27",
      "scope": "主研究对象/受限 SDK",
      "role": "研究参考，商用需授权"
    },
    {
      "id": "doly-media",
      "module": "相机帧与本地 TTS 接口",
      "repo": "robotdoly/DOLY-DIY",
      "commit": "dc6f9c6bd25510710d23b215c553680d37cd8ded",
      "paths": [
        "SDK/examples/python/Camera/example.py",
        "SDK/include/TtsControl.h",
        "SDK/docs/AI_Integration_Developer_FAQ.md"
      ],
      "symbols": [
        "PiCamera",
        "TtsControl"
      ],
      "license": "CC BY-NC-SA 4.0；Piper/声音模型另核",
      "reuse": "设备集成参考",
      "gap": "OpenCV/ALSA、阻塞 TTS、模型映射未知，云 AI 由用户自建",
      "depth": "示例与接口/FAQ 静态阅读",
      "source": "https://github.com/robotdoly/DOLY-DIY/blob/dc6f9c6bd25510710d23b215c553680d37cd8ded/SDK/examples/python/Camera/example.py#L1",
      "accessed": "2026-10-27",
      "scope": "主研究对象/受限 SDK",
      "role": "研究参考，商用需授权"
    }
  ],
  "binary_library_count": 23,
  "validation": {
    "scope": "仅静态阅读，无 SDK 编译/硬件/模型运行"
  },
  "commercial": {
    "cad": 301597,
    "backers": 747,
    "campaign_start": "2024-02-13",
    "campaign_end": "2024-03-14",
    "source": "https://www.kickstarter.com/projects/doly/doly-more-than-a-robot"
  },
  "license": "CC BY-NC-SA 4.0；商业使用须事先书面许可",
  "model_license": "Piper 包装层及匿名 MODEL_1/2/3；声音模型许可未核"
}
