官方口径冲突与中文常见误传对照
官方口径冲突 11 处、中文流传说法与官方原文对不上的 15 条，分两节并列；两侧谁算真值不替官方判定，核对交给读者动手。动态数字均抓取于 2026-11-14。
一、官方文档自己也打架
| 冲突 | 说法 A（出处） | 说法 B（出处） | 怎么核对 |
|---|---|---|---|
| 产品命名与 SKU | 产品页 H1 是 Robo Dog Bittle X，6 个 SKU 全叫 Bittle X V2 / V2+Arm | docs/master.md 标注 Bittle X 手册 (not for Bittle X V2) | 看包装条形码标签认代次 |
| 双文档站定位 | docs/master.md 自设 Legacy Hardware Products 区块、称最新文档在 guide | docs 首页标题仍是 for Bittle, Bittle X & Nybble；guide 的串口/蓝牙/语音页又回链 docs 中文页与 API 页 | 按页面路径判断适用代次 |
| 仓库代次倒挂 | legacy 仓库 5562 stars / 660 forks，README 开头才提示 current-gen 去 ESP32 仓库 | 烧录用 ESP32 仓库（547 stars / 140 forks）；serial-protocol、python-api 页的 InstinctBittle.h、OpenCatPythonAPI 链接却指向 legacy 仓库 | 烧录看 ESP32、脚本看 legacy、串口协议两代通用 |
| Arduino IDE 版本 | arduino-ide.md 第 1 节按 docs.arduino.cc 的 IDE v2 教程安装 | serial-monitor.md 与 useful-tools.md 推荐 1.8.19 | 跟哪份教程装哪份 |
| 分区方案与 Flash | README：Flash Size 4 MB、Partition Scheme Default 4MB with spiffs | guide：V0 是 16M flash（可用默认 4MB 分区表）、V1 是 4M，另可选 Minimal SPIFFS (1.9MB APP with OTA/190KB SPIFFS)、No OTA、Huge APP | 先认 V0 / V1 再选分区 |
| 版本依据 | 两仓 ChangeLog.md 各 44 个条目，最新都停在 Mar6, 2023 | OpenCat.h 有 #define DATE "250218"；ESP32 仓 2026-10-24、legacy 2026-11-12 仍在推送 |
以源码 DATE 与串口 ? 为准 |
| 电池页老款措辞 | battery.md（被 V2 链路引用）写 Reversed connection may damage your NyBoard!、keep Bittle running，含 CR2025 段 | 同链路开机页：Type-C 只充电、2P 2.54mm 端子供电、充电时停止对外供电 | 沿用老款措辞；接反有损坏风险结论保留 |
| 关节序号与引脚 | guide 英文：has no corresponding relationship with the PWM pin number | 中文手册 PDF：关节舵机的序号只与主板上的 PWM 管脚的位置相关、不需要阅读 PCB 板上的舵机引脚号 | 字面相反；两侧都说按接线图接、不读丝印 |
| 进校准方式数量 | 英文 guide：3 种软件界面 + 侧立开机 = 4 条路径 | 中文手册 PDF：进入校准状态有 5 种方法 | 以英文 3+1 为主干 |
| 语音口令方向 | voice-command.md：设英文默认先说 Lizheng 再说 Bing-Bing | 同页：设中文默认先说 Attention 再说 Di-Di | 原样照做，不交换、不改写 |
| 驱动芯片 | arduino-ide.md：BiBoard V0 装 CP210x | BiBoard V1 Guide 写 CH343P；Upload Firmware · BiBoard V1 页给 CH343SER；FAQ 另有 NyBoard 的 CH340C | 按板卡对号：V0→CP210x、V1→CH343、NyBoard→CH340C |
二、中文常见说法对照
| 中文常见说法 | 官方事实 | 官方出处 |
|---|---|---|
| Bittle X V2 用 NyBoard / ATmega328P | V2 是 BiBoard V1 / ESP32；NyBoard 属初代已停产 | 双仓 README |
| 星数最高的是烧录仓库 | 5562 stars 是 legacy 仓库；烧录须用 OpenCatEsp32-Quadruped-Robot | GitHub API |
| ESP32 板卡装最新版就行 | 必须装 2.0.12；装 2.0.13 及以上主板可能起不来 | Upload Sketch 页 |
| 关节索引号就是 PCB 引脚号 | 关节索引号与 PWM 引脚号没有对应关系，不必读引脚号 | Joint Pins on BiBoard V1 |
| 校准 offset 会自动保存 | 必须发 s，否则退出校准态即丢 |
Arduino IDE 校准页 |
| Type-C 口给机器人供电 | Type-C 只充电；供电走 2P 2.54mm 红黑线端子 | Boot up 页 |
| 可以边充边玩 | 充电时电池自动停止对外供电 | Battery 页 |
| 35 个语音命令都能自定义 | 35 个预定义 + 10 个可自定义，两类不同 | 产品页 |
| Quaddle 源码已开源 | README 原文 Source code is not yet public | 双仓 README |
| 官方没有中文资料 | guide 79 页、docs 82 页中文页存在；分散且混代 | 双站 llms.txt 索引 |
| BiBoard2 / PCA9685 转述可当官方事实 | 第三方不是一手证据；规格与许可以官方原文为准；BiBoard2 不在本项目范围 | BiBoard V1 Guide、LICENSE |
| B01_231206 是当前固件版本号 | 那是文档差异页日志的示例值；版本看源码 DATE 与 ? 查询 |
Upload Sketch 页 |
| 319 美元约合人民币 2xxx 元 | 官方只给 $319.00 USD，无汇率依据，不换算 | 产品页 |
| Bittle X V2 支持 5GHz WiFi | 只连 2.4GHz：首次须拆分频段；规格 802.11b/g/n | Web Coding Blocks、BiBoard V1 Guide |
| 组装版和预组装版清单一样 | 清单不同：组装版含 10 个 P1S 舵机与 M2*8 螺丝 | Unboxing 页 |
三、维护锚点：别用 ChangeLog 判断版本
两仓 ChangeLog.md 各只有 44 个日期条目、最新条目都是 Mar6, 2023；但源码里已有 #define DATE "250218"，两仓 2026 年仍在推送。以后复核固件版本不能看 ChangeLog。官方中文页存在（guide 79 页、docs 82 页），但分散在两站、新旧混排，读时逐页确认讲的是哪一代硬件。