{
  "accessed": "2026-10-27",
  "focus": "Petoi 当前 OpenCatESP32 / Bittle X V2",
  "report": "Petoi 控制与本地指令 源码研究.md",
  "repositories": [
    {
      "repo": "PetoiCamp/OpenCatEsp32-Quadruped-Robot",
      "created": "2021-02-19T09:25:42Z",
      "stars": 515,
      "forks": 131,
      "branch": "main",
      "sha": "f5aba6b9cb7e4f2062f77365fbcd0c388acf32ef",
      "date": "2026-10-24T07:29:17Z",
      "message": "Send XA digit suffixes to the voice module as one binary byte.\n\nSerial-monitor commands such as XA15 were forwarded as separate ASCII characters. Digits after XA are now parsed as a 0-255 value and written as a single byte. Bump the firmware date to 261024.\n\nCo-authored-by: Cursor <cursoragent@cursor.com>"
    },
    {
      "repo": "PetoiCamp/opencat-gemma",
      "created": "2026-10-24T04:00:50Z",
      "stars": 0,
      "forks": 0,
      "branch": "main",
      "sha": "60a76bc9529f7f61af9d0250d538d2cbde3d4cd5",
      "date": "2026-10-24T08:34:35Z",
      "message": "docs: link the Petoi doc center and the extensible modules guide\n\nCo-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>"
    }
  ],
  "releases": [],
  "summary": "MIT 控制代码和本地模型指令层；Quaddle 新品固件仍待公开。",
  "reusable_assets": [
    {
      "id": "petoi-motion",
      "module": "关节限幅与姿态插值",
      "repo": "PetoiCamp/OpenCatEsp32-Quadruped-Robot",
      "commit": "f5aba6b9cb7e4f2062f77365fbcd0c388acf32ef",
      "paths": [
        "src/motion.h"
      ],
      "symbols": [
        "calibratedPWM",
        "transform",
        "adjust"
      ],
      "license": "MIT；不自动覆盖第三方目录",
      "reuse": "改造后复用",
      "gap": "耦合关节标定、DOF、舵机与 IMU 全局状态",
      "depth": "固定源码静态阅读",
      "source": "https://github.com/PetoiCamp/OpenCatEsp32-Quadruped-Robot/blob/f5aba6b9cb7e4f2062f77365fbcd0c388acf32ef/src/motion.h#L5",
      "accessed": "2026-10-27",
      "scope": "主研究对象/公开源码",
      "role": "可复用候选"
    },
    {
      "id": "petoi-skill",
      "module": "步态/动作播放及循环结束",
      "repo": "PetoiCamp/OpenCatEsp32-Quadruped-Robot",
      "commit": "f5aba6b9cb7e4f2062f77365fbcd0c388acf32ef",
      "paths": [
        "src/skill.h",
        "src/taskQueue.h"
      ],
      "symbols": [
        "Skill::perform",
        "TaskQueue"
      ],
      "license": "MIT",
      "reuse": "改造后复用",
      "gap": "四足动作表与板级状态；输入解析需加强",
      "depth": "固定源码静态阅读",
      "source": "https://github.com/PetoiCamp/OpenCatEsp32-Quadruped-Robot/blob/f5aba6b9cb7e4f2062f77365fbcd0c388acf32ef/src/skill.h#L283",
      "accessed": "2026-10-27",
      "scope": "主研究对象/公开源码",
      "role": "可复用候选"
    },
    {
      "id": "petoi-contract",
      "module": "模型指令合约",
      "repo": "PetoiCamp/opencat-gemma",
      "commit": "60a76bc9529f7f61af9d0250d538d2cbde3d4cd5",
      "paths": [
        "opencat_gemma/contract.py",
        "contract/bittle.json",
        "contract/nybble.json",
        "contract/quaddle.json"
      ],
      "symbols": [
        "Contract",
        "Contract.validate"
      ],
      "license": "MIT",
      "reuse": "优先独立抽取",
      "gap": "现有白名单含跳跃翻滚；总命令数及桌面环境策略要补",
      "depth": "原函数/原测试执行，FakeLink，25 项套件的一部分",
      "source": "https://github.com/PetoiCamp/opencat-gemma/blob/60a76bc9529f7f61af9d0250d538d2cbde3d4cd5/opencat_gemma/contract.py#L10",
      "accessed": "2026-10-27",
      "scope": "主研究对象/公开源码",
      "role": "可复用候选"
    },
    {
      "id": "petoi-runner",
      "module": "有限计划与异常停止",
      "repo": "PetoiCamp/opencat-gemma",
      "commit": "60a76bc9529f7f61af9d0250d538d2cbde3d4cd5",
      "paths": [
        "opencat_gemma/runner.py"
      ],
      "symbols": [
        "plan",
        "run"
      ],
      "license": "MIT",
      "reuse": "优先独立抽取",
      "gap": "协议停止可能失败；不等于物理急停",
      "depth": "原函数/原测试执行，FakeLink，25 项套件的一部分",
      "source": "https://github.com/PetoiCamp/opencat-gemma/blob/60a76bc9529f7f61af9d0250d538d2cbde3d4cd5/opencat_gemma/runner.py#L13",
      "accessed": "2026-10-27",
      "scope": "主研究对象/公开源码",
      "role": "可复用候选"
    },
    {
      "id": "petoi-transport",
      "module": "USB/Wi-Fi 传输适配",
      "repo": "PetoiCamp/opencat-gemma",
      "commit": "60a76bc9529f7f61af9d0250d538d2cbde3d4cd5",
      "paths": [
        "opencat_gemma/links.py",
        "requirements.txt"
      ],
      "symbols": [
        "SerialLink",
        "WsLink"
      ],
      "license": "MIT；依赖另核",
      "reuse": "适配后复用",
      "gap": "pyserial/websockets，BLE 需 bleak；真实传输未测",
      "depth": "固定源码静态阅读",
      "source": "https://github.com/PetoiCamp/opencat-gemma/blob/60a76bc9529f7f61af9d0250d538d2cbde3d4cd5/opencat_gemma/links.py#L33",
      "accessed": "2026-10-27",
      "scope": "主研究对象/公开源码",
      "role": "可复用候选"
    },
    {
      "id": "petoi-local-parser",
      "module": "本地推理调用与二次解析",
      "repo": "PetoiCamp/opencat-gemma",
      "commit": "60a76bc9529f7f61af9d0250d538d2cbde3d4cd5",
      "paths": [
        "opencat_gemma/gemma.py"
      ],
      "symbols": [
        "ask",
        "parse"
      ],
      "license": "MIT；模型权重另核",
      "reuse": "替换本地模型后可研究复用",
      "gap": "默认 Ollama/Gemma，未运行模型或实际 HTTP",
      "depth": "固定源码静态阅读",
      "source": "https://github.com/PetoiCamp/opencat-gemma/blob/60a76bc9529f7f61af9d0250d538d2cbde3d4cd5/opencat_gemma/gemma.py#L6",
      "accessed": "2026-10-27",
      "scope": "主研究对象/公开源码",
      "role": "可复用候选"
    }
  ],
  "validation": {
    "tests": 25,
    "passed": 25,
    "duration_s": 0.006,
    "scope": "原 tests.test_contract、tests.test_runner；标准库及 FakeLink，无硬件/模型/网络",
    "result": "研究底稿（未随网页发布）"
  },
  "commercial": {
    "family_shipped": ">30000 厂商累计自报，非单品",
    "quaddle": {
      "usd": 115353,
      "backers": 508,
      "campaign_start": "2026-09-02",
      "campaign_end": "2026-10-08",
      "source": "https://www.kickstarter.com/projects/petoi/quaddle-open-source-desktop-robot-kit"
    }
  },
  "hardware": "完整制造资产许可未核；Quaddle 固件 README 声明未公开",
  "models": "代码 MIT 不覆盖 Gemma 权重，未取得模型许可正文"
}
