摘要：按组装通信、调试标定、策略版本、购买渠道四类给出「现象→原因→解法」对照表，附六步通用排查顺序、安全禁令与反馈前要准备的信息，全部标明来源口径而非实测结论。
先分层，再动手
「没反应」「一走就倒」这类描述，可能落在不同的层，处理方式完全不同。这套系统从上到下是：开发电脑、网络与蓝牙、板卡上的系统和服务、串口、舵机总线、供电、机械结构、策略。排查最省时间的做法，不是背下所有修法，而是先判断断在哪一层。
还有一条最快的分层测试：先手扶着跑一遍。扶着能走、松手就倒，问题在平衡或标定；扶着也乱动、关节方向明显不对，问题在编号或方向。这一步做完，后面能少走很多弯路。下面四类表都按「现象 → 原因 → 解法」组织；解法写的是第一件该做的事，不是完整维修手册。
组装与通信类
| 现象 |
原因 |
解法 |
| 所有舵机都扫描不到 |
供电未到位、动力地与逻辑地未共地、串口被登录控制台占用或半双工接口物理层错误 |
先看母线电压、再查共地与串口设备是否出现，最后才查线序；程序没跑时舵机是软的，不能用「掰得动」判断好坏 |
| 单颗舵机偶尔掉线或报校验错误、超时 |
连接器松动、线径不足、重复 ID、返回延迟、局部压降 |
把那颗单独上台架，核 ID 表与供电；用 make voltage 加 ID 参数区分整机掉压与单只掉压 |
| 总线达不到 50 Hz |
返回延迟、总线错误计数、第二个写入者占用端口、IMU 响应慢 |
看时序日志与 EEPROM 设置，确认端口独占；官方运行时每几分钟会汇总达成频率、抖动、总线占用与错误计数 |
| 手柄一连上，SSH 就断 |
单天线板卡上 Wi-Fi 与蓝牙共用 2.4GHz，无头守护服务主动关 Wi-Fi 让给蓝牙 |
这是设计行为，关掉手柄 Wi-Fi 会恢复；若伴随丢包，检查实际连的是 2.4GHz 还是 5GHz 频段，别只看连接名 |
| 姿态静止不动但总线无报错 |
IMU 样本冻结或样本计数不再增长 |
看连续几帧是否完全相同，用 make imu 一类工具确认读数在变 |
| 找不到设备的 mDNS 名字 |
开机未完成、未连上 Wi-Fi、或开发机与设备不同网段且系统不认 mDNS |
等一到三分钟，确认频段与 network-config 缩进，再用 nmcli 看有没有拿到 IP；实在不行进路由器后台直接按 IP 连 |
调试与标定类
| 现象 |
原因 |
解法 |
| 一上电就向前或向后倒 |
左右腿编号装反、IMU 安装朝向贴反、膝关节初始装配角偏差 |
先对照自己那份装配表重扫编号，再核 IMU 重力投影方向，最后查膝关节机械卡扣；中文专栏把编号装反列为高概率原因 |
| 一回零位就歪、关节撞限位 |
程序认为的零位与机械实际零位不符，offset 偏差 |
重新做整机零位校准，检查舵盘装齿与镜像件方向，别用增大力度掩盖装配错误 |
| 左腿正常、右腿乱动 |
14 个策略动作插进 15 槽目标数组时嘴部槽位错位 |
核对动作到电机的映射，网络推理正常、形状也对时尤其要查这一层 |
| 站得住，迈步就掉电重启 |
多颗舵机同时出力造成母线瞬态压降，总进电口缺缓冲 |
复刻记录里把供电从约 7.4V 调到约 8.0V 后十秒全程最低 7.6V，也有在总进电口并联 1000µF 电容的做法；电容不能代替足够输出能力的电池与线材 |
| 走几秒动作变慢、关节发热 |
主控过热降频拉长控制周期，或零位偏差导致持续纠偏 |
复刻记录里 CPU 被压到 408MHz 时控制周期从 20ms 拖到约 25ms，而策略按 50Hz 训练；先散热、看时序日志，再查无负载电流与目标实测误差 |
| 扭矩开着时掰不动关节 |
舵机处于锁止状态，这是正常现象 |
先停程序再摆姿势，别硬掰电机齿轮；搬动抓躯干，别抓腿和脚掌 |
策略与版本类
| 现象 |
原因 |
解法 |
| 换模型后走得比原来差 |
策略与固件、标定、硬件版本不匹配，或本来就有标定问题 |
把旧 ONNX 留一份在目录外，换回去对比一次，先分清是模型问题还是机器问题 |
| 仿真正常、CPU 复演异常 |
导出路径或观测归一化未烘焙进图 |
只用官方 scripts/export.py 导出，不要手转 checkpoint |
| CPU 复演正常、真机立即倒 |
质量质心、IMU 坐标系、零位、滤波或执行器模型与仿真不一致 |
逐项对齐仿真与实物日志，确认单位换算与符号；按卸力预览到小范围行走分级放开 |
| 策略加载失败或运行时报不健康 |
图形状不符、文件损坏、路径写错或版本不匹配 |
看 robotctl health 与 monitor 点名的原因，核 61 进 14 出的契约与策略路径 |
| 更新后行为变了但版本看着没变 |
守护进程未重启、策略与二进制不匹配、配置被覆盖 |
用 version 与 health 核对实际在跑的东西，再确认策略路径 |
| 别人有了新动作，自己的复刻机没有 |
量化导出的策略冻结在导出当天，无法跟随官方后续发布 |
按官方流程重训、重新导出并重新验证；这是复刻路线的固有局限，不是故障 |
购买与渠道类
| 现象 |
原因 |
解法 |
| 页面出现「首批售罄」「限时加价」「保证圣诞前发货」 |
与官方无关的仿冒页面，冒用官方新闻话术 |
只认官方产品页与其链出的唯一商店；核对页脚主体名称是不是 Pollen Robotics 或 Hugging Face |
| 同一页面价格自相矛盾 |
仿冒站同时挂划线价、到手价与运费组合，口径不一 |
不按该页预算下单，回官方产品页核对当期口径 |
| 售卖官方选配清单里没有的配件 |
官方选配只有充电器包、配件包、开发包三类 |
把「清单外选配」当作辨别特征，别当成稀缺配件 |
| 把社区 BOM 当官方规格采购 |
官方未开放 BOM、3D 打印件、接线图与 IMU 板设计 |
逐仓确认方案、日期、许可证，以各自仓库当期文档为准 |
| 期待国内正式在售或确定交付日 |
官方措辞是交付目标，商店页不承诺具体日期，媒体转述排期会变 |
只作背景判断，不写进结论，不按转述排期安排项目 |
通用排查六步
- 先分层：手扶测试区分平衡标定问题与编号方向问题。预期结果：能圈定一两层，而不是全系统都怀疑。
- 看电：整机与单只电压分别读一次，确认共地与极性。预期结果：负载下电压不掉出范围。
- 看通信：扫描 ID 是否唯一、波特率是否匹配、端口是否被独占。预期结果：所有设备在线、错误计数为零。
- 看标定：中位、offset、IMU 安装方向与单位换算。预期结果：默认姿态与机械中心一致，实物一帧与仿真一帧量级符号一致。
- 看版本：硬件、固件、运行时、策略四处是否同一版，旧文件是否还在目录里被误加载。预期结果：能写出一行可复现的版本字符串。
- 最后才动策略：换回旧文件对比、CPU 复演、分级上机。预期结果：每一步都能单独复现。
安全禁令与反馈前的信息
- 第一次运行用手扶住，不在桌边或高处测试；低电压不长时间运行；扭矩开着不硬掰关节。
- 先执行安全关机命令，等十到十五秒再关电源开关，避免写卡时断电。
- 上电前检查短路、极性与焊点绝缘；自制线材接反一次，可能就带走一块板子。
- 反馈问题前，把信息理清楚：硬件与接口版本、运行时版本、实际固件标识、做过哪几步、看到什么现象、有没有日志或视频，按连不上、服务起不来、通信异常、运动异常四类分开写。
边界
以上现象与解法整理自站内排障文章、中文调试专栏、复刻者逐仓复核长文与官方产品页，属于各自方案的公开记录，本站未做真机实测，也不把社区经验写成官方规格；电压、中位值、编号表、按键映射都必须按自己跟的那套仓库版本核对。想系统理解校准与量化，回《Microduck 舵机归零与 IMU 水平校准》与《Microduck 行走策略量化与部署》。