机器人
教育机器人项目为什么要分开管理机械、电控与软件版本
机器人看似是一台设备，实际由机械结构、电路、固件和控制程序共同组成。
故障会跨越不同层
轮子不转可能来自机械卡滞、电池电压、驱动板接线、固件或控制逻辑。没有分层记录时，团队容易反复修改程序，却忽略真实原因。
机械版本需要图纸与实物对应
孔位、齿轮比和材料厚度变化后，旧图纸可能仍留在共享目录。每次装配应标记对应设计版本，避免维修人员按过期尺寸制作零件。
接线图必须随改动更新
临时换脚位常能解决现场问题，但若没有回写接线图，下一次上传程序就可能驱动错误端口。照片适合补充位置，不能替代明确的电路标注。
固件与上位程序要成对保存
控制板固件决定底层行为，电脑程序负责更高层任务。只更新其中一边可能造成通信协议不一致。发布时应记录经过验证的组合。
传感器校准属于项目数据
光线、距离与惯性传感器会受安装角度和环境影响。校准值不能脱离设备编号复制。换传感器后沿用旧参数，可能让程序正常运行却输出错误判断。
测试场地也是版本条件
地面摩擦、照明、障碍尺寸和无线环境都会改变结果。竞赛场地表现与教室不同并不意外，复盘时应把环境变化纳入分析。
软件分支需要明确合并人
多人同时调整导航与机械控制时，合并代码的人必须理解接口变化。自动合并只能处理文本，不会判断机器人是否仍能安全运行。
现场修复也要留下记录
比赛或展示期间常用胶带、替换零件和参数调整快速恢复。活动结束后应把这些临时修改转为正式记录，否则下一次开机很难还原状态。
安全测试早于性能测试
更快的速度和更高的扭矩会增加碰撞风险。修改动力参数后，先在受控范围测试急停、方向和限位，再进入完整任务。
成果展示应说明迭代过程
一段成功视频不能代表项目全部价值。展示设计假设、失败原因和改进证据，更能说明学生如何运用工程判断，也让后续团队有资料可继续。