定位
面向喜欢折腾、热爱创造的研发爱好者，通过电脑 SSH 连接在机器狗上写代码、改功能、做自己的项目。
即使你不是专业程序员，只要对编程有兴趣，跟着教程也能上手。
章节
章节 | 标题 | 核心内容 |
|---|---|---|
1 | 开发环境搭建 | SSH 连接（pi/luwu 两种镜像）、VS Code Remote-SSH 上手（1.2：安装配置→常用操作）、Qoder vibe coding 远程开发（1.3 六步流程：连接→浏览远程项目→自然语言描述→AI 生成→审批采纳→运行调试；含隐私脱敏提示）、文件传输（scp/rsync）、官方 Luwu-Imager 镜像烧录、源码部署（luwu_os 官方仓库 + install.sh 14 步） |
2 | 系统架构 | Qt C++ Launcher + PySide6 Apps + Linux Kernel 三层、硬件规格表（9 项外设）、官方架构分层（Launcher/App/硬件抽象/IPC）、启动流程（systemd 服务表与查看命令）、FIFO IPC（含 run.fifo 外部启动与「单应用调试」）、按键系统（含应用内 keyPressEvent）、目录结构（23 个应用，含新版 AI 对话 ai_chat_pro/voice_chat）、机型检测、2.6 常见问题排查 |
3 | 应用开发 | PySide6 模板代码（含 3.1.1 运行模板与预期效果/常见报错）、浅色主题系统（Color/qss/Font/Asset，含实际用例）、国际化（Translator/t，含运行时语言切换生效）、创建新应用步骤（galleryview CARDS 注册 + 常见问题）、现有应用核心技术栈表 |
4 | xgolib 机器人控制 | 四足基础运动（4.1：最小试跑脚本+预期效果、连接/方向语义/姿态平移/步态动作/机械臂/状态读、参数范围表、常见报错表）、轮足 Rider/RA 高级控制（4.2 ra_/rider_）、机型兼容（4.3 别名表与分支判断）、调试与验证小贴士（4.4）、官方开源来源（xgo_doglib） |
5 | MQTT 通信 | 群组表演原理（为什么用 MQTT、xgo/group/{room_id} 主题协议、presence/command/plan 消息格式、一次同步表演时间线、NTP 时间同步与验证、UDP 回退）、自定义 MQTT 开发（paho-mqtt，含 5.2.1 最小验证与常见问题） |
6 | AI 模型替换 | 完整 ONNX 模型列表（约 15 个模型文件，命名因版本而异，含英文/中文唤醒词模型）与模型→应用对应表（6.1/6.1.1，含 grep 定位引用）、onnxruntime 通用推理封装（6.2）、替换人脸检测/手势识别模型步骤（6.3/6.4）、替换后常见问题排查表（6.5）、性能提示与常用查询命令（6.6）、替换前后检查清单（6.7） |