Petoi Bittle X 是什么：先认清你要看哪一版

Petoi Bittle X 是什么

Petoi Bittle X 是 Petoi（GitHub 组织 PetoiCamp）的开源四足机器狗产品线，基于 ESP32 主控，支持语音控制与积木、C++、Python 编程。先说清一件事：「Bittle X」是跨代复用的产品名——官方把老款机器叫做 Bittle X、legacy robot Bittle X 或旧款 Bittle/Bittle X，新一代整机叫 Bittle X V2，没出现过「Bittle X V1」的叫法；官方还出于环保复用包装盒，要看带条形码的文本标签确认盒内是哪款机器。命名口径并不统一：产品页在售 6 个 SKU 全部以 Bittle X V2 / Bittle X V2+Arm 命名，docs 文档站又把 Bittle X 手册标注为 not for Bittle X V2——这是官方自己的口径冲突，本项目分版本并列、不裁决。

本项目的口径是四句话：「Petoi Bittle X」项目名跨代复用，不专指某一代；正文以 Bittle X V2（BiBoard V1）为实操主线；老款 Bittle X（BiBoard V0）以「怎么认、哪里不同、该看哪份官方文档」对照覆盖，不另起完整实操链路；初代 Bittle 与 Nybble（NyBoard 平台）不并入本项目。

两代硬件：先对号入座

产品与主板的对应是官方明写的：Petoi Coding Blocks 官方页把 Bittle X（BiBoard V0）、Bittle X V2（BiBoard V1）、Bittle X+Arm 与 Nybble Q 并列为 BiBoard 产品。分区、驱动、遥控与文档站都由机型决定，见《版本辨识：Bittle X / V2、BiBoard V0 / V1 与两个仓库》。

两个代码仓库：星多的不是烧录用的

ESP32 仓库 README 明确写 This is the codebase for current-generation Petoi hardware；legacy 仓库 README 开头反向提示 current-gen 硬件请去 OpenCatESP32。也就是说，无论老款 Bittle X（BiBoard V0）还是 Bittle X V2（BiBoard V1），烧录固件都用 ESP32 仓库。

两处现状并列、不裁决：其一，星数与代次倒挂——legacy 仓库 5562 stars 远高于 ESP32 仓库的 547 stars，短地址 PetoiCamp/OpenCat 还会 301 跳到 legacy 仓库；其二，guide 串口协议页与 Python API 页里 OpenCat.h、InstinctBittle.h 与 OpenCatPythonAPI 的链接仍指向 legacy 仓库。

两套文档站：按页面路径找，不按站找

所以不能一刀切说「docs 是旧站、guide 是新站」：docs 首页标题仍写着 Bittle X，又自设 legacy 区块链接 guide；guide 的串口、蓝牙、语音页又反向链接 docs 的中文页与 API 页。按页面路径判断属于哪一代，比按站判断可靠。

Bittle X V2（BiBoard V1）概览

官方产品页对 Bittle X V2 的定位是 open-source, voice-controlled robot dog：35 个以上预定义动作，支持中英语音切换；另有 10 个可自定义语音命令，命令可以是任何声音，不必映射到某种语言。编程支持 Petoi Coding Blocks、Petoi Web Coding Blocks、C++ 与 Python。硬件搭载 BiBoard V1（ESP32），支持反馈舵机，内置陀螺仪与背部触摸传感器。

guide 文档站还列有 Nybble Q（同代猫型）、Bittle X V2+Arm（配置变体）与 Quaddle——后者是 README 标注的 Kickstarter 项目（2026-09-02 上线），官方写明 Source code is not yet public。三者都不在实操主线内。

本项目怎么用

本项目共 16 页，按「版本辨识 → 开箱 → 组装 → 上电 → 环境 → 烧录 → 校准 → 控制 → 排障」串行平铺：先读《版本辨识：Bittle X / V2、BiBoard V0 / V1 与两个仓库》确认版本，再沿《Petoi Bittle X 快速开始：从开箱到第一次站起来》走主线；官方互相打架的说法集中在《官方口径冲突与中文常见误传对照》页。