信息截止与访问日:2026-10-27。面向桌面智能硬件研发选型,重点研究当前 BiBoard / ESP32 控制栈和本地模型指令层。已读固定版本源码、许可及产品资料,并实际运行 25 项上游无硬件测试。未编译固件、连接机器人、下载模型或调用推理服务。
适合作为五个产品研究重点之一。 可复用价值在动作控制和模型指令约束,公开代码与产品商业历史都有依据。Bittle X V2、Nybble Q 是当前产品线,Quaddle 是 2026 年的新产品观察项。不能把 Quaddle 的新品时间或众筹成绩当成其固件已开源的证据。
版本、产品与商业依据
| 对象 | 固定版本与时间 | 热度及证据边界 |
|---|---|---|
| OpenCatESP32 主仓库 | 创建于 2021-02-19。main 固定提交 f5aba6b9,提交时间 2026-10-24 07:29:17 UTC | 访问时 515 stars、131 forks。最新改动修正 XA 数字后缀发送给语音模块的格式,并更新固件日期。仓库历史较长,不能称 2026 年新项目 |
| opencat-gemma | 创建于 2026-10-24。main 固定提交 60a76bc9,提交时间 2026-10-24 08:34:35 UTC | 访问时 0 stars、0 forks。是新公开的示例项目,不是已有热度或成熟度的证明 |
| Bittle X V2 / Nybble Q | Bittle X V2 官方说明确认 BiBoard V1 / ESP32、反馈舵机、触摸传感器与 C++ / Python 支持。页面未给明确上市日期 | 主仓库 README明确 BiBoard 是当前平台,旧 NyBoard Bittle / Nybble 已停产 |
| Quaddle | Kickstarter 原页:2026-09-02 至 10-08,今日读取 USD 115,353、508 位支持者 | 这是筹资承诺及支持者数量,不是已交付销量。固定 README 第 28 行仍写固件源码尚未公开、计划交付前开放 |
| 厂商累计出货 | 官方仓库声明:累计所有渠道 30,000+ 台机器人、60+ 国家 | 厂商自报、产品家族合计、未独立审计。不能分配为 Bittle X V2 或 Quaddle 单品销量 |
两仓库当前 GitHub releases 查询均为空,以上更新按默认分支提交记录,不编造版本标签。Quaddle 的控制协议与动作合约已出现在 opencat-gemma 中,这说明可从主机发送指令,不能反推它的完整固件已公开。
实际代码链路与可抽取模块
Python 本地链路是输入文本 → Ollama 的本地 HTTP 接口 → JSON 解析与白名单 → 有限动作计划 → USB / Wi-Fi / BLE 传输 → 机器人固件。默认模型字符串是 gemma4:e2b-it-qat,地址是 http://localhost:11434/api/chat。gemma.py ask / parse实际传入 JSON schema,收到输出后再做一次本地校验。函数也允许改 URL,不能据默认值断言任意部署都离线。
| 资产 | 实际路径与符号 | 可复用部分 | 依赖与需要改造的边界 |
|---|---|---|---|
| 关节限幅与姿态过渡 | motion.h calibratedPWM / transform / adjust | 先按每关节 angleLimit 截断,再施加标定并输出舵机。姿态过渡、IMU 调整阻尼有实现可读 | 依赖 DOF、关节限值、舵机方向、当前角度、IMU 与板级全局状态。迁移到桌面头部或轮式底盘要重新定义机械参数,不能直接复制四足步态 |
| 动作播放与步数结束 | skill.h Skill::perform,循环计数 | 多帧动作、姿态/步态区分、头部叠加、达到目标循环数后入队站立动作 | 依赖动作数组、板级传感器与 TaskQueue。动作表应随所选机型、校准和电源能力验证 |
| 动作排队 | taskQueue.h Task / TaskQueue | token、参数、延时组合及基于 millis 的调度 | 解析器依赖全局 newCmd,使用 strtok / atoi、动态 char 数组,输入健壮性不能按服务端级别假定。优先参考任务结构,再重写边界检查 |
| 模型动作合约 | contract.py Contract.validate及 contract/bittle.json、nybble.json、quaddle.json | 每机型动作白名单、步数 1–20、适用关节角度 −90° 至 90°,由同一数据生成 prompt 与 schema | 仅白名单及语法约束。没有总命令条数上限、环境感知或碰撞证明。合约当前允许翻滚、跳跃等动作,不能直接作为桌面安全策略 |
| 有限动作执行器 | runner.py plan / run | 缺省步数 3、步行超时 5+2×步数秒,转向由主机计时 2 秒后发 kbalance。异常或 Ctrl+C 尝试停止,再抛原异常。final 模式后截断后续动作 | kbalance 是协议动作,不是硬件断电急停。断链时停止可能失败,源码会记录 STOP FAILED。不同固件回执与机械响应要实测 |
| 传输适配 | links.py SerialLink / WsLink | send(command, timeout) 接口、串口回执截止时间、WebSocket 任务号与心跳。Wi-Fi 忙状态时重试一次以发送停止 | pyserial、websockets 和 bleak 见 requirements.txt。Windows/Linux 整机路径未获上游硬件验证,本轮也未连接硬件 |
相较 Reachy 的头部姿态和媒体管线,Petoi 更适合补充四足执行器、动作编排及模型到动作的接口。它不能代替小智语音底座的唤醒、ASR/TTS,也不是 Hachimo 的桌面 UI 入口。对于 StackChan,可以借鉴模型输出隔离于执行器的结构,但不能复用四足标定与步态常量。
许可及复制边界
| 材料 | 已读依据 | 结论 |
|---|---|---|
| 本文所选 OpenCatESP32 自有控制文件 | MIT 正文,版权所有 Rongzhong Li | 可作为保留版权和许可文本的商业复用候选。仓库含独立许可的第三方代码,根 MIT 不自动覆盖所有 bundled 依赖 |
| opencat-gemma 代码、合约与测试 | MIT 正文,版权所有 Petoi LLC | 适合独立抽取纯 Python 合约和执行器。复用时保留许可文本及来源记录 |
| Gemma、Ollama / LiteRT 与模型权重 | 代码只给模型名称和运行时入口 | 本轮未下载或取得所选权重的完整许可材料。不能用代码 MIT 推定模型权重与所有运行时同许可 |
| 硬件、外壳、舵机及 Quaddle 固件 | Quaddle 源码状态 | 本轮未建立完整可制造硬件文件及许可链。不能承诺复刻整机。Quaddle 固件仍列待公开 |
本地验证与可测指标
从固定 opencat-gemma 提交取得两个原测试文件,连同实际 contract.py、runner.py 和三机型合约执行,使用现有 Python 3.12.14,仅标准库。命令是 python -m unittest tests.test_contract tests.test_runner -v。25 项全部通过,耗时 0.006 秒。 测试包含不合法步数/角度拒绝、合约生成一致、发送顺序、转向后停止、超时与 Ctrl+C 停止、停止失败日志、BLE 禁止断链模式、final 动作后截断。
这验证的是原函数和 FakeLink 模拟传输行为,不是语言理解准确率、物理急停、桌面防跌落或整机运行。本轮未执行其余测试、固件编译、Ollama 模型、真实串口、BLE、Wi-Fi 或网页。
临时材料:仓库原文件位于 petoi-gemma(研究底稿,未随本专区发布),结果见 petoi-validation.json(研究底稿,未随本专区发布)。后续可先将合约缩减到坐下、站立、低幅动作,再测拒绝率、停止命令发出延迟、断链后的最大持续运动时间与机型回执兼容性。没有实测数据前不设定产品已达到这些指标。