版本辨识：先判断手里是哪一版
「Bittle X」是跨代复用的产品名：老款的主板是 BiBoard V0，Bittle X V2 的主板是 BiBoard V1，两代差异见下文分表。命名上官方还有分歧：产品页在售 6 个 SKU 全以 Bittle X V2 / Bittle X V2+Arm 命名，docs 文档站却把 Bittle X 手册标注为 not for Bittle X V2——两侧并列、不裁决，本页统一用「老款 Bittle X（BiBoard V0）」与「Bittle X V2（BiBoard V1）」指代两代。
辨认手段一：包装条形码标签
官方 Getting Started Guide 原句：If you have a Bittle X V2 (as indicated on the package barcode label), please visit guide.petoi.com；出于环保两代复用包装盒，须凭条形码文本标签辨认盒内物品。中文指南：
| 包装条形码标签 | 对应机型 | 固件上传器主板型号 |
|---|---|---|
| Bittle X | 老款 Bittle X（BiBoard V0） | BiBoard_V0_* |
| Bittle X V2 | Bittle X V2（BiBoard V1） | BiBoard_V1_0 |
辨认手段二：红外接收器
| 主板 | 红外接收器位置 |
|---|---|
| NyBoard | 靠尾部 |
| BiBoard V0 | 靠头部 |
| BiBoard V1 | 没有红外接收器 |
guide 索引对 Remote Controller 条目写明：适用于 Nybble / Bittle（NyBoard）/ Bittle X（BiBoard V0），This doesn't work with Bittle X V2 (with BiBoard V1)。
辨认手段三：板卡宏定义
能打开源码或桌面应用时，看板卡宏最可靠：OpenCatEsp32.ino 头部三选一——BiBoard_V0_1、BiBoard_V0_2、BiBoard_V1_0；固件上传器的 Board version 同样分流：BiBoard_V0_1 / BiBoard_V0_2 对应 Bittle X，BiBoard_V1_0 对应 Bittle X V2 和 Nybble Q。
两代硬件分表对照
| 对照项 | 老款 Bittle X（BiBoard V0） | Bittle X V2（BiBoard V1） |
|---|---|---|
| Flash（guide 口径） | 16M | 4M |
| 分区方案 | 默认 4MB 分区表即可 | Minimal SPIFFS (1.9MB APP with OTA/190KB SPIFFS)、No OTA 或 Huge APP |
| USB 驱动 | CP210x | 模块表写 CH343P；上传子页写 CH343SER |
| 红外遥控 | 可用 | 官方明写不支持 |
| 语音模块 | 需拨扩展帽开关（XA/XU/XS 命令） | 内置，无此要求 |
| 官方文档站 | bittle-x.petoi.com（标注 not for Bittle X V2） | guide.petoi.com/product/bittle-x-v2 |
| 板卡宏 | BiBoard_V0_1 / BiBoard_V0_2 | BiBoard_V1_0 |
两处差异并列、不裁决：分区——README 板型参数表写 Flash Size 4 MB、Default 4MB with spiffs，guide 的 upload-sketch 页按板卡写 V0 为 16M、V1 为 4M；驱动——V1 模块表写 CH343P、上传子页写 CH343SER，另有 NyBoard 的 CH340C。均按板卡对号，别笼统装 USB 驱动。
两个仓库各自什么时候用
两个 README 已把分工说清：ESP32 仓库写 This is the codebase for current-generation Petoi hardware；legacy 仓库开头提示 current-gen 硬件请去 OpenCatESP32。
| 仓库 | 覆盖硬件与用法 |
|---|---|
| PetoiCamp/OpenCatEsp32-Quadruped-Robot | BiBoard/ESP32（两代 Bittle X、Nybble Q）——烧录、改代码、编译上传一律用它 |
| PetoiCamp/OpenCat-Quadruped-Robot | NyBoard/ATmega328P（初代 Bittle、Nybble，discontinued）——只在玩 NyBoard 机型时用 |
另两处：星数与代次倒挂——legacy 仓库 5562 stars / 660 forks，ESP32 仓库 547 stars / 140 forks（抓取日期 2026-11-14），星多的不是烧录用的；guide 的 serial-protocol、python-api 页里 OpenCat.h、InstinctBittle.h、OpenCatPythonAPI 等链接仍指向 legacy 仓库。所以：烧录用 ESP32 仓库；Python 脚本在 legacy 仓库的 OpenCatPythonAPI 目录；串口协议两代通用，不能概括成「只有一个仓库」。
「版本」的四个维度别混成一个
| 维度 | 取值与说明 |
|---|---|
| 产品代次 | Bittle → Bittle X → Bittle X V2（V2+Arm 是配置变体；Nybble Q 是同代猫型） |
| 主板版本 | NyBoard V1_0 / V1_1 / V1_2、BiBoard V0_1 / V0_2、BiBoard V1_0（与代次对应但不等同） |
| 固件/软件版本 | Desktop App Software version 2.0 / 1.0（1.0 obsolete）、源码版本日期 DATE "250218"；官方原话：There's no correlation between the board (hardware) version and the code (software) version |
| 工具链版本 | Arduino ESP32 boards 2.0.12、Mind+ V1.x、Desktop App 1.2.7（环境约束，不是机器版本） |
判断版本只涉及前两层：产品代次决定看哪套文档，主板版本决定烧录参数。V2 用户沿 guide 的 V2 手册与本项目主线走，老款用户把板型参数替换为 V0 列；官方冲突清单见《官方口径冲突与中文常见误传对照》。