01
先解释概念
第一次出现 GPIO、GND、BLE HID、UF2 或 ZMK 时，会说明它是什么、为什么需要它。
Learning by building
从第一根线开始，造出你的 AI 语音遥控器
这不是一份只告诉你“复制命令”的文档。每个阶段都会解释新概念、展示代码怎样工作、给出真实验收证据，再进入下一关。
产品总进度：1 / 10 个阶段完成
120 / 1000 XP
我们的学习契约
每一步都能讲明白
代码、硬件和验证三条线同时前进。页面中的“完成”只代表已有证据，不代表计划写好了。
02
再读懂代码
先解释文件职责，再解释关键语句、输入输出和它与其他文件的连接关系。
03
最后拿证据
编译成功不等于硬件成功。接线、按键事件、蓝牙切换和续航都要分别实测。
Product roadmap
十关产品开发路线
绿色是已完成，蓝色是当前关卡，灰色是尚未开始。未来每完成一关，就在源码里更新这个状态。
建立可重复的固件工程
已完成创建私有 GitHub 仓库、ZMK shield、五键映射、恢复固件和构建工作流。
认识手里的硬件
当前关卡弄清开发板、面包板、轻触按钮、杜邦线、GPIO、GND 与 USB 数据线分别做什么。
搭好五键面包板电路
待解锁把 D0–D4 分别接到五个按钮，按钮另一侧共用 GND；上电前完成通断检查。
刷入第一份 UF2 固件
待解锁理解 bootloader、UF2 磁盘与刷写过程，先通过 USB 供电，不接锂电池。
验证五个 USB 按键事件
待解锁使用键盘事件查看器验证 F13、↑、Enter、↓ 和 Device 行为，排查连击与漏击。
完成单电脑 BLE 配对
待解锁理解 BLE HID、配对信息和断线重连，在一台真实电脑上完整走通。
打通三电脑切换
待解锁为三台电脑分别占用一个 ZMK Bluetooth profile，并实测 Device 循环切换。
做出可握持外壳原型
待解锁先比较 A / B / C 三款 1:1 握持模型，再把有证据的布局转成 STEP 与 STL。
设计并制造 PCB Rev A
待解锁先做 XIAO 载板，不挑战裸 nRF52840 射频；工厂 PCBA，避免把焊接作为新手门槛。
接入电池并完成七天试用
最终关测待机、按键、低电量和充电，连续使用七天后整理 Rev B 修改清单。
现在可以学什么
三份已开放课程
代码、电子硬件与工业设计分开学习，但最终必须在同一个产品里通过验证。
当前真实状态
固件已经在 GitHub Actions 中编译成功，生成了正常固件和 settings-reset 恢复固件；但还没有在你的 XIAO、面包板和三台电脑上实测。因此 Roadmap 只把“建立工程”标为完成。