从开箱到第一次站起来：一条能走通的主线
本页把项目 16 页按执行顺序串成主线，每步写明「做完得到什么」。主线以 Bittle X V2（BiBoard V1）为准；老款 Bittle X（BiBoard V0）用户沿主线走，板型相关步骤按《版本辨识：Bittle X / V2、BiBoard V0 / V1 与两个仓库》替换参数。
第 0 步：认清版本（动手前必做）
看包装盒上带条形码的文本标签。官方中文快速上手指南按标签分流：Bittle X 套件参照 BiBoard V0 舵机接线图、桌面应用上传固件选 BiBoard_V0_*；Bittle X V2 套件参照 BiBoard V1 接线图、选 BiBoard_V1_0。红外接收器、板卡宏等辅助手段见《版本辨识》页。做完得到什么：后续每步的板型选项都有唯一答案。
第 1 步：开箱核对
组装版（construction）与预组装版清单不同：组装版含 10 个 P1S 舵机（长线 ×5、短线 ×5）、BiBoard V1（ESP32）、充电电池、USB 线与 M2*8 螺丝；预组装版是 Main Unit、Calibrator part、贴纸/明信片（背面印语音命令）与随附工具、备件包。留意两处：电池充电口方向须朝机器人头部；背盖内侧的 FPC 触摸排线正常无需拆。做完得到什么：确认无缺件、分清两版清单。逐项对照见《开箱清单：预组装版与组装版分别有什么》。
第 2 步：组装与接线（仅组装版）
舵机长短线分配、GND 插向与左右腿镜像关系见《组装与接线：长线短线舵机、GND 方向与 M2*8》。关键前置：未组装套件在进入校准状态之前不要装头和腿——断电时舵机输出轴角度随机，装腿可能互相碰撞或卡住机身，长时间堵转可能损坏舵机。官方流程是先接线、烧录、进校准姿态，再逐关节装腿。做完得到什么：线序正确、头腿暂不安装的机身（预组装版跳过）。
第 3 步：电池与第一次开机
电池型号 ZCF503060，1000mAh / 7.4Wh，输入 5V-1.5A；Type-C 是充电口，2P 2.54mm 红黑线端子才是接 BiBoard 供电的口，不能混。长按电池按钮 3 秒开关机，开机约 5 秒初始化并播放旋律；首次使用建议先充满电、放在校准支架上再开机。反馈语言：
| 信号 | 含义 |
|---|---|
| 主板蓝灯亮 / 黄灯亮 | USB 供电 / 外部电池供电 |
| 满电蓝、低电红、充电中红、充满绿 | 电量指示，短按蓝色按钮查状态 |
| 短旋律 / 短 beep / 重复旋律 | 程序启动成功 / 收到命令 / 低电或电池未接 |
低电时机器人会暂停动作并 beep；充电时电池自动停止对外供电，装在机身上时必须拆下充。见《电池与第一次开机：Type-C 只充电、长按 3 秒》。做完得到什么：一台能正常开机、能读懂灯色与旋律的机器。
第 4 步（随查随用）：读懂主板
BiBoard V1 规格与模块随查随用：遇到断 JP1 读第 12 路反馈、按住 BOOT 进 Download mode 这类关键词，查《BiBoard V1 规格与接口：从 ESP32-U4WDH 到 CH343P》即可，不占主线时间。
第 5 步：搭 Arduino IDE 环境（烧录的关键前置）
两道硬门槛：把 ESP32 开发板 URL 填进 Preferences——https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json——在 Boards Manager 搜 esp32 安装；且版本必须装 2.0.12，官方原文写明 Installing version 2.0.13 and above may cause the motherboard to fail to startup。sdkconfig、依赖库与整包重命名见《Arduino IDE 环境：2.0.12、sdkconfig 与整包重命名》。做完得到什么：能编译 OpenCatEsp32.ino 的环境。
第 6 步：烧录固件并完成首次初始化
从 ESP32 仓库整包下载源码，按机器改好主 sketch 宏，烧录后在串口监视器（115200、No line ending）完成初始化问答。逐条解释见《烧录与首次初始化：?、! 与 Y/n 问答》。做完得到什么：主板跑上与源码版本日期一致的固件，串口发 ? 能查到主板固件版本日期。
第 7 步：关节校准（第二个前置密集区）
官方四个前置条件：已上传 OpenCat Main function firmware；所有舵机线接主板；电池接控制板并开机；连上电脑或手机。USB 数据线必须直连 BiBoard，不能接电池的外部充电口。校准姿态下所有关节归 0°，此时逐关节把腿装到舵机输出轴齿轮上；舵机齿离散，必须再用软件微调：命令格式「关节索引 + 空格 + offset」，如 c8 6（第 8 舵机 +6°）、c0 -4（头部 -4°），分辨率 1 度、不能用小数，调上腿先于下腿。每调完必须输入 s 保存 offset，否则退出校准态即丢失。验证：依次发 d、kup、kwkF，机器人在 rest / stand / walk 之间对称运动，可能需多轮，最后装中心螺丝固定。做完得到什么：一台站得正、走得直的机器狗。逐关节索引表见《关节校准：calib 姿态、cIndex Offset 与按 s 保存》。
第 8 步：发出第一个动作命令
串口协议里所有 token 以单个 ASCII 字符开头，大小写敏感、通常小写。官方示例：
| 命令 | 作用 |
|---|---|
| ksit | 坐下 |
| kbalance | 站立（balance） |
| kwkF | 向前走 |
| ktrL | trot 步态向左 |
| m0 30 / m0 -30 | 头部关节（关节 0）转到 +30° / -30° |
| d | 趴下（rest） |
文档里的引号只是字符串表示，监视器里不要打引号。k 前缀命名规则与完整 token 表见《串口协议与第一个动作：从 ksit 到 kwkF》。做完得到什么：不写一行代码也能指挥机器人坐、站、走。
第 9 至 12 步：控制方式的横向扩展
串口跑通后按兴趣扩展，四页各自独立：《语音命令：35 预定义、10 自定义与中英切换》：语音模块内置于 BiBoard V1，重启后自动恢复默认语言英文；《四条编程路径：Blocks、Web Blocks、C++、Python》：Python 脚本在 legacy 仓库的 OpenCatPythonAPI 目录；《桌面应用与技能创作：上传器、校准器、Skill Composer》：可视化上传与技能编排；《故障排查：烧录、供电、校准、语音与走路》：按症状找动作，配合《官方口径冲突与中文常见误传对照》核对矛盾说法。
主线只有一个分岔点：第 0 步的版本判断。版本认清，后面每步参数唯一；认错版本，最快在第 5 步就会卡住。