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