一次，只调一个关节。

一个参数输入 15°，模型动了，看上去似乎成功了。接着再问一句：这是相对机身还是相对上一段连杆？从哪条方向开始量？正方向朝哪边？如果没有共同约定，同一个数字可以被不同模块解释成不同的动作。调试最费力的地方，常常就在这些看起来默认一致的小事里。

这篇示例文章借 STRIDE 的双关节腿讨论观察方法，通过几何图与可复制计算代码解释关系。所有长度、角度和图形都属于虚拟模型，不对应 MF168 的真实安全范围、安装零位或机械尺寸。文中步骤是一份方法说明，不是已完成机器人调试的实测报告。

先让每个名字，都只指向一个对象。

当界面说“左前腿”、日志说“leg_0”、图解又写“第一条腿”时，它们可能指同一处，也可能只是我们想当然。先建立稳定标识，再在旁边放友好的中文名称，可以减少这种歧义。页面上的选择、控制模块、记录和相关文章，都应该通过同一份映射认识这个对象。

名字之外，还要写清坐标约定。原点放在哪里，平面朝哪边，上关节角是相对固定轴还是机身，下关节角是相对上一连杆还是全局方向。先画一张带箭头的简单图，往往比直接展示复杂公式更有帮助，因为后面的每个结果都依赖这些前提。

只改一个输入，才知道是谁带来了变化。

先固定下关节的相对角，只改变上关节。下游结构应该随父级变换一起移动，但下关节输入值不应悄悄变化。再固定上关节，单独改变下关节，观察足端如何围绕不同的转轴移动。这样做不是为了让动作漂亮，而是为了检查我们对层级关系的理解是否一致。

如果界面为保持“自然姿态”自动补上其他关节动作，就需要明确指出使用了什么额外逻辑。否则，访客无法区分结果来自自己的输入，还是来自隐藏的补偿。解释型演示宁可暂时笨拙，也应该让因果关系清楚：改了什么，哪些量保持不动，哪些部分按定义随动。

原创调试提示：先写下预期会改变的量，再写下预期不变的量。两边都核对，才算观察完整。

写给实践时的自己

两段连杆，可以先用一份小模型表达。

为了讲清关系，先把模型限制在一个二维平面：第一段长度为 L1，第二段为 L2；上关节相对横轴的角为 a，下关节相对第一段的角为 b。于是第二段相对横轴的方向是 a + b。两段向量相加，就能得到足端坐标。这是给定角度求位置的正向几何，不是已经完成逆运动学控制。

数学函数通常用弧度，界面更适合显示角度，因此转换应放在明确的边界上。下面代码使用任意的虚拟长度单位，角度以度输入；它没有操作 PWM、总线或舵机。将来与真实工程连接时，坐标映射、标定与机械限制需要另行验证，不能在这段绘图函数里猜出来。

// 二维虚拟连杆：x 向右，y 向上；角度逆时针为正。
// 长度使用同一种虚拟单位，不对应真实机器人尺寸。
function footPosition(upperDeg, lowerDeg, l1, l2) {
  const values = [upperDeg, lowerDeg, l1, l2];
  if (!values.every(Number.isFinite) || l1 <= 0 || l2 <= 0) {
    throw new RangeError('请输入有限角度与正的连杆长度');
  }
  const a = upperDeg * Math.PI / 180;
  const b = lowerDeg * Math.PI / 180;
  return {
    x: l1 * Math.cos(a) + l2 * Math.cos(a + b),
    y: l1 * Math.sin(a) + l2 * Math.sin(a + b),
  };
}

footPosition(0, 0, 1, 1); // { x: 2, y: 0 }，两段水平伸展

给一次变化，留下可以回看的线索。

一条“更新成功”还不够解释发生了什么。更有帮助的记录会说明选中了哪个关节、输入从什么值改到什么值、使用哪套坐标约定，以及哪些视图已经更新。浏览器里的关节演示应只记录当前页面操作；真实系统则要区分指令已生成、已发送、收到回执和实际观察到动作，不能把它们合并成一个含糊的成功状态。

设计参数与日志联动时，每一帧都打印一行往往只会淹没有用信息。界面可以实时显示当前值，在结束拖动或确认输入时追加摘要事件，再按需展开细节。这样既保留操作的连续感，也让回看抓住重点。示例日志必须标明模拟来源，网页中的输入与图形结果不能生成虚构的传感器读数。

• 操作前：记录对象、初始值、坐标约定与预期。
• 操作中：只改变一个输入，观察父子关系与相关视图。
• 操作后：记录结果、差异与尚未解释的现象。
• 复位后：检查是否确实回到同一基准，而非只把数字改回去。

从单关节，到一个可验证的小系统。

真实机器人不能直接照搬图形模型的验证方式。进入硬件前，要先核对具体型号资料、供电与连接、安装尺寸、零位映射和机械限制；再按标定、单关节、单腿、整机推进。哪一阶段通过，需要什么证据，应在操作之前写清楚。即使未来加入关节演示的“复位”，它也只能重置网页状态，不能被理解为真实设备可以安全回零。

等几何、命名和观察方法一致，再讨论 IK、轨迹与步态，系统就会少一些猜测。一次只调一个关节，并不是最后只能做一个关节，而是先把一条因果链看清楚。复杂系统的成长，可以从这个很小、但能被完整解释的变化开始。